From ac0cfabf3d62ef6bb9fab4c0704be8de4744e4a9 Mon Sep 17 00:00:00 2001 From: Michiel Broek Date: Sat, 9 Feb 2002 21:59:30 +0000 Subject: [PATCH] Updated docs --- html/Makefile | 2 +- html/basic.html | 11 ++--- html/misc/ftpserver.html | 38 ++++++++-------- html/misc/webserver.html | 97 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 124 insertions(+), 24 deletions(-) create mode 100644 html/misc/webserver.html diff --git a/html/Makefile b/html/Makefile index 68ebe640..08634bd6 100644 --- a/html/Makefile +++ b/html/Makefile @@ -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 \ misc/jam.html misc/semafore.html misc/filefind.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 \ programs/mbfido.html programs/mbmon.html \ diff --git a/html/basic.html b/html/basic.html index 661edfdf..b023ad35 100755 --- a/html/basic.html +++ b/html/basic.html @@ -12,7 +12,7 @@
-
Last update 04-Feb-2002
+
Last update 09-Feb-2002

 

MBSE BBS Basic Installation

@@ -39,7 +39,8 @@ layout looks like this:
/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 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/menus 0755 Galego menu files /opt/mbse/galego/txtfiles 0755 Galego ANSI files @@ -60,13 +61,13 @@ layout looks like this:
/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/inbound 0750 Protected inbound directory -/opt/mbse/var/bso/outbound 0750 Default outbound directory -/opt/mbse/var/bso/unknown 0750 Unprotected inbound 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 diff --git a/html/misc/ftpserver.html b/html/misc/ftpserver.html index 7228339f..17c89358 100644 --- a/html/misc/ftpserver.html +++ b/html/misc/ftpserver.html @@ -12,7 +12,7 @@

-
Last update 27-Jan-2002
+
Last update 09-Feb-2002

 

How to setup an FTP server to work with MBSE BBS.

@@ -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 server you must still create a structure like this for the fidonet mailer, if you don't, mail and files will get lost! -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. Don't use mbftpd yet! +Read the section for the webserver as well.

The filestructure I used is as follows:

@@ -31,21 +32,28 @@ may be another ftpd installed. Don't use mbftpd yet!
+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 vipw
+command. Look for the entry of the ftp user and change his homedirectory to
+/opt/mbse/ftp. You may also use the command usermod -d /opt/mbse/ftp ftp
+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.
 
+

 If another DOS/Windows style mailer has access to your MBSE outbound you must
 set the DOS path and Unix path in mbsetup (1.4.12 and 1.4.13) to 
 "m:" and "/opt/mbse". Note that to get 
@@ -64,22 +72,16 @@ users have mbsebbs as their shell and this shell is not in the file
 /etc/shells 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.
 

-Note the following directory permissions MUST BE SET!!!!::: See also
-the man pages for the DARPA ftpd server.
+The following is a list of file permissions when using ProFTPD:
 

 
 
 Directory               	owner group mode perms
 ------------------------------- ----- ----- ---- ----------
-/opt/mbse			mbse  bbs   0755 drwxr-xr-x
-/opt/mbse/ftp			root  wheel 0555 dr-xr-xr-x
-/opt/mbse/ftp/bin		root  wheel 0555 dr-xr-xr-x
-/opt/mbse/ftp/bin/ls		root  bin   0111 ---x--x--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
+/opt/mbse			mbse  bbs   0775 drwxrxxr-x
+/opt/mbse/ftp			root  root  0755 drxxr-xr-x
+/opt/mbse/ftp/pub		mbse  bbs   0755 drwxr-xr-x
+/opt/mbse/ftp/incoming   	ftp   ftp   0755 drwxr-xr-x
 
 

 Note that all subdirectories under ../pub also must be owned by mbse
diff --git a/html/misc/webserver.html b/html/misc/webserver.html
new file mode 100644
index 00000000..bc9be1e7
--- /dev/null
+++ b/html/misc/webserver.html
@@ -0,0 +1,97 @@
+
+
+
+
+
+
+
+
+
+Howto setup an webserver to work with MBSE BBS.
+
+
+
+

+
Last update 09-Feb-2002

+
 

+
+
How to setup an webserver to work with MBSE BBS.

+

+
Introduction

+

+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, 
+mail and files will get lost!
+This description is written for Apache,
+this is installed on most Linux and xxxBSD distributions. 
+For the directory structure, read the setup for
+the FTP server.
+
 

+
+
Important settings in mbsetup.

+

+Screen 1.18:
+
+1.  Base path      /opt/mbse/ftp/pub
+

+Screen 1.19:
+
+1.  Docs root      /var/www/htdocs
+2.  Link to ftp    files
+3.  URL name       http://www.mbse.ym
+

+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 Slackware 8.0. Because the directory
+/var/www/htdocs has nothing to do with /opt/mbse/ftp/pub we make an alias link
+named files. 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.
+

+Now you can run the command mbfile index, this will create a main index
+in the directory /opt/mbse/ftp/pub and additional index.html files in all your
+download areas.
+
 

+
+
Change Apache server configuration.

+

+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
+<IfModule mod_alias.c> and </IfModule> insert the following lines:
+
+    #
+    # Alias for MBSE BBS download areas.
+    #
+    Alias /files/ /opt/mbse/ftp/pub/
+    <Directory "/opt/mbse/ftp/pub">
+        Options Indexes MultiViews
+        AllowOverride None
+        Order allow,deny
+        Allow from all
+    </Directory>
+
+    #
+    # Alias to access the MBSE BBS documenatation
+    #
+    Alias /mbseman/ /opt/mbse/html/
+    <Directory "/opt/mbse/html">
+        Options Indexes MultiViews
+        AllowOverride None
+        Order allow,deny
+        Allow from all
+    </Directory>
+

+Then restart Apache with the command apachectl restart 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.
+
+

+BackGo Back
+

+
+
+