This README is in german. Only a small part is written in english.
Sorry for this. If I find some spare time, the whole docs will be
written in english.

For Bugs-Reports, Opinion etc.  
please mail to "tbbs@mail.boerde.de"  (Mailing-List)

###########################################################################
								      7/95

Zusatz-Information fuer erste Installation
--------------------------------------------

Ich veroeffentliche jetzt immer (ab v1.2) zwei Distibutionen (bin+src) der 
tbbs. Man braucht jedoch nur _eine_ davon. 


Am effektivsten ist natuerlich das Bin-Pack, da alles schon fuer Linux 
compiliert ist. Es sollte jetzt ab V1.2pl3.11 ohne Neucompilieren von
jedem Pfad (name unter 55 Zeichen!!!) aus laufen, da es durch das tbbs.setup
SH-Script automatisch 'aktuallisiert' wird. Das wurde allerdings nur unter 
"/local/tbbs" getestet, sollte jedoch funktionieren.
Das Bin-Pack veroeffentliche ich jetzt auch, da wiederholt Probleme beim
Compilieren des src durch die User aufgetreten sind , bzw. staendig in
den falschen Header/Config-Files editiert wurden ist, was verschiedene
unerklaerliche Fehler in der bbs zur Folge hatte. 


Probleme mit 2.0'er Kernel bei der Installation:
-----------------------------------------------
Mit Linux-Kernel-Versionen ab V2.0 gibt es momentan bei den Shell-Scripten
und dem Makefile kleine Probleme mit dem absoluten HOME-Paths bei Root.
Dieses wurde aus irgend welchen Sicherheitsgruenden ab Kernel-Version
geaendert und hat zur Folge, dass saemtliche Scripte 'tbbs.config' oder auch
im makefile an einigen Punkten haengen. Die BBS lauft aber bei kleinen
Aenderungen per Hand (Installation) ohne Probleme.
Derzeit habe ich aber kein 2.0'er Kernel/System installiert, kann dieses
also persoenlich nicht testen. Das werde ich aber im Laufe der naechsten 
Wochen nachholen bzw. patchen.





Vorbereitung zur Installation
-----------------------------
Bevor die BBS installiert wird, sollte folgendes ueberprueft werden:
- Kernel-Version 1.1.xx oder hoeher!!!!!!
- 16MB RAM + SWAP, je mehr desto besser ;-)
  Wenn zu wenig Speicher ist, bricht die bbs in der Regel nur mit
  Fehlermeldungen wie 'Can't fork()' usw.... ab. 
- korrekte Installation des NNTP-Servers (LIST/GROUP ... -Befehle
  testen->siehe Hinweise C, unten )
- Installation des WWW-Brouser's  "Lynx" (Optional), bitte die geaenderte 
  Version  aus dem 'contrib'-Verzeichnis (compilieren mit 'make
  linux-ncurses')
- Komplett-Installation der Linux-Tools (a-Pack der Slackware) 
  (zip,lharc,gzip,strings,ps...  )


SRC-Pack
--------
1. cd ./src
2. Editieren "config.h"   (keine anderen Header-Files!!!!!)
3. make dep; make inst
4. siehe weiter bei BIN-Pack :-)

