Overview

To get more functionality and universal support for all major package types you can easily upgrade your JFrog Container Registry according to your JFrog Container Registry version.


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

Upgrade Method

On-Prem

You can upgrade your JFrog Container Registry to these Artifactory flavors:



Artifactory ProExposes a set of professional features, on top of those already available to you from the JFrog Container Registry, opening up a whole world of capabilities that empower you to manage your binaries and integrate with industry standard tools in your development and deployment ecosystem.
Artifactory Pro XAn Artifactory Pro with increased 24/7 support together with JFrog Xray providing continuous security and universal artifact analysis.
Obtain a license and download installation files. For more information, see Upgrading to Artifactory Pro.
Cloud

You can upgrade your plan to one of these Cloud plans:



Cloud ProJFrog's SaaS-based solution for managing your artifacts and binary repositories in the cloud with the full power of Artifactory Pro behind you and 24/7 SLA-based support.
Cloud Pro XJFrog's SaaS-based solution for managing your artifacts and binary repositories in the cloud with the full power of Artifactory Pro behind you and 24/7 SLA-based support. Including JFrog Xray.

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:

  • Docker
  • Kubernetes
  • Debian
  • RPM

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:

  1. 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.
  2. Back up your database.
  3. If you are using a relational database, make sure the database user defined in your db.properties file has permissions to modify the database schema

Prerequisite 

A JFrog Artifactory Pro license key. If you need a license, please visit the JFrog website and either  or.

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 .


The procedure for upgrading to Artifactory Pro is:

  1. Run an upgrade process according to your installation type.
  2. 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.lic license file, and place it in the $ARTIFACTORY_HOME/etc folder. If you using the Docker installation, place the artifactory.lic file inside the /artifactory_extra_conf folder.

Please refer to the sections below with specific instructions for your installation type.

Docker Installation

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:

  1. Stop the current container
  2. Start a container with the new version using same data and configuration
  3. Remove the old container.

The example below shows this process for upgrading Artifactory from v5.0.0 to v5.1.0. 

$ # Stop the currently running container
$ docker stop artifactory-6.0.0
 
$ # Start a new container from the new version image
$ docker run -d --name artifactory-6.14.0 --volumes-from=artifactory-6.0.0 -p 8081:8081 docker.bintray.io/jfrog/artifactory-pro:6.1.0
 
$ # Remove old container
$ docker rm artifactory-6.0.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.

If you have configured JFrog Container Registry to run as the ROOT application in Tomcat, you need to follow the steps described in .


Zip Installation

  1. Unzip the Artifactory distribution archive.
  2. If you have not yet done so, perform a graceful shutdown of your currently running installation.
  3. If the $ARTIFACTORY_HOME/tomcat/conf/server.xml has been modified keep it in a temporary location.  

  4. Backup files to a temporary location according to the conditions described below:
    1. In all cases, backup $ARTIFACTORY_HOME/bin/artifactory.default
    2. If Artifactory is configured to work with a database that is not Derby, backup the $ARTIFACTORY_HOME/tomcat/lib/<JDBC> driver.  
  5. Remove the following files and folders from your $ARTIFACTORY_HOME folder:
    • webapps/artifactory.war

    • tomcat

    • bin

    • misc

  6. Replace the removed files and folders with the corresponding ones from the new unzipped version.
  7. Any files that were stored in temporary locations should now be returned to their original location under the new installation.


Debian 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:

  1. Perform a graceful shutdown of your currently running installation.
  2. Perform a backup of $ARTIFACTORY_HOME/data folder.

  3. Delete the JFrog Container Registry Installation. 

    apt-get remove jfrog-artifactory-jcr
  4. Download and install the Artifactory Pro package.

    dpkg -i $jfrog-artifactory-pro-<version>.deb
  5. Import the ‘data’ backup folder to the new installation location.

    $ARTIFACTORY_HOME/data
  6. Start Artifactory. 

    $ARTIFACTORY_HOME/data

RPM Installation

  1. 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.
  2. Log in as root (or use sudo su -).
  3. If you have not yet done so, perform a graceful shutdown of your currently running installation
  4. Execute the following command:

    rpm -U jfrog-artifactory-pro-6.y.z.rpm

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. 

.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.

.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.