1mmsadm(1M) System Administration Commands mmsadm(1M)
2
6 mmsadm - administration command for the Media Management System
7
9 /usr/sbin/mmsadm [-h | -?]
10 mmsadm discover [-H] [-t library|drive|vol] [-S ACSLS-host[:port]] -a
13 mmsadm create -t library|drive|mpool|dpool|app|voltype
16 -o option=x [-o option2=y...] name
17 mmsadm delete -t library|drive|mpool|dpool|app|voltype
20 [-f] name
21 mmsadm set -t library|drive|mpool|dpool|app|voltype
24 -o option=x [-o option2=y...] name
25 mmsadm list [-vH] -t library|drive|mpool|dpool|app|voltype
28 -o option=x [-o option2=y...] [-F filter [-F filter2...] [name]
29 mmsadm passwd [-P file] name
32 mmsadm online -t library|drive name
35 mmsadm offline -t library|drive name
38 mmsadm add-volume -l library -o voltype=type -x vol1[,vol2,...] mpool
41 mmsadm remove-volume -x [-l library] [-x vol1[,vol2,...]] mpool
44 mmsadm label [-n] [-A application] [-l library]
47 [-P file]volume[,volume,...]]
48 mmsadm showreq [-H] [drivename]
51 mmsadm accept [-r "reason"] requestid
54 mmsadm reject [-r "reason"] requestid
57 mmsadm dbbackup directory
60 mmsadm dbrestore file
63 mmsadm mount [-n] [-N] [-d drive] [-D density] -A application -l library
66 [-P passwordfile] [-u username] [-b blocksize] [-R]
67 [-M mode[,mode...] volume
68 mmsadm unmount [-A application] [-P file] [-f] volume|pseudodevice
71
74 The Media Management System (MMS) is a software interface that manages
75 removable storage media such as tape libraries, tape drives, media
76 pools, tape volumes, and disk resources that emulate tape drives and
77 tape volumes. It is an implementation of the IEEE 1244 specification
78 for removable media.
79 The MMS consists of an MM server and database that control various
82 library managers and drive managers. Administrators use mmsadm and its
83 subcommands to configure and maintain storage resources from a variety
84 of vendors. The MMS management commands, such as mmsadm, construct and
85 issue the most frequently-used Media Management Protocol (MMP) com‐
86 mands, handling all events and acknowledgments. The MMP is defined in
87 the IEEE 1244 specification.
88 The mmsinit(1M) command must be run to initialize MMS on a system
91 before you can use the mmsadm command.
92 The mmsadm command is RBAC-compliant. (See rbac(5).) Required autho‐
95 rizations vary among individual subcommands and are listed in the
96 descriptions of those subcommands.
97
99 The mmsadm supports the subcommands listed below. Each subcommand
100 description includes a description of that subcommand's options and op‐
101 erands. A mmsadm command takes the form:
102 # mmsadm subcommand [options]
104 discover Subcommand
108 The discover subcommand displays the library, drives, or volumes on an
109 Automated Control System Library Server (ACSLS) server, or the tape
110 drives connected to the local system. Use this command to determine
111 what resources are available and whether they have been configured for
112 use with MMS.
113 discover requires the solaris.smf.read.mms authorization. The subcom‐
116 mand has the following syntax:
117 mmsadm discover [-H] [-t library|drive|vol]
119 [-S ACSLS-host[:port]] -a
120 The subcommand options are described as follows.
125 -a
127 Displays all discovered resources, including those configured for
129 MMS. By default, only unconfigured resources are displayed.
130 -H
133 Displays the resources in a manner parseable by scripts. The dis‐
135 play does not include headers and it separates fields with a tab
136 character.
137 -S ACSLS-host[:port]
140 Displays resources managed by the specified server and port. The
142 default port number is 50004. If the -S option is not used, the
143 command displays tape drives connected to the local system.
144 -t library|drive|vol
147 Displays only the specified type of resource:
149 -t library
151 Shows discovered libraries.
153 -t drive
156 Shows discovered drives.
158 -t vol
161 Shows discovered volumes.
163 If this option is not used, library and drive resources are
165 included in the display. The number of volumes can be large so
166 their discovery must be requested explicitly.
167 create and set Subcommands
170 The create subcommand configures the resource to be managed by MMS. The
171 set subcommand modifies the attributes of a resource managed by MMS.
172 These subcommands share a common set of options.
173 ACSLS-controlled libraries and disk archiving libraries are supported.
176 Libraries must be configured before any drive pool and drives managed
177 in that library can be configured, or any volumes managed by the
178 library added to media pools. voltype must be configured before adding
179 volumes to media pools.
180 The create and set subcommands require the solaris.smf.modify.mms,
183 solaris.smf.value.mms, solaris.mms.*, and solaris.smf.read.mms autho‐
184 rizations, with the exception of changing tracing attributes. If chang‐
185 ing the size of trace files or trace level, only solaris.mms.device.log
186 and solaris.smf.read.mms authorizations are required.
187 These subcommands have the following syntax:
190 create -t library|drive|mpool|dpool|app|voltype
192 -o option=x [-o option2=y...] name
193 set -t library|drive|mpool|dpool|app|voltype
195 -o option=x [-o option2=y...] name
196 The subcommand options and operand are described as follows.
201 -t type
203 Specifies the type of resource being created or modified. type can
205 be one of:
206 library Tape library
208 drive Tape or disk archiving drive
211 mpool Media pool
214 dpool Drive pool
217 app MMS-aware application
220 voltype An MMS construct to map tape cartridge types (such as
223 LTO3) to a user-defined type. Allows the user to specify
224 a default cartridge size for this type of tape.
225 -o option=x [-o option2=y...]
229 Options are key/value pairs and are specific to the resource type.
231 Library Options:
233 hwtype=type
235 Specify one of the supported library types: L180, L500, L700,
237 SL500, SL8500, or SL3000. This option is required for create
238 operations.
239 For disk archiving libraries, specify DISK.
241 The following are options for real network attached libraries.
243 acs=acs_number
245 Specifies the ACSLS ACS number for the library, as shown by the
247 discover subcommand. Required for create.
248 lsm=lsm_number
251 Specifies the ACSLS LSM number for the library, as shown by the
253 discover subcommand. Required for create.
254 serialno=serial_num
257 Specifies the serial number of the library as reported by the
259 discover subcommand. Required for create.
260 acsls=host[:port]
263 Identifies the host and port number of the ACSLS server con‐
265 trolling the library. If not specified, the default port is
266 50004. Required for create.
267 The following are options for disk archiving libraries.
269 dkpath=path
271 Defines the default path of the DISK library. The path speci‐
273 fies the parent directory of the library and its name must not
274 be the last component of the path.
275 dkaltpath=host1@directory1[,host2@directory2]
278 Defines the path of a DISK library in a host which cannot use
280 the default path to access the DISK library. The path specifies
281 the parent directory of the library and its name must not be
282 the last component of the path.
283 All libraries have the following options.
285 msg-level=emergency|alert|critical|error|warning|notice|
287 information|debug
288 Specifies the level of detail in messages written to the log
290 file. The default level is error.
291 trace-level=emergency|alert|critical|error|warning|
294 notice|information|debug
295 Specifies the level of detail in messages written to the trace
297 file. The default level is error.
298 trace-file-size=size
301 Specifies the maximum size of the trace file before it is
303 rotated and restarted. Specify the size using a value and the
304 character that identifies the unit:
305 o K for kilobytes
307 o M for megabytes
309 o G for gigabytes
311 The default size is 10 megabytes. To set the maximum size of
312 the trace file to 15 megabytes (for example), enter:
313 trace-file-size=15M
315 Drive Options:
319 hwtype=type
321 Specifies the drive type as reported from the discover subcom‐
323 mand. Required for create.
324 serialno=serial
327 Specifies the serial number of the drive as reported from the
329 discover subcommand. Required for create.
330 library=library_name
333 Defines the MMS identifier of the library controlling this
335 drive as reported from the list subcommand. Required for cre‐
336 ate.
337 connection=host,[host]
340 Identifies the host name or IP address to which the drive is
342 physically connected. If the drive is multiported, enter each
343 host separated by a comma. Required for create.
344 apps=app1[,app2,...]
347 Specifies which applications registered with MMS can use this
349 drive. To specify that more than one application can use this
350 drive, enter each application name, separated by commas.
351 msg-level=emergency|alert|critical|error|warning|notice|
354 information|debug
355 Specifies the level of detail in messages written to the log
357 file. The default level is error.
358 trace-level=emergency|alert|critical|error|warning|
361 notice|information|debug
362 Specifies the level of detail in messages written to the trace
364 file. The default level is error.
365 trace-file-size=size
368 Specifies the maximum size of the trace file before it is
370 rotated and restarted. Specify the size using a value and the
371 character that identifies the unit:
372 o K for kilobytes
374 o M for megabytes
376 o G for gigabytes
378 The default size is 10 megabytes. To set the maximum size of
379 the trace file to 15 megabytes (for example), enter:
380 trace-file-size=15M
382 unload-time=num_minutes
387 Specifies the maximum time an unused volume is left in a drive
389 before it is ejected. After an application has finished using a
390 volume, it is often left in the drive. This is to speed up
391 requests if the same volume is needed again in a short amount
392 of time. This option ensures the drive is emptied and available
393 to load other volumes when requested. The default number of
394 minutes is 60.
395 reserve=yes|no
398 Defines whether access to a drive is enforced. Use yes to use
400 SCSI reserve and release commands to enforce access to the
401 drive. Use no to not use SCSI reservations. Use no only if the
402 drive behaves improperly when access is enforced, or if the
403 drive does not support the SCSI reservation commands. The
404 default value is yes.
405 Drive Pool Options
407 Specifies which applications registered with MMS can use this drive
409 pool. To specify that more than one application can use this pool,
410 enter each application name, separated by commas.
411 Media Pool Options
413 apps=app1[,app2,...]
415 Specifies which applications registered with MMS can use this
417 media pool. To specify that more than one application can use
418 this pool, enter each application name, separated by commas.
419 Application Options
421 retain=num_days
423 Specifies the number of days that the volume's data is pre‐
425 served after the expiration date defined by the application for
426 a volume. The default value is 0.
427 validate-expiration=yes|no
430 Specifies whether overwriting unexpired files is allowed. Use
432 no to allow overwriting of unexpired volume files. Use yes to
433 prevent overwriting unexpired volume files. The default value
434 is no.
435 validate-volid=yes|no
438 Specifies whether the volume identifier is verified. Use yes to
440 verify that the volume ID obtained from the mmsadm mount com‐
441 mand matches the volume identifier on the volume label. Use no
442 to specify that this verification is not done. The default
443 value is yes.
444 validate-filename=yes|no
447 Specifies whether the file name is verified. Use yes to verify
449 that the file name obtained from the mmsadm mount command
450 matches the file name on the HDR1 header label of the file. Use
451 no to specify that this verification is not done. The default
452 value is no.
453 overwrite-existing=yes|no|ask
456 This option is only for unlabeled volumes that are not blank.
458 It specifies whether the data on an unlabeled volume can be
459 overwritten. The default is yes to indicate data can be over‐
460 written. Use no to reject any write requests. Use ask to prompt
461 an operator for his wish when a write request is received.
462 System Options
464 log-level=emergency|alert|critical|error|warning|notice|
466 information|debug
467 Specifies the level of detail in messages written to the log
469 file. The default level is error.
470 num-restarts=num
473 Specifies the number of attempts to start a failed daemon
475 before the drive or library associated with the daemon is dis‐
476 abled and requires the mmsadm online command to be run after
477 the problem with the system or device is resolved. Use a value
478 of -1 for unlimited restart attempts. The default value is 3.
479 attended=yes|no
482 Specify whether MMS makes operator requests when an operation
484 cannot be automatically satisfied. An example of such a case
485 would be if a mount request was made for a tape volume that had
486 been physically removed from a library. The default action,
487 yes, indicates that an operator is available to respond. Use no
488 to specify that no operator is available. If no operator is
489 available, all operator requests are rejected.
490 num-sockets=num
493 Specifies the number of open file descriptors the MM daemon can
495 have at one time. On a resource-constrained system, set this
496 value to a number between 30 and 65536. It is not recommended
497 to set the value to less than 256. The default value is -1,
498 meaning an unlimited number of file descriptors.
499 disk-timeout=seconds
502 Specifies the time a disk archiving drive manager waits for the
504 file system containing a disk archiving volume to become avail‐
505 able. It is strongly recommended to set the time to a minimum
506 of 120 seconds (two minutes). Use a value of 0 to specify no
507 expiration time.
508 dkvol Options
510 dirname=path
512 Required by (and only valid for) create. Specifies the direc‐
514 tory in which the new disk archiving volume will created.
515 size=num
518 Valid only for create. Specifies the size, in megabytes, of the
520 disk archiving volume.
521 readonly=true|false
524 Sets the volume to read-only or to allow write operations. The
526 default is false, meaning that the disk archiving volume is
527 writeable.
528 mpool=pool_name
531 Media pool to which this disk archiving volume will be added
533 after it is created. This option is required for create.
534 dkdrive Options
536 apps=app1[,app2,...]
538 Specifies which applications registered with MMS can use this
540 drive. To specify that more than one application can use this
541 drive, enter each application name, separated by commas.
542 msg-level=emergency|alert|critical|error|warning|notice|
545 information|debug
546 Specifies the level of detail in messages written to the log
548 file. The default level is error.
549 trace-level=emergency|alert|critical|error|warning|
552 notice|information|debug
553 Specifies the level of detail in messages written to the trace
555 file. The default level is error.
556 trace-file-size=size
559 Specifies the maximum size of the trace file before it is
561 rotated and restarted. Specify the size using a value and the
562 character that identifies the unit:
563 o K for kilobytes
565 o M for megabytes
567 o G for gigabytes
569 The default size is 10 megabytes. To set the maximum size of
570 the trace file to 15 megabytes (for example), enter:
571 trace-file-size=15M
573 unload-time=num_minutes
578 Specifies the maximum time an unused volume is left in a drive
580 before it is ejected. After an application has finished using a
581 volume, it is often left in the drive. This is to speed up
582 requests if the same volume is needed again in a short amount
583 of time. This option ensures the drive is emptied and available
584 to load other volumes when requested. The default number of
585 minutes is 60.
586 voltype Options
588 mediatype=type
590 One of the supported media types: 9940, 9940_worm, 9840,
592 9840_worm, 9840C_worm, 9840D_worm, LTO1, LTO2, LTO3,
593 LTO3_worm, LTO4, LTO4_worm, SDLT2, and DISK. This option is
594 required for create.
595 size=num
599 The size, in megabytes, of the this volume type. This option is
601 required for create.
602 The create and set subcommands have the following operand.
607 name
609 Specifies the name of the resource being added or modified. With
611 the exception of applications, names are simple text strings, and
612 they must be unique for their resource type. Recommended naming
613 conventions are:
614 For a library: LIB_type_serial
616 Example: LIB_L180_MPC02209500
618 For a drive: DRV_type_serial
620 Example: DRV_T9940B_479000010675
622 For a disk archive volume: VOL_xxxxxx
624 Application names must reflect the name the application itself is
626 going to use when communicating with MMS. Check the application
627 documentation to find this value.
628 delete Subcommand
631 The delete subcommand deletes the entry for the specified resource from
632 the MMS configuration. Use caution when removing media pools, as this
633 might result in data loss. If the resource to be deleted is determined
634 to be in use, the operation will be rejected unless the -f option is
635 specified.
636 Deleting a library involves deleting all associated drives, and remov‐
639 ing volumes managed by this library from media pools. Deleting a
640 library is prohibited if any of its associated drives is actively in
641 use, or any of its volumes have been used by an application.
642 Deleting a drive is prohibited if it is actively in use.
645 Deleting a drive pool is prohibited if any of its drives is being used
648 by an application.
649 Deleting a media pool is prohibited if any of its volumes is being used
652 by an application.
653 Deleting an application will cause all volumes that have been used by
656 that application to be recycled and made available for reuse. Ensure
657 that all required data has been copied from these volumes before delet‐
658 ing the application.
659 Deleting a voltype is prohibited if any volumes are assigned that type.
662 The -f option cannot be used to force this operation.
663 The delete subcommand requires the solaris.smf.value.mms and
666 solaris.mms.* authorizations.
667 This subcommand has the following syntax:
670 mmsadm delete -t library|drive|mpool|dpool|app|voltype
672 [-f] name
673 The subcommand has the following options:
678 -f
680 Forces the removal of the specified resource, subject to the
682 restrictions outlined above.
683 -t library|drive|mpool|dpool|app|voltype
686 Specifies the type of resource being deleted.
688 The subcommand has the following operand:
692 name
694 Identifies the resource as reported by the list subcommand.
696 list Subcommand
699 The list subcommand displays all of the storage resources or messages
700 that meet the criteria specified in the options, filter, and name
701 parameters. This subcommand is available to any user.
702 This subcommand has the following syntax:
705 mmsadm list [-vH] -t library|drive|mpool|dpool|app|voltype
707 -o option[,-o option2,...] [-F filter [-F filter2...] [name]
708 The list subcommand has all of the options that are supported by the
713 create and set subcommands. See the section on these subcommands for
714 descriptions of those options. In addition to these options, list has
715 the options and operand listed below.
716 -v
718 Verbose.
720 -H
723 Displays the information in a manner parseable by scripts. The dis‐
725 play does not include headers and it separates fields with a tab
726 character.
727 -t type
730 One of:
732 o app
734 o drive
736 o library
738 o mpool
740 o dpool
742 o voltype
744 -o option[,-o option2,...]
747 Specifies which properties of a resource are displayed. For exam‐
749 ple, to list only drive names and their respective states, enter:
750 % mmsadm list -t drive -o name,state
752 -F filter [-F filter2...]
757 Restricts the listed items to those with specified filter. Filter
759 names are the same as option names, and results are restricted to
760 those resources that match the option value. For example, to show
761 all drives of type LTO4, enter:
762 # mmsadm list -t drive -F hwtype=LTO4
764 Each resource type has its own options. All options are listed
767 below. Most options are in common with the create subcommand; see
768 the section on that subcommand for descriptions of these common
769 options. Those options that are supported only by the list subcom‐
770 mand have their descriptions below.
771 Library Options
773 Options in common with set:
775 o acs
777 o acsls
779 o hwtype
781 o lsm
783 o msg-level
785 o serialno
787 o trace-file-size
789 o trace-level
791 The following library options are unique to list.
792 create-time
794 The date and time when the library was added to the MMS.
796 state
799 The current state of the library, one of ready, offline, or
801 broken.
802 Drive Options
804 Options in common with set:
806 o apps
808 o connection
810 o hwtype
812 o library
814 o msg-level
816 o reserve
818 o serialno
820 o trace-file-size
822 o trace-level
824 o unload-time
826 The following drive options are unique to list.
827 create-time
829 The date and time when the drive was added to the MMS.
831 device-name
834 The Unix device name of the drive, if available.
836 last-mount
839 The date and time when the drive was last mounted.
841 state
844 The current state of the drive, one of ready, offline, or bro‐
846 ken.
847 total-mount-time
850 The total amount of time the drive has had tapes mounted.
852 volume
855 The volume name of the volume loaded in the drive, if any.
857 Media Pool Options
859 There is one option in common with create, apps.
861 The following media pool options are unique to list.
863 create-time
865 The date and time the media pool was created.
867 free
870 The total amount of free space remaining on volumes in the
872 media pool.
873 size
876 The total capacity of the media pool.
878 used
881 The total amount of data on volumes in the media pool.
883 Application Options
885 All of the application options are in common with create. These
887 options are as follows:
888 o overwrite-existing
890 o retain
892 o validate-expiration
894 o validate-filename
896 o validate-volid
898 System Options
899 Options in common with set:
901 o acsls-install-dir
903 o attended
905 o disk-timeout
907 o host
909 o log-file
911 o log-level
913 o port
915 o num-restarts
917 o num-sockets
919 There is one system option unique to list.
920 active-sessions
922 Brief listing of active sessions.
924 Volume Options
926 All of the volume options are unique to list.
928 apps
930 Lists the application that has stored data on this volume.
932 create-time
935 Date and time this volume was added to the MMS.
937 free
940 Amount of free space on the volume.
942 last-mounted
945 Date and time this volume was last mounted.
947 library
950 Lists the library controlling this volume.
952 mpool
955 Media pool, of which this volume is a member.
957 num-mounts
960 Number of times this volume has been mounted.
962 size
965 Size of the volume.
967 total-mount-time
970 Total amount of time this volume has been mounted.
972 used
975 Amount of data written to the volume.
977 voltype
980 Lists the volume type as was specified when the volume was
982 added to a media pool.
983 Volume Type Options
985 Both of the volume type options are unique to list.
987 mtype
989 MMS media type associated with this voltype.
991 size
994 Default size, in megabytes, for volumes of this type.
996 The passwd Subcommand
1000 The passwd subcommand changes the password for the MMS administrator,
1001 MMS Database administrator, or for MMS applications. If the -P option
1002 is not specified, the user will be prompted to enter the password.
1003 The passwd subcommand has the following syntax.
1006 mmsadm passwd [-P passwdfile] name
1008 This subcommand requires the solaris.smf.value.mms and solaris.mms.*
1013 authorizations.
1014 The passwd subcommand has the following option.
1017 -P passwdfile
1019 Path to a temporary file containing the password.
1021 The passwd subcommand has the following operand.
1025 name
1027 Use admin to change the MMS administrative password. Use dbadmin to
1029 change the MMS database administrative password. Use the applica‐
1030 tion name to change the password for any other application.
1031 The online and offline Subcommands
1034 The online and offline subcommands control whether the specified
1035 library or drive is available to clients. If a library is set to off‐
1036 line, all drives and volumes managed by that library are unavailable.
1037 If a drive is set to offline, no volume can be mounted or accessed on
1038 that drive.
1039 The syntax for the online and offline subcommands is as follows:
1042 mmsadm online -t library | drive name
1044 mmsadm offline -t library | drive name
1046 The online and offline subcommands require the solaris.smf.read.mms and
1051 solaris.mms.device.state.* authorizations.
1052 The online and offline subcommands have the following option.
1055 -t library | drive
1057 Specifies the type of resource to make unavailable or to restore.
1059 drive
1061 Tape or disk archiving drive.
1063 library
1066 Tape library.
1068 The online and offline subcommands have the following operand.
1073 name
1075 Name of the library or drive, as reported by the list subcommand
1077 The label Subcommand
1080 The label subcommand labels specified volumes. The subcommand has the
1081 following syntax:
1082 mmsadm label [-n] -l library -A application [-P file]
1084 volume[,volume,...]
1085 The label subcommand requires the solaris.smf.read.mms and
1090 solaris.mms.media.* authorizations.
1091 The label subcommand has the following options.
1094 -l library
1096 Name of the library holding the volume.
1098 -n
1101 Do not mount the volume. If this is not specified, the specified
1103 volume will be mounted and header labels will be written.
1104 -A application
1107 Name of the application to which this volume will be assigned after
1109 labeling.
1110 -P file
1113 Path to a file containing the application password. If a file name
1115 is not provided, the user is prompted for the password.
1116 The label subcommand has the following operand.
1120 volume[,volume,...]
1122 Volume(s) to be labeled.
1124 The add-volume Subcommand
1127 The add-volume subcommand adds new volumes to the specified media pool.
1128 The subcommand has the following syntax:
1129 mmsadm add-volume -l library_name -o voltype=type
1131 -x vol1[,vol2,...] mpool
1132 The add-volume subcommand requires the solaris.smf.read.mms and
1137 solaris.mms.media.* authorizations.
1138 The add-volume subcommand has the following options.
1141 -l library_name
1143 Name of the library from which volumes are selected.
1145 -o voltype=type
1148 Volumes to be added will be assigned the voltype specified here. To
1150 add volumes of different types to the same media pool, use the
1151 mmsadm add-volume command multiple times, specifying a different
1152 voltype each time.
1153 -x vol1[,vol2,...]
1156 A comma-separated list of unused volumes in the specified library.
1158 The add-volume subcommand has the following operand.
1162 mpool
1164 Name of the media pool as reported by the list subcommand.
1166 The remove-volume Subcommand
1169 The remove-volume subcommand removes volumes from the specified media
1170 pools. If a volume is being used by an application, the force option,
1171 -f, is required. If the option is not included in the command, the
1172 request is rejected. This subcommand prompts for confirmation unless -f
1173 is provided. The subcommand has the following syntax:
1174 mmsadm remove-volume -f -x [-l library] vol1[,vol2,...] mpool
1176 The remove-volume subcommand requires the solaris.smf.read.mms and
1181 solaris.mms.media.* authorizations.
1182 The remove-volume subcommand has the following options.
1185 -f
1187 Forces the removal of the specified volume(s), even if they are in
1189 use by an application.
1190 -l library_name
1193 Name of the library from which volumes are removed.
1195 -x vol1[,vol2,...]
1198 A comma-separated list of volumes.
1200 The remove-volume subcommand has the following operand.
1204 mpool
1206 Name of the media pool as reported by the list subcommand.
1208 The showreq Subcommand
1211 The showreq subcommand lists any pending operator requests, each with a
1212 request identifier. The subcommand has the following syntax:
1213 mmsadm showreq [-H] [drivename]
1215 The showreq subcommand does not require any authorizations.
1220 The showreq subcommand has the following option.
1223 -H
1225 Displays the requests in a manner parseable by scripts. The display
1227 does not include headers; fields are separated with a tab charac‐
1228 ter.
1229 The showreq subcommand has the following operand.
1233 drivename
1235 Displays the requests only for the specified drive.
1237 The accept Subcommand
1240 The accept subcommand accepts the operator request so that the MMS can
1241 proceed with the operation. The subcommand has the following syntax.
1242 mmsadm accept [-r "response text"] requestid
1244 The accept subcommand requires the solaris.mms.request.* and
1249 solaris.smf.read.mms authorizations.
1250 The accept subcommand has the following option.
1253 -r "response text"
1255 Displays the text that explains the reason for the action.
1257 The accept subcommand has the following operand.
1261 requestid
1263 The identifier of the operator request, as displayed by the mmsadm
1265 showreq command.
1266 The reject Subcommand
1269 The reject subcommand rejects the operator request. The subcommand has
1270 the following syntax.
1271 mmsadm reject [-r "response text"] requestid
1273 The reject subcommand requires the solaris.mms.request.* and
1278 solaris.smf.read.mms authorizations.
1279 The reject subcommand has the following option.
1282 -r "response text"
1284 Displays the text that explains the reason for the action.
1286 The reject subcommand has the following operand.
1290 requestid
1292 The identifier of the operator request, as displayed by the mmsadm
1294 showreq command.
1295 The dbbackup Subcommand
1298 The dbbackup subcommand creates a backup file containing the contents
1299 of the MMS database. This file can be used to restore the MMS database
1300 in the case of accidental removal, corruption, or other destructive
1301 event. It is strongly suggested this backup file be created on a regu‐
1302 lar basis, and backed up as part of the system backups. The subcommand
1303 has the following syntax.
1304 mmsadm dbbackup directory
1306 The dbbackup subcommand requires the solaris.smf.manage.mms,
1311 solaris.smf.value.mms, and solaris.mms.* authorizations.
1312 The dbbackup subcommand has the following operand.
1315 directory
1317 Specifies the location where the database backup files will be
1319 stored.
1320 The dbrestore Subcommand
1323 The dbrestore subcommand restores the MMS database from the specified
1324 file. The database is restored to the state it was in at the time the
1325 file was created by the mmsadm dbbackup command. The subcommand has the
1326 following syntax
1327 mmsadm dbrestore filename
1329 The dbrestore subcommand requires the solaris.smf.manage.mms and
1334 solaris.smf.value.mms authorizations.
1335 The dbrestore subcommand has the following operand.
1338 filename
1340 Specifies the complete pathname to the file containing the backup
1342 of the MMS database.
1343 The mount Subcommand
1346 The mount subcommand mounts a specified volume. The subcommand has the
1347 following syntax.
1348 mmsadm mount [-n] [-N] [-d drive] [-D density]
1350 -A application -l library [-P file] [-u username]
1351 [-b blocksize] [-R] [-M mode[,mode...] volume
1352 The mount subcommand requires the solaris.mms.io.[read|write|*] autho‐
1357 rization.
1358 The mount subcommand has the following options.
1361 -A application
1363 Application name to be used when authenticating with the MM server.
1365 The name is the identifer used by the application itself, according
1366 to its API documentation.
1367 -b blocksize
1370 Specifies the largest block that the application can write to the
1372 tape drive for both variable and fixed blocks. Default is 262144.
1373 The maximum size depends on the drive type:
1374 9940 and 9840
1376 1 - 262144. If you specify fixed for the -M option (described
1378 below), must be an even number.
1379 LTO (all models)
1382 1 - 16777215. If you specify fixed for the -M option (described
1384 below).
1385 The choice of variable or fixed block is specified in the argument
1387 to the -M (mode) option. If you specify fixed, then -b is the block
1388 size because you can only read and write blocks in the block size
1389 you specified.
1390 -d drive
1393 Drive on which to mount a volume. If this option is not specified,
1395 the MM server selects a drive based on availability and capability.
1396 -D density
1399 Specifies the output density. Can be one of:
1401 o high
1403 o medium
1405 o low
1407 o compressed
1409 o den_9840
1411 o den_T9840C
1413 o den_T9940A
1415 o den_T9940B
1417 -l library_name
1420 Library containing the volume to be mounted.
1422 -M mode[,mode...]
1425 The mode argument can be one or more of creat, old, st_nobsd,
1427 st_tm, raw, mms, compression, nocompression, variable, block.
1428 -n
1431 Specifies norewind.
1433 -N
1436 Specifies nowait.
1438 -P file
1441 Path to a file containing the application password. If a file name
1443 is not provided, the user is prompted for the password.
1444 -R
1447 Specifies a read-only mount. The default is read/write.
1449 -u username
1452 Specifies the user who will own the pseudodevice created by mount.
1454 The mount subcommand has the following operand.
1458 volume
1460 Volume to be mounted.
1462 The unmount Subcommand
1465 The unmount subcommand unmounts the specified volume or MMS pseudode‐
1466 vice. The subcommand has the following syntax.
1467 mmsadm unmount [-f] [-l library_name] [-A application]
1469 [-P file] volume|pseudodevice
1470 The unmount subcommand requires the solaris.mms.io.[read|write|*]
1475 authorization.
1476 The unmount subcommand has the following options.
1479 -A application
1481 Application name to be used when authenticating with the MM server.
1483 -f
1486 Forces an unmount operation of this volume even if it is in use by
1488 another user.
1489 -l library_name
1492 Library containing the mounted volume. Required only if using the
1494 volume name operand.
1495 -P file
1498 Path to a temporary file containing the application password.
1500 The unmount subcommand has one of the following operands.
1504 pseudodevice
1506 Device path as returned from the mmsadm mount command. If this form
1508 of unmount is used, the library need not be specified.
1509 volume
1512 Volume to be unmounted.
1514
1517 Example 1 Displaying Available Libraries
1518 To display all libraries available to be managed by the MMS, enter:
1521 # mmsadm discover -t library -S my-acsls-server
1524 Example 2 Creating a Library
1528 To create a library in the MMS, enter:
1531 # mmsadm create -t library -o acsls=my-acsls-server -o acs=0 \
1534 -o lsm=1 -o hwtype=L180 -o serialno=7493476 LIB_L180_7493476
1535 Example 3 Creating a Drive
1539 To create a drive in the MMS, enter:
1542 # mmsadm create -t drive -o library=LIB_L180_7493476 \
1545 -o hwtype=LTO2 -o serialno=6453805873 \
1546 -o connection=myhost DRV_LTO2_6453805873
1547 Example 4 Making Library Available
1551 To make a library available for use, enter:
1554 # mmsadm online LIB_L180_7493476
1557 Example 5 Registering an Application
1561 To register an application, enter:
1564 # mmsadm create -t app -P /var/tmp/app_passwd MyBackupApp
1567 Example 6 Allowing an Application to Use a Drive
1571 To allow the MyBackupApp application to use a drive, enter:
1574 # mmsadm set -t drive -o apps=MyBackupApp DRV_LTO2_6453805873
1577 Example 7 Listing Volumes in a Library
1581 To show volumes in library L700_99987004 of type LT03, enter:
1584 # mmsadm list -t vol -o library=L700_99987004 -F mtype=LTO3
1587 Example 8 Listing Unconfigured Volumes
1591 To show volumes not yet configured for the MMS, enter:
1594 # mmsadm discover -t vol -S my_acsls_server
1597 Example 9 Configure an MMS for Three Applications
1601 The following sequence of commands illustrates the process of configur‐
1604 ing a Media Management System for three applications, engineering,
1605 finance, and backup.
1606 Initialize the MM server and set the administrator password to
1610 mmsadm2008 in the password file, mmsadm_passwd:
1611 # mmsinit -P ~/mmsadm_passwd
1614 Create an application for the engineering application:
1619 # mmsadm create -t app -P ~/eng_passwd eng
1622 Create an application for the finance application:
1627 # mmsadm create -t app -P ~/finance_passwd finance
1630 Create an application for the backup application:
1635 # mmsadm create -t app -P ~/backup_passwd backup
1638 Create an L700 library named library1:
1643 # mmsadm create -t library -o acsls=mms-280-1 -o hwtype=L700 \
1646 -o acs=0 -o lsm=0 -o serialno=MPC02201638 library1
1647 Create a drive pool named org_dpool, to be shared between the engineer‐
1652 ing and finance applications:
1653 # mmsadm create -t dpool -o apps=eng,finance org_dpool
1656 Create a drive pool named shared_dpool, to be shared by the engineer‐
1661 ing, finance, and backup applications:
1662 # mmsadm create -t dpool -o apps=eng,finance,backup shared_dpool
1665 Create an exclusive drive pool for the backup application named
1670 bk_dpool:
1671 # mmsadm create -t dpool -o apps=backup bk_dpool
1674 Add a 9940 drive named drive1 shared by the engineering and finance
1679 applications:
1680 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000002009 \
1683 -o library=library1 -o dpool=org_dpool drive1
1684 Add a 9940 drive named drive2 shared by the engineering, finance, and
1689 backup applications:
1690 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000001954 \
1693 -o library=library1 -o dpool=shared_dpool drive2
1694 Add an exclusive 9940 drive named drive3 for the backup application:
1699 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000001944 \
1702 -o library=library1 -o dpool=bk_dpool drive3
1703 Create media pool for the engineering and finance applications named
1708 org_mpool:
1709 # mmsadm create -t mpool -o apps=eng,finance org_mpool
1712 Create an exclusive media pool for the backup application named
1717 bk_mpool:
1718 # mmsadm create -t mpool -o apps=backup bk_mpool
1721 Add three volumes to the engineering and finance media pool:
1726 # mmsadm add-volume -l library1 -o voltype=9940 \
1729 -x 000220,000221,000222 org_mpool
1730 Add two volumes to the backup media pool:
1735 # mmsadm add-volume -l library1 -o voltype=9940 \
1738 -x 000230,000231 bk_mpool
1739 Write a volume label on the volume. The volume becomes owned by the
1744 engineering application. The finance or backup applications are, as a
1745 result, not able to use the volume:
1746 # mmsadm label -P ~/eng_passwd -l library1 -A eng 000220
1749 Verify that the engineering application owns the volume:
1754 # mmsadm label -P ~/finance_passwd -l library1 -A finance 000220
1757 Write a volume label for the finance application:
1762 # mmsadm label -P ~/finance_passwd -l library1 -A finance 000221
1765 Write a volume label for the backup application:
1770 # mmsadm label -P ~/backup_passwd -l library1 -A backup 000230
1773 Mount media for the engineering, finance and backup applications. The
1778 handle returned by the mount command will be used as a normal /dev/rmt
1779 entry:
1780 # mmsadm mount -P ~/eng_passwd -l library1 -A eng 000220
1783 # mmsadm mount -P ~/finance_passwd -l library1 -A finance 000221
1784 # mmsadm mount -P ~/backup_passwd -l library1 -A backup 000230
1785 Unmount the media and unload the drives:
1790 # mmsadm unmount -P ~/eng_passwd -U -l library1 -A eng 000220
1793 # mmsadm unmount -P ~/finance_passwd -U -l library1 -A finance 000221
1794 # mmsadm unmount -P ~/backup_passwd -U -l library1 -A backup 000230
1795 Example 10 Configure an MMS for Disk Archiving
1799 The following sequence of commands configures a Media Management System
1802 for disk archiving.
1803 Create a test application:
1807 # mmsadm create -t app -P ~/test_passwd test
1810 Create a disk archiving library named dklib1:
1815 # mmsadm create -t library -o hwtype=DISK -o dkpath=/dskpool dklib1
1818 Create a disk archiving media pool named dkcarts:
1823 # mmsadm create -t mpool -o apps=test dkcarts
1826 Create three 100 GB volumes for disk archiving and place the volumes in
1831 the media pool:
1832 # mmsadm add-volume -l dklib1 -o voltype=DISK -x 000000,000001,000002 \
1835 -o size=100g dkcarts
1836 Create a disk archiving drive pool named dkdrives:
1841 # mmsadm create -t dpool -o apps=test dkdrives
1844 Create a disk archiving drive and place it in the drive pool:
1849 # mmsadm create -t drive -o hwtype=DISK -o library=dklib1 \
1852 -o dpool=dkdrives dkdrive1
1853 Create volume labels. The volume will be labeled when it is mounted:
1858 # mmsadm label -P ~/test_passwd -n -l dklib1 -A test 000000
1861 # mmsadm label -P ~/test_passwd -n -l dklib1 -A test 000001
1862 # mmsadm label -P ~/test_passwd -n -l dklib1 -A test 000002
1863 Mount the volume 000000. Use the returned tape handle in a subsequent
1868 tar command:
1869 # mmsadm mount -P ~/test_passwd -n -l dklib1 -A test 000000
1872 Show the file sizes of the disk archiving volume before creating tar
1877 archive:
1878 % ls -la /dskpool/dklib1/000000
1881 Create a disk archiving tar archive:
1886 # tar -cvf <mms_handle> /var > /tmp/out$$ 2>&1
1889 Show the file sizes of the disk archiving volume after creating the tar
1894 archive:
1895 % ls -la /dskpool/dklib1/000000
1898 Unmount and unload the volume from the drive:
1903 # mmsadm unmount -P ~/test_passwd -U -l dklib1 -A test 000000
1906
1910 0
1911 Command succeeded.
1913 >0
1916 An error occurred.
1918
1921 See attributes(5) for descriptions of the following attributes:
1922 ┌─────────────────────────────┬─────────────────────────────┐
1927 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
1928 ├─────────────────────────────┼─────────────────────────────┤
1929 │Availability │SUNWmmsu │
1930 ├─────────────────────────────┼─────────────────────────────┤
1931 │Interface Stability │Committed │
1932 └─────────────────────────────┴─────────────────────────────┘
1933
1935 mmsclient(1M), mmsexplorer(1M), mmsinit(1M), mount(1M), attributes(5),
1936 mms(5), rbac(5)
1937SunOS 5.11 16 Apr 2009 mmsadm(1M)