How to: gathering diagnostics for a StorageCraft Support Case (Linux)

Article Number: 
348

Summary

This article outlines how to gather and send machine diagnostics to StorageCraft Support for use in a support case.

Instructions:


Affected products

 

Gathering logs for StorageCraft Support:

A variety of logs are used to troubleshoot issues with StorageCraft products on Linux.  Use the directions below to download and execute the diagnostic utility used to gather the required information and logs from a host. In some instances, additional logs may be requested by StorageCraft in order to troubleshoot a particular case. 

StorageCraft Diagnostic Tool XPlatform (dtx) For Linux

================================================================================
DIAGNOSTIC TOOL XPLATFORM (DTX) FOR LINUX - QUICK INSTALLATION INSTRUCTIONS
================================================================================

1. Download the appropriate archive from ftp://ftp.storagecraft.com.au/dtx/:

a. for CentOS 7 and Red Hat 7:

wget ftp://ftp.storagecraft.com.au/dtx/dtx-2.1.118-0_centos-7-x86_64_2017-04-18.tar.gz -O dtx-2.1.118.tar.gz

SHA256: af793ddb03f11027b60c9e4d31a7b6370da3b10de5ebd461412243ff1eb18295
SHA1:  696b86bef348354c9388d06f56c92e278bd4639d
MD5:  d00901a2ff9967433344c91e7a4c5846

b. for CentOS 6 and Red Hat 6:

wget ftp://ftp.storagecraft.com.au/dtx/dtx-2.1.118-0_centos-6-x86_64_2017-04-18.tar.gz -O dtx-2.1.118.tar.gz

SHA256: 64a6a97caab10df05b497d86da74af30e3b685b24b775746468247d66fcbd34c
SHA1: 5aaac01729bb3e7da375276bfa0f2de0f6c31c39
MD5:  349f30a3264be891e55ebf1e41c469ee

c. for Ubuntu 16.04 (Xenial Xerus), Ubuntu 14.04 (Trusty Tahr) and Ubuntu 12.04 (Precise Pangolin):

wget ftp://ftp.storagecraft.com.au/dtx/dtx-2.1.118-0_ubuntu-x86_64_2017-04-18.tar.gz -O dtx-2.1.118.tar.gz

SHA256: bea95b0e14136b11f1b6734065e08296109a6bd9158ab6faa2395efebe7d5858
SHA1: fa95d86089c741655b097f2bd149432167f0b126
MD5:  8ac8e89517a5f47d37970b3052963022

2. Decompress the archive by running:

tar -zxvf dtx-2.1.118.tar.gz

NOTE: Depending on where you extracted the archive, you may need to change permissions to run the application:

chmod 711 dtx

3. Run the application:

sudo ./dtx

NOTE: the archive file is located in the folder /var/opt/StorageCraft/dtx. If extracting the archive on a Linux system, ensure that the -C argument is used to avoid overwriting live system files!

4. To upload the generated archive to the StorageCraft Support FTP servers:

sudo ./dtx --upload-ftp <support region> <case number> <archive file>

As an example:

a. to the Support Centre in Sydney, Australia:

sudo ./dtx --upload-ftp au 99999999 /var/opt/StorageCraft/dtx/dtx_labx18_20160725T0703Z.tar.gz

b. to the Support Centre in Cork, Ireland:

sudo ./dtx --upload-ftp eu 99999999 /var/opt/StorageCraft/dtx/dtx_labx18_20160725T0703Z.tar.gz

c. to the Support Centre in Draper, USA:

sudo ./dtx --upload-ftp us 99999999 /var/opt/StorageCraft/dtx/dtx_labx18_20160725T0703Z.tar.gz

updated: 2017-04-18
================================================================================

 

Sending logs to StorageCraft Support:

NOTE:  If manually uploading logs via a FTP client or if sending the logs via email, please rename the archive file generated to prefix it with the case number                       assigned. The case number is eight digits so please include leading zeros. For example:  00123456_dtx_labx18_20160725T0703Z.tar.gz.

              If the diagnostic utility is used to upload the archive file, it will automatically prefix the file with the case number.  

    • upload when opening a case:

The preferred method is to upload the archive file generated when opening a support case. This is an important step towards a faster resolution. If you do not have a support request open, gather the logs, then go to: http://www.storagecraft.com/support/support-request

    •  send via email:

Most of the time the archive file generated will be small enough that it can be sent via email. Note that the file must be in an archive format (.tar.gz for Linux and 7z or ZIP format for Windows) for StorageCraft to receive them. A 10 MiB limit exists on inbound email attachments to StorageCraft. If the archive file exceeds this size limit, please manually upload using a FTP client or by using the diagnostic utility.

    • upload using the diagnostic utility:

DTX can upload the archive file generated to the StorageCraft Support FTP servers. The syntax is:

sudo ./dtx --upload-ftp <support region> <case number> <archive file>

As an example:

sudo ./dtx --upload-ftp au 99999999 dtx_labx18_20160725T0703Z.tar.gz  ; to the Support Centre in Sydney, Australia
sudo ./dtx --upload-ftp eu 99999999 dtx_labx18_20160725T0703Z.tar.gz  ; to the Support Centre in Cork, Ireland
sudo ./dtx --upload-ftp us 99999999 dtx_labx18_20160725T0703Z.tar.gz  ; to the Support Centre in Draper, USA

    • upload using a FTP client:

If the archive file generated is larger than 10 MiB, use FTP to transfer the archive file to the StorageCraft FTP servers. Doing this requires an FTP client. If you do not have one, a link is included below to a free open source FTP client called FileZilla.

      1. connect using a FTP client with the username “anonymous” and no password
         
          • Port:                                             990 (US and EU)
                                                                  21 (AU)
          • Username:                                   anonymous
          • Password:                                    <blank>
          • Encryption:                                  explicit or implicit FTP over TLS (US and EU)
                                                                  plain FTP (AU)
      1. upload the files
      2. send a confirmation email confirming the file transfer and the name of the file transfered to the technician assigned to the case
         

Free FTP client (FileZilla):        http://filezilla-project.org/download.php/

NOTE: Once you are logged into the FTP site, you will not be able to get a directory listing. This is a restricted location where users cannot
              read the directory contents but can write into the directory.

© 2003-2017 StorageCraft Technology Corporation. All rights reserved.

ShadowProtect Version(s):
Operating Systems:
OS Bit Mode:

Terms and Conditions of Use - Privacy Policy - Cookies