Try JFrog
Guides
Contact SupportTry JFrog
Start typing to search…
  1. Operations and Maintenance
  2. Upgrade JFrog Products
  3. Upgrading Artifactory

Upgrade Linux Package

Upgrading Artifactory on Linux using native packages provides a process. straightforward, production-ready

Upgrading Artifactory on Linux using native packages provides a straightforward, production-ready process. This approach utilizes your operating system’s package manager (YUM, DNF, or APT) or a manual archive to manage the upgrade and configuration of Artifactory.

Choose your environment below to get started:

Upgrade Artifactory RPM Package

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via an RPM package to a newer 7.x version.

If you want to upgrade from any version lower than 7.x, see Upgrading Artifactory from 6.10.x to 7.x.

Preparation and Pre-Upgrade Checks

To ensure a smooth upgrade, consider the following:

  • Backup Your Data: We strongly recommend you to perform a full backup of your Artifactory data directory ($JFROG_HOME/artifactory/var) and database before starting any upgrade process. This allows for recovery in case of unexpected issues.
  • Review Release Notes: Always check the Artifactory Release Notes for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here.
  • Downtime: In a single-node setup, the Artifactory service will be unavailable to users during the upgrade. In High-Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, allowing the service to remain available to users.

Upgrade Steps

The following steps outline how to upgrade your Artifactory single-node installation using either the JFrog RPM repository or a direct .rpm package download.

  1. Method 1: Upgrade Using the JFrog RPM Repository

    This is the recommended method for upgrading as it simplifies the process.

    1. Stop Artifactory: Before upgrading, stop the Artifactory service.

      sudo systemctl stop artifactory.service

    2. Install New Version: Install the desired Artifactory version. Replace 7.111.11 with your target Artifactory version.

      sudo yum install jfrog-artifactory-pro-7.111.11

      On newer Fedora or CentOS/RHEL versions, you might use dnf instead of yum.

      sudo dnf install jfrog-artifactory-pro-7.111.11

    3. Start Artifactory: Once the package installation is complete, start the Artifactory service.

      sudo systemctl start artifactory.service

    4. Verify the Upgrade:

      • Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
      • Access UI: Access http://<SERVER_HOSTNAME>:8082/ui/ in your browser to verify the UI loads.
      • Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

  2. Method 2: Upgrade Using a .rpm Package

    This method is useful for upgrading to a specific .rpm package directly.

    1. Stop Artifactory: Before upgrading, stop the Artifactory service.

      sudo systemctl stop artifactory.service

    2. Download the .rpm Package: Download the .rpm package for the specific Artifactory version you want to install. For example, to download version 7.111.11:

      curl -g -L -O -J 'https://releases.jfrog.io/artifactory/artifactory-pro-rpms/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.rpm'

    3. Install the New Package: Navigate to the directory where you downloaded the file and use yum to install it. This will upgrade your existing installation.

      sudo yum install -y ./jfrog-artifactory-pro-7.111.11.rpm

    4. Start Artifactory: Once the package is installed, start the Artifactory service.

      sudo systemctl start artifactory.service

    5. Verify the Upgrade:

      • Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
      • Access UI: Access http://<SERVER_HOSTNAME>:8082/ui/ in your browser to verify the UI loads.
      • Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

Troubleshooting and Post-Upgrade Notes

  • Database Migrations: During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema.

Upgrade Artifactory Debian Package

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Debian package to a newer 7.x version.

If you want to upgrade from any version lower than 7.x, see Upgrading Artifactory from 6.10.x to 7.x.

Preparation and Pre-Upgrade Checks

To ensure a smooth upgrade, consider the following:

  • Backup Your Data: We strongly recommend you to perform a full backup of your Artifactory data directory ($JFROG_HOME/artifactory/var) and database before starting any upgrade process. This allows for recovery in case of unexpected issues.
  • Review Release Notes: Always check the Artifactory Release Notes for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here.
  • Downtime: In a single-node setup, the Artifactory service will be unavailable to users during the upgrade. In High-Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, allowing the service to remain available to users.

Upgrade Steps

