Target Service Agent (TSAFSGW) for Linux and Netware
(Last modified: 16Sep2005)
This document (10098834) is provided subject to the disclaimer at the end of this document.
fact
TSAFSGW
Groupwise 7.0
Groupwise 6.5
TSA5UP18
symptom
TSASFGW doesn't back up document storage areas
goal
Introduction
fix
TSAFSGW, the latest version of the GroupWise Target Service Agent, operates much the same as the existing GroupWise TSA (GWTSA). It supports the same home switch command line syntax as the GWTSA and provides the same high-level GroupWise objects (domains and post offices) to the 3rd party backup software.
It differs in that it is not a stand-alone tsa like the GWTSA, but instead, works through (and is therefore dependent on) the GroupWise-enabled file system tsa (tsafs) to back up and restore GroupWise data.
goal
Obtaining and Installing SMS components (including tsafs)
fix
The GroupWise-enabled tsafs is available as part of the novell-sms package on the Novell Open Enterprise Server Linux platform. The novell-sms package will also be available as a stand-alone rpm for installation on other Linux platforms.
To install the sms rpm, login as root and type tye following at the console:
rpm -ivh novell-sms-1.0.0-xx.i586.rpm
Then start the smdr daemon:
/etc/init.d/smdrd start
Verify that the smdrd daemon is running:
/opt/novell/sms/bin/smsconfig -t
The GroupWise-enabled tsafs NLM ships with current versions of NetWare and its service packs. SMS updates (which include the GroupWise-enabled tsafs) can occur between NetWare service packs. These updates can be downloaded from the Novell Support website. Search for 'tsa5up??.exe' (include the question mark wilcard characters).
goal
Enabling tsafs GroupWise Enhancements
fix
The GroupWise enhancements built into the tsafs must be enabled manually by way of the EnableGW command line switch.
EnableGW (NetWare)
To enable the GroupWise enhancements, type the following at the command line
MYSERVER:unload tsafs
Module TSAFS.NLM unloaded
MYSERVER:tsafs /EnableGW=yes
To disable the GroupWise enhancements, type the following at the command line
MYSERVER:unload tsafs
Module TSAFS.NLM unloaded
MYSERVER:tsafs /EnableGW=no
Once enabled, the GroupWise functionality will remain enabled until explicitly disabled.
To determine the state of the EnableGW switch, simply type 'tsafs' at the command line while the tsafs is loaded. Hit any key to scroll down until the EnableGW status appears on the screen.
See the Technical Information Document FAQ: Backing up GW 6.5 with TSAFS.NLM instead of GWTSA.NLM (FAQ-Frequently - TID10095203 for more information on the GroupWise-enabled tsafs.
EnableGW (Linux)
open a terminal and log in as root.
cd /opt/novell/sms/bin
Unload the tsafs by typing
./smsconfig -u tsafs
Reload the tsafs with the --EnableGW switch by typing the following:
./smsconfig -l tsafs --EnableGW
In order to make this change permanent, edit the /etc/opt/novell/sms/smdrd.conf file.
In the smdrd.conf file, modify tsafs autoload line:
change
autoload: tsafs
to
autoload: tsafs --EnableGW
Loading tsafsgw on NetWare
Follow the same steps for loading the tsafsgw on NetWare as you would for loading the GWTSA. The GWTSA and the tsafsgw may not be loaded simultaneously.
Loading tsafsgw on Linux
If not already present, copy the libtsafsgw.so.<version> file into the /opt/novell/lib directory.
If not already present, create a symbolic link to the libtsafsgw.so.<version> file.
While logged in as root, execute the following:
cd /opt/novell/lib
ln -s libtsafsgw.so.<ver> libtsafsgw.so
You should now be able to load the tsafsgw.
As root, execute the following:
cd /opt/novell/sms/bin
smsconfig -l tsafsgw -home /yourDomainPath -home /yourPostOfficePath
You can also use smsconfig to display a list of loaded TSAs.
As root, execute the following:
/opt/novell/sms/bin/smsconfig -t
smsconfig will output a list of loaded TSAs:
The loaded TSAs are:
tsafs --EnableGW
tsafsgw -home /yourDomainPath -home /yourPostOfficePath
If you would like the tsafsgw to load automatically, add an 'autoload' line to the smdrd.conf file. Edit /etc/opt/novell/sms/smdrd.conf and find the tsafs autoload line.
autoload: tsafs \u2013EnableGW
add the tsafsgw autoload line after the tsafs autoload line.
autoload: tsafsgw -home /yourDomainPath -home /yourPostOfficePath
goal
GroupWise Database Caching
fix
The tsafsgw makes a temporary copy of GroupWise databases on disk during the backup process. This minimizes the time that the backup process locks the live GroupWise database so that the GroupWise agents continue to run smoothly during backup.
The default location for the temporary files on NetWare is in the SYS:SYSTEM\TSA\TEMP directory.
The default location for the temporary files on Linux is the /tmp directory.
The user may specify an alternate location via the \u201ctempdir\u201d command line switch. The syntax for the 'tempdir' switch is the same as that of the 'home' switch.`
goal
Known issues
fix
1- The 'home' and 'tempdir' switches are the only command line switches supported by the current version of the tsafsgw. Since the tsafsgw works through the tsafs, backup performance is tuned by adjusting the tsafs command line switches.
2- The current version of the tsafsgw does not automatically exclude unnecessary files. See the Technical Information Document FAQ: Backing up GW 6.5 with TSAFS.NLM instead of GWTSA.NLM (FAQ-Frequently - TID10095203 for a list of files that may be manually excluded in order to prevent spurious error messages during backup.
3- The current version of the tsafsgw does not automatically list document storage areas. In a default GroupWise installation this is not an issue because they are placed in the post office directory and are backed up as part of the post office. Where document storage areas are outside of the post office directory, manually add a /home switch to the tsafsgw command line parameters.
4- In its default configuration, the tsafs caches multiple files simultaneously to increase backup performance. This can have a detrimental effect on the GroupWise agents, since the tsafs can retain database locks long enough for the GroupWise agents to time out. The tsafsgw automatically disables the tsafs' caching mode for all tsafsgw backups. There is no longer a need to add the /NoCachingMode switch to the tsafs startup parameters.
5- A full backup of the top level object \u201cGroupWise System\u201d will back up all 'home' switch directories, including [TMP] directories.
6- On NetWare, the OES version of the tsafs is required for restore. Otherwise, files in the root directory of the backup are restored to the wrong place.
7- The user logged in to the tsafsgw must have write permissions to the database files. Otherwise, the databases lock operation will time out, and the databases will be skipped with an 0xFFFDFFF5 (NWSMTS_DATA_SET_IN_USE) error.
document
| Document Title: | Target Service Agent (TSAFSGW) for Linux and Netware |
| Document ID: | 10098834 |
| Solution ID: | NOVL103386 |
| Creation Date: | 08Sep2005 |
| Modified Date: | 16Sep2005 |
| Novell Product Class: | GroupWise Client/Admin |
disclaimer
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.