Skip to end of metadata
Go to start of metadata
Table of Contents

Overview

The procedure to upgrade Artifactory depends on the version you currently have installed.

Please check the instructions below according to your current version.

Going Pro?

Even if you're just switching your current version of Artifactory OSS to the same version of Artifactory Pro, you still need to follow the same upgrade instructions specified on this page.

The one exception is for an rpm installation. Since you are installing an rpm with the same version number, you need to add --force to the end of the command.

Before you upgrade

We strongly recommend that you do 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.

 


Upgrading from v3.x to the Latest Version

Upgrading Artifactory HA?

If you are upgrading an Artifactory HA cluster, please refer to Upgrading Artifactory HA.

Running the WAR in a Servlet Container

To upgrade Artifactory that is running as a WAR in a Servlet Container:

  1. Unzip the Artifactory distribution archive.
  2. Replace the previously deployed artifactory.war file with the webapps/artifactory.war file found in the Artifactory distribution archive.
    On servlet containers such as Tomcat it is also necessary to remove the expanded artifactory webapp directory.

    Recommend removing "work" and "temp" directories

    To make sure your previous version of Artifactory is really removed, we also recommend removing your Tomcat work and temp directories

Running as a Standalone Installation

  1. Unzip the Artifactory distribution archive.
  2. If the $ARTIFACTORY_HOME/tomcat/conf/server.xml has been modified keep it in a temporary location.  
  3. If Artifactory is configured to work with a database that is not Derby, keep the $ARTIFACTORY_HOME/tomcat/lib/<JDBC> driver  in a temporary location.  
  4. Replace the following files and folders in your current $ARTIFACTORY_HOME folder with the corresponding files from the new version.
    • webapps/artifactory.war

    • tomcat

    • bin

  5. Any files that were stored in temporary locations should now be returned to their original location under the new installation.
  6. If you installed Artifactory as a Linux service, browse to your $ARTIFACTORY_HOME/bin directory and execute the following command as root: $ARTIFACTORY_HOME/bin/installservice.sh [USER [GROUP]]

misc Folder

 The misc folder contains configuration files for specialized environments such as when running Artifactory as a Standalone Installation or on IBM Websphere.

Although these files are not required for runtime, it is recommended to replace this folder too.

Running as an RPM Installation

    1. Log in as root (or use sudo su -).
    2. Execute the following command:

Running in a Docker Container

Artifactory runs as an RPM service within a Docker container. To upgrade Artifactory, follow the instructions for Running as an RPM Installation.


Upgrading from v2.6.6 and Above to v3.x

Upgrading When Binaries are Stored in the Database

The procedure described in this section will only work if your system is configured to store binaries on the file system (the default configuration). If your system is configured to store binaries in the database, please follow the instructions for Upgrading From v2.2.x to v3.x below.

This upgrade procedure has the following steps:

  • Export data from the current version 
  • Install and configure the new version
  • Copy the filestore from the current version
  • Import data to the new version

Export Data

To export the data from your current version, select the Admin tab and then go to Import & Export | System to display the Export System parameters.

Define your Target Export Dir and check Exclude Content as displayed below:

Exclusions

Take care to only check Exclude Content. All the other check boxes should remain unchecked

Using Data from a Backup

If you have an up-to-date backup, you can skip the Export and use the data from your backup instead.

Full details on using Export and Import can be found in Importing and Exporting.

Install and Configure

Before installing the new version of Artifactory, take the following points into consideration:

  • The new version must be installed at a new location on your file system. You must not overwrite any previously installed versions
  • If you are using an external database, you cannot use the same schema. You must create a new schema for the upgraded version.
  • The amount of free disk space that you need for the upgrade is at least as large as your current filestore because to complete the upgrade you must manually copy your current filestore to the new version

You may now install the new version which is fully described in Installing Artifactory.

Copy the Filestore

To copy the filestore from your current version follow the steps below: 

  1. Manually create the data directory under $ARTIFACTORY_HOME/ of the new installation.
  2. Copy the $ARTIFACTORY_HOME/data/filestore directory from the old Artifactory version to the $ARTIFACTORY_HOME/data folder in the new Artifactory 3.x you have just installed.

Import Data 

To import your data into the the new version, in the Admin under Import & Export | System scroll down to display the Import System parameters.

Specify the System Zip File or Directory to import from and select "Import"

Adding a Timestamp

You must add the timestamp to the name of the Zip File or Directory field after completion of the import process.


Upgrading from v2.2.x and Above to v3.x

For this upgrade procedure, first you need to upgrade to version 2.6.6, and then to the new version as follows:

  • Export data from the current version to create a backup (in case something goes wrong during the upgrade procedure).
  • Install v2.6.6
  • Upgrade to the new version

Export Data

To export the data from your current version, select the Admin tab and then go to Import & Export | System to display the Export System parameters.

Define your Target Export Dir as displayed below:

Using Data from a Backup

If you have an up-to-date backup, you can skip the Export and use the data from your backup instead.

Full details on using Export and Import can be found in Importing and Exporting.

Installing v2.6.6

To upgrade to v2.6.6 execute the following steps:

  • Replace the [$ARTIFACTORY_HOME]/webapps/artifactory.war file with the artifactory.war file provided in the v2.6.6 distribution
  • Delete the [$ARTIFACTORY_HOME]/work folder.
  • Start the Artifactory server

Upgrading to the New Version

To upgrade to the new version, please refer to Upgrading from v2.6.6 and Above to v3.x


Upgrading from Versions Prior to v2.2

To upgrade from a version prior to 2.2 you first need to upgrade to version 2.6.  For details on how to perform this upgrade please refer to Upgrading Artifactory to Version 2.6.x.

 

 

 

  • No labels