Generating a DataStax Mission Control Support Bundle
DataStax Mission Control is current in Private Preview. It is subject to the beta agreement executed between you and DataStax. DataStax Mission Control is not intended for production use, has not been certified for production workloads, and might contain bugs and other functional issues. There is no guarantee that DataStax Mission Control will ever become generally available. DataStax Mission Control is provided on an “AS IS” basis, without warranty or indemnity of any kind.
If you are interested in trying out DataStax Mission Control please contact your DataStax account team.
The Admin Console that is installed as part of DataStax Mission Control provides a Troubleshoot tab where you can generate an analysis and review remediation suggestions for troubleshooting DataStax Mission Control. You can also download a support bundle to share with your account team at DataStax.
Create a Support Bundle using the Admin Console
From the Admin Console, select the Troubleshoot tab.
Click Analyze to start analyzing DataStax Mission Control.
The analysis executes the support bundle plugin. After the analysis completes, the bundle is available on the Troubleshoot tab in the Admin Console. Any known issues that are detected are highlighted with possible remediation suggestions.
No data leaves the cluster. Data is never sent across the internet or to anyone else.
Optional: Click Download bundle to download the support bundle. You can send the bundle to DataStax for assistance.
Create a Support Bundle using the Command Line Interface (CLI)
Create a support bundle using one of the following methods, depending on your environment or situation.
With the Default kots.io Specification
To use the default
kots.io specification, run the following command to create a support bundle:
kubectl support-bundle https://kots.io
On an Air Gap Server
If you are on an air-gapped server, perform the following steps to create a support bundle:
Run this curl command from a computer with internet access to download the default
curl -o spec.yaml https://kots.io -H 'User-agent:Replicated_Troubleshoot/v1beta1'
spec.yamlfile to the air-gapped server.
kubectlcommand to create a support bundle using the uploaded
kubectl support-bundle <location>spec.yaml
When the Admin Console and DataStax Mission Control are installed
If the admin console is running and DataStax Mission Control is installed, then run the following command to create a support bundle that includes any customization specific to DataStax Mission Control from the
support-bundle.yaml manifest file:
kubectl support-bundle http://<server-address>:8800/api/v1/troubleshoot/<app-slug>
When DataStax Mission Control is not installed
If DataStax Mission Control is not installed but the Admin Console is running, then run the following command to create a support bundle with additional customization from the Admin Console:
kubectl support-bundle http://<server-address>:8800/api/v1/troubleshoot
Generate a Host Support Bundle
For Kubernetes installer provisioned clusters (embedded clusters), you can generate a host support bundle to help troubleshoot a cluster that is down. DataStax provides you with a host support bundle YAML file that you run with a command to generate the host support bundle.
Root access is typically not required to run the host collectors and analyzers. However, depending on what is being collected, you might need to run the support-bundle binary with elevated permissions. For example, if you run the
filesystemPerformance host collector against
/var/lib/etcd and the user running the binary does not have permissions on this directory, the collection process fails.
To generate a host support bundle:
Install the support-bundle plugin. See Install the Support Bundle Plugin.
Save the host support bundle YAML file from DataStax on the host. For air gap environments, download the file and copy it to the air gap machine.
Run the following command on the host to generate a host support bundle:
./support-bundle --interactive=false <location>/<filename>.yaml
<location>with the path to the host support bundle YAML file.
<filename>with the name of the host support bundle YAML file from DataStax.
Share the host support bundle with the DataStax account team.
Repeat these steps for each node because there is no method to generate host support bundles on remote hosts. If you have a multi-node Kubernetes cluster, then you must run the support-bundle binary on each node and generate a host support bundle for each node.