This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
deb-mbse/html/basic.html.in

249 lines
11 KiB
HTML
Raw Normal View History

2003-11-09 14:46:31 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2001-10-22 17:33:55 +00:00
<HTML>
2002-01-21 22:20:54 +00:00
<!-- $Id$ -->
2001-10-22 17:33:55 +00:00
<HEAD>
2003-11-09 14:46:31 +00:00
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
2001-10-22 17:33:55 +00:00
<META http-equiv="Content-Style-Type" content="text/css">
2003-11-09 14:46:31 +00:00
<META NAME="Language" content='en'>
2001-10-22 17:33:55 +00:00
<META name="author" lang="en" content="Michiel Broek">
<META name="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual">
<META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
<TITLE>MBSE BBS basic installation.</TITLE>
<LINK rel=stylesheet HREF="manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
2004-01-21 20:32:00 +00:00
<div align="right"><h5>Last update 21-Jan-2004</h5></div>
2002-09-28 22:15:28 +00:00
<div align="center"><h1>MBSE BBS Basic Installation</h1></div>
2001-10-22 17:33:55 +00:00
<h3>Introduction.</h3>
<p>
Before you compile and install MBSE BBS you must first setup the basic
2003-11-09 17:07:51 +00:00
environment. If you don't do this, things will fail.
<p>
To compile and install MBSE BBS most distributions have installed all needed packages.
If important packages are missing then the configure script will tell you. There are also
less important packages which if missinng still let you compile MBSE BBS, but you will miss
some features. Here is a short list of these packages:
<ol>
<li><b>Zlib</b>. On some distributions you also need <b>zlib development</b>. When you have
zlib installed, then in <b>mbcico</b> extra code will be compiled in the Hydra protocol driver
that will allow the PLZ extension. When a connection is made with another system that also
supports this extension (currently MBSE BBS and Radius beta versions), the files will be sent
compressed even if they are already compressed. The increased throughput will be between 1
and 10 times, that's even better then modem compression can do. Later the zlib compression will
also be added to binkp.</li>
</ol>
2001-10-22 17:33:55 +00:00
<P>&nbsp;<p>
<h3>Step 1: planning the filesystems.</h3>
<p>
2001-12-25 17:57:32 +00:00
MBSE BBS is default installed in <b>/opt/mbse</b>. The default filesystem
layout looks like this:<br>
<pre>
2002-02-04 15:20:31 +00:00
/opt/mbse 0775 Default MBSE_ROOT
/opt/mbse/bin 0755 Binaries
/opt/mbse/doc 0755 Generated sitedocs
2002-09-28 22:15:28 +00:00
/opt/mbse/dutch/macro 0755 Dutch macro files
2002-02-04 15:20:31 +00:00
/opt/mbse/dutch/menus 0755 Dutch menu files
/opt/mbse/dutch/txtfiles 0755 Dutch ANSI files
2002-09-28 22:15:28 +00:00
/opt/mbse/english/macro 0755 Default english macro files
/opt/mbse/english/menus 0755 Default english menu files
2002-02-04 15:20:31 +00:00
/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.
2002-09-28 22:15:28 +00:00
/opt/mbse/galego/macro 0755 Galego macro files
2002-02-04 15:20:31 +00:00
/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
2002-09-28 22:15:28 +00:00
/opt/mbse/italian/macro 0755 Italian macro files
2002-02-04 15:20:31 +00:00
/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
2002-09-28 22:15:28 +00:00
/opt/mbse/spanish/macro 0755 Spanish macro files
2002-02-04 15:20:31 +00:00
/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
2002-09-28 22:15:28 +00:00
/opt/mbse/var/arealists 0750 Areamgr arealist files
2002-02-04 15:20:31 +00:00
/opt/mbse/var/badtic 0750 Bad TIC files
2002-09-28 22:15:28 +00:00
/opt/mbse/var/boxes 0750 Base for nodes fileboxes
2002-02-04 15:20:31 +00:00
/opt/mbse/var/bso 0750 Binkley Style Outbound directory
2002-02-09 21:59:30 +00:00
/opt/mbse/var/bso/outbound 0750 Default outbound for main aka
/opt/mbse/var/inbound 0750 Protected inbound directory
2002-02-04 15:20:31 +00:00
/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
2002-09-28 22:15:28 +00:00
/opt/mbse/var/queue 0750 Queue for before outbound
2002-02-04 15:20:31 +00:00
/opt/mbse/var/ticqueue 0750 Queue for TIC files
2002-02-09 21:59:30 +00:00
/opt/mbse/var/unknown 0750 Unprotected inbound directory
2001-12-25 17:57:32 +00:00
</pre>
2001-10-22 17:33:55 +00:00
<p>
2003-08-15 20:05:34 +00:00
Don't use UMSDOS or SAMBA filesystems for the bbs, stick by the standard
GNU/Linux
2002-09-28 22:15:28 +00:00
filesystems (ext2, ext3 or reiserfs) or ufs if you use FreeBSD.
2001-12-25 17:57:32 +00:00
If you intent to make your bbs also accessible
2001-10-22 17:33:55 +00:00
by FTP and WWW you must create the directory structure under the ftp user
behind the pub directory. Read <a href="misc/ftpserver.html">the
ftp server</a> 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.
<P>&nbsp;<p>
<h3>Step 2: Running the installation script.</h3>
<p>
2003-01-12 16:13:48 +00:00
First, if you use FreeBSD, install the psmisc package. This will make sure
that MBSE BBS is stopped properly if you shutdown your computer.<br>
2001-12-29 15:17:18 +00:00
If you are upgrading, proceed with step 4. If not, follow the next steps
2003-01-12 16:13:48 +00:00
very carefully!<br>
2001-10-22 17:33:55 +00:00
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 <strong>.mbse</strong> To run the installation script you need
the archive <strong>mbbsebbs-@VERSION@.tar.bz2</strong>.
Unpack this archive on your system, in /tmp:
2001-10-22 17:33:55 +00:00
<pre>
cd /tmp
tar xfvj /path/to/the/mbsebbs-@VERSION@.tar.bz2
2001-10-22 17:33:55 +00:00
</pre>
To start the script type:
<pre>
cd mbsebbs-@VERSION@
2001-10-22 17:33:55 +00:00
bash ./SETUP.sh
</pre>
Yes, use <b>bash</b> 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:
<ol>
<li>Create the group <strong>bbs</strong>
<li>Create the user <strong>mbse</strong>
<li>Create a <strong>.profile</strong> for user <strong>mbse</strong>
<li>Create and set owner of directory tree under /opt/mbse
</ol>
Then the script will ask you to give a password for user <strong>mbse</strong>
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:
<ol start="5">
<li>The user <strong>bbs</strong> is added.
<li>The password will be removed from user <strong>bbs</strong> 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.
2002-01-21 22:20:54 +00:00
On NetBSD you have to do that manually, there are no tools to do that.
2001-10-22 17:33:55 +00:00
<li>If they don't exist in the file /etc/services the services fido, tfido
2002-01-21 22:20:54 +00:00
and binkp will be added.
2001-10-22 17:33:55 +00:00
<li>If they don't exist in the file /etc/inetd.conf the internet protocols
for the mailer will be added. The <strong>inetd</strong> is restarted to
2002-01-21 22:20:54 +00:00
activate the changes. If your distribution uses xinetd instead of inetd, an
include file for xinetd is added instead.
2001-10-22 17:33:55 +00:00
</ol>
<p>&nbsp;<p>
<h3>Step 3: Check the basic installation</h3>
<p>
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 <strong>.mbse</strong> i.e: those were the original files.
2002-01-21 22:20:54 +00:00
The installation logfile is copied to /opt/mbse.
If everythings is allright, then remove the directory /tmp/mbsebbs-@VERSION@:
2001-10-22 17:33:55 +00:00
<pre>
cd /tmp
rm -Rf mbsebbs-@VERSION@
2001-10-22 17:33:55 +00:00
</pre>
<p>&nbsp;<p>
<h3>Step 4: Install the basic packages.</h3>
<p>
2001-12-25 17:57:32 +00:00
Login as user <b>mbse</b>. Yes, very important, <b>login as user mbse</b>.
2002-01-21 22:20:54 +00:00
While in mbse's home directory (/opt/mbse) unpack the distribution archives:
2001-10-22 17:33:55 +00:00
<pre>
2004-01-21 20:32:00 +00:00
tar xfvj /path/to/mbsebbs-@VERSION@.tar.bz2
2001-10-22 17:33:55 +00:00
</pre>
You now have the subdirectory with sources in the right place.
2003-12-20 21:13:22 +00:00
Next build the binaries and install them using the following commands:
2001-10-22 17:33:55 +00:00
<pre>
cd ~/mbsebbs-@VERSION@
2001-10-22 17:33:55 +00:00
./configure
make
2001-12-25 17:57:32 +00:00
su <b>important, do not use "su -"</b>
2001-10-22 17:33:55 +00:00
password: <em>enter root password here</em>
make install
exit
</pre>
The last part of the installation procedure shows you the location of the bbs
2002-01-21 22:20:54 +00:00
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.
2001-10-22 17:33:55 +00:00
If they already exist on your systems (when you do an upgrade) they
will not be installed again.
<p>
2002-01-21 22:20:54 +00:00
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 <b>start</b>.
For example:
<pre>
/etc/rc.d/init.d/mbsed start
</pre>
This will start the <b>mbtask</b> daemon.
After that the bbs will be opened for use.
Check the file <b>/opt/mbse/log/mbtask.log</b> for startup problems.
The first time <b>mbtask</b> is started on your system it will create a
lot of new configuration files with default settings.
2001-10-22 17:33:55 +00:00
<p>&nbsp;<p>
<h3>Step 5: (RedHat) startup problems.</h3>
<p>
From RedHat 6.1 (not the older versions) the behaviour of the
<strong>su</strong> is changed. This may be true for other distributions since
the end of 1999 and for Mandrake as well. The file <code>/etc/rc.d/init.d/mbsed</code> that is
created by the setup script is different then before. The new command
is <strong>su -</strong> instead of simply <strong>su</strong>. 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.
<p>&nbsp;<p>
2002-01-21 22:20:54 +00:00
<h3>Step 6: Ready.</h3>
2001-10-22 17:33:55 +00:00
<p>
2002-01-21 22:20:54 +00:00
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.<br>
2003-11-09 17:07:51 +00:00
Editing ansi screens can be done on a GNU/Linux system with one of the
following packages:
<ol>
<li><strong>duhdraw</strong>, this is available from 2:280/2802 as
<strong>duhdraw.tgz</strong> (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.</li>
<li><strong>bmdraw</strong> This editor is available from
<A HREF="http://www.drastic.net/bmdraw/">http://www.drastic.net/bmdraw/</A>,
you can find the tar.gz file in
<A HREF="http://www.drastic.net/bmdraw/files/bmd022.tgz">http://www.drastic.net/bmdraw/files/bmd022.tgz</A>,
it's about 36 Kbytes. This is also a thedraw clone for Linux.
Note, at my system I needed to run it as root.</li>
<li><strong>TetraDraw</strong> This is a very nice Ansi editor, you can
get this file as TETR~VC#.TGZ from 2:280/2802. The file is 157 Kbytes.
</ol>
2002-01-21 22:20:54 +00:00
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.
<P>
Now the basic environment is finished, the next thing to do is
<a href="setup/index.htm">configure the bbs</a>.
2001-10-22 17:33:55 +00:00
<P>&nbsp;<P>
2002-01-21 22:20:54 +00:00
<a href="index.htm"><img SRC="images/b_arrow.png" ALT="Back to Index" BORDER=0>Back to Index</a>
2001-10-22 17:33:55 +00:00
</blockquote>
</body>
</html>