5.4 Setting Up GroupWise WebAccess

5.4.1 NetWare and Windows: Setting Up GroupWise WebAccess

Complete the following tasks to set up GroupWise WebAccess and WebPublisher:

IMPORTANT:If you plan to install GroupWise WebAccess in a clustered server environment, see the GroupWise 7 Interoperability Guide before you install WebAccess.

Installing the WebAccess Agent

The following steps provide instructions for installing the WebAccess Agent. For information about installing the WebAccess and WebPublisher Applications to a Web server, see Installing the WebAccess Application and WebPublisher Application.

  1. Select an appropriate location to run the WebAccess Installation program.

    NetWare:

    If you are installing the NetWare WebAccess Agent, you can run the Installation program from any Windows machine that meets the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

    Windows:

    If you are installing the Windows WebAccess Agent, you must run the Installation program at the Windows server were you want to install the WebAccess Agent. It must also meet the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

  2. Make sure that no other GroupWise agents are running on the server where you want to install the WebAccess Agent.

  3. Make sure that you have access to the directory where you want to install the WebAccess Agent and to the domain directory.

  4. Log in to eDirectory with Admin-equivalent rights to the eDirectory tree where you want the Installation program to create the WebAccess Agent object.

  5. Insert the GroupWise 7 Administrator for NetWare/Windows CD into the CD drive to start the GroupWise Installation program, then click Install Products > Install GroupWise WebAccess. If the Installation program does not start automatically, run setup.exe from the root of the CD.

    or

    If you have already copied the GroupWise WebAccess software to a software distribution directory, run internet\webacces\setup.exe to start the WebAccess Installation program.

  6. Click Yes to accept the license agreement and display the GroupWise WebAccess: Components dialog box.

    GroupWise WebAccess: Components dialog box
  7. Select GroupWise WebAccess Agent and deselect the GroupWise WebAccess Application and GroupWise WebPublisher Application options (worksheet item 1).

    NOTE:You can also install the WebAccess Application and WebPublisher Application to your Web server at this time, if you have the appropriate Web server file system access and eDirectory access, as described in Installing the WebAccess Application and WebPublisher Application.

  8. Follow the prompts to provide information about WebAccess Agent configuration, using the following information from the GroupWise WebAccess Installation Worksheet.

  9. If you are installing the WebAccess Application and WebPublisher Application along with the WebAccess Agent, skip to Step 10 in Installing the WebAccess Application and WebPublisher Application.

    of

    If you are installing the WebAccess Application and WebPublisher Application as a separate task, continue with Step 1 in Installing the WebAccess Application and WebPublisher Application.

Installing the WebAccess Application and WebPublisher Application

The following steps provide instructions for installing the WebAccess Application and WebPublisher Application. For information about installing the WebAccess Agent, see Installing the WebAccess Agent.

  1. Select an appropriate location to run the WebAccess Installation program.

    NetWare:

    If you are installing to a NetWare Web server, you can run the WebAccess Installation program on any Windows machine that meets the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

    Windows:

    If you are installing to a Windows Web server, you must run the WebAccess Installation program on that server. It must also meet the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

  2. Make sure that you have access to the directory where you want to install the WebAccess Agent and to the domain directory.

  3. Make sure that you have the file system access required to install the WebAccess Application and the WebPublisher Application:

  4. Shut down the Web server and Java.

    NetWare:

    NetWare 6:

    unload apache
    unload java
    

    NetWare 6.5:

    unload apache2
    unload java
    

    Linux:

    GroupWise installation of Apache:

    /etc/init.d/novell-httpd stop
    /etc/init.d/novell-tomcat4 stop
    

    Novell Open Enterprise Server Linux installation of Apache:

    /etc/init.d/apache2 stop
    /etc/init.d/novell-tomcat4 stop
    

    SUSE Linux Enterprise Server 10 installation of Apache:

    /etc/init.d/apache2 stop
    /etc/init.d/tomcat stop
    

    SLES 9 installation of Apache:

    apachectl stop
    CATALINA_HOME/bin/shutdown.sh
    

    Windows:

    Refer to your Microsoft Windows documentation.

  5. Log in to eDirectory with Admin-equivalent rights to the eDirectory tree where you want the Installation program to create the WebAccess objects (worksheet item 17).

  6. Insert the GroupWise 7 Administrator for NetWare/Windows CD into the CD drive to start the GroupWise Installation program, then click Install Products > Install GroupWise WebAccess. If the Installation program does not start automatically, run setup.exe from the root of the CD.

    or

    If you have already copied the GroupWise WebAccess software to a software distribution directory, run internet\webacces\setup.exe to start the WebAccess Installation program.

  7. Click Yes to accept the license agreement and display the GroupWise WebAccess: Components dialog box.

    GroupWise WebAccess: Components dialog box
  8. Select GroupWise WebAccess Application and GroupWise WebPublisher Application (if you plan to use WebPublisher).

  9. Deselect the GroupWise WebAccess Agent option, then click OK.

  10. Follow the prompts to provide information about WebAccess Application and WebPublisher configuration, using the following information from the GroupWise WebAccess Installation Worksheet.

  11. When the installation is complete, select from the following options:

    Launch Installation Summary: This option displays a list of the information you provided during installation. You can print it for future reference.

    Start the GroupWise WebAccess Agent: This option starts the WebAccess Agent immediately. If you want to configure the server to start the WebAccess Agent automatically each time the server restarts, see Starting the NetWare GroupWise Agents or Starting the Windows GroupWise Agents.

    Restart the Web Server: This option starts the Web server, which loads the WebAccess Application (and WebPublisher Application if you installed it).

  12. After installation is complete, if you are installing to an Apache Web server on UNIX Solaris, continue with Completing the Installation on a UNIX Apache Web Server.

    or

    Skip to Section 5.4.3, Testing GroupWise WebAccess and WebPublisher.

