Page History
...
| 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-SQ Mandatory: Yes |
setup-mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
| instance-name | SQL Server instance name. (Must always be uppercase). Values: String Mandatory: Yes |
| collector-server-machine-name | Name of the server on which the Precise for SQL Server Collector will be installed. Values: String Mandatory: Yes |
| os-user | Specifies the Windows user that the SQL Server Collector should use. Values: String Mandatory: Only if the instance does not reside on the same server as the collector, or when the PMDB uses Windows authentication. |
| os-domain | Specifies the Windows user’s domain that the SQL Server Collector should use. Values: String Mandatory: Only if the instance does not reside on the same server as the collector, or when the PMDB uses Windows authentication. |
| os-encrypted-password | Specifies the Windows password that the SQL Server Collector should use. Values: Encrypted String. For more information, see Encrypt command on page 148. Mandatory: Only if the instance does not reside on the same server as the collector, or when the PMDB uses Windows authentication. Alternatively the os-clear-password parameter can be used, allowing you to specify a clear password instead of an encrypted string. |
| sqlserver-authentication* | Specifies how the Collector will connect to the SQL Server instance. (Windows authentication/SQL authentication). Values: sql, nt Mandatory: Yes |
| sqlserver-i3-user* | User name. Values: String Mandatory: Only mandatory if authentication is ‘sql’. |
| sqlserver-i3-encrypted-password* | Password for SQL Server. Values: Encrypted String. Mandatory: Only mandatory if authentication is ‘sql’. For more information, see Encrypt command on page 148. Alternatively the sqlserver-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. |
| install-storage-type* |
...
Install Precise for Storage. Values: empty - for no Precise for Storage SQWIN - for Windows storage Mandatory: No | |
| install-psoft-extension* |
...
Installs the PeopleSoft extension. Values: true, false Mandatory: No | |
| sqlserver-sap-system- |
...
| name | The SAP system name. Values: String Mandatory: Yes, if install-sap-inter-point is true. |
| sqlserver-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. You can only specify one default-app-server and app-rout-string. |
| sqlserver-sap-system- |
...
| number | The SAP system number. Values: String Mandatory: Yes, if install-sap-inter-point is true. |
| sqlserver-sap- |
...
| user | The SAP system user name. Values: String Mandatory: Yes, if install-sap-inter-point is true. |
| sqlserver-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 sqlserver-sap-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. |
| sqlserver-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. |
| install-sap-inter- |
...
| point | Indicates whether you want to install SAP Interpoint 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 |
| 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. |
| 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 Precise for SAP with the Precise CLI utility
Installing SAP Collectors on a server enables you to sample a remote SAP system.
Before installing the SAP Tier Collector with the Precise CLI utility, verify the following issue:• Precise
- Precise for SAP FocalPoint was installed.
To install Precise for SAP with the Precise CLI utility1. Create
- Create the Precise for SAP 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 Precise for SAP parameter file on page 82.
...
- 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 <precise_for_sap_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_sap_installation_parameters_file_name>
About Precise for SAP parameter file
You need to prepare the Precise for SAP parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
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.
Example:
<parameters>
<parameter name="setup-process" value="apptier-SP"/>
<parameter name="setup-mode" value="install"/>
<parameter name="instance-name" value="H47_TEST2" />
<parameter name="sap-system" value="H47" />
<parameter name="default-app-server" value="poolhp3" />
<parameter name="app-server-exist" value="true" />
<parameter name="app-rout-string-exist" value="false" />
<parameter name="app-rout-string" value="" />
<parameter name="db-system-number" value="00" />
<parameter name="sap-user" value="adm" />
<parameter name="sap-clear-password" value="precise" />
<parameter name="client-id" value="000" />
<parameter name="environment-name" value="Default" />
<parameter name="app-servers" value="host=poolhp3;routing-str=;port=00;name=poolhp3_H47_00" />
<parameter name="clients" value="lang=E;number=000||lang=E;number=001||lang=E;number=066||lang=E;number=100" />
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
Table 2-16 Elements 16 Elements of the Precise for SAP 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-SP Mandatory: Yes |
| setup- |
...
| mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
| instance- |
...
| name | The unique name for the instance. This unique name helps to distinguish between several instances. Values: String Mandatory: Yes |
| sap- |
...
| clients | The SAP clients numbers and language that the SAP Collector should monitor. Use two pipelines "||" as a separator between the clients names. lang=E;number=000||lang=E;number=001||lang=E;number=066||lang=E;number=100 Value: String Mandatory: No If not specified, all clients detected will be monitored. |
| sap- |
...
| system | The SAP system name. Values: String Mandatory: Yes |
| default-app-server* |
...
The Application server name used to create the first connection with the SAP system. Values: String Mandatory: Yes, if app-rout-string is not provided. | |
| app-rout-string* |
...
The Application server route string used to create the first connection with the SAP system. Values: String Mandatory: Yes, if default-app-server is not provided. | |
| sap-connection- |
...
| type | The connection type to use when connecting to SAP Values: String (CustomApplicationServer/LogonGroup) Mandatory: No Default value: CustomApplicationServer |
| sap-logon- |
...
| group | Group/Server to use when connecting to SAP Values : String Mandatory: Yes, if sap-connection-type is LogonGroup |
| db-system-number* |
...
The SAP system number. Values: String Mandatory: Yes | |
| sap-user* |
...
The SAP system user name. Values: String Mandatory: Yes | |
| sap-encrypted-password* |
...
The SAP system encrypted password. Values: Encrypted String Mandatory: Yes. For more information, see Encrypt command on page 148. Alternatively the sap-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. | |
| client-id* |
...
The client ID used to create the first connection with the SAP system. Values: String Mandatory: Yes | |
| app-servers* |
...
The Application servers that the SAP Collectors should monitor. Use two pipelines "||" as a separator between the Application server names. Format: name=application-server-name;host=host-name; routing-str=routing-string;port=port-number Values: String Mandatory: No If not specified, all application servers detected will be monitored. | |
| apptier- |
...
| name | Name of the Tier. Values: String Mandatory: No |
| environment- |
...
| name | Name of an existing application. Values: String Mandatory: Yes |
Installing Precise for Sybase with the Precise CLI utility
Installing the Sybase Tier Collector on a server enables you to sample a Sybase instance on the server. A Sybase Tier Collector can be installed on Windows servers running Sybase instances, or it can be installed on any Windows server and sample the Sybase instance remotely.
Before installing the Sybase Tier Collector with the Precise CLI utility, verify the following issues:• Precise
- Precise for Sybase FocalPoint was installed.
...
- The Precise Listener was installed on the target server on which the Sybase 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 with the Precise CLI utility
...
- Create the Precise for Sybase parameter file and save it to the
...
- <precise_
...
- root> folder on the main Precise FocalPoint. You can also create this file in advance. See About the Precise for Sybase parameter file on page 84.
...
- 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 <precise_for_sybase_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_sybase_installation_parameters_file_name>
About the Precise for Sybase parameter file
When you install Precise for Sybase 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 an Precise for Sybase parameters file:
<parameters>
<parameter name="setup-process" value="apptier-SY"/>
<parameter name="setup-mode" value="install"/>
<parameter name="apptier-name" value="Sybase"/>
<parameter name="environment-name" value="Default"/>
<parameter name="collector-server-machine-name" value="pifa102"/>
<parameter name="instance-server-machine-name" value="sun12"/>
<parameter name="sybase-instance-name" value="sun12_12_0"/>
<parameter name="sybase-port" value="5100"/>
<parameter name="sybase-i3-user" value="sa"/>
<parameter name="sybase-i3-encrypted-password" value="IE"/>
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The identity of a Sybase instance is determined by a concatenation of the instance-server-machine-name tag and the sybase-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-17 Elements 17 Elements of the Precise for Sybase 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. always apptier-SY Mandatory: Yes |
| setup- |
...
| mode | Setup mode. Values: install, edit, uninstall Mandatory: Yes |
| instance-server-machine- |
...
| name | Name of the server that the Sybase instance is installed on. Values: String Mandatory: Yes |
| sybase-instance- |
...
| name | Name of the Sybase instance. Values: String Mandatory: Yes |
| collector-server-machine- |
...
| name | Name of the server on which the Precise for Sybase Collector will be installed. Values: String Mandatory: Yes |
| sybase-port* |
...
The number of the port that the Sybase instance is listening on. Values: Integer Mandatory: Yes | |
| sybase-i3- |
...
| user | The name of the user. Values: String Mandatory: Yes |
| sybase-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-i3-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. |
Installing Precise for Sybase Replication Server with the Precise CLI utility
Installing the Sybase Replication Server Tier Collector on a server, enables you to sample a Sybase Replication Server instance on the server.
...
Before installing the Sybase Replication Server Tier Collector with the Precise CLI utility, verify the following issues:• Precise
- 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
1. 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.
...
Windows | i nf r a\bin\ p sin_cli.bat |
UNIX | ./in f ra/bin/ p sin _ cli.sh |
Values: true/false
Mandatory: No
Set to true to in case you want to have customized alerts metrics for this instance.