Installation Guide

System Architecture Overview

Kiuwan On-Premises (KOP) is based on a client-server architecture with the following major server components:

• WildFly application server 
• MySQL database
• Redis in-memory data store

KOP solution is deployed on a centralized server (all the components are installed in the same host) and accessed by users via HTTP website access or by IDE plugins (Eclipse, Visual Studio).

KOP also supports distributed architecture with high-availability and load-balancing. For these scenarios, please contact Kiuwan support.

Server Host Requirements

Installation requirements

Kiuwan On-Premises (KOP)  solution is deployed on a centralized server host (all the components are installed in the same host) and accessed by users via HTTP or by IDE plugins (Eclipse, Visual Studio).

KOP installation process consists on building a Docker image.

Installation must be executed by a unix user with privileges to execute docker server commands.

During the installation process, you will need to specify a KOP unix user and group :

• KOP user will the owner of the KOP processes that will run within the docker container 
• the docker persistent volume will be owned by KOP user

KOP User and Group is specified during the KOP Installation process as KIUWAN_USER and KIUWAN_GROUP properties

You can create KOP user and group by executing next commands (no special privileges are needed):

• sudo groupadd ${KIUWAN_GROUP}
• sudo useradd -g ${KIUWAN_GROUP} -s /bin/false -m -d /home/${KIUWAN_USER} ${KIUWAN_USER}
  

KOP Persistent Volume is created by the installation process and must specified as DIR_PERSISTENT_VOLUME property

CPU and memory requirements

 Server CPU and memory requirements depend on several factors:

• how many lines of code will need to be scanned
• how many analyses will need to be executed in parallel 
• how many users will access the web application
  

Above factors heavily influence host server requirements, but minimum requirements are:

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

Above configuration is recommended for a system load that requires continuous service for:

• parallel execution 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), and
• 50 concurrent web-users

Additional system requirements can be met by following next recommendations:

• In case you need a higher number of parallel analyses executions, you should add 1 CPU core and 512 Mb for any additional required parallel analysis
• In case you need to improve response time to web users, conside to add 1Gb for every 50 additional web users.

Installation steps

Before installing KOP, make sure that you understand the System Architecture Overview, that your server host(s) complies with the Server Host Requirements, and that you have properly prepared the Environment as follows:

Step 1. Unpackage KOP Installation Package

Step 2. Configure Kiuwan Docker image

Step 3. Build the Kiuwan Docker image

     cd $KOP_INSTDIR/vX.Y

     ./create_and_init_kop.sh

After image creation, you will be able to list the images in your docker server and identify your kiuwan image by issuing the next command:

     docker images

Step 3.1 (Optional) Moving the image to another server host

After creating the image, if you want to move it to another host server you first must save it to a tarball by executing: 

     docker save kop:v1.2 > kop_v12_saved_image.tar 

     docker load --input kop_v12_saved_image.tar 

    run_kop.sh 

    run_init_kop.sh 

     docker stop <my_container_name>

Step 4.1 Execution in debug mode (only sshd) 

Just in case you are running with problems while executing Kiuwan container, you can run it in debug mode.

This means to apply the configuration but not starting the services, allowing you to access the container through ssh.

     docker run --rm --name <my_container_name> \

                     -h <my_container_host_name> \

                     -v <server_host_mount_dir:container_mount_dir> \

                     -p <ssh_port_ext>:22  \

                     -d \

                     <image_name:version>

Step 5. Accessing Kiuwan On Premise

KOP built-in users

KOP comes with the following built-in users.

• kiuwanadmin (password: kiuwanadmin)
  • access to Kiuwan "functional" administration modules such as Users, Applications and Model Management  (see Admin Guide )
  • log in as kiuwanadmin to create users of your KOP instance
• sysadmin (password: sysadmin)
  • log in as sysadmin to access functionalities related to monitoring and tuning KOP execution
  • sysadmin will give you access KOP sysconsole

KOP URL

Once Kiuwan On Premise container is running, you can access it from a browser in the following URL:

http://<KIUWAN_HOST>:<KIUWAN_PORT>/saas

where KIUWAN_HOST and KIUWAN_PORT match the values of those properties as configured in settings.custom

Advanced Configuration

As above specified, settings.custom file allows you to specify most (but not all) configuration parameters.