Custom installation

IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Custom installation

Complete the following step for a custom installation of the Managing Server:
Log on to the computer to be the Managing Server as the installation user, for example, amuser. If you have not already created this user, refer to the following section: Create the installation user.
If Terminal Services is enabled on Windows 2003 Server or Windows 2008 Server, put the server into installation mode. Run the following command from a command prompt:
change user /install
Ignore the message:
Install mode does not apply to a Terminal server configured for remote
administration.
Complete one of the following steps to start the installation:

To open a window that invokes the installer, and gives access to prerequisite information, documentation, and support, use LaunchPad:

Access LaunchPad. See Use the LaunchPad interface.
Click the Install ITCAM button.

To directly invoke the installation without using LaunchPad, launch setup_MS.exe from the directory that contains your installation image:

The first window that is displayed is the Select log path window. Enter a location to store log files and click OK:
The Welcome panel for the installation program is displayed.
If the installation program detects your computer does not match the basic prerequisites for starting the installation, a failure window opens instead of the Welcome panel. Refer to the information displayed to correct the situation and restart the installation. For more details on prerequisites, see https://www.ibm.com/developerworks/wikis/display/tivolimonitoring/Prerequisites+for+ITCAM+for+Application+Diagnostics+7.1.0.1
Click Next. The Review License Agreement panel is displayed.
Select I accept both the IBM and the non-IBM terms and click Next.
The CD Install Selection panel is displayed.
Complete one of the following options:

If you are installing from an image located on your hard disk, select No and click Next.
If you are installing directly from a CD, select Yes so that the Managing Server installation image can be copied to a temporary directory on your hard disk - this clears the CD drive for the rest of the installation disks. Either accept the default temporary directory or browse to a different directory. The Managing Server installation image requires at least 1 GB of space. Click Next. The Analyze System for Prerequisites panel is displayed.

This panel shows the process of analyzing your system for prerequisites and existing versions of IBM WAS and IBM DB2. Wait for the installation program to finish its analysis and then click Next.
The Choose Installation Type panel is displayed.
Select Custom and click Next. The Choose Features panel is displayed.

Here is a description of the features you can select in the Choose Features panel:

Managing Server: this option is selected by default, the Managing Server is installed in all circumstances.
Visualization Engine: select this if you are installing the Managing Server on this computer. Clear this if you are running the installer program for creating database tables for an existing database environment on this computer and the Managing Server is being installed on a separate computer.
Database Tables: select this if you are installing IBM DB2 or creating database tables for an existing database environment on this computer. Clear this if you are using an existing remote database.
Select the features you want to install. Click Next. The Choose Destination panel is displayed.

Click Next to accept the default installation directory path in the Directory Name field, or you can change this path by typing or browsing to a different directory and then clicking Next.

You cannot install the Managing Server in a directory path that contains non-English characters, for example:

Traditional Chinese
Simplified Chinese
Japanese
Korean
Spanish special characters
German special characters
Portuguese Brazilian special characters
French special characters
Italian special characters
Cyrillic characters

The directory that you specify must be empty.
If you specify a directory that does not exist, the installation program creates the directory.

After performing the initial installation steps, the Enter TEPS information panel is displayed. Complete the following steps to configure the TEPS information:

To install database tables on the TEPS DB2 database, select Install Database Tables on TEPS DB2 Database.
To install the Visualization Engine (Application Monitor) on the TEPS embedded WAS, select Install Visualization Engine on TEPS eWAS
The Input ITM HOME field is displayed, enter the path for ITM_home.
Click Next. The Enter Database Information panel is displayed.

If you are installing IBM DB2 with the Managing Server to install IBM DB2:

Select Install DB2.
If the installer detects an existing IBM DB2 environment on this computer, you will not have the option to install IBM DB2. To perform an embedded installation of IBM DB2 instead of using an existing database, you need to uninstall it from this computer or choose another computer to install the Managing Server on. You will need to exit the installation.
In the DB2 9.5 Installation Image Location field, click Browse to indicate a location for the installation image.
Browse to select the setup.exe file, which is commonly in the same directory as the db2 subdirectory. The installer will install IBM DB2 at MS_home\DB2.
To specify DB2 user names instead of accepting the defaults, select Show Advanced Options and complete one or more of the following fields:
The installation program automatically creates the users. You cannot use a preexisting user.

