Oracle Cloud Infrastructure Documentation

Support Bundles

Support bundles are files of diagnostic data collected from Private Cloud Appliance, which are used to evaluate and fix problems.

Support bundles can be uploaded to Oracle Support automatically or manually. They are uploaded securely and contain the minimum required data: system identity (not IP addresses), problem symptoms, and diagnostic information such as logs and status. Support bundles can be created and not uploaded. You might want to create a bundle for your own use. Creating a support bundle is a convenient way to collect related data.

Support bundles are created and uploaded in the following ways:

  • Oracle Auto Service Request

    ASR automatically creates a service request and support bundle when certain hardware faults occur. The service request and support bundle are automatically sent to Oracle Support, and the Private Cloud Appliance administrator is notified. See Oracle Auto Service Request (ASR).

  • Service CLI asrInitiateBundle command

    The asrInitiateBundle command is a Service CLI command that creates a support bundle, attaches the support bundle to an existing service request, and uploads the support bundle to Oracle Support. See Collecting Support Bundles from the Service CLI.

  • Oracle Linux tool support-bundles on management node

    The support-bundles command is a management node command that creates a support bundle of a specified type. Oracle Support might ask you to run this command to collect more data related to a service request, or you might want to collect this data for your own use. See admin-supportbundles-tool.htm.

  • Manual upload to Oracle Support

    Several methods are available for uploading support bundles or other data to Oracle Support. See admin-supportbundle-upload.htm.

Collecting Support Bundles from the Service CLI

The asrInitiateBundle command is a Private Cloud Appliance Service CLI command that creates a support bundle, attaches the support bundle to an existing service request, and uploads it.

The asrInitiateBundle command takes three parameters, all required:

PCA-ADMIN> asrInitiateBundle mode=triage sr=SR_number bundleType=auto

A triage support bundle is collected and automatically attached to service request SR_number. For more information about the triage support bundle, see admin-supportbundles-tool.htm#admin-support-bundles-tool__supbundles-triage-mode.

If the ASR service is enabled, bundleType=auto uploads the bundle to Oracle Support using the Phone Home service. For information about the Phone Home service, see Registering Private Cloud Appliance for Oracle Auto Service Request.

The bundle is saved on the management node for two days after successful upload. See admin-supportbundles-tool.htm.

If you specify mode=native and do not specify any value for nativeType, then a ZFS_BUNDLE is uploaded.