Installation, Upgrade und Migration der aktuellen CB-BCMNET OpenBCM
-------------------------------------------------------------------

Neuinstallation einer CB-BCMNET OpenBCM unter Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Folgende Schritte beschreiben die Installation unter Debian GNU/Linux und
können bei anderen Linux-Distributionen abweichen. Für die Installation im
CB-BCMNET wird emfohlen:

 - User unter welchem die Mailbox läuft: cb
 - Homeverzeichnis des Users:            /home/cb
 - Homeverzeichnis der Mailbox:          /home/cb/bcm
 - Lokaler AXIP UDP Port der Mailbox:    9094
 - AXIP UDP Port des Nodes:              9093

Basierend auf diesen Daten wird die Installation durchgeführt:

A) Installation des OpenBCM-Initscripts

   1) Das bereits heruntergeladene Initscript entpacken.
      tar -xvzf bcm-initscript-*.tar.gz
   2) In das erstellte Verzeichnis wechseln.
      cd bcm-initscript-*
   3) Das Initscript Anhand der enthaltenen Anleitung installieren.

B) Vorbereitungen zur Installation der OpenBCM

   1) Einen User erstellen, unter welchem die Mailbox installiert und
      ausgeführt werden soll.
      adduser cb
   2) Als entsprechender User einloggen.
      su - cb
   3) Das Hauptverzeichnis zur Installation der OpenBCM anlegen.
      mkdir bcm
   4) Ein Verzeichnis anlegen worin der Quellcode entpackt und compiliert
      werden kann.
      mkdir src
   5) Ins src-Verzeichnis wechseln.
      cd src

C) OpenBCM kompilieren und installieren

   1) Den bereits heruntergeladenen OpenBCM-Quellcode entpacken.
      tar -xvjf obcm-*.tar.bz2
   2) Ins dadurch entstandene Verzeichnis wechseln.
      cd obcm-*
   3) Die OpenBCM compilieren.
      make INC=-D_BCMNET
   4) Die erstellte bcm Executable ins bcm-Hauptverzeichnis kopieren.
      cp bcm ~/bcm/

D) Konfiguration und Messages-Dateien installieren

   1) Ins bcm-Hauptverzeichnis wechseln.
      cd ~/bcm
   2) Die bereits heruntergeladene config.zip entpacken.
      unzip config.zip
   3) Die bereits heruntergeladene msg.zip entpacken.
      unzip msg.zip

E) OpenBCM starten und konfigurieren

   1) Die OpenBCM starten.
      ./bcm
   2) Nach einigen Sekunden die OpenBCM mit CTRL+C wieder beenden. Dadurch
      wurden die notwendigen Konfigurationsdateien angelegt.
   3) init.bcm editieren und dabei mindestens folgende Konfigurationsparameter
      anpassen: boxaddress, boxheader, sysopcall, mycall, disable
   4) init.l2 editieren und die Einstellungen zur AX.25-Anbindung vornehmen.
      Üblicherweise wird diese über AXIP UDP erfolgen, dazu die
      Konfigurationsparameter port, txport und ggf. peer anpassen.
      port 9094
      txport 9093
   5) Folgende Messages-Dateien im msg-Unterverzeichnis mit persönlichen
      Texten versehen: ctext.dl, ctext.gb, info.dl, info.gb

F) Installation abschließen

   1) Als User cb ausloggen.
      exit
   2) Die OpenBCM starten.
      /etc/init.d/bcm start

G) Absicherung der Mailbox

   Zur Erstkonfiguration der Mailbox unter Linux kann Telnet verwendet werden:
   telnet 127.0.0.1 4719

   Sysop-Zugriff ohne Passwort über 127.0.0.1 ist unsicher, wenn auf den
   Rechner noch andere User Zugriff haben! Deshalb diesen nach erfolgter
   Erstkonfiguration in der rhosts.bcm abstellen.


Neuinstallation einer CB-BCMNET OpenBCM unter Dos
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1) Ein neues Verzeichnis anlegen z.B. mit dem Namen bcm. Dieses Verzeichnis ist
   nun das bcm-Hauptverzeichnis.
