Page History
...
■ uninstall (to uninstall)
Mandatory: Yes
Editable: Yes
focal-server-machine-name Name of the server where the Precise FocalPoint will be installed. The name must be written in lowercase letters only. Can be a fully qualified name or IP address.
Values: String
Mandatory: Yes
Editable: No
installation-cd-path Indicates the absolute path to the folder where the Precise v9.6 download was downloaded to.
Values: String
Mandatory: Yes
Editable: Yes
Installing Servers
The first stage in a server installation using the CLI utility requires installing and registering the server in Precise. The server is registered in the Precise database, a Precise Listener is started on the server, and communication between the Precise FocalPoint and the Precise Listener is enabled.
NOTE To promote efficiency, servers can also be installed automatically. For more information, see Auto Deployment on page 108.
Before installing a server using the CLI utility, verify the following issues:
• The Precise communication port is open in both directions (between the Precise FocalPoint server and the target server).
• CLI can handle installation packages. For more information, see Installation packages on page 8. To install the servers with the CLI utility
1. Run the following command on the main Precise FocalPoint server:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action list-required-files-for-new-server
-bits <new server bits (32/64)>
-os <os _type>
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action list-required-files-for-new-server
-bits <new server bits (32/64)>
-os <os_type>
The CLI creates an XML file containing the list of required installation packages for the server.
Table 2-6 Server Installation
Element Description
i3-user See Authenticate to CLI Utility on page 8.
i3-encrypted-password See Authenticate to CLI Utility on page 8.
action Always list-required-files-for-new-server
Mandatory: Yes
bits The OS bits in the new added server
Values: 32 or 64
Mandatory: Yes
os The added server OS
Values: See Operating System Type and Flavor on page 176.
Mandatory: Yes
2. On the new server create the installation folder and create new sub folder under it: distribution.
3. Copy the files specified the XML file created in Step 1 to the new server in the
<precise_root>/distribution
4. Login to the server using the Precise user
5. CD <precise_root>
Run the following command:
Windows distribution\psin_ba_WIN.exe -s
UNIX ./distribution/psin_ba_<os_type> -s
For more information, see Operating System Type and Flavor on page 176.
Note the -s argument
6. For each of the other files you've copied, run the following command:
Windows infra\bin\psin_file_new.exe -manual -extract distribution\<the_file_name> -event install
UNIX ./infra/bin/psin_file_new -manual -extract distribution/<the_file_name> -event install
7. Create an XML file containing the relevant installation parameters. Place the file in <precise_root> folder on the target server. You can also set up this file in advance.
By default, installing an non-secured local server using the CLI is not enabled. To enable a non-secured CLI server installation, set the Precise registry parameter:
registry\products\infrastructure\setup\settings\enable-local-server-cli to true, and restart Precise FocalPoint.
8. Run the following command to execute the CLI utility installation script from the <precise_root> folder on the target server:
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_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-server
-parametersfile <server_installation_parameters_file_name>
NOTE 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 script
Element Description
i3-user See Authenticate to CLI Utility on page 8.
i3-encrypted-password See 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 of the servers parameter file for product Collectors
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-us er-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-en crypted-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-do main-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-mo de-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-n ame 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-passwor d-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.
NOTE: 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-ser ver-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
Precise. Performance intelligence from click to storage. Learn more > >
...