Configuring the GroupWise Document Service Provider

The GroupWise^® Document service provider is installed and configured when you install the WebPublisher Application to a Web server. The GroupWise Document service provider receives GroupWise document requests from the WebPublisher Application and communicates with the WebAccess Agent to fill the requests.

The WebAccess installation program creates a Novell^® eDirectory^TM object for the GroupWise Document service provider in the same context as the WebPublisher Application. The object is named GroupWiseDocumentProvider. Using ConsoleOne^®, you can modify the GroupWiseDocumentProvider object to define the WebAccess Agents that the service provider will contact to fill GroupWise document requests. If your GroupWise system includes more than one WebAccess Agent, you can use this feature to provide failover support.

To modify the GroupWise Document service provider's configuration:

1. In ConsoleOne, right-click the GroupWise Document service provider object (GroupWiseDocumentProvider), then click Properties.

   NOTE:  The GroupWise Document service provider object is not available in the GroupWise View. To locate the GroupWise Document service provider object, you must use the Console View.

2. If necessary, click Provider > Environment to display the Environment page.

   
   

3. Choose from the following options:

   Configuration File: The WebAccess Agent's configuration file (commgr.cfg) contains the agent's IP address and the encryption key required by the GroupWise Document service provider to communicate with the WebAccess Agent. By default, the commgr.cfg file is stored in the WebPublisher Application's home directory (novell\webpublisher on the Web server or /opt/novell/groupwise/webpublisher on Linux).

   In general, you should not need to change this setting. However, if you have multiple WebAccess Agents in your GroupWise system and you are optimizing WebPublisher to provide greater scalability and availability, you might need to change the setting. For information, see Configuring Redirection and Failover Support.

   GroupWise WebAccess Agents: This list displays the WebAccess Agents the GroupWise Document service provider can communicate with when attempting to complete a request. If the first one listed is unavailable, the GroupWise Document service provider will attempt to use the second, third, fourth, and so on until it is successful. This provides failover support and ensures greater availability for your WebPublisher users. For more information about optimizing availability, see Configuring Redirection and Failover Support.

   The list must include at least one WebAccess Agent.

   To add a WebAccess Agent to the list, click Add to browse for and select the WebAccess Agent object, then click OK.

   To edit a WebAccess Agent's information, select the WebAccess Agent in the list, then click Edit.

   To remove a WebAccess Agent from the list, select the WebAccess Agent in the list, then click Delete.

   Customize Settings in XML: Click this button to launch the XML editor. You can use the editor to add, modify, or delete GroupWise Document service provider settings.

4. Click OK to save the changes.