unixtsa.conf(4)


unixtsa.conf -- configuration file for Storage Management System for Target Service Agent

Description

The tsad(1) program is responsible for notifying a set of NetWare servers that it (the UnixWare TSA daemon) is running. Each server notified will be able to back up filesystems on the UnixWare machine. The unixtsa.conf file tells tsad the names of NetWare servers to contact, and which protocols to use for each server. This is a normal ASCII file.

Blank lines in the file are ignored. Any line beginning with a number sign (#) is considered to be a comment and also ignored.

Each non-blank, non-comment line in the file must have the following format:

   server_name protocol [TSA_codeset server_codeset [server_locale]] 
At least the following two white-space separated fields are required:

server_name
The name of the NetWare server to contact.

protocol
The protocol to be used in contacting the server. Currently supported protocols are TCP and SPX. It is valid to list the same NetWare server twice with different protocols; this tells tsad to notify the indicated servers and listen for backup requests over both network protocols.
There are also three optional parameters that specify locale information for each of the listed servers, and a special entry for unnamed NetWare workstations running the backup engine. If present, these entries ensure that the UnixWare machine and the NetWare server or workstation running the SMS backup engine are using compatible internationalization locales and codesets.

TSA_codeset
This is the name of the codeset used by the local UnixWare machine (and, hence, tsad). It must be specified along with server_codeset.

server_codeset
This is the name of the codeset used by the remote NetWare server named by server_name. It must be specified along with a TSA_codeset.

server_locale
This is the name of the locale used by the remote NetWare server named by server_name. If server_locale is specified, then both TSA_codeset and server_codeset must also be specified.
For unnamed NetWare workstations (running DOS or Windows), a special entry can be created in the file using a server_name of ``default''. The codesets and locale specified on the default line will be used when an unnamed workstation contacts tsad. Note that the protocol specified on the default line is ignored, but must be specified (that is, it can be either TCP or SPX, and will still apply to requests received over both protocols).

For more information on the use of NetWare backup services from UnixWare, see ``NetWare backup and restore''.

Usage

This same file format may be used to create a Network Information Service (NIS) map called unixtsa, which will be used in a similar fashion by tsad processes running in the same NIS domain. For more information on NIS, refer to ``Administering the Network Information Service (NIS)''.

References

setlocale(3C), tsad(1), tsaunix(1)

Examples

The following is a typical unixtsa file:
   lora    tcp 
   thneed  spx 
   thneed  spx 

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.