Versions Compared

Key

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

...

Table of Contents
maxLevel2

InstallingthePreciseFramework

Anchor
InstallingthePreciseFramework
InstallingthePreciseFramework
Installing the Precise Framework

...

  • Installing Precise for Oracle with the Precise CLI utility
  • Installing Precise for Storage with the Precise CLI utility
  • Installing Precise for J2EE with the Precise CLI utility
  • Installing Precise for Web with the Precise CLI utility
  • Installing Precise for Microsoft .NET with the Precise CLI utility
  • Installing Precise for SQL Server with the Precise CLI utility
  • Installing Precise for SAP with the Precise CLI utility
  • Installing Precise for Sybase with the Precise CLI utility
  • Installing Precise for Sybase Replication Server with the Precise CLI utility
  • Installing Precise for DB2 with the Precise CLI utility
  • Installing a Tuxedo instance with the Precise CLI utilityInstalling a WebSphere MQ instance with the Precise CLI utility
  • Installing an Oracle Applications instance with the Precise CLI utility
  • Installing Other Tier Collectors with the Precise CLI utility
  • Installing an OS instance with the Precise CLI utilityInstalling an extension for Siebel with the Precise CLI utility
  • Installing Precise for vCenter Server with the Precise CLI utility

...

ElementDescription
installation-cd-path

Indicates the absolute path to the folder where the Precise download was downloaded to.

Values: String

Mandatory: Yes

setup-process

Setup process. always apptier-OR

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

Values: String

Mandatory: Yes

environment-name

Name of the application.

Values: String

Mandatory: Yes, for a federation installation

instance-name

Oracle instance name (SID).

Values: String

Mandatory: Yes

oracle-home*

Full path of Oracle home.

Values: String

Mandatory: Yes

oracle-version

Oracle instance version

Values: 81100, 90110, 100120, 110180

The values represent the following versions:

81 100 = Version 8.110
90 110 = Version 9.011
100 120 = Version 1012
110 180 = Version 1118

Mandatory: Yes

oracle-port*

Oracle instance Listener port.

Values: Numeric

Mandatory: Yes

oracle-dba-user

User name for Oracle user with DBA privileges. Will only be used during installation.

Values: String

Mandatory: Yes

oracle-dba-encrypted-password

Password for Oracle user with DBA privileges. Will only be used during installation.

Values: Encrypted String

Mandatory: Yes

Alternatively the oracle-dba-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. See Encrypt command.

oracle-connect-as

Connection option for Oracle user with DBA privileges. When using a manual schema, this must be specified as Normal.

Values: SYSDBA, Normal

Mandatory: Yes

network-ports

Oracle listener ports. Specify all the ports you want the Insight Savvy for Network to sample. At least one port must be specified.

Values: port=x||port=y (for example: port=1111||port=2222)

Mandatory: Yes if Install-network is ‘true’.

oracle-create-new-user

Indicates whether the oracle-i3-user is an existing user or the installation should create a new user.

Values: (true/false)

Mandatory: Yes

Info

If an Oracle DB schema has been installed manually before the current collector installation, then this parameter should appear explicitly in the parameters file and its value must be "false".

oracle-i3-user

User name of the Oracle user who owns the Precise for Oracle schema.

Values: String

Mandatory: Yes

oracle-i3-encrypted-password

Password of the Oracle user who owns the Precise for Oracle schema.

Values: Encrypted String

See Encrypt command on page 148.

Mandatory: Yes

Alternatively the oracle-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.

oracle-sap-system-name

The SAP system name.

Values: String

Mandatory: Yes, if install-sap-inter-point is true.

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

oracle-sap-system-number

The SAP system number.

Values: String

Mandatory: Yes, if install-sap-inter-point is true.

oracle-sap-user

The SAP system user name.

Values: String

Mandatory: Yes, if install-sap-inter-point is true.

oracle-sap-encrypted-password

The SAP system encrypted password.

Values: Encrypted String

Mandatory: Yes, if install-sap-inter-point is true.

See Encrypt command.

Alternatively the sap-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.

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

oracle-tablespace-name

Storage parameter for the Precise for Oracle schema. Indicates Tablespace name.

Values: String

Mandatory: No

oracle-tablespace-file

Storage parameter for the Precise for Oracle schema. Indicates Tablespace datafile.

Values: String

Mandatory: No

oracle-tablespace-temp-name

Storage parameter for the Precise for Oracle schema. Indicates Temporary tablespace name.

Values: String

Mandatory: No

oracle-tablespace-temp-file

Storage parameter for the Precise for Oracle schema. Indicates Temporary tablespace file.

Values: String

Mandatory: No

install-psoft-extension*

Installs the PeopleSoft extension

Values: true, false

Mandatory: No

install-sap-inter-point

Indicates whether you want to install a SAP Interpoint.

Values: true, false

Mandatory: No

oracle-history-size*

Oracle session information period (in hours).

