This section includes the following topics:

About auto deployment

To enhance the installation experience a new option has been developed that helps you install servers faster. This option is called "Template Listener" and is set up from the Main Precise FocalPoint. The option consists of two CLI utility commands that prepare the Template Listener for installing new servers and the installation based on the Template Listener. The Template Listener is a set of files that is relevant for a defined type of servers.

The Template Listener needs to be recreated if one of the following cases is applicable:

  • The original version of the software on the server is upgraded (e.g. v9.0 to v10.0)
  • You have applied an update that include updated packages of psin_ba* or jre_*

Preparing auto deployment

Using the CLI utilities, you can prepare the Template Listener on the Main Precise FocalPoint. This command creates a self extract file that should be extracted on the server that the Precise Listener will be installed on.

To prepare the Template Listener, run the following command from the Main Precise FocalPoint root folder:

Windows    infra\bin\psin_cli.bat
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action template-listener-prepare
                    -bits <bits>
                    -os "<os_type>"
                    -cpu-model <model> [-output-file <file>]
                    [-proxy-alias <node_alias>]
                    [-parameter server-machine-port-template-listener <port>]
                    [-parameter server-machine-security-encrypted-password-template-listener <encrypted_password>] [-installation-cd-path <installation_path>]
UNIX            ./infra/bin/psin_cli.sh
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action template-listener-prepare
                    -bits <bits>
                    -os "<os_type>"
                    -cpu-model <model> [-output-file <file>]
                    [-proxy-alias <node_alias>]
                    [-parameter server-machine-port-template-listener <port>]
                    [-parameter server-machine-security-encrypted-password-template-listener <encrypted_password>] [-installation-cd-path <installation_path>]

Table 1 Elements of the Prepare command

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

Always template-listener-prepare

Mandatory: Yes

bits

The OS bits of the server in the template.

Values: 32 or 64

Mandatory: Yes

os

The type of operating system used.

Values: See Operating System Type and Flavor on page 176.

Mandatory: Yes

cpu-model

The CPU model.

Values: AMD or ITANIUM

Mandatory: Only used for Windows or Linux 64 bits

output-file

The location of the output

Values: string

Mandatory: No

proxy-alias

Alias of the node

Values: string

Mandatory: Yes, only in a federation installation

parameter

server-machine-port-template-listener

The listener port for the Template Listener server

Values: string

Mandatory: No

parameter

server-machine-security-encrypted-password-template-listener

The password used to encrypt the communication key of the Listener. If this parameter is used, it must also be used in the template-listener-install command for the Template Listener server

Values: string

Mandatory: No

installation-cd-path

The path of the installation media.

Values: string

Mandatory: No

Installing with the Template Listener

Using the CLI utilities, you can install the new server based on the prepared Template Listener. The initial process is to copy the self extract file to a dedicated folder on the new server and run it. This can be done by including the extracted files as part of the server’s template, or ad-hoc step. If you intend to monitor cluster application servers on the server, verify that you extract the Template Listener to the same folder and drive on every server (so the Precise root folder will be identical). You need to recreate this image in those cases as described at the beginning of this section.

If the main Precise FocalPoint is Windows server and this server is a UNIX server, perform the following step after extracting the self extract file on the new server:

  • chmod -R 775 <the folder in the new server with the template files> This command handles the permission for this folder.

To install the Template Listener, run the following command from the root folder of the new server:

Windows    infra\bin\psin_cli.bat
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action template-listener-install
                    [-parameter server-machine-security-clear-password-template-listener=<clear_password>]
UNIX           ./infra/bin/psin_cli.sh
                   -i3-user <user_name>
                   {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                   -action template-listener-install
                   [-parameter server-machine-security-clear-password-template-listener=<clear_password>]

Table 2 Elements of the Install command

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

Always template-listener-install

Mandatory: Yes

parameter

server-machine-security-clear-password-template-listener

The password for the template listener written in clear text.

Values: string

Mandatory: Must be specified when supplied in the template-listener-prepare command

Additionally settings can be adapted using the template-listener_override.xml file.

About the template-listener_override.xml parameter file

Template Listener settings can be changed by using the template-listener_override.xml file that you need to create in the root folder of the new server. This file is an optional file. If it does not exist in the installation root folder, defaults will be used according to the ones in the template. Apply the following parameters that will override the standard settings:

<template-listener-override>
     <override>
          <parameter name="template-listener-server-machine-name" value="<name>"/>
          <parameter name="server-machine-port-template-listener" value="<port>"/>
          <parameter name="server-machine-use-communication-relay-template-listener" value="true|false"/>
     </override>
     <instance>
          parameters for instances as described in this guide (optional)
     </instance>
</template-listener-override>

The instance tag section can contain instances that you want to install on the server automatically. To specify parameter values which contain the server name (which may be unknown at the time of the template creation) use the word "template-listener". For example: <parameter name="collector-server-machine-name" value="template-listener"/>.

Table 3 Elements of the Install parameters file

ElementDescription
template-listener-server-machine-name

The name of the template-listener server.

Values: string

Mandatory: No. If not specified the host name is applied.

server-machine-port-template-listener

The listener port for the template-listener server.

Values: string

Mandatory: No

server-machine-use-communication-relay-template-listener

Indicates whether this server should use relay communication. Select this option if the server resides behind a firewall.

Firewall must be opened at the time of installation. Only block the connection with the server after the installation is complete.

Values: (true/false)

Mandatory: No

IDERA |  Products | Purchase | Support |  Community |  Resources |  About Us  | Legal