Sending support bundles to Joyent
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"
}
- The
sdc-sbupload
command uses HTTP with a username and password configured in the head node/config
file to upload the support bundle to MNX Support.
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.