[Tutorial]PSYCHOSTATS INSTALLATION TUTORIAL FOR LINUX

[CryStaliN]

PSYCHOSTATS INSTALLATION TUTORIAL FOR LINUX

 

Introduction

PsychoStats version 3.x is very easy and quick to install on any system. It includes an online installation wizard that you run through your browser. Follow these simple steps and you'll be up and running in no time. This documentation is for VERSION 3.x. All documentation for version 2.x is gone. Upgrade to v3 as support for v2 is depreciated. People are often very confused about how PsychoStats actually works. PsychoStats is software that relies on other technologies such as a WebServer like Apache and a database server

like MySQL. You must be familar with these types of servers in order to use PsychoStats. And you must have access to a web

and mysql server.

 

There are 2

parts to PsychoStats:

- Backend Perl Scripts

The backend takes care of the actual log parsing and updates. This is where the primary "stats.pl" perl script is run to fetch, parse and record log data from the game server(s) into the database.

Note: The system that runs these updates (Windows or Linux) is what defines which archive you should download a nd install.

- Frontend PHP Website

The frontend takes care of the interface that the user actually see's and interacts with. This is a set of PHP pages that interact with the same database as the backend so users can view the stats online.

 

 

Minimum Requirements

 

- PHP v4.3 (or 5.0+)

- MySQL v4.1.11 (or v5.0+)

- Perl v5.8

Required Perl modules

- DBI

- DBD::mysql

Optional Perl modules

- Net::SFTP - This is only required if you need to download logs via an SFTP server. Note: This module has a lot of extra dependencies. Too many to list here.

 

These requirements are the bare minimum that ensure PsychoStats will work. If you attempt to use older versions you run the risk of stats updates crashing or invalid statistics from being recorded. Users having problems with the software that are running

older versions of these requirements can not be supported.

 

Download Psychostats

Download the current release from the PsychoStats Downloads. Be sure to download the Linux archive.

 

Installation

Unzip the archive somewhere on your system. It does not matter where you do this. It's not required (nor desirable) to put this directory inside your web server directory root. Having the full unzipped archive in your web server's document

tree means that users could potentially view your stats.cfg and get your database information.

 

Before you can run the Installation Wizard to finalize your installation you need to copy the frontend web files to your web server. This should be the only manual part of the installation you have to perform.

 

Apache is generally the web server of choice for Linux users. The document root of the website can be almost anywhere on the system. Some common locations include: /usr/local/apache/htdocs, /usr/www/htdocs, ~/public_html. Consult your web server configuration or your web host support for information on where your document root is.

 

To copy the frontend files to your website do this:

First change your directory to where the PsychoStats archive was untar'd. Then do the commands below.

 

mkdir /path/to/document/root/stats
cp -rf upload/* /path/to/document/root/stats

 

For example, to start the installation use a URL like this: http://www.yourdomain.com/stats/install/index.php

Be sure to use a proper domain name in the URL to where your website is actually hosted.

 

Edit the stats.cfg with the proper database settings so PsychoStats can connect to your database.

 

All Done! Now you just need to run the stats.pl to update your stats. If you have shell access on your server then just run:

 

./stats.pl -v

 

Once the Install Wizard has fully completed the first thing you need to do is login to the stats website that was just setup for you using the administrator login you created during installation. Once logged in you absolutely need to configure a logsource so PsychoStats will know how and where to read your game logs.

 

Add a cron entry to run the stats.pl on a daily basis (like every hour or so).

 

Credits:Mut2nt&Mine

Have Fun&Enjoy

[`RoSe^]

Nice tutorial Crystalin keep up  Brother=]

[CryStaliN]

Thanks.Soon i will post and the windows installation version.

Stay Tunned.