Versions Compared

Key

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

Table of Contents
minLevel3
outlinetrue
stylenone


Summary Summary 

TQLConsole ThingSpaces Configurator can be used to deploy and manage the A-Stack Runtime Environment consisting of your models (projects) on a target host machine(s).

...

                                           Image RemovedImage Added


A-Stack Runtime Environment deploy and manage can be done using TQLConsole ThingsSpace Configurator User interface or using TQL Command Line Interface (TQL CLI)

...

  • Deploy Cluster 
  • Start/Stop/Restart of application in cluster nodes
  • Dynamic Editing of Application Configurations files per cluster peer basis
  • Execute Shell Script(s) and TQL queries against each application node
  • Application Monitoring for Memory, CPU Usage
  • Perform On-Demand Garbage Collection on a per node basis
  • Log Files Aggregation and ELK (Elastic Search, LogStash, Kibana Setup)

Preparing the Target Host(s)

In order to discover the cluster, the use can simply provide the IP address and Port of one of the nodes.

Target Host(s) needs to be prepared before the TQL Applications can be deployed using ThingSpace Configurator.

Target Host(s) Requirements

  1. Target Host(s) OS - Please refer to A-Stack Runtime OS Support Matrix for details. Note the CPU, Memory and Storage of target host(s) is dependent on your Applications need.
  2. A-Stack Configurator Daemon:
    1. Port Requirement - Daemon is started on port 9000.
    2. CPU, Memory footprint - 
    3. Always-on Vs On-Demand Mode

Download and Install A-Stack Configurator Daemon

  • A-Stack Configurator Daemon can be downloaded from your account page.

                    Image Added

  • Install A-Stack Configurator Daemon
    • Unzip the A-Stack Configurator Zip fie.
    • Start the configurator using the TQL CLI Command.

      Please note that if you are starting multiple instances of A-Stack on same host; specify the Path parameter to the -engine command.

      Code Block
      languagetext
      themeEmacs
      titleTQL CLI to Start the Configurator Daemon
      tql -engine -start -Xmx=512m Path="/home/ec2-user/atomiton/configurator
      


    • Default SSL Certificate - A-Stack Configurator Daemon comes installed with default SSL Certificate. This file is in sslcertificates folder on the installation.
    • Test if the Deamon is running

      Hit the URL:  https://<host>:9000

      Code Block
      languagexml
      themeEmacs
      titleDaemon Keep-Live Response
      <FacetAgent Status="200" Reason="OK"/>
      


    • Steps to generate SSL Certificate

      Code Block
      languagetext
      themeEmacs
      titleSteps to generate SSL Certificate
      Update openssl.cnf file for SAN update -
      
      1. Update openssl.cnf file located at /etc/pki/tls/openssl.cnf to add below configuration lines
      These lines need to update in v3_req section
      
      subjectAltName = @alt_names
      alt_names
      DNS.1 = localhost
      DNS.2 = <Hostname>
      IP.1 = <IP address>
      
      Execute below openssl commands to create and import ssl certificate -
      
      1. openssl genrsa -des3 -out server.key 1024 -extensions v3_req -extfile /etc/pki/tls/openssl.cnf
      
      2. openssl req -new -key server.key -out server.cer -extensions v3_req
      
      3. cp server.key server.key.org
      
      4. openssl rsa -in server.key.org -out server.key
      
      5. openssl x509 -req -days 365 -in server.cer -signkey server.key -out server.crt -extensions v3_req -extfile /etc/pki/tls/openssl.cnf
      
      6. openssl pkcs12 -export -in server.crt -inkey server.key -out serverKeystore.p12
      
      7. export PATH=$PATH:/opt/jdk1.8.0_144/jre/bin – Find path till java keytool lib directory and pass it to export command
      
      8. keytool -importkeystore -deststorepass test123 -destkeystore server.jks -srckeystore serverKeystore.p12 -srcstoretype PKCS12
      
      Replace certificate in $TQL_HOME/sslcertificates folder; where $TQL_HOME is the directory where A-Stack Configurator Daemon is installed.
      
      If certificate file name is different from server.jks then update its name in sff.local.config.xml file


Creating a Gold Copy of A-Stack Configurator

Docker Container
AWS EC2 AMI


The discovery result is divided into two parts: Local Engine and Cluster Nodes categorized the Group to which the nodes belong. 

...

Following Search Fields are available:

Elastic Search Queries

Code Block
languagetext
themeEmacs
titleElastic Search Queries
To display all logs that are having fields.type is 'SffReport'
{
  "query": {
    "match": {
      "fields.type": {
        "query": "SffReport",
        "type": "phrase"
      }
    }
  }
}

To display all logs that are having loglevel is 'WARN'
{
  "query": {
    "match": {
      "loglevel": {
        "query": "WARN",
        "type": "phrase"
      }
    }
  }
}

To display all logs that are having fields.port is '8085'
{
  "query": {
    "match": {
      "fields.port": {
        "query": "8085",
        "type": "phrase"
      }
    }
  }
}

To display all logs those are having fields.host is '172.31.48.38'
{
  "query": {
    "match": {
      "fields.host": {
        "query": "172.31.48.38",
        "type": "phrase"
      }
    }
  }
}

To display all logs that contains are 'SubmitSequence' in SffReportsData tag
{
  "query": {
    "match": {
      "SffReportsData": {
        "query": "*SubmitSequence*",
        "type": "phrase"
      }
    }
  }
}


To display all logs that contains are 'SffSequenceFacet' in message tag
{
  "query": {
    "match": {
      "message": {
        "query": "*SffSequenceFacet*",
        "type": "phrase"
      }
    }
  }
}