Restoring the audit log on the recovered non-primary Admin Node

If you were able to preserve the audit log from the failed non-primary Admin Node, so that historical audit log information is retained, you can copy it to the non-primary Admin Node you are recovering.

Before you begin

About this task

If an Admin Node fails, audit logs saved to that Admin Node are potentially lost. It might be possible to preserve data from loss by copying audit logs from the failed Admin Node and then restoring these audit logs to the recovered Admin Node. Depending on the failure, it might not be possible to copy audit logs from the failed Admin Node. In that case, if the deployment has more than one Admin Node, you can recover audit logs from another Admin Node as audit logs are replicated to all Admin Nodes.

If there is only one Admin Node and the audit log cannot be copied from the failed node, the recovered Admin Node starts recording events to the audit log as if the installation is new.

You must recover an Admin Node as soon as possible to restore logging functionality.


  1. From the service laptop, log in to the recovered Admin Node:
    1. Enter the following command: ssh admin@recovery_Admin_Node_IP
    2. Enter the password listed in the Passwords.txt file.
    3. Enter the following command to switch to root: su -
    4. Enter the password listed in the Passwords.txt file.
    After you are logged in as root, the prompt changes from $ to #.
  2. Check which audit files have been preserved: cd /var/local/audit/export
  3. Copy the preserved audit log files to the recovered Admin Node: scp admin@grid_node_IP:/var/local/tmp/saved-audit-logs/YYYY* .
    When prompted, enter the password for admin.
  4. For security, delete the audit logs from the failed grid node after verifying that they have been copied successfully to the recovered Admin Node.
  5. Update the user and group settings of the audit log files on the recovered Admin Node: chown ams-user:bycast *
  6. Log out as root: exit

After you finish

You must also restore any pre-existing client access to the audit share. For more information, see the instructions for administering StorageGRID.