To make the upgrade process as smooth as possible we recommend following the checklist below. Once you've done all of these, you're ready to go!
- Review upgrade documentation
- Before diving into the upgrade, read each step of the documentation so you don't end up with surprises down the road.
- Read the systems requirements chart
- Always make sure that your system can support the new version requirements, it is an essential step in order to keep the system running smoothly.
- Ensure that Artifactory is not running on a Networked File System (NFS), latency from an NFS will result in Artifactory failing to start
- Review our release notes for any breaking changes between the source version and the target version
- Make sure that the host OS is still supported for the target version
- In Artifactory versions 7.77.3 and above the product will officially run with Node.js 20.x on all installation types, as such the following fully deprecated OS are no longer supported:
- Ubuntu 18.04 (has reached End of Standard Support on May 31, 2023).
- RHEL 7.x - Red Hat Enterprise Linux 7.x (has reached End of Full Support on 2019)
- Centos 7.x (has reached End of Active Support on 2020).
- Suse Linux Enterprise Server (SLES) 12 SP5 ( will reach End of Standard Support on October 31, 2024)
- Amazon Linux 2 (no support for Node.js 20x)
- In Artifactory versions 7.77.3 and above the product will officially run with Node.js 20.x on all installation types, as such the following fully deprecated OS are no longer supported:
- If we're using a Non-PostgreSQL Database and upgrading from a version below 7.84 to a version above, make sure that the following snippet was added to the system.yaml file:
shared:
database:
allowNonPostgresql: true
- Back up the database
- Often as Artifactory grows, the database schema changes along. Having a backup on hand will save you a lot of trouble if you have to revert to your previous version.
- This guide will help you if your system is larger than 1TB, otherwise, use this guide for assistance in doing a database backup.
- Back up the filestore
- That is where your binaries are actually located, so having a backup can be a lifesaver. Using Kubernetes? Back up your PVC instead.
- That is where your binaries are actually located, so having a backup can be a lifesaver. Using Kubernetes? Back up your PVC instead.
- Try the upgrade on a test server
- A test server will save you time and worries by helping you catch bugs or unexpected outcomes without impacting your production environment.
- A test server will save you time and worries by helping you catch bugs or unexpected outcomes without impacting your production environment.
- Set up a maintenance window to let your users know that Artifactory will be inaccessible for the time of the upgrade.
Good luck with your upgrades!