FBB logo image

First installation and startup.

 This part of the manual is intended for the sysop who has never used FBB
software before. I hope this part of the manual will help you to get "on the
air" with FBB without too many problems.

 FBB is designed in 3 versions.  One for Dos (referred to as DosFBB), one
for Windows (referred to as WinFBB) and one for Linux (referred to as LinFBB).
This manual covers all versions.  Most of the contents is identical for all
versions, but when there is a difference, it will be clearly stated.  In 
either case, I presume that you have installed your operating-system (DOS,
Windows or Linux) correct before you attempt to install FBB.

 Normally you will install FBB from diskettes. Normally your diskette-drive
will be called A, and normally you will install the FBB-program on hard-disk
called C. But this is no absolute need, you may use other drives as well.
More about this a little later.

 Your hard-disk is organised in several directories. If you are not familiar
with this, you should read in your operating-system's manual about how the 
hard-disk is organized.

 FBB will normally be installed on your hard-disk in a directory named FBB.
This directory should be placed directly under root  (C:\FBB). This directory
will be automatically created for you. The BBS will also need a lot of other
directories, and they can be created directly from root, or they can be 
created under the FBB-directory. In the procedure I will describe here, only 
the FBB-directory will be at the root (C:\FBB) of the hard-disk, while all the
other directories will be placed under FBB (like  C:\FBB\USERS etc). But you 
can choose this yourself. More about this a little later.

 However, this is the recommended  organization  for  your  directories.  The 
directories will be created like this if you make no changes (a list of the
files and directories is given in appendix 14).

 You should now be ready to start the installation procedure. Put the first
of the diskettes in your disk-drive.

For WinFBB:

 Have Windows up-and-running.  Install WinFBB from your diskette-drive the 
same way as you normally install programmes from diskette.  In Windows 3.x 
I think it should be normal to go to the file-manager, select RUN, and type
A:INSTALL.  In Win95 you may press START, then RUN, then type A:INSTALL.

 You will first be asked for the directory (and drive) that you want to 
have WinFBB installed to.  If you accept the defaults, just press ENTER.
If you want WinFBB installed in another directory or on another drive, 
just do the changes you want now, by typing your own drive/path.

 The screen will now display a text with some more information on the
installation.  Read it carefully before you proceed (by closing that
window).  

 The installation continues.  You will be advised that SYSTEM.INI will be
modified to replace the COMM-driver.  This is the driver for the TNCs and
telephone-modem.  You will also be told to increase the environment to 2kb.
AUTOEXEC.BAT will also be updated with the correct path to your 
FBB-directory.

 Next, the installation-procedure continues by starting the program
INSTWFBB.  (If this is not started during installation, you should start
it after the installation has completed, by clicking on the icon for
WinFBB Configuration).  This program lets you set most of the parametres you
need (all parametres for PORT.SYS and INIT.SRV) for your installation.  
Please take great care here, and go through ALL the pages of this installation
very carefully before you exit the program.  Use the NEXT - PREV buttons to go
through the entire installation.  Be sure to insert your correct callsign, 
your correct H-route etc.  INSTWFBB will update both INIT.SRV and PORT.SYS for
you, you will not need to change them manually later, if you take great care 
to do a good job now.

 When you are sure that your setup now is correct, you may exit the 
INSTWFBB.  The PC will then reboot, to finish the setup.  After this,
you will have a new program-group with icons for WinFBB and for
WinFBB Configuration.  You may run WinFBB Configuration at any time later,
to change your setup again.  The configuration may also be changed while 
the BBS is running, by clicking on the word Config on the top of the 
screen.

Next, the same procedure for DosFBB and LinFBB follows.  Skip them, and go
directly to the section called "FIRST-TIME SETUP OF DIFFERENT FILES."


For DosFBB:

 You should now be ready to start the installation procedure. Put the first
of the diskettes in your disk-drive, and type A: if that drive is named A, 
or B: if that drive is named B. Press ENTER to execute the command (you must
always press ENTER after a command to the PC). Your PC will now answer with
something like A:\> or B:\>

 If you now are ready to install FBB for the first time on your PC, you