Values: 1, 2, 4, 8, 12, 24, 28

Mandatory: No

oracle-collapse-statements*

Collapses statements with different constants in their text into single statements with bind variables.

Values: true, false

Mandatory: No

install-storage-type*

Install Precise for Storage.

Values: empty - for no Precise for Storage ORXP - for HP crosspoint storage

Mandatory: No

oracle-tablespaces-folder

Storage parameter for the Precise for Oracle schema. Indicates the folder in which datafiles are stored.

Values: String

Mandatory: No

install-network*

Associates Oracle activity with network statistics.

Values: true, false

Mandatory: No

oracle-cluster-name

Oracle instance cluster name

Values: string

Mandatory: No

oracle-connection-pool-server

Server name used in the connection pool for the Oracle instance. In case this parameter is not supplied, the collector-server-machine-name is used.

The Precise Oracle FocalPoint creates JDBC connections to the Oracle instance. Use this parameter in case you want the Oracle FocalPoint to connect to the instance using a server name different than the server name specified in collector-server-machine-name parameter.

Value: String

Mandatory: No

...

ElementDescription
installation-cd-path

Indicates the absolute path to the folder where the Precise download was downloaded to.

Values: String

Mandatory: Yes

setup-process

Setup process. always apptier-WW

Mandatory: Yes

setup-mode

Setup Mode

Values: install, edit, uninstall

Mandatory: Yes

collector-server-machine-name

Name of the server of the Collector.

Values: String

Mandatory: Yes

instance-name

The unique name of the Web server instance as identified on the Web server. This unique name helps to distinguish between several instances.

Values: String

Mandatory: No. This parameter is only relevant when the setup-mode is uninstall.

instance-identifier

Used to create the instance name.

Values: String

Mandatory: Yes

is-cluster

Indicates that this instance is part of a cluster.

Values: (true/false). Can only be set to true for WebLogic and WebSphere.

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.

web-type

Indicates type of server where the Web server instance is running.

Values: IIS, Apache, iPlanet, WebLogic, WebSphere, Tomcat, Sun ONE, SAP WAS J2EE, Oracle AS, Other J2EE, Other.

Mandatory: Yes

web-configuration-file

The full path for a Web server configuration file.

Values: String

Mandatory: Yes for Web Servers - Apache, iPlanet, WebLogic, Sun ONE, WebSphere, Tomcat, Oracle AS.

Mandatory: Web Servers - IIS, Other, Other J2EE, SAP WAS J2EE should all be specified as empty parameter.

web-apache-configuration-file

The full path for an Apache HTTP Web server configuration file.

Values: String

Mandatory: Yes, only for Oracle AS servers.

web-server-version

The Web server version.

Values: String

For IIS: Mandatory: Yes Versions: 5.x, 6.x

For Other, Other J2EE, SAP WAS J2EE. Mandatory: No

For Apache: Mandatory: Yes. Versions: 1.3.x, 2.0.x, 2.2.x

For WebLogic: Mandatory: Yes. Versions: 8.x, 9.x, 10.x

For WebSphere: Mandatory: Yes. Versions: 6.0, 6.1-6.x, 7.x

For Tomcat: Mandatory: Yes. Versions: 5.x, 6.x

For iPlanet: Mandatory: Yes Version: 6.x

For Sun ONE: Mandatory: Yes Version: 6.1

For Oracle AS: Mandatory: Yes. Version: "9.0.4.0.1 - 10.1.3" (Notice the additional spaces)

web-real-name

The IIS Web site name.

Values: String

Mandatory: Yes, only for IIS servers.

web-iis-instance-number

The IIS Web site number.

Values: String

Mandatory: Yes, only for IIS servers.

web-application-used

The application served by this Web server site.

Values: Web Siebel PeopleSoft

Mandatory: Yes

web-application-used-version

The application version served by this Web server site.

Values: String

For PeopleSoft:

Mandatory: Yes

Values:

  • If the monitored web server is WebSphere: "8.1 - 8.49"
  • If the monitored web server is WebLogic 8.x, 9.x or 10.x: "8.44 - 8.49"
  • If the monitored web server is Oracle Application Server: "8.44 - 8.49"
  • If the monitored web server is "Other J2EE": "8.1 - 8.49" For Web:

Values: Do not enter a value.For Siebel:

Mandatory: Yes

Values: "7.5 - 7.7"

install-filters*

Indicates whether to install a filter on the Web server to collect server-side performance information.

Values: true, false

Mandatory: Yes

Info

Dependent on Web server type (some types do not support this, some force this installation).

install-dynamic-instrumentation*

Indicates whether to perform dynamic instrumentation.

Values: true, false

Mandatory: Yes, only if "install-instrumentation" is true.

Info

Dependent on Web server type (some types do not support this, some force this installation).

web-ports*

The ports to be used by the Web Tier Collectors. Use two pipelines "||" as a separator between the ports. Specify at least one port.

