Single node installation

1. Download and install common utilities: wget, nc, gzip.

   $ sudo yum install wget nc gzip
   

2. Install Oracle JDK 8. Download and install JDK rpm.

   $ cd ~
   $ wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F; oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u60-b27/jdk-8u60-linux-x64.rpm"
   $ sudo yum localinstall jdk-8u60-linux-x64.rpm
   

   Update Java alternatives for the new JDK.

   $ cd /usr/java/jdk1.8.0_60/
   $ sudo alternatives --install /usr/bin/java java /usr/java/jdk1.8.0_60/bin/java 2
   $ sudo alternatives --config java
   There are 2 programs which provide 'java'.
   
     Selection    Command
   -----------------------------------------------
   *  1           /usr/java/jdk1.8.0_60/jre/bin/java
    + 2           /usr/java/jdk1.8.0_60/bin/java
   

   Check Java version.

   $ java -version
   
   java version "1.8.0_60"
   Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
   Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)
   

3. Install SQL DB. Kaa requires MariaDB (used by default) or PostgreSQL.

• MariaDB
• PostgreSQL

Add MariaDB YUM repository entry for CentOS. Copy and paste it into a file located in the /etc/yum.repos.d/ directory (name the file MariaDB.repo or similar).

sudo nano /etc/yum.repos.d/MariaDB.repo

Copy the contents below to the /etc/yum.repos.d/MariaDB.repo file.

• CentOS 6.7
• CentOS 7.2

# MariaDB 5.5 CentOS repository list
# http://mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/5.5/centos6-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1

# MariaDB 5.5 CentOS repository list
# http://mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = https://downloads.mariadb.com/MariaDB/mariadb-5.5.53/yum/centos7-amd64/
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1

Then, run the following commands.

$ sudo yum -y update
$ sudo service mysqld stop
$ sudo yum -y remove mysql-server mysql

Install MariaDB 5.5.

$ sudo yum install MariaDB-server MariaDB-client
$ sudo service mysql start

Check if MariaDB service is running.

$ sudo netstat -ntlp | grep 3306

tcp        0      0 0.0.0.0:3306            0.0.0.0:*               LISTEN      5476/mysqld

For more information, see the official page.

Connect to the mariadb-server.

$ mysql -u root -p

Create a new user for the database.

CREATE USER 'sqladmin'@'localhost' IDENTIFIED BY 'admin'; GRANT ALL PRIVILEGES ON *.* TO 'sqladmin'@'localhost' WITH GRANT OPTION; FLUSH PRIVILEGES;

Create a Kaa database.

CREATE DATABASE kaa
    CHARACTER SET utf8
    COLLATE utf8_general_ci;

Follow the instructions for your OS.

• CentOS 6.7
• CentOS 7.2

Exclude old PostgreSQL from the default repository, append a line exclude=postgresql* to the sections [base] and [updates].

$ sudo nano /etc/yum.repos.d/CentOS-Base.repo

...

[base]
name=CentOS-$releasever - Base
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os
#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6
exclude=postgresql*

...

[updates]
name=CentOS-$releasever - Updates
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6
exclude=postgresql*

...

Install PostgreSQL 9.4 PGDG file.

$ sudo yum localinstall https://yum.postgresql.org/9.4/redhat/rhel-6-x86_64/pgdg-centos94-9.4-3.noarch.rpm

List available PostgreSQL installations and install the PostgreSQL server.

$ sudo yum list postgres*
$ sudo yum install postgresql94-server

Initialize the PostgreSQL database.

$ sudo service postgresql-9.4 initdb
Initializing database:                [  OK  ]

Configure the database to start automatically when OS starts.

$ sudo chkconfig postgresql-9.4 on

Start the database.

$ sudo service postgresql-9.4 start
Starting postgresql-9.4 service:            [  OK  ]

Connect to the postgresql-server using the psql utility.

$ sudo -u postgres psql

Specify the password for the Postgres user (the default password in the Kaa configuration files is admin).

postgres=# \password
Enter new password: admin
Enter it again: admin

Create a Kaa database.

CREATE DATABASE "kaa"
	  WITH OWNER "postgres"
	  ENCODING 'UTF8'
	  LC_COLLATE = 'en_US.UTF-8'
	  LC_CTYPE = 'en_US.UTF-8'
	  TEMPLATE template0;

Update the pg\_hba.conf file to allow local connections.

$ sudo nano /var/lib/pgsql/9.4/data/pg_hba.conf

remove lines:
local   all             all                                     peer
host    all             all             127.0.0.1/32            ident

add lines:
local   all             all                                     trust
host    all             all             127.0.0.1/32            trust

Restart the database.

$ sudo service postgresql-9.4 restart

Stopping postgresql-9.4 service:            [  OK  ]
Starting postgresql-9.4 service:            [  OK  ]

