...
This 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
...
new versions
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".
...
| Meaning | |
|---|---|
| Kiuwan Core | Kiuwan On-Premises itself. This is the image version of your Kiuwan containers (front, analyzer and scheduler nodes). |
| Kiuwan Clients | Kiuwan On-Premises clients. These are the clients provided along with your current Kiuwan On-Premises installation. Sometimes clients may be updated without the need of a full Kiuwan On-Premises upgrade that includes Kiuwan Core. See Upgrading Kiuwan On-Premises (only clients) section for more information. |
| Installed version | This column shows the version name of the current installed versions (both for Kiuwan core and clients). |
| Last available version | This column shows the latest available version of Kiuwan core and clients. |
| Status | When a new version is detected this column will indicate that an upgrade is available. |
| Minimum Kiuwan On-Premises version needed to upgrade clients | If your current Kiuwan Core version is less than this version, new versions of Kiuwan On-Premises clients will not be available for your installation anymore. If you want to upgrade, it is mandatory to perform a full upgrade. See Upgrading Kiuwan On-Premises (full) section for more information. |
Upgrade modes
Upgrade clients
Upgrade full
Upgrade: common steps
Upgrade: common steps
Either you are upgrading only clients or performing a full upgrade, your must follow this steps before continuing.
Step 1: backup your current volumes
Just in case an unexpected error occurs during the upgrade process, it is convenient that your backup all your volumes before proceeding.
Step 2: check clients upgrade bypass configuration
To make sure that your current configuration is not ignoring new available clients, you should check if "kiuwan.clients.update" is set in the following file:
- [VOLUMES_DIR]/config-shared/globalConfig/globalConfig.properties
Locate the key "kiuwan.
...
clients.update" at the end of the file and make sure it is set to true:
| Code Block | ||
|---|---|---|
| ||
kiuwan.clients.update=true |
When the flag is set to true, all Kiuwan clients will be updated as long as a new version is available.
Upgrade: clients only mode
...
Kiuwan On-Premises clients are those Kiuwan products that your Kiuwan On-Premises servers will provide to your users:
...
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 to make your Kiuwan On-Premises servers provide the latest available versions of each client, please follow this guide.
| Note |
|---|
Do not mix up what a Kiuwan On-Premises client version is. These are different concepts: |
...
|
Step 1: backup your current volumes
Please refer to Backup your current volumes section.
Step 2: check
...
clients upgrade bypass configuration
Please refer to Check clients upgrade bypass configuration section.
First of all, make sure your current configuration is not ignoring new available clients. This flag may be set in this file:
- [VOLUMES_DIR]/config-shared/globalConfig/globalConfig.properties
Locate the key "kiuwan.clients.update" at the end of the file and make sure it is set to true:
| Code Block | ||
|---|---|---|
| ||
kiuwan.clients.update=true |
Step 3: check the status of Kiuwan On-Premises infrastructure
...
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.
If you have run any of the provided scripts that stop this infrastructure elements, please make sure you start them before proceding to upgrade.
Step 4: upgrade your Kiuwan On-Premises clients
...
| Code Block | ||
|---|---|---|
| ||
sudo ./update-clients.sh |
Step 5: check your Kiuwan On-Premises clients installations
Please refer to Check your Kiuwan On-Premises clients installations section.
...
Upgrade: full mode
Note that a full upgrade will update your Kiuwan On-Premises clients as well, so there is no need to run the clients upgrade when performing a full upgrade.
...
- Users will not be able to access Kiuwan On-Premises web application.
- Analyses can be still run and will be queued until the new version is available.
Step 1:
...
Please refer to Backup your current volumes section.
Step 1: keep your old kiuwan-cluster installer
Step 2: download kiuwan-cluster latest version
Step 3: check if you need to follow specific steps for your Kiuwan On-Premises version
Step 4: perform the upgrade
Step 5: check your Kiuwan On-Premises clients installations
Please refer to Check your Kiuwan On-Premises clients installations section.
Upgrading Kiuwan On-Premises (common steps)
Backup your current volumes
...
the upgrade
...
...
Checking your Kiuwan On-Premises clients installations after upgrading
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:
...