Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
Attach
Attach
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<proxy_alias>alias>]
                        -server <proxy<proxy_host_name>name>
                        -port <proxy<proxy_infra_port>port>
                        -folder <proxy<proxy_key>key>
                        -proxy-user <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<proxy_alias>alias>]
                        -server <proxy<proxy_host_name>name>
                        -port <proxy<proxy_infra_port>port>
                        -folder <proxy<proxy_key>key>
                        -proxy-user <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 1 Elements for AttachElement    Description

ElementDescription
i3-

...

...

.
i3-clear-

...

...

.

...

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

Anchor
Detach
Detach
Detach

Using CLI you can detach an attached Node. Run the following command from the main Precise FocalPoint to the <precise<precise_root> 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 2 Elements for Detach

Element

...

Description
i3-

...

...

.
i3-encrypted-

...

...

.
action

...

Always detach.

Mandatory: yes

...

alias

Node’s display name.

Values: String

Mandatory: yes


Anchor
MainPreciseFocalPointCrash
MainPreciseFocalPointCrash
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

Info

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.

...

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

...

Info

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 3 Elements for Force Detach on Proxy

Element    Descriptions

...

ElementDescription
action

Always forced-detach-on-proxy.

Mandatory: Yes

i3-

...

...

.
i3-encrypted-

...

...

.

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.

...

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>

Info

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

...

.

Table 11-4    Elements 4 Elements for Force Detach on Proxy

Element    Descriptions

...

ElementDescription
action

Always forced-detach-on-main.

Mandatory: Yes

i3-

...

...

.
i3-encrypted-

...

...

.
alias

...

Display name of the Node you want to detach.

Values: String

Mandatory: Yes

Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
Newtabfooter
aliasIDERA
urlhttp://www.idera.com
 | 
Newtabfooter
aliasProducts
urlhttps://www.idera.com/productssolutions/sqlserver
 
| 

...

Precise. Performance intelligence from click to storage. Learn more > >

...

Newtabfooter
aliasPurchase
urlhttps://www.idera.com/buynow/onlinestore
 | 
Newtabfooter
aliasSupport
urlhttps://idera.secure.force.com/precise/
 | 
Newtabfooter
aliasCommunity
urlhttp://community.idera.com
 
|
 
Newtabfooter
aliasResources
urlhttp://www.idera.com/resourcecentral
 | 
Newtabfooter
aliasAbout Us
urlhttp://www.idera.com/about/aboutus
 
Newtabfooter
aliasLegal
urlhttps://www.idera.com/legal/termsofuse

...