Exclude old PostgreSQL from the default repository, append a line exclude=postgresql* to the sections [base] and [updates].

$ sudo nano /etc/yum.repos.d/CentOS-Base.repo

...

[base]
name=CentOS-$releasever - Base
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
exclude=postgresql*

#released updates
[updates]
name=CentOS-$releasever - Updates
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
exclude=postgresql*

...

Install PostgreSQL 9.4 PGDG file.

$ sudo yum localinstall https://yum.postgresql.org/9.4/redhat/rhel-7.2-x86_64/pgdg-centos94-9.4-3.noarch.rpm

List available PostgreSQL installations and install the PostgreSQL server.

$ sudo yum list postgres*
$ sudo yum install postgresql94-server

Initialize the PostgreSQL database.

$ sudo /usr/pgsql-9.4/bin/postgresql94-setup initdb
Initializing database ... OK

Configure the database to start automatically when OS starts.

$ systemctl enable postgresql-9.4

Start the database.

$ systemctl start postgresql-9.4

Connect to the postgresql-server using the psql utility.

$ sudo -u postgres psql

Specify the password for the Postgres user (the default password in the Kaa configuration files is admin).

postgres=# \password
Enter new password: admin
Enter it again: admin

Create a Kaa database.

CREATE DATABASE "kaa"
	  WITH OWNER "postgres"
	  ENCODING 'UTF8'
	  LC_COLLATE = 'en_US.UTF-8'
	  LC_CTYPE = 'en_US.UTF-8'
	  TEMPLATE template0;

Update the pg\_hba.conf file to allow local connections.

$ sudo nano /var/lib/pgsql/9.4/data/pg_hba.conf

remove lines:
local   all             all                                     peer
host    all             all             127.0.0.1/32            ident

add lines:
local   all             all                                     trust
host    all             all             127.0.0.1/32            trust

Restart the database.

$ systemctl restart postgresql-9.4

4. Install Zookeeper 3.4.9.

   Download and extract Zookeeper packages.

   $ cd /opt
   $ sudo wget http://www.eu.apache.org/dist/zookeeper/zookeeper-3.4.9/zookeeper-3.4.9.tar.gz
   $ sudo tar zxvf zookeeper-3.4.9.tar.gz
   $ sudo cp zookeeper-3.4.9/conf/zoo_sample.cfg zookeeper-3.4.9/conf/zoo.cfg
   

   Create a data directory.

   $ sudo mkdir /var/zookeeper
   

   Edit the dataDir property in the zookeeper configuration file.

   $ sudo nano /opt/zookeeper-3.4.9/conf/zoo.cfg
   

   ...
   dataDir=/var/zookeeper
   ...
   

   • CentOS 6.7
   • CentOS 7.2

   Install the supervisor utility.

   $ sudo rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm
   $ sudo yum install supervisor
   

   Edit the /etc/supervisord.conf file and add a section about ZooKeeper to it.

   $ sudo nano /etc/supervisord.conf
   [program:zookeeper]
   command=/opt/zookeeper-3.4.9/bin/zkServer.sh start-foreground
   autostart=true
   autorestart=true
   startsecs=1
   startretries=999
   redirect_stderr=false
   stdout_logfile=/var/log/zookeeper-out
   stdout_logfile_maxbytes=10MB
   stdout_logfile_backups=10
   stdout_events_enabled=true
   stderr_logfile=/var/log/zookeeper-err
   stderr_logfile_maxbytes=100MB
   stderr_logfile_backups=10
   stderr_events_enabled=true
   

   Configure the supervisor to start automatically when OS starts.

   $ sudo chkconfig supervisord on
   

   Start Zookeeper.

   $ sudo service supervisord start
   Starting supervisord:                 [  OK  ]
   

   Check Zookeeper status.

   $ sudo supervisorctl
   zookeeper RUNNING pid 24765, uptime 0:00:06
   

   Check if Zookeeper service is running.

   $ netstat -ntlp | grep 2181
   tcp    0   0 :::2181         :::*           LISTEN   2132/java
   

   Install the supervisor utility.

   $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-8.noarch.rpm
   $ sudo yum install supervisor
   

   Edit the /etc/supervisord.conf file and add a section about ZooKeeper to it.

   $ sudo nano /etc/supervisord.conf
   [program:zookeeper]
   command=/opt/zookeeper-3.4.9/bin/zkServer.sh start-foreground
   autostart=true
   autorestart=true
   startsecs=1
   startretries=999
   redirect_stderr=false
   stdout_logfile=/var/log/zookeeper-out
   stdout_logfile_maxbytes=10MB
   stdout_logfile_backups=10
   stdout_events_enabled=true
   stderr_logfile=/var/log/zookeeper-err
   stderr_logfile_maxbytes=100MB
   stderr_logfile_backups=10
   stderr_events_enabled=true
   

   Configure the supervisor to start automatically when OS starts.

   $ systemctl enable supervisord
   

   Start Zookeeper.

   $ systemctl start supervisord
   

   Check Zookeeper status.

   $ sudo supervisorctl
   zookeeper                        RUNNING   pid 15546, uptime 0:00:41
   

   Check if Zookeeper service is running.

   $ sudo netstat -ntlp | grep 2181
     tcp6       0      0 :::2181                 :::*                    LISTEN      15546/java
   

