How to Complete a Customer-Managed Installation in a Non-air-gapped Environment

Overview

This guide outlines the steps for completing an customer-managed installation in a non-air-gapped environment using an embedded cluster.

Installation Process

1. Ensure you've addressed all the prerequisites outlined in the Customer-Managed Installation Prerequisites.
2. Go to the link provided to you by Kinetic Data.
3. Continue to the Embedded Cluster Installation section.

Embedded Cluster Installation

1. Select Embedded cluster from the left-hand menu.

2. Under License, click Download license.

3. Using your desired terminal emulator, access the CLI for the node you want to install the Platform on.

4. Run the install command provided by Kinetic Data (for example, curl -sSL https://kurl.sh/kinetic-platform-application | sudo bash -s ha).

5. The installer will stop automatically if any errors are encountered. If this occurs, contact Kinetic Support.

6. The installer will pause and display the following message if any warnings are encountered:
   Host preflights have warnings It is highly recommended to sort out the warning conditions before proceeding. Be aware that continuing with preflight warnings can result in failures. Would you like to continue?
   Review and address any warning messages, then continue the installation.

7. Make a note of the URL to the admin console along with the password. You’ll use this information to log in later.
   

   Recommended: While not required, we recommend resetting the password to the admin console using the following command: kubectl kots reset-password default. Enter a new password when prompted, then use the new password to log in to the admin console.

8. Make a note of the Join command provided at the end of the script output. You’ll use this command to join all of the nodes to the cluster for high availability.

9. Run the provided Join command on every other node that will make up the cluster.
   

10. Continue to the Installing the Platform via the Configuration Admin Console section.

Installing the Platform via the Configuration Admin Console

1. Access the admin console using the URL you made a note of earlier. Log in using the provided password (or the updated password if you changed it).
2. You will be brought to the "Bypass browser TLS warning" page, which indicates that your browser may warn you that the certificate used for the page is self-signed. Follow your browser's instructions to bypass the warning message and continue to the admin console.
3. Upload a custom certificate using the on-screen instructions if desired. Otherwise, continue to Step 4.
4. On the License tab, upload the license file you downloaded earlier.
5. On the Config tab, enter the configuration information for the Platform and related applications. Required settings are marked with a yellow "Required".
6. Click Continue. This triggers Kubernetes to run preflight checks for the application.
   1. If you encounter any preflight errors, contact Kinetic Support.
7. Navigate to your load balancer URL (identified in the installation prerequisites) to access the application.
8. Log in to the application using the system username and password you specified in the admin console.