IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Managing Server install configuration options

This section describes the syntax for specifying configuration options in a response file or on the command line and provides a list of the possible configuration options for the Managing Server.

The following table lists the options for installing and configuring a Managing Server on Windows.


Configuration options for the Managing Server on Windows

Feature or entity the option configures Option Description Optional or required?
Installation parameters -V disableOSPrereqChecking=true | false Indicates whether the operating-system-level checking is turned on before the installation. Specifying true means the program will ignore the results of the operating-system-level checking. Specifying false means that the operating-system-level checking is turned on before the installation and the program will exit if the operating system on the target computer has not met the minimum requirements for the installation. Required
  -V LICENSE_ACCEPT_BUTTON=true | false Specify true. Required
  -V LICENSE_REJECT_BUTTON=true | false Specify false. Required
  -V LOG_DIR=value This specifies the writable directory to which the installation program will write log files. This is useful if the default directory of
C:\IBM\tivoli 
\common\CYN\logs
is not writable on your systems. If you set this new option, the installation program will use it as real log path even if the default log path is writable.
Required if C:\IBM\tivoli\common\CYN\logs is not writable.
  -V IS_SELECTED_INSTALLATION_TYPE =typical | custom Specifies the type of installation. Required
  -P installLocation=value Path of the installation directory for the installation. If you do not specify this option, the installation program uses the default directory path:
C:\IBM\itcam 
\WebSphere\MS

  1. You cannot install the Managing Server 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

  2. The directory that you specify must be empty.

  3. If you specify a directory that does not exist, the installation program creates the directory.

Optional
  -P msFilesInstall.active=true | false Specifies whether to install the Managing Server files. Indicate true or false. Indicate true if you are installing the Managing Server on this computer. Indicate false if you are running the installer program for the purpose of creating database tables for an existing database environment on this computer and the Managing Server is being installed on a separate computer. Required if -V IS_SELECTED_ INSTALLATION_ TYPE=custom
  -P veInstall.active=true | false Specifies whether to install the ITCAM for Application Diagnostics Managing Server with the installation. Indicate true or false. Indicate true if you are installing the Managing Server on this computer. Indicate false if you are running the installer program for the purpose of creating database tables for an existing database environment on this computer and the Managing Server is being installed on a separate computer. Required if -V IS_SELECTED _INSTALLATION_ TYPE=custom
  -P dbInstall.active=true | false

Specifies whether to install database tables with the installation. Indicate true or false. Indicate true if you are installing IBM DB2 or creating database tables for an existing database environment on this computer. Indicate false if you are running the installer program for the purpose of installing the Managing Server on this computer and you are creating database tables for an existing database environment on a separate computer.

Indicate false if you are upgrading the Managing Server. If you indicate true, the data in the existing database tables will be deleted.

Required if -V IS_SELECTED_ INSTALLATION_ TYPE=custom
  -V LAUNCH_MS=true | false Specifies whether to start the Managing Server after the installation. Required
  -P mswinsrv.active=true | false Use this parameter to indicate you don't want to create a Windows Service for the Managing Server during installation. The default value is true. Optional
Message generation -W LogSetting.logLevel=value See Options for monitoring installation messages. Optional
  -W LogSetting.consoleOut=true | false See Options for monitoring installation messages. Required
Managing Server settings -V ITCAM_SYS_USERS=value

  • Typical installation: specifies the user used to log into the ITCAM for Application Diagnostics Managing Server and the IBM WAS administrative console.
  • Custom installation: specifies the user used to log into the ITCAM for Application Diagnostics Managing Server. Default the installation user.

Required if -V IS_SELECTED_ INSTALLATION_ TYPE=typical
  -V KERNEL_HOST01=value Specifies the fully qualified host name of the Managing Server. Required
  -V PORT_ARCHIVE_AGENT1=value Port that the Managing Server will use to connect to Archive Agent 1. Default 9129. Optional
  -V PORT_ARCHIVE_AGENT2=value Port that the Managing Server will use to connect to Archive Agent 2. Default 9130. Optional
  -V PORT_KERNEL_CODEBASE01=value Port that the Managing Server will use to connect to Kernel Codebase 1. Default 9122. Optional
  -V PORT_KERNEL_RFS01=value Port that the Managing Server will use to connect to Kernel Remote File Sharing (RFS) 1. The default is 9120. Optional
  -V PORT_KERNEL_RMI01=value Port that the Managing Server will use to connect to Kernel Remote Method Invocation (RMI) 1. The default is 9118. Optional
  -V PORT_MESSAGE_DISPATCHER=value Port that the Managing Server will use to connect to the Message Dispatcher. Default 9106. Optional
  -V PORT_PA=value Port that the Managing Server will use to connect to the Polling Agent. Default 9111. Optional
  -V PORT_PS=value Port that the Managing Server will use to connect to Publish Server 1. Default 9103. Optional
  -V TEPS_BASED_INSTALL = true | false Specifies whether you are installing the MS based on ITM TEPS. Note: Managing Server Visualization Engine could be installed on ITM TEPS embeded WAS(eWAS). This is not recommended for production use. Required
  -V ITM_HOME = value Specifies the ITM home directory if you choose to install MS based on ITM TEPS. required if -V TEPS_BASED_ INSTALL=true
  -V PORT_SAM=value Port that the Managing Server will use to connect to Structured Application Monitor 1. Default 9126. Optional
