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
{
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{ "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", |
...
} |
...
}
All parameters must be configured as per A-SackConfiguratorDeamon and A-StackMonioringDashboard.
} |
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.
...