|
| 1 | +--- |
| 2 | +title: Enterprise High Availability Mode 2.x |
| 3 | +layout: en_enterprise |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## Travis CI Enterprise 2.x |
| 8 | + |
| 9 | +Travis CI Enterprise 2.x typically runs as a single container instance communicating with one or multiple workers. Still, we also offer a High Availability configuration so you can run your installation with redundancy. High Availability Mode is a helpful way to have additional stability, particularly for customers with large-volume licenses. |
| 10 | + |
| 11 | +If you're interested, or might be interested, in running Travis CI Enterprise in High Availability mode, please email us at [[email protected]](mailto:enterprise@travis-cicom?subject:HA%20Mode), and we can discuss options and help you get started. |
| 12 | + |
| 13 | +### Installation Overview |
| 14 | + |
| 15 | +The platform installation is similar to the standard [Enterprise installation](/user/enterprise/setting-up-travis-ci-enterprise/#1-setting-up-enterprise-platform-virtual-machine), and the [worker installation](#installing-the-worker-in-high-availability-mode) is identical. However, there are some additional [system prerequisites](/user/enterprise/high-availability/), which means that to install in HA mode, you will need the following: |
| 16 | + * 3+ **16 gigs of RAM, 8 CPUs, 40GB HDD**, i.e. `c4.2xlarge` with a 40GB HDD. - 2+ for the VMs running the Platform and 1+ for the VMs running the Worker |
| 17 | + * [Redis](https://redis.io/), [RabbitMQ](https://www.rabbitmq.com/), |
| 18 | +and [Postgres](https://www.postgresql.org/) instances |
| 19 | + * [GitHub OAuth app](/user/enterprise/setting-up-travis-ci-enterprise/#prerequisites), [trial license](/user/enterprise/setting-up-travis-ci-enterprise/#prerequisites) -- enabled for HA |
| 20 | + * Internet connection -- note, this installation is _not _ airgapped by default. Let [us know ](mailto:[email protected]) if you are interested in one. |
| 21 | + |
| 22 | +### Install the Platform in High Availability Mode |
| 23 | + |
| 24 | +HA is configured entirely on the Enterprise platform instance, but installing an HA platform is quite similar to installing a standard platform. The steps for HA are as follows. |
| 25 | + |
| 26 | +1. Contact [[email protected]](mailto:[email protected]?subject=HA%20Installation) to have your Enterprise license configured for HA mode. |
| 27 | +1. Set up your [platform instance using the standard installation steps](/user/enterprise/setting-up-travis-ci-enterprise/#1-setting-up-enterprise-platform-virtual-machine) |
| 28 | +1. Sign in to your Admin Dashboard (at `https://<your-travis-ci-enterprise-domain>:8800`) |
| 29 | + 1. Go to 'Settings' and click 'Enable HA'. |
| 30 | + 1. Paste in the URLs where you have [Postgres](https://www.postgresql.org/), [Redis](https://redis.io/), and [RabbitMQ](https://www.rabbitmq.com/) hosted. The connection strings should be in the format of: |
| 31 | + ``` |
| 32 | + postgres://user:password@url:port |
| 33 | + redis://user:password@url:port |
| 34 | + amqps://user:password@url:port |
| 35 | + ``` |
| 36 | + 1. Optional: Upload a RabbitMQ Client Certificate (`.crt`). This allows RabbitMQ to use TLS. |
| 37 | + 1. Scroll down to the bottom of the page. |
| 38 | + 1. Click 'Save' and restart. |
| 39 | + |
| 40 | +Once your first platform instance is fully configured, you should be able to see the UI and request a build - your build will only run correctly if a worker is installed. Try out your new platform, and [please let us know ](mailto:[email protected]?subject=HA%20Troubleshooting) if you have questions. |
| 41 | + |
| 42 | +#### Add more Platform Installations |
| 43 | + |
| 44 | +We recommend at least two Platform containers for HA mode, and you can install more Enterprise containers in the same way you [installed](/user/enterprise/setting-up-travis-ci-enterprise/#1-setting-up-enterprise-platform-virtual-machine) the first. |
| 45 | + |
| 46 | +Once your second platform is installed, its HA settings must also be configured. Go to the Admin Dashboard for your new platform container at `https://<your-second-travis-ci-enterprise-domain>:8800` to configure these as you did for [the first platform installation](#installing-the-platform-in-high-availability-mode). |
| 47 | + |
| 48 | +## Install the Worker in High Availability Mode (all versions) |
| 49 | + |
| 50 | +The worker installation works the same as non-HA installations, as do the build environment compatibility defaults per the Enterprise version. Check out the docs for which version of Enterprise handles different OS's([TCIE 2.x](/user/enterprise/setting-up-travis-ci-enterprise/#2-setting-up-the-enterprise-worker-virtual-machine) or [TCIE 3.x](/user/enterprise/tcie-3.x-setting-up-travis-ci-enterprise/#2-setting-up-the-enterprise-worker-virtual-machine) and other information regarding the installation. You must retrieve your RabbitMQ password from your installation rather than the Travis CI Enterprise Admin Dashboard. |
| 51 | + |
| 52 | + |
| 53 | +## Contact Enterprise Support |
| 54 | + |
| 55 | +{{ site.data.snippets.contact_enterprise_support }} |
0 commit comments