/
MSA Support Bundle Debugging Tool

MSA Support Bundle Debugging Tool

JetStream Software provides the Python tool parse_support.py to extract and display details from the logs of various errors that may occur with protected domains, DRVA, and Orphans. Some key details can be seen after running the tool:

  • Garbage to valid ratio

  • Failed IO completion of a domain

  • Consistent watermark lagging, etc…

Usage

This tool can be run from a Mac Terminal or Linux. The Python3 module must be installed to use the tool.

  1. Copy the tool to the location where the MSA support bundle is located.
     

  2. Extract the log using the command:
    tar -xf <file_name>
     

  3. Run the tool using the command:
    python3 parse_support.py

 

To run the tool on a live system use -l in the command (e.g., python3 parse_support.py -l).

Example

A sample run to collect an MSA support bundle:

[root@fs087-h1-msa1 logs]# python3 parse_support.py -l
(IssueType.INFO,'Processing date(s) 2023-02-21T09:50:07',0)
drva1
P2_Domain2
(IssueType.GARBAGE_RATIO,'Garbage to valid ratio: 0%',0)
(IssueType.ORPHAN,'domain is not mentioned in existing config.',0)
(IssueType.INFO,'domain ID: 0000010400000000699497a9818f3b00',0)
P1_Domain1
(IssueType.GARBAGE_RATIO,'Garbage to valid ratio: 3.55%',3.55)
(IssueType.INFO,'domain ID: 0000010400000000b7e188a4618f3b00',0)

Starting from JetDR 4.2 onwards the parse_support.py is embedded into the /opt/jetstream/jetdr/script/healthView executable, it is available in the MSA but only internally when healthView is run.