Check onboard encryption keys - AFF A220 and FAS2700
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 which version of ONTAP is running on the system.
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 the Synchronize a node with the cluster.
-
Check the status of the impaired controller:
-
If the impaired controller is at the login prompt, log in as
admin
. -
If the impaired controller is at the LOADER prompt and is part of HA configuration, log in as
admin
on the healthy controller. -
If the impaired controller is in a standalone configuration and at LOADER prompt, contact mysupport.netapp.com.
-
-
If AutoSupport is enabled, suppress automatic case creation by invoking an AutoSupport message:
system node autosupport invoke -node * -type all -message MAINT=number_of_hours_downh
The following AutoSupport message suppresses automatic case creation for two hours:
cluster1:*> system node autosupport invoke -node * -type all -message MAINT=2h
-
Check the version of ONTAP the system is running on the impaired controller if up, or on the partner controller if the impaired controller is down, using the
version -v
command:-
If <lno-DARE> or <1Ono-DARE> is displayed in the command output, the system does not support NVE, proceed to shut down the controller.
-
If <lno-DARE> is not displayed in the command output, and the system is running ONTAP 9.5, go to Option 1: Check NVE or NSE on systems running ONTAP 9.5 and earlier.
-
If <lno-DARE> is not displayed in the command output, and the system is running ONTAP 9.6 or later, go to Option 2: Check NVE or NSE on systems running ONTAP 9.6 and later.
-
-
If the impaired controller is part of an HA configuration, disable automatic giveback from the healthy controller:
storage failover modify -node local -auto-giveback false
orstorage failover modify -node local -auto-giveback-after-panic false
Option 1: Check NVE or NSE on systems running ONTAP 9.5 and earlier
Before shutting down the impaired controller, you need to check whether the system has either NetApp Volume Encryption (NVE) or NetApp Storage Encryption (NSE) enabled. If so, you need to verify the configuration.
-
Connect the console cable to the impaired controller.
-
Check whether NVE is configured for any volumes in the cluster:
volume show -is-encrypted true
If any volumes are listed in the output, NVE is configured and you need to verify the NVE configuration. If no volumes are listed, check whether NSE is configured.
-
Check whether NSE is configured:
storage encryption disk show
-
If the command output lists the drive details with Mode & Key ID information, NSE is configured and you need to verify the NSE configuration.
-
If NVE and NSE are not configured, it's safe to shut down the impaired controller.
-
Verify NVE configuration
-
Display the key IDs of the authentication keys that are stored on the key management servers:
security key-manager query
-
If the
Restored
column displaysyes
and all key managers displayavailable
, it's safe to shut down the impaired controller. -
If the
Restored
column displays anything other thanyes
, or if any key manager displaysunavailable
, you need to complete some additional steps. -
If you see the message This command is not supported when onboard key management is enabled, you need to complete some other additional steps.
-
-
If the
Restored
column displayed anything other thanyes
, or if any key manager displayedunavailable
:-
Retrieve and restore all authentication keys and associated key IDs:
security key-manager restore -address *
If the command fails, contact NetApp Support.
-
Verify that the
Restored
column displaysyes
for all authentication keys and that all key managers displayavailable
:security key-manager query
-
Shut down the impaired controller.
-
-
If you saw the message This command is not supported when onboard key management is enabled, display the keys stored in the onboard key manager:
security key-manager key show -detail
-
If the
Restored
column displaysyes
manually back up the onboard key management information:-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the OKM backup information:
security key-manager backup show
-
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.
-
Return to admin mode:
set -priv admin
-
Shut down the impaired controller.
-
-
If the
Restored
column displays anything other thanyes
:-
Run the key-manager setup wizard:
security key-manager setup -node target/impaired node name
Enter the customer's onboard key management passphrase at the prompt. If the passphrase cannot be provided, contact mysupport.netapp.com -
Verify that the
Restored
column displaysyes
for all authentication key:security key-manager key show -detail
-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the OKM backup information:
security key-manager backup show
-
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.
-
Return to admin mode:
set -priv admin
-
You can safely shutdown the controller.
-
-
Verify NSE configuration
-
Display the key IDs of the authentication keys that are stored on the key management servers:
security key-manager query
-
If the
Restored
column displaysyes
and all key managers displayavailable
, it's safe to shut down the impaired controller. -
If the
Restored
column displays anything other thanyes
, or if any key manager displaysunavailable
, you need to complete some additional steps. -
If you see the message This command is not supported when onboard key management is enabled, you need to complete some other additional steps
-
-
If the
Restored
column displayed anything other thanyes
, or if any key manager displayedunavailable
:-
Retrieve and restore all authentication keys and associated key IDs:
security key-manager restore -address *
If the command fails, contact NetApp Support.
-
Verify that the
Restored
column displaysyes
for all authentication keys and that all key managers displayavailable
:security key-manager query
-
Shut down the impaired controller.
-
-
If you saw the message This command is not supported when onboard key management is enabled, display the keys stored in the onboard key manager:
security key-manager key show -detail
-
If the
Restored
column displaysyes
, manually back up the onboard key management information:-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the OKM backup information:
security key-manager backup show
-
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.
-
Return to admin mode:
set -priv admin
-
Shut down the impaired controller.
-
-
If the
Restored
column displays anything other thanyes
:-
Run the key-manager setup wizard:
security key-manager setup -node target/impaired node name
Enter the customer's OKM passphrase at the prompt. If the passphrase cannot be provided, contact mysupport.netapp.com -
Verify that the
Restored
column showsyes
for all authentication keys:security key-manager key show -detail
-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to back up the OKM information:
security key-manager backup show
Make sure that OKM information is saved in your log file. This information will be needed in disaster scenarios where OKM might need to be manually recovered. -
Copy the contents of the backup information to a separate file or your log. You'll need it in disaster scenarios where you might need to manually recover OKM.
-
Return to admin mode:
set -priv admin
-
You can safely shut down the controller.
-
-
Option 2: Check NVE or NSE on systems running ONTAP 9.6 and later
Before shutting down the impaired controller, you need to verify whether the system has either NetApp Volume Encryption (NVE) or NetApp Storage Encryption (NSE) enabled. If so, you need to verify the configuration.
-
Verify whether NVE is in use for any volumes in the cluster:
volume show -is-encrypted true
If any volumes are listed in the output, NVE is configured and you need to verify the NVE configuration. If no volumes are listed, check whether NSE is configured and in use.
-
Verify whether NSE is configured and in use:
storage encryption disk show
-
If the command output lists the drive details with Mode & Key ID information, NSE is configured and you need to verify the NSE configuration and in use.
-
If no disks are shown, NSE is not configured.
-
If NVE and NSE are not configured, no drives are protected with NSE keys, it's safe to shut down the impaired controller.
-
Verify NVE configuration
-
Display the key IDs of the authentication keys that are stored on the key management servers:
security key-manager key query
After the ONTAP 9.6 release, you may have additional key manager types. The types are KMIP
,AKV
, andGCP
. The process for confirming these types is the same as confirmingexternal
oronboard
key manager types.-
If the
Key Manager
type displaysexternal
and theRestored
column displaysyes
, it's safe to shut down the impaired controller. -
If the
Key Manager
type displaysonboard
and theRestored
column displaysyes
, you need to complete some additional steps. -
If the
Key Manager
type displaysexternal
and theRestored
column displays anything other thanyes
, you need to complete some additional steps. -
If the
Key Manager
type displaysonboard
and theRestored
column displays anything other thanyes
, you need to complete some additional steps.
-
-
If the
Key Manager
type displaysonboard
and theRestored
column displaysyes
, manually back up the OKM information:-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the key management information:
security key-manager onboard show-backup
-
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.
-
Return to admin mode:
set -priv admin
-
Shut down the impaired controller.
-
-
If the
Key Manager
type displaysexternal
and theRestored
column displays anything other thanyes
:-
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.
-
Verify that the
Restored
column equalsyes
for all authentication keys:security key-manager key query
-
Shut down the impaired controller.
-
-
If the
Key Manager
type displaysonboard
and theRestored
column displays anything other thanyes
:-
Enter the onboard security key-manager sync command:
security key-manager onboard sync
Enter the customer's 32 character, alphanumeric onboard key management passphrase at the prompt. If the passphrase cannot be provided, contact NetApp Support. mysupport.netapp.com -
Verify the
Restored
column showsyes
for all authentication keys:security key-manager key query
-
Verify that the
Key Manager
type showsonboard
, and then manually back up the OKM information. -
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the key management backup information:
security key-manager onboard show-backup
-
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.
-
Return to admin mode:
set -priv admin
-
You can safely shut down the controller.
-
Verify NSE configuration
-
Display the key IDs of the authentication keys that are stored on the key management servers:
security key-manager key query -key-type NSE-AK
After the ONTAP 9.6 release, you may have additional key manager types. The types are KMIP
,AKV
, andGCP
. The process for confirming these types is the same as confirmingexternal
oronboard
key manager types.-
If the
Key Manager
type displaysexternal
and theRestored
column displaysyes
, it's safe to shut down the impaired controller. -
If the
Key Manager
type displaysonboard
and theRestored
column displaysyes
, you need to complete some additional steps. -
If the
Key Manager
type displaysexternal
and theRestored
column displays anything other thanyes
, you need to complete some additional steps. -
If the
Key Manager
type displaysexternal
and theRestored
column displays anything other thanyes
, you need to complete some additional steps.
-
-
If the
Key Manager
type displaysonboard
and theRestored
column displaysyes
, manually back up the OKM information:-
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the key management information:
security key-manager onboard show-backup
-
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.
-
Return to admin mode:
set -priv admin
-
You can safely shut down the controller.
-
-
If the
Key Manager
type displaysexternal
and theRestored
column displays anything other thanyes
:-
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.
-
Verify that the
Restored
column equalsyes
for all authentication keys:security key-manager key query
-
You can safely shut down the controller.
-
-
If the
Key Manager
type displaysonboard
and theRestored
column displays anything other thanyes
:-
Enter the onboard security key-manager sync command:
security key-manager onboard sync
Enter the customer's 32 character, alphanumeric onboard key management passphrase at the prompt. If the passphrase cannot be provided, contact NetApp Support.
-
Verify the
Restored
column showsyes
for all authentication keys:security key-manager key query
-
Verify that the
Key Manager
type showsonboard
, and then manually back up the OKM information. -
Go to advanced privilege mode and enter
y
when prompted to continue:set -priv advanced
-
Enter the command to display the key management backup information:
security key-manager onboard show-backup
-
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.
-
Return to admin mode:
set -priv admin
-
You can safely shut down the controller.
-