Share on print
Share on facebook
Share on linkedin
Share on whatsapp
Share on email

This article provides the instructions to download, install, and configure the operating system, prerequisite software, and Appspace software, for a first-time install of an Appspace 7.x on-prem deployment.

Please follow the instructions in this order:

Note
If you are an existing Appspace customer running an older version of Appspace on-prem and looking to upgrade our software, please refer to the Upgrade to Appspace 7.x On-Prem article.

Prerequisites

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.

Install and Configure Operating System

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.
  1. Select and install the Windows Server 2016 operating system (OS). Please note the specific configuration required for Appspace, as listed below:
    • Install Windows Server 2016 as per instructions on the Microsoft website: https://social.technet.microsoft.com/wiki/contents/articles/37890.windows-server-2016-installation.aspx 
      Important

      When installing the Windows Server 2016, ensure that the Time and currency format is set to English (United States). This is the default setting.

      This is to prevent a licensing issue, where the on-prem server is unable to add the pending license receipt. This is due to a date format mismatch between the Appspace cloud server, which is set with the M/d/yyyy date format, and the on-prem server, which may contain a different date format, if another locale is selected during the Windows server installation.


       
    • Install all the necessary updates for Windows Server 2016.
      Important
      • Please install all the latest Windows Updates before the Appspace installation, to prevent installation conflicts between both the Appspace installation process and windows server updates in the background. 
      • Do not disable the Windows Update service. If the Windows Update service is disabled, the Appspace installer will encounter an error. 
  2. Install the Universal C Runtime update as per instructions on the Microsoft website: https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows
  3. Ensure the following options are checked:
    • Role-based or feature-based installation.
    • Select Appspace server from the server pool.
    • Web Server (IIS).
      Ensure the following Web Server IIS services are selected:
      • Web Server (IIS)
        • Web Server
          • Default Document
          • Static Content
        • Performance
          • Static Content Compression
          • Dynamic Content Compression
        • Application Development
          • .NET Extensibility 3.5
          • .NET Extensibility 4.6
          • ASP
          • ASP.NET 3.5
          • ASP.NET 4.6
          • ISAPI Extensions
          • ISAPI Filters
      • Management Tools
        • IIS Management Console
    • .NET Framework 3.5 Features and .NET Framework 4.6 Features.
      Ensure the following .NET Framework features are selected:
      • .NET Framework 3.5 Features
        • HTTP Activation
        • Non-HTTP Activation
      • .NET Framework 4.6 Features
        • WCF Services
          • HTTP Activation
          • TCP Activation
  4. Restart the Windows 2016  server.
  5. Proceed to configure the Secure Sockets Layer (SSL) for the server, by following 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
  6. Once installed, restart the Windows 2016 server and proceed to the next section.

Download Prerequisite Software

Warning
Only download these software and DO NOT install yet.
  1. Disable the Internet Explorer Enhanced Security Configurations (IE ESC), which is enabled by default, as this blocks IE from downloading all files.

    In Windows Server Manager, click On and in the IE Enhanced Security Configuration option, select the Off options for both Administrators and Users

     

  2. Download Microsoft .NET Framework 4.6.2: https://support.microsoft.com/en-us/topic/the-net-framework-4-6-2-web-installer-for-windows-6ec55fa1-50e9-0395-2a37-ff612779027c 
  3. Download only one of the following database: 
  4. Please contact Appspace Support to get the latest Appspace Installer.
  5. Proceed to install the applications as per 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. Install .NET Framework 4.6.2. Follow the instructions here: https://docs.microsoft.com/en-us/dotnet/framework/install/guide-for-developers?redirectedfrom=MSDN
  2. Install and configure your preferred database:
    Warning
     
    • SQL passwords should NOT contain shell metacharacters such as !#’”`&; or spaces.
    • The database credentials CANNOT be changed once Appspace has been installed.
    • The database user account must not be deleted once Appspace has been installed.

    • MySQL:
      • Install MySQL 8.x. Follow the instructions here: https://dev.mysql.com/doc/refman/8.0/en/windows-installation.html
        • Select the Custom option on the Choosing a Setup Type window, and click Next to continue.
        • On the Select Products and Features window, ensure the following options are selected, and moved under the Products/Features To Be Installed section.
          • MySQL Server 8.x (x64 version)
          • MySQL Workbench CE 8.0.x (x64 version)
            Warning
            Only select these 2 options. Leave all the other options unchecked. It is important to make sure that the other options (such as MySQL Connectors) are NOT selected during the MySQL installation.
        • In the Group Replication window, select the Standalone MySQL Server/Classic MySQL Replication option.
        • In the Type and Networking window, do the following:
          • Select Server Machine from the Config Type drop-down menu.
          • Under Connectivity, check the TCP/IP checkbox, and set the Port Number to 3306.
          • Check Open Firewall port for network access.
          • Check Show Advanced and Logging Options.
        • In the Authentication Method window, select the Use Legacy Authentication Method (Retain MySQL 5.x Compatibility) option.
        • In the Accounts and Roles window, enter in the MySQL Root Password.

          Warning
          SQL passwords should NOT contain shell metacharacters such as !#’”`&; or spaces.

      • Configure MySQL Workbench. Follow the instructions in the Setup MySQL with MySQL Workbench article.
    • MS SQL
  3. Proceed to the next section below.

