Before you proceed, see System Requirements for information on supported platforms, supported browsers, and other requirements.
In addition, review the Docker requirements.
Docker Requirements
For Docker and Docker Compose installations, JFrog services require Docker 20.10.10 and above, and Docker Compose v1.24 and above to be installed on the machine on which you want to run on.
For install instructions, refer to the Docker and the Docker Compose documentation.
Stop and remove the current containers.
Upgrading from Docker run
docker stop artifactory docker rm -f artifactory
Upgrading from Docker Compose previously available in Bintray
docker stop artifactory postgresql nginx docker rm -f artifactory postgresql nginx
Extract the contents of the compressed archive and go to the extracted folder.
tar -xvf jfrog-artifactory-<pro|oss|cpp-ce>-<version>-compose.tar.gz
.env file included within the Docker-Compose archive
The .env file is used by docker-compose and is updated during installations and upgrades.
Some operating systems do not display dot files by default. If you make any changes to the file, remember to backup before an upgrade.
Run the config.sh script to setup folders with required ownership.
./config.sh
Check that the migration has completed successfully, by reviewing the following files:
migration log:
$JFROG_HOME/artifactory/var/log/migration.log
system.yaml
configuration:$JFROG_HOME/artifactory/var/etc/system.yaml
. This newly created file will contain your current custom configurations in the new format.Depending on your choices, a selected
docker-compose.yaml
will be available in the extracted folder. However, there are a few docker-compose templates in the directory templates.You can choose any template and copy it to the extracted folder asdocker-compose.yaml
.
Manage Artifactory using native Docker Compose commands.
docker-compose -p rt-postgres -f docker-compose-postgres-9-6-11v.yaml up -d docker-compose -p rt up -d docker-compose -p rt ps docker-compose -p rt down
Access Artifactory from your browser at:
http://SERVER_HOSTNAME:8082/ui/
.For example, on your local machine: http://localhost:8082/ui/
Reverse Proxy Settings
If you had a reverse proxy or load balancer configured with your Artifactory 6.x, you will need to create a new reverse proxy configuration and update your reverse proxy settings.
You can generate a new configuration template by accessing the upgraded Artifactory server UI (by default http://localhost:8082/ui/), navigate to
Navigate to Administration > Artifactory > General > HTTP Settings to adjust your Reverse Proxy Settings and generate a new configuration template. See Reverse Proxy Settings.
Check Artifactory Log.
tail -f $JFROG_HOME/artifactory/var/log/console.log
Configure log rotation of the console log
The
console.log
file can grow quickly since all services write to it. For more information, see configure the log rotation.
Artifactory version 6.x to 7.x Docker Compose Upgrade Using Docker Volumes
Stop and remove the current Docker containers.
docker stop artifactory postgresql docker rm -f artifactory postgresql
Extract the contents of the compressed archive and go to the extracted folder.
tar -xvf jfrog-artifactory-<pro|oss|cpp-ce>-<version>-compose.tar.gz
Copy the
docker-compose-volumes.yaml
file to the extracted folder.cp templates/docker-compose-volumes.yaml docker-compose.yaml
Add the entry to the
.env
file.echo -e "JF_SHARED_NODE_IP=$(hostname -i)" >> .env echo -e "JF_SHARED_NODE_ID=$(hostname -s)" >> .env echo -e "JF_SHARED_NODE_NAME=$(hostname -s)" >> .env
Avoid duplicating the entry in the
.env
file.Remove the following env from the
docker-compose.yaml
file.- JF_SHARED_DATABASE_TYPE=postgresql - JF_SHARED_DATABASE_USERNAME=artifactory - JF_SHARED_DATABASE_PASSWORD=password - JF_SHARED_DATABASE_URL=jdbc:postgresql://postgresql:5432/artifactory - JF_SHARED_DATABASE_DRIVER=org.postgresql.Driver
Migration starts from within the container and a new
system.yaml
aligning to the migrated data from Artifactory 6.x is created. To leverage this process, remove the env here to ensure that the old connection details are taken fromsystem.yaml
because the ENV supercedes thesystem.yaml
entries. You can also choose to update these environment values to the old connection details for the upgrade to be successful.Manage Artifactory using the native Docker Compose commands.
docker-compose -p rt up -d docker-compose -p rt ps docker-compose -p rt down
Run this command from the extracted folder.