# MBSE BBS basic installation.
MBSE BBS Manual
Author: Michiel Broek
Keywords: MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer

> ##### Last update 22-Apr-2002

> # MBSE BBS Basic Installation

> ### Introduction.

> Before you compile and install MBSE BBS you must first setup the basic environment. If you don't do this, things will fail.

> ### Step 1: planning the filesystems.

> MBSE BBS is default installed in /opt/mbse. The default filesystem layout looks like this:

>     /opt/mbse                      0775  Default MBSE_ROOT
>     /opt/mbse/bin                  0755  Binaries
>     /opt/mbse/doc                  0755  Generated sitedocs
>     /opt/mbse/dutch/macro          0755  N/A
>     /opt/mbse/dutch/menus          0755  Dutch menu files
>     /opt/mbse/dutch/txtfiles       0755  Dutch ANSI files
>     /opt/mbse/english/macro        0755  Default english macros, not yet.
>     /opt/mbse/english/menus        0755  Default english menus
>     /opt/mbse/english/txtfiles     0755  Default english ANSI files
>     /opt/mbse/etc                  0775  System configuration files
>     /opt/mbse/fdb                  0775  Files database
>     /opt/mbse/ftp/pub              0775  Default FTP root for download areas.
>     /opt/mbse/galego/macro         0755  N/A
>     /opt/mbse/galego/menus         0755  Galego menu files
>     /opt/mbse/galego/txtfiles      0755  Galego ANSI files
>     /opt/mbse/home                 0770  Users homedirectories
>     /opt/mbse/home/bbs             0770  Newuser account
>     /opt/mbse/html                 0755  HTML documentation
>     /opt/mbse/italian/macro        0755  N/A
>     /opt/mbse/italian/menus        0755  Italian menu files
>     /opt/mbse/italian/txtfiles     0755  Italian ANSI files
>     /opt/mbse/log                  0775  MBSE BBS logfiles
>     /opt/mbse/magic                0755  Magic filerequest names
>     /opt/mbse/sema                 0777  Semafore files
>     /opt/mbse/spanish/macro        0755  N/A
>     /opt/mbse/spanish/menus        0755  Spanish menu files
>     /opt/mbse/spanish/txtfiles     0755  Spanish ANSI files
>     /opt/mbse/tmp                  0775  Temp directory
>     /opt/mbse/tmp/arc              0775  Temp archiver directory
>     /opt/mbse/var                  0770  Var root
>     /opt/mbse/var/badtic           0750  Bad TIC files
>     /opt/mbse/var/bso              0750  Binkley Style Outbound directory
>     /opt/mbse/var/bso/outbound     0750  Default outbound for main aka
>     /opt/mbse/var/inbound          0750  Protected inbound directory
>     /opt/mbse/var/mail             0770  JAM messagebase root
>     /opt/mbse/var/msgs             0750  *.msgs netmail directory (not yet in use).
>     /opt/mbse/var/nodelist         0750  Nodelists
>     /opt/mbse/var/ticqueue         0750  Queue for TIC files
>     /opt/mbse/var/unknown          0750  Unprotected inbound directory

> Don't use UMSDOS or SAMBA filesystems for the bbs, stick by the standard Linux filesystems (ext2 or reiserfs) or ufs if you use FreeBSD. If you intent to make your bbs also accessible by FTP and WWW you must create the directory structure under the ftp user behind the pub directory. Read the ftp server doc for details. If you don't follow these guidlines, you will run into trouble later and have to spend a lot of time in correcting this error.

> ### Step 2: Running the installation script.

> If you are upgrading, proceed with step 4. If not, follow the next steps very carefully! The installation script must be run by root. It checks if there is a previous or failed installation on your system. If that's so the script will not run. In other words, you can only run this script once. The script makes backup copies of the system files it changes, these files will get the extension .mbse To run the installation script you need the archive mbbsebbs-0.33.nn.tar.gz. Unpack this archive on your system, in /tmp will do fine:

>     cd /tmp
>     tar xfvz /path/to/the/mbsebbs-0.33.nn.tar.gz

> To start the script type:

>     cd mbsebbs-0.33.nn
>     bash ./SETUP.sh

