This section includes the following topics:
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 |