Enabling tracing

By enabling the tracing feature, you can troubleshoot problems that you might encounter during operations with the IBM Storage Protect vSphere Client plug-in or the tag-based data mover node.

About this task

To enable tracing in the common VMware vCloud Suite layer for both the backup-archive command-line client and the IBM Storage Protect vSphere Client plug-in, the following trace files and trace properties files are used:
Log location
Trace output is added to the following log files:
  • Windows operating systems(Data Protection for VMware) C:\IBM\StorageProtect\webserver\usr\servers\veProfile\logs\vcsplugin.log
  • Linux operating systems(Data Protection for VMware) /opt/tivoli/tsm/tdpvmware/common/webserver/usr/servers/veProfile/logs/vcsplugin.log
Log property location
The property values are updated in the following trace properties files to enable tracing:
  • Windows operating systems(Client) C:\Program Files\Tivoli\TSM\baclient\plugins\vcloudsuite\sdk\log4j.properties
  • Linux operating systems(Client) /opt/tivoli/tsm/client/ba/bin/plugins/vcloudsuite/sdk/log4j.properties
  • Windows operating systems(Data Protection for VMware) C:\IBM\StorageProtect\webserver\usr\servers\veProfile\apps\tsmVmGUI.war\WEB-INF\classes\log4j.properties
  • Linux operating systems(Data Protection for VMware) /opt/tivoli/tsm/tdpvmware/common/webserver/usr/servers/veProfile/apps/tsmVmGUI.war/WEB-INF/classes/log4j.properties

Procedure

  1. To view more detailed trace information for the common VMware vCloud Suite layer, change the following property value from INFO to TRACE in the corresponding log4j.properties file:
     logger.ve.level = TRACE
  2. To view more detailed trace information for the common vCloud Suite layer, VMware vCloud Suite SDK, and associated .jar files, change the following property value from WARN to TRACE, in the corresponding log4j.properties file
    rootLogger.level =TRACE
  3. Rerun the actions or commands that caused the error.
    If the error occurred in the IBM Storage Protect vSphere Client plug-in, you must restart the server that hosts the Data Protection for VMware vSphere GUI.