The Swarm Support Tools bundle is essential for all users of Swarm products. It contains scripts for many purposes. Inside the bundle are support scripts as well as PDFs describing in detail how to use them:
Tech-Support-Scripts-Bundle.pdf
Tech-Support-Scripts-Bundle-swarmctl.pdf
The primary tool in this bundle is the script techsupport-bundle-grab.sh
. The script snapshots the Swarm configuration and log data into a tarball and attaches it to a support ticket to assist troubleshooting.
Creating a support bundle
Best practice is to proactively collect and upload a support bundle with relevant technical information when a support ticket is opened with DataCore Support. Create a tarball by running the techsupport-bundle-grab.sh
command from the extracted tools bundle.
Follow the process below to provide the support bundle when an issue is raised with DataCore Support:
Open a support ticket and note the ticket number (such as
220331-000023
) to use when uploading files.Download the bundle: swarm-support-tools.tgz
CLI download command example
cd /root wget https://support.cloud.caringo.com/tools/swarm-support-tools.tgz
Extract the tools in the
/root
directory on the server (CSN, Elasticsearch, SwarmNFS, or Gateway).CLI extraction command example
tar -xf swarm-support-tools.tgz
Navigate to the tools directory, which is usually
/root/dist
.cd /root/dist
Recommended: Update the support bundle if significant time has passed since the bundle was last downloaded or updated. The version can be checked by viewing the REVISION.txt file.
Check the version by viewing the contents of the REVISION.txt file
cat REVISION.txt 2022_0328-1512-01
Update the bundle to the current version.
./updateBundle.sh
Execute the script:
Standard bundle grab:
./techsupport-bundle-grab.sh
Bundle grab including the settings checker output. Useful for Swarm upgrades. See Storage Settings Checker for more details.
./techsupport-bundle-grab.sh -s
Note the name and location of the tarball created by the script.
Uploading the bundle (internet access)
Upload directly from a server with internet access:
Type the following to enable the uploadtosupport function in the local shell:
source /root/dist/bashrcforcustomers
Type the following to upload the bundle to DataCore Support:
uploadtosupport [new-bundle-filename]
Enter the ticket number when prompted for a client name and ticket number.
The uploader automatically adds the bundle to the ticket and notifies DataCore Support. There is no need to email DataCore Support or make any changes to the ticket.
Uploading the bundle (no internet access)
The file needs to be moved to a location with internet access if the local server does not have access to the internet.
Securely connect (such as with WinSCP) to the server (CSN or other product) from an accessible location.
Download the latest support bundle.
Browse to the Uploader URL: https://support.cloud.caringo.com/uploader/uploader
Upload the bundle from the download location.
Enter the ticket number when prompted for a client name and ticket number.
The uploader automatically adds the bundle to the ticket and notifies DataCore Support. There is no need to email DataCore Support or make any changes to the ticket.