Snap Creator provides useful error messages and troubleshooting logs.
The following types of error messages are provided by Snap Creator:
- INFO
- For standard, normally occurring operations.
- CMD
- External command or script that Snap Creator runs (according to configuration) and the return code from the command or script is logged. Typically, these are PRE, POST, or APP quiesce or unquiesce commands.
- OUTPUT
- For Data ONTAPI library calls.
- DEBUG
- For debug information.
- WARN
- To draw your attention, but it is considered to be a normal activity usually and does not require any action (for example, when you delete Snapshot copies)
- ERROR
- Indicates a problem and most likely requires manual action to fix the error. Snap Creator exits on any ERROR message. It is important to fix any problem that occurred before it runs again. Snap Creator does not automatically fix problems, but you can specify what is to be done before exiting Snap Creator by using PRE_EXIT_CMD defined in the configuration file.
The troubleshooting logs contain the output from any external commands or scripts run by Snap Creator (for example, SnapDrive). If you call other scripts through Snap Creator, it is important that you properly set up exit codes and output for those scripts. You should never exit with status 0 if a problem occurs.
There following logs are available for every Snap Creator profile and configuration:
- Out
- Contain only verbose logging
information.
- Debug
- Contain verbose and debug logging
information. If trace messages are enabled in the configuration
file, which is the default setting, then the trace information is
displayed in this log. The parameter that enables trace messages
is
LOG_TRACE_ENABLE - (Y|N).
- Error
- Contain a history of all of the
error events for a given configuration. The error log helps with
viewing information about past errors so that users can correlate
events and gain a historical perspective. It can be monitored and
used as a way to integrate Snap Creator with a monitoring
application.
- Stderr
- Contain information if issues with the
Snap Creator code are encountered; however, the standard error streams log is
typically empty.
The Out, Debug, and Stderr logs are retained as defined by the LOG_NUM value in the configuration file while the error log is always appended. All logs are written to the /scServer_install_path/engine/logs/profile directory.
The Snap Creator Agent optionally creates the Out, Debug, and Stderr logs as well, and is enabled, by default, with the following parameter setting: SC_AGENT_LOG_ENABLE=Y.