Skip to main content

recoverinvariants

This utility is used with all ArcGIS Data Store types.

If the primary encryption key used by ArcGIS Data Store to encrypt and decrypt information becomes corrupted, use the recoverinvariants utility and a recovery codes file to regenerate the primary encryption key.

ArcGIS Enterprise generates the recovery codes file when you configure or upgrade the deployment.

Syntax

recoverinvariants --recoveryCodesFile <name and path to recovery codes file> --force

Option

Description

--recoveryCodesFile

Specify the path to and the name of the recovery codes file. See Manage encryption keys for information about these files and how they are used.

--force

You can use the --force option to overwrite an existing recovery codes file.

This option is only enforced if the file to be overwritten has the same name as the existing recovery codes file in the ArcGIS Data Store framework directory.

Examples

In this example, a copy of the recovery codes file that was stored in a secure, remote location is used to replace the local file that was deleted:

./recoverinvariants.sh --recoveryCodesFile /net/server1/recovery_codes.txt

In this example, a copy of the recovery codes file that was stored in a secure, remote location is used to replace the local file that was deleted:

recoverinvariants --recoveryCodesFile '\\server1\vault\recovery_codes.txt'

In this example, the default recovery codes file is overwritten with one generated for other ArcGIS Enterprise components:

./recoverinvariants.sh --recoveryCodesFile /usr/myfiles/recovery_codes.txt --force

In this example, the default recovery codes file is overwritten with one generated for other ArcGIS Enterprise components:

recoverinvariants --recoveryCodesFile C:\myfiles\recovery_codes.txt --force