Adds a Tape Coordinator entry to the Backup Database
Synopsis
bak addhost -tapehost machine [-tcid tc_number] [-help]
Options
-tapehost machine
Names the machine for which the Tape Coordinator is to be added. Specify the machine's DCE pathname (for example, /.../abc.com/hosts/bak1),
its host name (for example, bak1.abc.com), or its IP address (for example, 11.22.33.44).
-tcid tc_number
Specifies the Tape Coordinator ID (TCID) to be assigned to the Tape Coordinator. Legal values are integers from 0 to 1023. A value must match the TCID
assigned to the Tape Coordinator in the dcelocal/var/dfs/backup/TapeConfig file on the -tapehost machine, and it must be unique among TCIDs in the Backup Database of the
local cell. Each Tape Coordinator must have its own TCID, but the TCIDs need not be assigned in sequence (for example, it is legal to skip numbers or to assign them out of order). If this option is
omitted, a value of 0 (zero) is used.
Issuing bak commands is most convenient if the Tape Coordinator used most often has a TCID of 0 (zero). The -tcid option can then be omitted to direct commands to that Tape Coordinator.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bak addhost command creates an entry for a Tape Coordinator in the Backup Database. The entry indicates
· The machine for which the Tape Coordinator is defined (specified by -tapehost).
· The Tape Coordinator's TCID (specified by -tcid).
Repeat the command once for each Tape Coordinator on a Tape Coordinator machine. The Backup Database allows a maximum of 1024 Tape Coordinators in the local cell.
The mapping between the TCID of a Tape Coordinator and the device name of the drive with which it is associated is recorded in the TapeConfig file on the Tape Coordinator machine. The TapeConfig file must be altered accordingly when this command is issued.
Enter the bak lshosts command to list the Tape Coordinators that have entries in the Backup Database. Enter the bak rmhost command to remove the entry for a Tape Coordinator from the Backup Database.
Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.
Examples
The following command creates an entry in the Backup Database for a Tape Coordinator on the machine named bak1. The Tape Coordinator is assigned a TCID of
0 (zero); the mapping between the TCID of the Tape Coordinator and the device name of a tape drive must appear in the TapeConfig file.
$ bak addhost /.../abc.com/hosts/bak1
The following command creates an entry in the Backup Database for a Tape Coordinator on the machine named bak2; the Tape Coordinator has a TCID of 1.
$ bak addh /.../abc.com/hosts/bak2 1
Related Information
Commands: bak lshosts(8dfs)
Files: TapeConfig(4dfs)