svn: .../velometrik/beratungsstation/velobox3/setup/README

Vorbereitung: Erstellen der Setuppakete
=======================================
Die folgende Anleitung setzt einige Installationspakete voraus,
deren Erstellung hier beschrieben wird.
Das ist nur erforderlich, wenn diese Pakete nicht vorhanden
oder nicht aktuell sind.

1. Paket für das allgemeine initiale Setup
    - svn export svn+ssh://svnserver/srv/svn/repos/velometrik/beratungsstation/velobox3
      (mit eigenem svnserver Account) oder
    - svn export svn+ssh://velometrik@svnserver/srv/svn/repos/velometrik/beratungsstation/velobox3
      mit velometrik-Passwort wie auf der Velobox.
    - cd velobox3/devel
    - ./create_vlbupdate_tar_gz.sh
      (root Passwort des eigenen Rechners erforderlich)
    - ./create_velobox_tar_gz.sh
    - cd ..
    - velobox3_S<version>.tar.gz hochladen auf downloads.velometrik.eu/velobox3
      sftp  root@downloads.velometrik.eu
        cd /var/www/downloads/velobox3/
        put velobox3_S<version>.tar.gz
        rm velobox.tar.gz (falls vorhanden)
        ln -s velobox_S4.0.0.tar.gz velobox.tar.gz
        quit

2. Paket für den Stationsdaemon
2.1 Eigentliches Installationspaket
    - svn export svn+ssh://svnserver/srv/svn/repos/velometrik/beratungsstation/vmkstationd3
      oder (s. oben)
      svn export svn+ssh://velometrik@svnserver/srv/svn/repos/velometrik/beratungsstation/vmkstationd3
    - ./create_vmkstationd_tar_gz.sh

TODO fertig beschreiben
2.2. Paketeinbettung für vlbupdate
TODO beschreiben

                            *****

Das Setup einer neuen Velobox3 erfolgt in vier Schritten:
1. Allgemeines initiales Setup
2. Optionale Setups
2.1. Lokales Display
2.2. Piepserplatine
3. Setup des vmkstationd3
4. Setup diverser (lokaler) Clients des vmkstationd3
5. Einspielen der HTML-Dateien


Setup mit neuem Raspios Image als Ausgangspunkt
===============================================

1. Allgemeines initiales Setup
   ---------------------------

Die Velobox3 hat als Basis die Lite Version des raspios.
Da das lokale Display für den Hocker bislang nur mit der 32-Bit Version funktioniert,
kann die 64-Bit Version nur ohne Display verwendet werden.
Seit der Version vom 4.4.2022 muß beim ersten Booten der (Standard) User
manuell eingerichtet werden.
Das erfordert Tastatur- und Monitor- und Ethernetanschluß.

Manuelle Vorbereitungen für setup.sh:
    - Boot mit neuem raspios
         => Tastatur und Standard-User werden abgefragt.
    - Tastatur 'German' (ohne Extras)
    - User 'velometrik' (geheimes Passwort wie bei root)
         => Login Prompt erscheint => Als "velometrik" anmelden
    - sudo raspi-config
         - Untermenü "Interface Options": ssh enable
         - Untermenü "System Options": WLAN DE
           (Fehler wegen noch nicht vorhandenem Interface ignorieren.)
    - root Passwort wie bei velometrik setzen: sudo su
                                 ... als root: passwd
    - (ssh-Freigabe für root ist in setup.sh)
    - exit => weiter als "velometrik"
    - wget http://<downloads>/velobox3/velobox_S<version>.tar.gz
      <dowloads> intern: downloads.velometrik.eu
      <version>: Ermitteln durch Aufrufen von <downloads>/velobox3 im Browser
    - tar xvf velobox_S<version>.tar.gz
    - cd velobox_S<version>
    - ./setup.sh
        => endet nach Rückfrage mit reboot

Der Start von setup.sh sowie der weiteren setup-Skripte
kann als 'velometrik' erfolgen,
danach erfolgt (automatisch) ein Neustart als 'root'.
Alle Setupschritte werden im Logfile /var/local/log/vlbsetup.log protokolliert.
Weitere Details s. Skript-Header.

Falls mit Fehler abgebrochen wurde oder das Setup aus unerfindlichen Gründen
hängen bleibt, kann setup.sh neu gestartet werden.
(apt-get upgrade kann etwas dauern.)


2. Optionale Setups
   ----------------

Neben ssh steht die USB-Konsole mittels vlbterm.tcl auf dem angeschlossenen Rechner zur Verfügung.
(svn: .../beratungsstation/service/vlbterm.tcl)

Optionale Setups beziehen sich auf spezielle Hardwarekonfigurationen und werden nur ausgeführt,
wenn die entsprechende Hardwarekomponente tatsächlich existiert.

2.1. Lokales Display

Skript: setup_RB-TFT-3.5.sh
Es werden (nur) die allernötigsten X11-Pakete installiert. (Kein Desktop)
reboot (HDMI abziehen)
Danach muß der Aufruf von startx durch root xterm auf dem Display erscheinen lassen (Funktionstest).
Außerdem sollte die Touchfunktion den Mauskursor an die richtige Stelle bringen.
Mit exit wird es verlassen und der X-Server wird wieder beendet.

2.2. Piepserplatine

Skript: setup_piepser.sh
Das Setup der Piepserplatine beschränkt sich auf das Einstellen der benötigten GPIO-Pins
in der Bootkonfiguration. Das verhindert den andernfalls ertönenden Dauerton beim power up.

2.3. Zusätzliche WLAN-Treiber

Skript: setup_wlan.sh
Das ist notwendig, damit der vorgesehene WLAN Adapter EDIMAX AC1200 funktioniert.
Es ist anzunehmen, daß das bei zukünftigen Kernelversionen bereits funktionieren wird.
(getestet mit 6.1.21-v7+ (uname -r))


3. Setup des vmkstationd3
   ----------------------

Wenn das Setup nicht mit
wget http://downloads.velometrik.eu/velobox/vmkstationd_V<version>.tar.gz
geholt werden kann:

svn: .../velometrik/beratungsstation/vmkstationd3/
Im Unterverzeichnis /dev befindet sich das Skript 
    create_vmkstationd3_tar_gz.sh,
das ein gezipptes Tar für die Installation erzeugt.
Der Verzeichnisbaum wird zuvor mit
svn export svn+ssh://svnserver/srv/svn/repos/velometrik/beratungsstation/vmkstationd3
geholt.

Das Tarfile wird als 'root' nach /usr/local hochgeladen und dort entpackt.
(tar xvf vmkstationd_Vx.y.z.tar.gz)
Dann geht es wie dort in .../setup/README beschrieben weiter.


4. Setup diverser (lokaler) Clients des vmkstationd3
   ---------------------------------------

Auch das wird in .../setup/README beschrieben.


5. Einspielen der HTML-Dateien
   ---------------------------

Schließlich wird das Unterverzeichnis .../htdocs mit den für diese Velobox
vorgesehenen lokalen Anwendungen gefüllt.
TODO Es fehlen die Festlegung zum Umgang mit verschiedenen, sich gegenseitig
ausschließenden lokalen Anwendungen.