2) bcm.exe ins bcm-Hauptverzeichnis kopieren.
3) config.zip ins bcm-Hauptverzeichnis entpacken.
4) msg.zip im Hauptverzeichnis entpacken, so dass ein msg-Unterverzeichnis
   entsteht.
5) Die OpenBCM starten mit dem Aufruf der bcm.exe.
6) Nach einigen Sekunden die OpenBCM mit ALT+X wieder beenden. Dadurch wurden
   die notwendigen Konfigurationsdateien angelegt.
7) init.bcm editieren und dabei mindestens folgende Konfigurationsparameter
   anpassen: boxaddress, boxheader, sysopcall, mycall, disable
8) Folgende Messages-Dateien im msg-Unterverzeichnis mit persönlichen
   Einstellungen versehen: ctext.dl, ctext.gb, info.dl, info.gb
9) Die OpenBCM durch den Aufruf der bcm.exe wieder starten.


Upgrade einer bestehenden CB-BCMNET OpenBCM
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1) Datensicherung durchführen um Datenverlust vorzubeugen.
2) Die alte bcm-Executable gegen die neue ersetzen.
   a) Linux
      Siehe Neuinstallation unter Linux > OpenBCM kompilieren und installieren.
   b) Dos
      bcm.exe ins bcm-Hauptverzeichnis kopieren und dabei die alte Version
      überschreiben.
3) msg.zip im Hauptverzeichnis entpacken und damit die alten Dateien
   im msg-Unterverzeichnis überschreiben.
4) Folgende Messages-Dateien im msg-Unterverzeichnis mit persönlichen
   Einstellungen versehen: ctext.dl, ctext.gb, info.dl, info.gb
5) OpenBCM wie üblich starten.
6) Zur Bebebung von Fehlern in der Userdatenbank folgenden Befehl als Sysop
   in der Mailbox ausführen: REORG L


OpenBCM Migration von Dos nach Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Folgende Punkte sind bei der Migration besonders zu beachten:

 - Unter Linux müssen sämtliche Dateien und Verzeichnisse klein
   geschrieben werden. Dies ist insbesondere bei allen von der Dos-
   Installation zu übernehmenden Dateien und Verzeichnissen zu beachten.
   Unzip unter Linux unterstützt die Option -L um alle Dateien kleingeschrieben
   zu entpacken. Es bietet sich deshalb an die Dateien unter Dos mit pkzip
   zu packen und unter Linux mit unzip -L zu entpacken.
 - Alle Dateien und Verzeichnisse müssen als entsprechender User erstellt
   werden unter welchem die OpenBCM ausgeführt wird, damit diese die korrekten
   Rechte erhalten.

1) OpenBCM unter Dos auf den aktuellen Stand bringen (mindestens OpenBCM 1.04),
   damit eine users4.bcm von der Mailbox erstellt wird.
2) Unter Linux den Schritten zur Neuinstallation folgen, inklusiv der
   Konfiguration von init.bcm und init.l2.
3) OpenBCM unter Dos beenden.
4) OpenBCM unter Linux beenden.
   /etc/init.d/bcm stop
5) Folgende Dateien von der Dos-Installation übernehmen und dabei die bei
   der Neuinstallation erstellten Dateien überschreiben:
   boardinf.bcm
   bulletin.bcm
   convert.bcm
   hadr4.bcm
   hadrhash.bcm
   passwd.bcm
   userh2.bcm
   users4.bcm
6) Auch folgende Dateien können von der Dos-Installation übernommen werden.
   Diese sind jedoch vorher auf Aktualität zu prüfen und ggf. anzupassen:
   convat.bcm
   fwd.bcm
   reject.bcm
   speech.bcm
7) Das users-Unterverzeichnis von der Dos- zur Linux-Installation kopieren.
8) Das info-Unterverzeichnis von der Dos- zur Linux-Installation kopieren.
9) OpenBCM starten und folgende Befehle ausführen. Jeder Reorg muss abgewartet
   werden, ehe der nächste gestartet werden kann:
   REORG L
   REORG I
   REORG H
   REORG F


73 de Andreas Stempfhuber http://www.afulinux.de/email.htm
