Installation Guide

This installation guide describes installation of a single node (all-in-one) Zusammen sample application and Zusammen. The installed application uses the reference implementation plug-ins described in the ‘Implementation Example’ section of the Layers Diagram.

This guide assumes the following set up:

• Vanilla CentOS 6.5 - x86_64 - 64-bit
• 32 GB of RAM
• 4 vCPUs
• 6GB HDD.

Technical stack

The following table describes the packages that Zusammen was tested with.

Parliamentary step

• Prior to starting the installation process, ensure all package indexes are up-to-date by running the command:
  

  1	sudo yum check-update

NOTE: In some cases, you will need to configure your yum proxy settings to follow the proxy settings of your organization.

Prerequisites

Java

Zusammen is written in Java 8, and requires Java to run.

Being an Open Source project, Zusammen uses OpenJDK.

1. To install OpenJDK, run the following command and answer the subsequent questions:
   

   1	sudo yum install java-1.8.0-openjdk.x86_64

2. To validate that OpenJDK has been installed, run the following command and check the version:
   

   1	java -version

Git

Amdocs recommends using Git 2.11 or later.

NOTE: The Centos repository contains a very old version of Git. You can either install Git from source or use other repositories (such as https://ius.io, mentioned in the Git documentation). To get a newer packaged version of Git use the command

1

yum install git2u

• To validate that the correct version of Git is installed, run the following command:
  

  1	git --version

Cassandra

1. Create a datastax.repo file.
   

   1	/etc/yum.repos.d/datastax.repo

2. Add the DataStax community repository settings to the datastax.repo file:
   

   1	[datastax]

   
   

   1	name = DataStax Repo for Apache Cassandra

   
   

   1	baseurl = https://rpm.datastax.com/community

   
   

   1	enabled = 1

   
   

   1	gpgcheck = 0

3. Install Cassandra 2.1.9.
   

   1	sudo yum install dsc21-2.1.9-1 cassandra2.1.9-1

4. Validate the version of Cassandra is 2.1.9:
   

   1	cassandra -v

Elastic

1. Install Elastic’s public signing key
   

   1	sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

2. Create a elasticsearch.repo file.
   

   1	/etc/yum.repos.d/elasticsearch.repo

3. Add the Elastic repository settings to the elasticsearch.repo file:

   1	[elasticsearch-5.x]

   
   

   1	name=Elasticsearch repository for 5.x packages

   
   

   1	baseurl=https://artifacts.elastic.co/packages/5.x/yum

   
   

   1	gpgcheck=1

   
   

   1	gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch

   
   

   1

   enabled=1

   
   

   1	autorefresh=1

   
   

   1	type=rpm-md

4. Install Elastic 5.x.
   

   1	sudo yum install elasticsearch

5. Start the Elastic daemon.
   

   1	sudo -i service elasticsearch start