If you configure and manage your own reports, please continue reading for additional tips on troubleshooting Urchin processing problems…
The most common causes of Urchin failing to update are due to one of the following:
- The Urchin Scheduler is not running.
- There is a problem with the webserver logfile location or configuration.
- There is a problem with the Urchin database.
Urchin Scheduler
Unless you manually run Urchin to update your reports, they are updated according to the Urchin Scheduler configuration. The Urchin Scheduler daemon must be running for the reports to update on time. To check the status of the scheduler, you’ll need to open a command shell to the Urchin server and change directory to the “bin” directory of the Urchin distribution. From there, run the following command to check the status:
./urchinctl status (Note: omit the “./” for Windows systems)
If either the Scheduler or the Urchinwebd are not running, you can restart them as follows:
./urchinctl start
Once the scheduler is running again, you may wait for Urchin to update according to its normal schedule or manually update it by selecting the “Run Now” option from the Urchin Administrative GUI.
Log File Configuration
If the location of the log file changes or if the format of the log file changes, Urchin may stop updating the reports. To determine if this is happening, scroll down to the section in this article titled “Task History Inspection.” to look for related errors.
If the log format does not match one of Urchin’s automatically recognized formats, or if you have selected one format, but the logs are written in a different format, Urchin will not be able to read them and create report data properly. The following article contains full details on which formats Urchin will read and how to configure your server to write logs in those formats http://help.urchin.com/index.cgi?id=1514
Database Problem
Urchin stores data on a per-profile monthly databases in the data/reports directory of the Urchin distribution. If the Urchin databases are corrupt or locked for any reason, the reports will stop updating for the affected profile. To determine if this has happened, see the following section titled “Task History Inspection.”
Task History Inspection
Urchin keeps a record of every attempt to process logs for every profile. If you suspect there may be a problem with the processing, these logs will often provide information that points to the root of the problem.
There are two ways to access this information:
- Open the Urchin Configuration GUI and select the following window: Configuration -> Scheduler -> Task History. From this view you’ll see a Status column. Each item in the “Status” column is a clickable link. The link will open a window that displays the process status when Urchin attempted to process the log file for that profile. They are listed by date/time/profile as indicated in the remaining columns in this window. Click “Next” if necessary to find the profile and date you are looking for.
- These same files are available on the server Urchin is running on. They are organized by profile so that each profile has a unique directory with all the Task History files contained within. The path to the profile directories is ~urchin/data/history/”profile-name” where “profile-name” represents the profile directory. The files are not date named but they are in order so that the oldest file is the first history file and the last file in the list is the most recent history file with the latest process data.