IBM Cognos Architecture Diagram Tool For IBM Cognos BI Version 8.

User Guide

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

INTRODUCTION PURPOSE REQUIREMENTS WINDOWS INSTALLATION

3 3 3 3

RUN THE ARCHITECTURE DIAGRAM TOOL NAVIGATE TO COGSTARTUP.XML SAVE CURRENT SETTINGS BUTTON OK BUTTON LOGIN TO YOUR DISPATCHER VIEW YOUR CONFIGURATION STATUS DIALOG DIAGRAM MENU LEGEND CLICK ON COMPONENTS OF A COMPUTER ADD NOTE RIGHT CLICK OPTIONS HIDE/SHOW CONNECTION LINE COPYRIGHT AND TRADEMARK INFORMATION

4 4 4 4 5 6 6 7 7 8 8 9 10 10 11

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 2

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Introduction
Purpose
This document is intended for use with IBM Cognos BI Version 8.4 products. It provides information for using the Architecture Diagram Tool. This tool was developed to show the architecture diagram of Cognos installation components and some settings. This tool is read-only. Cognos settings can not be modified with this tool.

Requirements
IBM Cognos BI Version 8.4 Other Cognos BI versions are not compatible with this version of the architecture diagram tool. Microsoft Windows This tool will run on Microsoft Windows operating system only. Java This tool will run with Java version 1.5 and higher.

Windows Installation
1. Download the zip file to any directory on your computer. 2. Extract the zip file. 3. A directory is created containing the files: run.jar cog.bat lian_en.txt IBM Cognos Architecture diagram Tool for IBM Cognos 8.pdf 4. Place the extracted directory under <Cognos installation>\bin\utilities. 5. Check that the java path is included in the System PATH environment variable.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 3

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Run the Architecture Diagram Tool

To run this tool, double click the file run.jar or execute the file cog.bat located in the directory <Cognos installation >\bin\utilities\cog\IBM Cognos Architecture Diagram Tool_v4.

Navigate to cogstartup.xml

Save Current Settings button

Click the Save Current Settings button to create a property file named configuration in the tool installation directory. The next time the tool is run, the cogstartup.xml file path will be pre-populated with the last saved setting.

OK button
Click the OK button to continue to the dispatcher login page.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 4

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Login to your dispatcher

Parameters to add or modify: User Name: Enter a user name to login to dispatcher. Password: Enter a valid password. Namespace ID: Enter a valid namespace ID. Dispatcher URL: Enter a Dispatcher URL. This value is found in the Cognos configuration file. Anonymous Checkbox: if anonymous access is enabled in the Cognos configuration file, check this box to run with Anonymous access Click the Login button to continue. Click the Cancel button to exit the tool.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 5

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

View your configuration

The time required for a diagram to be displayed will vary depending on the size of the distribution environment. This tool will ping all dispatchers and computers in the network. Allow anywhere from 10 seconds up to 2 minutes for a large distribution.

Status dialog

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 6

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4 The status dialog indicates the completion of network connection testing. Click the Close button to continue. Diagram The Diagram window is resizable. In the case of a very large distribution, the Diagram may have overlapping components. To make the Diagram easier to read, it is recommended to maximize the window or resize the window to a larger size.

Menu
File: o New : Enables the user to choose and navigate to a new cogstartup.xml Connection: the connection between the components of each computer is viewed by a line from the starting component and ending with a circle to the ending component. o Refresh: You can refresh the diagram to monitor the network connection at any time and notice the changes. o Gateway dispatcher connection : toggle to show or hide this connection o Dispatcher content manager connection : toggle to show or hide this connection o Content manager content store connection: toggle to show or hide this connection o Content manager authentication provider connection: toggle to show or hide this connection Run Tools : The following available diagnostic tools that can be run : o IBM Cognos 8 Dispatcher utility : download from http:// www-01.ibm.com/support/docview.wss?rs=0&uid=swg24021220 o IBM Cognos 8 Content Manager size tool : installed with the product and is located at <Cognos installation directory >\bin\utilities\diagnostictools \win32 o IBM Cognos 8 Content Manager browser tool : installed with the product and is located at <Cognos installation directory >\bin\utilities \diagnostictools\win32 Take Screen Shot: take a screen shot of the current saved under the current directory the tool is running. Help: o Legend: view the legend which explains each symbol

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 7

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Legend

Click on components of a computer

Each computer is illustrated by a gray box. Each component is illustrated by a white box inside the gray box. If you click on each white box you can view more information about that specific component. In the example below, you can see that computer tp-joharii includes an NTLM authentication provider. Click the AP box to display a popup box with information about that specific authentication provider. In the example shown below, the namespace ID is ntlm and the type of the authentication provider is NTLM. The example also shows that the selected computer cant be accessed by the computer running the IBM Cognos Architecture Diagram Tool. If the name of the workstation is printed in red-e.g. sottendtdc2 - it could be an indication of high network traffic and therefore a time out of the ping that was sent to the target computer; or it could indicate insufficient privileges because the computer is inaccessible.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 8

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Add Note
Right click on the main diagram and select Add Note. A text box is displayed at that location. Add comments about specific computers or any errors you have encountered.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 9

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Right click options

Hide/Show connection line

The following example shows the difference between the two diagrams using the hide/ show feature. Show Hide

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 10

IBM Cognos Architecture Diagram Tool for IBM Cognos BI Version 8.4

Copyright and trademark Information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Licensed Materials - Property of IBM Copyright IBM Corp. 2010 Page 11