PingAccess

Restoring PingAccess using a JSON file

Restore your PingAccess using a JavaScript Object Notation (JSON) file.

About this task

The Import Configuration option is a version-specific tool for importing a previously exported configuration. PingAccess checks the exported JSON file to ensure that the file is not from a later version of PingAccess and is compatible with application programming interface (API) v3 (PingAccess 5.0 or later).

This operation is destructive and overwrites any existing PingAccess configuration.

Large PingAccess configurations can take several hours to import. During an import, you cannot modify or read the PingAccess configuration.

To restore your PingAccess using a JSON file:

Steps

  1. If you are restoring on a new environment, copy the saved pa.jwk file to the <PA_Home>/conf/ directory.

  2. Click Settings and then go to System → Configuration Export/Import.

  3. Click Import Configuration and select the local file you want to use.

  4. Click Import.

  5. Click Confirm and make any changes indicated by the import process.

    Troubleshooting:

    If the import fails, click View failures from last import to view all of the errors logged during the import.

  6. If the Agent or Admin listener key pairs change as a result of the import operation, restart PingAccess.

  7. If the environment is clustered, ensure that the replica administrative node and engine nodes are using the proper engine keys, and if they aren’t, re-save them to generate a new public key, and reconfigure them to use the newly generated key.

    For more information, see Clustering in PingAccess.