home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
HM11A.ZIP
/
SQNOTES.TXT
< prev
next >
Wrap
Text File
|
1992-10-24
|
7KB
|
145 lines
=======================================================================
Notes on using Harmony BBS with Squish
This file has been included to ease the integration of the popular
program Squish (tm) by Scott Dudley with Harmony BBS.
You should have a full understanding of both programs before hand!
=======================================================================
With the new verison of Harmony BBS (v1.1), came the arrival of
a new format for all the message bases and the post office.
This format was originally writtem by Scott Dudley for the
Maximus BBS program, but has become widely accepted throughout
the BBS community because of it flexibility and speed.
Anyway, enough small talk, lets get to it ...
===================
Step 1 : Make sure that you have defined all of the message
bases that you would like on Harmony BBS. More can be added
later, but it will take a lot more text editing.
Step 2 : Load up HMC from version 1.1 of Harmony BBS, and move
to the message base section. Now go to the menu choice called
SQUISH and run it.
HMC will scan through your message bases and create a text file
called AREAS.SQU in your main Harmony BBS directory.
Step 3 : Exit HMC, and with your favorite text editor, load up
your SQUISH.CFG file.
The first thing you have to configure is the post office section
of your BBS.
Go to the message areas section within your squish.cfg file, and
change your NETMAIL area to read :
NetArea NETMAIL C:\HM\SYSTEM\NETMAIL -$m300 -$d365 -p{net_addr}
The directory (c:\hm\system\netmail) should point to Harmony
BBS's system directory, and MUSY have the word NETMAIL attached
to the end of it.
The -p{net_addr} parameter is optional, and should only be
there if you are running a networked BBS. For more information
on the -p parameter, refer you the Squish documentation.
Another important note should be made here. If you are running
a front end mailer that expects your net mail to be in the
classic Fidonet *.MSG format (such as Front Door), you should
NOT define you net mail directory in the way just described. If
you do, your mailer will never be able to find your netmail and
will become fairly useless. Instead, you are going to have to
create 2 separate mail areas. One for Harmony BBS, and another
for your mailer. Example :
NetArea NETMAIL d:\hm\mail -p{net_addr}
EchoArea HMMAIL d:\hm\system\netmail -$m300 -$d365 -p{net_addr}
Notice the Harmony BBS's mail is no longer recognized as a
netmail area, rather an EchoArea. This setup just seemed to
work better for this type of configuration, but you can try
setting up both as a NetArea.
The $m300 and $d365 tells squish to only allow 300 private
messages within Harmony's post office, and keep them for a
maximum of 365 days. This is what Harmony BBS expects to see
also, so those numbers should not be changed.
Step 4 : Now simply merge the AREAS.SQU file that HMC has
created into the rest of the areas section in squish. There are
only 2 things which you may have to change in each of these
lines. Here is an example line from within the AREAS.SQU file :
EchoArea FIRESIDE C:\TELE\MSGS\Fireside -$m40 -$d14 -p1:260/445
IF you have not defined a NETNAME from within Harmony BBS during
each message bases creation, the second word (FIRESIDE) will not
be present. But since Squish looks for this name, you must add
one. If the message base is a networked message base, it MUST
match the area name expected by the network. If the message
base is a local message base to your system only, this line MUST
still be in the squish.cfg file, otherwise, no houework will
ever be done to it. Simply create an artificial area name, and
place it there.
The only other thing that may have to be changed in each line is
the -p{net_addr} parameter. If you are not running a networked
BBS at all, simply erase that parameter from the line. If you
are running it, make sure the that net_addr coincides with the
address required for that message base.
Finally, if you are hosting that message base for any other
systems, you will have to add those addresses manually to each
area.
DO NOT change the 3rd parameter on this line of text. It points
to the EXACT directory and file of each message base. It is used
from both within Squish and Harmony BBS.
===================
Finally, some notes on maintaining you message bases.
First, and most importantly -- Whenever mail is IMPORTED into
your message bases, or whenver SQPACK is executed, HMHOUSE -M
should be run immediately afterwards. Doing so lets Harmony BBS
know of any new changes to all the message bases. For those of
you who were running Harmony BBS v1.0, you will be pleased to
see the amount of time HMHOUSE -M now takes!
Secondly, it is propably a good idea to run SQPACK at least once
a day. For those not familiar with it, you would run it is sort
of like this :
SQPACK c:\hm\msgs\*.sqd
You should also run it on your post office squish file as much
as possible also :
SQPACK c:\hm\system\netmail.sqd
SQPACK should ALWAYS be run after a user has deleted a message
from within a message base. How do you know when this is done
you ask? Ahhh.. whenever someone deleted a message, Harmony
BBS will create a semaphore file called DELETED.MSG in its home
directory. Your batch file should look for the existance of
this file, and call SQPACK if it it is found. Make sure your
batch file also deletes DELETED.MSG otherwise it will be called
constantly after each user logs off (not that this is a bad
thing, but it will cause a lot of excess house work to be done).
Also be sure to run HMHOUSE -M after SQPACK.
================================
Well, thats pretty much the long and short of it. It isn't
really difficult at all to do, just make sure you know the
concepts before doing the work. It makes life a lot easier.