Using the latest version?
JFrog Container Registry Guide
Upgrading to Advanced Versions
The following table lists the versions you can upgrade from JFrog Container Registry to a more advanced JFrog Artifactory version.
JFrog Container Registry Version
JFrog Product Upgrade Versions
You can upgrade your JFrog Container Registry to these Artifactory flavors:
|Obtain a license and download installation files. For more information, see Upgrading to Artifactory Pro.|
You can upgrade your plan to one of these Cloud plans:
Upgrade directly from your MyJFrog account.
Upgrading Docker Container Registry to Artifactory Pro
The procedure to upgrade to Artifactory Pro depends on your installation type. We strongly recommend reading through this page before proceeding with your upgrade. Detailed upgrade instructions are provided for the following installation types:
Before you upgrade
We strongly recommend that you take the following actions to ensure you can roll back your system in case you encounter any issues during the upgrade process:
- Perform a complete System Export before commencing your upgrade procedure. If at any time you decide to roll back to your current version, you can use the export to reproduce your current system in its entirety.
- Back up your database.
- If you are using a relational database, make sure the database user defined in your
db.propertiesfile has permissions to modify the database schema
Once you submit the corresponding form, a download link will be provided to you by email.
You may also access the latest version through the Artifactory Pro Download Site.
The procedure for upgrading to Artifactory Pro is:
- Run an upgrade process according to your installation type.
- Add your license.
After upgrading to Artifactory Pro, make sure you provide the Artifactory installation with a license. Simply create a file called
artifactory.lic,copy the license you have received from JFrog and paste it into the
artifactory.liclicense file, and place it in the
$ARTIFACTORY_HOME/etcfolder. If you using the Docker installation, place the
artifactory.licfile inside the
Please refer to the sections below with specific instructions for your installation type.
In order to keep your data and configuration between versions, when upgrading the JFrog Container Registry Docker image, you need to use an external mounted volume as described under Managing Data Persistence.
To upgrade the JFrog Container Registry Docker image, follow these steps:
- Stop the current container
- Start a container with the new version using same data and configuration
- Remove the old container.
The example below shows this process for upgrading Artifactory from v5.0.0 to v5.1.0.
Once these commands have completed successfully, you would have the Artifactory Pro running with the data and configuration from the old version that was removed.
Running JFrog Container Registry as ROOT
If you have configured JFrog Container Registry to run as the ROOT application in Tomcat, you need to follow the steps described in this Knowledge Base article.
- Unzip the Artifactory distribution archive.
- If you have not yet done so, perform a graceful shutdown of your currently running installation.
$ARTIFACTORY_HOME/tomcat/conf/server.xml has been modified keep it in a temporary location.
- Backup files to a temporary location according to the conditions described below:
- In all cases, backup
- If Artifactory is configured to work with a database that is not Derby, backup the
- In all cases, backup
- Remove the following files and folders from your
- Replace the removed files and folders with the corresponding ones from the new unzipped version.
Any files that were stored in temporary locations should now be returned to their original location under the new installation.
To ensure that all of the data remains following the upgrade to Pro (assuming you are using the default DB), please follow these steps:
- Perform a graceful shutdown of your currently running installation.
- Perform a backup of $ARTIFACTORY_HOME/data folder.
Delete the JFrog Container Registry Installation.
Download and install the Artifactory Pro package.
Import the ‘data’ backup folder to the new installation location.
- Download the Artifactory Pro RPM Installer. The latest version can be downloaded from the JFrog Artifactory Pro Download Page. Previous versions can be downloaded from JFrog Bintray.
- Log in as root (or use
sudo su -).
- If you have not yet done so, perform a graceful shutdown of your currently running installation
Execute the following command:
rpm -U jfrog-artifactory-pro-
During an upgrade of an RPM installation different files may get backed up, where the backup file is appended with either a .rpmorig or a .rpmnew extension.
A .rpmorig extension means that the original file in your installation, the one that was there before performing the upgrade, was backed up before being replaced in the upgrade process.
A .rpmnew extension means that the original file in your installation, was not replaced in the upgrade, and instead, the new file with the same filename was backed up.
In either case, Artifactory will display a message such as:
warning: /etc/opt/jfrog/artifactory/default saved as /etc/opt/jfrog/artifactory/default.rpmorig
In these cases we recommend comparing the file installed once the upgrade has been completed with the backed-up file to see which best fits your needs, and using that one in the final setup.
If you make any changes, you may need to restart Artifactory for the change to be applied.
Activating Artifactory Pro
Your license key is provided in the same email that contains the download link sent to you.
Your Artifactory administrator should enter the license key into the corresponding field in the Admin module under Configuration | Register License.
You must be an Administrator in order to access the License Key field.