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

To upgrade Artifactory to the latest version follow the specific instructions for your current version:

Upgrading Artifactory from 3.x to the latest version

 

The upgrade from version 2.x is not automatic. To upgrade from version 2.x read the upgrade instructions in the relevant sections below.

When Running the Artifactory WAR in a Servlet Container

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

When Running Standalone Artifactory

  1. Unzip the Artifactory distribution archive.
  2. Replace the following files and folders in you current $ARTIFACTORY_HOME with the same files from the new version:

    The misc folder contains configuration files for specialized environments such as a Standalone Tomcat Server or Websphere. Although these files are not required for runtime, it is recommended to replace this folder too.

  3. Delete the Tomcat work folder ($ARTIFACTORY_HOME/tomcat/work) before starting up Artifactory.

When Running the RPM Installation

  1. Log in as root (or use 'sudo su -').
  2. Execute 'rpm -U artifactory-3.y.z.rpm'

 

If you have previously installed RPM from version 2.x, it cannot be upgraded. You must uninstall the old RPM and then install version 3.

 

====================================================================================

Export / Import of Data to Artifactory from 2.6.6 and above to 3.x

There are three steps required for the upgrade procedure:

  • Export from 2.6.6+
  • Copy the filestore from 2.6.6+
  • Import to 3.x

You can find detailed instructions below:

Export

NOTE! that if you have an updated backup, you can use this backup for performing the import.

Select the Admin tab and then go to Import & Export -> System to display the Export and Import options. 

 

The only checkbox to be marked is the Exclude Content. Do not mark any other checkboxes!

Installation and Definition - Physical and Database 

When installing the new version of Artifactory, it must be installed in a different location to the previously installed version.

If you have previously installed RPM from version 2.x, it cannot be upgraded. You must uninstall the RPM and then install version 3.

If you are using an external database, you cannot use the same schema. You must create a new schema for the upgraded version.

Once you have taken the above into consideration, you can now perform a regular installation of Artifactory.  Refer to Installing Artifactory for details.

Take into consideration, that the amount of free disk space required for upgrading a normal installation of Artifactory is at least the size of the current file store - because manually copying the current file store

File Store Copy

  1. Manually create “data” directory in $ARTIFACTORY_HOME/
  2. Copy the $ARTIFACTORY_HOME/data/filestore directory from the old Artifactory version to $ARTIFACTORY_HOME/data in the new Artifactory 3.x

Import

Select the “Admin” tab and then go to the Import & Export -> System to display the Export and Import options.

NOTE! that you must add the timestamp to the name of the Zip File or Directory field after completion of the import process.

 

====================================================================================

Upgrading From Version 2.2.x and Above to Version 3.x

The upgrade and installation process is divided into 3 steps: 

  • Export from the previous version
  • Installation of Artifactory (in a new location) and defining a database
  • Import the data that was exported

    Set out below are the procedures required to upgrade Artifactory from version 2.2.x and above to version 3.x.

    If you are using Artifactory version 2.6.6 it is preferable to use the upgrade instructions above, which is a significantly faster procedure than a standard full system Export/Import.

Export

NOTE! that if you have an updated backup, you can use this backup for performing the import.

Select the Admin tab and then go to Import & Export -> System and select the target export directory.

Refer to Importing and Exporting for complete details of performing the export procedure.

Installation and Definition - Physical and Database 

When installing the new version of Artifactory, it must be installed in a different location to the previously installed version.

If you have previously installed RPM from version 2.x, it cannot be upgraded. You must uninstall the old RPM and then install version 3.

If you are using an external database, you cannot use the same schema. You must create a new schema for the upgraded version.

Once you have taken the above into consideration, you can now perform a regular installation of Artifactory.  Refer to Installing Artifactory for details.

Import

Select the Admin tab and then go to Import & Export -> System and select the target directory to import to.

NOTE! that you must add the timestamp to the name of the Zip File or Directory field after completion of the import process.

Refer to Importing and Exporting for complete details of performing the import procedure.

====================================================================================

Upgrading From 2.2.x or Earlier Versions

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

  • No labels