This command creates a support bundle.

Usage

supportbundle create --prefix PREFIX
                    [--preset PRESET]              
                    [--start-time TIME]
                    [--end-time TIME]
                    [--obfuscated]
                    [--aggregated]
                    [--cnodes-only]|[dnodes-only]
                    [--cnode-ids CNODE_IDs]
                    [--dnode-ids DNODE_IDs]
                    [--vippool-ids POOL_IDs]
                    [--hubble-args ARGs]
                    [--astron-args ARGs]
                    [--max-size SIZE]
                    [--text]
                    [--send-now] 
                    [--upload-via-vms]
                    [--bucket-name NAME]
                    [--access-key KEY]
                    [--secret-key KEY]
                    [--bucket-subdir DIR]
                    [--delete-after-send]

Required Parameters

--prefix PREFIX

Enter an identifying label to include in the bundle file name.

The prefix can contain up to 64 characters. Special characters are not allowed.

The name of the bundle will be bundle-<preset>-<cluster name>-<prefix>-<timestamp>.tar, where <prefix> is the prefix specified here.

For example, if the prefix is MyUrgentIssue, a bundle using the mini preset created at exactly 7:45 am UTC on September 3rd, 2020 on a cluster called cluster1 would be named bundle-mini-cluster1-MyUrgentIssue-2020-09-03-074500.tar.

Options

`--preset PRESET`	Specify a category (or categories) that best suits the issue for which you are creating the support bundle. Each category includes a predefined set of data objects in the support bundle. Verify with your support engineer which category is suitable for your needs. If no categories are specified, only management logs are collected. Specify one or more of the following categories as PRESET: standard (default) debug mini management performance traces_and_metrics nfs nfs4 smb s3 estore raid hardware permission_issues rca dr metadata
`--start-time TIME`	Sets the start time from which to collect information. Specify TIME in UTC+0 in the format `YYYY-MM-DD hh:mm:ss`.
`--end-time TIME`	Sets the end time for the period to collect information. Specify TIME in UTC+0 in the format `YYYY-MM-DD hh:mm:ss`. It's usually advisable to consult with the support engineer on the time frame so that you can make it as short as possible and minimize the size of the bundle.
`--obfuscated`	Converts all bundled objects to text and obfuscates them. Any data that cannot be converted to text is not included in the bundle. The following types of information are replaced with a non-reversible hash: file and directory names, IP addresses, host names, user names, passwords, MAC addresses. If this option is not specified (default), the information is not obfuscated.
`--aggregated`	Saves an aggregated bundle file on the management CNode. If this option is not specified (default), a separate bundle file is created on each CNode and DNode that is included in the bundle. The aggregated file is created in addition to the separate bundle files per node. It supplies all the information in one larger file. Unlike the separate bundle files, an aggregated bundle is not overwritten when a new support bundle is created.
`--cnodes-only`	Specify this option to collect data from CNodes only.
`--dnodes-only`	Specify this option to collect data from DNodes only.
`--cnode-ids CNODE_IDs`	Specify a comma-separated list of CNode IDs to collect data from. By default, all CNodes are included. This option cannot be used together with `--dnodes-only`.
`--dnode-ids DNODE_IDs`	Specify a comma-separated list of DNode IDs to collect data from. By default, all DNodes are included. This option cannot be used together with `--cnodes-only`.
`--vippool-ids POOL_IDs`	Specify a comma-separated list of virtual IP pools to collect data only from CNodes that are included in these virtual IP pools.
`--hubble-args ARGs`	Enter any arguments to pass to Hubble, per instructions from the support engineer.
`--astron-args ARGs`	Enter any arguments to pass to Astron, per instructions from the support engineer.
`--max-size SIZE`	Enter a maximum data limit to apply to the collection of binary trace files, in GB. You can use this option to limit the overall size of the support bundle.
`--text`	Converts all bundled objects to a text format. Any data that cannot be converted to text is not included in the bundle. This setting is enabled automatically if `--obfuscated` is specified.
`--send-now`	Sends the support bundle immediately.
`--upload-via-vms`	Uploads a non-aggregated support bundle via VMS. Otherwise, the upload is done from each node. This option is available only if `--send-now` is specified. Using this option requires a proxy to be configured with the `callhomeconfig` command.
`--bucket-name NAME`	Specifies the S3 bucket name of the destination S3 bucket.
`--access-key KEY`	Specifies the access key of a valid key pair to access the destination S3 bucket.
`--secret-key KEY`	Specifies the secret key of a valid key pair to access the destination S3 bucket.
`--bucket-subdir DIR`	Specifies the subdirectory in the destination S3 bucket to which to upload the support bundle.
`--delete-after-send`	Deletes the support bundle immediately after it has been sent successfully.

Example

This example shows creating a standard support bundle on CNodes 5 and 6:

vcli: admin> supportbundle create --prefix SB --preset standard --start-time "2022-04-18 03:00:00" --end-time "2022-04-18 03:15:00" --cnode-ids 5,6

supportbundle list

Usage

Example