Environment
Blueprint (all versions)
Situation
Customer's Blueprint jobs are returning all "zeroes" for mailbox statistics. How do I run gwcheck (GUI version) as a troubleshooting step?
Resolution
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: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
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_profileNow you are ready to run gwcheck.
2. Hit "i" on your keyboard to put it in Insert mode.
3. 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).
4. On a new line, type: export PATH=$PATH:/usr/java/latest/bin (again, adjust according to your Java installation).
5. Hit the ESC key to exit Insert mode.
6. Hit ZZ on your keyboard to save the changes and exit the VI editor.
7. Log out then log back in.
8. Verify that the variables are set by echoing them (e.g., "echo $JAVA_HOME" and "echo $PATH").
1. Change to the gwcheck directory: /opt/novell/groupwise/gwcheck/bin
2. Execute gwcheck: ./gwcheck
3. Set up gwcheck:
a) Action = Mailbox Statistics4. Click on RUN.
b) "Mailbox Statistics" radio button should be selected.
c) Database Path = .../[profile]/connect/current
d) Post Office Name = [the profile's post office name]
e) Object Type = Users/Resources - put in the userid of a known user for that PO
Additional Information
This article was originally published in the GWAVA knowledgebase as article ID 2140.