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

# Installationsanleitung:

Voraussetzung:
    - RaspberryPi mit Erstinstallation als Velobox
      (s. dazu /beratungsstation/velobox/setup/README)

Vorbereitung: Erstellung des Setuppakets
========================================
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. Eigentliches Installationspaket
    (Die Skripte für die Paketerzeugung können auch ohne svn export
     auf einer vorhandenen Arbeitskopie ausgeführt werden. (ggf. svn update)
     Wenn vom aktuellen Stand ein Setup zum Testen gebaut werden soll,
     ist beim Export /branches/<version> durch /trunk zu ersetzen.)
    - svn export svn+ssh://svnserver/srv/svn/repos/velometrik/beratungsstation/vmkstationd/branches/<version>
      (mit eigenem svnserver Account) oder
      svn export svn+ssh://velometrik@svnserver/srv/svn/repos/velometrik/beratungsstation/vmkstationd/branches/<version>
      mit velometrik-Passwort wie auf der Velobox.
    - cd vmkstationd/devel
    - ./create_vmkstationd_tar_gz.sh
      (root Passwort des aktuellen Rechners erforderlich)
    - cd ../setup # (Dort befindet sich vmkstationd_V<version>.tar.gz.)
    - vmkstationd_V<version>.tar.gz hochladen auf downloads.velometrik.eu/velobox
      (Zum Testen sofort auf vorbereitete Velobox holen. (s. unten))
      TODO sftp ...

2.2. Paketeinbettung für vlbupdate
     TODO Beschreibung


Ausführung
==========

1. vmkstationd
    - Als root anmelden
    - vmkstationd_Vx.y.z.tar.gz nach /usr/local kopieren.
    - Dann: (Internet muß verfügbar sein.)
        Entpacken und
        ./vmkstationd_Vx.y.z/setup/setup.sh *)
        (Setup von Python bleak kann bei 32-Bit dauern.)
    - Kontrollieren:
        service vmkstationd status
        /var/local/log/vmksdsetup.log
    - Testen:
        In einem Browser: http://velobox<boxid>.local
*) Es gibt Optionen, die das Setup ggf. modifizieren.
   Der Aufruf mit -? liefert die nötigen Informationen.

Wenn alles läuft, kann das Tarfile gelöscht werden.

Dateien:
setup.sh            Setup für die allererste Installation
README              Diese Datei
vmkstationd.conf    Initiale Konfiguration
vmkstationd.sh      Startskript in /etc/init.d/
dhcpcd.exit-hook    Informiert vmkstationd über hinzugekommene/entfallene
                    Netzwekschnittstellen (Aufruf durch dhcpd)
vlbclients.sl3db    Initialisierte Datenbank 1)
vlbsettings.sl3db   Initialisierte Datenbank 1)
import_dbldfiles.tcl  Datenübernahme von satteldruckanalyse.tcl
                    (Bei Neuinstallation nicht erforderlich.)

1) Die Datenbanken werden vom Stationsdaemon beim ersten Start geholt.
    Nach einem Update werden sie nicht ersetzt.

2. Lokale Clients

Einziger lokaler Client ist aktuell .../bin/sitzknochenabstand.tk,
der als Daemon installiert wird. Das hat nur Sinn auf einer VeloBox
mit eigenem Display.
Auf einem Rechner mit installiertem X und TK kann sitzknochenabstand.tk
als normale Anwendung auch außerhalb einer Velobox laufen.
Die URL muß dann beim Start mit der Kommandozeilenoption -L <url> angegeben
werden. (Option -? zur Abfrage aller Optionen)

    - Als root anmelden
    - setup_clients.sh aufrufen
    - Kontrollieren:
        service vlbdisplay status
        /var/local/log/vmksdsetup.log

Dateien:
vlbdisplay.sh       Startskript in /etc/init.d

Hinweis: Der Service vlbdisplay startet nur, wenn USAGE=smartcube in /usr/local/etc/velobox.conf.
         Das kann direkt editiert oder über http://veloboxiii.local:8080/ gesetzt werden.

#TODO weiter



I.3. htdocs einspielen
    (abhängig von IMPLEMENTATION in /usr/local/etc/velobox.conf)

htdocs können direkt aus Subversion geholt werden, z.B.

svn export --force svn+ssh://svnserver/srv/svn/repos/velometrik/beratungsstation/velobox_ui/branches/3.1.0 /usr/local/vmkstationd/htdocs

TODO Verfahren definieren


II. Updates

TODO Folgendes überarbeiten und beschreiben

Dateien:
activate.sh
updatecheck
update.sh

