This article is for IT Administrators who wish to migrate their current Appspace server to another server. The migration process involves backing up, restoring database tables stored in MySQL Workbench, and reinstalling Appspace on the new server. It also involves replicating the original Appspace folders to the new server.
- Please ensure you meet all the requirements listed in the On-Prem System Requirements article.
- Identical license key(s) for the backup server.
- HTTPS is required for communications. Download and install a valid SSL (Secure Sockets Layer) certificate for the Appspace on-prem server. Refer to the How to Set Up SSL on IIS 7 instructions here: https://docs.microsoft.com/en-us/iis/manage/configuring-security/how-to-set-up-ssl-on-iis
- Configure the DNS (Domain Name Server) with a FQDN (Fully Qualified Domain Name).
- If Shared IIS Configuration is enabled, you must disable it and install the IIS URL Rewrite feature manually on each web server, by following the instructions here: https://social.technet.microsoft.com/wiki/contents/articles/25762.how-to-install-and-configure-iis-url-rewrite-over-iis-shared-configuration-feature.aspx The Appspace Installation Center may not be able to install the IIS URL Rewrite feature correctly if the Shared IIS Configuration is enabled.
- Turn off anti-virus software prior to installation. If unable to turn off anti-virus software due to company policies, configure the anti-virus software to exclude all Appspace folders and databases.
- Contact Appspace Support to obtain the latest version of the Appspace Installer.
To perform a full backup and migration, follow the instructions below:
Backup Existing Appspace Databases
Backup the existing Appspace databases from your Windows Server to a new location. You may choose to copy the folder to a location within the server, or to an external source such as a USB drive or a secure cloud storage service.
- Stop the Internet Information Services (IIS) on the Appspace server, from the command prompt using this command: iisreset /stop
For more information, please refer to the instructions on the Microsoft website: https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/95826e7a-bac4-4e1f-bcb6-c52d49c9d7f4.mspx?mfr=true or https://technet.microsoft.com/en-us/library/cc732317(v=ws.10).aspx
- Run the MySQL Workbench program from the Windows Start menu.
- Click ‘Local instance MySQL’. The ‘Local instance MySQL’ tab will be displayed, with the Data Export and Data Import/Restore links shown on the Navigator sidebar.
- Select Data Export under Management in the Navigator pane, and in the Local Instance MySQL tab, select one database schema you would like to export, and ensure that all the tables are selected in the Schema Objects window on the right.
- Ensure the following ‘Objects to Export’ checkboxes are checked:
- Dump Stored Procedures and Functions
- Dump Events
- Dump Triggers
- Select the ‘Export to Self-Contained File’ option, and choose a location to store your .sql file (you may also customize the name of the file to your own preference). Click the Start Export button.Allow some time for the export process. The progress bar will indicate the status of the task. The task will be completed once the Status indicates that the file has been exported. You may verify this by navigating to the location of the newly-generated .sql file in Windows Explorer.
- Repeat Steps 3 to 5 for all the other database schemas by creating new self-contained .sql files. Ensure that only one database schema is selected at any one time, and that the ‘Export to Self-Contained File’ option is selected before exporting.
Backup Appspace Folders
- From Windows Explorer, copy and paste the following Appspace installation folder to a desired backup location:
- Repeat the process for other folders that host Appspace files (if any).
Install Appspace on Windows Server 2016 / 2019
Install Apspspace 7.x on your new Windows Server 2016 or Windows Server 2019 server.
Please refer to the Install and Configure Operating System section in the Install Appspace On-Prem article.
You must restore databases in MySQL by manually importing the self-contained SQL files backed up earlier to the Windows Server 2016 or Windows Server 2019 server.
- Stop the Internet Information Services (IIS) on the server, by following the instructions on the Microsoft website: https://technet.microsoft.com/en-us/library/cc732778(v=ws.10).aspx
- In MySQL Workbench, click Data Import/Restore, and select the ‘Import from Self-Contained File’ option. Locate the .sql file in your server and choose the appropriate Default Target Schema from the drop-down menu.
- Click the Start Import button. The progress bar will indicate the status of the task.
- Repeat the same procedure for the other database schemas (dsnmetrics, playoutmetrics, etc).
Restore Appspace Folders
Once the databases are restored, you may proceed to restore the installation folders and files from the previous Appspace server to the same location in the new Appspace server. By default the location is:
Repeat the process for other folders backed up earlier (if any).
Run Appspace Installer
- Rerun the Appspace 7.1.3 Installation Center (AIC) and select the Upgrade option. Please refer to the Upgrade Appspace section in the Upgrade to Appspace 7.1 On-Prem article.
- Start the Internet Information Services (IIS) on the server, by following the instructions on the Microsoft website: https://technet.microsoft.com/en-us/library/cc732778(v=ws.10).aspx
Proceed to activate the new license. Please refer to the Activate Appspace On-Prem article.