Completing the Installation on a UNIX Apache Web Server

The WebAccess Installation program copies the following files to the location you specified:

  • webaccess.tar

  • webaccessdocs.tar

  • webaccessjars.tar

  • webaccessservlets.tar

  • index.html

  • web.xml

  • commgr.cfg

To complete the installation and configuration process:

  1. Using the tar -xvf command, extract the following tar files to the specified locations:

    • webaccess.tar: Extract to the root of the UNIX server. A /novell directory is created for the files.

    • webaccessdocs.tar: Extract to the Tomcat GroupWise document root directory (for example, /usr/local/tomcat4/webapps/gw).

    • webaccessservlets.tar: Extract to the Tomcat GroupWise classes directory (for example, /usr/local/tomcat4/webapps/gw/WEB-INF/classes).

    • webaccessjars.tar: Extract to the Tomcat GroupWise lib directory (for example, /usr/local/tomcat4/webapps/gw/WEB-INF/lib).

  2. Copy the web.xml file is in the Tomcat webapps/gw/WEB-INF directory.

  3. Modify the webacc.cfg and webpub.cfg files, located in the /novell/webaccess and /novell/webpublisher directories at the root of the UNIX server, to change the Templates.path setting to point to the templates.

    For example, change the following line in webacc.cfg:

    Templates.path=/java/servlets/com/novell/webaccess/templates
    

    to

    Templates.path=/usr/local/tomcat4/webapps/gw/WEB-INF/classes/com/novell/webaccess/templates
    
  4. Copy the commgr.cfg file to the /novell/webaccess directory. If you installed GroupWise WebPublisher, you also need to copy the file to the /novell/webpublisher directory.

  5. In the webacc.cfg file, verify that the paths for the following settings point to valid directories. Typically, these directories reside in the /novell/webaccess directory, but you can relocate them if desired. Refer to the comments in the webacc.cfg file for explanations of each of these settings.

    Log.path=/novell/webaccess/logs
    Security.Timeout.path=/novell/webaccess/users
    File.Upload.path=/novell/webaccess/temp
    

    Verify that the paths for the following settings are correct.

    Provider.GWAP.Config.file=/novell/webaccess/commgr.cfg
    Provider.LDAP.Config.file=/novell/webaccess/ldap.cfg
    
  6. In the webpub.cfg file, verify that the paths for the following settings point to valid directories. Typically, these directories reside in the /novell/webpublisher directory, but you can relocate them if desired. Refer to the comments in the webpub.cfg file for explanations of each of these settings.

    Log.path=/novell/webpublisher/logs
    File.Upload.path=/novell/webpublisher/temp
    

    Verify that the path for the following setting is correct.

    Provider.GWDOC.Config.file=/novell/webpublisher/commgr.cfg
    
  7. Copy the index.html file to the Tomcat GroupWise document root directory (for example, /usr/local/tomcat4/webapps/gw).

    For the convenience of your users, you can link to the GroupWise file from your current default home page.

  8. Change to the gw/com/novell/webaccess directory of the Web server, then unzip the __help__.zip file to provide online help for the WebAccess client.

    For example:

    unzip __help__.zip
    
  9. Change to the gw/com/novell/webpublisher directory of the Web server, then unzip the __help__.zip file to provide online help for WebPublisher.

