System Administration Commands mmsadm(1M)
NAME
mmsadm - administration command for the Media Management
System
SYNOPSIS
/usr/sbin/mmsadm [-h -?]
mmsadm discover [-H] [-t librarydrivevol] [-S ACSLS-host[:port] -a
mmsadm create -t librarydrivempooldpoolappvoltype
-o option=x [-o option2=y...] name
mmsadm delete -t librarydrivempooldpoolappvoltype
[-f] name
mmsadm set -t librarydrivempooldpoolappvoltype
-o option=x [-o option2=y...] name
mmsadm list [-vH] -t librarydrivempooldpoolappvoltype
-o option=x [-o option2=y...] [-F filter [-F filter2...] [name]
mmsadm passwd [-P file] name
mmsadm online -t librarydrive name
mmsadm offline -t librarydrive name
mmsadm add-volume -l library -o voltype=type -x vol1[,vol2,...] mpool
mmsadm remove-volume -x [-l library] [-x vol1[,vol2,...] mpool
mmsadm label [-n] [-A application] [-l library]
[-P file]volume[,volume,...]
mmsadm showreq [-H] [drivename]
mmsadm accept [-r "reason"] requestid
SunOS 5.11 Last change: 27 Jan 2009 1
System Administration Commands mmsadm(1M)
mmsadm reject [-r "reason"] requestid
mmsadm dbbackup directory
mmsadm dbrestore file
mmsadm mount [-n] [-N] [-d drive] [-D density] -A application -l library
[-P passwordfile] [-u username] [-b blocksize] [-R]
[-M mode[,mode...] volume
mmsadm unmount [-A application] [-P file] [-f] volumepseudodevice
DESCRIPTION
The Media Management System (MS) is a software interface
that manages removable storage media such as tape libraries,
tape drives, media pools, tape volumes, and disk resources
that emulate tape drives and tape volumes. It is an imple-
mentation of the IE 1244 specification for removable
media.
The MS consists of an M server and database that control
various library managers and drive managers. Administrators
use mmsadm and its subcommands to configure and maintain
storage resources from a variety of vendors. The MS manage-
ment commands, such as mmsadm, construct and issue the most
frequently-used Media Management Protocol (MP) commands,
handling all events and acknowledgments. The MP is defined
in the IE 1244 specification.
The mmsinit(1M) command must be run to initialize MS on a
system before you can use the mmsadm command.
The mmsadm command is RBAC-compliant. (See rbac(5).)
Required authorizations vary among individual subcommands
and are listed in the descriptions of those subcommands.
SUB-COMANDS
The mmsadm supports the subcommands listed below. Each sub-
command description includes a description of that
subcommand's options and operands. A mmsadm command takes
the form:
# mmsadm subcommand [options]
SunOS 5.11 Last change: 27 Jan 2009 2
System Administration Commands mmsadm(1M)
discover Subcommand
The discover subcommand displays the library, drives, or
volumes on an Automated Control System Library Server
(ACSLS) server, or the tape drives connected to the local
system. Use this command to determine what resources are
available and whether they have been configured for use with
MS.
discover requires the solaris.smf.read.mms authorization.
The subcommand has the following syntax:
mmsadm discover [-H] [-t librarydrivevol]
[-S ACSLS-host[:port] -a
The subcommand options are described as follows.
-a
Displays all discovered resources, including those con-
figured for MS. By default, only unconfigured resources
are displayed.
-H
Displays the resources in a manner parseable by scripts.
The display does not include headers and it separates
fields with a tab character.
-S ACSLS-host[:port]
Displays resources managed by the specified server and
port. The default port number is 50004. If the -S option
is not used, the command displays tape drives connected
to the local system.
-t librarydrivevol
Displays only the specified type of resource:
-t library
Shows discovered libraries.
SunOS 5.11 Last change: 27 Jan 2009 3
System Administration Commands mmsadm(1M)
-t drive
Shows discovered drives.
-t vol
Shows discovered volumes.
If this option is not used, library and drive resources
are included in the display. The number of volumes can
be large so their discovery must be requested expli-
citly.
create and set Subcommands
The create subcommand configures the resource to be managed
by MS. The set subcommand modifies the attributes of a
resource managed by MS. These subcommands share a common
set of options.
ACSLS-controlled libraries and disk archiving libraries are
supported. Libraries must be configured before any drive
pool and drives managed in that library can be configured,
or any volumes managed by the library added to media pools.
voltype must be configured before adding volumes to media
pools.
The create and set subcommands require the
solaris.smf.modify.mms, solaris.smf.value.mms,
solaris.mms.*, and solaris.smf.read.mms authorizations, with
the exception of changing tracing attributes. If changing
the size of trace files or trace level, only
solaris.mms.device.log and solaris.smf.read.mms authoriza-
tions are required.
These subcommands have the following syntax:
create -t librarydrivempooldpoolappvoltype
-o option=x [-o option2=y...] name
set -t librarydrivempooldpoolappvoltype
-o option=x [-o option2=y...] name
The subcommand options and operand are described as follows.
SunOS 5.11 Last change: 27 Jan 2009 4
System Administration Commands mmsadm(1M)
-t type
Specifies the type of resource being created or modi-
fied. type can be one of:
library Tape library
drive Tape or disk archiving drive
mpool Media pool
dpool Drive pool
app MS-aware application
voltype An MS construct to map tape cartridge types
(such as LTO3) to a user-defined type. Allows
the user to specify a default cartridge size
for this type of tape.
-o option=x [-o option2=y...]
Options are key/value pairs and are specific to the
resource type.
Library Options:
hwtype=type
Specify one of the supported library types: L180,
L500, L700, SL500, or SL3000. This option is
required for create operations.
For disk archiving libraries, specify DISK.
The following are options for real network attached
libraries.
acs=acsnumber
Specifies the ACSLS ACS number for the library, as
shown by the discover subcommand. Required for
create.
SunOS 5.11 Last change: 27 Jan 2009 5
System Administration Commands mmsadm(1M)
lsm=lsmnumber
Specifies the ACSLS LSM number for the library, as
shown by the discover subcommand. Required for
create.
serialno=serialnum
Specifies the serial number of the library as
reported by the discover subcommand. Required for
create.
acsls=host[:port]
Identifies the host and port number of the ACSLS
server controlling the library. If not specified,
the default port is 50004. Required for create.
The following are options for disk archiving libraries.
dkpath=path
Defines the default path of the DISK library. The
path specifies the parent directory of the library
and its name must not be the last component of the
path.
dkaltpath=host1@directory1[,host2@directory2]
Defines the path of a DISK library in a host which
cannot use the default path to access the DISK
library. The path specifies the parent directory of
the library and its name must not be the last com-
ponent of the path.
All libraries have the following options.
msg-level=emergencyalertcriticalerrorwarningnotice
informationdebug
Specifies the level of detail in messages written to
the log file. The default level is error.
trace-level=emergencyalertcriticalerrorwarning
noticeinformationdebug
Specifies the level of detail in messages written to
the trace file. The default level is error.
SunOS 5.11 Last change: 27 Jan 2009 6
System Administration Commands mmsadm(1M)
trace-file-size=size
Specifies the maximum size of the trace file before
it is rotated and restarted. Specify the size using
a value and the character that identifies the unit:
o K for kilobytes
o M for megabytes
o G for gigabytes
The default size is 10 megabytes. To set the maximum
size of the trace file to 15 megabytes (for exam-
ple), enter:
trace-file-size=15M
Drive Options:
hwtype=type
Specifies the drive type as reported from the dis-
cover subcommand. Required for create.
serialno=serial
Specifies the serial number of the drive as reported
from the discover subcommand. Required for create.
library=libraryname
Defines the MS identifier of the library control-
ling this drive as reported from the list subcom-
mand. Required for create.
connection=host,[host]
Identifies the host name or IP address to which the
drive is physically connected. If the drive is mul-
tiported, enter each host separated by a comma.
Required for create.
apps=app1[,app2,...]
Specifies which applications registered with MS can
use this drive. To specify that more than one
SunOS 5.11 Last change: 27 Jan 2009 7
System Administration Commands mmsadm(1M)
application can use this drive, enter each applica-
tion name, separated by commas.
msg-level=emergencyalertcriticalerrorwarningnotice
informationdebug
Specifies the level of detail in messages written to
the log file. The default level is error.
trace-level=emergencyalertcriticalerrorwarning
noticeinformationdebug
Specifies the level of detail in messages written to
the trace file. The default level is error.
trace-file-size=size
Specifies the maximum size of the trace file before
it is rotated and restarted. Specify the size using
a value and the character that identifies the unit:
o K for kilobytes
o M for megabytes
o G for gigabytes
The default size is 10 megabytes. To set the maximum
size of the trace file to 15 megabytes (for exam-
ple), enter:
trace-file-size=15M
unload-time=numminutes
Specifies the maximum time an unused volume is left
in a drive before it is ejected. After an applica-
tion has finished using a volume, it is often left
in the drive. This is to speed up requests if the
same volume is needed again in a short amount of
time. This option ensures the drive is emptied and
available to load other volumes when requested. The
default number of minutes is 60.
reserve=yesno
SunOS 5.11 Last change: 27 Jan 2009 8
System Administration Commands mmsadm(1M)
Defines whether access to a drive is enforced. Use
yes to use SCSI reserve and release commands to
enforce access to the drive. Use no to not use SCSI
reservations. Use no only if the drive behaves
improperly when access is enforced, or if the drive
does not support the SCSI reservation commands. The
default value is yes.
Drive Pool Options
Specifies which applications registered with MS can use
this drive pool. To specify that more than one applica-
tion can use this pool, enter each application name,
separated by commas.
Media Pool Options
apps=app1[,app2,...]
Specifies which applications registered with MS can
use this media pool. To specify that more than one
application can use this pool, enter each applica-
tion name, separated by commas.
Application Options
retain=numdays
Specifies the number of days that the volume's data
is preserved after the expiration date defined by
the application for a volume. The default value is
0.
validate-expiration=yesno
Specifies whether overwriting unexpired files is
allowed. Use no to allow overwriting of unexpired
volume files. Use yes to prevent overwriting unex-
pired volume files. The default value is no.
validate-volid=yesno
Specifies whether the volume identifier is verified.
Use yes to verify that the volume ID obtained from
the mmsadm mount command matches the volume identif-
ier on the volume label. Use no to specify that this
verification is not done. The default value is yes.
SunOS 5.11 Last change: 27 Jan 2009 9
System Administration Commands mmsadm(1M)
validate-filename=yesno
Specifies whether the file name is verified. Use yes
to verify that the file name obtained from the
mmsadm mount command matches the file name on the
HDR1 header label of the file. Use no to specify
that this verification is not done. The default
value is no.
overwrite-existing=yesnoask
This option is only for unlabeled volumes that are
not blank. It specifies whether the data on an unla-
beled volume can be overwritten. The default is yes
to indicate data can be overwritten. Use no to
reject any write requests. Use ask to prompt an
operator for his wish when a write request is
received.
System Options
log-level=emergencyalertcriticalerrorwarningnotice
informationdebug
Specifies the level of detail in messages written to
the log file. The default level is error.
num-restarts=num
Specifies the number of attempts to start a failed
daemon before the drive or library associated with
the daemon is disabled and requires the mmsadm
online command to be run after the problem with the
system or device is resolved. Use a value of -1 for
unlimited restart attempts. The default value is 3.
attended=yesno
Specify whether MS makes operator requests when an
operation cannot be automatically satisfied. An
example of such a case would be if a mount request
was made for a tape volume that had been physically
removed from a library. The default action, yes,
indicates that an operator is available to respond.
Use no to specify that no operator is available. If
no operator is available, all operator requests are
rejected.
SunOS 5.11 Last change: 27 Jan 2009 10
System Administration Commands mmsadm(1M)
num-sockets=num
Specifies the number of open file descriptors the M
daemon can have at one time. On a resource-
constrained system, set this value to a number
between 30 and 65536. It is not recommended to set
the value to less than 256. The default value is -1,
meaning an unlimited number of file descriptors.
disk-timeout=seconds
Specifies the time a disk archiving drive manager
waits for the file system containing a disk archiv-
ing volume to become available. It is strongly
recommended to set the time to a minimum of 120
seconds (two minutes). Use a value of 0 to specify
no expiration time.
dkvol Options
dirname=path
Required by (and only valid for) create. Specifies
the directory in which the new disk archiving volume
will created.
size=num
Valid only for create. Specifies the size, in mega-
bytes, of the disk archiving volume.
readonly=truefalse
Sets the volume to read-only or to allow write
operations. The default is false, meaning that the
disk archiving volume is writeable.
mpool=poolname
Media pool to which this disk archiving volume will
be added after it is created. This option is
required for create.
dkdrive Options
apps=app1[,app2,...]
Specifies which applications registered with MS can
SunOS 5.11 Last change: 27 Jan 2009 11
System Administration Commands mmsadm(1M)
use this drive. To specify that more than one appli-
cation can use this drive, enter each application
name, separated by commas.
msg-level=emergencyalertcriticalerrorwarningnotice
informationdebug
Specifies the level of detail in messages written to
the log file. The default level is error.
trace-level=emergencyalertcriticalerrorwarning
noticeinformationdebug
Specifies the level of detail in messages written to
the trace file. The default level is error.
trace-file-size=size
Specifies the maximum size of the trace file before
it is rotated and restarted. Specify the size using
a value and the character that identifies the unit:
o K for kilobytes
o M for megabytes
o G for gigabytes
The default size is 10 megabytes. To set the maximum
size of the trace file to 15 megabytes (for exam-
ple), enter:
trace-file-size=15M
unload-time=numminutes
Specifies the maximum time an unused volume is left
in a drive before it is ejected. After an applica-
tion has finished using a volume, it is often left
in the drive. This is to speed up requests if the
same volume is needed again in a short amount of
time. This option ensures the drive is emptied and
available to load other volumes when requested. The
default number of minutes is 60.
voltype Options
SunOS 5.11 Last change: 27 Jan 2009 12
System Administration Commands mmsadm(1M)
mediatype=type
One of the supported media types: 9940, 9840, LTO1,
LTO2, LTO3, LTO4, SDLT2, and DISK. This option is
required for create.
size=num
The size, in megabytes, of the this volume type.
This option is required for create.
The create and set subcommands have the following operand.
name
Specifies the name of the resource being added or modi-
fied. With the exception of applications, names are sim-
ple text strings, and they must be unique for their
resource type. Recommended naming conventions are:
For a library: LIBtypeserial
Example: LIBL180MPC02209500
For a drive: DRVtypeserial
Example: DRVT9940B479000010675
For a disk archive volume: VOLxxxxxx
Application names must reflect the name the application
itself is going to use when communicating with MS.
Check the application documentation to find this value.
delete Subcommand
The delete subcommand deletes the entry for the specified
resource from the MS configuration. Use caution when remov-
ing media pools, as this might result in data loss. If the
resource to be deleted is determined to be in use, the
operation will be rejected unless the -f option is speci-
fied.
Deleting a library involves deleting all associated drives,
and removing volumes managed by this library from media
pools. Deleting a library is prohibited if any of its
SunOS 5.11 Last change: 27 Jan 2009 13
System Administration Commands mmsadm(1M)
associated drives is actively in use, or any of its volumes
have been used by an application.
Deleting a drive is prohibited if it is actively in use.
Deleting a drive pool is prohibited if any of its drives is
being used by an application.
Deleting a media pool is prohibited if any of its volumes is
being used by an application.
Deleting an application will cause all volumes that have
been used by that application to be recycled and made avail-
able for reuse. Ensure that all required data has been
copied from these volumes before deleting the application.
Deleting a voltype is prohibited if any volumes are assigned
that type. The -f option cannot be used to force this opera-
tion.
The delete subcommand requires the solaris.smf.value.mms and
solaris.mms.* authorizations.
This subcommand has the following syntax:
mmsadm delete -t librarydrivempooldpoolappvoltype
[-f] name
The subcommand has the following options:
-f
Forces the removal of the specified resource, subject to
the restrictions outlined above.
-t librarydrivempooldpoolappvoltype
Specifies the type of resource being deleted.
SunOS 5.11 Last change: 27 Jan 2009 14
System Administration Commands mmsadm(1M)
The subcommand has the following operand:
name
Identifies the resource as reported by the list subcom-
mand.
list Subcommand
The list subcommand displays all of the storage resources or
messages that meet the criteria specified in the options,
filter, and name parameters. This subcommand is available to
any user.
This subcommand has the following syntax:
mmsadm list [-vH] -t librarydrivempooldpoolappvoltype
-o option[,-o option2,...] [-F filter [-F filter2...] [name]
The list subcommand has all of the options that are sup-
ported by the create and set subcommands. See the section on
these subcommands for descriptions of those options. In
addition to these options, list has the options and operand
listed below.
-v
Verbose.
-H
Displays the information in a manner parseable by
scripts. The display does not include headers and it
separates fields with a tab character.
-t type
One of:
o app
o drive
o library
o mpool
SunOS 5.11 Last change: 27 Jan 2009 15
System Administration Commands mmsadm(1M)
o dpool
o voltype
-o option[,-o option2,...]
Specifies which properties of a resource are displayed.
For example, to list only drive names and their respec-
tive states, enter:
% mmsadm list -t drive -o name,state
-F filter [-F filter2...]
Restricts the listed items to those with specified
filter. Filter names are the same as option names, and
results are restricted to those resources that match the
option value. For example, to show all drives of type
LTO4, enter:
# mmsadm list -t drive -F hwtype=LTO4
Each resource type has its own options. All options are
listed below. Most options are in common with the create
subcommand; see the section on that subcommand for
descriptions of these common options. Those options that
are supported only by the list subcommand have their
descriptions below.
Library Options
Options in common with set:
o acs
o acsls
o hwtype
o lsm
o msg-level
o serialno
o trace-file-size
SunOS 5.11 Last change: 27 Jan 2009 16
System Administration Commands mmsadm(1M)
o trace-level
The following library options are unique to list.
create-time
The date and time when the library was added to the
MS.
state
The current state of the library, one of ready, off-
line, or broken.
Drive Options
Options in common with set:
o apps
o connection
o hwtype
o library
o msg-level
o reserve
o serialno
o trace-file-size
o trace-level
o unload-time
The following drive options are unique to list.
create-time
The date and time when the drive was added to the
MS.
device-name
The Unix device name of the drive, if available.
last-mount
SunOS 5.11 Last change: 27 Jan 2009 17
System Administration Commands mmsadm(1M)
The date and time when the drive was last mounted.
state
The current state of the drive, one of ready, off-
line, or broken.
total-mount-time
The total amount of time the drive has had tapes
mounted.
volume
The volume name of the volume loaded in the drive,
if any.
Media Pool Options
There is one option in common with create, apps.
The following media pool options are unique to list.
create-time
The date and time the media pool was created.
free
The total amount of free space remaining on volumes
in the media pool.
size
The total capacity of the media pool.
used
The total amount of data on volumes in the media
pool.
Application Options
All of the application options are in common with
create. These options are as follows:
SunOS 5.11 Last change: 27 Jan 2009 18
System Administration Commands mmsadm(1M)
o overwrite-existing
o retain
o validate-expiration
o validate-filename
o validate-volid
System Options
Options in common with set:
o acsls-install-dir
o attended
o disk-timeout
o host
o log-file
o log-level
o port
o num-restarts
o num-sockets
There is one system option unique to list.
active-sessions
Brief listing of active sessions.
Volume Options
All of the volume options are unique to list.
apps
Lists the application that has stored data on this
volume.
create-time
Date and time this volume was added to the MS.
SunOS 5.11 Last change: 27 Jan 2009 19
System Administration Commands mmsadm(1M)
free
Amount of free space on the volume.
last-mounted
Date and time this volume was last mounted.
library
Lists the library controlling this volume.
mpool
Media pool, of which this volume is a member.
num-mounts
Number of times this volume has been mounted.
size
Size of the volume.
total-mount-time
Total amount of time this volume has been mounted.
used
Amount of data written to the volume.
voltype
Lists the volume type as was specified when the
volume was added to a media pool.
Volume Type Options
Both of the volume type options are unique to list.
mtype
MS media type associated with this voltype.
SunOS 5.11 Last change: 27 Jan 2009 20
System Administration Commands mmsadm(1M)
size
Default size, in megabytes, for volumes of this
type.
The passwd Subcommand
The passwd subcommand changes the password for the MS
administrator, MS Database administrator, or for MS appli-
cations. If the -P option is not specified, the user will be
prompted to enter the password.
The passwd subcommand has the following syntax.
mmsadm passwd [-P passwdfile] name
This subcommand requires the solaris.smf.value.mms and
solaris.mms.* authorizations.
The passwd subcommand has the following option.
-P passwdfile
Path to a temporary file containing the password.
The passwd subcommand has the following operand.
name
Use admin to change the MS administrative password. Use
dbadmin to change the MS database administrative pass-
word. Use the application name to change the password
for any other application.
The online and offline Subcommands
The online and offline subcommands control whether the
specified library or drive is available to clients. If a
library is set to offline, all drives and volumes managed by
that library are unavailable. If a drive is set to offline,
no volume can be mounted or accessed on that drive.
SunOS 5.11 Last change: 27 Jan 2009 21
System Administration Commands mmsadm(1M)
The syntax for the online and offline subcommands is as fol-
lows:
mmsadm online -t library drive name
mmsadm offline -t library drive name
The online and offline subcommands require the
solaris.smf.read.mms and solaris.mms.device.state.* authori-
zations.
The online and offline subcommands have the following
option.
-t library drive
Specifies the type of resource to make unavailable or to
restore.
drive
Tape or disk archiving drive.
library
Tape library.
The online and offline subcommands have the following
operand.
name
Name of the library or drive, as reported by the list
subcommand
The label Subcommand
The label subcommand labels specified volumes. The subcom-
mand has the following syntax:
mmsadm label [-n] -l library -A application [-P file]
volume[,volume,...]
SunOS 5.11 Last change: 27 Jan 2009 22
System Administration Commands mmsadm(1M)
The label subcommand requires the solaris.smf.read.mms and
solaris.mms.media.* authorizations.
The label subcommand has the following options.
-l library
Name of the library holding the volume.
-n
Do not mount the volume. If this is not specified, the
specified volume will be mounted and header labels will
be written.
-A application
Name of the application to which this volume will be
assigned after labeling.
-P file
Path to a file containing the application password. If a
file name is not provided, the user is prompted for the
password.
The label subcommand has the following operand.
volume[,volume,...]
Volume(s) to be labeled.
The add-volume Subcommand
The add-volume subcommand adds new volumes to the specified
media pool. The subcommand has the following syntax:
mmsadm add-volume -l libraryname -o voltype=type
-x vol1[,vol2,...] mpool
The add-volume subcommand requires the solaris.smf.read.mms
and solaris.mms.media.* authorizations.
SunOS 5.11 Last change: 27 Jan 2009 23
System Administration Commands mmsadm(1M)
The add-volume subcommand has the following options.
-l libraryname
Name of the library from which volumes are selected.
-o voltype=type
Volumes to be added will be assigned the voltype speci-
fied here. To add volumes of different types to the same
media pool, use the mmsadm add-volume command multiple
times, specifying a different voltype each time.
-x vol1[,vol2,...]
A comma-separated list of unused volumes in the speci-
fied library.
The add-volume subcommand has the following operand.
mpool
Name of the media pool as reported by the list subcom-
mand.
The remove-volume Subcommand
The remove-volume subcommand removes volumes from the speci-
fied media pools. If a volume is being used by an applica-
tion, the force option, -f, is required. If the option is
not included in the command, the request is rejected. This
subcommand prompts for confirmation unless -f is provided.
The subcommand has the following syntax:
mmsadm remove-volume -f -x [-l library] vol1[,vol2,...] mpool
The remove-volume subcommand requires the
solaris.smf.read.mms and solaris.mms.media.* authorizations.
The remove-volume subcommand has the following options.
-f
Forces the removal of the specified volume(s), even if
SunOS 5.11 Last change: 27 Jan 2009 24
System Administration Commands mmsadm(1M)
they are in use by an application.
-l libraryname
Name of the library from which volumes are removed.
-x vol1[,vol2,...]
A comma-separated list of volumes.
The remove-volume subcommand has the following operand.
mpool
Name of the media pool as reported by the list subcom-
mand.
The showreq Subcommand
The showreq subcommand lists any pending operator requests,
each with a request identifier. The subcommand has the fol-
lowing syntax:
mmsadm showreq [-H] [drivename]
The showreq subcommand does not require any authorizations.
The showreq subcommand has the following option.
-H
Displays the requests in a manner parseable by scripts.
The display does not include headers; fields are
separated with a tab character.
The showreq subcommand has the following operand.
drivename
Displays the requests only for the specified drive.
SunOS 5.11 Last change: 27 Jan 2009 25
System Administration Commands mmsadm(1M)
The accept Subcommand
The accept subcommand accepts the operator request so that
the MS can proceed with the operation. The subcommand has
the following syntax.
mmsadm accept [-r "response text"] requestid
The accept subcommand requires the solaris.mms.request.* and
solaris.smf.read.mms authorizations.
The accept subcommand has the following option.
-r "response text"
Displays the text that explains the reason for the
action.
The accept subcommand has the following operand.
requestid
The identifier of the operator request, as displayed by
the mmsadm showreq command.
The reject Subcommand
The reject subcommand rejects the operator request. The sub-
command has the following syntax.
mmsadm reject [-r "response text"] requestid
The reject subcommand requires the solaris.mms.request.* and
solaris.smf.read.mms authorizations.
The reject subcommand has the following option.
-r "response text"
Displays the text that explains the reason for the
action.
SunOS 5.11 Last change: 27 Jan 2009 26
System Administration Commands mmsadm(1M)
The reject subcommand has the following operand.
requestid
The identifier of the operator request, as displayed by
the mmsadm showreq command.
The dbbackup Subcommand
The dbbackup subcommand creates a backup file containing the
contents of the MS database. This file can be used to
restore the MS database in the case of accidental removal,
corruption, or other destructive event. It is strongly sug-
gested this backup file be created on a regular basis, and
backed up as part of the system backups. The subcommand has
the following syntax.
mmsadm dbbackup directory
The dbbackup subcommand requires the solaris.smf.manage.mms,
solaris.smf.value.mms, and solaris.mms.* authorizations.
The dbbackup subcommand has the following operand.
directory
Specifies the location where the database backup files
will be stored.
The dbrestore Subcommand
The dbrestore subcommand restores the MS database from the
specified file. The database is restored to the state it was
in at the time the file was created by the mmsadm dbbackup
command. The subcommand has the following syntax
mmsadm dbrestore filename
The dbrestore subcommand requires the solaris.smf.manage.mms
and solaris.smf.value.mms authorizations.
The dbrestore subcommand has the following operand.
SunOS 5.11 Last change: 27 Jan 2009 27
System Administration Commands mmsadm(1M)
filename
Specifies the complete pathname to the file containing
the backup of the MS database.
The mount Subcommand
The mount subcommand mounts a specified volume. The subcom-
mand has the following syntax.
mmsadm mount [-n] [-N] [-d drive] [-D density]
-A application -l library [-P file] [-u username]
[-b blocksize] [-R] [-M mode[,mode...] volume
The mount subcommand requires the
solaris.mms.io.[readwrite*] authorization.
The mount subcommand has the following options.
-A application
Application name to be used when authenticating with the
M server. The name is the identifer used by the appli-
cation itself, according to its API documentation.
-b blocksize
Specifies the largest block that the application can
write to the tape drive for both variable and fixed
blocks. Default is 262144. The maximum size depends on
the drive type:
9940 and 9840
1 - 262144. If you specify fixed for the -M option
(described below), must be an even number.
LTO (all models)
1 - 16777215. If you specify fixed for the -M option
(described below).
The choice of variable or fixed block is specified in
the argument to the -M (mode) option. If you specify
fixed, then -b is the block size because you can only
read and write blocks in the block size you specified.
SunOS 5.11 Last change: 27 Jan 2009 28
System Administration Commands mmsadm(1M)
-d drive
Drive on which to mount a volume. If this option is not
specified, the M server selects a drive based on avai-
lability and capability.
-D density
Specifies the output density. Can be one of:
o high
o medium
o low
o compressed
o den9840
o denT9840C
o denT9940A
o denT9940B
-l libraryname
Library containing the volume to be mounted.
-M mode[,mode...]
The mode argument can be one or more of creat, old,
stnobsd, sttm, raw, mms, compression, nocompression,
variable, block.
-n
Specifies norewind.
-N
Specifies nowait.
-P file
SunOS 5.11 Last change: 27 Jan 2009 29
System Administration Commands mmsadm(1M)
Path to a file containing the application password. If a
file name is not provided, the user is prompted for the
password.
-R
Specifies a read-only mount. The default is read/write.
-u username
Specifies the user who will own the pseudodevice created
by mount.
The mount subcommand has the following operand.
volume
Volume to be mounted.
The unmount Subcommand
The unmount subcommand unmounts the specified volume or MS
pseudodevice. The subcommand has the following syntax.
mmsadm unmount [-f] [-l libraryname] [-A application]
[-P file] volumepseudodevice
The unmount subcommand requires the
solaris.mms.io.[readwrite*] authorization.
The unmount subcommand has the following options.
-A application
Application name to be used when authenticating with the
M server.
-f
Forces an unmount operation of this volume even if it is
in use by another user.
SunOS 5.11 Last change: 27 Jan 2009 30
System Administration Commands mmsadm(1M)
-l libraryname
Library containing the mounted volume. Required only if
using the volume name operand.
-P file
Path to a temporary file containing the application
password.
The unmount subcommand has one of the following operands.
pseudodevice
Device path as returned from the mmsadm mount command.
If this form of unmount is used, the library need not be
specified.
volume
Volume to be unmounted.
EXAMPLES
Example 1 Displaying Available Libraries
To display all libraries available to be managed by the MS,
enter:
# mmsadm discover -t library -S my-acsls-server
Example 2 Creating a Library
To create a library in the MS, enter:
# mmsadm create -t library -o acsls=my-acsls-server -o acs=0 \
-o lsm=1 -o hwtype=L180 -o serialno=7493476 LIBL1807493476
Example 3 Creating a Drive
SunOS 5.11 Last change: 27 Jan 2009 31
System Administration Commands mmsadm(1M)
To create a drive in the MS, enter:
# mmsadm create -t drive -o library=LIBL1807493476 \
-o hwtype=LTO2 -o serialno=6453805873 \
-o connection=myhost DRVLTO26453805873
Example 4 Making Library Available
To make a library available for use, enter:
# mmsadm online LIBL1807493476
Example 5 Registering an Application
To register an application, enter:
# mmsadm create -t app -P /var/tmp/apppasswd MyBackupApp
Example 6 Allowing an Application to Use a Drive
To allow the MyBackupApp application to use a drive, enter:
# mmsadm set -t drive -o apps=MyBackupApp DRVLTO26453805873
Example 7 Listing Volumes in a Library
To show volumes in library L70099987004 of type LT03,
enter:
# mmsadm list -t vol -o library=L70099987004 -F mtype=LTO3
Example 8 Listing Unconfigured Volumes
SunOS 5.11 Last change: 27 Jan 2009 32
System Administration Commands mmsadm(1M)
To show volumes not yet configured for the MS, enter:
# mmsadm discover -t vol -S myacslsserver
Example 9 Configure an MS for Three Applications
The following sequence of commands illustrates the process
of configuring a Media Management System for three applica-
tions, engineering, finance, and backup.
Initialize the M server and set the administrator password
to mmsadm2008 in the password file, mmsadmpasswd:
# mmsinit -P ~/mmsadmpasswd
Create an application for the engineering application:
# mmsadm create -t app -P ~/engpasswd eng
Create an application for the finance application:
# mmsadm create -t app -P ~/financepasswd finance
Create an application for the backup application:
# mmsadm create -t app -P ~/backuppasswd backup
Create an L700 library named library1:
SunOS 5.11 Last change: 27 Jan 2009 33
System Administration Commands mmsadm(1M)
# mmsadm create -t library -o acsls=mms-280-1 -o hwtype=L700 \
-o acs=0 -o lsm=0 -o serialno=MPC02201638 library1
Create a drive pool named orgdpool, to be shared between
the engineering and finance applications:
# mmsadm create -t dpool -o apps=eng,finance orgdpool
Create a drive pool named shareddpool, to be shared by the
engineering, finance, and backup applications:
# mmsadm create -t dpool -o apps=eng,finance,backup shareddpool
Create an exclusive drive pool for the backup application
named bkdpool:
# mmsadm create -t dpool -o apps=backup bkdpool
Add a 9940 drive named drive1 shared by the engineering and
finance applications:
# mmsadm create -t drive -o hwtype=9940 -o serialno=479000002009 \
-o library=library1 -o dpool=orgdpool drive1
Add a 9940 drive named drive2 shared by the engineering,
finance, and backup applications:
# mmsadm create -t drive -o hwtype=9940 -o serialno=479000001954 \
-o library=library1 -o dpool=shareddpool drive2
SunOS 5.11 Last change: 27 Jan 2009 34
System Administration Commands mmsadm(1M)
Add an exclusive 9940 drive named drive3 for the backup
application:
# mmsadm create -t drive -o hwtype=9940 -o serialno=479000001944 \
-o library=library1 -o dpool=bkdpool drive3
Create media pool for the engineering and finance applica-
tions named orgmpool:
# mmsadm create -t mpool -o apps=eng,finance orgmpool
Create an exclusive media pool for the backup application
named bkmpool:
# mmsadm create -t mpool -o apps=backup bkmpool
Add three volumes to the engineering and finance media pool:
# mmsadm add-volume -l library1 -o voltype=9940 \
-x 000220,000221,000222 orgmpool
Add two volumes to the backup media pool:
# mmsadm add-volume -l library1 -o voltype=9940 \
-x 000230,000231 bkmpool
Write a volume label on the volume. The volume becomes owned
by the engineering application. The finance or backup appli-
cations are, as a result, not able to use the volume:
# mmsadm label -P ~/engpasswd -l library1 -A eng 000220
SunOS 5.11 Last change: 27 Jan 2009 35
System Administration Commands mmsadm(1M)
Verify that the engineering application owns the volume:
# mmsadm label -P ~/financepasswd -l library1 -A finance 000220
Write a volume label for the finance application:
# mmsadm label -P ~/financepasswd -l library1 -A finance 000221
Write a volume label for the backup application:
# mmsadm label -P ~/backuppasswd -l library1 -A backup 000230
Mount media for the engineering, finance and backup applica-
tions. The handle returned by the mount command will be used
as a normal /dev/rmt entry:
# mmsadm mount -P ~/engpasswd -l library1 -A eng 000220
# mmsadm mount -P ~/financepasswd -l library1 -A finance 000221
# mmsadm mount -P ~/backuppasswd -l library1 -A backup 000230
Unmount the media and unload the drives:
# mmsadm unmount -P ~/engpasswd -U -l library1 -A eng 000220
# mmsadm unmount -P ~/financepasswd -U -l library1 -A finance 000221
# mmsadm unmount -P ~/backuppasswd -U -l library1 -A backup 000230
Example 10 Configure an MS for Disk Archiving
The following sequence of commands configures a Media
Management System for disk archiving.
SunOS 5.11 Last change: 27 Jan 2009 36
System Administration Commands mmsadm(1M)
Create a test application:
# mmsadm create -t app -P ~/testpasswd test
Create a disk archiving library named dklib1:
# mmsadm create -t library -o hwtype=DISK -o dkpath=/dskpool dklib1
Create a disk archiving media pool named dkcarts:
# mmsadm create -t mpool -o apps=test dkcarts
Create three 100 GB volumes for disk archiving and place the
volumes in the media pool:
# mmsadm add-volume -l dklib1 -o voltype=DISK -x 000000,000001,000002 \
-o size=100g dkcarts
Create a disk archiving drive pool named dkdrives:
# mmsadm create -t dpool -o apps=test dkdrives
Create a disk archiving drive and place it in the drive
pool:
# mmsadm create -t drive -o hwtype=DISK -o library=dklib1 \
-o dpool=dkdrives dkdrive1
SunOS 5.11 Last change: 27 Jan 2009 37
System Administration Commands mmsadm(1M)
Create volume labels. The volume will be labeled when it is
mounted:
# mmsadm label -P ~/testpasswd -n -l dklib1 -A test 000000
# mmsadm label -P ~/testpasswd -n -l dklib1 -A test 000001
# mmsadm label -P ~/testpasswd -n -l dklib1 -A test 000002
Mount the volume 000000. Use the returned tape handle in a
subsequent tar command:
# mmsadm mount -P ~/testpasswd -n -l dklib1 -A test 000000
Show the file sizes of the disk archiving volume before
creating tar archive:
% ls -la /dskpool/dklib1/000000
Create a disk archiving tar archive:
# tar -cvf /var > /tmp/out$$ 2>&1
Show the file sizes of the disk archiving volume after
creating the tar archive:
% ls -la /dskpool/dklib1/000000
Unmount and unload the volume from the drive:
# mmsadm unmount -P ~/testpasswd -U -l dklib1 -A test 000000
SunOS 5.11 Last change: 27 Jan 2009 38
System Administration Commands mmsadm(1M)
EXIT STATUS
0
Command succeeded.
>0
An error occurred.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWmmsu
Interface Stability Committed
SEE ALSO
mmsclient(1M), mmsexplorer(1M), mmsinit(1M), mount(1M),
attributes(5), mms(5), rbac(5)
SunOS 5.11 Last change: 27 Jan 2009 39
|