Specifying users when installing IBM DB2

Field Description
Database Administrator User ID DB2 Administration Server user: this account has full IBM DB2 privileges. The user ID for the DB2 administration server user is used to run the DB2 administration server on your system.
Database Administrator Password Password for DB2 Administration Server user
Database Instance User ID Database Instance user: the instance owner home directory is where the IBM DB2 instance are created.
Database Instance Password Password for DB2 Instance user
Specify DB2 Installation Location Directory where IBM DB2 is installed. Default C:\Program Files\IBM\itcam\WebSphere\MS\DB2

These are the guidelines for creating user IDs and passwords:

When creating a user ID:

User IDs are limited to 30 characters.
User IDs are not case sensitive.
You cannot use USERS, ADMINS, GUESTS, PUBLIC, LOCAL.
You cannot begin the user name with SQL, SYS, or IBM.
You can use a combination of upper- and lowercase characters. However, they are typically converted to uppercase in IBM DB2.
You can use the numbers 0 through 9.
You can use the following special characters: @, #, or $.

Examples (These are the defaults.):

DB2 Administration Server: dasusr1
DB2 Instance: db2inst1

When creating a password:

The general guidelines are the same as for the user name.
You can use one to eight characters, without spaces.
Do not begin the password with a number or an ampersand (&).
Passwords are case sensitive.

Click Next.
If you are using an existing version of IBM DB2 with the Managing Server to configure an existing IBM DB2 environment:

Select the Use an Existing Database radio button to configure the existing database.
Select the Existing IBM DB2 option in the Database Selection menu.
Local IBM DB2 only: type the name of the user of the IBM DB2 instance in the Database Instance User ID field.
This was determined when the IBM DB2 environment was configured before starting the Managing Server installation. If you do not know this value, consult your database administrator.
Local IBM DB2 only: type the password for the user you entered in the previous step.
This was determined when the IBM DB2 environment was configured before starting the Managing Server installation. If you do not know this value, consult your database administrator.
If your passwords have expired or you need to change the passwords, you need to modify your password in MS_home\bin\setenv.sh and in the IBM WebSphere data source.
In the Database Schema User ID field, enter the user name for the IBM DB2 schema, for example, amuser. This user owns and can create the database tables for ITCAM for Application Diagnostics.
In theDatabase Schema Password field, enter the password for the IBM DB2 schema.
This was determined when the IBM DB2 environment was configured before starting the Managing Server installation. If you do not know this value, consult your database administrator.
If your passwords have expired or you need to change the passwords, you need to modify your password in MS_home\bin\setenv.sh and in the IBM WebSphere data source.
Select the JDBC type to use. From the list, you can choose the following JDBC types:

Type 2 - JDBC type 2
Type 4 - JDBC type 4

Verify the full path to the required JDBC files or browse to and select the db2cc.jar file. For example, the db2cc.jar file might be located in the following path: c:\IBM\SQLLIB\java\db2cc.jar.
If IBM DB2 is installed on a remote computer, one technique you can use is to copy the subdirectory containing the JDBC files (db2cc.jar and db2jcc_license_cu.jar) to the local computer, then browse to and select that directory.
To specify advanced options (such as specifying the location of a remote database), select Show Advanced Options and complete one or more of the following fields:

Advanced options for an existing IBM DB2

Field Description
Database Host Type the fully qualified host name or IP address of the computer on which the existing IBM DB2 environment is installed.
Port Number Type the port number used by the IBM DB2 instance. This is the port number for the instance identified in Step #ch_ins11792048/ch_ins11768189. Do not accept the default port assignment (50000) if you have assigned other applications to use that port number.
You can discover the correct port number to enter by performing the steps in Determine the port number for an existing DB2 instance, or you can consult your database administrator for the correct port to enter.
Database Name Specify the database name. You can use any database name or the default name (octigate).

