This document outlines all required incremental steps that an existing Jama Connect 8.x customer should go through to successfully upgrade their self-hosted installation of Jama Connect.
Required Upgrade Pathway Order
1. 8.x to 8.36
If you run into issues during the upgrade process, stop what you're doing, and follow these steps:
1. Review the system requirements and supported software to ensure you're meeting the requirements.
2. Review the database server requirements to ensure you set up and configured the databases correctly.
3. Ensure your database server and application server can access each other.
4. You must reindex after reaching your desired version.
If these components are configured correctly, contact Jama Software Customer Support for help.
Step 1: Make Backups and Inform Users of Downtime Prior to Upgrading
- Database backup
- My SQL - take a MySQL dump
- SQLServer - proprietary dump
- Data directory backup
- Make a copy of the data directory and store it in the location
- Replicated Snapshot
- Option in Replicated Admin Console; check yes to save settings to revert back to in cases of rollback
- Prepare for maintenance mode and create a customer downtime plan
Step 2: Overview the Upgrade Plan with Your Jama Consultant
Review the following high-level steps with your Jama Consultant to fully understand roles/responsibilities:
- Put Jama Connect into maintenance mode and ensure users were notified of planned outage (Customer)
- Perform step upgrade activities (Customer)
- Once on the targeted upgrade version, log in as the root user and then perform a full re-index
- Disable maintenance mode and release Jama Connect to users
Step 3: Confirm System Requirements
Activity | Comments/Actions |
|
|
|
|
|
|
|
|
|
|
|
|
Step 4: Commence Step Upgrade(s)
- For each incremental step, it's crucial to make sure you check the specifics for each step outlined below -- the required step upgrades are as follows:
8.x to 8.36.0 Upgrade Checks
- Run
curl -sSL "https://get.jamasoftware.com/docker?replicated_tag=2.32.2" | sudo bash -s no-auto
.- This updates both Docker and Replicated and readies the Jama Connect upgrade to version 8.36.0.
- This updates both Docker and Replicated and readies the Jama Connect upgrade to version 8.36.0.
- Visit the Replicated admin console, then check for updates and commence the upgrade by clicking on the link for version 8.36.0
- Instructions can be found in the Jama Connect User Guide HERE
8.36.0 to 8.49.0 Upgrade Checks
- The sysctl.conf file must be edited through - /etc/sysctl.conf
- Instructions can be found in the Jama Connect User Guide HERE
- Instructions can be found in the Jama Connect User Guide HERE
- Run
curl -sSL "https://get.jamasoftware.com/docker?replicated_tag=2.42.5" | sudo bash -s no-auto
- This updates both Docker and Replicated, and readies the Jama Connect upgrade to version 8.49.0
- This updates both Docker and Replicated, and readies the Jama Connect upgrade to version 8.49.0
- Visit the Replicated admin console, then check for updates and commence the upgrade by clicking on the link for version 8.49.0
- Instructions can be found in the Jama Connect User Guide HERE
8.49.0 to 8.62.4 Upgrade Checks
- Visit the Jama Connect 8.62.4 Self-Hosted Release Notes page to update your database per the outlined NEW database requirements (including schemas and possible additional database details).
- Instructions for both MSSQL and MySQL are outlined in this doc.
- Please make sure to follow all instructions outlined, based on the database that you are using!
- Run
curl -sSL “https://get.jamasoftware.com/docker?replicated_tag=2.51.0" | sudo bash -s no-auto
- This updates both Docker and Replicated and readies the Jama Connect upgrade to version 8.62.4
- This updates both Docker and Replicated and readies the Jama Connect upgrade to version 8.62.4
- Visit the Replicated admin console, then check for updates and commence the upgrade by clicking on the link for version 8.62.4
- Instructions can be found in the Jama Connect User Guide HERE
8.62.4 to Current Release Upgrade Checks
- 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
- When upgrading to the current version, Jama stops supporting MySQL versions prior to MySQL 8
- Run
curl -sSL “https://get.jamasoftware.com/docker?replicated_tag=2.53.2" | sudo bash -s no-auto
- This updates both Docker and Replicated and readies the Jama Connect upgrade to the current version
- This updates both Docker and Replicated and readies the Jama Connect upgrade to the current version
- Visit the Replicated admin console, then check for updates and commence the upgrade by clicking on the link for the current version
- Instructions can be found in the Jama Connect User Guide HERE
Step 5: Final Upgrade Steps
- Once you are on the targeted upgrade version, please log in as the root user then perform the steps outlined HERE to re-index.
- You do not need to re-index after each incremental upgrade, only once you have attained your targeted upgrade version
Troubleshooting Tips/One-Off Scenarios
Unable to Find Updated Versions Available to Upgrade to
- Contact Jama Customer Support
Reindexing Failures or Errors
- Update Advanced Startup Settings
jmsactivemq.memoryusage=2048000000
-
jamasearch.reindexBrokenItemThreshold=10000000
-
jamasearch.enabled=true
-
jamasearch.backgroundbatchindex.enabled=true
-
jamasearch.multithreadindex.chunksize=500
-
jamasearch.multithreadindex.enabled=true
-
jamasearch.multithreadindex.poolsize=5
Docker-Specific Errors or Issues
- Try these commands to ensure that the recommended Docker version is in the repo for production
yum list docker-ce --showduplicates
yum-config-manager \
--add-repo \
Comments
0 comments
Please sign in to leave a comment.