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
1. 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)
o Copy the folder - do not move or use link to a shared folder among main and proxy.
o Do not copy the folder more than once since once you run the command below, the folder content on the proxy is changed.
o 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 11-1 Elements for Attach
Element Description
i3-user See Authenticate to CLI Utility on page 8.
i3-clear-password See Authenticate to CLI Utility on page 8.
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 on page 146.
relay-to-focalpoint Restrict Precise FocalPoint proxy access to the main Precise FocalPoint
Values: true, false
Mandatory: No
relay-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 11-2 Elements for Detach
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 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.
NOTE 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
NOTE 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 11-3 Elements for Force Detach on Proxy
Element Descriptions
action Always forced-detach-on-proxy
Mandatory: Yes
i3-user See Authenticate to CLI Utility on page 8.
i3-encrypted-password See Authenticate to CLI Utility on page 8.
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>
NOTE Many attach and detach operations might affect Precise performance. For more information, see Clean Main DB and Infra DB CLI command on page 149.
Table 11-4 Elements for Force Detach on Proxy
Element Descriptions
action Always forced-detach-on-main
Mandatory: Yes
i3-user See Authenticate to CLI Utility on page 8.
i3-encrypted-password See Authenticate to CLI Utility on page 8.
alias Display name of the Node you want to detach
Values: String
Mandatory: Yes