Click Next.

The installation program overrides the current values for the following parameters in the IBM DB2 server and change them:
update dbm cfg using authentication server;
update dbm cfg using intra_parallel yes;
update dbm cfg using query_heap_sz 2000;
update dbm cfg using SHEAPTHRES 120000;
update dbm cfg using FCM_NUM_RQB 768;
update dbm cfg using MAXAGENTS 300;
The DB2 administrator must take note of this and make adjustments in order to ensure proper data collector configuration. Refer to the MS_home\etc\dbsettings.sql file for details.
To configure an existing Oracle environment:
Select Use an Existing Database.
Select Existing Oracle in the Database Selection field.
In the SID field, enter the Oracle system identifier number (SID)
The SID is used to identify the Oracle environment. To find this value, see the value for the ORACLE_SID environment variable for the operating system.
Local Oracle only: In the DBA User ID field, enter the name of the Oracle database administrator
In the DBA Password field, enter the password for the DBA User ID.
The name of the Oracle database administrator and the password were determined when the Oracle environment was configured before starting the Managing Server installation. If you do not know them, consult your database administrator.
If your passwords have expired or you need to change the passwords, you need to modify your password in MS_home\bin\setenv.sh and in the IBM WebSphere data source.
The DBA User ID and DBA Password fields are only visible if you selected Database Tables in the Choose Features panel.
In the Database Schema User ID field, enter the user name for the Oracle schema, for example, amuser. This user owns and can create the database tables for ITCAM for Application Diagnostics.
In the Database Schema Password field, enter the password for the user you entered in the previous step.
The database schema user id and password were determined when the Oracle environment was configured before starting the Managing Server installation. If you do not know them, consult your database administrator.
If your passwords have expired or you need to change the passwords, you need to modify your password in MS_home\bin\setenv.sh and in the IBM WebSphere data source.
Local Oracle only: verify the full path to the Oracle home directory.
See the Oracle profile for details.
Local Oracle only: In the Oracle SQLPlus User field, enter the name of an existing Oracle SQLPlus user, for example, oracle. This was determined when the Oracle environment was configured before starting the Managing Server installation. If you do not know this value, consult your database administrator.
The Oracle SQLPlus User and Oracle SQLPlus User Password fields are only visible if you selected Database Tables in the Choose Features panel.
Select the JDBC type to use. From the list, you can choose the following JDBC types:

Type 2 - JDBC type 2
Type 4 - JDBC type 4
Verify the full path to the required JDBC files or browse to and select the classes12.jar file.
This is a directory which contains JDBC libraries. Here is an example of a directory:
C:\oracle\product\10g\jdbclib\classes12.jar
If Oracle is installed on a remote computer, one technique you can use is to copy the subdirectory containing the JDBC files (db2cc.jar and db2jcc_license_cu.jar) to the local computer, then browse to and select that directory.
To specify advanced options (such as specifying the location of a remote database), select Show Advanced Options and complete one or more of the following fields:
Advanced options for an Oracle database
Field Description
Database Host
Type the fully qualified host name or IP address of the computer on which the existing Oracle environment is installed. Do not include a protocol in the host name. For example, use
myserver.ibm.tivoli.com
, not
https://myserver.ibm.tivoli.com
Port Number Provide a port number in the Port Number field. Do not accept the default port assignment (1521) if you have assigned other applications to use that port number.
Consult your database administrator for the right port to enter.
Database Name Specify the database name. You can use any database name or the default name (octigate).
Click Next.
After performing the steps to set up your database environment, the Enter WAS Information panel is displayed. If you are installing WAS with the Managing Server, perform the following steps:

Select Install IBM WAS.
Enter the following information to specify your IBM WAS configuration:

Options for installing IBM WAS

