Sending support bundles to Joyent

Modified: 09 Mar 2023 22:10 UTC

Triton includes a feature to create and optionally send a support bundle to help MNX support troubleshoot problems with your installation. This bundle includes a number of logs and configuration files from your Triton installation.

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

To create and upload 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 -u
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

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

==> packing data to /var/tmp/sdc-support.headnode.20140314T124856Z.tar.bz2

# sdc-sbupload sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2
gpg: key FB6D2F9C: "MNX support " not changed
gpg: Total number processed: 1
gpg:              unchanged: 1
{
  "success": true,
  "uploadPath": "78-2b-cb-0a-75/joyent.sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2.44454c4c-3700-1039-8034-b5c04f445131.20140314T130335Z.20140314T130337Z"
}
[root@headnode (mxpa) /var/tmp]# sdc-sbupload sdc-support.headnode.20140314T124856Z.tar.bz2
gpg: key FB6D2F9C: "MNX support " not changed
gpg: Total number processed: 1
gpg:              unchanged: 1
{
  "success": true,
  "uploadPath": "44454c4c-3700-1039-8034-b5c04f445131/joyent.sdc-support.headnode.20140314T124856Z.tar.bz2.20140314T134008Z.20140314T134016Z"
}

with the "uploadPath" shown in the above output.

To create a support bundle without uploading it, run sdc-sbcreate without the -u option. You can use the sdc-sbupload described below to upload it later.

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.

Upload the bundle file to MNX Support.

# sdc-sbupload sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2
gpg: key FB6D2F9C: "MNX support " not changed
gpg: Total number processed: 1
gpg:              unchanged: 1
{
  "success": true,
  "uploadPath": "78-2b-cb-0a-75/joyent.sdc-support.78-2b-cb-0a-75-23.20140314T125306Z.tar.bz2.44454c4c-3700-1039-8034-b5c04f445131.20140314T130335Z.20140314T130337Z"
}

 with the "uploadPath" shown in the above output.

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 email.