Preflight Checks for Installation and Upgrade

Updated: June 2025

Audience: Self-hosted System Administrators

Environmental details: Self-hosted Airgap and Internet - KOTS

Summary

We introduced changes to the preflights with Jama Connect version 9.17. The v3 application server preflight check now warns if the hard disk is smaller than 256 GB and examines the /var directory to ensure it is not a symbolic link. The v3 database server preflight check queries your databases for collation settings and recommends running a supplied database migration script if it finds a collation other than utf8mb4_0900_ai_ci. Note that running the v3 database server preflight check now requires you to include tenant, host, port, user, and password arguments.

Jama Connect Release Notes

Perform KOTS preflight installation checks for upgrades. Run KOTS preflight installation checks for an upgrade. If your system is internet-enabled or air-gapped, ensure its readiness.

The pre-installation checks ensure all server requirements prevent installation and upgrade issues. You may install Jama Connect® once the results display green checkmarks for each test. 
If you run into issues during installation and submit a support request, please run the preflights and attach the outputs to the ticket submission for quicker issue isolation and resolution.

Running Preflight Checks Documentation