Skip to main content
Install and maintain

Check onboard encryption keys - AFF A70, AFF A90

Contributors dougthomp
PDFs

Prior to shutting down the impaired controller and checking the status of the onboard encryption keys, you must check the status of the impaired controller, disable automatic giveback, and check the version of ONTAP that is running.

If you have a cluster with more than two nodes, it must be in quorum. If the cluster is not in quorum or a healthy controller shows false for eligibility and health, you must correct the issue before shutting down the impaired controller; see Synchronize a node with the cluster.

Check NVE or NSE on systems running ONTAP 9.15 and later

Before shutting down the impaired controller, you need to verify whether the system has security key manager enabled or encrypted disks.

Verify security key-manager configuration

Steps

  1. Determe if Key Manager is active with the security key-manager keystore show command. For more information, see the security key-manager keystore show MAN page

    Note You may have additional key manager types. The types are KMIP, AKV, and GCP. The process for confirming these types is the same as confirming external or onboard key manager types.

    • If no output is displayed, go to shutdown the impaired controller to shutdown the impaired node.

    • If the command displays output, the system has security key-manager active and you need to display the Key Manager type and status.

  2. Display the information for the active Key Manager using the security key-manager key query command.

    • If the Key Manager type displays external and the Restored column displays true, it's safe to shut down the impaired controller.

    • If the Key Manager type displays onboard and the Restored column displays true, you need to complete some additional steps.

    • If the Key Manager type displays external and the Restored column displays anything other than true, you need to complete some additional steps.

    • If the Key Manager type displays onboard and the Restored column displays anything other than true, you need to complete some additional steps.

  3. If the Key Manager type displays onboard and the Restored column displays true, manually back up the OKM information:

    1. Enter y when prompted to continue: set -priv advanced

    2. Enter the command to display the key management information: security key-manager onboard show-backup

    3. Copy the contents of the backup information to a separate file or your log file. You'll need it in disaster scenarios where you might need to manually recover OKM.

    4. You can safely shut down the impaired controller.

  4. If the Key Manager type displays onboard and the Restored column displays anything other than true:

    1. Enter the onboard security key-manager sync command: security key-manager onboard sync

      Note Enter the 32 character, alphanumeric onboard key management passphrase at the prompt. If the passphrase cannot be provided, contact NetApp Support. mysupport.netapp.com

    2. Verify the Restored column displays true for all authentication keys: security key-manager key query

    3. Verify that the Key Manager type displays onboard, and then manually back up the OKM information.

    4. Enter the command to display the key management backup information: security key-manager onboard show-backup

    5. Copy the contents of the backup information to a separate file or your log file. You'll need it in disaster scenarios where you might need to manually recover OKM.

    6. You can safely shut down the controller.

  5. If the Key Manager type displays external and the Restored column displays anything other than true:

    1. Restore the external key management authentication keys to all nodes in the cluster: security key-manager external restore

      If the command fails, contact NetApp Support at mysupport.netapp.com.

    2. Verify that the Restored column displays true for all authentication keys: security key-manager key query

    3. You can safely shut down the impaired controller.