Knowledge Base Home

Call Support


Search the Knowledge Base

Skip to end of metadata
Go to start of metadata

Environment

Netmail Archive 5.3.0.1439 and higher in GroupWise 2014 environments

Synopsis

This article applies to the following situations:

  • Installing the WebViewer after installing Netmail Archive
  • After upgrading to GroupWise 2014, the archive link/button disappeared from the WebViewer
Note: GroupWise 2014 is only supported by Netmail Archive 5.3 HP2 and higher.

Solution

Before beginning the installation, the installation files for WebViewer should be available. They are located on the Netmail Archive server at ... \Program Files (x86)\Messaging Architects\_<latest version>\LocalSetups\WebViewer.

To copy the files between a Windows environment and the WebAccess server where the WebViewer will be installed, a Windows client such as WinSCP will be required. WinSCP is a free open source free SFTP, SCP, FTPS, and FTP client for Windows (current version at this time is available for download from  http://winscp.net/download/winscp555setup.exe).

To install the WebViewer on the WebAccess server, proceed as follows:

Note: The Paths used are based on a default installation of WebAccess and the paths shown below may differ if WebAccess was not installed in the default location.

1. Modify the webacc.cfg file

Modify the webacc.cfg file to add the correct section below after the end of file entry; the default location for webacc.cfg is /var/opt/novell/groupwise/webaccess/webacc.cfg.

If this is only a WebViewer update, it will be enough to verify that the section shown below is still in the webacc.cfg file (after some WebAccess updates, this section can end up missing some of the needed data):

###############################################################################
#TMA: Added for GWXML WebViewer Provider
###############################################################################
#------------------------------------------------------------------------------
#Specify the provider's class
#------------------------------------------------------------------------------
Provider.GWXMLV.class=com.novell.webaccess.providers.GWXMLV.GWANWP
#------------------------------------------------------------------------------
#Specify the provider's templates folder.
#------------------------------------------------------------------------------
Templates.GWXMLV.folder=GWXMLV
#------------------------------------------------------------------------------
#Specify the provider's configuration file.
#------------------------------------------------------------------------------
Provider.GWXMLV.Config.file=/var/opt/novell/groupwise/webaccess/gwxmlv.cfg
#------------------------------------------------------------------------------
#Specify super users. Separated by ';'
#------------------------------------------------------------------------------
Provider.GWXMLV.SuperUser.name=admin
#------------------------------------------------------------------------------
#setting for proxy, value: true or false
#------------------------------------------------------------------------------
Provider.GWXMLV.Proxy.disabled=false


2. Copy and modify the gwxmlv.cfg file

From the WebViewer installation files, modify the gwxmlv.cfg file and change the IP address section to point to the IP address of the server hosting the Remote Provider.

Next, check the port listed in this configuration file to make sure it points to the Remote Provider port. The default port is 6666.

After the file is updated, copy it to the WebAccess server, into the same folder that contains the webacc.cfg file (default is /var/opt/novell/groupwise/webaccess/).

 

3. Copy the WebViewer files to the WebAccess server

  • Create a new GWXMLV folder under the WebAccess css folder, and copy all the files from the WebAccess css folder to the newly created GWXMLV folder. The location of the css folder will vary with the version of Tomcat:
    • With Tomcat5:      /srv/www/Tomcat5/base/webapps/gw/WEB-INF/classes/templates/webacc/css

    • With Tomcat6:     /srv/Tomcat6/webapps/gw/WEB-INF/classes/templates/webacc/css or /var/opt/novell/tomcat6/webapps/gw/WEB-INF/classes/templates/webacc/css

  • Copy the contents of the gwxmlv_gw2014 folder from the WebViewer installation source to the newly created GWXMLV folder. Replace all files when prompted.

  • Copy the Customization.properties file from the WebViewer webacc_gw2014 installation source folder to the WebAccess webacc folder.
  • Rename the caption.htt file in the WebAccess css folder to caption.htt.orig.
  • Copy the files from the css_gw2014 WebViewer installation source to the WebAccess css folder.

  • Copy the provider folder from the WebViewer installation source to the WebAccess providers folder. The location will vary with the version of Tomcat:

    • With Tomcat5:      /srv/www/Tomcat5/base/webapps/gw/WEB-INF/classes/com/novell/webaccess/providers

    • With Tomcat6:     /srv/Tomcat6/webapps/gw/WEB-INF/classes/com/novell/webaccess/providers or /var/opt/novell/tomcat6/webapps/gw/WEB-INF/classes/com/novell/webaccess/providers

  • Rename the newly copied provider folder to GWXMLV.

  • Copy the WebaccImages folder from the WebViewer installation source to the WebAccess images folder. The location will vary with the version of Tomcat:

    • With Tomcat5:      /srv/www/Tomcat5/base/webapps/gw/webaccess/<random number>/images

    • With Tomcat6:     /srv/Tomcat6/webapps/gw/webaccess/<random number>/images or /var/opt/novell/tomcat6/webapps/gw/webaccess/<random number>/images

  • Rename the newly copied WebaccImages folder to GWXMLV.

 

4. Restart Services

  • For the modifications to become active, Tomcat must be restarted:

    • For Tomcat5:    service tomcat5 restart

    • For Tomcat6:    service tomcat6 restart

  • Log in to GroupWise WebAccess. If the Archive button is not visible after logging in, it may be necessary to restart the server. If the button is still not visible after this, troubleshoot the communication between the server hosting the Remote Provider and the WebAccess server.
  • Start by checking the corresponding log files: refer to WebViewer - Log Files for the location of these files.

Notes

If the WebViewer does not load properly or you wish to revert back to the original WebAccess configuration, follow the steps below (the following applies to both tomcat5 and tomcat6):

  1. Rename the gw folder in the ...tomcat5/webapps/gw to ...tomcat5/webapps/gw.old
  2. Restart tomcat5 services
  3. A new gw directory will be created and WebAccess will load with the default configuration

 


Help us improve!
Is this article helpful?
Is it well written?
Is the content complete?