Client Upgrade

To validate the authenticity and integrity of the Debian and the RPMClosedFile format for software package distributed by RPM Package Manager package, refer to Validating Debian and RPM Packages.

Client Upgrade Quickstart

  1. Before the upgrade:
    1. Optionally, run the ucl diagnose command. Use its result to compare with the ucl diagnose following the upgrade.
    2. Based on the OS, do the following:

    • Without automation (the install_props.txt file is missing).

      • 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.

    • With automation (refer to Automatic Configuration ).

      • 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.

    • Uninstall the previous version:

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

  2. Upgrade:

    • sudo rpm -Uvh ekm-client-<version>.<el7 | el8 | el7+el8>.x86_64.rpm

    • sudo rpm -Uvh ekm-client-<version>.<el7 | el8 | el7+el8>.x86_64.rpm

    • sudo zypper update ekm-client-<VERSION>-SuSE.x86_64.rpm

    • sudo dpkg -i ekm-client-<version>.<deb8 | deb9 | deb8+deb9>_amd64.deb

      1. Unzip and untar the obtained tar.gz file to the designated directory:

        2. gunzip ekm_client-<VERSION>.aix7.1.tar.gz

        tar -vxf ekm_client-<VERSION>.aix7.1.tar -C <CORE client target directory>

      2. Add the <CORE client target directory> to the LD_LIBRARY_PATH.

    • You will need root, sudo, or power user privileges.

      1. To install, click on the obtained ekm-client-<VERSION>.pkg file. It is mandatory to specify the default installation folder. The installation creates ubVirtualTokenHost.app in the /Applications folder while asserting the signatures and notarization.
      2. Reboot the system.

    • 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.

  3. Test by running the ucl diagnose command.