Last updated on January 18, 2016

Installing Appspace

Introduction

This article provides the instructions to download, install, and configure the operating systems, the prerequisite software, and Appspace software for an on-premise deployment of Appspace.

  1. Install and Configure Operating System
  2. Download Prerequisite Software
  3. Install Prerequisite Software
  4. Install Appspace Installation Center
  5. Configure Folder Permissions
  6. Install Appspace

Before you begin, please read and ensure you meet the Appspace System Requirements.

Warning

Please only use local hard drives to install Appspace. Remote storage drives such as SAN and NAS are not supported.

Install and Configure Operating System

  1. Select and install one of the following operating systems (OS). Please note the specific configurations required for Appspace, as listed below:


    • Windows Server 2012 R2 Standard Edition

      1. Install the OS as per instructions on the Microsoft website: https://technet.microsoft.com/en-us/library/hh831620.aspx.

      2. Ensure the following options are checked:

        • Role-based or feature-based installation


        • Web Server (IIS)


        • .NET Framework 3.5 Features and .Net Framework 4.5 Features


  2. Restart the computer and proceed to the next section.


Download Prerequisite Software

  1. Disable Internet Explorer Enhanced Security Configurations (IE ESC), which is enabled by default. When this feature is enabled, file downloads may be blocked. In Windows Server Manager, click ‘Configure IE ESC’ and in the Internet Explorer Enhanced Security Configuration window, select the Off options for both Administrators and Users.

    Warning

    Only download these software and do NOT install.

  2. Download Microsoft .Net Framework 4.5.2 here: https://www.microsoft.com/en-us/download/details.aspx?id=42642.

  3. Download Microsoft Visual C++ 2013 here: https://www.microsoft.com/en-us/download/details.aspx?id=40784.

  4. Download one of the following database:


  5. Download Appspace Installation Center via ‘System > Downloads’ in your Appspace Cloud account.


  6. Proceed to install the applications as per the instructions in the next section below.


Install Prerequisite Software

Note

  • Links to the installation instructions on the provider’s website are provided.
  • Please take note of specific configuration information 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.5.2. Follow the instructions here: https://msdn.microsoft.com/en-us/library/5a4x27ek(v=vs.110).aspx

  2. Install Microsoft Visual C++ 2013. Follow the ‘Install instructions’ here: https://msdn.microsoft.com/en-us/library/5a4x27ek(v=vs.110).aspx

  3. Install and configure your preferred database:

    Warning

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

    • MySQL:

      1. Install MySQL 5.6 (Version 5.6.21). Follow the instructions here: http://dev.mysql.com/doc/refman/5.6/en/mysql-installer-gui.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 5.6.23 (either the x86 or x64 version depending on your server)
          • MySQL Workbench CE 6.2.3 (either the x86 or x64 version depending on your server)

          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 Type and Networking window, do the following:

          • Select Server Machine from the Config Type drop-down menu.
          • Under Connectivity, check ‘TCP/IP’ and set the ‘Port Number’ as 3306.
          • Check ‘Open Firewall port for network access’.
          • Check ‘Show Advanced Options’.

      2. Configure MySQL Workbench. Follow the instructions in the MySQL Setup with MySQL Workbench article.



  4. Proceed to the next section below.


Install Appspace Installation Center

Note

The Appspace Installation Center 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 Windows Control Panel > Add/Remove Programs, prior to installation.

  1. Launch the Appspace Installation Center setup file on your server machine. If prompted by a security warning, click Run to continue.

  2. Click Next in the ‘Welcome to the Appspace Installation Center Setup Wizard’ window.


  3. In the ‘End-User License Agreement’ window, check the box to accept the terms in the License Agreement and click Next to continue.


  4. In the ‘Choose Setup Type’ window, select Typical (this is the most common type of installation) and click Next.


  5. Click Install to begin the installation.

  6. If prompted, click Yes to allow the program to make changes to the computer.

  7. Click Finish when you see the ‘Completed the Appspace installation Center Setup Wizard’ message.

  8. Proceed to the next section below.


Configure Folder Permissions

Grant read and write permissions to IIS_IUSRS on the following folders:

  • C:/temp
  • C:/Windows/Temp
  • C:/Appspace

Warning

Failure to set permissions may result in a failed server install due to access restrictions.

  1. Navigate to the ‘temp’ folder on your Windows server. If you do not see the folder, create the folder in the C 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, continue 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

  1. Launch the Appspace Installation Center (AIC) from the desktop. If prompted by a warning, click Yes to allow the program to make changes to the computer.

  2. At this point you may see the ‘Prerequisite not met’ window. This is a notification message that informs you of the two Windows registry changes the installation center has just modified (TcpTimedWaitDelay and MaxUserPort). No additional action needs to be performed. Close the window.


  3. Perform a manual restart of your Windows server.

  4. Right-click and launch the Appspace Installation Center using the ‘Run as Administrator’ option.

  5. Click Install in the ‘Welcome to Appspace Installation Center’ window.


  6. Click Next to continue in the Customizing Appspace window. You may choose to change the installation folder.


  7. From the Database drop-down menu, select your server’s database type, input the credentials, and click Validate.

    • MySQL

      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.


    • MS SQL

      Select SQL Server option as the Authentication type. Enter the Host name of the server (this can be obtained from the server connection screen when you launch SQL Server Management Studio).


  8. Please wait while Appspace is being installed. Installation duration vary and typically require at least 20 minutes.


  9. Click OK when you see the “Appspace Installation Complete” message, and perform a manual restart of your Windows server.

  10. Connect to the Appspace server from a web browser via one of the following two URL paths:

    • http://<server_name_ip_address>/app

      (replace <server_name_ip_address> with the DNS name or IP address of your Appspace server)

    • http://localhost/app

    Note

    When you access Appspace for the first time, you will be prompted with the License Activation page. Please refer to either the License Activation (Omni Subscribers) article or the License Activation (Traditional) article for more information.