Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 for SAP FocalPoint was installed.

 

To install Precise for SAP with the Precise CLI utility

1.    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.

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 <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 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 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

1.    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.

2.    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 of the Precise for Sybase 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-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.

Sybase Replication Server Tier Collector can be installed on Windows servers running Sybase Replication Server instances, or it can be installed on any Windows server and sample the Sybase Replication Server instance remotely.

Before installing the Sybase Replication Server Tier Collector with the Precise CLI utility, verify the following issues:

•    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.

2.    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.

 

Precise. Performance intelligence from click to storage. Learn more > >

...