Overview

ScaleArc provides a script for complementary generation of debugging logs, named idblog_collector.sh, and is required to investigate critical issues taking place at the installation.

Environment: ScaleArc version 3.0 and above

Procedure

The  idblog_collector.sh script can be used to collect all the necessary logs from the ScaleArc appliance. When executed, it creates a tar.gz archive which can be uploaded to the ScaleArc`s sFTP server for further analysis.

Below are the instructions to run it on your ScaleArc appliances:

1. Download attachment idblog_collector.sh onto your local computer.
2. Upload the script from your local computer to ScaleArc instance, via FileZilla or WinSCP.
3. Set the permissions to make the script executable by the system, by issuing:

 $ sudo chmod +x idblog_collector.sh

The following options are available for log generation:

• Run the script with DATE option, replacing YYYYMMDD with the date which to collect the logs for (e.g --date=20180526):

$ sudo sh idblog_collector.sh --date=YYYYMMDD

• To collect the logs for a particular hour of the day, include the hour (HH) after the date (e.g --date=2018052611):  

$ sudo sh idblog_collector.sh --date=YYYYMMDDHH

• To collect the logs for a particular cluster, include the cluster id (CID) as an argument (e.g -x=2):

$ sudo sh idblog_collector.sh --date=YYYYMMDD -x=<CID>

• Upon completion of the execution, the script output provides the name of the tar archive file and its exact location, which is typically/data/logs/log_<time stamp> folder.

Generic Usage Note for MacOS users: The log collector script uses colored text to indicate various sorts of messages, and its main color for informational messages is white. And that is the default background color on MacOS for Terminal Windows. Therefore, the user will be unable to see the questions the script is printing out about the ScaleArc appliance, to provide an acknowledgement or a response to them. Each input prompt presented to the user has a default choice of "y", having a five-second timeout value set for each prompt. If no selection is made and the input timeout value expires, then the script will continue execution as if a choice of "y" had been entered. Hence, it is strongly recommended that you use a terminal window with a black background to avoid this problem.