Versions Compared

Key

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

...

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

Example:

<parameters>
     <parameter name="setup-process" value="apptier-WW"/>
     <parameter name="collector-server-machine-name" value="server1"/>
     <parameter name="web-type" value="IIS"/>
     <parameter name="instance-identifier" value="WEB1" />
     <parameter name="is-cluster" value="false" />
     <parameter name="web-real-name" value="Default Web Site" />
     <parameter name="web-server-version" value="6.x" />
     <parameter name="web-application-used" value="Web" />
     <parameter name="install-filters" value="true" />
     <parameter name="install-instrumentation" value="true" />
     <parameter name="install-dynamic-instrumentation" value="true" />
     <parameter name="web-collect-extended-information" value="false" />
     <parameter name="web-ports" value="port=80;ip=server1;ssl=true"/>
     <parameter name="web-iis-instance-number" value="1"/>
     <parameter name="installation-cd-path" value="d:\"/>
</parameters>

Table 2-13    Elements 13 Elements of the Precise for Web 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-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 on page 148.

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 on page 148.

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

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.

...