                                Adding Volumes
	

You must add volumes to the volume configuration before Media Manager can
use them. There are options for adding single volumes, a range of volumes,
or automatically adding volumes through use of a robot inventory.  Use the
Update Volume Configuration selection from the Robot Inventory dialog to
use the automated method for adding volumes.

When using the non-automated method for adding volumes to a robot, it is
important to remember that this is only a logical addition to the database.
You must also physically insert the media in the device. xvmadm expects the
media to be in the robot unless you specify the Inject via Mailslot/Inport
option when adding a single volume.


Adding a Single Volume

1.      Choose New and then Single Volume from the Actions menu in the Media
	Management window.

	This opens the New Volume dialog box. The New Volume dialog box
	consists of a Media Type option menu, a Robot Type option menu, an
	OK push button, and a Cancel push button.

2.      Choose the Media Type to add with the Media Type option menu.
	This is the media type of the volume you wish to add.

3.      Choose the Robot Type that the media is in with the Robot Type
	option menu. 

	The Robot Type option menu will only display Robot Types that are valid 
	for the selected Media Type. If there are no valid Robot Types for a 
	Media Type the only option is Not Robotic. (QIC 1/4-inch cartridge tape 
	is an example of a Media Type for which there is no supported Robot
	Type.)

4.      If you choose Not Robotic, the Adding Single Non-Robotic Volume dialog
	box opens. 

	Refer to the Add Single Volume Dialog Description section (below) for 
	instructions on completing each part of the dialog.

5.      If you choose a robot, the Adding Single Robotic Volume dialog box 
	opens.

	Refer to the Add Single Volume Dialog Description section (below) for 
	instructions on completing each part of the dialog.

6.      When you are through adding information for this volume:

	- If you are making multiple additions, it may be convenient to use the
	  Apply button to add this volume and the other volumes without closing 
	  the dialog.

	- Choose OK to complete the operation and return to the Media 
	  Management window.

	- Choose Cancel to cancel any changes made since the last apply and
	  return to the Media Management window.

