newbIT TSA

Installation prerequisites

Docker

The official RedHat package for docker is distributed in the rhel-7-server-extras-rpms yum repository, which might need to be enabled first (see /etc/yum.repos.d). After you have the docker packages available, you can install the packages with the following command:

sudo yum install docker, docker-python, docker-selinux -y

Start the docker service:

sudo systemctl start docker.service

Enable the docker service:

sudo systemctl enable docker.service

Check the docker service status:

sudo systemctl status docker.service
    docker.service - Docker Application Container Engine
       Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
      Drop-in: /usr/lib/systemd/system/docker.service.d
               |-flannel.conf
       Active: active (running) since Thu 2018-03-01 22:398:47 EDT; 14s ago
         Docs: http://docs.docker.com
     Main PID: 13495 (sh)
       CGroup: /system.slice/docker.service
               └─13495 /bin/sh -c /usr/bin/docker-current daemon $OPTIONS

Ansible®

We provide ansible roles and playbook to install the newbIT TSA. To execute the Ansible playbook it is required that ansible is installed on the server itself or on a dedicated management system.

After you have made the ansible package available on the server, you can install the package with the following command:

sudo yum install ansible -y

Download and load docker images

This step is not required if your server has access to the official docker registry.

We regularly create exports of the complete docker image into an offline usable tar format. These images/versions were pre-tested prior to release, and are only published once we have qualified them in our lab.

In order to have as good a customer experience as possible, it is important that you contact us prior to installing or updating your installation. This ensures that we can help you to avoid any potential issues before they occur.

Download the images from https://packages.newbit.ch/influx/docker/, and copy them onto your nTSA server. We recommend storing the image under ~/docker-images.

To import the images into your local docker installation, run the following commands on your nTSA server:

Note: The filenames contain the version string. Care should be used to ensure that the correct versions of each component are used, as the previous packages will likely also be listed (if downloaded last time).

sudo docker load -i ~/docker-images/chronograf_1.6.2.tar
sudo docker load -i ~/docker-images/grafana_grafana_5.3.2.tar
sudo docker load -i ~/docker-images/influxdb_1.6.4.tar
sudo docker load -i ~/docker-images/kapacitor_1.5.1.tar
sudo docker load -i ~/docker-images/newbit_ntsa-docs_0.2.0.tar
sudo docker load -i ~/docker-images/newbit_ntsa-portal_0.1.1.tar

Prepare ansible playbook

Replace influx-hostname with the fqdn of the server, where the newbIT TSA will be installed.
Note: that you can also use localhost as the fqdn when you execute the ansible-playbook on the same server as you deploy the influx stack.

all:
  children:
    influxdb:
      hosts:
        influx-hostname

We recommend you Deploy your public ssh key on the server. This will simply the file transfer and the interaction with the server.

Configure playbook with your settings

The ansible playbook allows you to customize the configuration if required, for example:

---
- hosts: influxdb
  roles:
    - { role: influx-docker,
        influx_docker_data_path: "/docker",
        influx_docker_influxdb_host: "your-domain.com",
        influx_docker_grafana_domain: "your-domain.com",
        influx_docker_influxdb_version: '1.6.4',
        influx_docker_chronograf_version: '1.6.2',
        influx_docker_kapacitor_version: '1.5.1',
        influx_docker_grafana_version: '5.3.2',
        influx_docker_telegraf_version: '1.8.2',
        influx_docker_ntsa_docs_version: '0.2.0',
        influx_docker_ntsa_portal_version: '0.1.1',
        influx_docker_manage_firewall: false,
        influx_docker_databases: "telegraf _internal kapacitor",
        influx_docker_grafana_reporting_enabled: "false",
        influx_docker_grafana_check_for_updates: "false",
        influx_docker_grafana_disable_gravatar: "true",
        influx_docker_influxdb_auth_enabled: false,
      }

Run ansible playbook

The ansible playbook will deploy and setup the Influx stack.

Execute the following command if you execute ansible from the same system (not as root user):

sudo ansible-playbook play.yml -i hosts -c local --ask-become-pass

Execute the following command if you execute ansible from a management host:

sudo ansible-playbook play.yml -i hosts -u root

For more information about ansible playbooks please refer to its documentation.

results matching ""

    No results matching ""