Updated docs

This commit is contained in:
Michiel Broek 2007-09-02 12:53:07 +00:00
parent 2166d0575f
commit eb495172a3
2 changed files with 34 additions and 4 deletions

View File

@ -14,7 +14,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<div align="right"><h5>Last update 01-Mar-2007</h5></div> <div align="right"><h5>Last update 02-Sep-2007</h5></div>
<div align="center"><h1>MBSE BBS Basic Installation</h1></div> <div align="center"><h1>MBSE BBS Basic Installation</h1></div>
<h3>Introduction.</h3> <h3>Introduction.</h3>
@ -32,7 +32,9 @@ some features. Here is a short list of these packages:
that will allow the PLZ extension. In the binkp protocol GZ compression will be enabled as well.</li> that will allow the PLZ extension. In the binkp protocol GZ compression will be enabled as well.</li>
<li><b>Bzlib</b>. On some distributions you need to install <b>bzlib2 development</b> to add <li><b>Bzlib</b>. On some distributions you need to install <b>bzlib2 development</b> to add
support for binkp BZ2 compression.</li> support for binkp BZ2 compression.</li>
</ol> </ol>
If you use Gentoo or Ubuntu, read the files README.Gentoo of README.Ubuntu. The last one may be usefull
for Debian users too.
<P>&nbsp;<p> <P>&nbsp;<p>
<h3>Step 1: planning the filesystems.</h3> <h3>Step 1: planning the filesystems.</h3>
@ -135,12 +137,17 @@ To start the script type:
cd mbsebbs-@VERSION@ cd mbsebbs-@VERSION@
bash ./SETUP.sh bash ./SETUP.sh
</pre> </pre>
Ubuntu users should do:
<pre>
cd mbsebbs-@VERSION@
sudo bash ./SETUP.sh
</pre>
Yes, use <b>bash</b> as shell here. On some systems root doesn't use bash 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. as login shell, calling the script with bash forces the use of bash.
The script does the following: The script does the following:
<ol> <ol>
<li>Create the group <strong>bbs</strong> <li>Create the group <strong>bbs</strong>
<li>Create the user <strong>mbse</strong> <li>Create the user <strong>mbse</strong> On Ubuntu this user is added to the admin group.
<li>Create a <strong>.profile</strong> for 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 <li>Create and set owner of directory tree under /opt/mbse
</ol> </ol>
@ -195,6 +202,13 @@ password: <em>enter root password here</em>
make install make install
exit exit
</pre> </pre>
Ubuntu users should do:
<pre>
cd ~/mbsebbs-@VERSION@
./configure [--enable-optimize] [--enable-newsgate] [--enable-gdkdel]
make
sudo make install
</pre>
<b>Important:</b> it seems logical to use the <code>--enable-newsgate</code> option <b>Important:</b> it seems logical to use the <code>--enable-newsgate</code> option
but it isn't. When you do, the mbnntp program is disabled and you cannot serve but it isn't. When you do, the mbnntp program is disabled and you cannot serve
echomail as news to your users via internet. But you can gate echomail to the echomail as news to your users via internet. But you can gate echomail to the
@ -219,6 +233,10 @@ For example:
<pre> <pre>
/etc/rc.d/init.d/mbsed start /etc/rc.d/init.d/mbsed start
</pre> </pre>
Ubuntu users do:
<pre>
sudo /etc/init.d/mbsebbs start
</pre>
This will start the <b>mbtask</b> daemon. This will start the <b>mbtask</b> daemon.
After that the bbs will be opened for use. After that the bbs will be opened for use.
Check the file <b>/opt/mbse/log/mbtask.log</b> for startup problems. Check the file <b>/opt/mbse/log/mbtask.log</b> for startup problems.

View File

@ -14,7 +14,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<div align="right"><h5>Last update 21-Jan-2004</h5></div> <div align="right"><h5>Last update 02-Sep-2007</h5></div>
<div align="center"><h1>Upgrade MBSE BBS</h1></div> <div align="center"><h1>Upgrade MBSE BBS</h1></div>
<h3>Introduction.</h3> <h3>Introduction.</h3>
@ -44,6 +44,14 @@ su <b>important, do not use "su -"</b>
password: <em>enter root password here</em> password: <em>enter root password here</em>
make install make install
</pre> </pre>
Ubuntu users should do:
<pre>
cd ~/mbsebbs-@VERSION@
make clean
./configure
make
sudo make install
</pre>
The last part of the installation procedure shows you the location of the bbs 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. startup script that is added to your system. Remember this one for a moment.
<p> <p>
@ -56,6 +64,10 @@ For example:
/etc/rc.d/init.d/mbsed reload /etc/rc.d/init.d/mbsed reload
exit exit
</pre> </pre>
Ubuntu users do:
<pre>
sudo /etc/init.d/mbsebbs restart
</pre>
This will close the bbs, kill <b>mbtask</b>, start the new <b>mbtask</b> and open This will close the bbs, kill <b>mbtask</b>, start the new <b>mbtask</b> and open
the bbs again for use. At this point you may need to update some configuration settings the bbs again for use. At this point you may need to update some configuration settings
with <b>mbsetup</b>. Read the ChangeLog for the details. The ChangeLog may also describe a with <b>mbsetup</b>. Read the ChangeLog for the details. The ChangeLog may also describe a