...

Installation: common steps

This guide will reference two important folders:

• [INSTALL_DIR]: where the installation tool (kiuwan-cluster) will be located.
• [VOLUMES_DIR]: where the persistent volumen will be located.

Sometimes this folders will be referenced inside command line examples. Please make sure you replace any of them with the needed real path.

Note that it is up to you where this folders will be located.

Step 1: download kiuwan-cluster

The first step is to download kiuwan-cluster, the Kiuwan on premises installation tool. It can be downloaded directly from a terminal like this:

wget https://static.kiuwan.com/download/onpremise/kiuwan-cluster.tar.gz

...

Once downloaded you should untar the provided gz file:

tar xvzpf kiuwan-cluster_master.tar.gz

...

/home/user/kiuwan-cluster_master.XXXX-2.8.YYMM.V

This folder will be referred to as [INSTALL_DIR] through this guide.

Step 3: copy license files

In order to be able to start a Kiuwan on premises installation, you will need two license files

...

:

• configq1.zip
• license.zip

Copy these files to the user-content folder of your installation tool directory (please replace [INSTALL_DIR] with the real location of your installation directory):

cp configq1.zip [INSTALL_DIR]/user-content
cp configq1.zip [INSTALL_DIR]/user-content

Step 4: download and copy the needed driver version for MySQL

Kiuwan on premise needs this exact MySQL driver:

mysql-connector-java-5.1.39-bin.jar

You can download it by executing this command:

wget http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.39.tar.gz

Copy the downloaded jar file to the user content folder:

cp mysql-connector-java-5.1.39.tar.gz [INSTALL_DIR]/user-content

Step 5: initialize your volumes

The installation tool comes with the base volumes to boot a first installation of Kiuwan on premises. We provide three volumes:

• config-shared: contains the base configuration, shared between different services.
• data-shared: contains the base data structure, shared between different services.
• data-local: contains the base data structure, independent for each service.

Copy the provided volumes to a location of your desire:

cp -rp [INSTALL_DIR]/volumes/config-shared [VOLUMES_DIR]/config-shared
cp -rp [INSTALL_DIR]/volumes/data-shared [VOLUMES_DIR]/data-shared
cp -rp [INSTALL_DIR]/volumes/data-local [VOLUMES_DIR]/data-local

Take note of the locations you choose for each volume. You will need these paths for the next installation step.

Step 6: configure the created volume paths

Edit the file located in [INSTALL_DIR]/config/volumes.properties and set the previous paths to each property:

config.shared=[VOLUMES_DIR]/config-shared
data.shared=[VOLUMES_DIR]/data-shared
data.local=[VOLUMES_DIR]/data-local

Please remember that [VOLUMES_DIR] here is just a placeholder for the real path you chose.

Step #2: set paths for each persistent volume

Step #3: initialize your volumes

Installation: single-host

...