Installing Distribution

Overview

JFrog Distribution is a complementary product to JFrog Artifactory and is run as a separate installation as a set of microservices.

Both Docker and Non-Docker installation flavours are as quick and easy as possible, you only need to download a simple script that manages download and installation of all the other components needed to run Distribution.

To get started, make sure your system complies with the requirements in the following section before you proceed to download and install Distribution.

Installer Log

As part of the installation/upgrade Distribution creates a log file to track the installation process. Each installation/upgrade will create a new install log file with the following format:

${INSTALLER_DIR}/${SCRIPT_NAME}.${DATE}.log

System Requirements

Hardware

JFrog Distribution requires the following hardware:

Processor: 8 cores
RAM Memory: 8 GB
Storage: 50 GB

Platforms

JFrog Distribution supports any non-Windows platform that can run Docker v1.11 and above, and in addition, has been tested and verified to run as a non-Docker installation on the following 64-bit flavors of Linux:

Ubuntu 16.04
Centos 7.x
Debian 8.x
Red Hat 6.x
Red Hat 7.x

Page Contents

Docker

JFrog Distribution requires Docker v 1.11 and up to be installed on the machine on which you want to run Distribution. For instructions on installing Docker, please refer to the Docker documentation.

Browsers

Distribution has been tested with the latest versions (known at the time of release) of Google Chrome, Firefox, Internet Explorer, Microsoft Edge and Safari.

Artifactory

JFrog Distribution supports JFrog Artifactory v6.0 and above.

Proxy

In corporate environments it is often required to go through a proxy server to access remote resources.

JFrog Distribution should be installed in the same site as your JFrog Mission Control when communication with Artifactory instances through a proxy is required. This will enable the Distribution service to use the same proxy configurations set up in Mission Control.

Download and Installation

JFrog Distribution may be installed using Docker images, or as a native installation for each of the supported flavors of Linux. Once you have downloaded your preferred installer, follow the installation instructions in the corresponding sections below.

Download

The download links for Enterprise+ installers can be found here

Keep Distribution on your $PATH

Make sure to save the downloaded file in one of the locations defined in your $PATH environment variable so it is accessible from anywhere on your machine.

Supported Installers

Docker: Distribution is available for download as a Docker image to be run as a container. For for details, please refer to Installing with Docker.
Linux: Distribution can also be installed as a Linux Archive File Installation.
Kubernetes: Distribution is also available for installation on Kubernetes. For details, please refer to Installing on Kubernetes.

Using External Databases

JFrog Distribution uses several databases for different features of its operation.

Distribution gives you the option of using your own PostgreSQL database if you have these already installed and in use in your organization.

Supported database versions

Currently, Distribution supports the following external database versions:

PostgreSQL: version 9.6 and above

It is up to you to choose wether to externalize the data base when you install Distribution.

During the installation process, the Distribution installation script will prompt you with questions about whether to install an internal database or to use one already installed in your organization. Simply respond to these prompts as required.

You take full responsibility for your own databases

If you choose to have Distribution use any of your own databases for its operation, you take full responsibility for the maintenance, monitoring, backup and correct functioning of these databases.

For example, the Distribution installation script will ask if you would like to install PostgreSQL.

If you respond with a "Y", Distribution will install PostgreSQL for its own use. If you chose to externalize your PostgreSQL database and choose "n", the Distribution installation script will prompt you for the required connection string.

Would you like to install PostgreSQL instance? [Y/n]: n
Type a PostgreSQL connection string [jdbc:postgresql://postgres:5432/distribution?user=distribution&password=password]: jdbc:postgresql://<MACHINE_IP>:5432/distribution?user=distribution&password=password

Accessing Distribution

JFrog Distribution can be accessed using the following URL:

http://<SERVER_NAME>:8080

For example, if you are accessing Distribution on a machine called "myserver" you would use: http://myserver:8080

Activating Distribution

Once you have completed your Distribution installation, you must continue to the Enterprise Plus Configuration.