Versions Compared

Key

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

This section includes the following topics:•    Attach

...

...

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 FocalPoint1.    Copy

  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.
    1. Run the following command from the Main Precise FocalPoint root folder:
      Windows  

    ...

    1.  infra\bin\psin_cli.bat
                          -i3-user

    ...

    1. <user_

    ...

    1. name>
                          {-i3-encrypted-password

    ...

    1. <encrypted_

    ...

    1. password> | -i3-clear-password

    ...

    1. <clear_

    ...

    1. password>}
                          -action attach
                          [-alias

    ...

    1. <proxy_

    ...

    1. alias>]
                          -server

    ...

    1. <proxy_host_

    ...

    1. name>
                          -port

    ...

    1. <proxy_infra_

    ...

    1. port>
                          -folder

    ...

    1. <proxy_

    ...

    1. key>
                          -proxy-user

    ...

    1. <user>
                          {-proxy-clear-password

    ...

    1. <clear_

    ...

    1. password>
                          -proxy-encrypted-password

    ...

    1. <encrypted_

    ...

    1. password>}
                          relay-to-focalpoint true | false
                          -relay-to-servers true | false

    ...

    1. UNIX            ./infra/bin/psin_cli.sh
                          -i3-user <user

    ...

    1. _

    ...

    1. name>
                          {-i3-encrypted-password

    ...

    1. <encrypted_

    ...

    1. password> | -i3-clear-password

    ...

    1. <clear_

    ...

    1. password>}
                          -action attach
                          [-alias

    ...

    1. <proxy_

    ...

    1. alias>]
                          -server

    ...

    1. <proxy_host_

    ...

    1. name>
                          -port

    ...

    1. <proxy_infra_

    ...

    1. port>
                          -folder

    ...

    1. <proxy_

    ...

    1. key>
                          -proxy-user

    ...

    1. <user>
                          {-proxy-clear-password

    ...

    1. <clear_

    ...

    1. password>
                          -proxy-encrypted-password

    ...

    1. <encrypted_

    ...

    1. 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.

    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 Table 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

    ...