Precise Application Performance Platform 10.3.x

Page History

Versions Compared

Key

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

...

Element

Description

setup-mode

Setup mode that is used.

Values: install, edit, uninstall

Mandatory: Yes

setup-process

Setup process.

Value: always server.

Mandatory: Yes

handle-server-machine-name

Name of the local server. Can be a fully qualified name or IP address.

The server name must be recognized by the Precise FocalPoint server, for example, it should be registered in DNS.

Values: String

Mandatory: Yes

server-machine-port-server-name

Port of the Precise Listener on the local server.

Values: Numeric 1025–65535

Mandatory: Yes

i3fp-server-machine-name

Name of the Precise FocalPoint server. Can be fully qualified name or IP address.

The Precise FocalPoint server name must be recognized by the newly added server, for example, it should be registered in DNS.

Values: String

Mandatory: Yes

server-machine-port-i3fp-server-name

Port of the Precise FocalPoint Listener. Replace i3fp-server-name with the name of Precise FocalPoint as shown in Precise GUI.

Values: Numeric 1025–65535

Mandatory: Yes

server-machine-use-communication-relay

-server-name

The Communication Relay provides a solution to a firewall restrictions problem. For more details see the Precise Installation Guide.

Value: (true/false)

Mandatory: No.

environment-name

Related application name.

Values: String

Mandatory: Yes, in case of federation installation.

server-machine-service-authentication-user-server-name

User account name for Precise services on the server.

Values: String

Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user".

server-machine-service-authentication-encrypted-password-server-name

Password for the user specified in server-machine-service-authentication-user-server-name.

Values: Encrypted String

Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user".

Alternatively the server-machine-service-authentication-clear-password-server-name can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command on page 148.

server-machine-service-authentication-domain-server-name

Domain of user specified in server-machine-service-authentication-user-server-name.

Values: String

Mandatory: Only if server-machine-service-authentication-mode-server-name is set to "user".

server-machine-service-unique-id-server-name

A unique services suffix used in the installation of all Precise agents allows installation of several Precise installations folders on the same server.

Relevant only for Windows servers.

Values: String

Mandatory: No

server-machine-service-authentication-mode-server-name

Server authentication mode. Precise services are using LocalSystem account. to specify other user account specify "user", and use:

server-machine-service-authentication-user-server-name
and
server-machine-service-authentication-encrypted-password-server-name

to specify the authentication details:

Values: user or localsystem

Mandatory: No

server-machine-secured-protocol-server-name

The secured installation is using an existing security protocols and methods such as blowfish and SSH to ensure that the communication encryption keys are safely copied to the target server.

Value: true, false

Mandatory: No

server-machine-security-clear-password-server-name

Security password.

Value: String

Mandatory: Only on secured remote Manual installation.

server-machine-install-user-server-name

User name required to install the Precise Listener on the server. Will only be used during installation.

Value: String

Mandatory: Only on secured remote automatic installation.

server-machine-install-encrypted-password-server-name

Password for the user, required for using Precise Listener services on the server.

Values: Encrypted String

Mandatory: Yes, unless you prefer to perform a manual server installation.

Alternatively the server-machine-install-clear-password-server-name can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command on page 148.

server-machine-installation-folder-server-name

Indicates the folder in which Precise installation files are stored.

Values: String

Mandatory: Yes, unless you prefer to perform a manual server installation.

server-machine-flavor-server-name

Type of server. Must be in one of the following servers:

Windows, UNIX

Values: String

Mandatory: Yes

server-machine-use-jre-server-name

Indicates whether a Java-based Listener will be installed on the server or not.

Info
A Java-based Listener is required for ShortTimeSlice support.

Values: true, false.

Default: true for servers whose OS supports JRE 1.6. You should use false if the server’s OS does not support JRE 1.6 or to reduce the memory footprint of the Precise Listener.

Mandatory: No

server-machine-bind-listener-address-server-name

Indicates whether the Precise Listener on this server should bind the specific server name or bind all the addresses on the given port.

Values: true, false

Mandatory: No

server-machine-ssl-server-name

Indicates whether this Listener will function as an SSL Listener.

Info
An SSL Listener is necessary to communicate with remote monitored instances.

Values: true, false

Default: false

Mandatory: No

For more information, see J2EE Remote Instance Monitoring on page 112.

server-machine-ssl-port-server-name

