Troubleshooting Blueprint Jobs: Manually Running Gwcheck GUI

  • 7019485
  • 17-May-2013
  • 29-Aug-2017


Blueprint (all versions)


Customer's Blueprint jobs are returning all "zeroes" for mailbox statistics.  How do I run gwcheck (GUI version) as a troubleshooting step?


This article assumes you are in a GUI session of Linux and not at a Putty window (SSH connection). 

To run the GWCHECK GUI on a Linux server, JRE 1.5 or higher is required.  If not installed, first install the Java Runtime Environment.

NOTE: If you are running a 64-Bit OS, it is quite possible that you will get errors trying to run GWCHECK. See this Novell KB Article for examples of errors you might see. Trying to find a 32-Bit Java JRE on Oracle's website did not prove very easy. So we recommend that you look for this link at Oracle's website:

The file that worked on SLES11 SP3 was: jdk-7u45-linux-i586.rpm

With the above mentioned Java RPM, the JAVA_HOME path we specified was: /usr/java/jdk1.7.0_45/jre

Or said another way:

export JAVA_HOME=/usr/java/jdk1.7.0_45/jre

Once Java is installed, a couple of environment variables must be set:  JAVA_HOME and PATH.
1.  At a console prompt, type: vi ~/.bash_profile

  Hit "i" on your keyboard to put it in Insert mode.

  Type:  export JAVA_HOME=/usr/java/latest  (or whatever the parent Java directory might be - for Java 1.7, it installs to "/usr/java/latest", where "latest" is a symbolic link to the latest version).

  On a new line, type: export PATH=$PATH:/usr/java/latest/bin (again, adjust according to your Java installation).

  Hit the ESC key to exit Insert mode.

  Hit ZZ on your keyboard to save the changes and exit the VI editor.

  Log out then log back in.

  Verify that the variables are set by echoing them (e.g., "echo $JAVA_HOME" and "echo $PATH").
Now you are ready to run gwcheck.
1.  Change to the gwcheck directory:  /opt/novell/groupwise/gwcheck/bin

  Execute gwcheck:  ./gwcheck

Set up gwcheck:
a)  Action = Mailbox Statistics

  "Mailbox Statistics" radio button should be selected.

Database Path = .../[profile]/connect/current

  Post Office Name = [the profile's post office name]

  Object Type = Users/Resources - put in the userid of a known user for that PO
4.  Click on RUN.

Additional Information

This article was originally published in the GWAVA knowledgebase as article ID 2140.