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:
Once downloaded you should untar the provided gz file:
tar xvzpf kiuwan-cluster_master.tar.gz
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:
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:
You can download it by executing this command:
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.