tlhd

tlhd, tlhcd — Tape library half-inch (TLH) daemon (process on Windows systems) or control daemon (process on Windows systems)

SYNOPSIS

<volmgr_dir_path>tlhd [-v]

<volmgr_dir_path>tlhcd [-v] [-t]

On Windows systems, <volmgr_dir_path> is <install_path>\Volmgr\bin\

DESCRIPTION

Note:

This command applies only to the NetBackup Enterprise Server.

tlhd and tlhcd interface with Media Manager to mount and unmount tape volumes in a tape library half-inch (TLH) robot.

ltid is the Media Manager device daemon on UNIX and Linux systems and the NetBackup Device Manager service on Windows systems. tlhd interfaces directly with ltid. tlhd runs on each host with a drive connection and sends mount and unmount requests to the control daemon-process, tlhcd.

tlhcd communicates with the IBM Automated tape library (ATL) library manager, which processes all requests and all control functions for the robotic library. TLH robotic control software permits drives in the same robot to be configured on different hosts. tlhcd can be running on a different host than tlhd, depending on where the IBM library control is configured (see EXAMPLES). When communication with the library is established, tlhd puts the TLH robot in the UP state and can request volume mounts and unmounts. If the library or the control daemon is inaccessible, tlhd changes the robot to the DOWN state. In this state, tlhd is still running and returns the robot to the UP state if tlhcd is able to make a connection.

Note:

If drives are on different hosts, enter the robotic information in the Media and Device Management of the Administration Console on all machines. The robot number must be the same on all machines.

On Windows systems, tlhd and tlhcd are started when the NetBackup Device Manager service is started. They are stopped when this service is stopped. The control process, tlhcd, is on the host that has the robotic control. tlhd starts it automatically on that host (see EXAMPLES). tlhcd stops when you stop the NetBackup Device Manager service.

Before you access any volumes through the NetBackup Device Manager service (Windows systems), ltid, tlhd, and tlhcd, define the following information: the media ID and slot number for volumes in a robot in the EMM database. Both the initial EMM database population and future updates can be accomplished by using Media Manager robotic inventory options.

If a cleaning volume is used, it must be defined in the volume configuration. See tpclean about how to set the frequency to clean the drive automatically.

The drives are configured by using IBM device names. The robotic test utility, tlhtest (robtest if the robot is configured), can be used to determine the device names that are associated with the robot. You can also use this utility along with IBM's mtlib command-line interface to verify library communications, status, and functionality.

Configure the drive cleaning operation for the tape library half-inch robotic control through an IBM library manager console. The cleaning operations are not available to applications that use the IBM library manager. For this reason, you cannot define the volumes to clean through Media Manager. In addition, you cannot use the Media Manager utilities or the tpclean command for cleaning operations on drives under TLH robotic control.

On Windows systems, the Internet service port number for tldcd must be in %SystemRoot%\system32\drivers\etc\services. To override the services file, create the install_path\Volmgr\database\ports\tldcd file with a single line that contains the service port number for tldcd.

The default service port number is 13717.

You must have administrator privileges to run this command.

ERRORS

tlhd and tlhcd log an error message if a copy of the daemon or process is in operation. Media Manager logs any tape library half-inch and robotic errors to syslogd (UNIX and Linux systems) or to the application event log (Windows). Log entries are also made when the state changes between UP and DOWN.

SEE ALSO

tpclean, tpconfig