Page History
...
- Precise for Sybase FocalPoint was installed.
- The Precise Listener was installed on the target server on which the Sybase Replication Server Tier Collector is to be installed.
- The Precise Listener and all FocalPoints installed on the target server are running and accessible on the network. To install Precise for Sybase Replication Server with the Precise CLI utility
...
- Create the Precise for Sybase Replication Server parameter file and save it to the
...
- <precise_
...
- root> folder on the main Precise FocalPoint. You can also create this file in advance. For more information, see About the Precise for Sybase Replication Server parameter file on page 86.
...
- With the user that you created when defining the Precise server, run the following command from the
...
- <precise_
...
- root> folder on the main Precise FocalPoint. This executes the Precise CLI utility 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 <name_of_the_sybase_replication_server_parameters_file>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user
...
- _
...
- name>
{-i3-encrypted-password
...
- <encrypted_
...
- password> | -i3-clear-password
...
- <clear_
...
- password>}
-action setup
-parametersfile <name_of_the_sybase_replication_server_parameters_file>
About the Precise for Sybase Replication Server parameter file
When you install Precise for Sybase Replication Server with the Precise CLI utility, you must first create an XML file that contains all relevant installation parameters and their respective values. This file is referenced by the Precise CLI utility installation script during the installation process.
The following is an example of a Precise for Sybase Replication Server parameters file:
<root>
<parameter name="setup-process" value="apptier-RS"/>
<parameter name="sybase-replication-server-instance-name" value="POOLSUN1_1501_REP"/>
<parameter name="instance-server-machine-name" value="poolsun1"/>
<parameter name="collector-server-machine-name" value="pifa100"/>
<parameter name="sybase-replication-server-port" value="5006"/>
<parameter name="sybase-replication-server-i3-user" value="sa"/>
<parameter name="sybase-replication-server-i3-encrypted-password" value="IE"/>
<parameter name="sybase-replication-server-sql-ini-path" value="C:\\sybase\\ini\\sql.ini"/>
<parameter name="sybase-replication-server-rssd-instance" value="I4SQLV65_1502"/>
<parameter name="sybase-replication-server-rssd-database" value="POOLSUN1_1501_REP_RSSD"/>
<parameter name="sybase-replication-server-rssd-host" value="i4sqlv65"/>
<parameter name="sybase-replication-server-rssd-port" value="5001"/>
<parameter name="sybase-replication-server-rssd-i3-user" value="sa"/>
<parameter name="sybase-replication-server-rssd-encrypted-password" value="IE"/>
<parameter name="installation-cd-path" value="d:\"/>
</root>
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 18 Elements of the Sybase Replication Server parameter fileElement Description
| 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- |
...
| password | 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- |
...
| password | 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
- 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
...
- 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.
...
- 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 19 Elements of the Precise for DB2 parameter fileElement Description
| 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
- 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
...
- 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.
...
- 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 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 | |
| install-network* |
...
Associates a Tuxedo activity with network statistics. Values: true, false Mandatory: No | |
| 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. |
Installing a WebSphere MQ instance with the Precise CLI utility
Installing WebSphere MQ Collectors on a server enables you to sample WebSphere MQ instances on the server. A WebSphere MQ Tier Collector can be installed only on servers running WebSphere MQ instances.
Before installing a WebSphere MQ Tier Collector with the Precise CLI utility, verify the following issues:• The
- The Insight FocalPoint is installed.
...
- The Precise Listener on the target server on which the WebSphere MQ Tier Collector is to be installed, was installed.
To install the WebSphere MQ instance with the Precise CLI utility1. Create
- Create the WebSphere MQ 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 WebSphere MQ instance parameter file on page 83.
...
- 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_websphere_mq_ 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_websphere_mq_ installation_parameters_file_name>
About WebSphere MQ instance parameter file
You need to prepare the WebSphere MQ instance parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
...