Versions Compared

Key

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

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.

...

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

Step 6 Start the Monitoring Dashboard

{

  "ClusterSetup": {

    "ClusterId": "TestCluster_DemoDetails",

    "ShortName": "TestCluster_DemoDetails",

    "Description": "Test Cluster ",

    "InitialDirectory": "/home/ec2-user/testInstancesDetails1",

    "ExistingSetup": "false",

    "AppInstaller": {

      "InstallerBundleFile": "/home/ec2-user/deviceEngine.zip",

      "VersionNumber": "6.14"

    },

    "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",

  }

}


All parameters must be configured as per A-SackConfiguratorDeamon and A-StackMonioringDashboard.
 

...

  1. Run following command to see list of clusters
    $tql -cluster list
  2.  Execute below command to start particular cluster as mentioned in ClusterSetup.json file as 'ClusterId'.

    $ tql -cluster -start clusterid=<cluster_id>
  3.  After starting cluster Dashboard will look as below.
  4.  After selecting cluster, all cluster related information will be displayed on Dashboard.

...