Client Upgrade
To validate the authenticity and integrity of the Debian and the RPMFile format for software package distributed by RPM Package Manager package, see Validating Debian and RPM Packages.
Client Upgrade Quickstart
- Before the upgrade:
- Optionally, run the
ucl diagnose
command. Use its result to compare with theucl diagnose
following the upgrade. - Based on the OS, do the following:
- Without automation (the
install_props.txt
file is missing). - With automation (seeAutomatic Configuration ).
- Uninstall the previous version:
- Upgrade:
RHEL/Centos:
sudo rpm -Uvh ekm-client-<version>.<el7 | el8 | el7+el8>.x86_64.rpm
Fedora:
sudo rpm -Uvh ekm-client-<version>.<el7 | el8 | el7+el8>.x86_64.rpm
SUSE:
sudo zypper update ekm-client-<VERSION>-SuSE.x86_64.rpm
Ubuntu:
sudo dpkg -i ekm-client-<version>.<deb8 | deb9 | deb8+deb9>_amd64.deb
AIX on POWER® CPU:
- Unzip and untar the obtained tar.gz file to the designated directory:
- Add the
<CORE client target directory>
to theLD_LIBRARY_PATH
.
gunzip ekm_client-<VERSION>.aix7.1.tar.gz
tar -vxf ekm_client-<VERSION>.aix7.1.tar -C <CORE client target directory>
MacOS:
You will need
root
,sudo
, orpower
user privileges.- To install, click on the obtained
ekm-client-<VERSION>.pkg
file. It is mandatory to specify the default installation folder. The installation createsubVirtualTokenHost.app
in the/Applications
folder while asserting the signatures and notarization. - Reboot the system.
- To install, click on the obtained
Windows:
ekm-client-<VERSION>.windows.x64.msi
To use the non-interactive
msiexec.exe
option "/qn", you must be running Windows Elevated Privileges (for example, Windows Powershell Admin)msiexec.exe ekm-client-<VERSION>.windows.x64.msi /qn
For other methods to run the non-interactive installation with the elevated privilege, check Elevated Privileges Windows.
- Test by running the
ucl diagnose
command.

The CORE client's software upgrade preserves customization in the /etc/ekm/client.conf
file and uploads the default release-specific sample of it to the client.conf_original
file. Check the CORE Release Notes for possible enhancements and update the client.conf
as needed.
If the install_props.txt
file is present in the same folder as the upgrade software, the client configuration (/etc/ekm/client.conf
) is set according to the specifications in this file.

sudo sh /etc/ekm/uninstall-unbound-client.sh