Skip to main content

Jama Connect User Guide

Update the Jama Connect KOTS platform (internet)

Before you can deploy Jama Connect 9.17.x, you must first update the Jama Connect KOTS platform (referred to as an in-place upgrade).

  • When upgrading from Jama Connect 9.0.1–9.0.3 and 8.79.1–8.79.6, you are required to first run a pre-upgrade script, then run the Kubernetes (kURL) installer. After you run the script and installer, new versions of Jama Connect can be deployed from the KOTS Admin Console.

  • When upgrading from Jama Connect 9.04 and later, 8.79.7 and later, or 9.6.0 and later, you don't need to run a pre-upgrade script.

Important considerations

  • If upgrading from Jama Connect 9.0.1–9.0.3 and 8.79.1–8.79.6, make sure that the file system on your primary node/application server has enough free space to support a data migration of the assets associated with your Jama Connect instance. Measure the disk space occupied by the var/lib/longhorn directory (du /var/lib/longhorn) and confirm that the disk has twice that amount available.

  • Expect downtime. Upgrade during off hours to minimize the impact.

  • The Kubernetes (kURL) installer is interactive and prompts you to confirm some of the steps. Depending on the number of remote nodes in your environment, expect this part of the upgrade process to take at least two hours.

  • If you have dedicated Elasticsearch nodes, you are prompted to run separate installer commands on the secondary nodes during the installation.

  • Recommended — Run the install commands inside a terminal multiplexer session to keep the session active in the event that the connection is dropped or the terminal is closed.

To update the Jama Connect KOTS platform:

  1. Back up your Jama Connect instance.

  2. Download prepare-for-longhorn-to-openebs-upgrade.sh from GitHub.

    Important

    Skip this step if you are upgrading from Jama Connect 9.0.4 and later, 8.79.7 and later, or 9.6.0 and later.

  3. On the primary node, run the shell script downloaded in step 2 as a user with adequate privileges:

    bash prepare-for-longhorn-to-openebs-upgrade.sh

    Important

    Skip this step if you are upgrading from Jama Connect 9.0.4 and later, 8.79.7 and later, or 9.6.0 and later.

  4. Run the kURL installer:

    Important

    The kURL installer is interactive and prompts you to continue several times throughout the upgrade process. Kubernetes is upgraded incrementally in steps from version 1.29 and requires you to confirm several of the steps before proceeding to the next version.

    1. From the command line on the primary node/application server, enter the following command to initiate the installation:

      curl -sSL https://kurl.sh/jama-k8s-standardkots | sudo bash -s

    2. Prepare your instance for the new Jama Connect release. This command deletes targeted KOTS resources, which is required before deploying the new version of Jama Connect.

      kubectl delete sts/activemq sts/core sts/diff sts/elasticsearch sts/hazelcast sts/oauth \
sts/saml sts/search sts/nginx sts/core-ingress sts/core-reports sts/core-jobs \
jobs/tenant-manager pvc/volume-oauth-0 pvc/volume-saml-0

      Important

      Skip this step if you are upgrading from Jama Connect 9.0.4 and later, 8.79.7 and later, or 9.6.0 and later.

  5. Upgrade Jama Connect.

In this section: