Versions Compared

Key

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

Introduction

IntroThis page provides information on how to upgrade a Kiuwan On-Premises Distributed installation. Note that this guide only applies to Kiuwan On-Premises installations distributed installations done using the kiuwan-cluster tool.

Checking for updates

Currently installed versions and latest available versions of Kiuwan On-Premises are shown in the System Administration Console. To access this page, log into your Kiuwan On-Premises installation as "sysadmin".

...

Sometimes new versions of Kiuwan clients are published to fix bugs or include new features. If new versions of Kiuwan On-Premises clients are available and you want to upgrade your installation, please follow these steps.

Note

Please do not mix up what a Kiuwan On-Premises client version is. These are different concepts:

  • Client versions stored in your Kiuwan On-Premises servers: these are the versions that your Kiuwan On-Premises server provides to be downloaded and installed on your CI systems, development computers, etc. This versions are those shown in the System Administration Console.
  • Client versions installed in your company's laptops, CI systems, etc.: these are the versions that were installed after your first Kiuwan On-Premises installation. Once you upgrade your installation client versions, your company's computers may have old versions of Kiuwan On-Premises clients. The following steps address how to upgrade these as well.

Step 1: check your current configuration

...

Code Block
languagejava
kiuwan.clients.update=true

Step 2: check the status of Kiuwan On-Premises infrastructure

To upgrade Kiuwan On-Premises clients it is mandatory that at least these elements of the provided infrastructure are up and running:

  • MySQL
  • Redis cluster

Note that this is the minimum needed for the update to run, there are no restrictions to Kiuwan services. This means that it is safe to update Kiuwan On-Premises clients WITHOUT stopping any of the provided services or containers.

Step 3: upgrade your Kiuwan On-Premises clients

Open a terminal to the host where you downloaded and run kiuwan-client to install Kiuwan On-Premises, change the directory where the tool was untared ([INSTALLER_DIR]) and execute this command:

Code Block
languagebash
sudo ./update-clients.sh

Step

...

4: check your Kiuwan On-Premises clients installations

Once the update process is finished, all the published clients in your Kiuwan On-Premises installation will be ready to be downloaded. Check the specific client guide to see how to upgrade each client installation:

Upgrading Kiuwan On-Premises (full)

...