Last updated on April 25, 2017

Upgrading an Appspace on-premises server

This article provides the instructions to perform a full upgrade of the Appspace server:

  1. Modify the MySQL Database
  2. Update Appspace Installation Center
  3. Upgrade Appspace

Prerequisites

  • You must meet all the requirements listed in the Appspace on-premises requirements article.

  • 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.

    Important

    When not turned off, anti-virus software blocks installer processes from running, which prevents the installation of some Appspace files. Overall installation time is also slower.

Modify the MySQL Database

Update Appspace Installation Center

  1. You must first remove the previous builds of Appspace Installation Center. Go to the Windows Control Panel, and double-click ‘Programs and Features’. In the list of installed programs, select Appspace Installation Center and click Uninstall.


  2. Install the latest version of the Appspace Installation Center. For detailed instructions, please refer to the Install Appspace Installation Center section in the Installing Appspace on-premises article.


Upgrade Appspace

  1. Launch the Appspace Installation Center (AIC) using the ‘Run as Administrator’ option (hold down SHIFT + double-click on the icon).

  2. If prompted by a warning, click Yes to allow the program to make changes to the computer.

  3. Click Upgrade in the ‘Welcome to Appspace Installation Center’ window.


  4. You may choose to update Appspace default templates if you desire and click Next to continue. You do not need to replace templates for Appspace servers version 5.0 and later.

    Warning

    Opting to update the templates will also overwrite all existing templates/icons. Do not select this option if you have previously created custom elements/assets relating to widgets (i.e. custom weather widget icons).


  5. Select your database and enter the values in the Host, Username, and Password fields. Click Validate.


  6. Please wait while Appspace is being upgraded. Upgrade durations will vary depending on the system’s resources and hardware specifications. Typical upgrades will require at least 20 minutes. During the upgrade, you may see various messages and status updates.

  7. Click OK when you see the “Appspace Installation Complete” message.

  8. Perform a manual restart of your Windows server.