Values: port=port number;ip=[ip value|ALL];host-header=host headers;ssl=[true|false] (for example: port=3333;ip=ALL;host-header=srv2;ssl=true||port=4444;ip=ALL;host-header=srv1;ssl=true).

Mandatory: Yes, if install-network is true and is-cluster is false.

web-server-bits

Web server bits.

Values: 32, 64

Mandatory: Yes for Web Servers - Apache, iPlanet.

web-server-root

The root of the Web site root.

Mandatory: Yes, only for an Other Web server type.

web-ssl-client-certification-path

Full path to the client certificate file.

Values: String

Mandatory: Yes if "web-ssl-use-client-certification" is true.

web-server-i3-user-name

Web sever client name.

Values: String

Mandatory: Yes if "web-server-uses-authentication" is true.

web-server-i3-password(encrypted)

Web server encrypted password.

Values: String

Mandatory: Yes if "web-server-uses-authentication" is true

Alternatively the web-server-i3-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command.

web-server-domain

Web server domain.

Values: String

Mandatory: Yes if "web-server-uses-authentication" is true.

web-server-method

Web server method.

Values: Basic, Digest, NTLM

Mandatory: Yes if "web-server-uses-authentication" is true.

web-ssl-client-certification-password (encrypted)

Encrypted password for the client certificate.

Values: String

Mandatory: No

Alternatively the web-ssl-client-certification-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command.

web-ssl-client-certification-key-path

Full path to the client certificate private key file

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

...

ElementDescription
installation-cd-path

Indicates the absolute path to the folder where the Precise download was downloaded to.

Values: String

Mandatory: Yes

setup-process

Setup process. Always apptier-OT

Mandatory: Yes

setup-mode

Setup mode.

Values: install, edit, uninstall

Mandatory: Yes

instance-name

(component identifier field)

The unique name of the Tier that the Insight Savvy for Other Tier will monitor (for example, Citrix_Production, : AS400_DB).

Values: String

Mandatory: Yes

other-apptier-type*

Indicates the position and role of the Tier in your application. The options are as follows:

  • FE (Front-end). The first connection or input side in your application.
  • AP (Application Server). The middle Tier in your application. It is responsible for the business logic.
  • DB (Database). The back-end Tier in your application.

Values: String

Mandatory: Yes

other-protocol-type*

The network protocol for the monitored application. Two protocol types are supported:

  • ica (Citrix). The monitored application is a Citrix Presentation server application.
  • normal (Other). The monitored application uses any other protocol.

Values: String

Mandatory: Yes

other-monitor-method

The location from where the server is monitored. Two location types are available:

  • local (Locally). Check this option if you want the Insight Savvy for Network to monitor TCP traffic on a local Listener port.
  • remote (Remotely). Check this option if you want the Insight Savvy for Network to monitor all TCP traffic to a remote server port. Remote monitoring is usually used to monitor services on the computers the file is installed on, that cannot be monitored locally (for example: mainframe or unsupported operating systems running TCP applications).

Values: local, remote

Mandatory: Yes

other-monitor-ports*

Other monitor ports.

Values: static (if monitoring fixed ports), dynamic (if monitoring dynamic ports)

Mandatory: Yes

instance-server-machine-name

The name of the server where you will install the Other Tier. The server name or IP address will be valid if you previously defined this server as a Precise server.

Values: String.

Mandatory: Yes

other-remote-servers*

The names of the servers where you want to monitor the remote Tier. These are names whose ports will be monitored separated by two pipelines "||".

Format: remote-server=server-name||remote-server=server-name

Values: String.

Mandatory: Yes, only if other-monitor-method="remote". Otherwise, this must be empty without the value attribute: <parameter name="other-remote-servers" />

other-static-ports*

The TCP/IP fixed port or ports listened to by the monitored application. Use two pipelines "||" as a separator between the port ranges as follows: from=80;to=90||from=100;to=120. Do not define if the dynamic other-dynamic-ports-include-programs or other-dynamic-ports-exclude-programs fields are present.

Values: String

Mandatory: No.

other-dynamic-ports-include-programs*

The dynamic ports to be monitored; they are listened to by the monitored application. These are names of programs whose ports will be monitored. The program name will be matched against the first 9 characters of the names in the list separated by two pipelines "||".

Format: program=program-name||program=program-name. Do not define if the other-static-ports field is present.

Values: String.

Mandatory: No. Up to three values can be defined.

other-dynamic-ports-exclude-programs*

The dynamic ports, listened to by the monitored application, that should NOT to be monitored. These are names of programs whose ports will NOT be monitored. The program name will be matched against the first 9 characters of the names in the list separated by two pipelines "||".

Format: program=program-name||program=program-name. Do not define if the other-static-ports field is present.

Values: String.

Mandatory: No. Up to three values can be defined.

environment-name

Name of the application.

Values: String

Mandatory: Yes, for a federation installation.

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.

...