type INSTA700.

 You will now see at your screen something like this:

 ---- QUOTE: ----

       ****   FIRST TIME INSTALLATION OF FBB 7.00 FROM DISK %disk%   ****

-  Main BBS-directory -  C:\FBB
-  System-files       -  C:\FBB\SYSTEM
-  Messages           -  C:\FBB\MAIL
-  Binary-messages    -  C:\FBB\BINMAIL
-  User's dir.        -  C:\FBB\USERS
-  Yapp files         -  C:\FBB\USERS\YAPP
-  Oldmail            -  C:\FBB\OLDMAIL
-  Statistics         -  C:\FBB\STATS
-  Documentation      -  C:\FBB\DOCS
-  FBB-manuals        -  C:\FBB\DOC
-  Fwd-include-files  -  C:\FBB\SYSTEM\FWD
-  Executable files   -  C:\FBB\BIN
-  Example-files      -  C:\FBB\EXAMPLES.700
-  Utillities         -  C:\FBB\UTIL
   (Fwd-include-files MUST stay under %system%.)

       If this configuration does not suit your needs, you must stop now
       with CTRL-C and edit the SET-lines in the file A:SUITE1.BAT.
       If a version of FBB 5.15c already exists, press Ctrl-C 
       and use 515c700.BAT for upgrading.

 ----- UNQUOTE. -----

 This screen may vary a bit from version to version, but the work you have to
do, will still be the same. First of all, you will see that the PC says that
you will install from disk A. Is this correct ? If you are installing from
disk-drive B, you must stop the installation now. The same applies if you
want to use other directory-names or paths for some of the other directories
that are listed on your screen now.

 If you DO want to change any of these things, you MUST do it now. The
changes are described in this paragraph; if you do NOT want any changes, you
can go on to the next paragraph. You stop the installation-batch by pressing
CTRL-C. Now you will see the standard A:\> prompt again. Now you must use a
normal text-editor and edit the file SUITE1.BAT on your diskette. I presume
you have such an editor... Make sure that it is able to save the file again
in ASCII (DOS) format ! So if you use for example Word Perfect, you MUST
remember to save the file again in DOS-format !

 At the beginning of that file, you will see a line saying SET disk=A: If you
want to install from B-drive, you edit this line like this:

 SET disk=B:

 You change only the letter after '=', nothing else ! You can also change all
directory-names or directory-paths in this same way. If you do not want to
use C:\FBB\SYSTEM, but want it to be C:\FICHIERS, you just change the line
saying

 SET system=C:\FBB\SYSTEM
 to
 SET system=C:\FICHIERS

 and so on. You must ONLY change the name behind the '=' sign, you must NOT
change anything before that in that line. You can do this with any (or all)
the directory-names and paths. But remember that you will need to do some
extra work with other config-files later if you do not use the default
installation.

 When you have finished doing the changes you want in the lines starting with
SET, you must save the file again to disk. When that is done, you start over
again from the beginning, by typing INSTA700 etc.

 OK. That is about all. Now the BBS-program and all its files will be
installed on your hard-disk. You only have to change diskettes each time you
are asked to (if you install from more than one diskette). 

 Next, the installation-procedure continues by starting the program
FBBSETUP.  This program lets you set all the parametres in INIT.SRV and 
PORT.SYS that you need for your installation. 
(FBBSETUP supports multiple language files, but for the first time 
installation you will probably have only the English language files.)  
Please take great care here, and go through ALL the pages of this
installation very carefully before you exit the program.  Be sure to put in 
your correct callsign, your correct H-route etc.  FBBSETUP will update 
INIT.SRV and PORT.SYS for you, you will not need to change it manually later,
if you take great care to do a good job now.

 The path FBB\BIN must be included in your PATH in AUTOEXEC.BAT. Do this by
adding to the PATH line in AUTOEXEC.BAT ";C:\FBB\BIN" like :

PATH C:\;C:\FBB\BIN

Next, the same procedure for LinFBB follows.  Skip it, and go directly to 
the section called "FIRST-TIME SETUP OF DIFFERENT FILES."


For LinFBB:

There are two versions:
  a windowing version (using X11 windowing system and MOTIF toolkit).
  a daemon version. The daemon version has no interface and works alone in
  background (like works an anti-virus, hi...). So the compter may be used
  for any application while the BBS is running.

Tnx to SM6TKY:

If you need some help in setting up AF_AX25 and AF_NETROM for use with
LinFBB, you may want to read the Appendix 23.

You should now be ready to start the installation procedure.
To install and run LinFBB you MUST have root access,
you may log in as root or you can go to superuser mode with: su root

(1)
Put the floppy disk into the diskdrive.

(2)
If you have MTOOLS installed.
 To copy from floppy disk A:, type: mcopy a:/x700.tgz /tmp
 To copy from floppy disk B:, type: mcopy b:/x700.tgz /tmp

If you have NOT MTOOLS installed.
 To mount floppy drive A: type: mount -t msdos /dev/fd0 /mnt
 To mount floppy drive B: type: mount -t msdos /dev/fd1 /mnt

 Then type: cp /mnt/x700.tgz /tmp , to copy the contents of disk to /tmp,
 then type: umount /mnt , to unmount the floppy disk.

(3)
Now you should create the base directory where you want LinFBB.
 Example, if you want LinFBB in: /usr/local/fbb
 Then type: mkdir /usr/local/fbb

(4)
If you now are ready to install LinFBB for the first time on your PC,

 Type: cd /usr/local/fbb , to go to the LinFBB root directory.
 Type: tar xvzf /tmp/x700.tgz , to unpack the LinFBB archive.

OK. That is about all.
Now the BBS-program and all its files will be installed on your hard-disk. 

Next, the installation-procedure continues by starting the installation
script named INSTALL.SH

This script lets you set most of the parametres in INIT.SRV (BUT NOT ALL !)
that you need for your installation.  Please take great care here, and go 
through ALL the questions of this installation very carefully before you 
exit the script. Be sure to put in your correct callsign, your correct 
H-route etc. The script INSTALL.SH will update INIT.SRV for you, but you 
will also need to check the rest of it manually, too, afterwards !


FIRST-TIME SETUP OF DIFFERENT FILES.

 So far so good... Now we must modify some files, to make the system work. I
will describe all the changes you MUST do, and some changes that you CAN do,
if you like. Read this section very carefully. For most of the files it is
VERY important that the number of non-comment lines must NOT be changed.
Later in the sysop-manual you will find more details on some of these files,
and also details on other files that are not described here in this startup-
section.

Files you MUST check/change:
RUNFBB.BAT (ONLY for WinFBB)
XFBB.SH    (ONLY for LinFBB)
APPEL.BAT  (ONLY for DosFBB)
PORT.SYS   (MUST be changed for LinFBB, no changes needed for WinFBB or DosFBB)
INITTNCx.SYS
MAINTx.SYS

Files you must change if you plan to do any forward:
BBS.SYS
FORWARD.SYS

Files you should check, too, but not SO important:
BEACONx.SYS
EPURMESS.INI
SWAPP.SYS

Files that are automatically configured by INSTWFBB and FBBSETUP, and should
normally not be needed to change manually after (DosFBB and WinFBB).
INIT.SRV
PORT.SYS 

Files you may have a look at later (not so important).
CRON.SYS
REJECT.SYS
PROTECT.SYS
LANGUE.SYS
THEMES.SYS
REDIST.SYS
MEMO.SYS



Start the BBS for the first time.

 Now you should be ready to start the BBS for the first time. Before you do,
make sure that the internal clock of the BBS is correct. If not, you must
correct it now with the DOS-command DATE and TIME. In most newer PCs today,
the clock is automatically set at each power-up. But in some older PCs you
may need to use a special clock/calendar card in your PC, and use a special
program to set the date/time at each startup. For this you must look in the
manual for that clock/calendar card and include the appropriate command in
your AUTOEXEC.BAT file.

For WinFBB:
 Go to the FBB program-group an double-click the WinFBB icon.

For DosFBB:
 Go to the FBB directory and type APPEL and press ENTER.