5. Install a NoSQL DB. Kaa requires MongoDB (used by default) or Cassandra.

• MongoDB
• Cassandra

Add the MongoDB yum repository.

$ sudo nano /etc/yum.repos.d/mongodb.repo
[mongodb]
name=MongoDB Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64/
gpgcheck=0
enabled=1

Install MongoDB 2.6.

$ sudo yum install -y mongodb-org

Start MongoDB.

$ sudo service mongod start
Starting mongod: [ OK ]

Verify that MongoDB started successfully.

$ sudo cat /var/log/mongodb/mongod.log | grep "waiting for connections on port"
2015-09-23T16:39:35.455+0300 [initandlisten] waiting for connections on port 27017

Configure the database to start automatically when OS starts.

$ sudo chkconfig mongod on

Add the DataStax Community yum repository.

$ sudo nano /etc/yum.repos.d/datastax.repo
[datastax-ddc]
name = DataStax Repo for Apache Cassandra
baseurl = http://rpm.datastax.com/datastax-ddc/3.6
enabled = 1
gpgcheck = 0

Install Java Native Access (JNA).

$ sudo yum install jna

Install Cassandra 3.6.

$ sudo yum install datastax-ddc

Export java variables.

$ export JAVA_HOME=/usr/java/jdk1.8.0_60/
$ export PATH=$PATH:/usr/java/jdk1.8.0_60/bin/

Start Cassandra.

$ service cassandra start

Configure the database to start automatically when OS starts.

$ sudo chkconfig cassandra on

Check Cassandra cql shell.

$ cqlsh
Connected to Test Cluster at 127.0.0.1:9042.
[cqlsh 5.0.1 | Cassandra 3.6.0 | CQL spec 3.4.2 | Native protocol v4]
Use HELP for help.
cqlsh>

1. Download the latest RPM package from the Kaa download page.

2. Unpack the downloaded tarball.

   $ tar -xvf kaa-rpm-*.tar.gz
   

3. Install the Node service.

   $ sudo rpm -i kaa-node.rpm
   

Check that PostgreSQL username and password are valid in the server configuration files.

$ cat /etc/kaa-node/conf/admin-dao.properties | grep jdbc_password
jdbc_password=admin

$ cat /etc/kaa-node/conf/sql-dao.properties | grep jdbc_password
jdbc_password=admin

In case of password or username mismatch, edit the configuration file.

$ sudo nano /etc/kaa-node/conf/admin-dao.properties

$ sudo nano /etc/kaa-node/conf/sql-dao.properties

To switch from MariaDB to PostgreSQL, copy the contents of the PostgreSQL config files to the Kaa database configuration files.

$ sudo bash -c "cat /etc/kaa-node/conf/postgre-dao.properties.template > /etc/kaa-node/conf/sql-dao.properties"
$ sudo bash -c "cat /etc/kaa-node/conf/postgresql-dao.properties.template > /etc/kaa-node/conf/admin-dao.properties"

Open TCP ports to be used by Administration UI (8080), Bootstrap service (9888, 9889), and Operations service (9997, 9999).

$ sudo iptables -I INPUT -p tcp -m tcp --dport 22 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9888 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9889 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9997 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9999 -j ACCEPT
$ sudo apt-get install iptables-persistent
$ sudo service netfilter-persistent start
$ sudo netfilter-persistent save

Open TCP ports to be used by Administration UI (8080), Bootstrap service (9888, 9889), and Operations service (9997, 9999).

$ sudo iptables -I INPUT -p tcp -m tcp --dport 22 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9888 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9889 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9997 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9999 -j ACCEPT
$ sudo service iptables save

Open TCP ports to be used by Administration UI (8080), Bootstrap service (9888, 9889), and Operations service (9997, 9999).

$ systemctl stop firewalld
$ systemctl mask firewalld
$ yum install iptables-services
$ systemctl enable iptables
$ systemctl start iptables
$ sudo iptables -I INPUT -p tcp -m tcp --dport 22 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9888 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9889 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9997 -j ACCEPT
$ sudo iptables -I INPUT -p tcp -m tcp --dport 9999 -j ACCEPT
$ sudo service iptables save