Complete NAM Probe backup and restore

Make backup copies of the NAM Probe configuration regularly. Note that a configuration can only be restored for the same NAM Probe version.

Complete backup

Backing up the current NAM Probe configuration requires:

  • An operating, fully configured NAM Probe device.
  • Installed RUM Console and a user with privileges to perform administrative tasks on the listed devices.
  • An external medium or access to another computer that is independent of the NAM Probe device.
Important

The backup procedures described below will not back up your private SSL keys used for OpenSSL decryption.

  • To back up the OpenSSL keys, back up the /usr/adlex/config/keys folder on the NAM Probe.
  • To back up the other SSL keys, refer to the SSL card manufacturer's documentation.

Manual monitoring configuration backup

Log on to the NAM Probe as user root .

Issue the ndstop command on the Linux command line to stop all NAM Probe traffic monitoring services.

Save the existing NAM Probe configuration.

  1. Save the contents of the configuration directory /usr/adlex/config.
  2. Use an appropriate method to save this directory to an external medium or another computer. In this example, the tar command is used to archive the configuration directory and the scp command is used to copy the archive to a remote backup machine.
    [root@NAM Probe ~]# tar -czf  amd_config.tar.gz  /usr/adlex/config/
    
  3. Copy the archive to the remote backup machine: scp amd_config.tar.gz username @backup_machine_IP_address :backup_directory where username is the login name of the user account to use on the remote backup machine, backup_machine_IP_address is the backup machine's IP address, and backup_directory is the directory to which the backup file will be copied.
Important

There are several other ways to back up directories. Regardless of the method you choose, be sure to preserve the user rights for the directory and files that are backed up. This is required because the files located in the config directory have different owners.

Issue the ndstart command on the Linux command line to restart the NAM Probe software.

NAM Probe settings and configuration export

This procedure is designed to export vital NAM Probe settings and monitoring configuration for diagnostic purposes. While it can be used to regularly back up settings and configuration, there is no simple way to restore the information from this type of backup, so it should be used for preserving the NAM Probe configuration snapshot.

Access the RUM Console.

Open RUM Console ► Deployment ► Manage devices.

Click on the NAM Probe you want to back up and select the Export diagnostic information option from the context menu.

Optionally, you can include a fragment of monitored data. Using the begin and end settings, you can specify the time range covered by the included fragment. This option is specifically useful when diagnosing problems related to monitoring data.

Click Download to download a timestamped compressed file containing:

  • NAM Probe boot logs
  • Core dumps
  • Information about the operating system
  • Information about the hardware (memory, CPU, average load, devices, network interfaces)
  • Monitoring configuration (any settings related to software services, licenses and monitoring)
Private data

The exported diagnostic information files DO NOT contain any sensitive information such as SSL keys. For all NAM components you can specify and control any additional information that you wish to export for the particular component such as:

  • Configuration data of that component
  • Data sample used by that component
    Where you can specify the time range of the sample fragment, and where you can apply a RegEx filter to potentially exclude any information that you may deem private.
  • SQL trace logs for the database of that component
  • Installation logs of that component

Complete restore

You should have available the following:

  • Access to media with the backup or a backup computer used to store the saved configuration.
  • Administrator privileges for the NAM Probe device.
  • Knowledge of how the backup was performed, such as which path was saved.

The following example assumes that the configuration directory was archived without including the full path using the tar command.

To restore your backup configuration:

Log on to the NAM Probe as user root.

Issue the ndstop command on the Linux command line to stop the NAM Probe traffic monitoring software.

Restore the NAM Probe configuration from the archive.
Choose the appropriate restoration method, depending on whether you saved the back up to a disc (CD or DVD) or on a remote backup machine.

Important

Regardless of the method used to back up the NAM Probe configuration, be sure to preserve the user rights for the directory and files that you restore. This is required because the files located in the config directory have different owners.

  • If the back up file is on a disc:

    1. Mount the media drive where the back up is stored.
      [root@NAM Probe ~]# mount /dev/cdrom /mnt
      
      If there is no system output, use the mount command to ensure you have access to the backup media. See whether the output includes the path to the media. For example:
      [root@NAM Probe ~]# mount
      /dev/hdc on /mnt type iso9660 (ro)
      
    2. If the backup command included the full path to the config directory, ensure that the working path is a root directory of the NAM Probe device and execute the following command to unpack the archive:
      [root@NAM Probe ~]# cd /usr/adlex/config/
      [root@NAM Probe ~]# tar -xzvf /mnt/amd_config.tar.gz
      
  • If the backup file has been created following the Complete Backup procedure and is located on a remote backup computer:

    1. Copy the configuration saved on the backup machine to the system root on the NAM Probe machine.
      scp username @backup_machine_IP_address :backup_directory amd_config.tar.gz
    2. Unpack the archive.
      [root@NAM Probe ~]# tar -xzvf amd_config.tar.gz
      

Issue the ndstart command on the Linux command line to restart the NAM Probe traffic monitoring software.