Sending support bundles

Modified: 19 Mar 2024 20:25 UTC

Triton includes a feature to create a bundle to help MNX support troubleshoot problems with your installation. This bundle includes a number of logs and configuration files from your Triton installation. This bundle can then be uploaded to a signed Manta URL that will be provided by MNX Support.

Creating a support bundle

To create a support bundle to MNX Support, follow these steps:

Log in to the global zone on the head node.

as follows:

# cd /var/tmp
# sdc-sbcreate
This tool will create an SDC support bundle in /var/tmp/sdcsb.83346.
This may take some time...  If you wish to abort press CTRL-C now!
Starting in 0 seconds...
==> Gathering System Information
  > sysinfo
  > hardware configuration
  > datalink info
  > network interface info
  > routing table
  > auditlog info
  > services
    (all services)
    (global service archive)
    (service archive for d1381f53-fe59-4071-a242-3ff9d5cfc230)
    (service archive for 11e27b4f-52f3-4c58-be4f-ac750753d033)
    (service archive for 07d3b16d-22d4-4ace-8fa8-416852fdbd3c)
    (service archive for 1f76fc70-09cf-45ac-8a26-2649fc5260d8)
    (service archive for d8adf5ed-dc3d-4f40-9bfa-d0857f6e7288)
    (service archive for b9d79fdb-0739-4255-b9ad-d4dec3ba37c4)
    (service archive for 9137056f-6a49-436f-a9d1-7ee8be752357)
    (service archive for 7c3129a6-a8b0-4c12-9cac-2ca7b04f238f)
    (service archive for e4c35fb1-3468-4b03-9123-d50de5d5aec6)
    (service archive for ecfc78b6-252c-460e-b0d4-03679f3762c4)
    (service archive for 24007ce2-d44a-4d6d-8f1a-4c49f7cbe1d4)
    (service archive for 5c935e62-9ad5-4283-b08e-6198d1833568)
    (service archive for d4648122-9475-4294-a87c-84effd38d741)
    (service archive for 146956bc-979c-4fb2-b2eb-b580b9822737)
    (service archive for 8bf6d49e-e6d4-4eb5-8d9f-6be672e6a271)
    (service archive for 4646badf-098a-41ba-b9ab-e3e06946d6e9)
    (service archive for d6c6d26f-9b89-49b3-aba5-428ce1ec6df4)
    (service archive for 352fc730-7ca2-4049-8cd5-4cddcea49923)
    (service archive for 70342c13-c2d4-45ad-b81f-f1ab6ec7da70)
    (service archive for 069caca7-94dc-4ebb-9579-cc223e44d3ab)
    (service archive for 53d6be80-18f4-4703-aafb-34c87095de65)
    (service archive for 66746bfd-391f-492c-9f8e-5c894fe6e671)
    (service archive for 87a57538-6c5d-4d18-8ae5-c70ed561a1b4)
    (service archive for e83ba7cb-dd8d-477d-bfcf-2528d82ba35e)
  > process information
  > zfs info
    (zpool status)
    (zfs list)
    (iostat -e)
  > disk utilization
  > module information
  > usbkey filelist
  > zone list
  > zone kernel state
  > zone configs
  > zone logs
  > cores
  > kernel crash dumps
  > fmdump
  > logs
  > kernel & platform integrity hash
  > app zone config
  > fmd
  > disk list
  > zpool history
  > rabbitmq status
  > images
  > vms
  > servers
  > agents
==> packing data to /var/tmp/sdc-support.headnode.20140314T124856Z.tar.bz2
==> cleaning up
==> packing data to /var/tmp/sdc-support.headnode.20140314T124856Z.tar.bz2

Uploading the Support Bundle using the filename shown in this line in the above output

After creating the support bundle, file a ticket by emailing help@mnxsolutions.com. In the ticket please include the filename with the full path. You will then be provided with a signed Manta URL and a curl command to upload the support bundle to a secure location. A non-working example is provided below:

curl -k -X PUT -T /var/tmp/sdc-support.headnode.20140314T124856Z.tar.bz2 'https://us-central.manta.mnx.io/support/stor/sdc-support.headnode.20140314T124856Z.tar.bz2?algorithm=RSA-SHA1&expires=1399483110&keyId=%2Fmnx.support%2Fkeys%2F6b%3A95%3A03%3A3d%3Ad3%3A6e%3A52%3A69%3A01%3A96%3A1a%3A46%3A4a%3A8d%3Ac1%3A7e&signature=KisFVEOxYW8gejE9duhukdE8Bx2quThf2Qf9vjPHzLNBZ0PbI%2BOL%2BJM2L%2FtgGQGWPRI%2FX6%2FzX3oY807Q1VhL0UKqsaIGszt7fvdYAuNFqnS2Bp9knry08Dp82eTt4Qq36zsOOdwyDTu5zayRIqEPrO5XtLgR4q7CohWaxMxrSZhuQDs8cp%2FbHwfjFh9SH5GteBXWzPWNlKznguOMEcdGNT4P9VIEVAEkXyz9qovg2mqXmkr7DIXpn72O2gGYzeyXU74R%2FoNOlgvlAMe45aYerMk%2BV1b91AzsilZeWBLIwaq8x%2BpRgku28zhlOVxrxXddWE5yWREM4YHyMxZkaOHH1w%3D%3D'

