URL Export

in Basic Guides

Опубликованный: 5 янв. 2023 г.|Last updated: 5 янв. 2023 г.

The following guide will describe the steps to migrate from Deskpro v5 to Deskpro Horizon (v6) via the On-Premise Controller (OPC).

Note

If you are performing a production migration of your helpdesk, we recommend disabling your Deskpro v5 helpdesk before continuing with this guide.

This can be done in Admin > Setup > Settings by checking the Disable the helpdesk box, and clicking Save

Exporting your data from your v5 server

Go to your Admin Dashboard and click the link to the Horizon Upgrade Tool
Confirm that all pre-upgrade tasks have been completed.
Click the Configure a new data dump button, make a note of the Encryption Passkey then click Begin
Wait for the data dump to complete, then make a note of the Secret URL generated.

Importing your data into a new Horizon instance

You can find the OPC webGUI by going to https://<opc_IP_address>:29443 or your OPC domain in your browser.

Login to the webGUI with your master password, or by generating a PIN with the following command on the OPC server command line:

sudo opc session
 copy

Click New under Instances in the side menu, then select the Import Instance option.
If you want to perform a test import, click the Test option. Otherwise, if you are performing a live migration, select the Production option.

Warning

Test Instances cannot be converted to Live Instances, and must be deleted then re-imported under the Production option

To login to a test instance, you must append .test to your email address. If you use an external authentication method, you can login using a login token:

opc inst -i {instanceID} login-token {email_address}.test
 copy

Select Version 5 as the import source, then confirm that all steps have been completed and click Continue.
Select Provide Export, then in the Import Instance window, select the URL Download option under Import File. Paste the link to the Secret URL generated from your v5 data dump into the field, then check the Database backup is encrypted box and paste your Encryption Passkey into the field below.
OPTIONAL If you wish to use an external MySQL database or an external ElasticSearch server, you can configure them here.
Click Import Instance to start the import process. Once complete, click Continue to view the instance page..