Versions Compared

Key

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

...

Info

For Windows Server 2008 (Windows Longhorn) you must run this command using Administrator permissions: Click Start Menu, right-click Command Prompt, click Run as administrator, click Continue, to approve the operation. Run the command specified above.

Table 2-7 CLI utility installation scriptElement    Description

ElementDescription
i3-

...

userSee Authenticate to CLI Utility on page 8.
i3-encrypted-

...

passwordSee Authenticate to CLI Utility on page 8.
action

...

always setup-server

Mandatory: Yes

...

parametersfile

path to parameters file

Mandatory: Yes

About the server parameter file

You need to prepare the Server parameter file by creating an XML file with tags that represent the installation parameters and inserting the appropriate values.

The following is an example of a server parameter file:

<parameters>
     <parameter name="setup-mode" value="install"/>
     <parameter name="setup-process" value="server" />
     <parameter name="installation-cd-path" value="d:\" />
     <parameter name="handle-server-machine-name" value="poolserver5" />
     <parameter name="server-machine-port-poolserver5" value="3002" />
     <parameter name="server-machine-flavor-poolserver5" value="Windows" />
     <parameter name="i3fp-server-machine-name" value="focalmachine" />
     <parameter name="focalmachine-server-machine-port" value="20702" />
</parameters>

The following table describes the elements of the parameter file.

Table 2-8    Elements 8 Elements of the servers parameter file for product CollectorsElement    Description

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

...

server-machine-install-encrypted-passwor dpassword-server-name    Password for the user, required for using Precise Listener services on the server.

...