7.      If you are adding the volume to a robot, insert the volume now.

	When you add a volume to a robot, choosing OK brings up a dialog that
	reminds you to insert the volume into the proper slot or mailslot 
	(inport on TLD).

	If you insert the volume now, it is added to the database, or volume
	configuration, and logically associated with the robot. If the robot 
	has a barcode reader, the barcode is also automatically read and added
	to the database.

	If you do not insert the volume now, the volume is still added to the
	database and logically associated with the robot.  However, you must use
	the Update Barcodes command to get the correct barcode into the database
	(see "Update Barcodes in a Robot" in the Media Manager System 
	Administrator's Guide).




		       Adding a Single Volume Dialog Description

Media Type

	This is the media type you selected in the New Volume dialog box.

Media ID
	Specify a one to six character name for the new volume.

	If you are adding an optical disk, name the A side of the optical 
	platter in this box.

	NOTE: Media IDs for robots under the sole direct control of robot
	      vendor software must always match the barcodes, where barcodes
	      are assumed to be the volume serial numbers (or volsers) by 
	      which the media is classified in the vendor media tracking
	      system.  Types of robotic control that include this requirement
	      are:
	         - ACS (Automated Cartridge System)
	         - TLH (Tape Library Half-inch)
	         - TLM (Tape Library Multiple) 
	      Inventory operations can query the vendor software to obtain
	      lists of volume serial numbers along with their associated 
	      vendor media types.

Partner ID

	If you are adding an optical disk, name the B side of the optical 
	platter in this box.

Description

	Enter a 1 to 25 character description of the volume.

Robot Type

	This is the robot type you selected in the New Volume dialog box.

Slot Number

	For a volume in an ODL, TC4, TC8, TL4, TL8, TLD, TS8, TSD, or TSH
	robot, move the slider to the slot number where you will insert the
	volume.  The scale displays only the range of allowable numbers. See
	appendix E of the Media Manager System Administrator's Guide for slot
	maps.

	NOTE: You do not enter slot information for media added to robots
	      under the sole direct control of robot vendor software. This
	      includes the ACS, TLH, and TLM robot types.  Media Manager
	      does not require slot location for those robot types because 
	      this information is tracked by the robot vendor software.

Robot Control Host

	For a volume in a robot, enter the name of the host that drives the 
	robot. This is the host on which you have defined the Robotic Device 
	File for this robot.

Robot Number

	For a volume in a robot, either select a robot that already exists from 
	the displayed list or enter a new robot number. The robot number must 
	match the one you used when defining the robot (see "Adding Robots" in
	the Media Manager System Administrator's Guide).

Volume Group

	Select one of the existing names displayed or enter the name of a volume
	group in the Selection box. In the case of a robot, if you leave the 
	field blank, xvmadm generates a name.

	A group name that is generated by the utility is formed using the robot 
	number and the designation of the device type, for example, 00_050_TS8 
	for a tape stacker with robot number 50.

	A volume group defines the volume by location and is a logical grouping 
	that identifies a set of volumes that reside at the same physical 
	location. Refer to "Configuring Volume Pools" in the Media Manager 
	System Administrator's Guide for examples of how volume groups relate to
	volume pools.

	Volume groups are an administrator convenience for moving multiple 
	volumes. The use of a volume group allows you, in a single operation,
	to logically move a set of volumes between a robot and a standalone 
	location, or delete them from the volume configuration, by specifying
	the volume group name rather than the individual media IDs.

	The following are some rules for specifying volume groups:

	- All volumes in a group must be the same media type.

	- All volumes in a robot must belong to a volume group. You cannot 
	  add volumes to a robot without either specifying a group or having the
	  utility generate a name.

	- A single, removable component, such as a carousel or data cartridge
	  holder can contain more than one volume group. For example, you can 
	  add more than one group to a robot or can add more than one group of 
	  nonrobotic volumes.

	- All members of a group must be either in the same robot or be 
	  nonrobotic. That is, xvmadm will not let you add a group (or part of a
	  group) to a robot if it already exists in another robot.

	To change the group attribute for a volume, move the volume to a 
	different group.

Volume Pool

	Select a volume pool from the displayed list or enter one of the 
	displayed names in the Selection box.

	Select NetBackup to make the volume available only to NetBackup.

	Select None to make the volume available to any user or application.

	If you designate a volume pool, it must be one that you created earlier 
	as explained in "Configuring Volume Pools" in the Media Manager
	System Administrator's Guide.  Otherwise, xvmadm assigns None as the 
	volume pool.

Label Media

	For a rewritable optical disk volume in an ODL device, you can choose 
	whether the platter should be formatted and labeled and, if so, whether 
	labels should be overwritten. The three options are:

		-  Yes, but do not overwrite old labels

		-  Yes and overwrite as needed

		-  No

	If you choose to format the disk, the formatting request is sent to the
	host on which xvmadm is running. This action may cause a mount request 
	that requires manual assignment by the operator.

	Even if the formatting cannot be completed for some reason, the volume 
	or volumes are still added to the volume configuration.

	The format operation formats both sides of the platters and 
	automatically writes a volume serial number (VSN) and volume header on 
	the media. The media ID of the volume being added is used as the volume 
	serial number. Both the volume serial number and volume header are 
	required before you can use an optical platter with Media Manager.

	You can also perform the format operation manually by using the tpformat
	command described in appendix A of the Media Manager System 
	Administrator's Guide.

	All platforms and operating systems do not support 1024 byte-per-sector 	
	platters.  Most support only 512 byte-per-sector sizes (about 1.2 
	gigabytes per platter).

	Before purchasing optical disk platters for an HP-Optical juke box, 
	check your vendor documentation to determine the optical-disk sector 
	sizes supported by your platform and operating system. Also, see the
	Operating Notes chapter in the NetBackup Release Notes for information
	on what has been tested.  If you are still unsure, call your sales 
	representative or technical support.

	In all cases, we also STRONGLY urge you to use preformatted platters.

Inject Via Mailslot (inport on TLD)

	For volumes in ODL, TL8, or TSH robots, select whether to inject the
	media into the device's mailslot.  For a TLD robot, choose whether to
	use the inport.

Cleaning Count

	For a cleaning tapes, specify the number of cleanings available.





		        Adding a Range of Volumes

The steps for adding a range of volumes to the database are very similar to
those for adding a single volume. xvmadm names the volumes automatically
according to the pattern you specify.

1.      Choose New and then Multiple Volumes from the Actions menu in the Media
	Management window.

	This opens the New Volume dialog box. The New Volume dialog box
	consists of a Media Type option menu, a Robot Type option menu, an
	OK push button, and a Cancel push button.

2.      Choose the Media Type to add with the Media Type option menu.
	This is the media type of the volume you wish to add.

3.      Choose the Robot Type that the media is in with the Robot Type
	option menu. 

	The Robot Type option menu will only display Robot Types that are valid 
	for the selected Media Type. If there are no valid Robot Types for a 
	Media Type the only option is Not Robotic. (QIC 1/4-inch cartridge tape 
	is an example of a Media Type for which there is no supported Robot
	Type.)

4.      If you choose Not Robotic, the Adding Multiple Non-Robotic Volumes 
	dialog box opens. 

	Refer to Adding a Range of Volumes Dialog Description (below) for 
	instructions on completing each part of the dialog.

5.      If you choose a robot, the Adding Multiple Robotic Volume dialog box
	opens.

	Refer to Adding a Range of Volumes Dialog Description (below) for 
	instructions on completing each part of the dialog.

6.      When you are through adding information for these volumes:

	- If you are making multiple additions, it may be convenient to use the
	  Apply button to add this volume and the other volumes without
	  closing the dialog.

	- Choose OK to complete the operation and return to the Media
	  Management window.

	- Choose Cancel to cancel any changes made since the last apply and
	  return to the Media Management window.

7.      If you are adding the volumes to a robot, insert them now.

	When you add volumes to a robot, choosing OK brings up a dialog that
	reminds you to insert the volumes into the proper slots.  If you do not
	insert the volumes, they are still added to the database, or volume 
	configuration, and logically associated with the robot.

	If the robot has a barcode reader, the barcodes are automatically read 
	and added to the database when you add the volumes, providing you also
	physically insert the volumes. If you insert the volumes later, then you
	must use the Update Barcodes command at that time (see "Update Barcodes
	in a Robot" in the Media Manager System Administrator's Guide).




		    Adding a Range of Volumes Dialog Description


Media Type

	This is the media type you selected in the New Volume dialog box.

First Media ID

	Enter the name of the first volume to be added. Use the same pattern as 
	you choose in the Media ID Style box below.  Media Manager automatically
	names the remaining volumes by incrementing the digits.

	NOTE: Media IDs for robots under the sole direct control of robot
	      vendor software must always match the barcodes, where barcodes
	      are assumed to be the volume serial numbers (or volsers) by 
	      which the media is classified in the vendor media tracking
	      system.  Types of robotic control that include this requirement
	      are:
	         - ACS (Automated Cartridge System)
	         - TLH (Tape Library Half-inch)
	         - TLM (Tape Library Multiple) 
	      Inventory operations can query the vendor software to obtain
	      lists of volume serial numbers along with their associated 
	      vendor media types.

Media ID Style

	Choose the button in this box to open a list of possible combinations 
	of leading alphanumeric characters and trailing digits. Then select the 
	style to use in creating the media IDs for this range of new volumes.

Number of Volumes/Number of Platters
	Specify the number of volumes to add.

	For a robot, this refers to the number of slots that must be reserved 
	for the new volumes.

	- For tapes, specify one volume per tape.

	- For optical disks, specify the number of platters you will be 
	  inserting into the robot. (Each side of the platter is considered 
	  one volume; therefore, the number of volumes is actually twice the 
	  number of platters.)

First Slot Number

	For volumes in a robot, move the slider to show the first slot number 
	to be used by this range of volumes.  Media Manager will assign the 
	remainder of the, slot numbers sequentially. See appendix E of the 
	Media Manager System Administrator's Guide for slot maps.

	NOTE: You do not enter slot information for media added to robots
	      under the sole direct control of robot vendor software. This
	      includes the ACS, TLH, and TLM robot types.  Media Manager
	      does not require slot location for those robot types because 
	      this information is tracked by the robot vendor software.

Description

	Enter a 1 to 25 character description of the volumes in the range.

Robot Type

	This is the robot type you selected in the New Volume dialog box.

Robot Host

	For volumes in a robot, enter the name of the host that drives the 
	robot. This is the host where you have defined the Robotic Device File 
	for this robot. If you choose an existing robot number (see Robot 
	Number below), the name is filled in automatically.

Robot Number

	For volumes in a robot, either enter a new robot number or choose one 
	that already exists from the displayed list.  Robot numbers must match 
	those you use when adding the robot. 

Volume Group

	Select one of the existing names displayed or enter the name of a 
	volume group in the Selection box. In the case of a robot, if you 
	leave the field blank, xvmadm generates a name.

	A group name that is generated by the utility is formed using the robot
	number and the designation of the device type, for example, 00_050_TS8 
	for a tape stacker with robot number 50.

	A volume group defines the volume by location and is a logical grouping 
	that identifies a set of volumes that reside at the same physical 
	location. Refer to "Configuring Volume Pools" of the Media Manager 
	System Administrator's Guide for examples of how volume groups relate 
	to volume pools.

	Volume groups are an administrator convenience for moving multiple 
	volumes. The use of a volume group allows you, in a single operation,
	to logically move a set of volumes between a robot and a standalone 
	location, or delete them from the volume configuration, by specifying
	the volume group name rather than the individual media IDs.

	The following are some rules for specifying volume groups:

	- All volumes in a group must be the same media type.

	- All volumes in a robot must belong to a volume group. You cannot 
	  add volumes to a robot without either specifying a group or having the
	  utility generate a name.

	- A single, removable component, such as a carousel or data cartridge
	  holder can contain more than one volume group. For example, you can 
	  add more than one group to a robot or can add more than one group of 
	  nonrobotic volumes.

	- All members of a group must be either in the same robot or be 
	  nonrobotic. That is, xvmadm will not let you add a group (or part of a
	  group) to a robot if it already exists in another robot.

	To change the group attribute for a volume, move the volume to a 
	different group.

Volume Pool

	Select a volume pool from the displayed list or enter one of the 
	displayed names in the Selection box.

	Select NetBackup to make the volume available only to NetBackup.

	Select None to make the volume available to any user or application.

	If you designate a volume pool, it must be one that you created earlier 
	as explained in "Configuring Volume Pools" in the Media Manager
	System Administrator's Guide. Otherwise, xvmadm assigns None as the 
	volume pool.

Label Media

	For a rewritable optical disk volume in an ODL device, you can choose 
	whether the platter should be formatted and labeled and, if so, whether 
	labels should be overwritten. The three options are:

		-  Yes, but do not overwrite old labels

		-  Yes and overwrite as needed

		-  No

	If you choose to format the disk, the formatting request is sent to the
	host on which xvmadm is running. This action may cause a mount request 
	that requires manual assignment by the operator.

	Even if the formatting cannot be completed for some reason, the volume 
	or volumes are still added to the volume configuration.

	The format operation formats both sides of the platters and 
	automatically writes a volume serial number (VSN) and volume header on 
	the media. The media ID of the volume being added is used as the volume 
	serial number. Both the volume serial number and volume header are 
	required before you can use an optical platter with Media Manager.

	You can also perform the format operation manually by using the tpformat
	command described in appendix A of the Media Manager System 
	Administrator's Guide.

	All platforms and operating systems do not support 1024 byte-per-sector 	
	platters.  Most support only 512 byte-per-sector sizes (about 1.2 
	gigabytes per platter).

	Before purchasing optical disk platters for an HP-Optical juke box, 
	check your vendor documentation to determine the optical-disk sector 
	sizes supported by your platform and operating system. Also, see the
	Operating Notes chapter in the NetBackup Release Notes for information
	on what has been tested.  If you are still unsure, call your sales 
	representative or technical support.

	In all cases, we also STRONGLY urge you to use preformatted platters.

Cleaning Count

	For a cleaning tapes, specify the number of cleanings available.


                            Robot Slot Layout

See Appendix E of the Media Manager System Administrator's Guide for
coordinate to slot mappings for supported robots.  Included here for
reference are coordinate charts for some of the supported TL8 robots:


                          TL8 coordinate chart

Coordinate to slot mappings for some TL8 robots:

        (for EXB-120 and EXB-60)
    ====================================
    A01-A10:   1-10    A11-A16:  111-116
    B01-B10:  11-20    B11-B20:   61- 70
    C01-C10:  21-30    C11-C20:   71- 80

    E01-E10:  31-40    E11-E20:   81- 90
    F01-F10:  41-50    F11-F20:   91-100
    G01-G10:  51-60    G11-G20:  101-110

        (for EXB-440 and EXB-480)
    ================================
             Fixed slot: 0
    Face 0:   1-10    Face 4:  41-50
    Face 1:  11-20    Face 5:  51-60
    Face 2:  21-30    Face 6:  61-70
    Face 3:  31-40    Face 7:  71-80

    Note - the side/face column of the display will show the
    EXB-120/EXB-60 versions of the mapping, even if the robot
    is an EXB-440/EXB-480 (i.e. slot 1 will show A01, slot 61
    in an EXB-480 will show B11, etc).