For LinFBB:
 To start LinFBB in X-Windows:
  Go to base directory and run "./xfbb.sh" in a xterm.
 To start LinFBB deamon:
  Go to base directory and run "./xfbb.sh -d &".

 The first time you start the BBS like this, it may ask you if you want to
create some files. Just answer Y (for Yes) every time. Then those files are
automatically created for you.

 The BBS should now be ready for use. Try a connect to the BBS. Do this by
pressing F2. The BBS will ask you for your name, city, home-BBS and 
ZIP-code.

Only for LinFBB:
Deamon version of LinFBB:
 Go to 'bin' directory, then use the utility 'xfbbC' to connect (eg: xfbbC -c).
 If you have set up PORT.SYS to allow incoming Telnet connections
 to LinFBB, then you can also use this..
 For example, if you defined LinFBB to listen on port 6300 (hex = 189C) 
 for incoming Telnet connections, then you type: telnet sm6tky.ampr.org 6300
X-Windows version of LinFBB:
 Select the "Window" in menu, and then select "Console"
 to enter Console connection.


 Next you must define all the BBSs you want to forward to. You do this with
the command EU. If you want to have forward to for example LA2D, you 
type EU LA2D.

 The BBS will say that this callsign is not known, and ask if you want to
create it. You answer Y. Next you will see a line of different options for
that user. You only have to type B. Now that callsign (LA2D) will be defined
as a BBS. You must press ENTER once more to stop editing the user. Repeat
this procedure with the callsign of all the BBSs that you will forward to.
You terminate the keyboard-session with the command B (Bye).

 Well, if all is ok, and you have not encountered any big problems so far,
you can stop the BBS.  
In DosFBB you do this with Alt-F10 or Alt-x.
In WinFBB you do this by pressing Alt-F4).
In LinFBB you do this:
  Deamon version:
   Do 'ps ax' , check for 'xfbbd' look after
   the process number and do 'kill <process number>'
  X-Windows version:
   Select "File" in menu, and then select "Exit"
   to shutdown the BBS.

You can connect the TNCs, and in INIT.SRV you must change from No to Ok in
the line that asks 'Mode test ?', or 
in WinFBB  : Click on the WinFBB Configuration icon
in LinFBB  : Use INSTALL.SH
in DosFBB  : Use FBBSETUP 
to change the field "TEST MODE" to "NO".


The TNC.

 This software will work with different kinds of TNCs or TNC-interfaces:

 - TNC-2 or close clones. The EPROM of type 27256 must be replaced by a
special EPROM with the WA8DED host-mode software, or by the german TF4, 
TF8, TF18 or similar.

 - PK-232 in host-mode.

 - Kantronics KAM in host-mode. You need a special driver called ESSKAM.

 - DRSI-card.

 - G8BPQ-node (uses TNCs in KISS-mode).

 The software for the TNC-2 host-mode EPROMs TF4 and TF8, may be included on
the distribution-disks. If you cannot burn new EPROMs yourself, there are a 
lot of hams around who can. You can also send a new EPROM to F6FBB or FC1GHV
(with return-postage and packing material, of course) and they will do the
work for you.

 The TNC should work on 4.9 MHz. The standard is 2.5 MHz, but a modification
for this is normally quite simple. In some cases it might be necessary to
replace the Z80 and the Z80 SIO by A-versions.

 If you use standard TNC-2 with one of the mentioned host-EPROMs, you can
start again now, and all should work fine. Make sure that the TNCs have the
same baud-rate as you wrote in PORT.SYS, and that they really are connected
to the COM-ports that you said in PORT.SYS.

 If you do NOT use a standard TNC-2 with DED-type host, but PK-232, BPQ,
Kantronics KAM or DRSI-card, you must read about your special TNC-
setup in one (or more) of the chapters PK-232, BPQ, KAM, DRSI or TFPCX/TFPCR
before you can start the BBS again.

 If the TNCs don't work ok with the software, you will see this when you
start the BBS. You will have a lot of error-messages on the screen, and the
TNCs may start to resync. Stop the program and go through all the setup once
more.

For WinFBB:
You may need to check the port-speed in Windows, make sure it is the same
for the port, as you have set the TNC and PORT.SYS to.


Contents image