Kiuwan on premise installer is a powerful tool that suits multiple environment scenarios:

• Single-host full contained installation.
• Multi-host installation where infrastructure services are externalized.
• Multi-host installation where kiuwan services are distributed (only AWS environments supported so far).
• Any combination of the two previous scenarios.

Depending on your needs, a different installation approach will be needed. Check this installation guide for details on how to proceed and find the solution that best fits your requirements.

System requirements

Installation requirements

It is mandatory for any host where a Kiuwan on premises service is installed to meet this requirements:

• Linux distribution
• Linux kernel version 3.10 or higher
• Connectivity to SMTP Mail Server.
• Internet connectivity during the installation process.
• Installing user must be root or have sudo privileges.

These software is also needed:

• Docker CE >=19.03.2
• Docker-compose >= 1.24.1
• Java Runtime Environment >=8
• Openssl >= 1.0.2
• Unzip
• GNU tar

CPU and memory minimum requirements

The following table shows the minimum requirements for each service. Note that these are only minimum requirements. You should take care of giving each service enough resources depending on your system demands.

Note: CPU clock speed and disk speed will affect overal response time. 

With the configuration above a system with the following load should give continuous service without problems:

• Parallel processing of 2 analyses (any additional parallel analysis request will be enqueued, and it will be executed as soon as any of the running analyses finishes)
• 50 concurrent web users or REST API calls.

Given the table above, for a single-host installation where no service is externalized the minimum system requirements are:

• 14GB of RAM and a processor with 8 cores for Kiuwan on premises.

It is recommended that you overscale these characteristics for the OS to have resources available for itself.

The Kiuwan on premise installation tool (kiuwan-cluster)

Kiuwan on premise installation process is carried out by our "kiuwan-cluster" tool.

The tool is provided as a tar.gz file. The following table summarizes the resources you will find once the tool distribution is extracted:

The following sections will guide you through the installation process.

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

This will download to the current directory the latest available installation tool.

Step 2: untar kiuwan-cluster

Once downloaded you should untar the provided gz file:

tar xvzpf kiuwan-cluster_master.tar.gz

This will untar the installation tool to a folder with extended version information of the tool. For example:

/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.

Installation: single-host

Installation: externalizing services

Installation: clustered environments