23.2 Manually Migrating the WebAccess and WebPublisher Applications to Linux

  1. On the Linux server, become root in a terminal window.

  2. Make sure that the Linux server already has Apache and Tomcat configured and running successfully and that you know the full path to the Apache and Tomcat root directories.

  3. If your Linux environment includes the X Window System, run the GUI GroupWise Installation program to install and configure the Linux WebAccess Application, as described in Installing and Configuring the WebAccess Application and WebPublisher Application.

    or

    If the X Window System is not available, run the text-based GroupWise Installation program instead, as described in Installing the GroupWise Agents Using the Text-Based Installation Program.

    IMPORTANT:On the WebAccess Objects page, specify a new context for the WebAccess Application objects, so that the old objects are retained.

  4. If you want to use WebPublisher on Linux, perform the manual configuration described in Configuring WebPublisher.

  5. In ConsoleOne, review the property pages for the old WebAccess Application objects:

    • GroupWise WebAccess

    • Novell Speller

    • LDAP Provider

    • GroupWise Provider

    • GroupWise Document Provider

  6. transfer any settings that you have customized on the old WebAccess Application objects to the new WebAccess Application objects.

  7. If you installed WebPublisher, review the property pages of the old GroupWise WebPublisher object, then transfer any settings that you have customized on the old GroupWise WebPublisher object to the new GroupWise WebPublisher object.

  8. If you have customized any WebAccess or WebPublisher template files, copy the customized template files from the old Web server to the following directories on the Linux Web server:

    /var/opt/novell/gw/WEB-INF/classes/com/novell/webaccess/templates
    /var/opt/novell/gw/WEB-INF/classes/com/novell/webpublisher/
                                                            templates
    
  9. Stop and then start Apache and Tomcat, as described in Restarting the Web Server.

  10. Verify that the new WebAccess Application is communicating successfully with the existing WebAccess Agent by accessing your GroupWise mailbox using the WebAccess client:

    http://new_web_server_address/gw/webacc
    
  11. To keep users’ existing browser bookmarks from being broken, redirect the old WebAccess and WebPublisher URLs to the new WebAccess and WebPublisher URLs:

    1. If your old Web server was Apache on NetWare:

      1. Change to the conf subdirectory of the Apache root directory (for example, \apache2\conf).

      2. Edit the Apache configuration file for GroupWise.

        On NetWare 6, the Apache configuration file is gwapache.conf. On NetWare 6.5, the Apache configuration file is gwapache2.conf.

      3. Add the following line:

        redirect permanent /servlet/webacc 
                                http://web_server_address/gw/webacc
        
      4. If you use WebPublisher, add the following additional line:

        redirect permanent /servlet/webpub 
                                http://web_server_address/gw/webpub
        
      5. Save the file, then exit the editor.

      6. Restart Apache to put the redirections into effect.

    2. If your old Web server was Internet Information Server (IIS) on Windows:

      1. Change to the netpub\wwwroot subdirectory of the IIS root directory (for example, c:\inetpub\wwwroot).

      2. Create a subdirectory named servlet.

      3. Under the servlet subdirectory, create a subdirectory named webacc.

      4. If you use WebPublisher, create a second subdirectory named webpub.

      5. In IIS Manager, expand the tree in the left pane to display Default Web Site under Web Sites.

        Under Default Web Sites, you should see the servlet subdirectory you created in Step 11.b.b

      6. Expand the servlet subdirectory to display the webacc subdirectory (and optionally, the webpub subdirectory) that you created in Step 11.b.c.

      7. Right-click the webacc subdirectory, then click Properties.

      8. Click Directory, select A Redirection to a URL, then type /gw/webacc in the associated field.

      9. Select A Permanent Redirection for This Resource, then click OK to save your changes.

      10. If you use WebPublisher, repeat Step 11.b.g through Step 11.b.i, using webpub in place of webacc.

      11. Restart the IIS Web server to put the redirections into effect.

    3. If your old Web server was Netscape Enterprise Server for NetWare, search the Novell Support Web site for redirection instructions.

  12. Notify users of the new WebAccess and WebPublisher URLs so that users can update their browser bookmarks if they want to.

  13. If desired, uninstall the WebAccess Application and the WebPublisher Application from the Web server to reclaim disk space on the NetWare or Windows Web server. See Uninstalling the NetWare GroupWise Agents or Uninstalling the Windows GroupWise Agents.