Sporum.Org
Newest Members: Most Recent Posts: SPT SPORUM SPMAIL |
 |
Necessities
(If you need help installing read over the FAQ) Release 3.0.0 information: download release Put in your top level directory (/home/username/sporum.tar.gz will do) This creates a directory called "sporum" and all the files will be inside this directory This will create the mysql database and the tables needed based upon your config settings Extra Install Information: Make sure you enter the correct themes directory in SmallPigVars.pm - if you make a mistake, the Themes field will be empty on one of the Preference pages, and if you save preferences serious errors will result. No Sporum pages will be able to load and you will get web server errors similar to this: Undefined subroutine &Templates::Default::get_stylesheet called at Templates/Default.pm line 601. To resolve this situation, deleting the Sporum database, fixing SmallPigVars.pm, and running "make install" again is a quick option if you don't yet have users or forums you want to keep. Old release notes for previous releases The release comes in two sections: Image Files If you install this on a virtual hosted account you would put this under your /home/user/public_html/ directory (/home/user/public_html/spt_imgs/) Otherwise you would need to install this images directory in the same directory as the /cgi-bin/ directory. (for apache: /usr/local/apache/) If you do move this to another directory you will need to replace all mappings to this image directory to your location of the image directory. Please do not link your forum images back onto this site. To find all the places necessary in the CGI Files you will need to do a grep to find them: (cd into the top level "spt" directory of the CGI Files to do this grep) grep -r spt_imgs * CGI Files Once you un-archive the CGI Files there will be several steps that must be followed: This release is configured to use perl from this location. If you location is different you will need to change all of the definitions to point to your perl location. You can do this with this command: perl -p -i -e "s| #!/usr/bin/perl | #!/your/path/to/perl |x" * (verify by grep -r "\/usr\/bin\/perl" * to see if you got them all) These are also the files you would modify to change the colors. Each of these has a directory under stp/sporum/ and a fkey entry in FVars.pm To create a new one: cp -r /spt/sporum/spt /spt/sporum/NEWNAME If you remove or rename these sub dirs, you MUST modify the FVars.pm fkey entries! (spt/sporum/CATNAME/SporumVars.pm) GRANT select, insert, update, create, alter, delete, drop ON database.* TO user@localhost IDENTIFIED BY 'password'; Where database is the name of the database you created, user is the name you specified in SmallPigVars.pm and password is the password you specified in SmallPigVars.pm To run these files: spt/setup/createtables. http://your.web.site/cgi-bin/spt/default.cgi?dpage=createadmin spt/Templates/createadmin.temp spt/createadmin.cgi http://your.web.site/cgi-bin/spt/sporum/cindex.cgi Then you will see your categories listed here with links to their pages: Follow each of them in turn to set up the respecitive section (category). You should come to a page like: http://your.web.site/cgi-bin/spt/sporum/CATNAME/index.cgi (CATNAME is your actual category name you assigned while installing) On this page you will have a link to an "admin" page - follow it: You must first create a category in this category (yes this is a little bit confusing - but when you see the page it will make sense). After you create categories you can then create boards to go in each category(in a category). spt/header.txt spt/footer.txt There exists a configured item in spt/SmallPigVars.pm which points to these two files. The release version points to files that are outside of this released directory structure, but there exists commented out lines that you can use to point to the existing files in the spt/ directory. (reference the instructions on installing spt) Each is in a table that is of a CSS class that is defined in all of the theme templates. This defines the look and feel of the table. Alter these two files to create your web site's look. - spt/cron/deleteusers.pl - spt/spmail/cron/deletemsg.pl - spt/spmail/cron/collectmail.pl - spt/sporum/cron/updateuserstatus.pl FOR EACH CATEGORY DEFINED: - spt/sporum/CATNAME/cron/deletefiles.pl - spt/sporum/CATNAME/cron/deleteusers.pl - spt/sporum/CATNAME/cron/delivermessages.pl - spt/sporum/CATNAME/cron/expirethreads.pl Each "cron" directory contains a file that ends with "cron" - this shows an example of a cron entry for the files in the same directory. To add cron tab entries: crontab -e Then paste in the entry similiar to the text in the *cron file mentioned above. For this site - this is the contents of the crontab: 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spt/cron/expirethreads.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spt/cron/deletefiles.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spt/cron/delivermessages.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spt/cron/deleteusers.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spmail/cron/expirethreads.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spmail/cron/deletefiles.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spmail/cron/delivermessages.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/spmail/cron/deleteusers.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/sporum/cron/expirethreads.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/sporum/cron/deletefiles.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/sporum/cron/delivermessages.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/sporum/cron/deleteusers.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/sporum/cron/updateuserstatus.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/cron/deleteusers.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/spmail/cron/deletemsg.pl 0 2 * * * /home/sporum/public_html/cgi-bin/spt/spmail/cron/collectmail.pl The contents of each cron perl file contains a line of code similar to this: BEGIN { unshift(@INC, "/home/sporum/public_html/cgi-bin/spt/spmail", "/home/sporum/public_html/cgi-bin/spt"); } You MUST change these paths to point to the respective location on your web server! To un-archive the tarballs: tar -xf tarballname.tar gzip tarballname.tar Remove the tarball when you have completed the install and it works correctly. Then create your own backup copy! gzip tarballname.tar [Note: itialics denotes your specific filenames.] |