Restore backup

 

Note: There is a known bug with version 4.4.1917.33 of ISL Conference Proxy where backup will fail to restore if version of the backup and current ICP are the same. In newer versions the backup is restored correctly, if you are experiencing issues please upgrade the ICP to a newer version or visit our support and we will provide you with a workaround.

Please follow the steps below to restore ISL Conference Proxy from an existing backup. Make sure to transfer the backup files to the machine where you intend to perform the restore before proceeding.


Step 1

Windows

  1. Download the latest ISL Conference Proxy installer (please choose 32-bit or 64-bit version, depending on your operating system). Most machines nowadays are 64-bit, so the examples will include the 64-bit version in sample commands, modify accordingly in case of 32-bits.
  2. Run the ISL Conference Proxy installer and follow the installation wizard. When prompted, enter the path to the appropriate location where you placed the backup files in your case, make sure you read the important note below.

Important note

It is crucial that the full path of the location where you placed the backup files is accessible and readable by ISL Conference Proxy which is running as user islcp (and not as administrator or local system account). Based on this we suggest using a directory on top level (such as C:\icp-backup) and adjusting its permissions appropriately.

Apart from that, the provided location must include the appropriate backup directory marker (a file called _islcp_backupdir_). If you only have the .gz files and files with the checksums of those .gz files, you can use the echo command to create the backup directory marker, e.g.:

echo . > C:\icp-backup\_islcp_backupdir_


Linux

  1. Download the latest ISL Conference Proxy installer (please choose 32-bit or 64-bit version, depending on your operating system). Most machines nowadays are 64-bit, so the examples will include the 64-bit version in sample commands, modify accordingly in case of 32-bits.
  2. Login as root and install ISL Conference Proxy (replace /icpbackup with the appropriate location where you placed the backup files in your case, make sure you read the important note below):
    sh installer_latest_linux64 restorebackup /icpbackup

Important note

It is crucial that the full path of the location where you placed the backup files is accessible and readable by ISL Conference Proxy which is running as user islcp (and not as root). Based on this we suggest using a directory on top level (such as /icpbackup) and adjusting its permissions appropriately.

Apart from that, the provided location must include the appropriate backup directory marker (a file called _islcp_backupdir_). If you only have the .gz files and files with the checksums of those .gz files, you can use the touch command to create the backup directory marker, e.g.:

touch /icpbackup/_islcp_backupdir_


Step 2

After installer has finished, login to your ISL Conference Proxy administration (<icp_server_address>/conf) and click on "Online update".


Step 3

Click on "Restore".


Step 4

Click on "Restart ISL Conference Proxy" to finish the restore procedure.


Step 5

After ISL Conference Proxy is back up and running, make sure to perform a quick check of the restored state.

If you see any errors on top of the administration like "Failed to load module postgresql_...", it is possible that there was a directory permission issue and ISL Conference Proxy was unable to access the specified backup directory to perform a restore.

Check "User management" to see if the expected domains and users are present.

Perform a product login with one of the users and check that the expected computers in the list are present, session history is not empty etc.

In case of any issues during the restore procedure or additional questions please visit our support and we will assist.

Was this article helpful?