Upgrading Cloudera Navigator HSM KMS

Upgrading HSM KMS Using Parcels

For customers using the Thales HSM KMS, do not use these upgrade steps. Instead, use Upgrading 5.x to 6.x Parcels for Thales HSM KMS.

To upgrade an HSM KMS using parcels:

  1. Go to Hosts > Parcels.
  2. Click Configuration and add your internal repository to the Remote Parcel Repository URLs section. See Configuring Cloudera Manager to Use an Internal Remote Parcel Repository for more information.
  3. Click Save Changes.
  4. Download, distribute, and activate the KEYTRUSTEE parcel for the version to which you are upgrading. See Overview of Parcels for detailed instructions on using parcels to install or upgrade components.
  5. Restart the HSM KMS service (HSM KMS service > Actions > Restart).

Upgrading 5.x to 6.x Parcels for Thales HSM KMS

To upgrade 5.x to 6.x parcels for Thales HSM KMS:

  1. Go to Hosts > Parcels.
  2. Click Configuration and add your internal repository to the Remote Parcel Repository URLs section. See Configuring Cloudera Manager to Use an Internal Remote Parcel Repository for more information.
  3. Click Save Changes.
  4. Download, distribute, and activate the KEYTRUSTEE parcel for the version to which you are upgrading. See Overview of Parcels for detailed instructions on using parcels to install or upgrade components.
  5. If the Thales HSM KMS already exists, then before upgrading to Cloudera Manager 6.0.0, you must change the privileged Thales HSM KMS port; the recommended port is 11501. The non-privileged port default is 9000, and does not need to be changed.
    To change the privileged port, log into the Thales HSM KMS machine(s), and run the following commands:
    # sudo /opt/nfast/bin/config-serverstartup --enable-tcp --enable-privileged-tcp --privport=11501
    [server_settings] change successful; you must restart the hardserver for this to take effect
    # sudo /opt/nfast/sbin/init.d-ncipher restart
     -- Running shutdown script 90ncsnmpd
    
     -- Running shutdown script 60raserv
    
    ...
    
    'ncsnmpd' server now running
  6. Restart the HSM KMS service (HSM KMS service > Actions > Restart).

Upgrading HSM KMS Using Packages

For customers using the Thales HSM KMS, do not use these upgrade steps. Instead, use Upgrading 5.x to 6.x Packages for Thales HSM KMS.

To upgrade an HSM KMS using packages:

  1. After Setting Up an Internal Repository, configure the HSM KMS host to use the repository. See Configuring Hosts to Use the Internal Repository for more information.
  2. Add the CDH repository. See Setting Up an Internal Repository for instructions. If you want to create an internal CDH repository, see Configuring a Local Package Repository.
  3. Upgrade the keytrustee-keyprovider package using the appropriate command for your operating system:
    • RHEL-compatible
      sudo yum install keytrustee-keyprovider
    • SLES
      sudo zypper install keytrustee-keyprovider
    • Ubuntu or Debian
      sudo apt-get install keytrustee-keyprovider
  4. Restart the HSM KMS service (HSM KMS service > Actions > Restart).

Upgrading 5.x to 6.x Packages for Thales HSM KMS

To upgrade 5.x to 6.x packages for Thales HSM KMS:

  1. After Setting Up an Internal Repository, configure the HSM KMS host to use the repository. See Configuring Hosts to Use the Internal Repository for more information.
  2. Add the CDH repository. See Setting Up an Internal Repository for instructions. If you want to create an internal CDH repository, see Configuring a Local Package Repository.
  3. Upgrade the keytrustee-keyprovider package using the appropriate command for your operating system:
    • RHEL-compatible
      sudo yum install keytrustee-keyprovider
    • SLES
      sudo zypper install keytrustee-keyprovider
    • Ubuntu or Debian
      sudo apt-get install keytrustee-keyprovider
  4. If the Thales HSM KMS already exists, then before upgrading to Cloudera Manager 6.0.0, you must change the privileged Thales HSM KMS port; the recommended port is 11501. The non-privileged port default is 9000, and does not need to be changed.
    To change the privileged port, log into the Thales HSM KMS machine(s), and run the following commands:
    # sudo /opt/nfast/bin/config-serverstartup --enable-tcp --enable-privileged-tcp --privport=11501
    [server_settings] change successful; you must restart the hardserver for this to take effect
    # sudo /opt/nfast/sbin/init.d-ncipher restart
     -- Running shutdown script 90ncsnmpd
    
     -- Running shutdown script 60raserv
    
    ...
    
    'ncsnmpd' server now running
  5. Restart the HSM KMS service (HSM KMS service > Actions > Restart).