Indicates the SSL port this Listener will listen too.

Values: Integer

Default: 443

Mandatory: No

For more information, see J2EE Remote Instance Monitoring on page 112.

server-machine-consumer-server-name

Indicates whether this Listener will function as a consumer that will pull data from SSL Listeners.

Values: true, false

Default: false

Mandatory: No

For more information, see J2EE Remote Instance Monitoring on page 112.

server-machine-consume-target-server-name

Indicates a target server that contains an SSL Listener.

By setting this parameter, the installed server will consume remote data only from the specified target server. If this parameter is not specified and the server-machine-consumer-server-name is set to true, the installed server will consume data from all servers that contain SSL Listeners.

This parameter should only be set if the server-machine-consumer-server-name is set to true and you want to pull data from a specific SSL Listener.

Info
The target server specified in this parameter must be defined as an SSL Listener. Values: String (server name).

Mandatory: No

For more information, see J2EE Remote Instance Monitoring on page 112.

...

Prepare the server parameters file and save it to the <precise_root> folder on the main Precise FocalPoint.
For more information, see Table 2-8 on page 22. Mandatory parameters for this installation method are: server-machine-secured-protocol-server-name true server-machine-install-encrypted-password-server-name server-machine-installation-folder-server-name server-machine-flavor-server-name server-machine-install-user-server-name
You must not supply:
server-machine-security-clear-password-server-name
On the main Precise FocalPoint, run the following command from <precise_root> folder:
Windows   infra\bin\psin_cli.bat
                   -i3-user <user_name>
                  {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                  -action setup
                  -parametersfile <server_parameters_file_path>
UNIX           ./infra/bin/psin_cli.sh
                               -i3-user <user_name>
                                   {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                               -action setup
                                 -parametersfile <server_parameters_file_path>

...

Prepare server parameters file. For more information, see Table 2-8 on page 22.
Mandatory parameters for this installation are:
server-machine-secured-protocol-server-name true

On the main Precise FocalPoint server, run the following command from the <precise_root> folder:
Windows   infra\bin\psin_cli.bat
                   -i3-user <user_name>
                  {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                  -action secure-crypt-keys
                  -ba-secure-clear-password <security_password>
UNIX      ./infra/bin/psin_cli.sh
                                 -i3-user <user_name>
                             {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                                 -action secure-crypt-keys
                                 -ba-secure-clear-password <security_password>
The command will generate a key file on the Precise FocalPoint server, under the products/i3fp/security/keys/ folder.
Table 2-9 Local mode

Element	Descriptions
i3-user	See Authenticate to CLI Utility on page 8.
i3-encrypted-password	See Authenticate to CLI Utility on page 8.
action	always secure-crypt-keys Mandatory: Yes
ba-secure-encrypted-password	Password used to encrypt the communication key, up to 8 characters. Mandatory: Yes Alternatively the i3clear-password can be used, allowing you to specify a clear password instead of an encrypted string.

Copy and extract the server packages on the target server as specified in Installing Servers.
Copy key file from: products/i3fp/security/keys/keys/xml on the main Precise FocalPoint to the target server, to the ./infra folder.
On the target server, run the following command from the <precise_root > folder:
Windows   infra\bin\psin_infra.exe
                                   -manual-extricate-crypt <security_password>
UNIX          ./infra/bin/psin_infra
                            -manual-extricate-crypt <security_password>
The command will extricate the security keys on the target server.
On the target server, run the following command from the <precise_root> folder. For more information, see Installing Servers.
Windows   infra\bin\psin_cli.bat
                    -i3-user <user_name>
                                     {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                                     -action setup-server
                                     -parametersfile <server_parameters_file_path>
UNIX   UNIX        ./infra/bin/psin_cli.sh
                                   -i3-user <user_name>
                                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                                   -action setup-server
                                  -parametersfile <server_parameters_file_path>

...

Create the Precise for Oracle parameter file and save it to the <precise_root> folder on the main Precise FocalPoint. For more information, see About the Precise for Oracle parameter file on page 28.
Run the following command from the <precise_root> folder on the main Precise FocalPoint to execute the Precise CLI 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_oracle_installation_parameters_file_name>
UNIX   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_oracle_installation_parameters_file_name>

...

Table 2-10 Elements of the Precise for Oracle 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-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.

...

Content

Space Tools

Versions Compared

Old Version 40

New Version 41

Key