Install an Update

  Administration > System administration > Server > Install, Upgrade, and Migrate Jama > Upgrade Jama >

Install an Update

Previous pageNext page Print this topic! Mail us feedback on this topic!

An existing installation of the new deployment model can be updated to a newer version using the Admin Console. During an upgrade, the application server must have access to the internet. If your security requirements do not permit this, you should consider airgap installation as an alternative.

Your system stores old Docker images from previous versions of Jama. They may use up storage space or cause indexing to fail. To avoid this, you must periodically remove old Docker images.

1.Use a browser to navigate to Admin Console > Dashboard and make sure that the Admin Console is up to date.
2.Create a manual snapshot (see Snapshots) by selecting Start Snapshot on the dashboard.
3.If an update was already discovered, the dashboard will read "There is an update available." Select View Update and go to step 5.

update 01 - view update


4.Alternatively, if no update was already discovered, the dashboard will read: "Jama is up to date." Select Check Now.

update 02 - check now


5.If an update is discovered, the dashboard will read "Update Available." Select View Update.

update 03 - update available


6.Review the proposed update or updates and select Install Update.

Note: You may be prompted to update the Admin Console.

update 04 - release history

update 05 - installing


7.Go to the dashboard.
8.Wait for updates to the components that make up Jama to be downloaded from our private and secure registry on the Internet (pulling, downloading, pushing). The dashboard reads "Updating" during this phase.
9.Wait for the components that make up Jama to be started and initialized. The dashboard reads "Starting" then "Queued." It also shows more detailed information about the status, such as the database is updating (patching).

update 07 - queued


10.Open Jama in a new browser window by selecting Open under Started.

update 08 - started


11. Log into Jama.
12. Rebuild the search index as needed.


Note: When it is necessary to rebuild the search index for a particular update of Jama, this will be communicated separately. Rebuilding the search index is still available for a root user in the Jama application.  Rebuilding the search index can be a time-consuming operation and should be performed only when indicated.

13. Verify the satisfactory update of Jama.
14. Updating Jama is complete.