Running the gwdiags diagnostic tool

If you ever run into a problem with your GroundWork Monitor deployment that you can't address by reading the Bookshelf documentation or by searching this knowledgebase, your next step would likely be to open up a case with GroundWork Support. Often they will be able to answer your question promptly without need for much information. However, in a number of cases the Support team need diagnostic information off your GroundWork Monitor server in order to assist further. The GroundWork Monitor product includes a diagnostic script that will provide this information.

Updated version of gwdiags.pl available
If you are running version 5.3 or later, please download the latest version of gwdiags.pl from this page and replace the version that is located at /usr/local/groundwork/tools/gwdiags.pl on your server.

Prequisites

Running the tool

Now you are ready to run the diagnostic script.

  1. Use your SSH client to login to your GroundWork Monitor server.
  2. After you have copied the latest version from this page to /usr/local/groundwork/tools/gwdiags.pl, run these commands
    chown nagios.nagios /usr/local/groundwork/tools/gwdiags.pl
    chmod 0755 /usr/local/groundwork/tools/gwdiags.pl
    
  3. enter the command at the shell prompt
  4. if you don't know the mysql root password, just hit enter
  5. Please copy this file from the GroundWork server to your workstation (WinSCP is easiest):
    /usr/local/groundwork/tmp/gwdiags.DATESTAMP.tar.gz
    Note: DATESTAMP is not the actual file name. The file will have the date and time from when you run the script.

    If you do not know how to use winscp to copy a file from the GroundWork Monitor server to your workstation, please contact one of your own IT team.

sample run
[root@groundwork ~]# /usr/local/groundwork/tools/gwdiags.pl
....

    The Case number is assigned by the GroundWork Case Management
    System. If you know this number, input it here. If this diag-
    nostic is for a new case, you can leave it to the default. If
    there is an existing case and you don't know it's number, put
    your company name here. Your input here will be pre-pended to
    the email's subject line.

    Case Number <New> ? customer-12


    If your MySql root user has a password, enter it here. If it
    doesn't have a root passwrod, just hit a <CR>.

    MySql Root Password <CR=none> <> ?
..................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................


        The gwdiags results file will be saved as /usr/local/groundwork/tmp/gwdiags.DATESTAMP.tar.gz
        Please attach the resulting file to your case at https://cases.groundworkopensource.com