Introduction

MangoApps Enterprise Edition is a multi-tiered application distributed as one or more machines. This architecture allows for a straightforward initial deployment and provides forward-thinking room to expand as your organization grows and high availability becomes important. This document will focus on an initial deployment consisting of a single machine setup. For further information on high availability, please contact your account manager.
You can follow a set of steps to install MangoApps on a new server. The installation process requires basic knowledge of Linux and system administration.

Prerequisites – Please Complete Before Continuing

Check off all of the following items before deploying the MangoApps On-Premise Server. Failure to complete the prerequisites before continuing will impact the time required to get up and running.

Before you start, please collect the following information and provide it your account manager. If there are questions, don’t hesitate to bring them up:

  1. IP Address
  2. Hostname/Fully-qualified domain name. A couple of things to note here:
    • The FQDN will become the name of the network and the URL your users will access the service with. So, please use an end-user friendly name, e.g. socialhub.xyz.com or hub.xyz.net, etc.
    • The top-level domain name is used to send invitations and other notification emails. So, please make sure it is a valid top-level domain (.com, .net, .org, etc.)
  3. Obtain an SSL certificate for the FQDN selected above. A wild-card certificate will work as well. (Please note: MangoApps uses Apache2 as its web server so please download the certificate in Apache2 format).
  4. Network/firewall access from the server to the internet
    • Network/firewall access to these ports on the server: 22 TCP, 80 TCP, 443 TCP, 1935 TCP, 5222 TCP, 5223 TCP, 843 TCP
    • Internet access from the server, at a minimum: port 80, port 443, port 25
  5. The Mail relay server (optional) that you would like the MangoApps server to use to send emails to.

During the installation / setup phase, we recommend that you put the server on your DMZ. Once server is setup to your satisfaction, you can move it behind your corporate network and control outside access as tightly as you would like.

We know that you are excited to get the installation going. We are too!

— PLEASE VERIFY THAT YOU HAVE COMPLETED THE ABOVE CHECKLIST. THE SERVER MAY NOT INSTALL PROPERLY IF YOU DON’T COMPLETE THE STEPS ABOVE –-

Please note that most common reason server installation fails is because the required ports are not open or server doesn’t have Internet access. If the server can’t access the Internet, setup will fail (setup relies on Internet connectivity to download the application from our management server and other patches).

 

 

MangoApps Standard Installation Process

The MangoApps installation process consists of two distinct steps. First step, it to download and setup the Linux operating system as outlined below. Once operating system is installed and network is setup, 2nd step can begin. 2nd step consists of downloading and installing the MangoApps server stack.

Step -1: Operating System Download and Installation:

  1. Download Ubuntu Linux Server 14.04 LTS from: http://www.ubuntu.com/download/server
  2. Install Ubuntu Server. Refer to the Preferred MangoApps Ubuntu Configuration article if necessary.
    1. Make the hostname of your Ubuntu install is the same name you provided MangoSpring.
    2. Choose only the OpenSSH-Server package when prompted to install additional packages. Please do not select and install anything else.
  3. Login as root.
  4. If necessary, make changes to the files below so the hostname is the exact hostname provided to MangoApps in Step 1.
    1. /etc/hostname
    2. /etc/hosts

    then reboot the server so new hostname takes effect.

  5. Verify outbound connectivity from your new Ubuntu server. For example, type cd /tmp then see if typing wget www.mangoapps.com gets a 200 OK HTTP response and downloads the homepage.

Step -2: MangoApps Server Stack Download and Setup

At this point, we will take care of the setup of MangoApps in your environment.

Setup and Installation

Provide us with the SSH login information to your server that is being setup and we will complete, verify the setup, and perform sanity tests for you before handing it over. The user that you provide to us needs to be in the sudoers list. Also, there needs to be outbound connectivity so that as a test, a wget command from a temporary directory will download the content of a webpage.

You can turn the VPN connection off once setup is complete and you are completely up and running by turning off the VPN or blocking outgoing connection at firewall.

If you need help at any step, just post a message in the project workspace your account manager created for you or send an email to support@mangoapps.com.