Starting GroupWise WebAccess

If you did not have the WebAccess Installation program start the WebAccess components, complete the following steps:

  1. Restart Java and the Web server.

    NetWare:

    NetWare 6:

    tomcat33
    apache
    

    NetWare 6.5:

    tomcat4
    apache2
    

    Linux:

    GroupWise installation of Apache:

    /etc/init.d/novell-tomcat4 start
    /etc/init.d/novell-httpd start
    

    Novell Open Enterprise Server Linux installation of Apache:

    /etc/init.d/novell-tomcat4 start
    /etc/init.d/apache2 start
    

    SUSE Linux Enterprise Server 10 installation of Apache:

    /etc/init.d/tomcat start
    /etc/init.d/apache2 start
    

    SLES 9 installation of Apache:

    CATALINA_HOME/bin/startup.sh
    apachectl start
    

    Windows:

    Refer to your Microsoft Windows documentation.

    This loads the WebAccess Application (and WebPublisher Application if you installed it).

  2. Start the WebAccess Agent

    NetWare:

    Enter strtweb.ncf at the NetWare server console.

    Windows:

    To run as an application, click Start > Programs > Novell GroupWise WebAccess > GroupWise WebAccess.

    To run as a service, from the Control Panel click Administrative Tools > Services. Right-click the WebAccess service, then click Start.

    NOTE:When you start the WebAccess Agent, the Document Viewer Agent also starts. However, the Viewer Agent cannot run as a Windows service.

    If the WebAccess Agent does not start successfully, see Starting the NetWare GroupWise Agents.

  3. If you enabled the WebAccess Agent Web console, you can use the following URL to view the Web console:

    http://webaccess_agent_network_address:http_port
    

    For example:

    http://172.16.5.18:7211
    

    For more information, see Using the WebAccess Agent Web Console in WebAccess in the GroupWise 7 Administration Guide.

  4. Skip to Section 5.4.3, Testing GroupWise WebAccess and WebPublisher.

5.4.2 Linux: Setting Up GroupWise WebAccess

Complete the following tasks to set up GroupWise WebAccess and WebPublisher. These tasks are designed to help you get Linux WebAccess up and running as quickly as possible and to help you manage the WebAccess Agent in the future.

IMPORTANT:If you are installing GroupWise WebAccess on SUSE Linux Enterprise Server 10, refer to TID 3248145 in the Novell Support Knowledgebase for installation instructions.

If you are installing GroupWise WebAccess in a clustered server environment, see the GroupWise 7 Interoperability Guide before you install WebAccess.

Installing the Linux WebAccess Agent

  1. Make sure that LDAP is running on your eDirectory server and that it is configured to accept login from the WebAccess Agent Installation program (worksheet item 11)

    The Installation program requires eDirectory access in order to create the WebAccess Agent object in eDirectory. The Installation program uses LDAP to gain the required access.

  2. In a terminal window, become root by entering sux and the root password.

    The sux command enables the X Window System, which is required for running the GUI GroupWise Installation program. If you are not using the X Window System, you can install GroupWise components individually, as described in Installing the GroupWise Agents Using the Text-Based Installation Program.

  3. Change to the root of the GroupWise 7 Administrator for Linux CD.

  4. Start the GroupWise Installation program.

    ./install
    
  5. Select the language in which you want to run the GroupWise Installation program, then click Next.

    NOTE:On Linux, all available languages are included in the same RPM, so all languages are always installed.

    GroupWise Installation program
  6. Click Install Products > GroupWise WebAccess > Install WebAccess Agent.

  7. When the installation is complete, click OK.

    The WebAccess Agent software is installed to /opt/novell/groupwise/agents.

  8. Continue with Configuring the Linux WebAccess Agent.

