Page History
...
emc-asm-user User name of an Oracle ASM user with DBA privileges.
Values: String
Mandatory: Yes, if emc-asm-enabled is true.
emc-asm-encrypted-password Password of an Oracle ASM user with DBA privileges.
Values: Encrypted string
Mandatory: Yes, if emc-asm-enabled is true. See Encrypt command on page 148.
Alternatively the emc-clear-password can be used, allowing you to specify a clear password instead of an encrypted string.
Installing Precise for J2EE with the Precise CLI utility
Installing J2EE Tier Collectors on a server enables you to sample a J2EE instance on the server. Before installing a J2EE Tier Collector with the Precise CLI utility, verify the following issues:
• The Precise Listener has been installed on the server where Precise for J2EE agent is to be installed. To install Precise for J2EE with the Precise CLI utility
1. Create the Precise for J2EE 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 J2EE parameter file on page 34.
2. Run the following command from the <precise_root> folder on the main Precise FocalPoint to execute 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_j2ee_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_j2ee_installation_parameters_file_name>
About the Precise for J2EE parameter file
You need to prepare the Precise for J2EE parameter file by creating an XML file with elements that represent the installation parameters and inserting the appropriate values.
The following is an example of a Precise for J2EE parameters file:
<parameters>
<parameter name="setup-process" value="apptier-JE"/>
<parameter name="setup-mode" value="install"/>
<parameter name="instance-identifier" value="J2EE-Application"/>
<parameter name="collector-server-machine-name" value="sun3"/>
<parameter name="j2ee-type" value="JES"/>
<parameter name="j2ee-version" value="3"/>
<parameter name="j2ee-java-home" value="" />
<parameter name="is-cluster" value="false"/>
<parameter name="installation-cd-path" value="d:\"/>
</parameters>
The following table describes the updated elements of the parameter file.
Table 2-12 Elements of the Precise for J2EE 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-JE
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 J2EE Collector will be installed.
Values: String
Mandatory: Yes
instance-name J2EE instance name.
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).
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.
j2ee-type J2EE application server type.
Values: WebLogic, WebSphere, JBoss, JEUS, JES, JRun, Tomcat, Resin, Oracle, SAP, Other
Mandatory: Yes
j2ee-version J2EE application server version.
Values:
For WebLogic: 7.0, 8.1, 8.1 (Portal), 9.0, 9.1, 9.2, 9.2 (Portal), 10.0, 10.0 (Portal), 10.3, 10.3(Portal)
For WebSphere: 5.0, 5.1, 5.1 (Portal), 6.0, 6.1
For JBoss: 3.2, 4.0
For JEUS: 4.2, 5.0
For JES: 2, 3
For JRun: 4.x
For Tomcat: 4.x, 5.0, 5.5
For Resin: 2.1, 3.x
For Oracle 9i AS:
1.0.2.2.2 (Release 1)
9.0.2.x (OC4Jstandalone)
9.0.2.x (Enterprise Edition)
9.0.3.0.0 (OC4J standalone)
9.0.3.0.0 (Enterprise Edition)
9.0.4
11.5.8 (Oracle Applications-Forms Listener Servlet Mode)
10.1.2
10.1.3
For Other: Other
For SAP: 6.4
Mandatory: Yes
j2ee-java-home J2EE application server java home.
Value: String
Mandatory: Yes (can be empty)
apptier-name Name of the Tier.
Values: String
Mandatory: No
install-alert-customized Values: true/false
Mandatory: No
Set to true in case you want to have customized alerts metrics for this instance.
environment-name Name of the application.
Values: String
Mandatory: Yes, for a federation installation
install-network* Associates J2EE activity with network statistics.
Values: true, false
Mandatory: No
network-ports Network ports used by the J2EE instance, specify at least one port.
Values: port=x||port=y (for example: port=1111||port=2222)
Mandatory: Yes if install-network is set to true.
j2ee-weblogic-started-by-node-man ager Indicates whether this is a managed WebLogic.
Values: true/false
Mandatory: Yes, if j2ee-type is WebLogic.
Installing Precise for Web with the Precise CLI utility
Installing Web Tier Collectors on a server enables you to sample a Web instance on the server. Before installing a Web Tier Collector with the Precise CLI utility, verify the following issues:
• The Precise for Web FocalPoint is installed and running.
• The Precise Listener on the target server on which the Precise for Web agent is to be installed, was installed. To install Precise for Web with the Precise CLI utility
1. Create the Precise for Web 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 Web parameter file (Precise CLI utility) on page 37.
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_web_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_web_installation_parameters_file_name>
About the Precise for Web parameter file (Precise CLI utility)
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 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
NOTE: Note: 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.
NOTE: 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
Precise. Performance intelligence from click to storage. Learn more > >
...