3.1. Log Files

Significant activity occurring on the Sun Ray server is logged and saved. The server stores this information in text files.

The structure and content of the various messages written to these files and other Sun Ray Software log files is arbitrary and might change at any time. The messages do not provide a stable interface for programmatic consumption.

Table 3.1, “Sun Ray Server Log Files” describes the log files that are maintained on the Sun Ray server.

Table 3.1. Sun Ray Server Log Files

Log File

Path

Description

Administration

/var/opt/SUNWut/log/admin_log

Lists operations performed during server administration. This log is updated daily. Archived files are stored on the system for up to one week and are annotated using numeric extensions, for example, from file name admin_log.0 to admin_log.5.

Authentication

/var/opt/SUNWut/log/auth_log

Lists events logged from the Authentication Manager. The auth_log file is updated up to a limit of 10 every time the server's authentication policy is changed or started. The archived authentication files are annotated using numeric extensions, for example, from auth_log.0 to auth_log.9.

Automatic Mounting

/var/opt/SUNWut/log/utmountd.log

Lists mount messages for mass storage devices. The archived utmountd files are annotated using numeric extensions, for example, from utmountd.log.0 to utmountd.log.9.

Mass Storage Devices

/var/opt/SUNWut/log/utstoraged.log

Lists mass storage device events. The archived storage files are annotated using numeric extensions, for example, from utstoraged.log.0 to utstoraged.log.9.

Messages

/var/opt/SUNWut/log/messages

Lists events from the server's clients, including details of registering, inserting, or removing smart cards. This file is updated daily. Archived files are stored up to seven days or 3.5 MB, annotated with numeric extensions, for example, from messages.0 to messages.5.

When using a shared network (LAN) with external DHCP server support (configured network using utadm -L on), logging for each event type is disabled unless the LogXXX value and the LogHost value are set. See Table 10.2, “.parms Key/Value Pairs” for details.

Web Administration

/var/opt/SUNWut/log/utwebadmin.log

Lists web administration-related messages. The archived log files are annotated with numeric extensions.

Table 3.2, “Sun Ray Server Installation and Configuration Log Files” list the specific installation and configuration logs files.

Table 3.2. Sun Ray Server Installation and Configuration Log Files

Log File

Path

Description

Activation

/var/adm/log/utctl.* (Solaris)

/var/log/SUNWut/utctl.* (Linux)

List events logged during post-installation product activation. The archived log files are annotated with time stamp extensions.

Installation

/var/adm/log/utinstall.* (Solaris)

/var/log/utinstall.* (Linux)

List events logged during installation. The archived log files are annotated with time stamp extensions.

Setup

/var/adm/log/utsetup.* (Solaris)

/var/log/SUNWut/utsetup.* (Linux)

List events logged during installation/configuration when performed by utsetup. The archived log files are annotated with time stamp extensions.