Skip to content

Commit 66c1d96

Browse files
authored
Create high-availability-tcie-2.x.md
1 parent a738b43 commit 66c1d96

File tree

1 file changed

+55
-0
lines changed

1 file changed

+55
-0
lines changed
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
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

Comments
 (0)