Installation
Note! At this stage installation hasn't been well tested and you may need some help in configuring the correct paths/dependencies. It's very much a "works for us", but we expect things to get easier as we identify what works and what doesn't.
Dependencies
General
Installing IRStats from the SVN repository requires Subversion, Autoconf and Automake. Most systems should have these already.
AWStats
IRStats, by default, expects to find awstats at /var/www/awstats. Awstats can be downloaded from http://awstats.sourceforge.net/.
Additional Perl Modules
IRStats requires a few Perl modules not typically installed in common systems:
$ cpan cpan> install Date::Calc cpan> install Logfile::EPrints cpan> install Geo::IP::PurePerl
(Some of these modules may be available as packages on your system)
Database
IRStats requires either a MySQL or Postgres database. If you are not installing IRStats into an existing database for MySQL you will want to do something like:
mysql> create database repo_stats; mysql> grant all privileges on repo_stats.* to irstats@localhost identified by 'mysecret';
Or for Postgres:
$ createdb repo_stats $ psql repo_stats psql> CREATE USER irstats WITH PASSWORD 'mysecret'; psql> GRANT ALL PRIVILEGES ON DATABASE irstats TO irstats;
The database driver used is controlled by the database_driver configuration setting. For MySQL use mysql and for Postgres use Pg.
ChartDirector
ChartDirector is a commercial product that can be downloaded from http://www.advsofteng.com/. For why we used ChartDirector take a look at Charting. Without ChartDirector IRStats will use the PlotKit graphing library (your users will require Javascript).
EPrints has a redistribution license for ChartDirector but this does not allow end-user development (i.e. you can only use it for IRStats as distributed from trac.eprints.org). Please contact the mailing list if you want to use our license (subject to agreeing the ChartDirector license).
Maxmind Organisation Database
The Maxmind Organisation Database is a commercial product that can be purchased from http://www.maxmind.com/app/organization (currently $15). Note: if you don't include the geo_ip_org_file option in the configuration file IRStats will run without translating IPs to organisations (TODO: I don't think this is used anyway ...).
Install IRStats
Download the current version. To install into /usr/local/irstats:
cd irstats autoconf ./configure make sudo make install
For configuration please see the IRStats Manual.
To install into /:
cd irstats autoconf ./configure --prefix=/ make sudo make install
