Skip to main content

Jama Connect User Guide

Run the KOTS preflight installation checks

Whether your environment is internet-enabled or airgapped, run the KOTS preflight installation checks to ensure your system is ready for upgrade.

Important considerations

  • The preflight checks verify that all server requirements are met to help avoid installation and upgrade issues. When the results display green checkmarks for each test, you can begin the installation process.

  • If you are performing an in-place upgrade to 8.79.6, 9.0.4, or 9.6.x, the warning and failure messages displayed during preflight are expected and can be ignored.

    warnings.png

To run preflight checks for internet-enabled environments:

  1. Run the command on your application server:

    curl -s https://raw.githubusercontent.com/JamaSoftware/kots-preflights/main/v2/non-airgap/\
application-server.sh | sudo bash

  2. Run the command on your database server:

    curl -s https://raw.githubusercontent.com/JamaSoftware/kots-preflights/main/v2/non-airgap/\
database-server.sh | sudo bash

  3. Press S to save the file, then review the results.

  4. Submit an Installation Service Request Form (guided for Self-Hosted) and include your preflight check results to help our technical services team support your installation needs. Include any questions or concerns about the results in the ticket.

To run preflight checks for airgapped environments:

  1. From an internet-enabled server

    1. Download the preflight script files for the application server:

      curl https://raw.githubusercontent.com/JamaSoftware/kots-preflights/\
main/v2/airgap/linux/airgap-host-preflight_linux.tar.gz --output airgap-host-preflight_linux.tar.gz

      curl https://raw.githubusercontent.com/JamaSoftware/kots-preflights/\
main/v2/airgap/linux/airgap-application-server_linux.sh --output airgap-application-server_linux.sh

    2. Download the preflight script files for the database server:

      curl https://raw.githubusercontent.com/JamaSoftware/kots-preflights/\
main/v2/airgap/linux/airgap-database-preflight_linux.tar.gz --output airgap-database-preflight_linux.tar.gz

      curl https://raw.githubusercontent.com/JamaSoftware/kots-preflights/\
main/v2/airgap/linux/\
airgap-database-server_linux.sh --output airgap-database-server_linux.sh

  2. From your application server

    1. Save both application server script files to a directory on the airgapped application server that will host your KOTS installation, then configure the file permissions for the shell script:

      chmod +x <path to the files>/airgap-application-server_linux.sh

    2. Run the preflight installation check:

      sudo bash <path to the files>/airgap-application-server_linux.sh

    3. Press S to save the file, then review the results.

  3. From your database server

    1. Save both database server script files to a directory on the airgapped Jama Connect database server, then configure the file permissions for the shell script:

      chmod +x <path to the files>/airgap-database-server_linux.sh

    2. Run the preflight installation check:

      sudo bash <path to the files>/airgap-database-server_linux.sh

    3. Press S to save the file, then review the results.

  4. Submit an Installation Service Request Form (guided for Self-Hosted) and include your preflight check results to help our technical services team support your installation needs. Include any questions or concerns about the results in the ticket.

In this section: