soctools

Cluster support for Soctools project

It's just begining of the work, it works only on Centos 7, (just minmal install and ssh(public key) access(with root user) from "Controller machine" is required on the ansoble hosts(fingerprints should be added before the ansible playbook runs))

The playbook contains instalation commands for both, cluster and standalone.

Standalone instalation steps

1. Configure playbook parameters: Edit group_vars/all/main.yml and change 'soctoolsproxy' so that it points to the FQDN of the server.

   • vi group_vars/all/main.yml

2. Users can be configured in the file group_vars/all/users.yml

   • vi group_vars/all/users.yml

3. Prepare server

   • sudo yum -y install epel-release
   • sudo yum -y install ansible git
   • sudo ansible-galaxy collection install ansible.posix

4. Run ansible commands

   • ansible-playbook -i inventories_standalone.ini prepare.yml -t prepare_standalone
   • ansible-playbook -i inventories_standalone.ini buildimages.yml -t build_standalone
   • ansible-playbook -i inventories_standalone.ini buildca.yml
   • ansible-playbook -i inventories_standalone.ini soctools.yml -t start-docker-containers_standalone
   • ansible-playbook -i inventories_cluster.ini soctools.yml -t init

5. To stop docker containers, run the following command:

   • ansible-playbook -i inventories_standalone.ini soctools.yml -t stop-docker-containers_standalone

Cluster instalation steps Requirements and Configuration

1. project requires minimum 4 servers:

   • One server - "Controller machine" where the ansible playbook will run (other servers should be accissible from this host with ansible(root user))
   • 3 servers as "ansible hosts"

2. configure inventories_cluster.ini file:

   • Put IP addresses or DNS Hostnames for three ansible hosts in the soctoolshosts section(hosts can be more then three)
   • Put one host/ip(one of the host/ip from the soctoolshosts section. it sets where(in which host) to run each container) in the following hostgroups:
   • cassandrahost
   • cortexhost
   • haproxyhost
   • keycloakhost
   • odfekibanahost
   • misphost
   • mysqlhost
   • thehivehost
   • zookeeperhost
   • Put two hosts/ips(two of the hosts/ips from the soctoolshosts section. it sets where(in which host) to run each container) in the following hostgroup:
   • odfehosts
   • Put three hosts/ips(two of the hosts/ips from the soctoolshosts section. it sets where(in which host) to run each container) in the following hostgroup:
   • nifihosts P.S.: example inventories_cluster.ini file is: inventories_cluster.example

3. fill the following variables in the group_vars/all/main.yml file

   • "soctoolsproxy" - FQDN which will be pointed to the "soctoolsproxy_vip" IP address
   • "soctoolsproxy_vip" - One avalable IP address from the same subnet as soctools servers
   • "soctoolsproxy_vip_netmask" - Subnet mask in CIDR format, for example "26"

4. Users can be configured in the file group_vars/all/users.yml

   • vi group_vars/all/users.yml

5. Prepare server

   • sudo yum -y install epel-release
   • sudo yum -y install ansible git
   • sudo ansible-galaxy collection install ansible.posix

6. Run ansible commands

   • ansible-playbook -i inventories_cluster.ini prepare.yml -t prepare_cluster
   • ansible-playbook -i inventories_cluster.ini buildimages.yml -t build_cluster
   • ansible-playbook -i inventories_cluster.ini buildca.yml
   • ansible-playbook -i inventories_cluster.ini soctools.yml -t start-docker-containers_cluster
   • ansible-playbook -i inventories_cluster.ini soctools.yml -t init

7. To stop docker containers, run the following command:

   • ansible-playbook -i inventories_cluster.ini soctools.yml -t stop-docker-containers_cluster