Generating hardware log files with "getlogs.sh" script

Version 2

     

    Introduction

     

    For hardware related issues, standard troubleshooting methods like tcpdumps or the Web Gateway feedback script might not give enough information to determine which component in the system is causing the issue.  McAfee Web Gateway Support might request that you collect additional diagnostic output to further troubleshoot the issue.

     

    McAfee is now providing a convenient way to collect hardware related logfiles and diagnostics output directly from your Web Gateway command line with a tool called "getlogs.sh". The steps below will walk you through installing, running, and submitting the getlogs script and it's output.

     

    Installation

     

    1. Connect to your Web Gateway command line using SSH as the "root" user.

    2. Install the following packages:

     

    For Web Gateway version 7.2.x run the following commands:

     

    yum install OpenIPMI-tools

    rpm -i http://appliance.webwasher.com/support/getlogs.rpm

     

    For Web Gateway version 7.3.x or newer, run the following commands:

     

    yum install http://appliance.webwasher.com/support/getlogs.rpm

     

    install73.png

     

    Running the getlogs script

     

    You can execute the getlogs script while your Web Gateway is up and running. There is no technical need to take it offline.

     

    1. Connect to your Web Gateway command line using SSH as the "root" user.

    2. Execute the following command:

     

    /opt/getlogs/getlogs.sh /opt/getlogs-output.zip

     

    3. You will be prompted to enter some information about your system and issue.

     

    running1.png

     

    4. In case you have ASC (Intel active System Console) or SNMP sub Agent (Intel SNMPSA) running on your system, you will be prompted for a decision to disable these services temporarily or to skip certain steps of the data collection.

     

    It is highly recommended that you proceed by pressing "Enter" and temporarily disable these services so that the data collection can be as complete as possible. The services will automatically be restarted immediately after the data has been collected.

     

    running2.png

     

    running3.png

     

    5. The getlogs script will now automatically collect all necessary information and create a zip file with the data at the end. The zip file should be located under

    /opt/getlogs-output.zip

     

    running4.png

     

    Transferring the data to McAfee

    To transfer the getlogs-output.zip, you can either transfer the file off your Web Gateway appliance (for example via WinSCP) and then email it into an existing ticket (if it is smaller than 10MB) or you can follow our FTP/SCP instructions in this community article: https://community.mcafee.com/docs/DOC-2402.