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

  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)
    • 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.
  2. 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

ElementDescription
i3-userSee Authenticate to CLI Utility.
i3-clear-passwordSee 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

ElementDescription
i3-userSee Authenticate to CLI Utility.
i3-encrypted-passwordSee 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

ElementDescription
action

Always forced-detach-on-proxy.

Mandatory: Yes

i3-userSee Authenticate to CLI Utility.
i3-encrypted-passwordSee 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

ElementDescription
action

Always forced-detach-on-main.

Mandatory: Yes

i3-userSee Authenticate to CLI Utility.
i3-encrypted-passwordSee Authenticate to CLI Utility.
alias

Display name of the Node you want to detach.

Values: String

Mandatory: Yes

  • No labels