Running the Groupwise 7 Monitor Agent as a Windows Service

Getting the Groupwise Monitor agent, gwmon.exe, running as a Windows service has been on my to do list for quite a while now.  I don’t understand why Novell doesn’t build this functionality into the product.  Here’s how I went about running the GW703HP1 agent as a service on my Windows Server 2003 R2 box.

First, install the Groupwise Monitor 7 Agent onto the Windows Server.  I installed this to the d:\gwmon directory.
 
Next, download the Windows 2003 Resource Kit Tools.  Extract and copy the instsrv.exe and srvany.exe files onto the Windows Server.  I put these files in the d:\service directory.
 
Launch a command prompt as a user with administrator credentials.  Change to the directory that you put instsrv.exe into, d:\services in my case.  Type:
 
instsrv gwmon d:\services\srvany.exe
 
where gwmon is the name you’d like your service to be named.  Note that you have to specify the full path to srvany.exe.
 
Run regedit, and navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\gwmon
 
If you didn’t name your service gwmon, navigate to
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NameOfYourService
 
Right click gwmon and select New > Key
 
Name the new key Parameters
 
Right click Parameters and select New > String Value
 
Name the new String Value Application
 
Edit the Application String, and in the box enter the full path to gwmon.exe.  In my case I entered:
 
d:\gwmon\gwmon.exe
 
Right click the Parameters key and select New > String Value
 
Name the new String Value AppParameters
 
Edit the AppParameters String, and in the box enter any startup parameters you specify when starting gwmon.exe manually.  In my case I entered:
 
/lang-us /home-\\gwpo5\gwdompri /httpuser-groupwise /httppassword-gwpass
 
This string specifies the following:
/lang-us = us english language
/home-\\gwpo5\gwdompri = path to my Groupwise primary domain
/httpuser-groupwise = the user “groupwise” that I login to agents as
/httppassword-gwpass = the password for the “groupwise” user account
 
Since I’m connecting to my primary domain that is located on another server,  I chose to use an Active Directory service account to run the service as.  To change the account:
 
Start > Run > services.msc
 
Edit the properties of the gwmon service
 
On the Log On tab, I specified “This Account
 
I specified the account as groupwise@mydomain.com, and entered the password twice.  After applying my changes, I was notified that the groupwise@mydomain.com account had been granted logon as a service account.
 
I started the service, and was able to access Groupwise monitor at http://serverIP/gw/gwmonitor. I then restarted the server to verify the service started up as expected.
 
Thanks to Martin Zinaich for his cool solution these instructions are based upon.
 
Beware of using older versions of instsrv.exe, like is referenced in Martin’s article.  I had a version on a Windows 2000 server that I tried to make work, but I had to use the newer version for it to work on Window Server 2003.

Leave a Reply

Your email address will not be published. Required fields are marked *