Overview

JFrog Distribution can be installed on supported Linux platforms

For an RPM installation, please ensure the following conditions hold:

  • JFrog Distribution must be installed on a different machine from JFrog Artifactory.
  • The SELinux policy must either be permissive or disabled
  • The umask (user file creation mode mask) must have a default setting of 0022, 022, 0002 or 002

 

 

 

To use an external log collector that requires a separate user for Distribution (e.g. Sumologic, Splunk), you can adjust the permissions on the $DISTRIBUTION_DATA/logs folder to allow the the log collection service to perform read operations on the generated log files as follows:

  • Add the log collection service user to the relevant group if needed (the user and group that installed and started Distribution)
  • Apply the user and group permissions as needed on the $DISTRIBUTION_DATA/logs directory using:

    $ chmod -R 640 $DISTRIBUTION_DATA/logs
  • Adjust the group read inheritance permissions setgid bit using:

    $ chmod -R 755 $DISTRIBUTION_HOME/data/logs 

    This will cause the generated log files to inherit the folder's group permissions. 

The Distribution Linux installation follows standard conventions and installs Distribution in the following folders:

Application files
/opt/jfrog/distribution
Data files

Default: /var/opt/jfrog/distribution/

The installation script will prompt you for an optional alternative location.

Log files

/var/opt/jfrog/distribution/logs

Distribution will rotate and compress old log files.

Log configuration files
/var/opt/jfrog/distribution/config
PostgreSQL home directory

/var/opt/jfrog/distribution/postgres

Redis home directory
/var/opt/jfrog/redis

The installation instructions for all of the supported flavors of Linux are the same. As a pre-requisite, you must have Java 8 installed.

Note: In all of the instructions below, replace the <linux-flavor> place-holder with one of centosdebianubuntu or redhat according to the flavor of Linux on which you are operating.

  1. Extract the downloaded installation archive

    tar -xzf distribution-<linux-flavor>-latest.tar.gz
  2. Run the installation script
    (If you are not running as "root", prepend the following command with "sudo")

    ./installDistribution-<linux-flavor>.sh

    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.

    For more details, please refer to Using External Databases.


Upgrading on Linux

For instructions on how to upgrade an existing installation, please refer to Upgrading Distribution

Interacting with the Linux Installer

Verify all the required Distribution components and connected databases are up and running using the following command:

./distribution.sh status all

 

Use the below command to start all Distribution components:

./distribution.sh start all

It is also possible to exclude the 'all' flag which will make the script run or check only for the running Distribution services (without the databases) as follows:

./distribution.sh status
./distribution.sh start
 

 

The installation script offers facilities for maintenance. Run the following commands as "root" or prepend them with "sudo".

./distribution.sh <command> <target (optional)>

where:

<command> can take one of the following values:

start
Start the service
stop
Stop the service
restart
Restart the service
status
Display the service status (e.g. running, stopped...)
info
 Displays version information for each service
deployServices
Deploy the service (only available for the distribution service)
removeServices
Remove the service (only available for the distribution service)

<target> Optional. When omitted, the command only applies to the Distribution service.

 

all
Apply the command to all services