Environment

NeGovern Archive 6.x

MicroFocus GroupWise Webaccess v 18

SuSE Linux Enterprise server v 11 SP3 and Later

Synopsis

This article outlines the steps to install NetGovern’s Webviewer in the above environment.  

Groupwise Webaccess installation introduces Tomcat 9 to the system and changes some of the file locations previous of Groupwise Webaccess versions worked with.

Pre-Requisites

There are some pre-requisites that need to be met:

On a default GroupWise Webaccess 18 deployment on Linux, the above files and folders cab be located at:

Netgovern Webviewer’s installation files can be found on any Archive node in the following folder:

Netgovern Webviewer’s files can be copied/transferred to the GroupWise Webaccess server using any ftp client (i.e.: WinSCP, FileZilla)

Solution

1. Modify the webacc.cfg file

Navigate to the folder containing the webacc.cfg file.  The default location is: /var/opt/novell/groupwise/webaccess/webacc.cfg

Edit the webacc.cfg file. 

Add the section shown below, preferably at the end of the file.

Note: If this is an update to an existing installation, please verify that this section is still in the file and is accurate (after certain WebAaccess updates, some of the required data can disappear from this section).

Section to add to webacc.cfg:

###############################################################################
#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 location the Webviewer source install folder was uploaded to, find the gwxmlv.cfg file and copy it to the GroupWise Webaccess folder where webacc.cfg file is (i.e.: /var/opt/novell/groupwise/webaccess/).

Using a text editor of choice, change the IP address section to point to the Remote Provider host . Ensure the listed port matches the port used by the Remote Provider . The default port for this is 6666.

Gwxmlv.cfg

##############################################################################

# WebViewer Administrator

##############################################################################

WebViewer.admins=

##############################################################################

# MessagingArchitects WebAccess Archive Provider Configuration File

##############################################################################

Provider.Server.IP=1.2.3.4

Provider.Server.Port=6666

##############################################################################

# Specify the logging level. Valid values are:

#     normal

#     verbose

#     diagnostic

##############################################################################

Log.level=normal

##############################################################################

#Threads for accessing dtSearch

##############################################################################

Thread.Number=20

3. Copy WebViewer files to WebAccess

    1. Create a folder named GWXMLV in /opt/novell/grpwise-tomcat/webapps/gw/WEB-INF/classes/templates/webacc/css/

    2. Copy the content of the /opt/novell/grpwise-tomcat/webapps/gw/WEB-INF/classes/templates/webacc/css/ folder onto the new GWXMLV folder.

    3. Copy the content of the GWXMLV_gw2014 folder from the webviewer installation folder to the WebAccess ../css/GWXMLV folder.

    4. Copy the Customization.properties file from the WebViewer webacc_gw2014 installation source folder to the WebAccess /opt/novell/grpwise-tomcat/webapps/gw/WEB-INF/classes/templates/webacc/ folder.

    5. Create a backup of the caption.htt file in the WebAccess css folder (i.e.: mv caption.htt to caption.htt.orig).

    6. Copy the files from the css_gw2014 WebViewer installation source to the WebAccess server's  /opt/novell/grpwise-tomcat/webapps/gw/WEB-INF/classes/templates/webacc/css/ folder.

    7. Copy the provider folder from the WebViewer installation source to  the WebAcess server's  /opt/novell/grpwise-tomcat/webapps/gw/WEB-INF/classes/com/novell/webaccess/providers/ folder.  Rename the copied provider folder to GWXMLV

    8. Copy the WebaccImages folder from the WebViewer installation source to the WebAccess /opt/novell/grpwise-tomcat/webapps/gw/webaccess/201712060545/images/ folder.  Rename WebaccImages folder to GWXMLV

4. Restart Services

NOTE: It is recommended to stop and start the Apache server as well as the Tomcat  server.

rcapache2 stop

rcgrpwise-tomcat stop

 

rcapache2 start

rcgrpwise-tomcat start

5. Log in to GroupWise WebAccess.

If the Archive button is not visible after logging in, it may be necessary to restart the host server.

For further troubleshooting refer to WebViewer - Log Files for the location of these files.