ITCAM Agent for WebSphere Applications Reports Installation and User Guide

Transcription

1 Version 7.2 ITCAM Agent for WebSphere Applications Reports Installation and User Guide SC

2

3 About this publication Publications This book provides a user, installation, and troubleshooting guide for IBM Tivoli Composite Application Manager (ITCAM) Agent for WebSphere Applications Reports. This section lists publications in the product library and related documents. It also describes how to access Tivoli publications online and how to order Tivoli publications. ITCAM for Applications library for Agents for WebSphere Applications, J2EE, and HTTP Servers The following publications are included in the ITCAM for Applications library, available in the: ITCAM for Applications Information Center v IBM Tivoli Composite Application Manager: Agents for WebSphere Applications, J2EE, and HTTP Servers User's Guide Provides the user overview, user scenarios, and Helps for agents for WebSphere Applications, J2EE, and HTTP Servers. v IBM Tivoli Composite Application Manager: Agents for WebSphere Applications, J2EE, and HTTP Servers Planning an Installation Provides the user with a first reference point for installation or upgrade of agents for WebSphere Applications, J2EE, and HTTP Servers. v IBM Tivoli Composite Application Manager: Agent for WebSphere Applications Installation and Configuration Guide Provides installation instructions for setting up and configuring ITCAM Agent for WebSphere Applications on distributed systems. v ITCAM Agent for J2EE Applications Installation and Configuration Guides: IBM Tivoli Composite Application Manager: Agent for J2EE Data Collector Installation and Configuration Guide IBM Tivoli Composite Application Manager: Agent for J2EE Monitoring Agent Installation and Configuration Guide Provides installation instructions for setting up and configuring ITCAM Agent for J2EE. v IBM Tivoli Composite Application Manager: Agent for HTTP Servers Installation and Configuration Guide Provides installation instructions for setting up and configuring ITCAM Agent for HTTP Servers. v IBM Tivoli Composite Application Manager: Agents for WebSphere Applications, J2EE, and HTTP Servers Troubleshooting Guide Provides instructions on problem determination and troubleshooting for agents for WebSphere Applications, J2EE, and HTTP Servers. v IBM Tivoli Composite Application Manager for Application Diagnostics: Messaging Guide Provides information about system messages received when installing and using agents for WebSphere Applications, J2EE, and HTTP Servers. Copyright IBM Corp iii

4 v IBM Tivoli Composite Application Manager: Agent for WebSphere Applications Reporting Guide Provides information about installing Agent for WebSphere Applications Reports and creating pre-defined and ad-hoc reports. Related publications The following documentation also provides useful information: v IBM Tivoli Documentation Central: Information about IBM Tivoli Documentation is provided on the following website: v IBM WebSphere Application Server: Information about IBM WebSphere Application Server is provided on the following website: v ITCAM for Application Diagnostics library: Information about ITCAM for Application Diagnostics Managing Server is provided on the following website: %2Fcom.ibm.itcamfad.doc_7101%2Fic-homepage.html v IBM DB2 : Information about IBM DB2 is provided on the following website: v Tivoli Data Warehouse Information about Tivoli Data Warehouse is provided on the following website: Tivoli+Data+Warehouse v IBM Tivoli Monitoring Information about IBM Tivoli Monitoring is provided on the following website: v IBM Tivoli Information Center: Information about IBM Tivoli products are provided on the following website: com.ibm.tivoli.tdwi.doc/toc.xml v IBM Support Assistant: Information about IBM Support Assistant is provided on the following website: Accessing terminology online The IBM Terminology website consolidates the terminology from IBM product libraries in one convenient location. You can access the Terminology website at Accessing publications online The documentation CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. iv ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

5 IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Documentation Central website at Access the Tivoli Information Center for ITCAM for Applications at the following web address: ITCAM for Applications Information Center Note: If you print PDF documents on other than letter-sized paper, set the option in the File Print window that allows Adobe Reader to print letter-sized pages on your local paper. Ordering publications You can order many Tivoli publications online at: You can also order by telephone by calling one of these numbers: v In the United States: v In Canada: In other countries, contact your software account representative to order Tivoli publications. To locate the telephone number of your local representative, perform the following steps: 1. Go to 2. Select your country from the list and click Go. 3. Click About this site in the main panel to see an information page that includes the telephone number of your local representative. Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. Tivoli technical training Tivoli user groups For additional information, see Accessibility Statement. For Tivoli technical training information, refer to the following IBM Tivoli Education website: Tivoli user groups are independent, user-run membership organizations that provide Tivoli users with information to assist them in the implementation of Tivoli Software solutions. Through these groups, members can share information and learn from the knowledge and experience of other Tivoli users. For more information about Tivoli Users Group, see About this publication v

