Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

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
Icon

Please follow Docker official recommendations when installing Docker. These URLs describe the installation process for different Linux distributions:

We also recommend using the target installation hosts exclusively for Kiuwan services. If you plan running other containers than Kiuwan's in a single-host installation, please make sure that non of them is using the following network:

172.172.0.0/16

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.

ServiceMemoryCPU cores
wildfly-f[n]2GB2 cores
wildfly-a[n]2GB2 cores
wildfly-s[n]2GB2 cores
mysql5GB4 cores
loadbalancer1GB1 core
redis_0000[n]2GB2 cores

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:

ResourcePurpose
/config/volumes.propertiesConfiguration file to set where your persistent volumes will reside.
/docker/*.shAdvanced shell scripts to interact with your Kiuwan on premise installation.
/logsThe folder where the tool will write installation logs.
/sslTools that ease the certificate creation to keep Kiuwan on premise under a secure environment.
/user-contentThe folder where you will have to put some resources the installation process will need.
/volumesThe base persistent volumes (that may be copied to different locations depending on your installation needs).

*.sh

Main shell scripts to interact with your Kiuwan on premise installation.

The following sections will guide you through the installation process.

Installation: common steps

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:

Download kiuwan-cluster

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:

Step #1: dDownload kiuwan-cluster

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

Step 3: copy license files

 

Step #2: set paths for each persistent volume

Step #3: initialize your volumes

 

Installation: single-host

 

Installation: externalizing services

 

Installation: clustered environments

 

 

  • No labels