IBM WAS settings -V PRE_WAS_EXISTING=true | false Specifies whether you have a version of IBM WAS installed on your computer. Optional
  -V NEW_WAS=true | false Specifies whether you are installing a new version of IBM WAS instead of using an existing version of IBM WAS for the Managing Server installation. Required
  -V EXISTING_WAS=true | false Specifies whether you are using an existing version of IBM WAS for the Managing Server installation. Required
  -V WAS_CDROMDIR=value Path of the installation image location for IBM WAS 7.0. Required if -V NEW_WAS=true
  -V WAS_ADMIN_CONSOLE_PORT=value When you perform the installation of IBM WAS that comes with ITCAM for Application Diagnostics, you use this to specify the port used by the IBM WAS administrative console. Default 9060. Do not use the default if port 9060 is assigned to another service. Optional
  -V WAS_HOSTNAME=value Specifies the fully qualified host name or IP address of the computer where IBM WAS 7.0 is installed. Required if -V EXISTING_WAS=true
  -V WAS_BASEDIR=value Path of the installation directory for IBM WAS 7.0 or the directory path of the profile of an existing version of IBM WAS. For example,
C:\IBM\itcam
\WebSphere\MS\WAS61
\AppServer1

You cannot install or 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

Optional
  -V WAS_PROFILEHOME=value Path to the profile for the instance of IBM WAS being used by the Managing Server. For example,
"C:\IBM\itcam
\WebSphere\MS\WAS61\Base
\profiles\default"
Required if -V IS_SELECTED_ INSTALLATION_ TYPE=custom
  -V WAS_PROFILENAME=value Specifies the name of the profile for the instance of IBM WAS being used by the Managing Server. For example, default. Required if -V EXISTING_WAS=true
  -V WAS_CELL=value When you are using an existing installation of IBM WAS software, you use this flag to specify the name of a cell in a IBM WAS distributed network. A cell is a configuration concept that enables IBM WAS administrators to logically associate nodes with each another. You can use any of the existing cell names that are defined in the cell directory. For example, hostCell01. Required if -V EXISTING_WAS=true
  -V WAS_NODE=value When you are using an existing installation of IBM WAS software, you use this flag to specify the name of a computer that runs an application server and an administrative server. Normally, the default node name includes the short host name. For example, on a computer named IBMMACHINE, the node name could be IBMMACHINENode01. Required if -V EXISTING_WAS=true
  -V WAS_SERVER=value When you are using an existing installation of IBM WAS software, you use this flag to specify the name of the IBM WAS where the Managing Server runs. In a simple installation this server might be named server1. Required if -V EXISTING_WAS=true
  -V WAS_USER=value Specifies the name of the user that will run IBM WAS. For an existing IBM WAS, if WAS global security is enabled, the user you specify must have the WebSphere Administrator Role; if WAS global security is not enabled, the user you specify must have membership in the Administrators group. This user must not be an LDAP user. Required
  -V WAS_USER_PWD=value Password of the user that will run IBM WAS. Required
  -V WAS_SOAP_PORT==value Specifies the connector port that the IBM WAS will use to send commands using the SOAP. Default 8880. Required
General database settings -V PRE_DB2_EXISTING=true | false Specifies whether you have a version of IBM DB2 installed on your computer. Required
  -V NEW_DB=true | false Specifies whether you are installing a new version of IBM DB2 instead of using an existing database for the Managing Server installation. Required
  -V EXISTING_DB=true | false Specifies whether you are using an existing database for the Managing Server installation. Required
  -V EXISTING_DB2_LOCAL=true | false Specifies whether the existing version of IBM DB2 you are using for the Managing Server installation is installed on the local computer. Required if -V EXISTING_DB=true
  -V EXISTING_DB2_REMOTE=true | false Specifies whether the existing version of IBM DB2 you are using for the Managing Server installation is installed on a remote computer. Required if -V EXISTING_DB=true
  -V EXISTING_ORACLE_LOCAL=true | false Specifies whether the existing version of Oracle you are using for the Managing Server installation is installed on the local computer. Required if -V EXISTING_DB=true
  -V DB2_INSTALL_LOCATION=value Specifies the full path to where you want IBM DB2 installed. Default
