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