Download and Install

Step 1 - Check the environment readiness

 If  echo $TQL_HOME  returns empty string then proceed to step number 2

Else run $ tql -engine -stop

Step 2 Set Environment Variables

Set JAVA_HOME & TQL_HOME. Look for TQL_HOME variable, it will be defined in ~/.bashrc or in ~/.bash_profile.

and add following line just below the above mentioned lines

export TQL_HOME=/home/ec2-user/ConfiguratorUI

export JAVA_HOME=/home/ec2-user/jdk1.8.0_131

PATH=$PATH:$HOME/.local/bin:$HOME/bin:$TQL_HOME/bin:$JAVA_HOME/bin

Step 3 Create Installation Directory

Create Directory where you would want to install the software. For example:  /home/ec2-user/ConfiguratorUI

Extract A-StackMonitoringDashboard zip into the created directory /home/ec2-user/ConfiguratorUI.

Step 4 Configure A-Stack Monitoring Dashboard to listen on HTTPS

Configure A-StackMonitoringDashboard to listen on HTTPS

Follows the step by step process defined in /home/ec2-user/ConfiguratorUI/StepsToCreateSSLCertificate.txt file.

Download all certificate (server.crt) files from all configurator nodes and import all certificates one by one using following command.

$  keytool -importcert -alias <alias_Name> -keystore "/opt/jdk1.8.0_131/jre/lib/security/cacerts" -storepass changeit -file server.crt

Copy server.crt file of A-StackConfigurator’s server into "/opt/jdk1.8.0_131/jre/lib/security/cacerts". This is for access daemon server from configuratorUI.

Step 5 Start the Monitoring Dashboard

Start tql engine by following command
$tql -engine -start

Step 6 Check Moniotring Dashboard Loads Properly

Check A-StackMonitoringDashboardis started successfully or not by hitting following URL in browser.

https://<ConfiguratorDeamon_IP_Address>:<Port>/

Following screen will be displayed in browser with no cluster.

Step 7 Cluster Setup

Now edit ClusterSetup.json file as per the guideline mentioned in Cluster Management. Put this file into /home/ec2-user/ConfiguratorUI.

Sample ClusterSetup.json file

{
  "ClusterSetup": {
    "ClusterId": "TestCluster_DemoDetails",
    "ShortName": "TestCluster_DemoDetails",
    "Description": "Test Cluster ",
    "InitialDirectory": "/home/ec2-user/testInstancesDetails1",
    "ExistingSetup": "false",
    "AppInstaller": {
      "InstallerBundleFile": "/home/ec2-user/HelloTQL.zip",
      "VersionNumber": "1.10"
    },
    "Instances": {
      "InstanceDetails": [
        {
          "InstanceName": "TestCluster_Shipra1",
          "HostName": "",
          "IPAddress": "18.216.140.179",
          "Port": "8087",
          "JvmArguments": "-Xms1027m -Xmx3g -XX:+HeapDumpOnOutOfMemoryError -XX:+PrintGCDetails -XX:+PrintGCDateStamps",
          "Path": ""
        },
        {
          "InstanceName": "TestCluster_Muralee1",
          "HostName": "",
          "IPAddress": "18.216.140.179",
          "Port": "8089",
          "JvmArguments": "-Xms1027m -Xmx3g -XX:+HeapDumpOnOutOfMemoryError -XX:+PrintGCDetails -XX:+PrintGCDateStamps",
          "Path": ""
        }
      ]
     },
    "LogFilesDirectory": "/home/ec2-user/testInstancesDetails/logs",
  }
}

Step 8 Start the Monitoring Dashboard

Now in command window run following command to setup clusters.
$ tql -cluster -setup path=/home/ec2-user/ConfiguratorUI/ClusterSetup.json,inputtype=file

Following message will be displayed.

Step 9 Check Cluster List

Run following command to see list of clusters
$tql -cluster list

Step 10 Start the Cluster

Execute below command to start particular cluster as mentioned in ClusterSetup.json file as 'ClusterId'.

$ tql -cluster -start clusterid=<cluster_id>

Step 11 Refresh Monitoring User Interface

After starting cluster Dashboard will look as below.

After selecting cluster, all cluster related information will be displayed on Dashboard.

Run following command to check status of cluster to verify.

$tql -cluster -status clusterid=<cluster_id>