... 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.
{info:title=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.
{info}
h3. Prequisites
* You will need to login to a UNIX shell as root or as a user that has sudo privileges.
* You will need to use an SSH client, such as PuTTY:
[http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html]
If you are on a non Windows workstation, then there is usually an SSH client installed.
* MySQL Root password. It's possible to run the diagnostic script without this, but support may need to ask you for more information if you do.
* The gwdiags program itself (included in the product as of version 6.1). Here are all the versions:
{attachments}
h3. Running the tool
Now you are ready to run the diagnostic script.
# Use your SSH client to login to your GroundWork Monitor server.
|
#* you should login as root or a user with sudo privileges
# After you have copied the latest version from this page to {{/usr/local/groundwork/tools/gwdiags.pl}}, run these commands
|
{code:bgColor=#FFFFCE}
|
chown nagios.nagios /usr/local/groundwork/tools/gwdiags.pl
chmod 0755 /usr/local/groundwork/tools/gwdiags.pl
|
... {code}
|
# enter the command at the shell prompt
#* +if you are root user+
|
{code:bgColor=#FFFFCE}/usr/local/groundwork/tools/gwdiags.pl{code}
|
#* +if you are user with sudo privileges+
|
{code:bgColor=#FFFFCE}sudo /usr/local/groundwork/tools/gwdiags.pl{code}
|
#** it will prompt for password
# if you don't know the mysql root password, just hit enter
|
... # Please copy this file from the GroundWork server to your workstation ([WinSCP|http://winscp.net/] is easiest):
/usr/local/groundwork/tmp/gwdiags.DATESTAMP.tar.gz
{info}Note: DATESTAMP is not the actual file name. The file will have the date and time from when you run the script.{info}
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.
{code:title=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
{code}
|
E-mail
