Docker Log File Management

Log File Locations

Functional Logs

Auditing Logs

These are logs related to the actions performed by users in the web interface and as well as logs of requests made on the web services REST API.

The following are examples of user actions that are registered in the log:

• Successful login
• Addition of a network element
• Request for a manual resync of a network element.

As an administrator, you may find it useful to view this log for various reasons.

For example:

• To investigate who accessed or tried to access the appliance
• To troubleshoot issues a user is experiencing while using the appliance
• To determine whether a user action was accomplished successfully
• To determine which user made a change to any stored information, such as a Skylight device configuration.

The log file is stored in the following directory:

${volume-location so-logs}/bizn1/bizn1instance/auditing_business.log

Backup Database Logs

The file is located in the following directory:

${volume-location so-logs}/bizn1/bizn1instance/all.log

Other

• Logs related to the Session management and the interaction between the Supervision Endpoint

  The file is located in the following directory:
  ${volume-location so-logs}/bizn1/bizn1instance/sdmm.log

• Logs related to the interaction with the Devices

  The file is located in the following directory:
  ${volume-location so-logs}/mednX/mednXinstance/all.log
  Where X is a mediation number from 1-12

Redundancy Logs

The redundancy feature writes a log of activity and error messages.

The log file that contains entries about redundancy is located in the following directory on the appliance for the active site:

${volume-location so-logs}/hamon/hamon.log

CLI manager Logs

Writes a log of activity and error messages related to the climanager.

You can find the log file that contains entries about the climanager located in the following directory on the appliance:

/home/skylight/so/bin/logs/clibase.log

Upgrade Logs

The upgrade feature writes a log of activity and error messages.

You can find the log file that contains entries about the upgrade located in the following directory on the Skylight orchestrator appliance:

/home/skylight/docker-dist.log

Deployment Profile Configuration Logs

The deployment feature writes a log of activity and error messages.

You can find the log file that contains entries about deployment located in the following directory on the Skylight orchestrator appliance:

${volume-location so-logs}/skylight/deploymenttool.log

Managing Logs

When solving issues for clients, Accedian Technical Support may require the server log files produced by Skylight orchestrator. They will occasionally require logs that are finer-grained than the logs usually produced by Skylight orchestrator.
These are the log levels that are available (in order of increasing detail):

• SEVERE - produces the fewest log entries
• WARNING
• INFO
• CONFIG
• FINE
• FINER
• FINEST
• ALL - produces the most log entries.

Changing the Log Level

To change the log files

1. Open an SSH terminal session to the Skylight orchestrator CLI on port 2200.

2. At the Skylight prompt, enter: shell container core
   You are brought to the appliance’s OS-level shell.

3. Connect to Glassfish as an administrator by entering:
   cd /opt/accedian/skylight/glassfish5/bin
   ./asadmin --port=5048
   The asadmin prompt is displayed.

4. List the logging level of each module by entering:
   list-log-levels bizcluster
   list-log-levels medcluster

5. Change the log level by entering commands similar to the following example (which sets the log level to FINE):
   set-log-levels --target bizcluster com.accedian.ems.ecf.server.request.MgmtRequestLogger=FINE
   set-log-levels --target medcluster com.accedian.ems.ecf.server.request.MgmtRequestLogger=FINE
   where: com.accedian.ems.ecf.server.request.MgmtRequestLogger is the logger module.

6. Terminate the admin session by entering:
   quit

Rotating the Log Files

It is possible to close the log files (server.log, all.log, thirdParty.log), mark them with the current time and start fresh logs. Rotating the log files in this way may be useful if you want to reduce the amount of data to inspect when performing system tests. In addition, starting new log files may be necessary when using finer log levels because they produce large files.

To rotate the log files

1. Open an SSH terminal session to the Skylight orchestrator CLI on port 2200.

2. At the Skylight prompt, enter: shell container core
   You are brought to the appliance’s OS-level shell.

3. Connect to Glassfish as an administrator by entering:
   cd /opt/accedian/skylight/glassfish/bin
   ./asadmin --port=5048
   The asadmin prompt is displayed.

4. Save the current log files and start new logs by entering:
   rotate-log --target bizcluster
   rotate-log --target medcluster

5. Terminate the asadmin session by entering:
   quit

Old log files have been closed; file names now include a timestamp and new logs are created.

Normal Log Levels

This section lists the normal log levels for Skylight orchestrator modules. When the intervention on the appliance is finished, the logging levels should be changed back to their normal levels.