Versions Compared

Key

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

...

This page will guide you through the process of migrating from a Kiuwan on On-Premises single-container installation carried out with the deprecated installation tool docker-for-kiuwan.

...

Once the upgrade is completed, you should see this versions in the KOP system administration console:

 
 

Step 2: stop old Kiuwan

...

On-Premises server

First, make sure there are no running analysis before stopping the application server. You can check this in the sysadmin console:

  1. Log in your old Kiuwan on premise On-Premises with sysadmin user.
  2. Access the Queues option in the upper right dropdown menu.
  3. Click on the "Active analyses" button and check if the table shows any running or pending analysis.

...

To stop the running Kiuwan and prevent creating more data before backuping it up, run this commands in the Kiuwan on On-Premises host.

Code Block
languagebash
docker exec -it [kiuwan_on_premise_container_name] /bin/bash
supervisorctl stop wildfly
exit

...

  • $DIR_PERSISTENT_VOLUME/$KIUWAN_HOST/KiuwanCentralWorkingDirectory
  • $DIR_PERSISTENT_VOLUME/$KIUWAN_HOST/repos/kiuwanSourceCodeRepository

Step 4: install a new Kiuwan

...

On-Premises using the new installer tool (kiuwan-cluster)

Follow the steps provided in Kiuwan On-Premises Installation Guide to prepare your Kiuwan on On-Premises new installation but do NOT perform the installation step (that may be executing install.sh or other scripts depending on your installation needs).

...

If it is mandatory for you to use the same machine to install the new Kiuwan on premiseOn-Premises, please make sure no persistent volume paths collide.

...

  1. KiuwanCentralWorkingDirectory should be copied to [VOLUMES_DIR]/data-shared/repos/kiuwanCentralRepository 
  2. kiuwanSourceCodeRepository should be copied to [VOLUMES_DIR]/data-shared/repos/kiuwanSourceCodeRepository 

Step 6: start new Kiuwan

...

On-Premises infrastructure

Execute these commands to create and start the new Kiuwan on On-Premises infrastructure:

Code Block
languagebash
cd [INSTALL_DIR]/docker
sudo ./create-network.sh
sudo ./install-infrastructure.sh
sudo ./start-infrastructure.sh

...

This last step forces Kiuwan on premises On-Premises to be updated to the current version (the one tied to the used kiuwan-cluster distribution). Execute in your new Kiuwan host console:

...

Step 9: check your data and discard the old installation

Once Kiuwan on premises On-Premises servers are up, you can access your new installation using the same users and passwords and all previous data will be there.

...