Discovery: How to collect Pool and Record data to replay a discovery scan for troubleshooting purposes

Version 4
    Share:|

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    BMC Discovery


    COMPONENT:

    BMC Atrium Discovery and Dependency Mapping


    APPLIES TO:

    BMC Atrium Discovery and Dependency Mapping



    QUESTION:

    How to collect Pool and Record data to replay a discovery scan for troubleshooting purposes?


    ANSWER:

     

    Pool and Record Data is sometimes requested by Customer Support to replay a discovery scan for troubleshooting purposes. This is usually accompanied by a request for debug logs. 

    The following instructions are to be performed on the Scanner (ideally when the Scanner is not running other scans):


    Please set the logging level for Discovery and Reasoning to DEBUG (see https://docs.bmc.com/docs/display/DISCO111/Changing+log+levels+at+runtime). If Support requests any other logs in DEBUG, set those as well.

      

    Go to Administration -> Discovery -> Discovery Configuration
    - Set Recording Mode to "Record"

    For recording of Linux/UNIX systems and Windows systems:
    - Go to Discovery -> Credentials and select the credential being used for the hosts where the problem occurs
    - In the Options section, change "Session Logging" to Enabled. Click "Apply"

      

    For recording of Windows systems, also perform these steps:
    - Go to Discovery -> Credentials > Windows Proxies and select the proxy being used for the hosts where the problem occurs
    - In the “Manage Windows Proxy” window, change Recording Mode to “record”
    - Set the logging level to "DEBUG"
    - click Apply Proxy Settings

      

    Go to Discovery -> Discovery Status
    - Click "Add New Run"
    - Set type to "Snapshot"
    - Enter IP addresses for the hosts where the problem occurs
    - Level should be set to "Full Discovery"
    - Label can be set to anything
    - Click "OK"

      

    After discovery is complete:
    - Disable "Record" mode in the discovery configuration and proxy configuration as described above
    - Set the logging level for Discovery and Reasoning to INFO, as well as any others which support requested in DEBUG mode
    - Disable "Session Logging" in Discovery -> Credentials

      

    Go to Administration -> Appliance Support

      

    For 11.1 and earlier versions:
    - Under "Atrium Discovery Logs By Date" select the date range for the discovery you performed
    - Check the box for Discovery and Reasoning logs, as well as any other modules support requested logs for
    - If this was a Windows discovery, check the box for “Logs from ‘xxxxxx' proxy”
    - Under "Target Host Data" enter the IP’s scanned
    - Check the boxes for Pool Data and Record Data (and Session logs for UNIX/Linux)
    - Under Create Archive, enter a name for the zip file
    - Click "Gather" and send us the result
    - After the gather has finished, click on the new archive to upload it to your PC, and send the archive file to Support

    For 11.2 and later versions:
    - Click "Create"
    - Provide a "Name" for the archive (you can use your case#)
    - Check the box for Discovery and Reasoning logs, as well as any other modules support requested logs for
    - If this was a Windows discovery, check the box for “Logs from ‘xxxxxx' proxy”
    - Check "Record & Pool Data" (and Session logs for UNIX/Linux)
    - Under "Logs By Date", select the date range for the discovery you performed
    - Under "IP Range(s)" enter the IP’s scanned
    - Click "Create"
    - Wait for the new archive to show up on the "Appliance Support" page.  It should be at the top of the list.
    - Click on the new archive to upload it to your PC, and send the archive file to Support



    =========================================================
    For successful scans, here is shortcut list of steps.  (We do not need discovery/reasoning logs when the scans are successful).

    The following instructions are to be performed on the Scanner (ideally when the Scanner is not running other scans):
    1) Set "Recording mode" to "Record" from Administration->Discovery Configuration page
    2) Set "Recording mode" to "Record" for the Windows Proxies that will be used in the scan (or just turn on record for each Windows Proxy if you don't know which ones will be used)
    3) Scan the IP's requested by Support
    4) Turn off record mode everywhere that you turned it on
    5) Gather the record data from the Appliance Support page:
        Check "Record and Pool data"
        Enter the IP's in the box below
        Click "Create"
    6) Send the gathered file (.tgz) to Support
     

     


    Article Number:

    000132636


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles