Updated docs

This commit is contained in:
Michiel Broek 2002-02-09 21:59:30 +00:00
parent 7478093023
commit ac0cfabf3d
4 changed files with 124 additions and 24 deletions

View File

@ -52,7 +52,7 @@ H_MENUS = menus/control.html menus/index.htm menus/menu100.html \
H_MISC = misc/dropfile.html misc/fileid.html misc/index.htm \ H_MISC = misc/dropfile.html misc/fileid.html misc/index.htm \
misc/jam.html misc/semafore.html misc/filefind.html \ misc/jam.html misc/semafore.html misc/filefind.html \
misc/ftpserver.html misc/ipmailer.html misc/outbound.html \ misc/ftpserver.html misc/ipmailer.html misc/outbound.html \
misc/usleep.html misc/usleep.html misc/webserver.html
H_PROGS = programs/import.html programs/mbchat.html \ H_PROGS = programs/import.html programs/mbchat.html \
programs/mbfido.html programs/mbmon.html \ programs/mbfido.html programs/mbmon.html \

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 04-Feb-2002</h5> <h5>Last update 09-Feb-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<h1>MBSE BBS Basic Installation</h1> <h1>MBSE BBS Basic Installation</h1>
@ -39,7 +39,8 @@ layout looks like this:<br>
/opt/mbse/english/txtfiles 0755 Default english ANSI files /opt/mbse/english/txtfiles 0755 Default english ANSI files
/opt/mbse/etc 0775 System configuration files /opt/mbse/etc 0775 System configuration files
/opt/mbse/fdb 0775 Files database /opt/mbse/fdb 0775 Files database
/opt/mbse/ftp 0755 Default FTP root /opt/mbse/ftp/css 0755 Stylesheet for MBSE BBS pages.
/opt/mbse/ftp/pub 0755 Default FTP root for download areas.
/opt/mbse/galego/macro 0755 N/A /opt/mbse/galego/macro 0755 N/A
/opt/mbse/galego/menus 0755 Galego menu files /opt/mbse/galego/menus 0755 Galego menu files
/opt/mbse/galego/txtfiles 0755 Galego ANSI files /opt/mbse/galego/txtfiles 0755 Galego ANSI files
@ -60,13 +61,13 @@ layout looks like this:<br>
/opt/mbse/var 0770 Var root /opt/mbse/var 0770 Var root
/opt/mbse/var/badtic 0750 Bad TIC files /opt/mbse/var/badtic 0750 Bad TIC files
/opt/mbse/var/bso 0750 Binkley Style Outbound directory /opt/mbse/var/bso 0750 Binkley Style Outbound directory
/opt/mbse/var/bso/inbound 0750 Protected inbound directory /opt/mbse/var/bso/outbound 0750 Default outbound for main aka
/opt/mbse/var/bso/outbound 0750 Default outbound directory /opt/mbse/var/inbound 0750 Protected inbound directory
/opt/mbse/var/bso/unknown 0750 Unprotected inbound directory
/opt/mbse/var/mail 0770 JAM messagebase root /opt/mbse/var/mail 0770 JAM messagebase root
/opt/mbse/var/msgs 0750 *.msgs netmail directory (not yet in use). /opt/mbse/var/msgs 0750 *.msgs netmail directory (not yet in use).
/opt/mbse/var/nodelist 0750 Nodelists /opt/mbse/var/nodelist 0750 Nodelists
/opt/mbse/var/ticqueue 0750 Queue for TIC files /opt/mbse/var/ticqueue 0750 Queue for TIC files
/opt/mbse/var/unknown 0750 Unprotected inbound directory
</pre> </pre>
<p> <p>
Don't use UMSDOS or SAMBA filesystems for the bbs, stick by the standard Linux Don't use UMSDOS or SAMBA filesystems for the bbs, stick by the standard Linux

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 27-Jan-2002</h5> <h5>Last update 09-Feb-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>How to setup an FTP server to work with MBSE BBS.</H1> <H1>How to setup an FTP server to work with MBSE BBS.</H1>
@ -22,8 +22,9 @@ In order to let MBSE BBS and your FTP server to both function together you must
organize a special file structure. Note that even if you don't setup an FTP organize a special file structure. Note that even if you don't setup an FTP
server you must still create a structure like this for the fidonet mailer, server you must still create a structure like this for the fidonet mailer,
if you don't, <strong>mail and files will get lost!</strong> if you don't, <strong>mail and files will get lost!</strong>
Note that this description is written for wu-ftpd, on your distribution there This description is written for ProFTPD, on your distribution there
may be another ftpd installed. <font color=red><u>Don't use mbftpd yet!</u></font> may be another ftpd installed. <font color=red><u>Don't use mbftpd yet!</u></font>
Read the section for the <A HREF="webserver.html">webserver</A> as well.
<P> <P>
<H4>The filestructure I used is as follows:</H4> <H4>The filestructure I used is as follows:</H4>
<PRE> <PRE>
@ -31,21 +32,28 @@ may be another ftpd installed. <font color=red><u>Don't use mbftpd yet!</u></fon
| | | /dos_disk | | | /dos_disk
| | | /dos_file | | | /dos_file
| | /virnet/mcafee | | /virnet/mcafee
| | /win16 | | | /win16
| | /win32 | | | /win32
| /bin - FTP bin directory | | /css/files.css - Stylesheet for http download
| /etc - FTP etc directory
| /incoming - FTP public upload. | /incoming - FTP public upload.
/var/bso/outbound - Your default outbound /var/bso/outbound - Your default outbound
| /outbound.009 - Outbound Zone 9 | /outbound.009 - Outbound Zone 9
| /inbound - Inbound directory /inbound - Inbound directory
/private/upload - Non-public download areas /private/upload - Non-public download areas
| /sysop | /sysop
| /logfiles | /logfiles
/tic_queue - Queue for .tic files. /tic_queue - Queue for .tic files.
</PRE> </PRE>
To let this work you need to change the default anonymous directory of the
ftp server to /opt/mbse/pub. As root, edit /etc/passwd with the <b>vipw</b>
command. Look for the entry of the ftp user and change his homedirectory to
/opt/mbse/ftp. You may also use the command <b>usermod -d /opt/mbse/ftp ftp</b>
to do the same. For a start the default configuration file for ProFTPD will do
fine. If you want to let users upload into the incoming directory, you need to
change /etc/proftpd.conf file to allow that.
<P>
If another DOS/Windows style mailer has access to your MBSE outbound you must If another DOS/Windows style mailer has access to your MBSE outbound you must
set the DOS path and Unix path in <strong>mbsetup</strong> (1.4.12 and 1.4.13) to set the DOS path and Unix path in <strong>mbsetup</strong> (1.4.12 and 1.4.13) to
<strong>"m:"</strong> and <strong>"/opt/mbse"</strong>. Note that to get <strong>"m:"</strong> and <strong>"/opt/mbse"</strong>. Note that to get
@ -64,22 +72,16 @@ users have <b>mbsebbs</b> as their shell and this shell is not in the file
<b>/etc/shells</b> the ftp daemon will not let the bbs users in. So even <b>/etc/shells</b> the ftp daemon will not let the bbs users in. So even
your own bbs users must login as anonymous to get files from the ftp server. your own bbs users must login as anonymous to get files from the ftp server.
<P> <P>
Note the following directory permissions MUST BE SET!!!!::: See also The following is a list of file permissions when using ProFTPD:
the man pages for the DARPA ftpd server.
<P> <P>
<PRE> <PRE>
Directory owner group mode perms Directory owner group mode perms
------------------------------- ----- ----- ---- ---------- ------------------------------- ----- ----- ---- ----------
/opt/mbse mbse bbs 0755 drwxr-xr-x /opt/mbse mbse bbs 0775 drwxrxxr-x
/opt/mbse/ftp root wheel 0555 dr-xr-xr-x /opt/mbse/ftp root root 0755 drxxr-xr-x
/opt/mbse/ftp/bin root wheel 0555 dr-xr-xr-x /opt/mbse/ftp/pub mbse bbs 0755 drwxr-xr-x
/opt/mbse/ftp/bin/ls root bin 0111 ---x--x--x /opt/mbse/ftp/incoming ftp ftp 0755 drwxr-xr-x
/opt/mbse/ftp/etc root root 0555 dr-xr-xr-x
/opt/mbse/ftp/etc/passwd root root 0444 -r--r--r--
/opt/mbse/ftp/etc/group root root 0444 -r--r--r--
/opt/mbse/ftp/pub mbse bbs 0775 drwxrwxr-x
/opt/mbse/ftp/incoming ftp users 0755 drwxr-xr-x
</PRE> </PRE>
Note that all subdirectories under ../pub also must be owned by <strong>mbse Note that all subdirectories under ../pub also must be owned by <strong>mbse

97
html/misc/webserver.html Normal file
View File

@ -0,0 +1,97 @@
<HTML>
<!-- $Id$ -->
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css">
<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>Howto setup an webserver to work with MBSE BBS.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 09-Feb-2002</h5>
<P>&nbsp;<P>
<H1>How to setup an webserver to work with MBSE BBS.</H1>
<P>
<H3>Introduction</H3>
<P>
To let a webserver work with MBSE BBS you must organize a special file
structure.
Note that even if you don't setup a webserver you must still create a
structure like this for the fidonet mailer, if you don't,
<strong>mail and files will get lost!</strong>
This description is written for <A HREF="http://www.apache.org">Apache</A>,
this is installed on most Linux and xxxBSD distributions.
For the directory structure, read the setup for
<A HREF="ftpserver.html">the FTP server</A>.
<P>&nbsp;<P>
<H3>Important settings in mbsetup.</H3>
<P>
Screen 1.18:
<pre>
1. Base path /opt/mbse/ftp/pub
</pre>
Screen 1.19:
<pre>
1. Docs root /var/www/htdocs
2. Link to ftp files
3. URL name http://www.mbse.ym
</pre>
The base ftp path is the default which mbse bbs installs. The Docs root for the
apache httpd server is different on each distribution, in this example it is set
for <A HREF="http://www.slackware.com">Slackware 8.0</A>. Because the directory
/var/www/htdocs has nothing to do with /opt/mbse/ftp/pub we make an alias link
named <b>files</b>. For the URL name you must fill in the real internet name how
your bbs is reached. If someone types this in, he must get the index.html from
the directory /var/www/htdocs, the docs root. I just assume you have your http
server up and running.
<p>
Now you can run the command <b>mbfile index</b>, this will create a main index
in the directory /opt/mbse/ftp/pub and additional index.html files in all your
download areas.
<P>&nbsp;<P>
<H3>Change Apache server configuration.</H3>
<P>
As root edit your httpd.conf file, it is possible that you find it in
/etc/apache, but that depends on your distribution. In the section between
&lt;IfModule mod_alias.c&gt; and &lt;/IfModule&gt; insert the following lines:
<pre>
#
# Alias for MBSE BBS download areas.
#
Alias /files/ /opt/mbse/ftp/pub/
&lt;Directory "/opt/mbse/ftp/pub"&gt;
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
&lt;/Directory&gt;
#
# Alias to access the MBSE BBS documenatation
#
Alias /mbseman/ /opt/mbse/html/
&lt;Directory "/opt/mbse/html"&gt;
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
&lt;/Directory&gt;
</pre>
Then restart Apache with the command <b>apachectl restart</b> Now if you access
your webserver with for example http://www.mybbs.com/files/ you must be able to
browse the filelists. If you use http://www.mybbs.com/mbseman/ you must be able
to browse this documentation online.
<P>
<A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0">Go Back</A>
</BLOCKQUOTE>
</BODY>
</HTML>