Field What to do
User Name
Type the name of the user that will run IBM WAS.
Default the installation user. This user must be a member of the Administrators group. It can be the same as or have the same permissions as the installation user, as described in Create the installation user.
Password Type a user password.
IBM WAS 7.0 Installation Image Location Browse to and select the WAS/install.exe file under the /path/to/install.
Specify IBM WAS installation directory: To change the default, select Show Advanced Options and enter or browse to and select the WAS/install.exe file under the /path/to/install.
You cannot install IBM WAS in a directory path that includes the following types of characters:

Traditional Chinese
Simplified Chinese
Japanese
Korean
Spanish special characters
German special characters
Portuguese Brazilian special characters
French special characters
Italian special characters

User Interface User To change the default, select Show Advanced Options and enter the name that you want for the user for logging in to and using the Application Monitor as the default user.
Default the installation user. If it is different from the installation user, make sure that user has the proper permissions. See Custom installation and upgrade: creating the user interface user.

Click Next.

If you are using an existing WAS:

Ensure that IBM WAS is installed on the Managing Server computer.
Select Use an existing IBM WAS.
The software searches for an installation of IBM WAS. It then displays a list of discovered IBM WAS instances.
Complete the following steps:

Select the IBM WAS instance on which to install the Managing Server.
If the IBM WAS instance on which to install the Managing Server was not detected, you can specify another instance of IBM WAS by completing the following steps:

Select Manually specify an Application Server Node.
In the Application Server Node Installation Directory, browse to select the AppServer_home directory.
Select the instance in the refreshed list of discovered IBM WAS instances.

You cannot choose a IBM WAS instance in a directory path (including profile, cell, node, and server names) that includes the following types of characters:

Traditional Chinese
Simplified Chinese
Japanese
Korean
Spanish special characters
German special characters
Portuguese Brazilian special characters
French special characters
Italian special characters

Click Next.
The Existing WAS Information panel is displayed.
Enter the following information to specify your IBM WAS configuration:

IBM WAS configuration for an existing installation

Field What to do
Host Name Type the fully qualified host name or IP address of the IBM WAS where the Managing Server will run.
If using Network Deployment, provide the host name of the deployment manager instead.
SOAP Connector Port Enter the SOAP port setting (Default 8880). This connector port is used by the IBM WAS to send commands using the SOAP. The SOAP port is identified in the AppServer_home\profiles\profile_name\config\cells\cell_name\nodes\node_name\serverindex.xml file of the instance of IBM WAS that the Managing Server will use.
If using Network Deployment, provide the SOAP port of the deployment manager instead.
User Name Type the name of the user that runs IBM WAS.
This user must be a member of the Administrators group. It can be the same as or have the same permissions as the installation user, as described in Create the installation user.
Password Type a user password.
User Interface User To change the default, select Show Advanced Options and enter the name that you want for the user for logging in to and using the ITCAM for Application Diagnostics Managing Server.
Default the installation user. If it is different from the installation user, make sure that user has the proper permissions. See Custom installation and upgrade: creating the user interface user.

Click Next.
The Select WAS panel is displayed.
Navigate to select the server, and click Next.
After performing the steps to set up your IBM WAS, the Enter Managing Server Information panel is displayed.
Perform the following final installation steps:
Enter the fully qualified host name or IP address of the server where you want to install the Managing Server.
If memory resources on one Managing Server are insufficient to support your environment, for example, if you want to have it connect to many data collectors (such as 500 or more), consider using a split Managing Server implementation. See Split Managing Server installation on Windows for instructions on how to install the Managing Server on two separate computers.
To change the default port numbers used by the Managing Server components, select Show Advanced Options and edit the values. Accept each provided value unless the port number has been used already. Click Next.
The Generate Response File panel is displayed.
To install the Managing Server on this computer, make the selection to install it on this computer.
You might not want to install the Managing Server on this computer if you are performing the installation procedure for the sole purpose of creating a response file for a subsequent silent installation.
If you want to create a response file for a subsequent silent installation, select Save the settings in a response file and enter the file path ending with a file name. For example:
C:\temp\response.opt
A response file is only generated if the GUI installation completes successfully. Click Next.
The Review Installation Information panel is displayed.
Read the summary information and click Install to accept it and begin the installation.
The Install and Configure Files panel is displayed.