C:\IBM\itcam\
WebSphere\MS\DB2
Optional
  -V DB2_DAS_USER=value Specifies the name of the DB2 Administration Server user account. Optional
  -V EXISTING_ORACLE_REMOTE=true | false Specifies whether the existing version of Oracle you are using for the Managing Server installation is installed on a remote computer. Required if -V EXISTING_DB=true
IBM DB2 settings -V DB2_IMAGE_LOCATION=value Path of the installation image location for IBM DB2 9.5. Required if -V EXISTING_DB=true
  -V DB2_DAS_PASSWORD=value Password of the IBM DB2 Administration Server user account.

The password created for this user during a Typical installation is itcam610.

Required if -V NEW_DB=true
  -V DB2_CREATE_DAS_USER=true | false If the DB2 Administration Server user does not exist on the target computer, specify true; otherwise, specify false. Required if you are installing or using an IBM DB2 database
  -V DB2_INST_NAME=value Specifies the name of the IBM DB2 instance. Optional
  -V DB2_INST_USER=value Specifies the name of the IBM DB2 Instance user. Required if you are using an existing IBM DB2 database
  -V DB2_INST_PASSWORD=value Password of the IBM DB2 Instance user.

The password created for this user during a Typical installation is itcam610.

Required if a value was entered for -V DB2_INST_USER
  -V DB2_CREATE_INST_USER=true | false If the IBM DB2 Instance user does not exist on the target computer, specify true; otherwise, specify false. Required if you are installing or using an IBM DB2 database
  -V DB2_JDBC=value Specifies the full path to the required JDBC files for IBM DB2. This must be a directory containing DB2 jdbc driver files, such as db2jcc.jar. Required if you are using an existing IBM DB2 database
  -V DB2_SERVER=value Specifies the fully qualified host name of the IBM DB2 server. Required if you are using an existing IBM DB2 database
  -V DB2_INST_PORTNUMBER=value Port used by IBM DB2. The default port is 50000 for IBM DB2. Optional
  -V DB2_SCHEMA_USER=value Specifies the Schema user name. This user will own and can create the database tables for ITCAM for Application Diagnostics. Required if you are using an existing IBM DB2 database
  -V DB2_SCHEMA_PASSWORD=value Password of the Schema user that you specify.

The password created for this user during a Typical installation is itcam610.

Required if a value was entered for -V DB2_SCHEMA_ USER
  -V DB2_CREATE_SCHEMA_USER=true | false If the DB2 Schema user does not exist on the target computer, specify true; otherwise, specify false. Required if you are using an existing IBM DB2 database
Oracle settings -V ORACLE_SID=value Specifies the Oracle system identifier number. This is a unique identifier of the Oracle database instance, defined during the Oracle installation. The oracle user needs to have bash as system shell. Required if you are using an Oracle database
  -V ORACLE_SERVER=value Specifies the fully qualified host name or the IP address of the host computer for the Oracle environment which contains table space for the management repository. For example, servername.it.company.com shows typical syntax for a fully qualified host name. Required if you are using an Oracle database
  -V ORACLE_SCHEMA_USER=value Specifies the Schema user name. This user will own and can create the database tables for ITCAM for Application Diagnostics. Required if you are using an Oracle database
  -V ORACLE_SCHEMA_PASSWORD=value Password for the Schema user in the Oracle environment. Required if you are using an Oracle database
  -V ORACLE_PORTNUMBER=value Port number for the Oracle database. The default port is 1521. Optional
  -V ORACLE_DBA_USER=value Specifies the user name of the Oracle database administrator. Required if you are using an existing local Oracle database
  -V ORACLE_DBA_PASSWORD=value Password of the Oracle database administrator. Required if a value was entered for -V ORACLE_DBA_ USER
  -V ORACLE_JDBC=value Specifies the full path to the required JDBC files for Oracle. This must be a directory containing Oracle jdbc driver files, such as ojdbc14.jar or classes12.jar. Required if you are using an Oracle database
  -V ORACLE_HOME=value Specifies the full path to the Oracle home directory. Required if you are using an existing local Oracle database
  -V ORACLE_SQLPLUS_USER=value Specifies the user name of an existing Oracle SQLPlus user. This user must have privileges to create tables in Oracle. Required if you are using an existing local Oracle database


Parent topic:

Performing a normal silent installation (in one phase)

+

Search Tips   |   Advanced Search