Cardshop Writer Host

Cardshop use writer hosts to download, write and ship SD-cards to recipient. A WriterHost is an always-running, always-connected computer connected to one or more USB SD-card readers.

Writer Hosts authenticate with the cardshop fetch tasks. The WriterHost operator is contacted (email) when an SD-card must be inserted, retrieved and shipped.

Requirements

  • always-on-capable computer
  • 500GB storage or more.
  • high-speed, direct, permanent connection to internet via ethernet.
  • one or more good-quality USB SD-card readers (Kingston)
  • A writer account on the cardshop.
  • An assigned port on the demo server (see maintenance).

Ubuntu Install

Just a regular, fresh Ubuntu-server install. Bellow are the defaults used for tests.

  • Boot off the install media & select Install Ubuntu Server at grub prompt.
  • Select language (English)
  • Select Keyboard layout (English (US), English (US))
  • Select Install Ubuntu (not cloud instance)
  • Configure the network (eth via dhcp)
  • Proxy Address: none
  • Mirror Address: http://archive.ubuntu.com/ubuntu (pre-filled default)
  • Use an entire Disk
  • Choose disk to install to: selected disk
  • Summary: confirm and continue
  • Profile
    • name: whatever (maint)
    • server name: whatever (bkored)
    • username: whatever (maint_user)
    • password: whatever (maint_pwd)
  • Reboot now
  • Remove install media then ENTER

Setup software

  • log-in and elevate as root (sudo su -)
  • set a password for root (passwd)
  • Make sure internet is working
  • Configure SSH tunneling for remote access
    • Generate SSH key pair for root, ssh-keygen (no passphrase)
    • Copy /root/.ssh/id_rsa to /root/.ssh/tunnel
    • Share (via email for example) public key with cardshop admin, it's located at /root/.ssh/id_rsa.pub.
    • This file will be append to /home/tunnel/.ssh/authorized_keys on the the tunneling server gateway by the cardshop admin, so the writer can connect.
  • Download setup script curl -L -o /tmp/whost-setup https://raw.githubusercontent.com/kiwix/cardshop/master/whost/whost-setup
  • Go to https://wiki.kiwix.org/wiki/Cardshop/maintenance and update the writer table
  • run the setup script chmod +x /tmp/whost-setup && REVERSE_SSH_PORT=XXX /tmp/whost-setup

Configure the writer

  • Open a terminal as root (no su)
  • Internet connectivity should work, otherwise you will need need to manually configure it with (1)
  • To configure the access to the cardshop you should get from the Cardshop admin your credentials and then configure the software with (2)
  • Then configure your USB microSD adapters with (3), we recommend the usage of "Kingston MobileLite G4"
  • You should then finally enable your writer with (5)
  • You are now ready to use the writer with the cardshop

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for rgaudin from gravatar.com rgaudin

Credits

Author/Maintainer: renaud gaudin

Requires

Python >=3.6, <4.0

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whost-0.1.15.tar.gz (20.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whost-0.1.15-py3-none-any.whl (56.1 kB view details)

Uploaded Python 3

File details

Details for the file whost-0.1.15.tar.gz.

File metadata

  • Download URL: whost-0.1.15.tar.gz
  • Upload date:
  • Size: 20.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.10 CPython/3.7.1 Darwin/18.2.0

File hashes

Hashes for whost-0.1.15.tar.gz
Algorithm Hash digest
SHA256 d791a39a853b2d8cd8ecf7e592fb1a476234a385558986d32c01f6e394244a76
MD5 2cc3758c9c383cb8dc22d77e5db32285
BLAKE2b-256 c0cd8b15a68958371c714bf71fe59818104f012d51717e4e530bd4e2109b39d2

See more details on using hashes here.

File details

Details for the file whost-0.1.15-py3-none-any.whl.

File metadata

  • Download URL: whost-0.1.15-py3-none-any.whl
  • Upload date:
  • Size: 56.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.10 CPython/3.7.1 Darwin/18.2.0

File hashes

Hashes for whost-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 b8914e7f2746ce324bda34a8a9d7e94e571fd7fe20fb0371e89acb89d0801b3b
MD5 3ceef62b087587105f950720c0029da7
BLAKE2b-256 0567044e2e4d406489f5c5ef423741805c8be93c2d6b29111b3debf6418d7f90

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

This release

0.1.15 This release

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page