Configure Folder Permissions

Grant read and write permissions to IIS_IUSRS for the following folders on the Windows and Appspace installation drive of your server:

  • C:/Windows/Temp
  • C:/temp
  • C:/Appspace
Note
In this example, we will be using the C:/ drive as the default Windows and Appspace installation drive. Please ensure the folders above are created in their respective installation drives if the Windows and Appspace installation is to be done other than the defaulted C:/ drive.
Warning
Failure to set permissions may result in a failed server install due to access restrictions.

Repeat the instructions below for each folder listed above:

  1. Navigate to the temp folder on your Windows server. If you do not see the folder, create the folder in the C drive (installation drive).
  2. Right-click on the folder and select Properties.
  3. Select the Security tab, and look for IIS_IUSRS in the Group or user names section.
    • If it is listed, proceed to Step 6.
    • If you do not see it, select Edit to continue.
  4. On the next window, select the Add button to create the group name.
  5. Enter the value, IIS_IUSRS, in the Enter the object names to select field. Click OK to continue.
  6. Select IIS_IUSRS, and check the Allow check box for Full control. Click OK.
  7. Repeat Step 1 to Step 6 for the other two folders listed above.
  8. Proceed to the next section below.

Install Appspace 7.x

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

  1. Right-click the Appspace 7.x 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 the FQDN Host Name of the server, as it will be used to identify and access the Appspace console once the installation is complete.
    Example: https://<server.hostname.com>

    Company Server: server
    Company Hostname: hostname.com

    Warning
    Ensure the FQDN hostname is used when asked for a hostname. We do not recommend changing this Host Name once the installation is complete. If a need arises, please contact Appspace Support first.
  4. Review the list of applications and services that will be installed, and click Install.
    The Appspace 7.x Installer will begin installing the required applications, services, and the Appspace Installation Center Setup file.
    Important
    The installation duration varies and may require the server to be restarted multiple times during the installation process. You must click the restart button on the installer as displayed. Do NOT manually restart the machine.
  5. Once the Appspace Installation Center Setup is launched during the installation process, click Install.
  6. Ensure the Installation, and Content folder paths are correct, and 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.
    Important
    We officially do not support or recommend the use of a remote database engine, as it may impact performance. However, if a remote database engine must be used, please contact our Support Team to further advise on configuration settings based on your deployment.
  8. Click Validate to continue the installation process.
  9. Restart the server once the Appspace Installation Center Setup has completed as indicated.
    Important
    You must click the Restart button on the installer as displayed. Do NOT manually restart the machine.

    Note
    If the installation fails, close the Appspace Installation Center Setup window. DO NOT click on the Restart button on the Appspace installer. Manually re-run the Appspace Installation Center Setup.
  10. Once restarted, the Appspace 7.x 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. Click Close at the You have completed the installation! screen, and OK at the confirmation dialog box.
  13. 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)
  14. When you access the Appspace console for the first time, you will be redirected to the License Activation page. Please refer to Activate Appspace On-Prem Server for more information.
Note
If there was an issue during the data migration or card installation phase, or if you wish to uninstall Appspace 7.x on-prem, relaunch the Appspace 7.x Installer setup file, and select one of the following options:

  • Data Migration – Select this option if Data Migration previously was not completed during the installation phase.
  • Card Installer – Select this option to install Cards (Update existing templates, and themes).
  • Uninstall – Select this option to uninstall Appspace 7.x.