Web Console backup and restore

Files to Back up

The following table lists all the files you must must back up in this procedure.

File or Directory	Purpose
console-db.backup	PostgreSQL database of the Web Console (contained within the archive)
/var/nexthink/common/*	Web Console general configuration
/var/nexthink/console/backup/<backup file>.tgz	Main backup archive (manual or automatic)
/var/nexthink/console/etc/certificate.pem	TLS certificate used by the Web Console
/var/nexthink/console/etc/custom_salt	Custom cryptographic salt (required for password handling)
/etc/hosts	Custom hostname mappings of the Appliance
/etc/yum/pluginconf.d/proxy.conf	Proxy configuration for YUM

Manual Backup

To manually backup the Web Console:

1. Log into the Appliance Command Line Interface (CLI).

2. Run the following command to create a new backup. Optionally, specify a different name for the backup file without the extension (tgz is automatically added):

   sudo /var/nexthink/console/helpers/backup-console.sh <backup file>

The backup file contains the full database of the Web Console (console-db.backup) and the content of the following files:

• /var/nexthink/common/* (all files in the directory)

• /etc/yum/pluginconf.d/proxy.conf

• /var/nexthink/console/etc/certificate.pem

Find the backup file in the following directory:

/var/nexthink/console/backup

Automatic Backup

Every day at 01:10 an automatic backup is triggered using a crontab entry. Up to 10 backups files are used to keep history, all located in the directory:

/var/nexthink/console/backup

A link file named console-backup.tgz is also created in that directory, pointing to the last backup.

Restoring the Web Console

To completely restore the Web Console settings and account configuration, log into the Appliance shell, get your backup file, and follow the next steps:

1. Stop the Web Console:

   sudo systemctl stop nxconsole

2. Untar your backup file (suppose that it is named console-backup.tgz) in a directory in your home:

   mkdir console-bk
   tar -xvzf console-backup.tgz -C console-bk

3. Copy the configuration files in the backup to their intended location:

   cd console-bk
   sudo cp -R var/nexthink/common/* /var/nexthink/common
   sudo cp etc/yum/pluginconf.d/proxy.conf /etc/yum/pluginconf.d
   sudo cp var/nexthink/console/etc/certificate.pem /var/nexthink/console/etc
   sudo cp var/nexthink/console/etc/custom_salt /var/nexthink/console/etc

4. Drop the database of the Web Console:

   dropdb -U postgres console

5. Drop the console user of the database:

   dropuser -U postgres console

6. Create an empty database: /var/nexthink/console/helpers/create-db.sh

7. Restore the database of the Web Console (console-db.backup file from the backup):

   pg_restore -U postgres -d console console-db.backup

8. Restart the Web Console:

   sudo systemctl start nxconsole

The Web Console is now restored with all its users and settings in place.

The operations described in this article should only be performed by a Nexthink Engineer or a Nexthink Certified Partner.

If you need help or assistance, contact your Nexthink Certified Partner.

---

RELATED TASK

• Logging in to the CLI

RELATED REFERENCE

• Nightly task schedules timetable