Bundled JAS Installation ( Not Production-Ready )
Install JFrog Advanced Security in bundled service mode on the same VM as Xray, for POC use only, on RPM, Debian, Linux Archive, and Docker Compose.
Not production-ready
Bundled JAS is not recommended for production. The recommended approach is to install JAS separately on one or more dedicated VMs using the standalone deployment. We also do not recommend bundled JAS if there are more than 100,000 indexed artifacts. Bundled JAS can be used for a POC if there are resource constraints.
In the bundled mode, the JAS services run on the same VM as Xray. Before you begin, review the prerequisites.
Sizing Requirements
The following table applies only for up to 100,000 artifacts and 1,000 builds per day.
| Component | Cores per node | RAM [GB] per node | Nodes | Disk space [GB] |
|---|---|---|---|---|
| Total (Xray + JAS) | 9 | 36 | 1 | 750 |
| Xray | 3 | 12 | 1 | 250 |
| JAS | 6 | 24 | 1 | 500 |
RPM / Debian
-
Download the Xray compressed archive, extract its contents, and go to the extracted folder.
tar -xvf jfrog-xray-<version>-<rpm|deb>.tar.gz cd jfrog-xray-<version>-<rpm|deb> -
Run the installer script with the
--include-jasflag. The script prompts you with a series of mandatory inputs, including the jfrogURL, joinKey, database, and RabbitMQ details../installV2.sh --include-jas -
When prompted to choose the JAS deployment mode, select option 1 (Bundled).
How should JFrog Advanced Security (JAS) be deployed? 1) Bundled - the JAS services run on this node, alongside Xray 2) Standalone - the JAS services run on a separate node; this node runs Xray only -
Start and manage the Xray service. JAS is started along with the other Xray services.
systemctl start|stop xray.service -
Verify the JAS service logs in
jascontextual.logandjasexposures.logunder$JFROG_HOME/xray/var/log.
Linux Archive
-
Download the Xray compressed archive.
When running Xray, the installation script creates a user called
xrayby default, which must have run and execute permissions on the installation directory. We recommend that you extract the Xray download file into a directory that gives run and execute permissions to all users, such as/opt.tar -xvf jfrog-xray-<version>-linux.tar.gz mv jfrog-xray-<version>-linux xray sudo mkdir -p /opt/jfrog sudo mv xray /opt/jfrog/ -
Go to
$JFROG_HOME/xray/app/binand run the installer script with the--include-jasflag. The script prompts you with a series of mandatory inputs, including the jfrogURL, joinKey, database, and RabbitMQ details.cd /opt/jfrog/xray/app/bin sudo ./installV2.sh --include-jas -
When prompted to choose the JAS deployment mode, select option 1 (Bundled).
How should JFrog Advanced Security (JAS) be deployed? 1) Bundled - the JAS services run on this node, alongside Xray 2) Standalone - the JAS services run on a separate node; this node runs Xray only -
Switch to the
xrayuser, and start and manage the Xray service. JAS is started along with the other Xray services.sudo chown -R xray:xray /opt/jfrog/xray sudo su xray /opt/jfrog/xray/app/bin/xray.sh start|stop -
Verify the JAS service logs in
jascontextual.logandjasexposures.logunder$JFROG_HOME/xray/var/log.
Docker Compose
-
Download the Xray compressed archive, extract its contents, and go to the extracted folder.
tar -xvf jfrog-xray-<version>-compose.tar.gz cd jfrog-xray-<version>-compose -
Run the installer script with the
--include-jasflag. The script prompts you with a series of mandatory inputs, including the jfrogURL, joinKey, database, and RabbitMQ details../configV2.sh --include-jas -
When prompted to choose the JAS deployment mode, select option 1 (Bundled).
How should JFrog Advanced Security (JAS) be deployed? 1) Bundled - the JAS services run on this node, alongside Xray 2) Standalone - the JAS services run on a separate node; this node runs Xray only -
Start and manage the Xray service. JAS is started along with the other Xray services.
docker-compose -p xray-rabbitmq -f docker-compose-rabbitmq.yaml up -d docker-compose -p xray-postgres -f docker-compose-postgres.yaml up -d docker-compose -p xray up -dNote
Start the
xray-rabbitmqandxray-postgresprojects only if you selected the bundled RabbitMQ and the bundled PostgreSQL during installation. -
Check the logs of the JAS containers.
docker logs -f xray_jascontextual docker logs -f xray_jasexposures
Related Topics
Updated 6 days ago
