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.

Upgrading from v3.x to the Latest Version

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.

Running as a Standalone Installation

  1. Unzip the Artifactory distribution archive.
  2. Replace the following files and folders in your current $ARTIFACTORY_HOME folder with the corresponding files from the new version
    • webapps/artifactory.war
    • tomcat/conf/server.xml
    • tomcat/conf/web.xml
    • tomcat/conf/Catalina/localhost/artifactory.xml
    • bin

       

      misc Folder

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

      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.

Running as an RPM Installation

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

Page Contents


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:

Exporting Data

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"

Importing Data

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

This upgrade procedure has the following steps:

  • Export data from the current version 
  • Install and configure the new 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 as displayed below:

Defining the Target Export Dir

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.

 

Full Export for Versions Before v2.4

If your current version is older than v2.4.0 then you must do a full export. Therefore do not set the Exclude Content check box.

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 currently running an RPM installation from version 2.x, it cannot be upgraded. You must uninstall the current version and then install the new one.
  • If you are using an external database, you cannot use the same schema. You must create a new schema for the upgraded version.

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


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