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

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

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

 

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.

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

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

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>

Table 4 Elements for Force Detach on Proxy