Configuring the Linux WebAccess Agent

  1. After the WebAccess Agent files have been installed, click Configure WebAccess Agent.

    The WebAccess Agent installation and configuration steps are separate so that you can install updated agent software without repeating the agent configuration steps.

    WebAccess Agent Configuration program
  2. Follow the prompts to configure the WebAccess Agent, using the following information from the GroupWise WebAccess Installation Worksheet in the order listed.

    On the Configuration Complete page, Launch WebAccess Agent on System Startup is selected by default.

    IMPORTANT:If you want to configure the WebAccess Agent for high availability, as described in Enabling the High Availability Service for the Linux GroupWise Agents, it must be configured to start automatically on system startup.

  3. If you do not want the WebAccess Agent to start automatically when the server restarts, deselect Launch WebAccess Agent on System Startup.

  4. Click Exit to complete the configuration.

  5. Continue with Installing and Configuring the WebAccess Application and WebPublisher Application.

Installing and Configuring the WebAccess Application and WebPublisher Application

IMPORTANT:If you are installing GroupWise WebAccess on SUSE Linux Enterprise Server 10, refer to TID 3248145 in the Novell Support Knowledgebase for installation instructions.

  1. After installing and configuring the WebAccess Agent, if you want to use an existing Apache and Tomcat installations, click Install GroupWise WebAccess Application.

    or

    Click Install GroupWise WebAccess Application with Apache and Tomcat.

    This installs a version of Apache and Tomcat specifically for use with GroupWise. Apache files are installed under /var/opt/novell/http and /etc/opt/novell/http. Tomcat files are installed under /var/opt/novell/tomcat4 and /etc/opt/novell/tomcat4.

    In addition, a self-signed certificate is generated, enabling users to use WebAccess and WebPublisher using an SSL connection.

    NOTE:The option to install Apache and Tomcat along with the WebAccess Application is not available if you are installing to Novell Open Enterprise Server Linux because Apache and Tomcat are already installed and configured correctly in that environment.

  2. When the installation is complete, click OK.

  3. Click Configure WebAccess Application.

    WebAccess Application Configuration program
  4. Follow the prompts to provide information about WebAccess Application, using the following information from the GroupWise WebAccess Installation Worksheet in the order listed.

  5. On the Configuration Complete page, click Exit to complete the configuration.

  6. If you installed WebPublisher, continue with Configuring WebPublisher.

    or

    Skip to Restarting the Web Server

Configuring WebPublisher

After installing and configuring WebAccess, as described in Section 5.4.2, Linux: Setting Up GroupWise WebAccess, if you want to enable WebPublisher as well, you must perform some manual configuration.

  1. In ConsoleOne, connect to the domain where the WebAccess Agent object was created during installation.

  2. In a convenient context, create a new user specifically for use with WebPublisher.

  3. Add the new user to a post office and provide a GroupWise password for the WebPublisher user.

  4. Browse to and right-click the WebAccess Agent object (by default, webac70a), then click Properties > WebPublisher.

    WebPublisher property page
  5. In the GroupWise Mailbox ID field, specify the WebPublisher user you created in Step 2 above.

  6. Click Add, then select the library for WebPublisher to access for documents.

  7. Select Assign General User Access to WebPublisher Users.

  8. Click OK to save the WebPublisher configuration information.

  9. Restart your Web server, as described in Restarting the Web Server

  10. Restart the WebAccess Agent, as described in Starting the Linux WebAccess Agent.

In order the add documents to the library so that they can be viewed on the Internet, WebPublisher user must use the GroupWise Windows client. See Publishing Documents to the Web with WebPublisher in Creating and Working with Documents in the GroupWise 7 Windows Client User Guide.

NOTE:WebPublisher functionality is not currently available in the GroupWise Cross-Platform client.

Restarting the Web Server

In order to load the WebAccess Application (and WebPublisher Application if you installed it), you must restart the Web server.

If you installed the Novell version of Apache and Tomcat along with the WebAccess Application, follow the instructions below to start your Web server. If you did not install the Novell version of Apache and Tomcat along with the WebAccess Application, restart Apache and Tomcat as you usually would.

  1. Make sure you are logged in as root.

  2. If you have other instances of Apache and Tomcat running on this server, bring them down before you start the new versions you just installed.

  3. Change to the /etc/init.d directory.

  4. Start Tomcat.

    ./novell-tomcat4 start
    
  5. Wait until Tomcat is all the way up.

  6. Start Apache.

    ./novell-httpd start
    
  7. Continue with Starting the Linux WebAccess Agent.

