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.13.tar.gz (20.3 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.13-py3-none-any.whl (55.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: whost-0.1.13.tar.gz
  • Upload date:
  • Size: 20.3 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.13.tar.gz
Algorithm Hash digest
SHA256 27699480dd18a3f30da3456cb5fb1c865f5478934697381d20be79ce3e8183ac
MD5 ff3823f32fb9215410a85a6c1284f245
BLAKE2b-256 8dd9c7449e30b0a94d4aca18418ac2d5be4ec53f03f81769b59c54eb07639d8b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: whost-0.1.13-py3-none-any.whl
  • Upload date:
  • Size: 55.8 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.13-py3-none-any.whl
Algorithm Hash digest
SHA256 88698162dd119b3f878de805e7f5381f5df85f94aa80f1f1f2242a3211567ab7
MD5 67d4cd77b9183e93e1c803ecc82f224b
BLAKE2b-256 018a5abcd752fd696a43634c8d02620d12db70faaa7dc700311effda020af1c5

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

0.1.14

2 files

This release

0.1.13 This release

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