Page History
...
The identity of a Sybase Replication Server instance is determined by a concatenation of the instance-server-machine-name tag and the sybase-replication-server-instance-name tag.
The following table describes the updated elements of the parameter file. Field names marked with an asterisk (*) can be updated after installation.
Table 2-18 Elements of the Sybase Replication Server parameter file
Element Description
collector-server-machine-name Name of the server on which the Sybase Replication Server
Collector will be installed.
Values: String
Mandatory: Yes
instance-server-machine-name Name of the server that the Sybase Replication Server instance is installed on.
Values: String
Mandatory: Yes
setup-mode Values: install, edit, uninstall
Mandatory: Yes
setup-process always apptier-RS
Mandatory: Yes
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
sybase-replication-server-instance-name Name of the Sybase Replication Server instance.
Values: String
Mandatory: Yes
sybase-replication-server-port* The number of the port that the Sybase Replication Server instance is listening on.
Values: Integer
Mandatory: Yes
sybase-replication-server-i3-user The name of the user.
Values: String
Mandatory: Yes
sybase-replication-server-i3-encrypted-passwo rd The password for the user name.
Values: Encrypted String.
Mandatory: Yes. For more information, see Encrypt command on page 148. Alternatively the sybase-replication-server-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
sybase-replication-server-sql-ini-path The path to Sybase Replication Server instance sql.ini file
Values: String
Mandatory: Yes
sybase-replication-server-rssd-instance Name of the Sybase Replication Server ASE instance.
Values: String
Mandatory: Yes
sybase-replication-server-rssd-database Name of the Sybase Replication Server ASE database.
Values:String
Mandatory: Yes
sybase-replication-server-rssd-host Name of the Sybase Replication Server ASE host
Values: String
Mandatory: Yes
sybase-replication-server-rssd-port* Port of the Sybase Replication Server ASE
Values: Integer
Mandatory: Yes
sybase-replication-server-rssd-i3-user The name of the Sybase Replication Server ASE user
Values: String
Mandatory: Yes
sybase-replication-server-rssd-encrypted-pass word The password of the user of Sybase Replication Server ASE
Values: Encrypted String.
Mandatory: Yes. For more information, see Encrypt command on page 148. Alternatively the sybase-replication-server-rssd-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
apptier-name Name of the Tier.
Values: String
Mandatory: No
environment-name Name of the application.
Values: String
Mandatory: Yes, for a federation installation
install-alert-customized Values: true/false
Mandatory: No
Set to true to in case you want to have customized alerts metrics for this instance.
os-user Specifies the Windows user that the collector should use.
Values: String
Mandatory: Must be specified if the PMBD uses Windows authentication.
os-domain Specifies the Windows user’s domain that the collector should use.
Values: String
Mandatory: Must be specified if the PMBD uses the Windows authentication.
os-encrypted-password Specifies the Windows password that the Collector should use.
Values: Encrypted String. For more information, see Encrypt command on page 148. Alternatively the os-clear-password parameter can be used, allowing you to specify a clear password instead of an encrypted string.
Mandatory: Must be specified if the PMBD uses Windows authentication.
Installing Precise for DB2 with the Precise CLI utility
Installing DB2 Tier Collectors on a server enables you to monitor DB2 instances on the server. A DB2 Tier Collector should be installed for each DB2 instance on the server that will be monitored. Before installing a DB2 Tier Collector with the Precise CLI utility, verify the following issues:
• The Precise for DB2 FocalPoint was installed.
• The Listener on the target server on which the Precise for DB2 agent is to be installed was installed. To install Precise for DB2 with the Precise CLI utility
1. Create the Precise for DB2 parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. You can also set up this file in advance. For more information, see About the Precise for DB2 parameter file on page 84.
2. Run the following command from the <precise_root> folder on the main Precise FocalPoint to execute the Precise CLI installation script:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <precise_for_db2_installation_parameters_file_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <precise_for_db2_installation_parameters_file_name>
About the Precise for DB2 parameter file
You need to prepare the Precise for DB2 parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
The following is an example of a Precise for DB2 parameters file:
<parameters>
<parameter name="setup-process" value="apptier-UD"/>
<parameter name="setup-mode" value="install"/>
<parameter name="collector-server-machine-name" value="sun3"/>
<parameter name="db2-instance" value="db2inst1" />
<parameter name="db2-database" value="SAMPLE" />
<parameter name="db2-user" value="db2inst1" />
<parameter name="db2-clear-password" value="db2inst1" />
<parameter name="db2-port" value="60000" />
<parameter name="db2-partition" value="0" />
<parameter name="db2-tablespace" value="APM_DB2" />
<parameter name="db2-tablespace-container" value="APM_DB2" />
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The following table describes the elements of the Precise for DB2 parameter file. Element names marked with an asterisk (*) can be updated after installation.
Table 2-19 Elements of the Precise for DB2 parameter file
Element Description
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
setup-process Setup process.
Values: apptier-UD
Mandatory: Yes
setup-mode Setup mode.
Values: install, edit, uninstall
Mandatory: Yes
collector-server-machine-name Name of the server on which the Precise for DB2 Collector will be installed.
Values: String
Mandatory: Yes
environment-name Name of the application.
Values: String
Mandatory: Yes, for a federation installation
db2-instance DB2 instance name.
Values: String
Mandatory: Yes
db2-database DB2 database name.
Values: String
Mandatory: Yes
db2-partition DB2 partition number.
Values: Numeric
Mandatory: Yes
db2-dba-user User name for DB2 user with DBA privileges. Will only be used during installation.
Values: String
Mandatory: Yes
db2-encrypted-password Password for DB2 user with DBA privileges. Will only be used during installation.
Values: Encrypted String
Mandatory: Yes. For more information, see Encrypt command on page 148. Alternatively the db2-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
db2-port* DB2 instance Listener port.
Values: Numeric
Mandatory: Yes
db2-tablespace Storage parameter for the Precise for DB2 schema. Indicates Tablespace name.
Values: String
Mandatory: Yes
db2-tablespace-container Tablespace container.
Values: String
Mandatory: Yes
install-storage Install Precise for Storage for Precise file systems and logical volumes.
Values: true, false
Mandatory: No, default is false.
symmetric-api-path EMC path
Value String
Mandatory:Yes if install storage is true
install-sap-inter-point Indicates whether you want to install sap interpoint
Values: true, false
Mandatory: No
db2-sap-system-name The SAP system name.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
db2-sap-default-application-server The Application server name used to create the first connection with the SAP system.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
db2-sap-system-number The SAP system number.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
db2-sap-user The SAP system user name.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
db2-sap-encrypted-password The SAP system encrypted password.
Values: Encrypted String
Mandatory: Yes, if install-sap-inter-point is true. For more information, see Encrypt command on page 148. Alternatively the db2-sap-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
db2-sap-client-id The client ID used to create the first connection with the SAP system.
Values: String
Mandatory: Yes, if install-sap-inter-point is true.
apptier-name Name of the Tier.
Values: String
Mandatory: No
install-alert-customized Value: true/false
Mandatory: No
Set to true to in case you want to have customized alerts metrics for this instance.
Installing a Tuxedo instance with the Precise CLI utility
Installing Tuxedo Collectors on a server enables you to sample Tuxedo instances on the server. A Tuxedo Tier Collector can be installed only on servers running Tuxedo instances.
Before installing a Tuxedo Tier Collector with the Precise CLI utility, verify the following issues:
• The Insight FocalPoint is installed.
• The Precise Listener on the target server on which the Tuxedo Collector is to be installed, was installed. To install Tuxedo instance with the Precise CLI utility
1. Create the Tuxedo instance parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. You can also set up this file in advance. For more information, see About Tuxedo Collector parameter file on page 84.
2. Run the following command from the <precise_root> folder on the main Precise FocalPoint to execute the Precise CLI utility installation script. Use the Precise user that was created when the Precise server was defined.
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <insight_savvy_for_tuxedo_ installation_parameters_file_name>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action setup
-parametersfile <insight_savvy_for_tuxedo_ installation_parameters_file_name>
About Tuxedo Collector parameter file
You need to prepare the Insight Savvy for Tuxedo parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
The following is an example of a Tuxedo instance parameters file:
<parameters>
<parameter name="setup-process" value="apptier-TU"/>
<parameter name="setup-mode" value="install"/>
<parameter name="apptier-name" value="Tuxedo"/>
<parameter name="environment-name" value="Default"/>
<parameter name="collector-server-machine-name" value="pifa102"/>
<parameter name="tuxedo-domain" value="tux_aix1"/>
<parameter name="instance-name" value="myInstance"/>
<parameter name="tuxedo-directory" value="/Oracle2/Tuxedo/65"/>
<parameter name="tuxedo-config-file" value="/Oracle2/Tuxedo/65/apps/ simapp/tuxconfig"/>
<parameter name="tuxedo-version" value="65"/>
<parameter name="install-network" value="true"/>
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The following table describes the updated elements of the parameter file. Element names marked with an asterisk (*) in this table can be updated after installation.
Table 2-20 Elements of the Tuxedo Collector parameter file
Element Description
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
setup-process Setup process. Always apptier-TU
Mandatory: Yes
setup-mode Setup mode.
Values: install, edit, uninstall
Mandatory: Yes
collector-server-machine-name Name of the server on which the Tuxedo Collector will be installed.
Values: String
Mandatory: Yes
instance-name (component identifier field) Name of the Tuxedo instance that will be installed.
Values: String
Mandatory: Yes
show-historical-data Indicates if historical data from the deleted instance is shown (true) or deleted (false)
Values: true/false
Mandatory: No. This parameter is only relevant when the setup-mode is uninstall.
tuxedo-domain Name of the Tuxedo domain where the Tuxedo Tier will be installed.
Values: String
Mandatory: Yes
tuxedo-directory* The installation home folder for the Tuxedo information system.
Values: String
Mandatory: Yes
tuxedo-config-file* The full binary path of the configuration file for the Tuxedo information system that is planned to be monitored.
Values: String
Mandatory: Yes
tuxedo-version* The BEA Tuxedo version. Precise supports BEA Tuxedo 6.4 to 9.0.
Values: String (XY[_64]). XY are the two digits for the version number. Add "_64" for 64-bits domains. For example: for BEA Tuxedo version 7.1 32-bits use "71"; for 9.0 64-bits use "90_64"
Mandatory: Yes
Precise. Performance intelligence from click to storage. Learn more > >
...