Source:Micro Focus GroupWise Configuration

From SEPsesam
Revision as of 10:49, 5 June 2020 by Sta (talk | contribs) (Updated, review required.)
Draft.png WORK IN PROGRESS
This article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.

Copyright © SEP AG 1999-2024. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo V2. For previous documentation version(s), check GroupWise archive.

Overview

The Novell corporate brand has been acquired by Micro Focus. The Novell GroupWise product name is now Micro Focus GroupWise; however, SEP sesam documentation update (such as names and screenshots) to reflect these changes is being done in a phased manner, therefore Micro Focus GroupWise may still appear under the name Novell GroupWise.

This article describes prerequisites and configuration requirements for Micro Focus (Novell) GroupWise environment. Note that the procedures introduced in this article are only the required pre-configuration steps. For details on GroupWise backup and restore configuration, see Novell GroupWise Backup and Novell GroupWise Restore. All required programs for GroupWise backup and restore are included in the SEP sesam Micro Focus client package.

SEP sesam provides reliable data protection for GroupWise environments and supports the following GroupWise object types:

  • GroupWise domains: Primary (created on installation of Groupwise) and secondary domains are main administrative unit for GroupWise system that serves as a logical grouping of one or more post offices and is used for routing processes.
  • GroupWise post offices: A post office is a set of folders on a network file server. It serves as an administrative unit for a group of users and mailboxes. The post office folder stores user mailboxes, messages and information used to distribute the messages.
  • GroupWise libraries: A library is a collection of documents and document properties that are stored in database. A post office can own more libraries. Documents can be stored directly at the post office or in document storage areas outside the post office. Libraries with document storage areas inside the post office will be saved with the post office.

For more details about GroupWise system, see the Micro Focus (Novell) GroupWise 2014 R2 Administration Guide

Requirements

Make sure that the following conditions are met when configuring GroupWise with SEP sesam.

General requirements

  • GroupWise 2012/2014/2018 system (all post office/domain/library objects on OES servers). Check the support matrix for the list of supported versions.
  • Verify that your network is set up correctly and that DNS name resolution is successful. Note that forward and reverse DNS resolution is required by SEP sesam (SEP sesam Server, data mover server, GroupWise server/cluster resource, cluster nodes). For details, see How to check DNS configuration.
  • Working Service Location Protocol (SLP) name resolution in the network (running slpd on the OES servers).
  • SEP sesam Server ≥ 4.4.3
  • Check Hardware requirements for SEP sesam Server, RDS or SEP sesam Client.
  • Data mover server (OES2/OES11/OES2015/OES2018 with installed and activated SMDR modules) with SEP sesam Micro Focus client. For details, see Micro Focus (Novell) data mover.

GroupWise server requirements

  • The Target Service Agent for file systems (TSAFS) module must work in default Linux mode (not dual or Netware) and the switch --EnableGW is required to activate the backup of GroupWise through TSAFS. Note that the full path name of the TSAFS configuration file on Open Enterprise Server Linux is /etc/opt/novell/sms/tsafs.conf.
  • The GroupWise configuration file gwha.conf must exists in the default folder /etc/opt/novell/groupwise/. If the file gwha.conf exists in another folder, copy and edit gwsep.conf file from /opt/sesam/skel/templates/ to /etc/opt/novell/groupwise/. Then edit gwsep.conf and add the line gwha=<path to gwha.conf>/gwha.conf in the [MISC] section.
  • The home switch in the startup files must have the syntax -- home /<path>/, as described in the Micro Focus (Novell) GroupWise documentation.

Requirement for GroupWise as standalone server

Groupwise Server (OES2/OES11/OES2015/OES2018 with installed and activated SMDR modules and TSAFS) with current SEP sesam Client.

Information sign.png Note
  • The SEP sesam Server and GroupWise server can be also the data mover server.
  • It is not recommended nor supported to have the SEP sesam Server, data mover server and GroupWise server running on a single machine.

Requirement for GroupWise as a Micro Focus cluster resource

All cluster nodes for GroupWise resource (OES2/OES11/OES2015/OES2018 with installed and activated SMDR modules and TSAFS ) with current SEP sesam Client.

Information sign.png Note
  • The SEP sesam Server can be also the data mover server.
  • It is not recommended nor supported to use the cluster nodes as data mover server.

Installing SEP sesam Client

Download and install the following items:

  1. Use the current SEP sesam Client for the supported server platform (v. > SLES10) from https://www.sep.de/downloadportal/linux/SuSE/ .
  2. Install the SEP sesam backup Client on the SEP sesam data mover and/or GroupWise server/cluster nodes
  3. rpm -Uvh <path to sesam client>/<client package>
  4. Use the current SEP sesam Micro Focus client from https://www.sep.de/downloadportal/netware/OES-Linux/.
  5. Install the SEP sesam Micro Focus client on the SEP sesam Server, SEP sesam data mover or GroupWise server
  6. rpm -Uvh <path to SEP sesam Micro Focus client package>/<Micro Focus client package>

Configuration on GroupWise server/cluster nodes

  1. Check if SMDRD is running and TSAFS is loaded correctly:
  2. rcnovell-smdrd status Checking for smdr daemon: running
  3. Check the file /etc/opt/novell/sms/tsafs.conf for line:
  4. tsamode=linux
  5. Check the file /etc/opt/novell/sms/smdrd.conf for line:
  6. autoload: tsafs --EnableGW or, if the tsamode in the tsafs.conf is not set to Linux: autoload: tsafs --EnableGW --tsamode=linux
  7. Check if TSAFS is loaded.
  8. /opt/novell/sms/bin/smsconfig -t loaded TSAs tsafs --EnableGW --tsamode=linux tsands Note that if you set the Linux TSA Mode in the tsafs.conf and not in the smdrd.conf, only the --EnableGW switch is visible.
SEP Tip.png Tip
A valid access from the SEP sesam data mover to the SEP sesam Client on the GroupWise server or to the cluster nodes must be allowed. Execute the following command on the Groupwise server or each cluster node:
 /opt/sesam/bin/sesam/sm_setup/set_client <hostname of SEP sesam data mover>

Configuring a GroupWise server or cluster as a SEP sesam Client

To protect your GroupWise environment, you must configure the Micro Focus GroupWise server or cluster as a SEP sesam Client. For details, see Configuring Clients.

  1. From Main Selection -> Components -> Topology, select your location and click the New Client button. The New Client window opens.
  2. In the New Client window, configure the following options:
    • Enter the Client name which is virtual NCP server name resolvable via DNS. For the cluster virtual NCP server name is shown in the ConsoleOne.
    • Select Linux from the Platform drop-down list and OES-Linux under the Operating system.
    • Choose the Access mode for the SEP sesam Server-Client communication (default setting is SMSSH, previously CTRL)).
    • GroupWise client Beefalo V2.jpg
    • Switch to the Micro Focus SMS tab, and specify Micro Focus SMS and data mover credentials.
  3. Click OK to add a GroupWise client to the SEP sesam environment.
Information sign.png Note
For GroupWise on non-NSS filesystem (POSIX) use root user for Micro Focus credentials or give your LUM-enabled eDir user the required POSIX permissions.

Known issues

If you have problems with Micro Focus GroupWise, check the Troubleshooting Guide.

See also

Novell GroupWise BackupNovell GroupWise Restore