Creating and Uploading a Support Bundle to Delphix (KBA1459)

Getting Started

Bundles (also referred to as Support Logs) can be generated through the Delphix Admin application (GUI) or the command line interface (CLI).

Masking logs are included in the Support Bundle if Masking is enabled on the Delphix Engine (DE). For more information see: Collecting Support Bundle and Logs on Masking Engine.

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies

Major Release	All Sub Releases
All	All

How to Create a Support Bundle using Delphix Admin GUI

1. Log in to the Delphix Admin application with the Admin user (or equivalent) credentials.
2. Navigate to Help > (System if using 4.2 or older) Support Logs.
3. Two options are presented for file transfer:
   • Transfer - This will generate the Support log bundle and attempt to upload directly to https://upload.delphix.com from the Engine. This option requires direct internet access or a functioning HTTP proxy configuration.
   • Download - This saves the bundle to your desktop. Transfer to Delphix will then be completed manually.
4. Optional: Enter Support Case Number. This is only effective in combination with the Transfer option

Note:

If there is no existing case number, please do not enter a "dummy" case number for upload, as this can cause issues in the Engine association with your organization.

5. Optional: Click the Show advanced to access the additional dialog for inclusion of Analytics data, if requested by Delphix Support.
6. Click OK. If the Download option is selected, a download dialog will be presented once generation is completed, and the bundle can be saved to local desktop for later transfer.

If the Transfer option is selected, and upload fails due to firewall or other restriction, the Bundle will need to be generated again selecting the Download option.

How to Create a Support Bundle using CLI 

1. Use SSH to access your Delphix Engine using sysadmin (or equivalent) login.

2. Navigate to 'service support bundle'.

3. Enter 'Upload'.

4. Optional: Set the 'caseNumber'. 

Note:

if there is no existing case number, please do not enter a "dummy" case number for upload, as this can cause issues in the Engine association with your organization.

5. If your version of the DE includes the ability to include Analytics information in the support bundle and you are having a performance issue, set 'includeAnalyticsData=true', or if directed by Delphix Support.
6. Submit the upload job by entering commit.

Note:

The support bundle cannot be downloaded to your desktop using the CLI Method.

ssh sysadmin@YOUR_DE
password:
YOUR_DE > service support bundle
YOUR_DE service support bundle> ls
Operations
upload
YOUR_DE service support bundle> upload
YOUR_DE service support bundle upload *> ls
Properties
    type: SupportBundleUploadParameters
    bundleType: ALL
    caseNumber: (unset)
    includeAnalyticsData: false
YOUR_DE service support bundle upload *> set caseNumber=[Support case number, if it exists]
YOUR_DE service support bundle upload *> set includeAnalyticsData=true
YOUR_DE service support bundle upload *> commit
    Dispatched job JOB-1
    SUPPORT_BUNDLE_UPLOAD job started for "sysadmin".
    Generating support bundle.
    Uploading support bundle.
    SUPPORT_BUNDLE_UPLOAD job for "sysadmin" completed successfully.

Uploading the File 

The file must be uploaded to the Delphix Support website to be reviewed by support personnel if:

• The Support Bundle log was downloaded to your desktop using the Delphix Admin application
• dmsuite.logs.gz file was created

Note:

Currently, downloading support logs from the CLI is not supported.

We recommend using Google Chrome, Firefox, or Internet Explorer 9 or newer to perform the upload.

To upload the log file:

1. Using your Web browser, navigate to https://upload.delphix.com.

2. (Optional) In the Case field, enter the Support Case Number if the bundle is being created in response to a specific support case. 
   Notification is automatically added to the case specified, once the file has been transferred and processed.

Note:

If there is no existing case number, please do not enter a "dummy" case number for upload, as this can cause issues in the Engine association with your organization.

3. Click Add Files and browse to the support bundle file.
   Alternately, you can also drag the file directly onto the Upload screen and it will automatically begin to upload.  
4. Select the file and click Start Upload.

 

Note:

Including any relevant case numbers in the file name, will help Support to locate the bundle more quickly, if Support Case Number is not populated. 

Uploading using FTP 

In the instance that upload through web interface is unavailable, an SFTP server is available for data transfer.

Site: ftp.delphix.com

User credentials can be requested as needed from Delphix Support through an existing or new case.

Note:

If using this option, put the file name in the case so it can be retrieved easily by Support. 

$ sftp <username>@ftp.delphix.com
<username>@ftp.delphix.com's password:

Connected to ftp.delphix.com

sftp> cd upload
sftp> put [FILENAME]

sftp> exit

Masking Engine 

The process above is the same for the Masking Engine. For specific details for the Masking Bundle please see Collecting Support Bundle and Logs on Masking Engine.