...
This table summarizes the meaning of the information shown in the previous screenshot:
| 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. |
Upgrading Kiuwan On-Premises (only clients)
Kiuwan On-Premises clients are those Kiuwan products that your Kiuwan On-Premises servers will provide to your users:
- Kiuwan Local Analyzer
- Kiuwan Engine
- Kiuwan for developers IDE plugins or extensions (Eclipse, JetBrains, Visual Studio and Visual Studio Code).
There are more Kiuwan clients that you may need to upgrade, but are provided by external sources and you should follow the standard upgrade procedure of their platform:
- Kiuwan Jenkins plugin: downloadable from the Jenkins plugin repository.
- Kiuwan Microsoft TFS Azure extension: downloadable through the Azure DevOps marketplace.
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 these stepsthis guide.
...
Do not mix up what a Kiuwan On-Premises client version is. These are different concepts:
| Note |
|---|
|
Step 1: backup your current volumes
Please refer to Backup your current volumes section.
Step 2: check your current configuration
First of all, make sure your current configuration is not ignoring new available clients. This flag may be set in this file:
...
| Code Block | ||
|---|---|---|
| ||
kiuwan.clients.update=true |
Step
...
3: 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:
...
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
...
4: upgrade your Kiuwan On-Premises clients
Open a terminal to the host where you downloaded and run the kiuwan-client cluster tool to install Kiuwan On-Premises , and change the directory to where the tool was untared (this directory is referred as [INSTALLER_DIR] ) and in the Kiuwan On-Premises Distributed Installation Guide). Once the current directory is [INSTALL_DIR], execute this command:
| 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.
...
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.
This process will stop all Kiuwan services. This means that during the upgrade process:
- 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: backup your volumes
Please refer to Backup your current volumes section.
Step 1: keep your old kiuwan-cluster installer
...
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
Just in case an unexpected error occurs during the upgrade process, it is convenient that your backup all your volumes before proceeding.
Check your Kiuwan On-Premises clients installations
...