Backing Up A Groupwise System In A Netware Cluster; Using Gwtsa In A Netware 5.1 Cluster - Novell GROUPWISE 7 - INTEROPERABILITY GUIDE Manual

Backing Up a GroupWise System
8
in a NetWare Cluster
®
The GroupWise Target Service Agent (GWTSA) is a GroupWise-specific API that works with
compatible backup software to provide reliable backups of a running GroupWise system on
®
NetWare 5.1. On NetWare 6.x, improved functionality is available with the GroupWise Target
Service Agent for File Systems (TSAFSGW). These TSAs can be used in a clustered GroupWise
system with appropriate preparation and understanding of how the TSAs work. For background
information about the GroupWise TSAs, see
GroupWise 7 Administration
Section 8.1, "Using GWTSA in a NetWare 5.1 Cluster," on page 111
Section 8.2, "Using TSAFSGW in a NetWare 6.x Cluster," on page 112

8.1 Using GWTSA in a NetWare 5.1 Cluster

In a clustering environment, GWTSA must be installed and loaded on each node from which your
backup software backs up any portion of your GroupWise system.
You should not install GWTSA on the cluster-enabled volumes where domains and post offices are
located. GWTSA cannot currently run in protected memory, nor can it run re-entrantly. If multiple
GroupWise volumes failed over to the same node, and if that node attempted to start an instance of
GWTSA for each GroupWise volume, only the first instance would run successfully. Subsequent
instances of GWTSA would fail and the domains and post offices specified for backup by those
instances would not be available to your backup software.
To accommodate the variable locations of data to back up from a clustered GroupWise system, the
.ncf file for GWTSA on each node should be edited to include a /home startup switch for every
domain and post office on every cluster-enabled volume that might ever be mounted on that node.
Set the /home startup switch to the physical volume name (without the server name), rather than the
cluster-enabled volume name, when specifying the location of each domain and post office. For
example:
Correct:
/home-gwvol1:\gwdom
Incorrect:
/home-gwcluster_gwvol1:\gwdom
Before your backup software starts backing up your GroupWise system, it calls GWTSA to verify
the accessibility of each physical volume specified by the /home startup switch.
Your backup software then backs up those domains and post offices that are currently accessible to
the GroupWise TSA and skips those that are not accessible. The backup runs successfully, even if
some locations are not currently mounted on the node where the GroupWise TSA is running.
Locations skipped when backups are run from one node will be caught when backups are run from
another node where the GroupWise TSA is also running.
"Target Service
Guide.

Backing Up a GroupWise System in a NetWare Cluster

Agents" in "Databases" in the
8
111