Knowledge Base

 View Only

Newer Documentation Available (link below) - Incremental Step Upgrade for Jama 8.x and Beyond - Self-Hosted

By Decoteau Wilkerson posted 10-16-2020 08:03


*NEW DOCUMENTATION -  Jama Connect® 8.x Upgrade Checklist and Process Documentation

Note: For upgrades with older versions of Jama prior to 8. x (such as 2015), please visit Education > System Administration for more information.

We recommend performing incremental upgrades to each major version change before proceeding to our latest release. There have been many changes between your version and our most recent release that need to be applied to the different major versions of Jama.

*NEW DOCUMENTATION -  Jama Connect® 8.x Upgrade Checklist and Process Documentation

We have found the following path of upgrades to be the most successful for customers upgrading to the current release: 

Required Upgrade Pathway Order

MySQL version 8 is required for releases 8.71.1+

  • You must reindex after reaching your desired version. 
  • ** Before you can install or upgrade to the Jama Connect 8.62+ release, we recommend that you first create two new database schemas to support the new SAML and OAuth authentication options. Please review the "Notes to Self-Hosted Administrators"  in the 8.62.4 release notes for specific instructions: Jama Connect 8.62.4 Release Notes
  • For all version upgrades, please review Release Notes for more specific information. 

    Important Considerations
    • We recommend following standard upgrade procedures in between each step. For example:
      • First, check to see if you need to run a curl, specified in the Admin Notes of the Release Notes
      • Log into your Jama Console, select the desired version, and choose your incremental step upgrade.
      • After reaching your desired version, you must log in to your Jama Root menu and reindex.
      • If you decide to stop at one of these versions, please make sure to check for any hotfix versions. Hot fixes are made to fix defects for any particular release.
      • Most of our upgrades require landing on the .00 version of any release before upgrading to a hotfix version of that release, with the exception of 8.56.1 (there is no .00 version for this release).
      • Please see the Notes for Self-Hosted Administrators in our Community Release Notes. This is suggested as each step upgrade will require a specific set of required actions for a successful upgrade. This script is not required with 8.49.3+.

            Tips for Users

            • If possible, we suggest performing upgrades on a test instance first. 
            • We recommend taking a backup of your instance in the event that your instance crashes during the upgrade.
            • Schedule the upgrade when all of your users are logged off and where there is minimal traffic on the server hosting your Jama instance.
            • If you have any more questions, you're welcome to open a ticket and request to schedule a one-hour call to review the upgrading process. We recommend that a  Named Support Contact and the person performing the actual upgrade be on the call.




            03-27-2023 10:47

            Hello Abubakar,

            Thank you for reaching out to gain guidance for the incremental step upgrade process. Please see this newer link on the Support Site,   Jama Connect® 8.x Self-Hosted Traditional Upgrade Checklist and Process Documentation

            1. In certain releases, we make changes that must be applied and reindexed before the next set of changes can get applied.  This is typically for a major change to the DB, such as in 8.62 with the new database schemas to support a packaged SAML implementation.  These are typically infrequent, and staying consistently on supported release minimizes the likelihood of this occurring.  8.25 to 8.79 is a 4+ year jump and requires the step upgrades, vs. 8.66 (latest supported version) to 8.79 is a direct path.   

            03-27-2023 03:18

            Hello Decoteau ,

            We are on 8.62.4 version of airgap (on-premises Jama connect). Do we need to directly upgrade from 8.62.4 to latest version?

            Let me also know which is the stable latest version of Jama  connect (on-premises).