Checking the log files

The IBM® Spectrum Control Base Edition maintains six log files that record different types of events.

You can find the following log files in the /var/log/sc/ directory:
  • events.log – Records Spectrum Control events according to their type: Info, Error, or Warning. The event logging is compatible with the Rsyslog application, an open source utility for forwarding log messages over IP networks (for more information, see the Rsyslog website). The following example shows different events that might be recorded:
    SC-0001, INFO, "User {user_name} has logged in."
IBMSC-0001, INFO, "User {user_name} has logged in."
IBMSC-0002, INFO, "User {user_name} has logged out."  
IBMSC-0003, WARNING, "User {user_name} login attempt failed."
IBMSC-0004, INFO, "IBM Spectrum Control local user account {user_name} was created."
IBMSC-0005, INFO, "IBM Spectrum Control local user account {user_name} was deleted."
IBMSC-0006, INFO, "IBM Spectrum Control local user account {user_name} password was reset."
IBMSC-0007, INFO, "Storage credentials were set for user {user_name}."
IBMSC-0008, ERROR, "Storage credentials for user {user_name} were disabled. Reason: {reason}."
IBMSC-0009, INFO, "Storage array identified as {identifier} with IP address {ip_address} has been added."
IBMSC-0010, WARNING, "Storage array {identifier} was removed."
IBMSC-0011, WARNING, "Storage array {identifier} was modified. Its new IP address is {ip_address}."
IBMSC-0014, INFO, "vCenter server with IP address {ip_address} was added by user {user_name}."
IBMSC-0015, WARNING, "vCenter server with IP address {ip_address} was removed."
IBMSC-0016, WARNING, "Credentials for vCenter server with IP address {ip_address} were updated by user {user_name}."
IBMSC-0017, INFO, "Storage pool {pool_name} on storage array {identifier} was attached to vCenter server with IP address
{ip_address}."
IBMSC-0018, WARNING, "Storage pool {pool_name} on storage array {identifier} was detached from vCenter server with IP address
{ip_address}."
IBMSC-0019, ERROR, "Failed to connect to storage array {identifier}. Reason: {reason}."
IBMSC-0020, INFO, "Information retrieval from storage array {identifier} was completed."
IBMSC-0021, ERROR, "Failed to retrieve information from storage array {identifier}. Reason: {reason}."
IBMSC-0022, INFO, "LDAP authentication was enabled."
IBMSC-0023, INFO, "LDAP authentication was disabled."
IBMSC-0024, INFO, "Completed the vSphere Web Client extension task {task_name} with the following parameters: {parameter_list}."
IBMSC-0025, ERROR, "Failed to complete the vSphere Web Client extension task {task_name} with the following parameters
{parameter_list}.
Reason: {reason}."
  • hsgsvr.log – Records events regarding monitoring and operations on storage arrays and volumes.
  • vasa1.log – Records events regarding the communication between Spectrum Control and the connected vCenter servers that utilize VASA functions.
  • vwc.log – Records events regarding the communication between Spectrum Control and the vSphere Web Client Server on which the IBM Storage Enhancements are installed.
  • celery.log – Records events regarding the Celery services on the Linux host on which Spectrum Control is installed.
  • sc_django.log – Records events regarding the Django service on the Linux host on which Spectrum Control is installed.
  • ds8k_proxy.log – Records ESS network interface (ESSNI) proxy operations for DS8000®.
  • ds8k_jsvc_error.log – Records startup failures of the ESSNI proxy for DS8000.
  • ds8k_jsvc.log – Records Apache Jsvc operations for DS8000.
  • vco.log – Records events regarding operation of the vSphere Orchestrator, complementing information stored in the hsgsvr.log file. The vco.log file is accessed via the Log tab of the vCO plug-in interface. If the Inventory folder within the 'IBM Storage' context is empty and the following message is stored in the vco.log: [SCRepository] com.sun.jersey.api.client.ClientHandlerException: javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: No name matching sc8.ps.xiv.ibm.com found, replace the default Spectrum Control SSL certificate and key files as described in GUI – Managing server certificates.

You can retrieve and save the current log files in a compressed TAR archive file by using the Collect Log option on the Settings menu of the Spectrum Control GUI. This option allows you to save different instances of the log files at different times.

Figure 1. Controller GUI – Collect Logs option
This image shows the Collect Log option on the Settings menu.