> Yes, use bash as shell here. On some systems root doesn't use bash as login shell, calling the script with bash forces the use of bash. The script does the following:
> 1. Create the group bbs
> 2. Create the user mbse
> 3. Create a .profile for user mbse
> 4. Create and set owner of directory tree under /opt/mbse
> Then the script will ask you to give a password for user mbse This password is for system maintenance and for you to make changes to the bbs. You will need that frequently but you should not make that password easy to guess of course. The script will then continue again:
> 5. The user bbs is added.
> 6. The password will be removed from user bbs This action will make changes in /etc/shadow (if you have that) otherwise in /etc/passwd. On FreeBSD it uses other tools to modify the master database. On NetBSD you have to do that manually, there are no tools to do that.
> 7. If they don't exist in the file /etc/services the services fido, tfido and binkp will be added.
> 8. If they don't exist in the file /etc/inetd.conf the internet protocols for the mailer will be added. The inetd is restarted to activate the changes. If your distribution uses xinetd instead of inetd, an include file for xinetd is added instead.

> ### Step 3: Check the basic installation

> The last screen of the script is about sanity checks. Perform those checks! If something is wrong, now is the time to fix it. Don't panic and remember the backups of the system files that are changed are in /etc with the extension .mbse i.e: those were the original files. The installation logfile is copied to /opt/mbse. If everythings is allright, then remove the directory /tmp/mbsebbs-0.33.nn:

>     cd /tmp
>     rm -Rf mbsebbs-0.33.nn

> ### Step 4: Install the basic packages.

> Login as user mbse. Yes, very important, login as user mbse. While in mbse's home directory (/opt/mbse) unpack the distribution archives:

>     tar xfvz /path/to/mbsebbs-0.33.nn.tar.gz

> You now have the subdirectory with sources in the right place. Next build the binaries and install them using the folowing commands:

>     cd ~/mbsebbs-0.33.nn
>     ./configure
>     make
>     su        important, do not use "su -"
>     password: enter root password here
>     make install
>     exit

> The last part of the installation procedure shows you the location of the bbs startup script that is added to your system. Remember this one for a moment. Because this is your first time installation, example menus and example textfiles are installed. If they already exist on your systems (when you do an upgrade) they will not be installed again.

> Now start the bbs for the first time (still as root) by executing the startup script you just saw on the screen followed by a space and the word start. For example:

>     /etc/rc.d/init.d/mbsed start

> This will start the mbtask daemon. After that the bbs will be opened for use. Check the file /opt/mbse/log/mbtask.log for startup problems. The first time mbtask is started on your system it will create a lot of new configuration files with default settings.

> ### Step 5: (RedHat) startup problems.

> From RedHat 6.1 (not the older versions) the behaviour of the su is changed. This may be true for other distributions since the end of 1999 and for Mandrake as well. The file `/etc/rc.d/init.d/mbsed` that is created by the setup script is different then before. The new command is su - instead of simply su. It might be that other new distributions also need the extra minus sign. If that's the case, please let me know and tell me how I can test what version it is.

> ### Step 6: Ready.

> Now you have shell scripts in ~/etc, most of them are called by cron, some are called during system startup and shutdown. You also have some default configuration files, these are ttyinfo, modems, fidonet networks. In the default (english) directory you now have default menu datafiles and ansi screens. These are copies of my test system so you have to edit them to build your own bbs.
> Editing ansi screens can be done on a Linux system with duhdraw, this is available from 2:280/2802 as duhdraw.tgz (68 Kbytes). The binaries are included in this archive, if you compile it yourself it may give trouble so if the binaries work, use these.
> Another editor is available from http://www.drastic.net/bmdraw/, you can find the tar.gz file in http://www.drastic.net/bmdraw/files/bmd022.tgz, it's about 36 Kbytes. This is also a thedraw clone for Linux. Note, at my system I needed to run it as root.
> You may also want to edit ~/etc/header.txt and ~/etc/footer.txt, these files are the top and bottom of the newfiles/allfiles listings.

> Now the basic environment is finished, the next thing to do is configure the bbs.

> Back to Index