...
| 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:
...
| Note |
|---|
Do not mix up what a Kiuwan On-Premises client version is. These are different concepts:
|
Clients only mode
You can choose to upgrade only Kiuwan On-Premises clients as long as their latest versions are compatible with your currently installed Kiuwan core.
Full mode
You can choose to upgrade only Kiuwan On-Premises clients as long as their latest versions are compatible with your currently installed Kiuwan core.
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
Please refer to Backup your current volumes sectionJust 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 availablePlease refer to Check clients upgrade bypass configuration section.
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:
- MySQL
- Redis cluster
If you have run any of the provided scripts that stop this infrastructure elements, please make sure you start them before proceding to upgrade.
Upgrade: clients only mode
Note 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 , but make sure you have run any of the provided scripts that stop this infrastructure elements, please make sure you start them before proceding to upgradechecked the Step 3 of the common steps before proceeding.
Step
...
1: upgrade your Kiuwan On-Premises clients
Open a terminal to the host where you downloaded and run the kiuwan-cluster tool to install Kiuwan On-Premises and change the directory to where the tool was untared (this directory is referred as [INSTALLER_DIR] in the Kiuwan On-Premises Distributed Installation Guide). Once the current directory is [INSTALL_DIR], execute this command:
...