Starting the Linux WebAccess Agent

To start the Linux WebAccess Agent with a user interface:

  1. Make sure you are logged in as root.

  2. Make sure that the MTA for the domain is running.

  3. Change to the /opt/novell/groupwise/agents/bin directory.

  4. To start the WebAccess Agent, enter one of the following commands:

    ./gwinter --show --home domain_directory/wpgate/webac70a &
    ./gwinter --show @webac70a.waa &
    

    The WebAccess Agent --show switch does not display a server console interface like the other GroupWise agents. Instead, WebAccess configuration and status information displays in the terminal window where you start the WebAccess Agent.

    The --home startup switch specifies the gateway directory and is required to start the WebAccess Agent.

    The @webac70a.waa startup switch specifies the WebAccess Agent startup file, which contains the --home startup switch.

    The ampersand (&) causes the WebAccess Agent to run in the background, so that the terminal window you started it in is again available for use.

    WebAccess terminal window

    NOTE:When you start the WebAccess Agent, the Document Viewer Agent also starts.

    Status messages for the WebAccess Agent are written to the WebAccess Agent log file (mmddlog.nnn) in the /var/log/novell/groupwise/domain.webac70a/000.prc directory. The log file name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day.

    After the WebAccess Agent starts successfully, refer to the following sections in Section 7.0, Installing GroupWise Agents for additional information about managing the WebAccess Agent on Linux:

  5. Continue with Testing GroupWise WebAccess and WebPublisher.

5.4.3 Testing GroupWise WebAccess and WebPublisher

To test GroupWise WebAccess and WebPublisher, complete the steps in the following sections:

Testing WebAccess on a Workstation

  1. To access the WebAccess client, enter the IP address or hostname of the Web server plus the directory where the Novell Web Services page is located:.

    http://web_server_address/gw
    
    Novell Web Services page
  2. Select a GroupWise WebAccess language and service, then click Go to display the Login page.

    You can bypass the Novell Web Services page to go directly to the Login page by using the following URL:

    http://web_server_address/gw/webacc
    

    If the Web server uses SSL, use https rather than http.

    WebAccess Login page
  3. Type your GroupWise user ID or GroupWise full name in the Name box and your GroupWise mailbox password in the Password box.

  4. Select the desired settings.

    High Connection Speed: Select this option if your connection to the Internet is faster than a 56 KB modem.

    Low Connection Speed: Select this option if your are on a 56 KB modem or slower. This reduces the amount of data downloaded from the server by disabling Name Completion so that the Frequent Contacts Address Book does not need to be downloaded, and by disabling some aspects of AutoUpdate in the message list, such as no updating after a send or delete action.

    Use the Basic Interface: Select this option for a mobile device. It uses simplified templates and assumes a smaller display area. A few features, such as Name Completion, right-click menus, and drag-and-drop functionality, are not available in the basic interface. For more information, see the GroupWise WebAccess Basic Interface Quick Start.

  5. Click Login to display the GroupWise WebAccess main window.

  6. Click Help for more information about using GroupWise WebAccess.

Testing WebAccess on a Mobile Device

  1. Enter the following URL:

    http://web_server_address/gw/webacc
    

    where web_server_address is the IP address or DNS hostname of your Web server. If the Web server uses SSL, use https rather than http.

    Follow the instructions in your mobile device’s documentation to add this URL to your Favorites or Bookmarks so you don’t need to type the URL every time you log in.

  2. Enter your GroupWise user ID and GroupWise mailbox ID.

Testing GroupWise WebPublisher

GroupWise WebPublisher only supports access through a Web browser on a computer. Mobile devices are not supported.

  1. To access the WebPublisher client, enter the IP address or hostname of the Web server plus the directory where the Novell Web Services page is located:

    http://web_server_address/gw
    
  2. Select a GroupWise WebPublisher language, then click Go to display GroupWise WebPublisher.

    You can bypass the Novell Web Services page to go directly to WebPublisher by using the following URL:

    http://web_server_address/gw/webpub
    

    where web_server_address is the IP address or DNS hostname of your Web server. If the Web server uses SSL, use https rather than http.

  3. To search for a specific document, enter the search words, then click Search.

    or

    To browse the documents in a library, click Document Browse, then click the library you want to browse. When you browse a library, the first 10 documents are listed. You can list additional documents if desired.

  4. Click Help for more information about using GroupWise WebPublisher.