How to generate a support bundle (Podman Compose)

If it is not already installed, you must install bash shell and yq to generate a Hyperscale support bundle. For more information on downloading yq, refer to the yq Downloads page on GitHub.

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:

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

Uncomment following 3 lines in file.

shopt -s expand_aliases
alias docker=podman
alias docker-compose=podman-compose

Change the mount_path and docker_compose_file_path accordingly.

Example:

mount_path=/home/delphix/hyperscale
docker_compose_file_path=/home/delphix/podman-compose.yaml

mount_path: Absolute path configured for mount directory in podman-compose file which is mapped to /etc/hyperscale.
podman_compose_file_path: Absolute path for podman_compose.yaml file.

3. Execute the “generate_support_bundle.sh” script

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

Example:

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 the path which is mapped to /etc/hyperscale in podman-compose file and is directly accessible from Hyperscale VM.

Example:

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
podman compose file

The script generate_support_bundle.sh generates a bare-bones support bundle from a Hyperscale engine running in podman.
Execute the generate_support_bundle.sh from the untar location.
The resulting support bundle will be 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 podman-compose file and is directly accessible from Hyperscale VM.
The user should have privileges or permission to execute the podman command in order to generate the support bundle.