6 Support information If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at support/probsub.html. Troubleshooting Guide For more information about resolving problems, see the IBM Tivoli Composite Application Manager: Agents for WebSphere Applications, J2EE, and HTTP Servers Troubleshooting Guide. Conventions used in this publication This publication uses several conventions for special terms and actions, operating system-dependent commands and paths, and margin graphics. Typeface conventions This publication uses the following typeface conventions: Bold Italic v v v v v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text Citations (examples: titles of publications, diskettes, and CDs Words defined in text (example: a nonswitched line is called a point-to-point line) v Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictive clause."; letters as letters example: "The LUN address must start with the letter L.") v New terms in text (except in a definition list): a view is a frame in a workspace that contains data. v Variables and values you must provide:... where myname represents... Monospace v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options Operating system-dependent variables and paths This guide refers to the following variables: vi ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

7 v ITM_home: the top-level directory for installation of IBM Tivoli Monitoring components. The default location is C:\IBM\ITM on Windows systems and /opt/ibm/itm on Linux and UNIX systems: About this publication vii

8 viii ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

9 Part 1. Introduction Copyright IBM Corp

10 2 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

11 Chapter 1. ITCAM Agent for WebSphere Applications Reports ITCAM Agent for WebSphere Applications Reports is the reporting package for ITCAM Agent for WebSphere Applications. You can use ITCAM Agent for WebSphere Applications Reports to create historical reports based on the data that is collected by the ITCAM Agent for WebSphere Applications. ITCAM Agent for WebSphere Applications is part of the ITCAM for Applications bundle. ITCAM Agent for WebSphere Applications Reports Architecture Overview ITCAM Agent for WebSphere Applications Reports is deployed in a Tivoli Monitoring environment. Tivoli Monitoring includes Tivoli Common Reporting and Tivoli Data Warehouse. ITCAM Agent for WebSphere Applications Reports is installed on Tivoli Common Reporting. The user interface for Tivoli Common Reporting is Tivoli Integrated Portal. You create and view reports in the Tivoli Integrated Portal. The Tivoli Data Warehouse is the data source for ITCAM Agent for WebSphere Applications Reports. When you enable historical data collection for ITCAM Agent for WebSphere Applications, collected data is stored in Tivoli Data Warehouse. ITCAM Agent for WebSphere Applications Reports includes Cognos Data Model. Copyright IBM Corp

12 4 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

13 Chapter 2. Prerequisites and preinstallation tasks for ITCAM Agent for WebSphere Applications Reports Verify that your computer meets the system and software prerequisites. System and Software Prerequisites The following software prerequisites are required before you install ITCAM Agent for WebSphere Applications Reports: v v v v v Tivoli Monitoring fix pack 3 or higher: IBM Tivoli Monitoring Information Center Tivoli Common Reporting or version 3.1: Tivoli Common Reporting Information Center ITCAM Agent for WebSphere Applications 7.1 Fix Pack 2, interim fix 3, or higher: ITCAM for Applications Information Center Tivoli Data Warehouse (including Summarization and Pruning agent [SnP]): IBM Tivoli Monitoring information center You must have Java Runtime Environment (JRE) 1.5 or higher installed on the systems where you are plan to run the reports installer. For more information about software prerequisites, see WebSphere Applications agent V7.2 See the Software product compatibility reports website to generate a variety of reports related to product and component requirements. Note: ITCAM Agent for WebSphere Applications Reports is a component of ITCAM for Applications version 7.2. To run a report specific to ITCAM for Application version 7.2, specify Tivoli Composite Application Manager for Applications as the product name and 7.2 as the version. Databases supported The databases that are supported are the same as the databases supported by Tivoli Data Warehouse: v IBM DB2 Universal Database V9.5.2 with fix packs v IBM DB2 Universal Database V9.7 with fix packs v IBM DB2 Universal Database V9.8 with fix packs v IBM DB2 Universal Database V10.1 with fix packs (Tivoli Monitoring V6.3 and later v Oracle Database 10g Release 2 v Oracle Database 11g Release 1 (Tivoli Monitoring V6.3 and later) v Oracle Database 11g Release 2 (Tivoli Monitoring V6.3 and later) v Microsoft SQL Server 2005 SP3 v Microsoft SQL Server 2008 SP2 v Microsoft SQL Server 2012 Enterprise Edition (Tivoli Monitoring V6.3 and later) Copyright IBM Corp

14 Configuring database client connections The data store for Tivoli Common Reporting is Tivoli Data Warehouse. Tivoli Data Warehouse can use a DB2, Oracle, or Microsoft SQL Server database as a data store. Tivoli Common Reporting uses ODBC to connect to the database. Follow Tivoli Monitoring guidelines for creating and configuring the Tivoli Data Warehouse. If Tivoli Common Reporting and the Tivoli Data Warehouse database are on different servers, you must complete four steps to configure database settings on Tivoli Common Reporting: 1. Install a database client on Tivoli Common Reporting. Attention: Tivoli Common Reporting is a 32-bit application. You must use a 32-bit version of database client. 2. Connect the database client on the Tivoli Common Reporting host to the database server. Depending on your client type and your Tivoli Common Reporting platform, you might have to update environment variables (for example, PATH, LD_LIBRARY_PATH). If you created or updated environment variables, you must restart the Tivoli Common Reporting server to apply the changes. 3. If you are doing a manual installation, create a data source connection in Tivoli Common Reporting. During the installation, a data source is created to communicate with Tivoli Data Warehouse. Depending on your database, complete the following steps to configure the database settings: v Microsoft SQL Server: Configuring a Microsoft SQL Server database v Oracle: Configuring an Oracle database v DB2: Configuring a DB2 database on page 7 Configuring a Microsoft SQL Server database Procedure 1. Install the Microsoft SQL Server database client on the Tivoli Common Reporting system where you will install ITCAM Agent for WebSphere Applications Reports. You might use a System DSN connection to create a data source on Windows systems. Important: On 64-bit system, you must configure System DSN using the 32-bit version of the Windows ODBC utility. To use the 32-bit version, run Odbcad32.exe in system_drive\windows\syswow To connect the Microsoft SQL Server client to the database server, run the Microsoft SQL Server Management Studio Express. Configure the local net service name configuration. Configuring an Oracle database Procedure 1. Install the Oracle instant client on the Tivoli Common Reporting computer where you plan to install ITCAM Agent for WebSphere Applications Reports. 6 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

15 Remember: Use the 32-bit version of instant client. 2. To connect the Oracle instant client to the database server, run the Oracle Net Configuration Assistant. Configure the local net service name configuration. If Net Configuration Assistant is not available, follow the instructions on the Oracle website for creating a connection for your database version 3. Copy tnsnames.ora and sqlnet.ora files from the Oracle server machine to the Oracle database client installation directory on the Tivoli Common Reporting computer. 4. Add the path to the Oracle instant client to the system PATH variable. 5. Create and export the TNS_ADMIN environmental variable. Set TNS_ADMIN to the Oracle tnsnames.ora file location. 6. Restart the Tivoli Common Reporting. Configuring a DB2 database Procedure 1. Install the DB2 database client on the Tivoli Common Reporting computer where you will install ITCAM Agent for WebSphere Applications Reports. The DB2 client must be the same version as the DB2 server database that Tivoli Common Reporting is using. 2. Connect the DB2 database client to the DB2 database server. Configure the local net service name configuration. For more details, see Connecting to a DB2 database Connecting to a DB2 database Procedure Run the following DB2 commands: db2 catalog tcpip node host remote host.domain.com server db2 catalog database WAREHOUS as db_alias at node host authentication server where host is the short host name of the computer where the DB2 database is located. WAREHOUS is your Tivoli Data Warehouse database name. db_alias can be any name of your choice. For example: db2 => catalog tcpip node dbserver remote dbserver.domain.com server db2 => catalog database WAREHOUS as WAREHOU1 at node dbserver authentication server Enabling historical data collection Before you install ITCAM Agent for WebSphere Applications Reports, enable historical data collection and configure summarization and pruning on the ITCAM Agent for WebSphere Applications. For more information, see the IBM Tivoli Monitoring information center. Ensure that raw (un-summarized/detailed) and summary tables for the following attribute groups are created: v Application_Server v Application_Server_Status v Application_Health_Status Chapter 2. Prerequisites and preinstallation tasks for ITCAM Agent for WebSphere Applications Reports 7

16 v v v v v v v DB_Connection_Pools Enterprise_Java_Beans Garbage_Collection_Analysis Request_Analysis Servlets_JSPs Thread_Pools Web_Applications Modifying the time period that is used to populate TIME_DIMENSION table The installation program creates the Tivoli Reporting and Analytics Model (TRAM) tables when you install ITCAM Agent for WebSphere Applications Reports. About this task When you install ITCAM Agent for WebSphere Applications Reports, the following tables are created with schema IBM_TRAM in Tivoli Data Warehouse: v ComputerSystem v MONTH_LOOKUP v TIMEZONE_DIMENSION v WEEKDAY_LOOKUP v TIME_DIMENSION To specify the time period for reports, you run a script to populate the TIME_DIMESION table. You can specify the period of time and the interval of time for your reports. By default, the TIME_DIMENSION table is populated with data for 5 years, 2011 through 2015 in 1 hour intervals. Note: Only complete the following steps if you want to change the default seeding of the TIME_DIMENSION table. Procedure 1. Open one of the following script in a text editor: DB2: call_proc_db2.sql Microsoft SQL Server: call_proc_mssql.sql Oracle: call_proc_oracle.sql The scripts are located in the ITCAM_for_AD_Report_Installer_HOME\reports\ cognos_reports\itcam_ad_cognos_report\db_scripts directory. The script has three parameters: start_date, end_date, and data frequency. 2. Modify the following line in the script call IBM_TRAM.CREATE_TIME_DIMENSION(' ',' ',60) where start_date use the following format: YYYY-MM-DD-HH.MM.SS end_date use the following format YYYY-MM-DD-HH.MM.SS 8 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

17 data frequency enter a numeric value to indicate the data frequency in minutes Note: If you want to display yearly data in reports, adjust the time period in the TIME_DIMENSION table so it begins one granular interval before the start date you require in your reports. For example, if you want your reporting period to start from 12:00 AM January with one hour of granularity, specify the start date as: Editing the Oracle scripts (Oracle only) This task applies only to implementations where Oracle is used. About this task When you install ITCAM Agent for WebSphere Applications Reports, the TRAM tables are created in Tivoli Data Warehouse. For an Oracle implementation, before you install ITCAM Agent for WebSphere Applications Reports you must amend the create_table_oracle.sql, create_view_oracle.sql, and create_table_indexes_oracle.sql to includes system user credentials. Procedure 1. Open the create_table_oracle.sql file that is located in the ITCAM_for_AD_Report_Installer_HOME\reports\cognos_reports\ itcam_ad_cognos_report\db_scripts directory. 2. Change the parameter values used by the script to match your environment settings: Table 1. Parameters for the create_table_oracle.sql Parameter Description Default Value Change To: DEFAULT_TBSPC Defines default tablespace for IBM_TRAM USERS Replace with the default users tablespace name. TEMPORARY_TBSPCDefines temporary tablespace for IBM_TRAM TEMP Replace with the temporary tablespace name. ITM_USER Defines Tivoli Data Warehouse user ID ITMUSER Replaced with an actual TDW user ID. TCR_PASS Defines IBM_TRAM user password password Replace with password for an 'IBM_TRAM' user. 3. Open the create_view_oracle.sql and create_table_indexes_oracle.sql files located in the same directory and replace all occurrences of ITMUSER schema with the actual TDW user ID. Chapter 2. Prerequisites and preinstallation tasks for ITCAM Agent for WebSphere Applications Reports 9

18 10 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

19 Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports You can install ITCAM Agent for WebSphere Applications Reports using the Tivoli Report Installer, or you can perform a manual installation. Tivoli Report Installer can be run in GUI or silent mode. You can also install ITCAM Agent for WebSphere Applications Reports in console mode. Determining whether to use the Tivoli Report Installer or a manual installation When you use the Tivoli Report Installer to install ITCAM Agent for WebSphere Applications Reports, all data in the TRAM tables is overwritten. If a reporting package for another agent or ITCAM Agent for WebSphere Applications Reports was previously installed, all data associated with these agents in the TRAM tables is overwritten. If you had customized the TRAM tables, the customization is also overwritten. To avoid overwriting the data in the TRAM tables, use the manual installation steps, see Manually Installing ITCAM Agent for WebSphere Applications Reports on page 20 Installing ITCAM Agent for WebSphere Applications Reports using the console mode You can install ITCAM Agent for WebSphere Applications Reports from a command line. You can use this method if an X window server is not available during the installation on a Linux or UNIX system. Procedure 1. Open a command prompt and run the following command: Windows: setup_windows.exe -i console AIX: setup_aix.bin -i console Linux:setup_linux.bin -i console HP setup_hpux.bin -i console: Solaris: setup_solaris.bin -i console 2. The following message is displayed: Choose Locale GERMAN 2- English 3- SPANISH 4- FRENCH 5- ITALIAN 7- PORGUGUESE_BRAZIL Enter the number that corresponds to your installation language. 3. The following message is displayed: Preparing CONSOLE Mode Installation... =============================================================================== Welcome Copyright IBM Corp

20 InstallAnywhere will guide you through the installation of IBM Tivoli Composite Application Manager Agent for WebSphere Applications. It is strongly recommended that you quit all programs before continuing with this installation. Press Enter to proceed to the next window. If you must change anything in the previous window, type "back" and press Enter. You may quit this installation at any time by typing "quit" and pressing Enter. PRESS <ENTER> TO CONTINUE Press Enter 4. The following message is displayed: Choose the Installation Folder The installation folder specifies the path to the Tivoli Common Reporting component directory. You do not need to provide the installation path for the reports, as they are installed into Tivoli Common Reporting directory. Note for Tivoli Common Reporting 2.1 and releases: In case of a distributed Tivoli Common Reporting installation, ensure that the folder you select contains the Cognos engine. Default Install Folder: C:\Program Files\IBM\JazzSM\reporting ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT Specify the location of the Tivoli Common Reporting installation directory or press Enter if Tivoli Common Reporting is installed in the default location. 5. The following message is displayed: 1-Cognos Reports 2-After selecting the report sets, choose this option to continue the installation Choose the report type: Enter The following message is displayed: 1- ITCAM Agent for WebSphere Applications Reports 2- Choose this option to select or deselect all the above report sets Choose the report sets for the installation or press Enter to continue: Enter 1 to indicate that you want to install ITCAM Agent for WebSphere Applications Reports. 7. The Cognos Engine Configuration steps are next. a. The following message is displayed: Enter the Tivoli Common Reporting user name b. The following message is displayed: Enter the Tivoli Common Reporting user password 8. The Cognos Data Source Tivoli Data Warehouse Configuration steps are next. a. The following message is displayed: Do you want to configure the TDW datasource? (if not, this configuration will be skipped) (Y/N): Enter y for yes. b. The following message is displayed: 12 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

21 Enter the database user name (DEFAULT: itmuser): Specify the Tivoli Data Warehouse user name. c. The following message is displayed: Enter the user password: Specify the password for the user name that you used to connect to the Tivoli Data Warehouse data source. d. The installation program displays: 1- DB2 2- ORACLE 3- MSSQL Choose the database type: Enter the number that represents your Tivoli Data Warehouse database type. e. The installation program displays: Enter the database name (DEFAULT: IBMDB): Enter the name of the database that you used to create a connection to the Tivoli Data Warehouse database server. For a Microsoft SQL Server database, you can use the DSN name if you use a System DSN connection. For a DB2 database, you can use the database alias that you used to catalog the database. For an Oracle database, you must use the name that is specified in the tnsnames.ora file. 9. The Data Script Configuration step is next. The installation program displays: Do you want to run the WebSphere_Agent_DB_Scripts database script? (Y/N): Enter y for yes. Important: In the next steps, you create a JDBC connection to the Tivoli Data Warehouse databases and execute SQL scripts that create an IBM_TRAM schema and populate tables under the schema. You must specify a user name that has the authority to create schema in Tivoli Data Warehouse. 10. The Data Script WebSphere_Agent_DB_Scripts Configuration steps are next. a. The following message is displayed: Enter the database user name (DEFAULT: itmuser): Enter a user name that has the authority to create the schema. For an Oracle database, use sys as sysdba. b. The following message is displayed: Enter Password for the user you have entered in the step above. c. The following message is displayed: Data Script WebSphere_Agent_DBScripts Configuration 1- DB2 2 -ORACLE 3- MSSQL Choose the databse type: Enter the number that corresponds to your Tivoli Data Warehouse type. d. The following message is displayed: Enter the database JDBC URL in the following format jdbc:sqlserver://<host>:<port>;databasename=<database> (DEFAULT: ): Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 13

22 Specific the URL for the JDBC connection. For example: DB2: jdbc:db2://<host>[:<port>]/<database_name> Oracle: MSSQL: jdbc:sqlserver://<host>[:<port>];databasename=<database> e. The following message is displayed: Provide the JDBC driver files separated by the semicolon (DEFAULT: ): Provide the appropriate drivers to create the JDBC connection. Tip: Make sure to use a driver that is compatible with the level of the Java Virtual Machine (JVM) of the installer. For example, use the se sqljdbc4.jar MS SQL driver if you use Java 1.6 and above when you run the installer. Usesqljdbc.jar if you use Java 1.5 when you run the installer. f. The following message is displayed: Enter the JDBC driver class (DEFAULT: com.microsoft.sqlserver.jdbc.sqlserverdriver): In most cases, you can accept the default value. If default value is not correct, enter the JDBC driver class path. 11. The following summary message is displayed: The following report sets will be installed: [Cognos reports] ITCAM Agent for WebSphere Applications Reports The following database scripts will be run: WebSphere_Agent_DB_Scripts PRESS <ENTER> TO CONTINUE Press Enter to complete the installation. 12. The following message is displayed: The installation results SUCCESS The database scripts: WebSphere_Agen_DB_Scrips SUCCESS Install the reports: ITCAM Aent for WebSphere applications Reports SUCCESS Create Cognos data source:tdw Press Enter. Silent Installation of ITCAM Agent for WebSphere Applications Reports Instead of doing a GUI installation or using the interactive command mode, you can use a command that points to a response file to install and configure ITCAM Agent for WebSphere Applications Reports. Procedure 1. Before you run a silent installation, create the silent installation response file. The itcam_silent_installer.properties file is a sample response file, it is available in the root directory. Use this as a template for your response file. 2. Run one of the following commands to perform a silent installation: Unix or Linux:setup_platform.bin i silent f path_to_the_response_file Windows: setup_windows.exe i silent -f path_to_the_response_file For an example of the response file template, see Appendix B, Silent Response file, on page ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

23 Results The installer creates the following log files: Unix or Linux /root/report_installer_for_tcr_output.txt /root/report_installer_for_tcr_output.txt/ Report_Installer_InstallLog.log Windows C:\Documents and Settings\Administrator\ Report_Installer_For_TCR_Output.txt C:\Documents and Settings\Administrator\ Report_Installer_InstallLog.log GUI Installation of ITCAM Agent for WebSphere Applications Reports About this task Install ITCAM Agent for WebSphere Applications Reports on an existing installation of Tivoli Common Reporting version or 3.1. To install, complete the following steps: Procedure 1. To begin the installation, run one of the following commands: Windows: setup_windows.exe AIX: setup_aix.bin Linux: setup_linux.bin HP: setup_hpux.bin Solaris: setup_solaris.bin The Tivoli Report Installer opens and the Welcome window is displayed. 2. Click Next. Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 15

24 The Choose the Installation Folder window is displayed. 3. Enter the location to the Tivoli Common Reporting Component directory. Click Next. The Choose the reports for the installation window opens. 4. Select ITCAM Agent for WebSphere Application Reports. 16 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

25 Click Next. The Cognos Engine Configuration window opens. 5. Enter the Tivoli Common Reporting user name and password. Click Next. A window displaying a summary of the selected features is displayed. 6. Select the database type that Tivoli Data Warehouse is running and enter the database name, username, and password. This step is required to create a data source. Tip: Make sure that the name of the database is the name you used to create the connection to the Tivoli Data Warehouse database server. Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 17

26 v v v For a Microsoft SQL Server database, the name is the DSN name if you used a System DSN connection. For a DB2 database, the name is the database alias that you used to catalog the database. For an Oracle databasw, the name is the name specified in tnsnames.ora file. Click Next. The Data Script WebSphere_Agent_DB_Scripts Configuration window opens 7. Enter the database user name and password. 18 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

27 Tip: In this panel, you create a jdbc connection to the Tivoli Data Warehouse databases and execute SQL scripts to create the IBM_TRAM schema and populate tables under the schema. You must provide a user name that has the authority to create the schema in Tivoli Data Warehouse. Use sys as sysdba for an Oracle database. Click Next. The Data Script WebSphere_Agent_DB_Scripts Configuration window opens. 8. Select the JDBC Database Credentials tab. Enter the JDBC details. Click Next. The results of the installation are displayed. 9. Click Done. Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 19

28 Results To verify that the installation was successful: 1. Verify that the installation log file of the Tivoli Report Installer has been created. The following two log files will be available in the /root (UNIX/Linux) or C:\Documents and Settings\Administrator (Windows) folder. v Report_Installer_For_TCR_Output.txt v Report_Installer_InstallLog.log 2. Verify ITCAM Agent for WebSphere Applications Reports in Tivoli Common Reporting. 3. Verify that the Tivoli Data Warehouse data source was created in Tivoli Common Reporting, and ensure you can test the connection successfully. 4. Verify that the TRAM tables, the IBM_TRAM schema, and the indexes of history tables were created successfully. 5. Verify that the TIME_DIMENSION table is populated. Manually Installing ITCAM Agent for WebSphere Applications Reports If there are already reporting packages installed on Tivoli Common Reporting, you have to manually install ITCAM Agent for WebSphere Applications Reports to avoid overwriting data in the TRAM tables. About this task You manually install ITCAM Agent for WebSphere Applications Reports in three stages: v Import the reporting package into the Tivoli Common Reporting v Modify the Tivoli Data Warehouse database to create custom indexes to ensure efficient report performance 20 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

29 v Modify the Tivoli Data Warehouse database to create custom views to ensure efficient report performance Procedure 1. Import the reporting package using one of the following methods: v Using Tivoli Report Installer to import the reporting package v Using the trcmd import command to import the reporting package on page 26 v Using Tivoli Common Reporting Import wizard to import the reporting package on page Create indexes by running the create_table_indexes.sql script located in the ITCAM_for_AD_Report_Installer\reports\cognos_reports\ itcam_ad_cognos_report\db_scripts\db_type directory. where db_type is the database type name: db2, oracle, or mssql The script creates indexes on high-priority detailed tables to improve performance of the reports. 3. Create views by running the create_ad_view_db_type.sql script. The script is located in ITCAM_for_AD_Report_Installer_Home\reports\cognos_reports\ itcam_ad_cognos_report\db_scripts\db_type. For a list of the views created, see Appendix A, Views, on page 39. Using Tivoli Report Installer to import the reporting package Import the reporting package using Tivoli Report Installer if you are performing a manual installation. Procedure 1. Run the following command: Windows: setup_windows.exe AIX: setup_aix.bin Linux: setup_linux.bin HP: setup_hpux.bin Solaris: setup_solaris.bin The Tivoli Report Installer opens. 2. Click Install. Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 21

30 The Welcome window is displayed. 3. Click Next. The Choose the Installation Folder is displayed. 4. Enter the location to the Tivoli Common Reporting Component directory. 22 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

31 Click Next. The Choose the reports for installation window is displayed. 5. Select ITCAM Agent for WebSphere Applications Reports. Click Next. The Cognos Engine Configuration window opens. 6. Clink Install Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 23

32 The Cognos Engine Configuration window opens. 7. Enter the Tivoli Common Reporting user name and password. Click Next. The Cognos Data Source TDW Configuration window opens. 8. Select Skip this panel and click Next. 24 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

33 Click Next. The Data Script WebSphere_Agent_DB_Scripts Configuration window opens. 9. Select Skip this panel. The results of the installation are displayed. 10. Click Done. Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 25

34 Using the trcmd import command to import the reporting package You can use the trcmd import command to import the ITCAM Agent for WebSphere Applications Reports reports package into Tivoli Common Reporting. The trcmd script is located in the tcr_home/bin directory. Procedure Run the following command: trcmd -import -bulk pkgfile -user username -password password where pkgfile is the local path and file name (including.zip extension) of the report package file to be imported. username is the TIP username password is the TIP password trcmd -import -bulk ITCAM_for_AD_Report_Installer/reports/cognos_reports/ itcam_ad_cognos_report/package/itcamforad_v72.zip -user tipadmin -password tippass Example For more information about the trcmd -import command, see the Tivoli Common Reporting Command Reference guide. Using Tivoli Common Reporting Import wizard to import the reporting package You can use the Tivoli Common Reporting import wizard to import the reporting package into Tivoli Common Reporting. 26 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

35 Procedure 1. Copy ITCAMforAD_v72.zip from the ITCAM_for_AD_Report_Installer/reports/ cognos_reports/itcam_ad_cognos_report/package directory to the tcr_home/tipv2components/tcrcomponent/cognos/deployment directory for Tivoli Common Report V2.1.1 or to the tcr_home/reportingcogno/deployment directory for Tivoli Common Report V Log in to Tivoli Common Reporting and select Common Reporting. 3. In the Work with Reports windows, select Administration from the Launch menu. 4. In the Configuration tab, select Content Administration. 5. Click the New Import Wizard icon. 6. Select ITCAMforAD_v72 deployment archive in the table. Run the wizard with the default values. Creating Views When you manually install ITCAM Agent for WebSphere Applications Reports, you must run a script that creates views for some of the detailed tables. This script rectifies a long column name problem. Before you create the views, an appropriate table must exist in the Tivoli Data Warehouse. About this task Procedure 1. Log in to Tivoli Data Warehouse using Tivoli Monitoring user name and password. 2. Run the create_ad_view_db_type.sql script. The script is located in ITCAM_for_AD_Report_Installer_Home\reports\cognos_reports\ itcam_ad_cognos_report\db_scripts. Results The script creates the following views: v Client_Communications_V v Container_Transactions_V v DB_Connection_Pools_V v Durable_Subscriptions_V v Dynamic_Cache_V v Dynamic_Cache_Templates_V v EJB_Containers_V v High_Availability_Manager_V v Portal_Summary_V v Queue_V v Request_Analysis_V v Servlet_Sessions_V v Servlets_JSPs_V v Topic_Spaces_V v WebSphere_XD_Compute_Grid_V v WebSphere_XS_Catalog_V v Workload_Management_Server_V Chapter 3. Installing ITCAM Agent for WebSphere Applications Reports 27

36 Maintenance You need to perform some maintenance tasks if additional historical groups were configured and started. Creating Indexes When you install ITCAM Agent for WebSphere Applications Reports, indexes are created in Tivoli Data Warehouse on historical tables. You might need to recreate indexes, for example, if historical data collection is not enabled when you install ITCAM Agent for WebSphere Applications Reports. To create or recreate indexes, use the create_table_indexes_db_type.sql script. The script is available in the ITCAM_for_AD_Report_Installer_Home\reports\cognos_reports\ itcam_ad_cognos_report\db_scripts directory. The script creates indexes in the following Tivoli Data Warehouse tables: v Application_Health_Status: KYNAPHLTH_IDXITM v Application_Server: KYNAPSRV_IDXITM v Application_Server_Status: KYNAPSST_IDXITM v Container_Transactions: KYNTRANS_IDXITM v Datasources: KYNDATAS_IDXITM v EJB_Containers: KYNCONTNR_IDXITM v Garbage_Collection_Analysis: KYNGCACT_IDXITM v Garbage_Collection_Cycle: KYNGCCYC_IDXITM v J2C_Connection_Pools: KYNJ2C_IDXITM v JMS_Summary: KYNJMSSUM_IDXITM v Request_Analysis: KYNREQUEST_IDXITM v Servlet_Sessions: KYNSERVS_IDXITM v Servlets_JSPs: KYNSERVLT_IDXITM v Thread_Pools: KYNTHRDP_IDXITM 28 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

37 Chapter 4. Creating Reports Predefined Reports You can run predefined reports or create on-demand reports. Predefined reports are available when you install ITCAM Agent for WebSphere Applications Reports. For information about running predefined reports, see Running predefined reports on page 32. The following predefined reports are available: Application Request Performance Description This report analyzes how applications perform at an aggregated level across an application server. The pie-chart shows the aggregate level requests for applications. The bar chart shows the average response time for applications at an aggregate level. The two time series line charts show the average response time and total request count trend for all of the applications. To drill down into the individual requests for an application, click a pie slice or a bar. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type and Application Server Type Tables Used Request_Analysis_*V DB Connection Pools Description This report analyzes database connection pools in an application server. The table shows the key statistics for all the connection pools at an aggregate level. When you select a specific data source, two trend charts show the trend of the key statistics. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Name Tables Used DB_Connection_Pools_*V EJB Performance Description This report analyzes how EJBs deployed in the application server perform. The pie chart shows the aggregate level method count for the EJBs. The bar chart shows the average Method Response Time across EJBs at an Copyright IBM Corp

38 aggregate level. The Two Time series charts show the Method Invocation Count trend and Average Method Response Time trend for all EJBs. The trend lines can be filtered per EJB by clicking a row from the list. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Name Tables Used Enterprise_Java_Beans_*V GC Usage of Application Server Description This report analyzes garbage collection. Use this report to determine if garbage collection is creating problems or if the heap is not sized properly. The first graph shows the average heap percent used and Average Real Time percent garbage collection over time. The second graph shows the average real-time percent garbage collection runs and the average garbage collection rate. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Type Tables Used Garbage_Collection_Analysis_*V JVM Usage for Application Server Description This report analyzes how the JVM of an application server performs. The stacked bar chart shows how the JVM Memory is used and is freed up. The dual line chart shows the JVM CPU consumption vis-a-vis JVM Memory usage. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Type Tables Used Application_Server_*V Request Performance for an Application Description This report analyzes how one application performs in the application server by looking at the underlying performance of its component URIs. The pie chart shows the aggregate level hit count for all the URIs that belong to the application. The bar chart shows the aggregate level response time for the same set of URIs. The Two Time series charts show the Hit Count trend and Average Response Time trend for all URIs. The trend lines can be filtered per URI by clicking a row from the list. 30 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

39 Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Type Tables Used Request_Analysis_*V Servlet-JSP Performance for an Application Description This report analyzes how one web application performs in the web container of the application server by looking at its underlying servlets and JSP performance. The pie chart shows the aggregate level hit count for all the servlet/jsps that belong to the application. The bar chart shows the aggregate level response time for the same set of servlet/jsps. The Two Time series charts show the Hit Count trend and Average Response Time trend for all servlet/jsps. The trend lines can be filtered per servlet or JSP by clicking a row from the list. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Application Server Type Tables Used Servlets_JSPs_*V Threadpools Description This report analyzes thread pools in an application server. The table shows the key statistics for all thread pools at an aggregate level. Once you select a thread pool from the list, the trend chart shows the trending of the key statistics for the selected Thread Pool. If no thread pool is selected, the trends show summary of all the thread pools. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar Required parameters: Summarization Type, Application Server Type Tables Used Thread_Pools_*V Web Application Performance Description This report analyzes how the applications perform in the web container of an application server (PMI Data). The pie charts show the aggregate level requests for the applications. The bar chart shows the average response time for applications at an aggregate level. The two time series line charts show the Average Response time and Total Request count trend for all the applications. Click a pie slice or a bar or a line to drill down into the individual servlet/jsps for that application. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Chapter 4. Creating Reports 31

40 Running predefined reports Required parameters: Summarization Type, Application Server Type Tables Used Thread_Pools_*V Application Request Performance for Clusters Description This report analyzes how servers in a cluster are performing. The first chart shows the number of requests completed by each of the cluster members during the selected time interval. The second chart provides information about the average response time trend for each of the cluster members. There is a separate line in this chart for each server in the cluster. Click a line to drill down into the individual server data. The Application Request Performance report for this server opens Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Cluster Name Tables Used Request_Analysis_*V JVM and GC Usage for Clusters Description This report analyzes JVM and garbage collection usage trends by each of the cluster members. The first chart shows the average real-time percent garbage collection runs. The second chart shows average heap percent used. The last charts show CPU and JVM memory usage. All of these charts show data for each cluster member as a separate line. Parameters Date Range: select one of the predefined reporting periods or select exact start and end times from the calendar. Required parameters: Summarization Type, Cluster Name Tables Used Garbage_Collection_Analysis_*V, Application_server_*V A number of predefined reports are available in ITCAM Agent for WebSphere Applications Reports. About this task To run predefined reports, complete the following steps: Procedure 1. Go to the Tivoli Common Reporting Cognos home page in the Tivoli Integrated Portal. 2. Select the ITCAM Agent for WebSphere Applications Reports. The list of predefined reports is displayed. 3. Click a report name to run that report. To run a report with options, such as changing the report format, click the green arrow icon. For more details on running reports, see the Tivoli Common Reporting information center. 32 ITCAM Agent for WebSphere Applications Reports Installation and User Guide:

41 Creating on-demand and customized reports In addition to running predefined reports, you can also create on-demand and customized reports. ITCAM Agent for WebSphere Applications Reports contains the Cognos data model for ITCAM Agent for WebSphere Applications. Use the Cognos data model to create on-demand and customized reports. Query Studio You can create on-demand reports based on the following categories: v Application v JVM v Portal Server v Process Server v Resources v Thread Pools v WebSphere v WebSphere -XS/XD Each category contains a number of reports, which can be viewed for different time periods, for example, hourly, daily, or weekly. Report Studio Use Report Studio to create customized reports. Report Studio is a web-based report editor. To create a custom report, select Report Studio under the Launch menu. For more details on how to use Query and Report Studio, see the Cognos product manuals. More information can also be found in the Tivoli Common Reporting information center: v3r1/index.jsp?topic=%2fcom.ibm.tivoli.tcr.doc%2ftcr_welcome.html Reports based on multiple tables There are a groups of tables, referred to as dimensions. You can use these dimensions, to create reports that are based on multiple tables. Dimensions are grouped into two separate groups: v v ITCAM for AD Shared Dimensions TRAM Shared Dimensions: Use these tables to create reports based on multiple ITCAM Agent for WebSphere Applications tables. The Tivoli Reporting and Analytics Model (TRAM) tables, are created when you install ITCAM Agent for WebSphere Applications Reports. TRAM Shared Dimension: Use these tables to create reports based on data collected by any Tivoli product. The following table describes the TRAM shared dimensions table: Chapter 4. Creating Reports 33