Before You Begin

Use the following instructions to backup and restore HelpSystems Insite 3.0 or above on the same system. To backup or restore on Insite installations before 3.00, see Backing Up and Restoring HelpSystems Insite 2.x and 1.x.

Backing Up and Restoring HelpSystems Insite 3.00+

There are two executables used to backup and restore HelpSystems Insite (backup/.exe and restore/.exe). Both files reside in the HelpSystems Insite root directory on the server.

Environment Location
Windows C:\Program Files\Help Systems\HelpSystems Insite\
Linux (Root install) /opt/insite/{backup|restore}database.sh
Linux (User install) {USER_HOME}/insite/{backup|restore}database.sh

Note: In order to use these scripts, the database service must be running.

Backing Up HelpSystems Insite

To back up the database, run the following command:

  • Windows: backup.exe
  • Linux: ./backup

This command creates two backup files that are named:

     insite_db_3_00_<timestamp>.backup (database backup)

     integration_config_<timestamp>.zip (IIS config backup)

The command puts the backup files in the root directory of the product.

Note: If you are backing up Insite in preparation for an upgrade, be sure to copy the backup file to a location outside the product directories.

Restoring HelpSystems Insite

Notes:

  • We highly recommend that you stop the HelpSystems Insite Server service and the HelpSystems Insite Analytics Service before performing a restore.
  • The database service (HelpSystemsDatabaseServer) must be running.
  • You must be at the same Insite version as the backup that you are trying to restore. For example, you cannot restore a 2.4 backup over a 2.6 installation.

To restore the database, run the following command (it's also found in the HelpSystems Insite root directory):

  • Windows: restoredatabase.bat
  • Linux: ./restoredatabase.sh

This command takes a backup file created by the backup command and restores it to the database.

The file path is passed to the script.

Command example:

(Windows) restoredatabase.bat insite_db_3_00_<timestamp>.backup

(Linux) ./restoredatabase.sh -f insite_db_3_00_20190313115154.backup

 

To restore the IIS config, run the following command (it's also found in the HelpSystems Insite root directory):

  • Windows: restore.exe
  • UNIX/Linux: restore

This command takes a zip file created by the backup command and restores it.

The file path is passed to the command.

Command example:

restore -i integration_config_<timestamp>.zip


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: November 20, 2019