UTStats
Copyright (C) 2004/2005 azazel, )DoE(-AnthraX and pjmodos

This program is free software; you can redistribute and/or modify
it under the terms of the Open Unreal Mod License.
See license.txt for more information.

=================================
UTStats Actor Install Information
=================================

From the System folder in the zip file, copy to your UTServer\System folder the following files:

UTSAccuBeta3.u
UTStatsBeta3.u

Add to [Engine.GameEngine] the following lines:
ServerActors=UTStatsBeta3.UTStatsSA
ServerPackages=UTSAccuBeta3

Under the [Engine.GameInfo] check for:
bLocalLog=True or bLocalLog=False

This line HAS to be:
bLocalLog=False

Setting it to True will not give you complete logs (don't ask why it just won't).

Log files are recorded to the UTServer\Logs folder.


===============================
UTStats Web Install Information
===============================

From the html folder in the zip file, upload all the files to your webserver wherever you like.
I suggest under a folder called utstats.
After the files have uploaded browse to the stats folder where you should see the following folders:

images
import
includes
logs
pages

Using whatever means (usually the ftp client) you need to CHMOD the logs folder to 777.
Now go into the logs folder.
Now CHMOD the backups folder to 777.

Now go back a level and into the includes folder.
CHMOD the file ftptimestamp.php to 777.
Now edit the config.php file.

Enter in your mysql database, hostname, username and password at the top.
If you are going to use ftp transferring of log files amend the FTP connection as required.

Now import the contents of utstats.sql located under the sql folder into the database you
entered into the config.php.
This will setup the following tables in your database:

uts_player
uts_match
uts_rank

It will not drop the tables for you, it will just try to create them.
If you already have them it will fail and its up to you to drop them tables.


==============
Importing Logs
==============

Depending on the level of access you have and how competent you are you can do this 3 ways.
*** Important *** 
Make sure you edit import.php to set an adminkey at the top!

Way 1:
If you don't have ftp access to your UT server or allowed to use ftp via php then upload your 
logs manually to the logs folder and then run the importer.

Way 2:
If you have ftp access and can do ftp via php, edit the config.php file and input your UT server ftp
information into there.
Now run the importer.

Way 3:
Automate the process using a cron job or scheduled task.
Just get this to run the import url (with the key in the url) every hour or less.


=================
Known Bugs/Issues
=================

On import this is quite CPU intensive (OK its a lot) ... but ... the plus side is a small database
and uber low CPU usage for stats display.
Because of this its STRONGLY advised not to run the stats pages on the same box as your game server.
Newer versions will focus on getting the import CPU usage right down.

-

If you import too many logs the php session will time out and will not finish the job and most
probably it will also half import 1 log.
On average it takes up to 10 seconds per log to import so its advised to import no more than 5 at
a time until I have a method to limit this in the script.

If you find this happens to you then you will have to manually remove the entries from the database
but be warned you cannot un-amend the ranking.

-

Flag Assists will not show in stats until Sinister has released the next version of SmartCTF.

-

If you find any bugs or issues please post them at our forums:
http://www.unrealadmin.org/forums/forumdisplay.php?f=173