Reading the Access Log

On UNIX, access log output goes to syslog. On Windows, you use the Event Viewer to view the access log.

This task shows you how to:

Related Topics
About the Access Log
Enabling the Access Log
Log Output

Read the UNIX Access Log

To control the output destination for syslog messages on UNIX or Linux:

  1. Modify the syslog.conf file, which may be located in the /etc/ directory. (It is not necessarily in a standard location on a server.)

  2. Create a file to hold the messages and then insert a line into the syslog.conf file such as: 

    *.info/usr/USERNAME/AccessLogMessages

    Note: The specified file must exist before adding this entry in the syslog.conf file.

    The UNIX system handles successful access and failed access messages as *.info and *.notice, respectively:

    • Successful access attempts are recorded as priority LOG_INFO.
    • Failed access attempts are recorded as priority LOG_NOTICE.

  3. Get the new entry (in the syslog.conf file) recognized by doing one of the following:

    • Restart the server.
    • Execute a kill command with the hangup option for the syslog process ID. For example:
      kill -HUP 'cat /etc/syslog.pid'

    Note: The syslog.pid file can be located in different areas on different machines. This is just an example.

The following is a sample of the output:
Jun 11 12:19:28 dvwflx1 ENOVIA[16313]: User creator: successful login.  (clientHOST=1.1.1.1, IP address=testmachine, MAC address=00-1A-A0-BC-52-06)
Jun 11 12:19:28 dvwflx1 ENOVIA[16313]: User p: successful login.  (clientHOST=1.1.1.1, IP address=testmachine, MAC address=00-1A-A0-BC-52-06)

A new entry is not added if the prior entry is the same. Instead, the number of times that the entry is repeated is entered, followed by the next entry that is different.

Use the Windows Event Viewer

To view the access log on Windows:

  1. From the Start menu, select Programs > Administrative Tools > Event Viewer.

  2. To change from the System log to the Application log, from the Log menu select Application.

  3. To view any of the access log entries, double click any of the entries whose Source is ENOVIA Live Collaboration.

  4. Scroll through the access log using the Previous and Next buttons.

  5. Click Close when finished viewing the access log entries.