Skip to content

Restore Authentication Domain Keys

Before you start

Goal

  • Restore a backup of the Altair SLC Hub authentication domain keys

Prerequisites

  • Internal database has been restored
  • A previously taken backup of authentication domain keys
  • If you are using Windows, you will need to login as a user that is a member of the Administrators group, and the command prompt must be started 'as Administrator'. These steps will permit use of the hubctl command.

Authentication Domain Keys restore procedure

To restore the authentication domain keys, the keys directory is restored from a backup.

To restore a backup, make sure the Hub is stopped. This can be done by running: 

hubctl service stop

Warning

This may cause data loss if you haven't created a backup.

Run the following command to clear the existing keys directory: 

rm -rf [var directory]/data/keys

Run the following command as superuser to preserve ownership and permissions and avoid errors: 

sudo tar --same-owner -xvpf HubAuthDomainKeys.tar [var directory]/data/

Delete the [var directory]\data\keys directory. Now right click on the backup zip file, select Extract all, set the directory to be extracted to as [var directory]\data\ and click Extract.

Verification

Keys Restored

  • Verify the keys have been extracted to the [var directory]\data\keys directory correctly.