BIN-Pack (fuer Binaries mindest. 486'er + ELF-Support erforderlich )
---------------------------------------------------------------------
1. (nur Bin-Pack)
Wie oben schon erwaehnt, muss es unbedingt in "/local" entpackt werden,
es ist nur von diesem Verzeichnis aus lauffaehig!
2. (nur Bin-Pack)
Nach dem Entpacken muesste die komplette bbs in "/local/tbbs" stehen.
Ueberpfuefen Sie die "config.h", ob alle Eintragungen richtig sind.
Wenn diese nicht korrekt ist, muessen Sie immer einen symbolic-Link auf
Ihr jeweiliges Verzeichnis bzw. Datei setzen, so dass alle Pfade/Files
in der config.h zutreffend sind. Beachten Sie, dass das Editieren der
config.h nichts bringt, da der Quellcode in diesem Fall neu compiliert
werden muss. 
Ab der Version v1.2pl3.9 habe ich noch ein Setup-Programm geschrieben,
siehe Hinweise B!

Bei den entsprechenden BBS-Jump-Libs aus "~bbs/lib" ("libbbs.so.1.???" ) 
sind die symbolic-Links "libbbs.so.1.???"->"libbbs.so.1" usw. zu
ueberpruefen (werden durch das Makefile gesetzt) und evtl. anzupassen!



{
### ist nicht mehr noetig, macht jetzt das tbbs.setup beim ersten start
    automatisch!
3.
Erweitern "/etc/passwd" / UEBERPRUEFEN!!:
bbs::1000:1000:Nina_BBS:/local/tbbs:/local/tbbs/bin/bbs
4.
Erweitern "/etc/group":
bbs::1000:bbs
5.
Erweitern "/etc/termcap":
(aktuelle Eintraege sind in ~bbs/INFO/config.runge)
}

6.
Fuer die Arbeit mit Lynx ist der im Lynx zu nutzende NNTP-Server in der
Datei "./etc/list.exports" zu setzen. Dieses ist fuer die Arbeit nur im Lynx
mit News notwendig.


7. aktuellen NNTP-Server+Port fuer News-Zugang eintragen:
Ueber das Setup-Progamm "tbbs.setup" wird unter CNews NNTP aktiviert,
der NNTP-Server/PORT eingetragen etc.

8. Ueberpruefen: "./etc/list.export"  (Ueber tbbs.setup moeglich)
- alle Eintragungen in diesem File werden in die Enviroment der BBS gesetzt.
  und gelten aussliesslich fuer den Aufruf externer Programme 

9. "/home/gast" (mit UID/GID != BBS/BBS) anlegen (je nach HOME-Pfad, der 
   in 'list.export' drin steht :)
  (macht jetzt auch das tbbs.setup!)

10. Informations-Files ueberpruefen (kann spaeter erfolgen) : (ueber tbbs.setup moeeglich) 
- Anpassen: "./etc/languages/sysinfo/*.sysinfo"
- Anpassen: "./etc/sysop.txt"     	-> Dazu den wendy-Editor nutzen
- Anpassen  "./etc/issue" 		-> Bedeutung aehnlich ./etc/issue
- Anpassen  "./etc/www.sh" , "./etc/rmail.sh" ,  "./etc/alias.sh"  ,
 	    "./etc/inews.sh"
- Anpassen  "./etc/guest.intro"

11.

12. Admin-Erst-Login
- Setup-Programm "tbbs.setup" von /local/tbbs aus starten (das legt dann 
   dan HOME/BIN-Pfad fest), eventuell Einstellungen korrigieren (ausser 
   NNTP-Server / System .. muesste alles gueltig sein)
- "root" Login auf "tty4",   (von diesem Termial kommt man immer ohne
      Passwort rein, falls es Probleme geben sollte), 
   jetzt muesste die bbs automatisch Admin+Gast-Account anlegen (diese
   duerfen nie vom Sysop 'geloescht' werden!!!!)
- "cd /local/tbbs"
- starten "bin/bbs"
- "Konfig"-Befehl ausfuehren (zusaetzliche System-Einstellungen anpassen)
- "Setup"-Befehl: Festlegen des aktuellen Terminals, Passwort etc.
- "Admin"-Befehl: Userverwaltung und FileUserGruppen festlegen 

11. BBS-Login-Test
- vom getty aus mit "bbs"	-> und ? :-)
   
12. Filebase anpassen (auch ueber tbbs.setup-tool moeglich):
- alle Filebereiche, die von der BBS aus genutzt werden sollen, sind 
  entweder ueber symbolic Link oder via NFS in "./download/NAME" einzu-
  mounten. 
- alle CDRom-Bereiche muessen das Schluessel-Wort "cdrom" enthalten,
  was bedeutet, dass dieser Bereich ReadOnly ist. Auch Beschreibungen
  (.INF-Files) werden dann nicht in diesem Bereich hinterlegt.
- Zum editieren der Beschreibungen sollte man den "sysfileman" nutzen,
  der allerdings nur eine Test-Version ist und noch weiterentwickelt 
  werden muss (jedoch vorerst gut geeignet).


13. System-Infobase anpassen (auch ueber tbbs.setup-tool moeglich):
- Files in "./etc/languages/deutsch.info" an System anpassen 

14. User-Welcome-Mail und BBS-Signum editieren (ueber tbbs.setup-tool):
  Achtung, sollte ueber tbbs.setup-tool erfolgen:
- Anpassen: "./etc/mail/welcome.txt"   :
  Dieses Mail bekommt jeder Benutzer, der sich ueber den "Account" Befehl
  neu als BBS-User eintraegt.
- Anpassen: "./etc/mail/bbs.signum.txt":(auch ueber tbbs.setup-tool moeglich):
  Dieses Signum-File wird an jede in der BBS geschriebenen News/Mail an-
  gehaengt. Wenn man dieses File auf NULL-Laenge setzt, wird kein Signum-
  File angehaengt. Wenn man dieses Signum-File loescht wird immer ein
  "Wetterbereicht" ;-) angehaegt, der noch aus der ix/mbox von Volker S.
  stammt (Aenderbar als Sysop ueber der "Wetter"-Befehl).

15.

16. vom crond aus sollte man ab und zu alle "./etc/log/*" -Files loeschen,
sie dienen nur dazu, dass man nachvollziehen kann, wo ein moeglicher
Fehler aufgetreten ist. 
Bei Problemen bitte Mail mit diesen Files an mich. 

17. Man sollte als Sysop NIE aendern
- Sysop/Administartion: USER.id=1
- Gast/Guest	      : USER.id=2

