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.14.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.14-py3-none-any.whl (56.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: whost-0.1.14.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.14.tar.gz
Algorithm Hash digest
SHA256 355a811fb7d38fe36bffc89fe771640fd2a6bb16120e1f681c80a01abedf7152
MD5 d5adf67bca9a6cd40f1a0fd41b3c1ca9
BLAKE2b-256 e6de5017f2df27cc01ecfdb6af394675942341aeffb994142970fc8bafd4b492

See more details on using hashes here.

File details

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

File metadata

  • Download URL: whost-0.1.14-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.14-py3-none-any.whl
Algorithm Hash digest
SHA256 b0bfde369df299f48ff0b53edd58a16ea049656abf35ad1dff04efd6394e596a
MD5 5e60da0af20a441fc3d52a9471dbd7b5
BLAKE2b-256 4139840a1c03df0f5f99e34729b1bfd32ea99da3f074c77cbaa2470d2ebc9623

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

0.1.15

2 files

This release

0.1.14 This release

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