jbreclaim(8)                                                         jbreclaim(8)

NAME

       jbreclaim - reclaim ownership of jukebox tape media

SYNOPSIS

       jbreclaim [ -n ] [ -s server ] [ -j <jukebox name> ] [ -v ]

      jbreclaim -h

DESCRIPTION

       jbreclaim interacts with external media managers to reclaim ownership
      of tape media that are already known to NetWorker's media database.
      This operation is generally performed when an external media manager,
      such as AlphaStor, is introduced into an established NetWorker environ-
      ment.
      
      To reclaim ownership of tape media, a NetWorker jukebox must already be
      configured to communicate with the external media manager that has
      assumed control over the media. AlphaStor is the only external media
      manager currently supported by jbreclaim.
      
      jbreclaim prints one status line for each processed piece of tape
      media. Each status line has the following form:
      barcode status
      
      barcode is the external barcode label of the tape media. status is
      either allocated, already allocated, needs to be allocated, or cannot
      allocate. Where possible, allocation failure status messages include
      the reason for the failure.
      
      The external media manager may reject the allocation request because
      the media is not present in its barcode inventory, or because the media
      is already allocated to another datazone or data mover.
      
      jbreclaim operates in interactive mode unless the -j option is present.
      In interactive mode, jbreclaim attempts to retrieve the list of all
      available jukeboxes on the server, and then prompts for a jukebox to be
      selected if more than one is available. For this reason, the -j option
      should always be specified when jbreclaim is used in a script, or when
      its output is intended for post-processing.
      
      If media allocated by jbreclaim does not appear in the NetWorker juke-
      box soon after the command completes, the media might not be physically
      located in the library, or the jukebox may need to be reinitialized
      with nsrjb -H. See nsrjb(8) for details.
      
      jbreclaim can be run from the NetWorker server or any storage node.
      "Configure NetWorker" privileges are required to run this command.

OPTIONS

       The following options are supported:
      
      -h Display the jbreclaim options.
      
      -j <jukebox name>
		jukebox name is the name of a NetWorker jukebox that is config-
		ured to communicate with the external media manager. If multi-
		ple NetWorker jukeboxes are configured with the same external
		media manager, then the name of any such jukebox can be speci-
		fied.
	
      -n	Perform a trial run to see what media is already allocated, and
		what media still needs to be allocated. When this option is
		specified, no media allocation requests are issued, and the
		environment is not modified in any way.

      -s server
		server is the name of the NetWorker server. If a server name is
		not specified, the local storage node is assumed to be the Net-
		Worker server.

      -v 	Enable verbose mode. Without this option, jbreclaim operates in
		quiet mode, and only issues messages about tape media which have
		been successfully allocated in this session, or which exist in
		the NetWorker media database, but could not be allocated. In
		verbose mode, the jbreclaim output also includes tape media
		which are already allocated.

EXIT STATUS

 	The exist status is zero when all required tape media allocation
	requests have been issued to the external media manager. This does not
	necessarily mean that all issued requests were granted.
	
	A non-zero exit status indicates that an error has occurred which pre-
	vented jbreclaim from issuing all required tape media allocation
	requests.

EXAMPLES

 	Without making any changes, see what tape media is already allocated,
	and what media still needs to be reclaimed:
	
		jbreclaim -s server -j jbname -nv
	
	Attempt to reclaim all tape media present in the NetWorker media
	database, and store allocation error messages in the file failed.txt:
	
	 jbreclaim -s server -j jbname | \ grep 'cannot allocate' >failed.txt

FILES

 	/nsr/res/nsrdb 	The NetWorker resource database.

DIAGNOSTICS

 	The following are some messages that jbreclaim might produce, along
	with their implications and possible solutions.
	
	Cannot find resource for jukebox `jukebox name'
		The jukebox name specified with the -j option is invalid. Check
		that the jukebox name is defined on the server.
	
	Failed to connect to NSR service on server name
		jbreclaim was unable to connect to the NetWorker server on the
		specified host name. Check that the server is up and running on
		host server name and that it is reachable from the host on which
		jbreclaim is running, and then retry the operation.
	
	Jukebox `jukebox name', cannot connect to DMI server
		jbreclaim was unable to connect to the AlphaStor DMI server.
		Check that the AlphaStor server is up and running, and that it
		is reachable from the host on which jbreclaim is running. Also
		check that the application name and application key attributes
		of the jukebox resource are configured correctly.
	
	Jukebox `jukebox name' configuration error: DMI initialization failure
		Check that the control port attribute of the jukebox resource is
		configured correctly.
	
	No jukeboxes are currently usable.
		There are no jukeboxes configured on the server or no configured
		jukeboxes are enabled and ready. Use the -j option to specify a
		jukebox that is configured but not enabled. See nsr_jukebox(5)
		for more details on the "enabled" and "ready" states.
	
	User user name on storage node does not have Configure NetWorker privi-
	lege on server name
		The user does not have privileges to modify the jukebox configu-
		ration.
	

SEE ALSO

 	nsr_jukebox(5), jbconfig(8), nsrjb(8).

NetWorker 8.0.1			 Dec 02, 12			jbreclaim(8)