User Manual

Console Server Features Event Port Logging
3-2
3.2 Event Port Logging
Port logging saves all idle data from an SCS serial port in a log file. This log file can be accessed by a system
administrator after a system crash, and can provide valuable information about the cause of and solution for
any problems with the attached serial device.
If email notification (discussed in Email Alerts for Serial Events on page 3-2) is enabled, the serial log can
be sent via email to the system administrator.
Enable port logging with the Set/Define Ports Serial Log command. This command sets the file size for
the log file, which can be up to 250 Kbytes. To disable the log file, enter a file size of 0.
Figure 3-2: Saving Serial Data to a Logfile
Note: This command sets port access to Access Remote.
The log file is stored on the SCS /ram disk in the form “/ram/Port_xx.log” where xx is the port number.
When the file reaches its specified limit, it is truncated to half its current size and begins logging again. The
oldest data is discarded.
If the SCS is rebooted, none of the data stored in the log file is preserved.
3.3 Email Alerts for Serial Events
Once a port is configured for port buffering (as described in Event Port Logging on page 3-2), you can
enable email notification. This feature triggers an email if the connected device reboots or otherwise
produces a burst of console output of 20 or more characters.
The port buffers incoming data for up to 25 seconds or until the log file reaches1500 bytes before sending
the email, which contains the current contents of the log file. Any data that comes in after that 25 seconds
will be saved in the file, but not included in that email. Email can not be sent from the same port more than
once every 10 minutes.
The email sent by the SCS also includes a URL that refers to the serial log file directly, so you can open it
in an email client or web browser. You will need to enter the system login password to access the file.
Each port’s email settings can be separately configured, or a default configuration can be created that will
be used for all email notifications. An emailsite stores the information necessary for email notification. The
only possible names for emailsites are portxx, where xx is a serial port number, or default. Settings for the
default emailsite will be used for any that are missing in the port-specific files.
Use the Define Email commands to configure each emailsite with features such as an email address for the
email to be sent to, a from line, a subject line, an SMTP mailhost, and a reply-to address.
Local>> DEFINE PORT 2 SERIALLOG LIMIT 200