The following steps outline how to upgrade your Artifactory single-node installation using either the JFrog APT repository or a direct .deb package download.

  1. Method 1: Upgrade Using the JFrog APT Repository

    This is the recommended method for upgrading as it simplifies the process.

    1. Stop Artifactory: Before upgrading, stop the Artifactory service.

      sudo systemctl stop artifactory.service

    2. Update APT Cache and Install New Version: Update your package list and install the desired Artifactory version. Replace 7.111.11 with your target Artifactory version.

      sudo apt-get update && sudo apt-get install jfrog-artifactory-pro=7.111.11

    3. Start Artifactory: Once the package installation is complete, start the Artifactory service.

      sudo systemctl start artifactory.service

    4. Verify the Upgrade:

      • Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
      • Access UI: Access http://<SERVER_HOSTNAME>:8082/ in your browser to verify the UI loads.
      • Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

  2. Method 2: Upgrade Using a .deb Package

    This method is useful for upgrading to a specific .deb package directly.

    1. Stop Artifactory: Before upgrading, stop the Artifactory service.

      sudo systemctl stop artifactory.service

    2. Download the .deb Package: Download the .deb package for the specific Artifactory version you want to install. For example, to download version 7.111.11:

      curl -g -L -O -J 'https://releases.jfrog.io/artifactory/artifactory-pro-debs/pool/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.deb'

    3. Install the New Package: Navigate to the directory where you downloaded the file and use dpkg to install it. This will upgrade your existing installation.

      sudo dpkg -i jfrog-artifactory-pro-7.111.11.deb

    4. Start Artifactory: Once the package is installed, start the Artifactory service.

      sudo systemctl start artifactory.service

    5. Verify the Upgrade:

      • Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
      • Access UI: Access http://<SERVER_HOSTNAME>:8082/ in your browser to verify the UI loads.
      • Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

Troubleshooting and Post-Upgrade Notes

  • Database Migrations: During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema.

Upgrade Artifactory with Linux Archive

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Linux archive to a newer 7.x version.

If you want to upgrade from any version lower than 7.x, see Upgrading Artifactory from 6.10.x to 7.x.

Preparation and Pre-Upgrade Checks

To ensure a smooth upgrade, consider the following:

  • Backup Your Data: We strongly recommend you to perform a full backup of your Artifactory data directory ($JFROG_HOME/artifactory/var) and database before starting any upgrade process. This allows for recovery in case of unexpected issues.
  • Review Release Notes: Always check the Artifactory Release Notes for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here.
  • Downtime: In a single-node setup, the Artifactory service will be unavailable to users during the upgrade. In High-Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, allowing the service to remain available to users.

Upgrade Steps

The following steps outline how to upgrade your Artifactory single-node installation from a Linux Archive.

  1. Log in as a root user.

  2. Set the JFROG_HOME variable:

    export JFROG_HOME=<Your JFrog home directory, for example /opt/jfrog>

  3. Stop Artifactory: Navigate to the bin directory and stop the service.

    cd $JFROG_HOME/artifactory/app/bin
./artifactoryctl stop

  4. Download and Extract the New Archive: Download the new archive, then extract its contents. Replace <version> with your target version.

    tar -xvf jfrog-artifactory-<pro|oss|cpp-ce>-<version>-linux.tar.gz

  5. Export the JF_NEW_VERSION variable:

    export JF_NEW_VERSION=<For example /opt/jfrog/artifactory-7.x>

  6. Replace the existing app folder: Use the following commands to replace the existing app folder with the new one.

    # Remove app
rm -rf $JFROG_HOME/artifactory/app
# Copy new app
cp -r $JF_NEW_VERSION/app $JFROG_HOME/artifactory
# Remove extracted new version
rm -rf $JF_NEW_VERSION
# Set permissions
chown -R artifactory:artifactory $JFROG_HOME/artifactory/app

  7. Re-install as a Service (if applicable): If Artifactory was installed as a service previously, reinstall it to ensure the new version starts correctly. Otherwise, a restart of the server may lead to the older version of Artifactory starting up.

    cd $JFROG_HOME/artifactory/app/bin
./installService.sh

  8. Add your Database Connector (if required): Add your database connector to $JFROG_HOME/artifactory/var/bootstrap/artifactory/tomcat/lib if required. For example, if your database is MySQL, you need to add the MySQL connector before starting Artifactory services.

  9. Start Artifactory: Start the Artifactory service.

    sudo systemctl start artifactory.service

    Alternatively, you can manage Artifactory using the control script:

    $JFROG_HOME/artifactory/app/bin/artifactoryctl start|stop|check

  10. Verify the Upgrade:

    • Access UI: Access http://<SERVER_HOSTNAME>:8082/ui/ in your browser to verify the UI loads.
    • Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

Troubleshooting and Post-Upgrade Notes

  • Database Migrations: During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema.

Updated 2 days ago