Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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:

Code Block
languagebash
titleDownload kiuwan-cluster
wget https://static.kiuwan.com/download/onpremise/kiuwan-cluster.tar.gz

...

Once downloaded you should untar the provided gz file:

Code Block
languagebash
titleStep #1: dDownload kiuwan-cluster
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

 

Step #2: set paths for each persistent volume

Step #3: initialize your volumes

 

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):

Code Block
languagebash
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:

Code Block
languagebash
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:

Code Block
languagebash
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:

Code Block
languagebash
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:

Code Block
languagephp
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.

Installation: single-host

...