18. Falls man die User-Base einer alten ix/mbox-Version nutzen will,
    kann man das 'convert' Programm nutzen, um die 'user.data' zu
    konvertieren. Danach sind alle user* Files der ix/mbox-Version 
    nach ./etc zu kopieren (zusammen mit den alten ./usr-Pfaden)

19. Falls es Probleme geben sollte, kann man den bbs-Befehl "Check" ausfuehren,
    womit die meisten der benoetigten Tools (und Pfade) ueberfrueft wird.
    Falls das 'gnuzip' -Script (in "./contrib")  noch nicht in "/bin" ist,
    sollte dieses dort installiert werden...

20. Die Seiten aus dem WWW.bbs-Projekt koennen jetzt auch 'installiert' 
    werden ("bbs.html" in "./etc/WWW.project/bbs" ist die STARTUP-Seite).
    Man braucht also nur einen symb. Link zum httpd-public-directory, also
    anpassen:
     "ln -s /local/tbbs/etc/BBS.project/bbs /usr/local/httpd/public/bbs"
    Der "Lynx"-Befehl startet also "./etc/www.sh" und der Befehl "WWWHelp"
    das Script "./etc/wwwhelp.sh"

21. Die crontab fuer <root> (aus "./INFO/config.runge/crontab.jobs") er -
    gaenzen um (macht jetzt tbbs.setup automatisch !)
     1. "bbs.update" (user-expire, smail-alias-update....)
     2. "sfileman.index" -eintrag
     3. fortune-eintrag (logout-spruch-wechsel) ;-) 


22. Ueberpruefe noch mal, ob folgende symbolic-Links (entsprechend dem 
    aktuellen dirs) gesetzt sind:
     "/local/tbbs/bin/xmd" 		-> "/usr/bin/xmd"
     "/local/tbbs/bin/wendy" 		-> "/usr/bin/wendy"
     "/local/tbbs/bin/bbs.shell" 	-> "/usr/bin/bbs.shell" 
    Achtung wird jetzt ab v1.3 automatisch vom tbbs.setup-script gesetzt !

-------
Hinweise:
A:Betreff: unbedingte installation in pfad "/local/tbbs"
  Ich habe ab version v1.2pl3.9 (erst ab dieser) variable HOME+BIN-Paths mit
  in die BBS eingebaut. Diese werden durch das "tbbs.setup"-Programm,
  was auch erst ab v1.2pl3.8 mit dabei ist, automatisch initialisiert.

B:Setup-Programm "tbbs.setup"
  Mit diesem (und nur diesem, es wird in KEINEM config-file mit dem 
  Editor umgeaendert!) kleinen SH-Script  wird die BBS konfiguriert.
  Das tbbs-Setup-Tool ist IMMER als ROOT vom Hauptverzeichnis der BBS
  aus zu starten. Zur Ausfuerhrung des SH-Scripts ist das dialog-tool
  erforderlich (bei slackware/dld immer dabei, damit laeuft auch das 
  linux-setup-script).
  Nach dem Start sollte sofort unter OPTIONEN/ASCII-Editor nachgesehen
  werden, ob 'joe' installiert ist, bzw. welcher zum Einsatz kommen soll
  (vi, emacs.....). Die Einstellung mit dem "wendy" sollte so bleiben,
  es sei denn, es ist ein aderer aehnlicher Editor verfuegbar. Nach
  Aenderung ist das SH-Script unbedingt neu zu starten!
  

C:Ueberpruefung des NNTP-Servers (von bbs unabhaenig):
  Man kann den NNTP-Server schnell mit Hilfe von telnet testen:
 "telnet localhost nntp"
  >Trying 130.117.12.64...
  >Connected to nina.boerde.de.
  >Escape character is '^]'.
  >200 nina NNTP server version 1.5.11 (10 February 1991) ready at Mon Jul 24 13:16:56 1995 (posting ok).
 "GROUP comp.os.linux.misc"
  >211 1242 11448 14045 comp.os.linux.misc
 "QUIT"
  >205 nina closing connection.  Goodbye.
  >Connection closed by foreign host.

  Falls LIST/GROUP/HEAD etc. NNTP-Server-Befehle nicht moeglich sind, bzw.
  man ueberhaupt keinen connect zum server bekommt, ist dies zuvor zu
  korrigieren !

D: 

E: Bitte die Crontab+Termcap Eintraege in ./INFO/config.runge/......
   entsprechend anpassen und einfuegen.  
   Achtung ALLE bbs-crontab-Jobs _muessen_ in der root-crontab stehen!


F: Visual Menue laeuft nur mit einer erweiterten Vt102-Terminal-Emulation
   und ist erst ab V1.3 im 'Entwicklungs-Status'. Kann also noch nicht
   genutzt werden. Wahrsch. wird es nicht weiter entwickelt, da es durch die
   ncurses bedingt, groessere Probleme gibt. Ausserdem findet es keine
   Akzeptanz bei den Usern  ;)

--------------------------------------------------------------


Ich hoffe, dieser Info-Text hilft bei der Installation geholfen hat.

Sylvio
