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.20.tar.gz (20.7 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.20-py3-none-any.whl (57.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: whost-0.1.20.tar.gz
  • Upload date:
  • Size: 20.7 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.20.tar.gz
Algorithm Hash digest
SHA256 4dc47fc0389d612334ce737551304c4ab1f0e64148201dd7ccb33f20f9901e97
MD5 13ca9423e623abc214ac358d553f9bae
BLAKE2b-256 654289788b9e041e56aa1d7b3154b91d570d2edbb278c1922c27dfdae8bc5859

See more details on using hashes here.

File details

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

File metadata

  • Download URL: whost-0.1.20-py3-none-any.whl
  • Upload date:
  • Size: 57.7 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.20-py3-none-any.whl
Algorithm Hash digest
SHA256 e5f1c8f462fe973985dc1454892073d206e1738781d58e349c1d6de5ac1f7857
MD5 e6b04b93ddb1941c93b8091ffc7cb762
BLAKE2b-256 a6a014b6d0a2b2577a40d4508acc1c411b4bf5941d80baf91cbd6cd48a9723d6

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

This release

0.1.20 This release

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

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