The Benefits of Running IBM Cognos 8 Diagnostic
The Benefits of Running IBM Cognos 8 Diagnostic
Diagnostics are troubleshooting tools that are widely used in the software industry today. Diagnostics mainly help to find and eliminate problems and also to automate a collection of data. They are fast, accurate, and results can be compared to previous runs.
This diagnostic retrieves system and product information about IBM Cognos 8 Product for both Windows and UNIX operating systems.
Requirements to Execute IBM Cognos 8 Diagnostic
JAVA Runtime Environment version 1.4 and higher is the only requirement. JAVA must be included in the PATH setting for System Environment Variables.
Downloading the Diagnostic Tools
You can download the diagnostic tools from the Cognos Software Services web site.
- Click on IBM Cognos 8 Diagnostic for Windows.
- Enter your login credentials in the Connect to support.cognos.com dialog box.
- Immediately after the verification of the credentials, the legal disclaimer will appear. Check the acceptance box to continue with the download.
- Save the IBMCognos8.zip file associated with the diagnostic to your local machine and extract all files.
- execute_IBMCognos8.bat
- IBMCognos8.jar
- IBMCognos8.properties
- IBM Cognos 8 Diagnostic.pdf
How to Run the Diagnostic Tools
To run the diagnostics, from the extracted files choose one of the follow steps:
- Double click on the execute_IBMCognos8.bat
- a DOS command prompt will appear to show the status of the diagnostic as the diagnostic is running
- This is the recommended way
- From a DOS command prompt type the following
- java -jar IBMCognos8.jar
- a DOS command prompt will appear to show the status of the diagnostic as the diagnostic is running
- Double click on IBMCognos8.jar
- this will run the diagnostic in the background
- a DOS command prompt will not appear to show the status of the diagnostic as the diagnostic is running
IBM Cognos Diagnostic Tools in Action
Once the diagnostic is executed, a check box with a choice of properties appears:
- Authentication Information
- Printer Information
- JAVA_HOME setting
- Processes
- Files
- Email Issues
- displays the files cogroot.link and cogconfig.prefs
- displays the IBM Cognos Configuration
The “Save Current Settings” button will save all the information selected. There will be no need to renter you choices each time this diagnostic is executed.
Once all is complete in the dialog box, click on the OK button to run the diagnostics.
Diagnostic results are being gathered and displayed in a tabbed view. Explore the results by clicking on the tabs.
Along with the tabbed view, another window appears with three buttons to choose from.
- Tabbed View
- to view the results in a “Tabbed View”
- View Results File
- to view the results in a text format
- Go To Results Directory
- to go the location where the text file is saved
- where the pertinent to debugging IBM Cognos 8 Files have copied to
- for quick access to the files and results if needed to be emailed
Viewing Results in Tabbed View at a Later Time
It is very easy to view the results in a tabbed view at a later time. Every time the IBM Cognos 8 Diagnostic is downloaded, a folder named GUI_Cognos8 is also automatically downloaded.
Go to the GUI_Cognos8 folder. This folder holds 3 files, a batch, a jar file and a PDF file. Clicking on the batch file called Execute_GUI_IBMCognos8.bat. The following window will appear.
Click on the browse button to browse to locate the IBM Cognos 8 results file in text format. Then click OK. Diagnostic results will appear in a tabbed view.
How to Run IBM Cognos 8 Diagnostic for UNIX
From the URL http://support.cognos.com/en/support/diagnostics/index.html
Click on the link IBM Cognos 8 under the label Enterprise Business Intelligence Products.
For IBM Cognos 8, the Following Diagnostics are available for downloading for both Windows and UNIX where applicable.
- IBM Cognos 8 Content Store Diagnostic
- IBM Cognos 8 Diagnostic
- IBM Cognos 8 Framework Manager Diagnostic
- IBM Cognos 8 Health Check
- IBM Cognos 8 SDK Validation Tool
Downloading and Extracting the IBMCognos8.tar:
Choose IBM Cognos 8 Diagnostic for UNIX under the label IBM Cognos 8 Diagnostic, and accept the legal disclaimer. Then you will be prompted to save the IBMCognos8_ux.tar file on your local windows directory.
FTP the IBMCognos8_ux.tar file in binary to a UNIX box.
On UNIX, using the Command: tar xpf IBMCognos8_ux.tar
The following files are unzipped:
- IBMCognos8_ux.jar
- The java code
- execute_IBMCongos8_ux.sh
- Typing this command will execute the java code
- IBMCognos8diagnostic_ux.txt
- A document to explain what this IBM Cognos8 Diagnostic retrieves and how to run it, also includes legal disclaimer
- IBMCognos8_ux.properties
- To remember where the entered IBM Cognos 8 Install Location,
- Directory Called GUI_IBMCognosUX which includes 2 files
- GUI_IBMCognos8_ux.jar
- execute_GUI_IBMCognos8_ux.sh
- This is where you can view your results in the GUI tabbed view at a later time.
- This is where you can view your results in the GUI tabbed view at a later time.
Conclusion - Diagnostic Tools
All diagnostics have a similar behaviour. They are associated with a product and each has a PDF file which briefly describes what information is being retrieved.
The jar file which is the implementation of each diagnostic, and as well as a *.bat file for Windows.
All the results are written to a folder that is created called DT_TOOLS. This folder is created in the user temporary directory. If the user does not have a temporary directory set, then the system temporary directory is used.
The only requirement is that Java Run Time ( JRE 1.4.x ) is in your PATH environment variable. Diagnostics are available for Windows and UNIX, where applicable.
Komentar
Posting Komentar