Federation installations

This section includes the following topics:

Attach
Detach
Main Precise FocalPoint Crash

Attach

Using CLI you can attach an existing node to an existing main Precise FocalPoint. To attach an existing node to an existing main Precise FocalPoint

Copy the following folder
infra/listener/etc/crypt
From the Precise FocalPoint (proxy) to the main Precise FocalPoint
~i3/proxy_key (create a new temporary folder)
- Copy the folder - do not move or use link to a shared folder among main and proxy.
- Do not copy the folder more than once since once you run the command below, the folder content on the proxy is changed.
- Copy the files from the proxy from the Infra/listener/etc/crypt folder, to a temporary folder on the main <precise_root>. Do not copy sub-folders.
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 attach
                    [-alias <proxy_alias>]
                    -server <proxy_host_name>
                    -port <proxy_infra_port>
                    -folder <proxy_key>
                    -proxy-user <user>
                    {-proxy-clear-password <clear_password>
                    -proxy-encrypted-password <encrypted_password>}
                    relay-to-focalpoint true | false
                    -relay-to-servers true | false
UNIX ./infra/bin/psin_cli.sh
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action attach
                    [-alias <proxy_alias>]
                    -server <proxy_host_name>
                    -port <proxy_infra_port>
                    -folder <proxy_key>
                    -proxy-user <user>
                    {-proxy-clear-password <clear_password>
                    -proxy-encrypted-password <encrypted_password>}
                    -relay-to-focalpoint true | false
                    -relay-to-servers true | false

Once the command is successfully completed, remove the proxy_key temporary folder.

Table 1 Elements for Attach

Element	Description
i3-user	See Authenticate to CLI Utility.
i3-clear-password	See Authenticate to CLI Utility.
action	Always attach. Mandatory: Yes
alias	The display name for the added proxy. Values: String Mandatory: No, will use Precise FocalPoint proxy server name by default.
server	Added Precise FocalPoint proxy server fully qualified name. Values: String Mandatory: Yes
port	Added Precise FocalPoint proxy listener communication port (not the GUI port). Values: Numeric Mandatory: Yes
folder	Values: path to the folder you've copied (proxy_key). Mandatory: Yes
proxy-user	Values: proxy's Precise administrative user name. Mandatory: Yes
proxy-clear-password	The proxy's Precise administrative user encrypted password. Values: encrypted string Mandatory: Yes Alternatively the proxy-clear-password can be used, allowing you to specify a clear password instead of an encrypted string. For more information, see Encrypt command.
relay-to-focalpoint	Restrict Precise FocalPoint proxy access to the main Precise FocalPoint. Values: true, false Mandatory: No
relat-to-servers	Restrict main Precise FocalPoint access to the Node servers. Values: true, false Mandatory: No

Detach

Using CLI you can detach an attached Node. Run the following command from the main Precise FocalPoint to 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 detach
                    -alias <proxy_alias>
UNIX ./infra/bin/psin_cli.sh
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action detach
                    -alias <proxy_alias>

Table 2 Elements for Detach

Element	Description
i3-user	See Authenticate to CLI Utility.
i3-encrypted-password	See Authenticate to CLI Utility.
action	Always detach. Mandatory: yes
alias	Node’s display name. Values: String Mandatory: yes

Main Precise FocalPoint Crash

In a federation installation the main Precise FocalPoint is a single point of failure. If the main Precise FocalPoint is down, the users will not be able to login to any of its nodes to view data.

Only GUI is not functional, but the instance’s data is still collected.

Therefore, the recommendation is to use cluster server installation for the main Precise FocalPoint.

However, if the Precise FocalPoint main server has crashed and no cluster solution was provided, you can use the workaround described below.

Once the Precise FocalPoint main server has crashed, you can force-detach the main Precise FocalPoint’s nodes. This allows the users to login directly into the detached node.

Run the following command on the <precise_root> of each proxy that you want to detach. You can detach one or more proxies (there is no need to detach all proxies), that you need to be active while the main Precise FocalPoint is down.

Force detach on Proxy

If JAAS is used for login verification you might need to manually enable JAAS on the proxy before running this command. This command produces action items.

To force detach a proxy, run the following command on the Precise FocalPoint of Node that you want to detach.

Windows   infra\bin\psin_cli.bat
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action forced-detach-on-proxy
UNIX      ./infra/bin/psin_cli.sh
                    -i3-user <user_name>
                    {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                    -action forced-detach-on-proxy

Table 3 Elements for Force Detach on Proxy

Element

Description

action

Always forced-detach-on-proxy.

Mandatory: Yes

i3-user

See Authenticate to CLI Utility.

i3-encrypted-password

See Authenticate to CLI Utility.

Force detach on Main

If the main Precise FocalPoint cannot be recovered, complete the action items related to the force detach on the proxy. Then you can install a brand new main Precise FocalPoint and connect the proxies to it.

If the main Precise FocalPoint is recovered, you can re-attach the detached proxies to it.

To do this, first run the following command on the main Precise FocalPoint for each detached proxy, and then attach the proxy using CLI or GUI.

Windows   infra\bin\psin_cli.bat
                  -i3-user <user_name>
                  {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                  -action forced-detach-on-main
                  -alias <proxy_alias>
UNIX    ./infra/bin/psin_cli.sh
                  -i3-user <user_name>
                  {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                  -action forced-detach-on-main
                  -alias <proxy_alias>

Many attach and detach operations might affect Precise performance. For more information, see Clean Main DB and Infra DB CLI command.

Table 4 Elements for Force Detach on Proxy

Element	Description
action	Always forced-detach-on-main. Mandatory: Yes
i3-user	See Authenticate to CLI Utility.
i3-encrypted-password	See Authenticate to CLI Utility.
alias	Display name of the Node you want to detach. Values: String Mandatory: Yes

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

Content

Space Tools