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.

   

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.

   • Item 2: Server Platform and Installation Directory
   • Item 3: Server Address
   • Item 4: Clustering Support (NetWare only)
   • Item 5: Gateway Directory
   • Item 6: Gateway Object
   • Item 7: eDirectory Authentication
   • Item 8: Execution Options (Windows only)
   • Item 9: Windows Service User (Windows only)
   • Item 10: Web Console
   • Item 12: WebPublisher Support (WebPublisher only)
   • Item 13: Libraries (WebPublisher only)

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.

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:

   • You need full file system rights to the GroupWise domain directory. See Item 5: Gateway Directory in Section 5.6, GroupWise WebAccess Installation Worksheet.

   • You need full file system rights to the Web server. If your Web server is on a UNIX server, the WebAccess Installation program copies tar files to a location you specify; this can be the UNIX server if you have access to it from the Windows workstation where you are performing the installation, or another location from which you can then copy the tar files to the UNIX server. See Item 13: Web Server Type and Root Directory in Section 5.6, GroupWise WebAccess Installation Worksheet.

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.

   

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.

    • Item 13: Web Server Type and Root Directory
    • Item 14: Novell Root Directory
    • Item 15: Java Servlet Engine (NetWare only)
    • Item 16: Default Language
    • Item 17: eDirectory Object Configuration

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.

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.

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.

   

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.

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.

   

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

   • Item 3: Server Information
   • Item 5: Gateway Directory
   • Item 11: LDAP Authentication
   • Item 6: Gateway Object

   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.

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.

   

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

   • Item 5: Gateway Directory
   • Item 13: Web Server Information
   • Item 11: LDAP Authentication
   • Item 17: WebAccess Objects

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

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.

   

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.

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.

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.

   

   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:

   • Starting the Linux GroupWise Agents as Daemons

   • Monitoring the Linux GroupWise Agents from Your Web Browser

   • Starting the Linux GroupWise Agents on System Startup

   • Running the Linux GroupWise Agents as a Non-root User

   • Enabling the High Availability Service for the Linux GroupWise Agents

   • Stopping the Linux GroupWise Agents

   • Uninstalling the Linux GroupWise Agents

5. Continue with Testing GroupWise WebAccess and WebPublisher.

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
   

   

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.

   

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.

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.

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.