Preflight installation and upgrade checks MUST be run Replicated - KOTS

Amanda Jennewein
Amanda Jennewein
  • Updated

Updated: June 2024

Audience: Everyone

Environmental details: Self-hosted Air-gapped and Internet, Replicated - KOTS

Summary

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.

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 a Jama Connect® Self-Hosted Support Request Form 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 air-gapped 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 air-gapped 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 air-gapped 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 a Jama Connect® Self-Hosted Support Request Form 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.

 

NOTE: If you are participating in an Annual Success Program or have Installation, Migration, or general services hours, you can submit a guided service request:

(a) Installation Service Request Form (guided for Self-Hosted)

(b) Upgrade Service Request Form (guided for Self-Hosted)

(c) Migration Service Request Form (guided for Self-Hosted) 

If you are not enrolled in an Annual Success Program and do not have Services but are interested in obtaining more information, don't hesitate to contact your Jama Software® Customer Success Manager.

Jama Connect® User Guides and Self-Hosted Resources: Learn how to access and share specific pages and unique URLs easily

Feedback: Please leave feedback in the comments below.

 

Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.