PsychoStats README file. v1.9 If you need immediate help installing PsychoStats v1.9 then please join us online in the #pychostats IRC channel on GAMESNET.NET: irc://irc.gamesnet.net/psychostats/ UPGRADING NOTES to v1.9 =========================================================================== General Notes: There are a couple new options available in the stats.cfg. Its always recommended that you use the new config files instead of your older ones, new options are often missed and can lead to stats being messed up. NOTE!! the file 'stats.pl' is used on ALL systems now, Windows and Linux types. This means all linux type systems will need to change their scripts and/or crons to point to 'stats.pl' instead of just 'stats'. Also, a bunch of the old configuration files, namely: aliases.cfg, playerlogos.cfg, clanlogos.cfg, clannames.cfg, permitclan.cfg and registered.cfg are NO LONGER used. And are replaced with the players.cfg and clans.cfg files. These 2 new files centralize a lot of the old style configurations which will make it easier for you to maintain your server. Theme Notes: Themes created since v1.7 will continue to work in this version! If you have any questions or problems with PsychoStats please go to the online forums at: http://www.psychostats.com/ =========================================================================== INSTALLING =========================================================================== For more installation help, please go to the online documentation at: http://www.psychostats.com/psdocs/ Instructions on how to install PsychoStats on a windows system come after the Linux section. Unix Installation Instructions (from scratch) =========================================================================== To install PsychoStats, simply run the install script provided. prompt> ./install.pl Before you run the script, make sure to edit the stats.cfg file first. The only things requiring to be correct before install in that file are the HTMLPATH and PICSPATH variables at the top of the file. If the install script fails for some reason here are the steps to do a manual install. Also, if the install script does in fact not work for you, please post your issue in the forums or email me with the information at stormtrooper@psychostats.com. Manual Install: 1) Untar the archive, which you've already done. 2) move the 'images' directory to your HTML directory for your website. For example, if the path to your website root is: /home/httpd/html and you're putting the stats in (create this directory too): /home/httpd/html/stats copy or move the 'images' directory to: /home/httpd/html/stats/images 3) Edit the stats.cfg to your needs/system. 4) Install the crontab for Psychostats. Read the cronexample file for more information. 5) You should run PsychoStats manually the first time by running it at the prompt like this: ./stats -v This will give you feedback during the update and will be able to help determine where an error occurs (if any at all) If you do receive any errors you can go to the forums at www.psychostats.com. And we can try and help. When posting an installation problem please show the actual error you receive along with what you've done up to the point you received the error. Windows installation instructions =========================================================================== These steps were done on a Windows 2000 Professional system. Windows 95/98/ME systems may differ slightly. These instructions are very basic and you may want to try one of the online guides more useful at http://www.psychostats.com/winhelp.php 1) Add the line "log on" to your autoexec.cfg file for your server. This sets up the HLDS server to log all game actions (except for chat messages). If the autoexec.cfg does not exist within your MOD directory you must create a new file. 2) Install a web server on your system. I used Microsoft Personal Web Server (PWS). For Windows 2000 Professional this is what you do. To install the web server go to control panel and click add/remove programs. Then click add/remove windows components. Double Click on the IIS Component and check Personal Web Manager & World Wide Web Server. Click ok then next. Pop in the Win 2K cd and let it install the components. You may need to restart your computer if you need to do it. Now after its installed go to Start-Programs-Adminstrative Tools-Personal Web Manager If not already enabled, enable the check box "Enable Default Document". In the text field "Default Documents" add "index.html," so that the resulting text is (note there are no spaces): index.html,Defalult.htm,Default.asp Next your Home Directory needs to be where you have installed P. Stats into. Example: c:\hlserver\cstrike\stats To edit your home directory click the advanced tab on the left and then properties button. You can either browse to the directory or input it manually. The reason for this is because it needs to point to where your index.html is located. To install PWS on a Windows 98 machine, insert your Windows 98 cdrom and run :\add-ons\pws\setup.exe I used the "Typical" installation and used the default paths. 3) Configure PWS by starting: start -> programs -> Microsoft Personal Web Server -> Personal Web Manager In the menu select: View -> Advanced If not already enabled, enable the check box "Enable Default Document". In the text field "Default Documents" add "index.html," so that the resulting text is (note there are no spaces): index.html,Defalult.htm,Default.asp 4) Install ActivePerl. Browse the ActivePerl download page: http://www.activestate.com/Products/ActivePerl/Download.html As suggested on the ActivePerl download page, I first downloaded and installed the Windows Installer (download links are on the page). I then downloaded and installed "Windows MSI" version of Perl. I installed using the defaults. For non-NT systems, ensure the file C:\autoexec.bat contains a line such as set PATH = "C:\Perl\bin;%PATH%" if not, add it and reboot. 5) Modify the stats.cfg to reflect your system configuration. For example: logpath = c:\hlserver\cstrike\logs htmlpath = c:\hlserver\cstrike\stats picspath = c:\hlserver\cstrike\stats\images\mappics\ 6) Install PsychoStats by running the 'install.pl' script provided. If ActivePerl is installed correctly you should be able to just double click it from the Windows Explorer. 7) To regularly update the stats, you'll have to periodically run the "stats.pl" program. You can use the widows task scheduler to do that. Here is how: start -> programs -> Accessories -> system tools -> scheduled tasks Open the icon labeled "Add scheduled task". This will run the "scheduled Task Wizard". In the wizard click "Next" then wait several minutes while Windows scans your system for all executables. When it is done click "Browse". In the text entry area "File name" enter "c:\psychostats\stats.pl" (be sure to use the actual directory to where you put PsychoStats), then click "Open". Select the "daily" radio button, then click next. For the next wizard step just click "next". Enable the check box "Open advanced properties for this task when I click Finsh", then click "Finish". A properties box will come up. Select the "Task" tab (actually it should be selected be default). The "Run" text box should read: start /minimized "C:\psychostats\stats.pl" Select the "Schedule" tab, then click the "Advanced" button. In the box that pops up enable the "Repeat task" check box. Next to "Every" set the number of minutes you want to repeat the update. If you want to update every half-hour, put 30. Then select the "Duration" radio button and set in to 24 hours. Click "OK". Select the "Settings" tab. (this step is optional) Enable the check box "Only start the task if the computer is ide for at least". Under the chek box enter 5 minutes. In the "If the comupter has not been idle that long, retry for up to:" minutes field enter 20. Click "OK", you're done, the task is running. RECOMMENDED----If the system checking for idle causes server lag then just set the event to be run once daily at 5:30AM. 8) Another little tip. When running the cs_stats.exe program you end up losing ur log files. If you want to update your stats all u have to do is just run the stats.pl (which you already set up in the task scheduler. 9) Once all these steps are complete to test and make sure your web server and stats have been updated do this. Go into Internet Explorer and type: Example - http://24.11.39.240 (the web server would be the IP number of your computer), You might be able to use "http://127.0.0.1/" as well. If your stats page comes up your all set and ready to link it to your web page. edited and cleaned up by: {ECA}Wolffman edited by Stormtrooper (09/16/2001) edited by Stormtrooper (04/02/2002)