6.3 Special considerations

This section describes special considerations for using the GroupWise portlets.

6.3.1 Setting Domain Name

If you are using GroupWise 6.5 or later, your portal and GroupWise server must be in the same DNS domain. When you configure the portlet preference that is the http address of your GroupWise WebAccess server, you must use a full DNS host name, for example http://GWWebaccess.novell.com

If you are working with the portlet in a local environment, you can avoid error messages by setting up a local domain name as follows:

  1. Search your local file system for the HOSTS file for your TCP/IP subsystem. Typical locations for Linux, Netware, and Windows, respectively, include: 

    //etc/hosts (for Linux)
SYS:ETC\HOSTS (for Netware)
rootdrive:\WINNT\system32\drivers\etc\hosts (for Windows) 
rootdrive:\WINDOWS\system32\drivers\etc\hosts (for Windows)

  2. Add an entry in the HOSTS file to name your local host. Use a proper name in the same domain as your GroupWise server. Duplicate the entry 127.0.0.1 localhost and then replace localhost in the duplicate with hostname.yourdomain

    For example: in the case of novell.com, this entry is:

      127.0.0.1 localhost  127.0.0.1 hostname.novell.com

6.3.2 Enabling Single Sign-On

To make this portlet easier for users to access, use single sign-on, which automatically authenticates users. To do so, use

  • Either ${User/simpleid} or ${Application/login-user} for the UserName preference

  • ${Application/login-pass} for the Password preference

Then, enable single sign-on.

To enable portlet Single Sign On, do the following:

  1. In the User Application, open the Administration tab and choose Application Configuration.

  2. Select Password Module Setup > Login.

  3. Click the radio button that enables SSO.

NOTE:Accessory portlets that allow single sign-on authentication based on passwords currently do not support single sign-on when SAML assertions are used for User Application authentication.

6.3.3 GroupWise WebAccess templates

You must install additional GroupWise templates on the GroupWise WebAccess Server to successfully display mail and calendar messages in the GroupWise portlets.

To install GroupWise WebAccess templates:

  1. Verify that you have GroupWise 6 or later with WebAccess installed on your GroupWise server.

  2. Copy the GroupWise Portlet templates.zip file from the install location to the template directory on the GroupWise WebAccess server.

    The install location is typically .../novell/idm.

    The template directory is typically at one of these locations:

    Type of Web Server

    Template directory for templates.zip

    OES/Linux WebAccess server

    For Open Enterprise Server with GroupWIse 7:

    /var/opt/novell/gw/web-inf/classes/com/novell/webaccess/templates/css

    IMPORTANT:Please note that with GroupWise 7 templates now reside in the .../templates/css directory.

    NetWare WebAccess server

    For NetWare 6.5 with GroupWise 6.5:

    sys:\tomcat\4\webapps\ROOT\WEB-INF\classes\com\novell\webaccess\templates\frames

    For NetWare 6 with GroupWise 7.x, copy GroupWise portlet templates.zip to the following directory on your GroupWise server: 

    sys:\tomcat\33\webapps\root\web-inf\classes\com\novell\webaccess\templates\css

    Windows WebAccess server

    For GroupWise 6.5 running on an Internet Information Server (IIS) server:

    c:\novell\java\servlets\com\novell\webaccess\templates\frames

  3. Unzip templates.zip to the following location on the GroupWise WebAccess server:

    ..../web-inf/classes/com/novell/webaccess/templates/css

  4. Modify the WebAccess Security setting in Webacc.cfg. This lets you view messages in WebAccess without having to log in again. On NetWare, modify the sys:novell\webaccess\webacc.cfg file. Set Security.UseClientIP.enable to False.

    You can find webacc.cfg in the following locations:

    OES/Linux Web server

    For Open Enterprise Server with GroupWise 7: /opt/novell/groupwise/webaccess/directory on your GroupWise server.

    NetWare Web server

    For NetWare 6.5 with GroupWise 6.5: sys:novell\webaccess

  5. Stop and restart the Tomcat instance that is hosting WebAccess.