Installing Apcera EE on Ubuntu

As an alternative to installing the Apcera Platform Edition Edition on supported cloud providers (such as AWS, OpenStack, or vSphere), you can install the Enterprise Edition on Ubuntu Server version 14.04. This is known as a "bare OS" installation.

The steps to install Apcera EE on Ubuntu 14.04 are as follows. Refer to the individual links for detailed instructions.

Checklist

To install Apcera Platform EE on Ubuntu 1404, complete the installation checklist.

1. Read the requirements.

Read the requirements for installing the platform on Ubuntu and formulate your architecture.

2. Set up DNS.

You will need to have a registered domain name for your cluster domain. After you know the IP address of the router host (the central machine), you must update your DNS records with the IP address. See configuring DNS for details.

3. Ensure internet connectivity.

Both provisioning scripts require internet connectivity. Note that bare OS air-gapped deployments are not supported at this time. See bare OS provisioning scripts for details.

4. Generate SSH key.

You will need to add an SSH key to the cluster.conf file so that you can SSH to the cluster hosts. See generating SSH key for details.

5. Set up auth provider.

If you are using Goolge Auth, create the Google Developer Project. See configuring Google Auth for details.

6. Download required files.

You need both provisioning scripts and the cluster.conf file. See https://support.apcera.com/hc/en-us/articles/209596146-Bare-OS-Installation to download the bare OS provisioning scripts and sample cluster configuration file.

7. Provision servers.

For an MVD deployment, you will need 1 physical or virtual machine for each cluster host role: Orchestrator, Central, Singleton, and Instance Manager(IM). You should use a VM for the Orchestrator host and a physical machine for each IM. You can choose physical or virtual for the other cluster hosts (Central and Singleton). See virtualization options for details.

8. Partition cluster hosts.

For a minimum viable deployment (MVD), you will need to partition the IM host(s) and the Singleton host. You can do this before or during the Ubuntu installation. See partition requirements for details.

9. Install Ubuntu 14.04.

Install Ubuntu 14.04.4 64-bit Server on each cluster host.

10. Run the provisioning scripts.

Run the provisioning scripts to create cluster hosts. You run the Orchestrator provisioning script on the Orchestrator host and the Base provisioning script on all other cluster hosts.

11. Populate cluster.conf.

Configure the cluster by populating the cluster.conf file according to your requirements and architecture. You update the cluster.conf file with the information specific to your environment. Required information is commended in the file as "TODO".

12. Deploy the platform.

Deploy the cluster using orchestrator-cli commands and the populated cluster.conf file.