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

Uploaded Python 3

File details

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

File metadata

  • Download URL: whost-0.1.18.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.18.tar.gz
Algorithm Hash digest
SHA256 b222c2cd5fe581bfda3637580c788565ff17e925651a93b8dabb9f2fa57a5a46
MD5 ead6203a22bbe1cb48a66c4761ab8495
BLAKE2b-256 9fbb96082f219f544e86ea0f84bdf737fcf6a0895626acc79c4101cd8c2cf46c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: whost-0.1.18-py3-none-any.whl
  • Upload date:
  • Size: 56.2 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.18-py3-none-any.whl
Algorithm Hash digest
SHA256 7b600dc59b462232b8b21e8addde5e21fbd0ae05bc244e5f2598a94f791326fc
MD5 9a4671829279ff18c219a54feb036a1b
BLAKE2b-256 7383ceb098677a04736f40cfc6c09893f2291ad2dbeb1d90c4c2576a30184d6a

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

This release

0.1.18 This release

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