This chapter explains the reporting functions available in RealPlayer Intranet Administrator. The information generated by these functions resides in two logs provided in RealPlayer Intranet Administrator —the access log and the error log.
The RealPlayer Intranet Administrator access log records the IP addresses of the clients that have connected to RealPlayer Intranet Administrator, the files they accessed, the times of day they connected, and much more. The access log is useful for verifying that RealPlayers are able to connect to RealPlayer Intranet Administrator and retrieve configuration files and updates to these files. New information is always appended to the end of the access log.
The access log file shows all files served by RealPlayer Intranet Administrator, including all RealSystem Administrator Web pages. These appear in the GET statement; you can easily identify them because they all begin with admin. For example, "GET admin/index.html HTTP 1.0" shows the opening RealSystem Administrator page. If you make changes using RealSystem Administrator, the confirmation page that appears in RealSystem Administrator is also recorded in the access log.
The error log contains both information and error messages about RealPlayer Intranet Administrator operation. By looking for patterns of errors, you can troubleshoot and correct problems and avoid recurrences of them.
You view the text of the error log by using a word processor or text editor.
The error log is an excellent tool for troubleshooting any problems that may arise with your RealPlayer Intranet Administrator. An entry is made to the error log only when an error occurs. If no errors occur, this file will not exist.
If you have an error message that refers to a fatal error, contact the RealNetworks Technical Support Department for assistance.
RealPlayer Intranet Administrator uses the following two settings to record information in the error log (you can view them from RealSystem Administrator by clicking Configure>General Setup>Logging):
Log Rolling Frequency—settings for creating new log files at specified intervals. See "Log File Rolling".
Error Log File—the default location is the Logs subdirectory of the main RealPlayer Intranet Administrator directory. The default name of the error log file is rmerror.log.
The error log records client connections and RealPlayer Intranet Administrator errors. Each time an error is generated by RealPlayer Intranet Administrator, a record is created in the error log. The error log path is stored in the same directory as the access log; this path is indicated by the LogPath variable.
The syntax of the file is as follows:
***date time computername(process_ID): error_message
The various types of entries are listed and defined in the following table.
Log files can grow indefinitely as they accumulate data. To keep log files at a manageable size, you can limit the access log to a week's worth of information, for example, or to a specified file size, and RealPlayer Intranet Administrator will begin a new log file when that limit is reached.
If you supply values for all four boxes, RealPlayer Intranet Administrator will use the size or time period that is reached first.
Rolled log files are named using the following format:
name.log.datestamp
name is the name of the regular log file, as taken from the Access Log File box or the Error Log File box (usually rmaccess for access logs and rmerror for error logs).
log is the file name extension for the log file.
datestamp is the date stamp, in the format YYYYMMDDHHMMSS,
YYYY denotes the year (always in four digits)
MM denotes minutes past the hour
SS denotes seconds past the minute
If you turn off log file rolling, RealPlayer Intranet Administrator will create a single, large log file.
0 in the first Log Rolling Frequency box.