The installer will install the Managing Server and (if specified in the previous windows) IBM DB2 or IBM WAS.
Notes:

The progress bar might display as stuck at a certain position for a long time during the installation. This is expected, especially for embedded IBM DB2 and IBM WAS installations. Allow the installation to continue.
Depending on the performance of your computer and operating system, installation might take longer than an hour.
When the installation in complete, the Review Installation Summary panel is displayed.
If the summary panel displays one of the following messages, install database tables manually:

There are problems in the communication between the Managing Server and the database.
Installation of the database tables failed or is incomplete.
In this case, see Manually creating database tables.
Read the information in the panel and click Next. The Finish panel is displayed.
To perform post-installation tasks at this time (recommended), select both Launch the Managing Server and Launch the User Interface.
Click Finish.
Parent topic:
Custom installation for the Managing Server on Windows

+
Search Tips | Advanced Search

Field	Description
Database Administrator User ID	DB2 Administration Server user: this account has full IBM DB2 privileges. The user ID for the DB2 administration server user is used to run the DB2 administration server on your system.
Database Administrator Password	Password for DB2 Administration Server user
Database Instance User ID	Database Instance user: the instance owner home directory is where the IBM DB2 instance are created.
Database Instance Password	Password for DB2 Instance user
Specify DB2 Installation Location	Directory where IBM DB2 is installed. Default C:\Program Files\IBM\itcam\WebSphere\MS\DB2

Field	Description
Database Host	Type the fully qualified host name or IP address of the computer on which the existing IBM DB2 environment is installed.
Port Number	Type the port number used by the IBM DB2 instance. This is the port number for the instance identified in Step #ch_ins11792048/ch_ins11768189. Do not accept the default port assignment (50000) if you have assigned other applications to use that port number. You can discover the correct port number to enter by performing the steps in Determine the port number for an existing DB2 instance, or you can consult your database administrator for the correct port to enter.
Database Name	Specify the database name. You can use any database name or the default name (octigate).

Field	What to do
User Name	Type the name of the user that will run IBM WAS. Default the installation user. This user must be a member of the Administrators group. It can be the same as or have the same permissions as the installation user, as described in Create the installation user.
Password	Type a user password.
IBM WAS 7.0 Installation Image Location	Browse to and select the WAS/install.exe file under the /path/to/install.
Specify IBM WAS installation directory:	To change the default, select Show Advanced Options and enter or browse to and select the WAS/install.exe file under the /path/to/install. You cannot install IBM WAS in a directory path that includes the following types of characters: Traditional Chinese Simplified Chinese Japanese Korean Spanish special characters German special characters Portuguese Brazilian special characters French special characters Italian special characters
User Interface User	To change the default, select Show Advanced Options and enter the name that you want for the user for logging in to and using the Application Monitor as the default user. Default the installation user. If it is different from the installation user, make sure that user has the proper permissions. See Custom installation and upgrade: creating the user interface user.

Field	What to do
Host Name	Type the fully qualified host name or IP address of the IBM WAS where the Managing Server will run. If using Network Deployment, provide the host name of the deployment manager instead.
SOAP Connector Port	Enter the SOAP port setting (Default 8880). This connector port is used by the IBM WAS to send commands using the SOAP. The SOAP port is identified in the AppServer_home\profiles\profile_name\config\cells\cell_name\nodes\node_name\serverindex.xml file of the instance of IBM WAS that the Managing Server will use. If using Network Deployment, provide the SOAP port of the deployment manager instead.
User Name	Type the name of the user that runs IBM WAS. This user must be a member of the Administrators group. It can be the same as or have the same permissions as the installation user, as described in Create the installation user.
Password	Type a user password.
User Interface User	To change the default, select Show Advanced Options and enter the name that you want for the user for logging in to and using the ITCAM for Application Diagnostics Managing Server. Default the installation user. If it is different from the installation user, make sure that user has the proper permissions. See Custom installation and upgrade: creating the user interface user.