Page History

...

Values: String

Mandatory: No

web-server-uses-authentication    Is the web server requires client authentication to establish a connection

Values: true\false

Mandatory: No

apptier-name    Name of the Tier for the added instance.

Values: String

Mandatory: No

environment-name    Name of the application for the added instance.

Values: String

Mandatory: Yes, for a federation installation

install-alert-customized    Value: true/false

Mandatory: No

Set to true to in case you want to have customized alerts metrics for this instance.

web-site-name    Site name, sometimes called context root.

Values: String

Mandatory: No

web-use-special-ssl-configuration    The only way to connect to the web server is using a secured connection (SSL).

Values: true\false

Mandatory: No

web-special-ssl-ciphers    Cipher list.

Values: Specify the ciphers to be used Comma separated.

Mandatory: No

web-ssl-use-client-certification    Specifies whether the web server requires the client certificate to have a certificate to establish a connection.

Values: true\false

Mandatory: No

install-network    Indicates whether to correlate the data collected by the Web server filter with the data collected by the Insight Savvy for Network.

Values: true, false

Mandatory: No

Installing Precise for Microsoft .NET with the Precise CLI utility

Installing Microsoft .NET Collectors on a server enables you to sample Microsoft .NET instances on the server. A Microsoft .NET Tier Collector can be installed only on servers running Microsoft .NET instances.

Before installing a Microsoft .NET Tier Collector with the Precise CLI utility, verify the following issues:

•    The Precise Listener on the target server on which the Precise for Microsoft .NET agent is to be installed, was installed.

To install Precise for Microsoft .NET with the Precise CLI utility

1.    Create the Precise for Microsoft .NET parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. For more information, see About the Precise for Microsoft .NET parameter file on page 42.

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_microsoft _.net_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_microsoft_.net_installation_parameters_file_name>

About the Precise for Microsoft .NET parameter file

You need to prepare the Precise for Microsoft .NET 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 Microsoft .NET parameter file. Parameters file example:

<root>

<parameter name="setup-process" value="apptier-DN"/>

<parameter name="collector-server-machine-name" value="serverwin1004"/>

<parameter name="instance-name" value="MyInstance"/>

<parameter name="type" value="web" />

<parameter name="application-name" value="IIS5" />

<parameter name="process-name" value="aspnet_wp.exe" />

<parameter name="installation-cd-path" value="d:\"/>

</root>

Table 2-14    Elements of the Precise for Microsoft .NET 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-DN

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 Microsoft .NET Collector will be installed.

Values: String

Mandatory: Yes

instance-name    The unique alphanumeric string used by Precise for Microsoft .NET and Insight to identify the monitored application instance.

Values: String using English characters.

Mandatory: Yes

type    Indicates the type of the Microsoft .NET instance.

Available types are as follows:

■    web. Select this option when monitoring an ASP.NET application.

■    general. Select this option when monitoring other Microsoft .NET processes.

Mandatory: Yes

application-name    If this instance is an ASP Microsoft .NET instance, the value for this field depends on the Internet Information Server (IIS) type: IIS5, or IIS6.

For a regular Microsoft .NET instance the field should be left empty.

Values: IIS5, IIS6, or empty

Mandatory: Yes, for ASP Microsoft .NET instances. For all other instances, this must remain empty.

process-name*    Indicates the name of the .NET process executable file.

For a regular Microsoft .NET instance, the field should include the path and name of the Microsoft .NET executable file.

For an ASP Microsoft .NET instance, the value for this field depends on the type of Internet Information Server (IIS) as follows:

■    For IIS 5:  aspnet_wp.exe

■    For IIS 6:  w3wp.exe

process-name can only be updated after installation if the instance type is general.

Values: String

Mandatory: Yes

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.

application-pool    Specifies the application pool(s) to be monitored by this instance. Use "*" to specify multiple application pools for monitoring.

Values: String

Mandatory: No

Installing Precise for SQL Server with the Precise CLI utility

Installing SQL Server Tier Collectors on a server enables you to sample SQL Server instances on the server. An SQL Server Tier Collector can be installed on Windows servers running SQL Server instances, or it can be installed on any Windows server and the SQL Server instances can be sampled remotely.

Before installing a SQL Server Tier Collector with the Precise CLI utility, verify the following issues:

•    The Precise for SQL Server FocalPoint was installed.

•    The Precise Listener on the target server on which the SQL Server Tier Collector is to be installed, was installed.

To install Precise for SQL Server with the Precise CLI utility

1.    Create the Precise for SQL Server parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. You can also set up this file in advance. See About the Precise for SQL Server parameter file on page 44.

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

About the Precise for SQL Server parameter file

You need to prepare the Precise for SQL Server parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values in them.

The following is an example of a Sql Server instance parameters file:

<parameters>

<parameter name="installation-cd-path" value="d:\"/>

<parameter name="setup-process" value="apptier-SQ" />

<parameter name="setup-mode" value="install" />

<parameter name="collector-server-machine-name" value="server1" />

<parameter name="instance-name" value="SERVER1" />

<parameter name="sqlserver-authentication" value="sql" />

<parameter name="sqlserver-i3-user" value="sa" />

<parameter name="sqlserver-i3-clear-password" value="" />

</parameters>

The following table describes the updated elements of the parameter file. Field names marked with an asterisk (*) can be updated after installation.

Table 2-15    Elements of the Precise for SQL Server 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-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-se rver    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

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

...