You can install and configure JFrog Xray, single node and high availability. For additional information on high availability, see high availability
Before installing Xray 3.x, you must first install JFrog Artifactory 7.x.
Note
Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.
Warning
If you install Xray on the same server as Artifactory, you might have port conflicts and performance issues. Artifactory and Xray use port 8082 for communication with the external network. In addition, the ports 8082, 8046, 8047, and 8049 are used by both Xray and Artifactory for the Router microservice.
To learn about the JFrog Platform Deployment, see System Architecture.
Admin Permissions for Installation
We recommend that you run the installation as a root user or provide sudo access to a non-root user.
You need to have admin permissions on the installation machine in the following cases.
Native installer - always requires admin permissions
Archive installer - requires admin permissions only during installation
Docker installer - does not require admin permissions
Before you proceed, see System Requirements for information on supported platforms, supported browsers, and other requirements.
Installation Steps
The installation procedure involves the following main steps.
Download Xray as per your required installer type (Docker Compose, RPM, Debian).
Install Xray either as a single node installation, or high availability cluster.
Install third party dependencies (PostgreSQL database, included in the archive)
Install Xray
Configure Xray basic settings.
Connect to an Artifactory instance (requires a
joinKey
and ajfrogUrl
).Optional: Configure the PostgreSQL database connection details if you have set Postgres as an external database.
Start the Service using the start scripts or OS service management.
Check the Service Log to check the status of the service.
Default Home Directory / $JFROG_HOME
The default Xray home directory is defined according to the installation type. For additional details see the Product Directory Structure page.
$JFROG_HOME
represents the JFrog root directory containing the deployed product.
Xray Single Node Installation
The following installation methods are supported.
Xray HA Installation
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.
Prerequisites
All nodes within the same Xray HA installation must be running the same Xray version.
Database
Xray HA requires an external PostgreSQL database. Make sure to install the database before proceeding to install the first node. There are several ways to set up PostgreSQL for redundancy, such as Load Balancing and Replication. For more information, see PostgreSQL.
RabbitMQ is automatically installed as part of the Xray installation for every node. In an HA architecture, RabbitMQ uses queue mirroring between the different RabbitMQ nodes, which are set up automatically.
Licensing
Xray HA is supported with an Enterprise License. Each node in the cluster must be activated with a different license.
Network
All the Xray HA components (Xray cluster nodes, database server and RabbitMQ) must be within the same fast LAN.
All the HA nodes must communicate with each other through dedicated TCP ports.