Chapter 5 - Banyan File Service Directories
The Banyan File service directories contain all of the files supported by the VINES File service (VFS). There are three sets of file service directories:
The /disk1/banyan/bfs directory contains the Banyan File service executable and all its support files. The /diskn/BFS directories contain data directories for the VINES File service (drive Z), for all user-added file services, and for the VFS service itself. The /disk1/banyan/afp directory contains files that enable users to access files and folder from a Macintosh workstation.
The /disk1/banyan/bfs directory contains the service executable and all of its support files. The contents of this directory are as follows:
basedb1 (ASCII)
Lists all files on the Banyan server, their file sizes, and a cyclical redundancy check value.
basepath1 (ASCII)
Lists all files on the Banyan server. This contains the same file list as basedb1, but does not include the file sizes or cyclical redundancy check values.
bfs (Executable)
Banyan file service executable.
btlog.DB (ASCII)
B-tree database file. B-tree is an algorithm used by the Banyan File service to accelerate file searches.
cleanup (Script)
This is a very dangerous script. Deletes files in preparation for shipment to customer sites, and is also run before a full restore. This script is run by the PREPARE2SHIP utility.
concheck.err (ASCII)
Error file used by /disk1/banyan/util/concheck.
condos.db (ASCII)
Consistency check database used by /disk1/banyan/util/concheck during analysis of DOS VINESFiles.
conerrpt.err (ASCII)
Error file used by /disk1/banyan/util/conerrpt.
conos2.db (ASCII)
Consistency check database used by /disk1/banyan/util/concheck during analysis of OS/2 VINESFiles.
consyse.db (ASCII)
List of all error text files on the system.
delvfsvol (Executable)
Deletes the specified /diskn/BFS directory. This program is run by the destroy script.
initvfsdirs (Script)
Creates directories required by a Banyan file service. This script is used by /disk1/banyan/bfs/create and the /disk1/banyan/Init* initialization scripts.
initvfsvol (Executable)
Sets up VFS structures for a new service in the /disk1/banyan/bfs/VFSvolumetable file. This program is used by /disk1/banyan/bfs/create.
LOWERED (ASCII)
A file that indicates that the names in the /diskn/BFS directories have been converted to lower case. This was used during the 4.xx to 5.xx upgrade, and is preserved here for compatibility with the /pre-updateit and /postupdateit scripts.
newvoltab (Database)
Used by vfsck utility during its disk analysis. The space occupied by this file is used by the vfsck utility.
vfs.err (ASCII)
VINES File service error messages.
vfscktable (ASCII)
Maps diskn/BFS directories to their corresponding service names.
VFSvolumetable (Database)
Internal VFS database file.
cores (Directory)
Standard Banyan service directory, as described in Table 1-1.
create (Script)
Standard Banyan service file, as described in Table 1-1.
destroy (Script)
Standard Banyan service file, as described in Table 1-1.
dumpscript (Script)
Standard Banyan service file, as described in Table 1-1.
startup (Script)
Standard Banyan service file, as described in Table 1-1.
SvcLogs (ASCII)
Standard Banyan service file, as described in Table 1-1.
SvcTable (ASCII)
Standard Banyan service file, as described in Table 1-1.
svclogn (ASCII)
Standard Banyan service file, as described in Table 1-1.
The /diskn/BFS directories contain all File service data directories. These directories are as follows:
On disk1 only, the directory /disk1/BFS/VINESFiles. This directory contains data files used by the VINES Files service (drive Z on a DOS or Windows workstation). A directory called /diskn/BFS/servicename for every file service that is added to a server. These directories contain programs and data stored by users. A directory called /diskn/BFS/VFS on each logical drive that contains one or more /diskn/BFS/servicename directories. The File service uses the files in this directory to maintain the servicename directories on that drive.
Warning: It is vitally important that users avoid manipulating data in the disk1/BFS directories from the UNIX prompt. Any unexpected change to the data in these directories may result in a file service core, a complete system crash, or other inconsistencies, such as vfsck errors.
The directories in diskn/BFS are shown in Figure 5-1. Note that VINESFiles and its subdirectories are present only on /disk1.
The directories in /diskn/BFS are as follows:
/disk1/BFS/VINESFiles - Contains the data directories used by the VINESFiles service (drive Z on a DOS or Windows workstation). The directory is present on disk1 only.
/diskn/BFS/servicename - Root directory of a user-created file service. For example, "Personnel@server@Servers" has the root directory "/diskn/BFS/Personnel." A drive may contain multiple servicename root directories.
/diskn/BFS/VFS - Contains data used by the File service to manage the various file services.
/diskn/BFS/bfslogs/VINESFiles - Contains logs for the VINES Files service. This directory is present on disk1 only.
/diskn/BFS/bfslogs/servicename - Contains logs for a user-created file service. For example, "Personnel"@server@Servers" has the log directory /diskn/BFS/bfslogs/Personnel. A drive contains a log directory for each file service that has a root directory on that drive.
/diskn/BFS/VFS/AFP - Apple File Protocol data directory
/diskn/BFS/VFS/EAS - A database where all OS/2 extended attributes are stored. There is one of these directories for each file system on the server. For example, there is one directory for /disk1, one for /disk2, one for /disk3, and so on.
acls - Contains the access rights lists for file services on the disk. There is one such file for /disk1, one for /disk2, one for /disk3, and so on.
disk1/BFS/VFS/resource_forks - Directory containing the Macintosh resource fork for any file on the disk which has one.
fids - Directory containing a data file for each file service. For example, /disk1/BFS/VFS/fids/VINESFiles is the fid file for VINES Files.
Note: In this directory, UNIX operations, such as ls, might take days to complete, depending on the size of the system.
attributes - Contains the attributes for all files on the disk. There is one of these files per logical drive.
The following files, located in /disk1/BFS/VFS, are used for mapping between StreetTalk Names and internal StreetTalk IDs:
group_bmap idmap namemap org_bmap unknown_bmap user_bmap
The vfsck utility runs when a server is cold-started after a system crash. The utility is designed to test the integrity of the VINES Files service before it is made available to the network.
The vfsck utility copies some of the files and directories in /disk1/BFS/VFS and uses these copies during its analysis. These file are:
eabmap - Extended attributes. This file is present only on logical disks that have a file service data directory.
ngroup_bmap - Copy of group_bmap. This file appears only on /disk1.
nidmap - Copy of idmap. This file appears only on /disk1.
nnamemap - Copy of namemap. This file appears only on /disk1.
norg_bmap - Copy of org_bmap. This file appears only on /disk1.
nunknown_bmap - Copy of unknown_bmap. This file appears only on /disk1.
nuser_bmap - Copy of user_bmap. This file appears only on /disk1.
newacls - Copy of acls.
newattrs - Copy of the attrs directory.
newlinks - Copy of links.
newrforks - Copy of resource_forks.
After vfsck creates the files and uses them during processing, it does one of two things, depending on the switch specified with the vfsck command:
vfsck -y - Switches the newly created files with the old files
vfsck -n - Exits without switching the files
The files created by vfsck are left on the disk in an attempt to reserve disk space for vfsck in case of a crash. The utility does not complete processing if it cannot write its data to the disk.
The Apple File Protocol service allows you to access files and folders on the server from a Macintosh workstation. The files in the /disk1/banyan/afp service directory are as follows:
afp (Executable)
AFP service executable.
AFP0.log, AFP1.log (ASCII)
Standard Banyan service rolling log files.
AFPForks.DB (Database)
AFP resource forks database.
AFPSess.DB (Database)
AFP Sessions database. This file can be read by the analyzer utility.
AFP_Stats.db (Database)
Includes information on the AFP service start time. This file is rewritten each time the APF service is started and can be read by the analyzer utility.
AFP_Stats.last (Database)
Older version of the AFP_stats.db database. Used for tracking and debugging.
analyzer (Executable)
Analyzer program for the AFP service. Allows you to retrieve information from the AFP databases.
btafp0.liblog (ASCII)
B-Tree log file.
btlog.DB (ASCII)
B-tree database files. B-tree is an algorithm used by the Banyan File service to accelerate file searches.
desktop (Executable)
AFP database analyzer utility.
VERIFY_DTDB (ASCII)
Flag file placed in this directory to alert the AFP service that its database requires verification at next bootup.
amsevents.map (Database)
Standard Banyan service file, as described in Table 1-2.
cleanup (Script)
Standard Banyan service file, as described in Table 1-2.
cores (Directory)
Standard Banyan service directory, as described in Table 1-2.
create (Script)
Standard Banyan service file, as described in Table 1-2.
destroy (Script)
Standard Banyan service file, as described in Table 1-2.
dumpscript (Script)
Standard Banyan service file, as described in Table 1-2.
startup (Script)
Standard Banyan service file, as described in Table 1-2.
svclog5 (ASCII)
Standard Banyan service file, as described in Table 1-2.
SvcLogs (ASCII)
Standard Banyan service file, as described in Table 1-2.
svctable (Script)
Standard Banyan service file, as described in Table 1-2.
