54.7 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.

Figure 54-9 Document Service Provider

The WebAccess installation program creates a Novell eDirectory 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 contacts 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. Click Provider > Environment to display the Environment page.

    Environment property 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, which varies by platform.

    NetWare and Windows:

    novell\webpublisher on the Web server

    Linux:

    /opt/novell/groupwise/webpublisher

    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 Section 53.3, 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 attempts 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 Section 53.3, Configuring Redirection and Failover Support.

    The list must include at least one WebAccess Agent.

    Choose from the following options to manage the WebAccess Agents:

    • Add: Click Add to browse for and select the WebAccess Agent object, then click OK to add it to the list.

    • Edit: Select a WebAccess Agent in the list, then click Edit to edit the WebAccess Agent’s object properties.

    • Up: Select a WebAccess Agent from the list, then click Up to move it up in the list.

    • Down: Select a WebAccess Agent from the list, then click Down to move it down in the list.

    • Delete: Select a WebAccess Agent in the list, then click Delete to remove it from the list.

    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.