Page History
...
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: |
...
|
...
|
...
|
...
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
|
...
| |
install-dynamic-instrumentation* |
...
Indicates whether to perform dynamic instrumentation. Values: true, false Mandatory: Yes, only if "install-instrumentation" is true.
|
...
| |
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.
...