This chapter describes the service and data directories of some less-known and less-used Banyan services. They are
/diskyan/nb - Banyan1/banyan/ata - AppleTalk Transfer Agent
/disk1/banyan/duptools - Banyan Duplication Tools (scripts that allow you to duplicate Banyan software releases)
/disk1/banyan/dump - Banyan Backup and Restore utility
/disk1/banyan/vt - Asynchronous Terminal Emulation service
/disk1/banyan/vcs - VINES Configuration service.
/disk1/ban Netbios Naming service.
The /disk1/banyan/ata directory contains the AppleTalk Transfer Agent and all of its support files. The files in /disk1/banyan/ata are as follows:.
ata (executable)
Appletalk Transfer Agent
ata0.log (ASCII)
Standard Banyan log, as described in Table 1-2.
ata1.log (ASCII)
Standard Banyan log, as described in Table 1-2.
cleanup (script)
Standard Banyan script, as described in Table 1-2.
create (ASCII)
Standard Banyan script, as described in Table 1-2.
destroy (ASCII)
Standard Banyan script, as described in Table 1-2.
startup (Script)
Standard Banyan script, as described in Table 1-2.
svclogn (ASCII)
Standard Banyan log, as described in Table 1-2.
The ata service allows Macintosh clients on a Banyan network to send standard VINES RPCs, encapsulated in an Appletalk packet, to the Banyan server as follows:
1. The ATA service receives the packet from the client.
2. ATA extracts the RPC from the Appletalk packet and sends the request to the VINES IP stack on the server.
3. VINES IP processes the request, and sends the response to ATA.
4. ATA encapsulates the response in an AppleTalk packet and returns the results of the RPC to the Macintosh client.
Figure 11-1 shows these transactions. The application running on the Macintosh calls VnsOpenSocket. The function is received by ATA, which processes the request and returns a BYCALLOK return code.
The /disk1/banyan/duptools directory contains utilities that allow you to duplicate Banyan software releases. The scripts in this directory are accessible from a hidden option on the System Maintenance menu. If you enter 3d at the System Maintenance menu, the Release Duplication menu appears, as shown in Figure 11-2.
This menu is described in detail in other Banyan documentation, such as the Banyan Server Operations Guide . The scripts and programs in /disk1/banyan/duptools that are run from this menu are as follows:
chose device (Script)
Determines which bantape program to use for the device chosen. The choices are tape, 5.25-inch diskette, and 3.5 inch diskette.
cmprelease (Script)
Compares a software release on diskette or tape to a release on disk.
create (Script)
Makes a new release set. This script takes two arguments from the UNIX command line: the revision of the software to create, and the device to be used for the output.
disk.space (Script)
Checks the amount of disk space available in the root partition to determine whether or not files can be copied to the root partition during the creation of a release.
dup.menu (Script)
Displays the Release Duplication menu. This script is called when you press `3d' from the System Maintenance menu.
flopupdate (Script)
Either replaces a single new diskette or replaces the disk image of a diskette. The diskette device is passed in as the first argument.
funequal (Executable)
Writes data to specified media.
help.dup (Script)
Help for the Release Duplication menu.
listitems (Script)
Puts each item on the command line on a menu and waits for the user to choose an item.
load (Script)
Loads a release tape or diskette onto the hard disk.
mounted (Script)
Lists mounted file systems by their root name.
verifyimage (Script)
Verifies a tape or diskette set against a disk image.
The /disk1/banyan/dump directory contains all the Banyan Backup and Restore utilities. The files in this directory are as follows:
amsevents.map (ASCII)
Contains a mapping between an alert id and the text string human-readable alert. The file is used by the VnsTranslateAlert function. The Banyan Alert Management service (AMS) compiler, bantup, automatically generates a file like this in the data directory of every service that issues alerts to AMS.
banfiles (Script)
This is a list of all the files under /disk1/banyan to be backed up. This list consists primarily of service database files, and other dynamic data.
brs.err (ASCII)
Error codes for Backup/Restore.
bs (Executable)
Backup/Restore console menu and utility. This program is called from bmenu. It backs up and restores from diskettes.
bs.msb (Database)
Message file for bs and tbs.
bsconv (Executable)
Converts version 4.11 backup/restore logs and history files to version 5.xx format.
chkbfsvols (Script)
Used during a restore to reconcile the differences between the /disk1/banyan/ss/SvcTable file on the hard disk with the file on the backup tape.
For example, suppose you are restoring a full backup tape and an incremental backup tape in the same restore session. In between the time of the full backup and the time of the incremental backup, a file service was deleted.
This script compares the /disk1/banyan/ss/SvcTable file on the full backup tape, and the /disk1/banyan/ss/SvcTable file on the incremental backup tape. When it discovers that the file service is deleted, it calls the program /disk1/banyan/bfs/delvfsvol to delete that file service from the hard disk. This way, a full restore followed by an incremental restore always results in the correct number of file services appearing on the hard disk.
cleanban.dmp (Script)
Destroys all the extended service data areas listed in the /disk1/banyan/ss/SvcTable. For example, this script destroys the /diskn/STDA, and diskn/BFS directories, if they exist on the server. This is a very dangerous script.
cleanup (Script)
Empty script file.
deletesvc (Script)
Destroys all extended service data that exists on the disk but is not listed in /disk1/banyan/ss/SvcTable.
dumpscript (Script)
Dumps Backup/Restore logs and core files to tape or diskettes.
expandnames (Script)
Creates a file called banfiles.out from banfiles. The banfiles.out file contains the path of every file to be backed up, relative to /diskn/banyan.
helpfiles (Directory)
Contains all of the help screens for the Backup/Restore menus.
kernfiles (ASCII)
A list of the files in /disk1/banyan/kern to be backed up.
kernfiles.out (ASCII)
Used by the Backup/Restore utility to restore new third-party peripheral binaries.
tbs (Executable)
Backup/Restore console menu and utility. This program is called from bmenu. It backs up and restore from diskettes.
The Backup/Restore utility backs up only two categories of files on a Banyan server:
Files listed in banfiles Extended data areas, such as diskn/BFS, /diskn/STDA, and so on.
Backup/Restore does not back up the following files:
Service executables Third-party service executables and data UNIX files, such as those in /bin
The /disk1/banyan/vt directory contains the Banyan Asynchronous Terminal Emulation service (ATE) and all of its support files. The files in this directory are listed in Table 11-7.
ASYservice (Executable)
ATE service executable.
Kermit (Executable)
Allows files to be transferred over telephone lines, using the Kermit protocol.
ttyinit.pid (ASCII)
Last known process ID of the ATE service.
vtoption (Executable)
Creates a zero-length file called VTScript. Neither vtoption nor VTScript is used by current versions of the Banyan ATE service.
ASY0.log, ASY1.log (ASCII)
Standard Banyan files, as described in Table 1-2.
cleanup (Script)
Standard Banyan file, as described in Table 1-2.
cores (Directory)
Standard Banyan directory, as described in Table 1-2.
create (Script)
Standard Banyan file, as described in Table 1-2.
destroy (Script)
Standard Banyan file, as described in Table 1-2.
dumpscript (Script)
Standard Banyan file, as described in Table 1-2.
startup (Script)
Standard Banyan file, as described in Table 1-2.
svccdLog (ASCII)
Standard Banyan file, as described in Table 1-2.
svclog15 (ASCII)
Standard Banyan file, as described in Table 1-2.
SvcLogs (ASCII)
Standard Banyan file, as described in Table 1-2.
The VINES Configuration Service (VCS) was originally designed as a general-purpose configuration service that would be used by all VINES services. To date, only the VINES Appletalk configuration utilities (/disk1/banyan/util/matalk) have been modified to use VCS.
The files in the /disk1/banyan/vcs directory are as follows:
arte.db (Database)
AppleTalk tunnels database.
arte.db# (Database)
A backup copy of the tunnels database.
atp.db (Database)
AppleTalk ports database.
atp.db# (Database)
Backup copy of the ports database.
VCS (Executable)
VCS service executable. Its main job is to maintain the AppleTalk databases (arte.db and apt.db).
vcslcfg (Executable)
This program is called by the /disk1/banyan/install/commstartup script at boot time. It loads the arte and atp databases into memory, then starts AppleTalk.
cleanup (Script)
Standard Banyan file, as described in Table 1-2.
cores (Directory)
Standard Banyan directory, as described in Table 1-2.
dumpscript (Script)
Standard Banyan file, as described in Table 1-2.
startup (Script)
Standard Banyan file, as described in Table 1-2.
startvcs (Script)
Standard Banyan file, as described in Table 1-2.
SvcLogs (ASCII)
Standard Banyan file, as described in Table 1-2.
(ASCII)
Standard Banyan file, as described in Table 1-2.
VCS0.log (ASCII)
Standard Banyan file, as described in Table 1-2.
VCS1.log (ASCII)
Standard Banyan file, as described in Table 1-2.
The /disk1/banyan/nb directory contains the Banyan Netbios Naming service and all of its support files. The files in this directory are as follows:
nb (Executable)
Netbios Naming service executable.
nb01 (Directory)
Contains logs and databases used by the Netbios service. See the following section for more information.
cleanup (Script)
Standard Banyan file, as described in Table 1-2.
cores (Directory)
Standard Banyan directory, as described in Table 1-2.
create (Script)
Standard Banyan file, as described in Table 1-2.
destroy (Script)
Standard Banyan file, as described in Table 1-2.
dumpscript (Script)
Standard Banyan file, as described in Table 1-2.
startup (Script)
Standard Banyan file, as described in Table 1-2.
svccdLog (ASCII)
Standard Banyan file, as described in Table 1-2.
svclogn (ASCII)
Standard Banyan file, as described in Table 1-2.
SvcLogs (ASCII)
Standard Banyan file, as described in Table 1-2.
SvcTable (ASCII)
Standard Banyan file, as described in Table 1-2.
The files in the /disk1/banyan/nb/nb01 directory are as follows:
NBlog_0.log, NBlog_1.log (ASCII)
Rolling log files for the Netbios naming service.
NBses.db (Database)
Netbios sessions database.
The VINES Proxy Agent (VPA) manages communications between workstations and the ENS for NetWare server, and between the ENS for NetWare server and the NetWare file server. It also acts as an intermediary between the ENS server and communications protocols like IPX/SPX.
The files in the /disk1/banyan/vpa directory are as follows:
agent (executable)
VINES Proxy Agent service executable.
cleanup (Script)
Standard Banyan file, as described in Table 1-2.
cores (Directory)
Standard Banyan directory, as described in Table 1-2.
create (Script)
Standard Banyan file, as described in Table 1-2.
destroy (Script)
Standard Banyan file, as described in Table 1-2.
dumpscript (Script)
Standard Banyan file, as described in Table 1-2.
startup (Script)
Standard Banyan file, as described in Table 1-2.
svccdLog (ASCII)
Standard Banyan file, as described in Table 1-2.
svclogn (ASCII)
Standard Banyan file, as described in Table 1-2.
SvcLogs (ASCII)
Standard Banyan file, as described in Table 1-2.
SvcTable (ASCII)
Standard Banyan file, as described in Table 1-2.
VPA0.log
Standard Banyan file, as described in Table 1-2.
VPA1.log
Standard Banyan file, as described in Table 1-2.