Updated: September 2024
Audience: Everyone
Environmental details: Jama Connect 8.74.1+ Self-Hosted, Replicated - KOTS
Summary
When the kURL script fails to install KOTS, and you can't access the Replicated Admin Panel, you can run a script to generate a Host Support Bundle. This can be done in either an air-gapped or internet-enabled environment. The resulting file contains essential information. I've included more details about its contents and appearance below.
Problem
KOTS installation failed mid-install with the kURL script, leaving only part of the cluster constructed. Kotsadm pods are missing, and the support bundle command fails.
Solution
- Depending on your environment, you need to either:
- Manually download the YAML file and run it from the Application server: https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/host/default.yaml and install with
kubectl support-bundle /path/to/host/default.yaml
-
OR download at runtime if the Application server is internet enabled:
kubectl support-bundle https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/host/default.yaml
- Manually download the YAML file and run it from the Application server: https://raw.githubusercontent.com/replicatedhq/troubleshoot-specs/main/host/default.yaml and install with
- The support bundle will output a simple analysis on the screen, as well as generate a support bundle with a name like
replicated-support#########.tar.gz
- You can open the support bundle with your editor of choice. There are many files in the bundle:
(See Exploded file structure) - The most crucial section is under "host-collectors" > "run-host."
Here, you'll find the tests that were run against the app server. In the case of my example, many files in here reported errors or were not installed, prompting questions about which user ran the kURL script, which pre-setup instructions were completed, and if they did the pre-flight checks (Screenshot)
Cause
Make sure to set up the environment correctly, avoid overly strict security settings, and ensure all prerequisites are met.
Additional Documentation and Resources:
Feedback: Please leave feedback in the comments below.
Related to
Comments
0 comments
Article is closed for comments.