JBEDIT(8)JBEDIT(8)NAMEjbedit - Add and delete device definitions to and from a NetWorker
jukebox.
SYNOPSISjbedit-a -f <device path> -E <element addr> [ -s server ] [ -j
<jukebox name> ] [ -v ]
jbedit-a-f <device name> -l [ -s server ] [ -j <jukebox name> ] [ -v
]
jbedit-d -f <device path> [ -s server ] [ -j <jukebox name> ] [ -v ]
jbedit-h
DESCRIPTIONjbedit allows a NetWorker user with "Configure NetWorker" privileges to
add or delete drive and device definitions to or from an existing juke‐
box definition in the NetWorker database. A drive is defined in Net‐
Worker as "the physical backup object, such as a tape drive, disk, or
file" and a device as "the access path to the physical drive." Every
drive therefore has at least one device associated with it, and every
device has exactly one drive with which it can be associated. The
addition of a device, even on an existing storage node, may require
changes to the Dynamic Drive Sharing (DDS) licenses.
jbedit complements the reconfigure library feature available through
the Networker Management Console. jbedit can be used as a fallback
means of editing library configurations if, for some reason, the recon‐
figure library program is limited (for example, the library does not
return the drive serial numbers).
jbedit supports all direct attached SCSI/SJI, SAN, NDMP and AlphaStor
libraries.
If the NSR_JUKEBOX environment variable is set, jbedit uses its value
as the name of the jukebox to edit. This behavior may be overridden by
-j option. If neither of these options are present, jbedit attempts to
retrieve the list of all available jukeboxes on the server, and prompts
for a jukebox to be selected if more than one is available.
To edit the library configuration, the jukebox must be enabled and
ready (see nsr_jukebox(5)). jbedit can be run from any storage node,
however it requires "Configure NetWorker" privileges.
OPTIONS
The following options are supported:
-a Add a drive/device.
-d Delete a drive/device.
-h Display the jbedit options and their usage.
-E The drive element address.
This is the data element address of the drive with which the
device is associated. When a new drive or device is being added
to a jukebox, jbedit needs to know the data element address of
the drive/device within the jukebox. The data element address is
the "decimal number" that the jukebox assigns to each of its
drives. Information about drives, data element addresses and
other information associated with a jukebox can be found in
relem(8), changers(8), sn(8) and sjisn(8).
-l The device being added is logical. Logical devices may be added
to AlphaStor libraries only.
-j Name of the jukebox that is to be edited.
-f Device path to be added or deleted.
A new device/drive instance may be added to a library only if
the device is auto-detected and available as an unconfigured
device in the NSR Storage Node resource, it is a logical device
(see -l option), or if it is available as a standalone
NSR device device. See ddmgr(8) and nsr_stor‐
age_node_resource(5) for more information on how to detect
devices on a storage node.
See EXAMPLES on how to add a new device/drive to a jukebox.
Also see specific format restrictions when adding an NDMP device
path.
-s Name of the NetWorker server. If not specified, local storage
node is assumed as the NetWorker server.
-v Run in verbose mode. Multiple -v options can be specified to
increase the level of verbosity. The higher the level, the more
verbose the output will be. Currently has a maximum of 5.
EXIT STATUSjbedit exits with a 0 on success and with a non-zero value on failure.
EXAMPLES
Adding a drive/device:
To add a new device /dev/rmt/0cbn from this storage node:
jbedit-s server -j jbname -a -f /dev/rmt/0cbn -E 82
To add a new device /dev/rmt/0cbn from storage node "sn":
jbedit-s server -j jbname -a -f sn:/dev/rmt/0cbn -E 82
To add an NDMP device nrst0l from storage node "ndmpsn":
jbedit-s server -j jbname -a -f "ndmpsn:nrst0l (NDMP)" -E 82
Please make sure that the device path ends with " (NDMP)".
To add a logical device ldev01 to an AlphaStor library from
storage node "sn":
jbedit-s server -j jbname -a -f sn:ldev01 -l
Deleting a drive/device:
To delete device /dev/rmt/0cbn from this storage node:
jbedit-s server -j jbname -d -f /dev/rmt/0cbn
To delete device \\.\tape0 from storage node "sn":
jbedit-s server -j jbname -d -f sn:\\.\tape0
To delete an NDMP device nrst0l from storage node "ndmpsn":
jbedit-s server -j jbname -d -f "ndmpsn:nrst0l (NDMP)"
FILES
/nsr/res/nsrdb The NetWorker resource database.
SEE ALSOddmgr(8), changers(8), jbconfig(8), nsrjb(8), relem(8), sjisn(8),
sn(8), nsr_device(5), nsr_jukebox(5), nsr_storage_node(5),
nsr_storage_node_resource(5)DIAGNOSTICS
The following are some messages that jbedit might produce along with
their implications and possible solutions.
cannot connect to NSR service on <server name>
jbedit was unable to connect to the NetWorker server on the
specified host name. Check that the server is up and running on
the server host and that it is reachable from the host on which
jbedit is running and retry the operation.
User <user name> on <storage node> does not have Configure NetWorker
privilege on <server name>
The user does not have privileges to add/remove devices.
No jukeboxes are currently usable.
There are no jukeboxes configured on the server or no configured
jukeboxes are enabled and ready. Please check nsr_jukebox(5)
for more details on the "enabled" and "ready" states.
Cannot find jukebox <jukebox name> for server <server name>
The jukebox name specified with -j option is invalid. Please
check that the jukebox name is defined on the server.
Cannot find any jukebox with a device named <device name> for server
<server name>
While deleting the device with -d option, either the jukebox
name specified with -j option is invalid or the device name
specified with -f option is invalid.
Couldn't retrieve NSR Storage Node resource information for <stor‐
age node>
The nsr_storage_node_resource(5) on which the device is going to
be created does not exist on the server. Create a new storage
node for <storage node> and run 'Scan for devices' before adding
any new devices from the <storage node>.
The device <device name> is already part of jukebox <jukebox name>
The device name specified with -f option already belongs to
<jukebox name>.
Cannot find device <device name> in 'unconfigured device names'
resource
The device name specified with -f option is not available from
nsr_storage_node_resource(5). Please run 'Scan for devices' on
the storage node to discover the device.
NetWorker 7.3.2 Aug 23, 06 JBEDIT(8)
