IBM Tivoli TrainingNetcool/Proviso
IBM Tivoli Training Netcool/Proviso Generating DataView debug data
This IBM Education Assistant module demonstrates how to generate DataView debug data using the SilverStream PVRDebugControl tool.
Objectives
Objectives Upon completion of this module, you should be able to: Understand the appropriate tool, PVRDebugControl, used to get specific DataView debug data Define the basic steps to generate a DSO level 5 debug report Understand the impact on DataView log files when using PVRDebugControl
Upon completion of this module you should be able to: Understand the appropriate tool, PVRDebugControl, used to get specific DataView debug data Define the basic steps to generate a DSO level 5 debug report Understand the impact that running debug has on log files
Assumptions
Assumptions Before issuing commands: You must have Netcool/Proviso® 4.3.4 or higher installed and running You have login access to the DataView server
Before issuing commands: You must have Netcool/Proviso 4.3.4, or higher, installed and running You must have access to the DataView server and DataView UNIX® login
Gathering detailed DataView log data
Gathering detailed DataView log data Enhanced debug data is often required to troubleshoot failing reports. DataView debug data is written to the SilverServerConsole.log. The PVRDebugControl tool controls what and how much data is written to the log. Log size can increase depending on the debug modules and level selected.
When problems within DataView are encountered, the PVRDebugControl tool can be utilized. Understand that: Enhanced debug data is often required to troubleshoot failing reports. DataView debug data is written to the SilverServerConsole.log. The PVRDebugControl tool controls what and how much data is being written to the log. Log size varies depending on the debug modules and debug level selected
Example of generating a DSO level 5 DataView debug log for a failing report
Example of generating a DSO level 5 DataView debug log for a failing report Launch the report in a browser. Launch the PVRDebugControl tool Set PVRDebugControl to capture level 5 DSO debug data Prepare to capture debug data to a file Refresh the report and capture the data Return the PVRDebugControl to normal operation
This module will demonstrate an example of generating DSO Level 5 debug data. To gather the debug information required to troubleshoot a reporting problem using the PVRDebugControl tool, the following steps must be taken: Launch the report in a browser. Then follow these steps in order: Launch the PVRDebugControl tool Set PVRDebugControl to capture level 5 DSO debug data Prepare to capture debug data to a file Refresh the report and capture the data Return the PVRDebugControl to normal operation
Launch the PVRDebugControl tool
Launch the PVRDebugControl tool
The PVRDebugControl tool is located in the SilverStream bin directory. Use the SilverJRunner process to launch the PVRDebugControl. Specify the host and port as well as the ORACLE_SID for the Proviso database. You can supply the administrator credentials for SilverStream also. In this module’s example, the command issued is: /opt/silverstream/bin/SilverJRunner -space- localhost:8080 –space- PV –space -PVRDebugControl
Enter SilverStream administrator credentials
Enter SilverStream administrator credentials
If the SilverStream credentials were not supplied with the command, you need to enter them when prompted. In this example, the default SilverStream admin user and password are used.
Example of setting DSO level 5 debug
Example of setting DSO level 5 debug
In the PVRDebugControl tool, you will need to set the appropriate options to produce a DSO level 5 debug report. First, select the DSO module. Then, within the Display mode segment, select console. Set the debug level to 5 and click submit. At this point you are generating level 5 debug data for DataView. Be aware that the SilverServerConsole log will now rapidly increase in size.
Enter the log capture command
Enter the log capture command
The SilverServerConsole.log is where the output from the DSO level 5 debug will be placed. It contains previous data collected prior to running the DSO level 5 debug dump. Use the tail command and redirect the output to a separate log file to ensure the debug dump information is readily available. In the example, the new log file is named SS_dso_l5.log.
Refresh the report
Refresh the report
Open the browser window and refresh the failing report. This will generate DSO level 5 debug dump data, which is sent to the SilverServerConsole.log. And, as shown previously, that log file is tailed, and the output of the tail is redirected to a separate log file.
Stop the logging by entering Control-C
Stop the logging by entering Control-C
After the refresh has completed, stop the tail by issuing a Control-C in the Xterm window.
Contents of log
Contents of log
The SS_dso_l5.log file is large for this particular Proviso installation. That is because of the module and debug level selected using the PVRDebugControl tool. These log files can be much larger in your Proviso installation. The options used to create the DSO level 5 debug dump fill the logs rapidly. For that reason, it is important to reset the default values in the PVRDebugControl tool after the log has been captured.
Restore debug defaults
Restore debug defaults
Deselect the DSO module and Console. Reset the debug level to 0 and submit. The PVRDebugControl is now returned to the default values. Exit the tool.
Summary
Summary You should now be able to: Understand the appropriate tool, PVRDebugControl, used to get specific DataView debug data Define the basic steps to generate a DSO level 5 debug report Understand the impact on DataView log files when using PVRDebugControl
You should now be able to: Understand the appropriate tool, PVRDebugControl, used to get specific DataView debug data Define the basic steps to generate a DSO level 5 debug report Understand the impact on log files of running debug
Training roadmap for Netcool/Proviso
Training roadmap for Netcool/Proviso http://www.ibm.com/software/tivoli/education/edu_prd.html
Copy and paste the link provided into the browser of your choice to explore the training roadmap for Netcool/Proviso.
Trademarks