How to connect to TIBCO BusinessEvents? cluster through as-admin?

Table of Contents

• Detailed instructions to connect to cluster and collect as-admin stats:
• Set environment:
• Run as-admin
• Connect
• Show Members
• Show Spaces
• Show space
• qldump

When you install TIBCO ActiveSpaces®, which is the default cache provider and a pre-requisite for TIBCO BusinessEvents clusters, you will get an as-admin utility inside the AS_HOME/bin folder and an executable JAR in AS_HOME/lib.

You can use the admin CLI to connect to your TIBCO BusinessEvents cluster and collect useful information to help gather important cluster-specific details.

Detailed instructions to connect to cluster and collect as-admin stats:

Set environment:

Windows

 set AS_HOME=<TIBCO_HOME>/as/<version> set PATH=%AS_HOME%/lib;%PATH%

Linux

 export AS_HOME=<TIBCO_HOME>/as/<version> export LD_LIBRARY_PATH=$AS_HOME/lib:$LD_LIBRARY_PATH

Run as-admin

Run as-admin executable in AS_HOME/bin folder or in case of older versions as-admin.jar in AS_HOME/lib folder (java -jar as-admin.jar)

Connect

connect to your cluster using following simple command at as-admin command prompt

 as-admin> connect name "<Cluster_Name>" discovery "<Discovery_URL>" listen "<Listen_URL_For_As_Admin>" 

Full Syntax:

 connect [name <string>] [discovery <string>] [listen <string>]  [member_name <string>] [security_token <string>]  [security_policy <string>] [identity_password <string>] [authentication_domain <string>] [authentication_username <string>] [authentication_password <string>] [authentication_keyfile <string>]

Show Members

 as-admin> show members Lists all members (including as-admin) which are part of the cluster

Show Spaces

 as-admin> show spaces Lists all the spaces

Show space

Look at specific space in the cluster

 as-admin> show space "<space_name>" This will give you information on number of entries, replicas and specific operation summary on specific space.

qldump

 as-admin>qldump qldump lists all the spaces and their recovery status.

The following columns make up the result of "qldump" command:

• State: Space state

• Recovery policy: The recovery policy you used for your last recovery(you can find more details in the document for recovery policies), the default for TIBCO BusinessEvents cluster is no_data_loss

• Seed: shows if seed is okay.

• Quorum: shows if the last recovery matched the recovery quorum

• Persist: shows if persist is okay.

• Loaded: shows if data loaded from a persistent file

• DataLost: shows if any data loss for the last recovery

• LoadOk: shows if the last load is successfully loaded

• View: we have a View number for all persistent files to sync the persistent files.

• Seeders: shows how many seeders joined the space

• Quorum: shows the quorum you used for the last recovery

• Exception: shows if any exceptions during recovery

Note: The usage information for as-admin can be obtained by invoking as-admin -help from the ActiveSpaces bin directory in a command window.