Generating a support bundle

Find the “collect_bundle.sh” script

• The support bundle tar file is available on the downloads site.

• Once the file is downloaded, untar the file to find the script.

dlpxuser@delphix:~/test$ tar -xzvf dct-support-bundle-1.0.1.tar.gz
x ./
x ./collect_bundle.sh
x ./README
x ./VERSION

Execute the “collect_bundle.sh” script when DCT is running in Kubernetes

• Transfer the "collect_bundle.sh" script to the machine where you have permissions to execute kubectl commands against the DCT pods.

You must install the bash shell to generate a DCT support bundle, if it is not already.

• Execute the “collect_bundle.sh” script, which assumes a Kubernetes deployment by default. The script may need to run with "sudo", if root permissions are needed to run the kubectl commands.

• If the namespace is not the default "dct-services", use the "-n" flag and pass the correct namespace.

dlpxuser@delphix:~/test/tools/support-scripts/$ ./collect_bundle.sh -n <custom_namespace>
....
DCT support bundle collection started at Thu Jun 22 12:35:05 EDT 2023
Collecting logs from all DCT containers...
....

Execute the “collect_bundle.sh” script when DCT is running in Docker-Compose

• Transfer the "collect_bundle.sh" script to the machine where you have permissions to execute docker commands against the DCT Docker-Compose application.

You must install the bash shell to generate a DCT support bundle, if it is not already.

• Execute the “collect_bundle.sh” script with the "-d" parameter. The script may need to run with "sudo", if root permissions are needed to run the docker commands.

dlpxuser@delphix:~/test/tools/support-scripts/$ ./collect_bundle.sh -d
...
DCT support bundle collection started at Thu Jun 22 12:35:05 EDT 2023
Collecting logs from all DCT containers...
....

Find the generated support bundle tar file

The resulting support bundle will be located at dct-support-****.tar.gz, inside the current directory. 

dlpxuser@delphix:~/test$ ls -ltr
total 316
-rw-r--r-- 1 65436 staff 104189 Feb 17 08:52 dct-support-<current_timestamp>.tar.gz

The support bundle tar file contains the following information:

• DCT logs for all of the containers.

• A java heap dump, .hprof, if one exists.

• A java thread dump and memory stats.

• The output of docker stats, if running in Docker-Compose.

• The output of cpuinfo, meminfo, and mpstat for each container, if running in Kubernetes.

• The output of kubectl get pods -o json for each container, if running in Kubernetes.

• The collect_bundle.sh generates a support bundle from a DCT engine running in Docker or Kubernetes.

• The resulting support bundle will be at ./dct-support-****.tar.gz inside the container.

• The user must have privileges or permission to execute the docker or kubectl, commands in order to generate the support bundle.