Creating a support bundle on a compute node and uploading to MNX Support from the head node

If you are creating a support bundle on a compute node you need to transfer it to the head node to be uploaded to MNX Support. Follow these steps:

Get the hostname and IP address of the compute node.

Login to the head node global zone.

.

# sdc-oneachnode -n 78-2b-cb-0a-75-23 sdc-sbcreate
=== Output from 44454c4c-3700-1039-8034-c2c04f445131 (78-2b-cb-0a-75-23):
This tool will create an SDC support bundle in /var/tmp/sdcsb.78896.
This may take some time...  If you wish to abort press CTRL-C now!
Starting in 0 seconds...
==> Gathering System Information
  > sysinfo
  > hardware configuration
  > datalink info
  > network interface info
  > routing table
  > auditlog info
  > services
    (all services)
    (global service archive)
    (service archive for d8f99863-b45a-c1a4-df12-ca98347c2bd4)
    (service archive for 8d44d9e9-fa70-462e-b355-02b077e8556c)
    (service archive for 15161bd5-a5c4-40f7-967e-d3b9f6ec64fd)
    (service archive for fd44546b-154d-6098-e96d-88805c802270)
    (service archive for f12ecbd6-b615-eb7d-c0b8-94df68378932)
    (service archive for 4985f9fb-e674-e472-ac02-86e15242d6f7)
  > process information
  > zfs info
    (zpool status)
    (zfs list)
    (iostat -e)
  > disk utilization
  > module information
  > zone list
  > zone kernel state
  > zone configs
  > zone logs
  > kernel crash dumps
  > fmdump
  > logs
  > app zone config
  > fmd
  > disk list
  > zpool history
  > agents
==> packing data to /var/tmp/sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2
==> cleaning up
==> done
The `sdc-sbcreate` command creates the file
`/var/tmp/sdc-support..$DATE.tar.bz2`, where `$DATE` is
the date that the file was created.
  

. The file name for the bundle is shown in the above output on the line

==> packing data to /var/tmp/sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2  

# cd /var/tmp
# scp root@10.0.1.39:/var/tmp/sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2 .
Password:
sdc-support.78-2b-cb 100% |**************************************************************************************************************************************|   890 KB    00:00

Log in to the head node on the global zone.

Send the full path of the transferred support bundle in a ticket to MNX Support, and you will then be provided with a curl command to upload the bundle to secure location. A non-working example is shown below:

curl -k -X PUT -T /var/tmp/sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2 'https://us-central.manta.mnx.io/support/stor/sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2?algorithm=RSA-SHA1&expires=1399483110&keyId=%2Fmnx.support%2Fkeys%2F6b%3A95%3A03%3A3d%3Ad3%3A6e%3A52%3A69%3A01%3A96%3A1a%3A46%3A4a%3A8d%3Ac1%3A7e&signature=KisFVEOxYW8gejE9duhukdE8Bx2quThf2Qf9vjPHzLNBZ0PbI%2BOL%2BJM2L%2FtgGQGWPRI%2FX6%2FzX3oY807Q1VhL0UKqsaIGszt7fvdYAuNFqnS2Bp9knry08Dp82eTt4Qq36zsOOdwyDTu5zayRIqEPrO5XtLgR4q7CohWaxMxrSZhuQDs8cp%2FbHwfjFh9SH5GteBXWzPWNlKznguOMEcdGNT4P9VIEVAEkXyz9qovg2mqXmkr7DIXpn72O2gGYzeyXU74R%2FoNOlgvlAMe45aYerMk%2BV1b91AzsilZeWBLIwaq8x%2BpRgku28zhlOVxrxXddWE5yWREM4YHyMxZkaOHH1w%3D%3D'

If your head node is not connected to the Internet, you can send the bundle found in the /var/tmp/sdc-suppport.headnode.$DATE.tar.bz2 files through any other convenient means such as emailing the support ticketing system, or by transferring it to another computer and using the signed Manta URL and curl command provided by support.