Skip to main content
Interania

Admin Guide: Backup and restore a cluster

0votes
14updates
43views

This document outlines the steps for creating a backup of your Interana installation, and then initiating a restore from the backup. Click a link to jump directly to the topic:

Backing up Interana data and metadata

This section covers the recommended processes and procedures to follow when backing up Interana data and metadata.

You do not need to backup the Interana application, as the settings and data are stored outside the running binaries. You can re-install Interana at any time with the Interana debian installer.

Best practices

It is important to adhere to the following practices to ensure the integrity of your Interana data:

  • Take daily snapshots for offline backups, no matter the platform on which Interana runs: AWS, Azure, VMWare, etc.
  • Quiesce the system prior to taking a snapshot to ensure file integrity.
  • Perform a test restoration once per quarter.

Backing up Interana metadata

The Interana cluster uses a MySQL database to store application settings, user accounts, and other Interana metadata. We recommend that you backup of the MySQL database on a regular basis. For details on how to backup a MySQL database, see the MySQL Documentation.

Backing up your Interana data

We recommend that you perform the following backups to ensure the integrity of your Interana data:

Interana data directory backup

Backup the directory that contains your Interana data with scp, rsync, or any standard backup utility or application. By default, the Interana data is located is /var/lib/interana/. However, the directory location on your cluster may be different, depending on site-specific configurations.

To backup your Interana data directory, do the following:

  1. Log into the config node of the cluster.
  2. To verify the location of your Interana data directory, enter the following command.
ps aux | grep [p]rimary_data_tier_path
  1. Log into the node where the Interana data directory is located. 
  2. To start to quiesce the node, stop the Interana processes with the following command.
iactl stop all
  1. To verify the processes have stopped, enter the following command.
 iactl status
  1. To fully quiesce the node, suspend all access to the file system with a utility such as fsfreeze.
  2. Back up the Interana data directory with any standard backup utility or application, then reactivate access to the file system. Utilities such as fsfreeze typically have an option that allows you to restore access to a file system.
  3. Start the Interana services again with the following command.
iactl start all
Node snapshot backups

Take daily snapshots of the following nodes in your cluster with any standard snapshot utility or application:

Data tier nodes String tier nodes
Listener nodes Config node

To take a snapshot of a node, do the following:

  1. Log into the node.
  2. To start to quiesce the node, stop the Interana processes with the following command.
iactl stop all
  1. To verify that the processes have stopped, enter the following command.
 iactl status
  1. To fully quiesce the node, suspend all access to the file system with a utility such as fsfreeze.
  2. Take a snapshot of the node, then reactivate access to the file system. Utilities such as fsfreeze typically have an option that allows you to restore access to a file system.
  3. Start the Interana services again with the following command.
iactl start all

Restoring Interana from a backup

This section outlines the steps to restore Interana data and metadata from a backup. It is recommended that you perform a test restoration once per quarter.

To restore Interana from a backup, do the following:

  1. Verify that all servers have access to their backup files.  
  2. Attach the server backup drive to each system.
  3. To stop the Interana processes, log into each node and enter the following command.
iactl stop all
  1. To verify that the processes have stopped, enter the following command.
 iactl status
  1. Install the previous version of the Interana application, as described in the Admin Guide.
  2. Restore the MySQL database file.  See the MySQL documentation for more details on how to restore MySQL databases.
  3. Restore the imported events into the Interana data directory, as determined in step 2 of the Interana data directory backup procedure. 
  4. To start the Interana service, log into each node and enter the following command.
iactl start all
  • Was this article helpful?