Last updated on July 18, 2019

Upgrade to Appspace 7.0 on-prem

This article provides the instructions to perform a full upgrade to Appspace on-prem 7.0, for existing Appspace customers running an older version of Appspace on-prem.

Please ensure you meet the prerequisites, and ensure your older version of Appspace has been upgraded according to our set upgrade paths.


Please follow the upgrade instructions in this order:

  1. Download Prerequisite Software
  2. Uninstall Appspace Installation Center
  3. Install Prerequisite Software
  4. Install Appspace 7.0

Note

If you are a new Appspace customer looking to install our software for the first time, please refer to the Install Appspace 7.0 on-prem article.

Upgrade Paths

Important

All older versions of Appspace on-prem require an interim upgrade before you can upgrade to the latest version. You must upgrade any older version of Appspace on-prem to Appspace 6.2.4 prior to proceeding with this article.

See the following table for the upgrade path of your Appspace on-prem version.

Starting Version Upgrade Paths
Appspace 7.0 7.0
Appspace 6.2.4 6.2.4 > 7.0
Appspace 6.1.0 6.1.0 > 6.2.4 > 7.0
Appspace 6.0.3 6.0.3 > 6.2.4 > 7.0
Appspace 5.8.0 5.8.0 > 6.0.3 > 6.2.4 > 7.0
Appspace 5.5.5 5.5.5 > 6.0.3 > 6.2.4 > 7.0
Appspace 5.2.3 5.2.3 > 6.0.3 > 6.2.4 > 7.0
Appspace 5.1.2 5.1.2 > 5.2.3 > 6.0.3 > 6.2.4 > 7.0
Appspace 5.0.3 5.0.3 > 5.1.2 > 5.2.3 > 6.0.3 > 6.2.4 > 7.0
Appspace 4.2.2 4.2.2 > 5.0.3 > 5.1.2 > 5.2.3 > 6.0.3 > 6.2.4 > 7.0
Appspace 4.1.0 4.1.0 > 4.2.2 > 5.0.3 > 5.1.2 > 5.2.3 > 6.0.3 > 6.2.4 > 7.0

Prerequisites


Download Prerequisite Software

Warning

Only download these software and DO NOT install yet.

  1. Download the following database, according to your preference. Ideally the same database used in your previous Appspace installation:

  2. Please contact Appspace Support to get the latest Appspace Installer (Appspace Installation Center).

  3. Proceed to the instructions in the next section below.

Uninstall Appspace Installation Center

You must first remove the previous build of Appspace Installation Center.

  1. Go to the Windows Control Panel, and double-click Programs and Features.

  2. In the list of installed programs, select Appspace Installation Center and click Uninstall.

  3. Proceed to the instructions in the next section below.


Install Prerequisite Software

Important

  • Links to the installation instructions on the provider’s website are provided.
  • Please ensure you take note of and complete the specific configuration required for each application, described in each step below.
  • Please right-click each installer file and select Run as Administrator to install.

Please install the prerequisite software downloaded earlier, in the following order:

  1. Upgrade the Appspace database:


  2. Proceed to install the Appspace 7.0 Installer.


Install Appspace 7.0

Note

The installation of Appspace 7.0 on-prem involves the installation of two Appspace installers. The Appspace Installation Center Setup file is included as part of the Appspace 7.0 Installer.

The Appspace Installation Center (AIC) is used for the installation as well as the maintenance or upgrade of Appspace software. Please remove any old instances of the Appspace Installation Center from the Windows Control Panel > Add/Remove Programs, prior to installation.

  1. Right-click the Appspace 7.0 Installer setup file on your on-prem server, and select Run as administrator to launch the installer. Click Begin Installation.


  2. Read the Appspace’s Software License Agreement. If you agree to the terms, check the checkbox, and click Agree.

  3. Click Next once you have ensured the installation paths for the Application, Content, and Data paths are correct.

    Enter in Host Name URL of the server, as it will be used to identify and access the Appspace console once installation is complete.


  4. Review the list of applications and services that will be installed, and click Install.

    The Appspace 7.0 Installer will begin installing the required applications, services, and the Appspace Installation Center Setup file. The installation duration varies, and may require the server to be restarted multiple times during the installation process.


  5. Once the Appspace Installation Center Setup is launched during the installation process, click Upgrade.


  6. Ensure the Installation, and Content folder paths are correct. Optionally, you may check the Update Templates checkbox to update the Appspace default templates. Click Next.


  7. Select the server Database type from the drop-down menu, and enter in the database Host and root credentials.

    You may leave localhost as the Host. If the database engine is installed on a separate server, replace the Host value with the IP address of the remote database server.


  8. Click Validate to continue the installation process.


  9. Restart the server once the Appspace Installation Center Setup has completed as indicated.


  10. Once restarted, the Appspace 7.0 Installer would continue the installation process.


  11. Click Next once the installation process is complete, and Next again at The installation was successful screen.


  12. The Data Migration process will begin. Click Next once the migration process is complete, and Next again at The data migration was successful screen.


  13. Click Close at the You have completed the installation! screen, and OK at the confirmation dialog box.


  14. Launch your web browser and connect to your Appspace console via the following URL:

    https://<hostname>

    (replace <hostname> with the Host Name entered in Step 3 above)


  15. When you access the Appspace console for the first time, you will be redirected to the License Activation page. Please refer to Activating Appspace on-prem for more information.