How to generate a support bundle

1. Find the “generate_support_bundle.sh” script

Login to Hyperscale VM for which you want to generate the support bundle.
generate_support_bundle.sh” file is bundled with the release tar file. You can find this script under tools/support-scripts folder, (present under the directory, where you will untar the release tar file on Hyperscale Engine). For example, /path_to_untarred_hyperscale_product/tools/support-scripts.

Example:

BASH

dlpxuser@delphix:~/test$ cd tools/support-scripts/
dlpxuser@delphix:~/test$ ls -ltr
total 48
-rwxr-xr-x  1 delphix  staff   823 Jul  7 09:55 generate_support_bundle.sh
-rwxr-xr-x  1 delphix  staff   463 Jul  7 09:55 container_information.sh
-rwxr-xr-x  1 delphix  staff  5597 Jul  7 09:55 collect_container_support_info.sh
-rw-r--r--  1 delphix  staff  5316 Jul  7 09:55 README.md

2. Modify the “container_information.sh” script parameters

Change the container_names, mount_path, and docker_compose_file_path accordingly. The container_names should be in the same order as mentioned in the below example.

Example:

BASH

container_names=(hyperscale-masking-controller-service_1  hyperscale-masking_unload-service_1 hyperscale-masking_masking-service_1 hyperscale-masking_load-service_1)
mount_path=/home/delphix/hyperscale
docker_compose_file_path=/home/delphix/docker-compose.yaml

container_names: Can be found by running docker ps command.
mount_path: Absolute path configured for mount directory in docker-compose file which is mapped to /etc/hyperscale.
docker_compose_file_path: Absolute path for docker_compose.yaml file.

3. Execute the “generate_support_bundle.sh” script

Execute the “generate_support_bundle.sh” script from tools/support-scripts/folder.

Example:

BASH

dlpxuser@delphix:~/test/tools/support-scripts/$ ./generate_support_bundle.sh
....
Generating support bundle tar file...
....

Enter the “Password” when prompted.

4. Find the generated support bundle tar file

The resulting support bundle will be located at /etc/hyperscale/hyperscale-support-****.tar.gz inside the container. This means the tar file is generated under a path that is mapped to /etc/hyperscale in docker-compose file and is directly accessible from Hyperscale VM.

Example:

BASH

dlpxuser@delphix:~/test$ ls -ltr ../hyperscale/
total 316
drwxrwxrwx 5  1004  1005   4096 Feb  9 10:14 aks-mount
-rw-r--r-- 1 65436 staff 104189 Feb 17 08:52 hyperscale-support-<current_timestamp>.tar.gz

The support bundle tar file contains the following information:

Hyperscale Logs
The output of mpstat for CPU utilization info.
The output of proc/meminfo for memory info.
The output of proc/cpuinfo for CPU info.
Files to show the memory limit for the application container and the max usage of the app container in bytes.
Redacted database file to restore the Hyperscale VM
Docker compose file

The script generate_support_bundle.sh is used to generate a bare bones support bundle from a Hyperscale engine running in docker.
Execute the generate_support_bundle.sh from the untar location.
The resulting support bundle will be located at /etc/hyperscale/hyperscale-support-****.tar.gz inside the container. This means tar file is generated under path which is mapped to /etc/hyperscale in docker-compose file and is directly accessible from Hyperscale VM.
The user should have privileges or permission to execute docker command in order to generate the support bundle.