Updated docs and FAQ

This commit is contained in:
Michiel Broek 2002-10-28 15:57:05 +00:00
parent 7cd927c877
commit 6e30d29ce4
2 changed files with 916 additions and 869 deletions

View File

@ -3,31 +3,21 @@
<head> <head>
<!-- $Id$ --> <!-- $Id$ -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css"> <meta http-equiv="Content-Style-Type" content="text/css">
<meta name="GENERATOR" content="vi handcraft"> <meta name="GENERATOR" content="vi handcraft">
<meta name="author" lang="en" content="Michiel Broek"> <meta name="author" lang="en" content="Michiel Broek">
<meta name="description" lang="en" content="MBSE BBS Manual"> <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"> <meta name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
<title>MBSE BBS FAQ &amp; Howto</title> <title>MBSE BBS FAQ &amp; Howto</title>
<link rel="stylesheet" href="manual.css"> <link rel="stylesheet" href="manual.css">
</head> </head>
<body> <body>
<blockquote> <blockquote>
<div align="Center">
<h1>MBSE BBS FAQ and Howto.</h1>
</div>
<div align="Center"><h1>MBSE BBS FAQ and Howto.</h1></div>
<hr> <hr>
<div align="Right"> <div align="Right"><h5>Last updated 28-Oct-2002</h5></div>
<h5>Last updated 10-Jul-2002</h5>
</div>
<pre> Author: P.E. Kimble aka King Kimerud<br> kimerud@bayhaus.org<br> </pre> <pre> Author: P.E. Kimble aka King Kimerud<br> kimerud@bayhaus.org<br> </pre>
Introduction Introduction
@ -88,11 +78,9 @@ out.</a>
</li> </li>
<ol> <ol>
<li><a href="#3.1">Posting newsmessages to the newsserver fails.</a> <li><a href="#3.1">Posting newsmessages to the newsserver fails.</a></li>
</li> <li><a href="#3.2">FTP fidonet feeds how-to.</a></li>
<li><a href="#3.2">FTP fidonet feeds how-to.</a> <li><a href="#3.3">Polling a internet node fails</a></li>
</li>
</ol> </ol>
<p>&nbsp;</p> <p>&nbsp;</p>
@ -359,16 +347,13 @@ It is meant only as a description for the filearea. </td>
</tr> </tr>
<tr> <tr>
<td valign="Top">A 2.5</td> <td valign="Top">A 2.5</td>
<td> No, not directly. It is a matter of using scripts to translate <td> Yes, but only the passive side. <a href="#2.5">Refer to 3.2.</a>
the .*lo (*.flo, *.clo, *.dlo, *.ilo) files for each node, and copying the
node's outbound files to their respective directory. <a href="#2.5">Refer
to 3.2.</a>
</td> </td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<a href="#_Fidosetup"><img src="images/hand.up.gif" border="0" alt="Up"> <a href="#_Fidosetup"><img src="images/hand.up.gif" border="0" alt="Up">
</a> </a>
</p> </p>
<p> </p> <p> </p>
<hr> <hr>
@ -390,10 +375,10 @@ Set this flag in mbsetup 1.15.5 </td>
</tbody> </tbody>
</table> </table>
<a href="#_Inetsetup"><img src="images/hand.up.gif" border="0" alt="Up"> <a href="#_Inetsetup"><img src="images/hand.up.gif" border="0" alt="Up">
</a> </a>
<p> <p>
<table width="100%"> <table width="100%">
<tbody> <tbody>
<tr> <tr>
<td width="50" valign="Top"><a name="3.2">Q 3.2</a> <td width="50" valign="Top"><a name="3.2">Q 3.2</a>
@ -403,55 +388,107 @@ Set this flag in mbsetup 1.15.5 </td>
<tr> <tr>
<td valign="Top">A 3.2</td> <td valign="Top">A 3.2</td>
<td> <td>
Follow the next steps to setup your system for FTP clients.
<ol> <ol>
<li>In mbsetup menu 1.4.12:2, remove any reference to a DOS translation path. <li>As root, add a new group to your system: <b>groupadd bbsftp</b>.
</li> <li>Make sure there is a directory /opt/mbse/var/bbsftp. This directory
<li> In mbsetup menu 1.4.12:3, remove any reference to a DOS translation should be owned by mbse, group bbs and have mode 0775.
path. </li> <li>Add an invalid shell to /etc/shells, /usr/bin/false is good.
</ol> <li>Install an FTP server, the examples here are for ProFTPD.
This will give you a "True" path to your files directory where mbcico tosses <li>In /etc/proftpd.conf make sure there are the following lines:
the inbound files. <pre>
<ol> # Anonymous ftp and members of group bbsftp have a chroot environment.
<li value="3"> Ftp Script for running a ftp feed with MBSE.<br> DefaultRoot ~ bbsftp
NOTE: Gracefully contributed by Janis Kacht &lt;janis@filegate.net&gt; </pre>
<p> This script does not delete or change the .flo file. It reads This will make sure that users who are member of the bbsftp group have
it in and creates a new script that will be used to move and copy the files a chrooted directory structure for their ftp directories.
to the user's outbound directory you specify on the command line. Just call Also make sure the line Umask 022 is changed to Umask 002.
this script, then call the finalflo.sh script with the directory name where <li>Add a username for the node you whish to give an FTP feed. Use the
the files should be PUT, like: </p> following as root:
<p> </p> <pre>
<pre>parseflo &lt;enter&gt;<br>finalflo.sh /home/fido/jdoe/out &lt;enter&gt;<br></pre> useradd -g bbs -G bbsftp -d /opt/mbse/var/bbsftp/username
-s /usr/bin/false -c "FTP Account for username" -m username
</pre>
Note: this is one line!
There will now be a user added and have a home directory of
/opt/mbse/var/bbsftp/username. Make sure that directory has permission
0775 or 0770. Create in the username directory two other directories,
inbound and outbound. They must be owned by the user and be a member of
group bbs and have mode 0775. The modes 077x are needed because the
user and mbse must be able to read and write to these directories.
<li>Try to login with ftp from some other system with the choosen
username and his password and check the changes until now. You should
not be able to escape from the directories of this user and you should
be able to upload files, download and delete files. Check also if you
uploaded a file if user mbse can delete that file and also put a file
in the users ftp directory as user mbse, and check that you can
download and delete is as ftp user.
<li>
Make sure for the node you want to change there is no mail left in the
outbound.
Now start mbsetup, menu 7, open the setup of the node that will use
ftp. In screen 3, items 7 and 8, set these to Directory. Now enter
screen 8, here you will setup the directory session.
<pre>
7.8 EDIT NODE DIRECTORY SESSION
<p> You will need a full path to the flo file in the "test" line Outbound settings
below and change the name of the flo file (it's not going to be 00000063.flo) 1. Files path /opt/mbse/var/bbsftp/username/outbound
Uncomment the "if test" line, and also uncomment the last line (fi) </p> 2. Check for lock Yes 3. Wait clear lock No
<pre>#!/bin/sh<br>if test -e /opt/mbse/mail/outbound/00000063.flo ; then<br> cat 00000063.flo | sed 's/\/home/cp \/home/' &gt; newflo.txt<br> cat newflo.txt | sed 's/\^\cp \/home/mv \/home/'&gt; newflo2.txt<br> cat newflo2.txt | sed 's/$/ \$1/' &gt; finalflo.sh<br>fi<br></pre> 4. Check lockfile /opt/mbse/var/bbsftp/username/lock.bsy
5. Create lock Yes
6. Create lockfile /opt/mbse/var/bbsftp/username/lock.bsy
<p> here's what finalflo.sh looks like, $1 is a variable for Inbound settings
the directory name you specify on the command line, or in a cron script: 7. Files path /opt/mbse/var/bbsftp/username/inbound
</p> 8. Check for lock Yes 9. Wait clear lock Yes
<pre>cp /home/ftp/pub/filegate/fg_worf/filegate.zxx $1<br>mv /opt/mbse/mail/outbound/00000063/dooqi39k.tic $1<br>cp /home/ftp/pub/filegate/ss_areas/ss_areas.zip $1<br>mv /opt/mbse/mail/outbound/00000063/dooqi39l.tic $1<br>cp /home/ftp/pub/filebone/admin/backbone/backbone.z1b $1<br>mv /opt/mbse/mail/outbound/00000063/dooqi39m.tic $1<br></pre> 10. Check lockfile /opt/mbse/var/bbsftp/username/lock.bsy
11. Create lock Yes
<p> Janis Kracht can not and will not be held liable if harm 12. Create lockfile /opt/mbse/var/bbsftp/username/lock.bsy
is done to your computer system due to any use of this script, either directly </pre>
or indirectly. This script works perfectly when instructions are followed, Save this and you are ready.
and the correct directories are substitiuted. How it will affect your system, <li>A final note, since this user is in group bbs and not in the bbs
is the responsiblity of the system administrator! </p> userdatabase he can never telnet to your system with this account and
</li> get a shell. The user doesn't even have a valid shell.
<li> Do not forget to test this setup. It has work fine on my
system, but nothing works the way it should the first time out of the box!
Pay close attention to the ftp script and directories you enter. It seems
as if 75% of the problems experinced with this sed script is due to improper
outbound directories </li>
</ol> </ol>
</td> </td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<a href="#_Inetsetup"><img src="images/hand.up.gif" border="0" alt="Up">
</a> <a href="#_Inetsetup"><img src="images/hand.up.gif" border="0" alt="Up"></a>
</p> </p>
<p> </p>
<p>
<table width="100%">
<tbody>
<tr>
<td width="50" valign="Top"><a name="3.3">Q 3.3</a>
</td>
<td>Polling a internet node fails.</td>
</tr>
<tr>
<td valign="Top">A 3.3</td>
<td>
There are several reasons why mbcico refuses to call an internet node, most
problems are nodelist related. A internet node with binkp protocol should be
listed with the flags CM,IBN before mbcico will make a call. Also, in the
nodelist system name field there should be the hosts full qualified
domainname so that mbcico can get that node's IP address. If one of these
items are missing, the node will not be called. To correct this problem there
are two options, make sure the node is listed with a dns name and proper
flags in the nodelist. The second option is to add a setup record for that
node and fill in the nodelist override fields. You can find these in menu
7.3, item 5 can be filled with the nodelist flags, ie. CM,IBN and item 6 can
be used to give that node's fdn or IP address.
</td>
</tr>
</tbody>
</table>
<a href="#_Inetsetup"><img src="images/hand.up.gif" border="0" alt="Up"></a>
</p>
<p></p>
<hr> <hr>
<h3><a name="4">4. BBS setup.</a> <h3><a name="4">4. BBS setup.</a>
</h3> </h3>

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<div align="right"><h5>Last update 28-Sep-2002</h5></div> <div align="right"><h5>Last update 28-Oct-2002</h5></div>
<div align="center"><H1>MBSE BBS Setup - Global Setup</H1></div> <div align="center"><H1>MBSE BBS Setup - Global Setup</H1></div>
<P> <P>
@ -237,17 +237,19 @@ will be updated automatic.
<strong>Max. dupes </strong>The maximum number of entries in dupe database <strong>Max. dupes </strong>The maximum number of entries in dupe database
<strong>Keep date </strong>Keep original filedate <strong>Keep date </strong>Keep original filedate
<strong>Keep netm </strong>Keep sent netmails <strong>Keep netm </strong>Keep sent netmails
<strong>Res future </strong>Reset dates in the future
<strong>Loc resp </strong>Respond to local created filefind messages <strong>Loc resp </strong>Respond to local created filefind messages
<strong>Repl ext </strong>Replace filename extension with .* before filesearch
<strong>Plus all </strong>Allow filemgr +all command <strong>Plus all </strong>Allow filemgr +all command
<strong>Notify </strong>Allow filemgr notify=on/off command <strong>Notify </strong>Allow filemgr notify=on/off command
<strong>Passwd </strong>Allow filemgr passwd command <strong>Passwd </strong>Allow filemgr/areamgr passwd command
<strong>Message </strong>Allow filemgr message=on/off command <strong>Message </strong>Allow filemgr message=on/off command
<strong>Tic on/off </strong>Allow filemgr tic=on/off command <strong>Tic on/off </strong>Allow filemgr tic=on/off command
<strong>Pause </strong>Allow filemgr pause/resume commands <strong>Pause </strong>Allow filemgr pause/resume commands
</pre><p> </pre><p>
When you change one of the <b>Allow filemgr</b> settings, you also need to edit
the file /opt/mbse/english/macro/filemgr.help to reflect the new settings.
Default all these switches are set to Yes.
<p>
<h3>1.14. Edit Fidonet mail and echomail processing.</h3> <h3>1.14. Edit Fidonet mail and echomail processing.</h3>
<p> <p>
Note that the first 2 mailboards must also exist in the normal mail areas if Note that the first 2 mailboards must also exist in the normal mail areas if
@ -281,7 +283,15 @@ it is necessary.<br>
<strong>4d address </strong>Use 4d. addressing (not needed you only use MBSE BBS) <strong>4d address </strong>Use 4d. addressing (not needed you only use MBSE BBS)
<strong>Split at </strong>Gently split messages after n KBytes (12..60) <strong>Split at </strong>Gently split messages after n KBytes (12..60)
<strong>Force at </strong>Force split of messages after n KBytes (16..63) <strong>Force at </strong>Force split of messages after n KBytes (16..63)
<strong>Plus all </strong>Allow areamgr +all command
<strong>Notify </strong>Allow areamgr notify=on/off command
<strong>Passwd </strong>Allow areamgr/filemgr passwd command
<strong>Pause </strong>Allow areamgr pause/resume commands
</pre><p> </pre><p>
When you change one of the <b>Allow areamgr</b> settings, you also need to edit
the file /opt/mbse/english/macro/areamgr.help to reflect the new settings.
Default all these switches are set to Yes.
<P>
A note about the splitting of messages. Some tossers can't handle A note about the splitting of messages. Some tossers can't handle
messages greater than 16 KBytes, these tossers are rare these days. Most messages greater than 16 KBytes, these tossers are rare these days. Most
tossers can handle messages of 32 KBytes. To set these values on the safe tossers can handle messages of 32 KBytes. To set these values on the safe