How to install a stand-alone GroupWise 2012 Document Viewer Agent (GWDVA) as a Windows service

  • 7012347
  • 01-May-2013
  • 01-May-2013


Novell GroupWise 2012
GroupWise 2012 Document Viewer Agent
Microsoft Windows Server


By default, the GroupWise 2012 Document Viewer Agent (GWDVA) is installed as a Windows service when installed as part of the GroupWise Agents installation. 

However, some customers want to run the DVA on a Windows server that does not have a POA configured (a WebAccess server, for example), but the installer does not give the option to create a stand-alone GWDVA as a service, so when installed using the "Install the software, but do not configure the agents" option in the GroupWise installer, the gwdva.exe executable runs as an application rather than a Windows service.


Installation: To install a stand-alone GroupWise Document Viewer Agent (gwdva.exe) without configuring an MTA or POA on the same server, follow these steps:
  1. Run setup.exe from the GroupWise 2012 installation directory
  2. When the "GroupWise - InstallShield Wizard" window comes up, click "Install GroupWise System"
  3. On the next screen, select the default of "Standard" setup type
  4. On the next screen, select the button for "Install individual components" and under "Select the GroupWise components you want to install" check only the box for "GroupWise Agents"
  5. On the "installation Path" screen, accept the default path of C:\Program Files (x86)\Novell\GroupWise Server\Agents and check the box for "Install the software, but do not configure the agents" and click "Next" and then "Install"
Configuration: After the installation finishes, open a Command window and run the following three commands to configure the Document Viewer Agent as a Windows service
  1.  sc create GWDVA start= auto binpath= "C:\Program Files (x86)\Novell\GroupWise Server\Agents\gwdva.exe" displayname= GWDVA
  2. echo /home-c:\Program Files (x86)\Novell\GroupWise Server\Agents >> c:\"Program Files (x86)\Novell\GroupWise Server\Agents"\strtup.dva
  3. reg add HKLM\SYSTEM\ControlSet001\services\gwdva /v Parm /d "C:\Program Files (x86)\Novell\GroupWise Server\Agents\strtup.dva"
After running the configuration commands, when you start Services you should see GWDVA listed as a service and you can start it by right-clicking and selecting "Start"

Note: The configuration step 2 above only adds the /home switch to the GWDVA startup file, but you can configure other options (IP address and port, user/password for the HTTP interface, etc) by editing the strtup.dva file in C:\Program Files (x86)\Novell\GroupWise Server\Agents\