Editing IRStats2 (section)

=Troubleshooting=
=== No style on stats ===

If you attempt to view the stats panel and it does not render correctly, run generate_static and restart apache.

=== Can't call method "add_trigger" ===

Error when running process_stats:

<pre>
Use of uninitialized value in concatenation (.) or string at (eval 70) line 11.
Use of uninitialized value in concatenation (.) or string at (eval 70) line 16.
Use of uninitialized value in concatenation (.) or string at (eval 70) line 19.

------------------------------------------------------------------
---------------- EPrints System Error ----------------------------
------------------------------------------------------------------
Error in configuration:
Can't call method "add_trigger" on unblessed reference at /usr/share/eprints3/archives/sandbox/bin/../cfg/cfg.d/z_irstats2.pl line 162.


------------------------------------------------------------------
EPrints System Error inducing stack dump
 at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints.pm line 146.
	EPrints::abort("EPrints") called at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints/Config.pm line 151
	EPrints::Config::load_system_config() called at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints/Config.pm line 96
	EPrints::Config::init() called at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints.pm line 706
	require EPrints.pm called at /usr/share/eprints3/archives/sandbox/bin/stats/process_stats line 12
	main::BEGIN() called at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints.pm line 0
	eval {...} called at /usr/share/eprints3/archives/sandbox/bin/stats/../../../../perl_lib/EPrints.pm line 0
</pre>

This is due to the FindBin library not working correctly.  Open the process_stats script and remove the line:

<pre>
use lib "$FindBin::Bin/../../../../perl_lib";
</pre>

When executing, use -I to explicitly set the EPrints perl_lib directory:

<pre>
perl -I/EPRINTS_ROOT/perl_lib /EPRINTS_ROOT/archives/ARCHIVEID/bin/stats/process_stats
</pre>

=== Argument "/opt/eprints3/lib/geoip/GeoIP.dat" isn't numeric ===

If you see the error:

<pre>
Argument "/opt/eprints3/lib/geoip/GeoIP.dat" isn't numeric in subroutine entry at /opt/eprints3/lib/plugins/EPrints/Plugin/Stats/Processor/Access/Country.pm line 36, <DATA> line 960.
</pre>

This is due to a change in functionality of the GeoIP library.  Open the file:

 /EPRINTS_ROOT/lib/plugins/EPrints/Plugin/Stats/Processor/Access/Country.pm

... and replace the line:

 $self->{geoip} = $pkg->new( $dat_file );

... with ...

 $self->{geoip} = $pkg->open( $dat_file );

Remember to add a suitable comment identifying who made the change, when it was made and why.  This will make upgrading easier.

=== process_stats locked ===

If IRStats terminates prematurely, it can leave a lock in the database that will need to be removed.  A script has been written to release this lock, but should only be run if you are certain that IRStats2 is not currently running.  The code is available on [https://github.com/gobfrey/irstats2_clear_lock github].