Xray HA Installation
Set up a Xray HA cluster with 2+ nodes using Helm, Docker Compose, or Linux archive with external PostgreSQL.
The following describes how to set up an Xray HA cluster with two or more nodes. For more information, see the System Architecture.
The following installation methods are supported.
- Helm on Kubernetes environment
- Helm on OpenShift environment
- Docker Compose
- Linux Archive / RPM / Debian
Prerequisites
See Prerequisites for HA Setup.
Getting Started
First node installation steps
We recommend using an external PostgreSQL database for HA setups. Ensure you create the Xray user and database before installing Xray.
Install Xray and start it. The installation is identical to the single node installation. See Xray Single Node Interactive Script Installation.
Adding an additional node
Note
If you want to install more than 3 Xray nodes, we recommend installing in split mode — 3 RabbitMQ nodes plus the desired number of Xray nodes. For more details on split mode, see RabbitMQ Split for Xray.
Follow the same steps as above on each node to install Xray using the interactive script.
When prompted, make sure to answer yes to the following option:
Are you adding an additional node to an existing product cluster? [y/N]: yThen follow the remaining interactive script prompts to provide the master key, Xray hostname, RabbitMQ credentials, and other required details.
Here is how the system.yaml file (/opt/jfrog/xray/var/etc/system.yaml) for additional nodes will look. This file is generated automatically by the installer script and will have the hostname of the first active node.
shared:
rabbitMq:
active:
node:
name: <hostname of any of the active nodes where Rabbit MQ service is running>Related Topics
Updated 9 days ago