#################################################################
#             Message Board V4.0.1 (Freeware)
#
# This program is distributed as freeware. We are not            	
# responsible for any damages that the program causes	
# to your system. It may be used and modified free of 
# charge, as long as the copyright notice
# in the program that give me credit remain intact.
# If you find any bugs in this program. It would be thankful
# if you can report it to us at cgifactory@cgi-factory.com.  
# However, that email address above is only for bugs reporting. 
# We will not  respond to the messages that are sent to that 
# address. If you have any trouble installing this program. 
# Please feel free to post a message on our CGI Support Forum.
# Selling this script is absolutely forbidden and illegal.
##################################################################
#
#               COPYRIGHT NOTICE:
#
#         Copyright 1999-2000 CGI-Factory.com TM 
#		  A subsidiary of SiliconSoup.com LLC
#
#
#      Web site: http://www.cgi-factory.com
#      E-Mail: cgifactory@cgi-factory.com
#      Released Date: April 08, 2000
#	
#   Message Board V4.0 is protected by the copyright 
#   laws and international copyright treaties, as well as other 
#   intellectual property laws and treaties.
###################################################################


Installation 

How do I install Message Board V4.0 (Freeware)?

In MB V4.0, you don't have to modify the variables with a text editor anymore. It is totally browser based.

Unfortunately, MB V4.0 doesn't work with the old message files from any previous version of the message board
products. So you will need to restart
the board.

*It is suggested that you create a sub directory under your cgi-bin then install the scripts there. 
For example, /cgi-bin/messageboard

1) If the path to perl on your server is different from
#!/usr/local/bin/perl 
then you will need to change it on the first line in view.pl ,message.pl, and configur.pl



2) Open all footer and header files separately with a text editor and modify them 
to fit the lay out of your web site. (header.txt, footer.txt, vheader.txt, and vfooter.txt)

header.txt and footer.txt are for the layout of each message post
vheader.txt and vfooter.txt are for the message board index page



3) Upload all files (including the folder "data" and all files under it) but the image files to your cgi-bin in ASCII(plain text).
(errorlog.txt, header.txt, footer.txt, vheader.txt, vfooter.txt, superuser.db, vcfg.pl, mcfg.pl, mgcfg.pl, 
view.pl, message.pl, configur.pl, data(dir), board1.bd, and board1.txt)

Please visit our FAQ section <http://www.cgi-factory.com/faq.shtml>
if you want to know how to upload a file in ASCII mode.



4) Chmod all *.pl files to permission "755." 
(Chmod mcfg.pl, vcfg.pl, mgcfg.pl, view.pl, message.pl, and configur.pl to permission "755")

*However, if you get a permission denied message when you save the configurations, you will need to
chmod mcfg.pl, vcfg.pl, and mgcfg.pl to permission "777."


5) Chmod all *.txt and *.db files to permission "755" first. However, chmoded them to "777" only when you get a 
permission denied message. For example, a permission denied message when you save your superuser name and password.  
(errorlog.txt, header.txt, footer.txt, vheader.txt, vfooter.txt, forbid.txt, superuser.db, board1.bd(under the data directory), and board1.txt(under the data directory))

Please visit our FAQ section <http://www.cgi-factory.com/support/faq.shtml> if you want to know how to chmod a file.



6) Execute configur.pl with your browser (point the browser to http://www.your_site.com/cgi-bin/configur.pl)



7) Set the superuser admin name and password then reload the browser to set the configurations.

For the first field, it is the system path to the "data" directory that you have just uploaded. 
For the field (near the end) that reads "Full System path the the message directory," 
it is the directory that you want to use for storing the message files. this directory should not be created
in the cgi-bin.

The system path looks somewhat like /web/home/httpd/cgi-bin... 
Usually, you can obtain the system path from your server admin. 
If you can use telnet to access your server, type in "pwd" after you have logged in. 
The PWD command will return your current system path.



8) Create the directory that you've set the path in configur.pl for storing the message files. Chmod it
to permission "755".

*However, if you get a permission denied message when you add a new board, you will need to
chmod this data directory to permission "777."

9) Make a link to view.pl, it will be your message board main page.

Important note for windows servers users: 

You need to open 
message.pl, view.pl, and configur.pl, 
then modify the variables- $mcfg, $vcfg, mgcfg, and $smtp_mail to full system path. 


What is the function of each file? <Skip this section if you are not interested>

header.txt- header for message.pl.
footer.txt- footer for message.pl.
vheader.txt- header for view.pl.
vfooter.txt- footer for view.pl.
superuser.db- The file for storing the super user name and password.
mcfg.pl- Configurations for your message board. 
vcfg.pl- Configurations for your message board. 
mgcfg.pl- Configurations for your message board.
message.pl- Receives the input data from the board then post them as a message.
view.pl- Displays all messages that were posted.
smtp_mail.lib - SMTP/TCP lib

readme.txt- Instructions for installing this script.
document.gif- Image file.