On-premise Installation Guide – Getting Started

Introduction

MangoApps is a multi-tiered application that can scale both horizontally and vertically. This architecture allows for a straightforward initial deployment and provides forward-thinking room to expand as your organization grows. This document will focus on an initial deployment consisting of a single machine setup. 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.

1. Static IP Address of the Mango server

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. portal.companydomain.com or hub.companydomain.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, 5223 TCP

   • Full Internet access from the server

5. The Mail relay server (optional) that you would like the MangoApps server to use to send emails to. If you do not have a mail relay server, mail can be sent directly from the Mango server.

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 16.0X LTS from: http://www.ubuntu.com/download/server

2. Install Ubuntu Server.

   1. Make the hostname of your Ubuntu install the same as FQDN

   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.

6. Create a user for us to use for installation and support. This user needs to be in the sudoers list and have full sudo access.

Step -2: MangoApps server stack download and setup

Provide all the information above to your account manager including the certificate. Once we have all the information, we will verify SSH access to the machine and 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.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 [e-mail].