1mmsadm(1M) System Administration Commands mmsadm(1M)
2
3
4
6 mmsadm - administration command for the Media Management System
7
9 /usr/sbin/mmsadm [-h | -?]
10
11
12 mmsadm discover [-H] [-t library|drive|vol] [-S ACSLS-host[:port]] -a
13
14
15 mmsadm create -t library|drive|mpool|dpool|app|voltype
16 -o option=x [-o option2=y...] name
17
18
19 mmsadm delete -t library|drive|mpool|dpool|app|voltype
20 [-f] name
21
22
23 mmsadm set -t library|drive|mpool|dpool|app|voltype
24 -o option=x [-o option2=y...] name
25
26
27 mmsadm list [-vH] -t library|drive|mpool|dpool|app|voltype
28 -o option=x [-o option2=y...] [-F filter [-F filter2...] [name]
29
30
31 mmsadm passwd [-P file] name
32
33
34 mmsadm online -t library|drive name
35
36
37 mmsadm offline -t library|drive name
38
39
40 mmsadm add-volume -l library -o voltype=type -x vol1[,vol2,...] mpool
41
42
43 mmsadm remove-volume -x [-l library] [-x vol1[,vol2,...]] mpool
44
45
46 mmsadm label [-n] [-A application] [-l library]
47 [-P file]volume[,volume,...]]
48
49
50 mmsadm showreq [-H] [drivename]
51
52
53 mmsadm accept [-r "reason"] requestid
54
55
56 mmsadm reject [-r "reason"] requestid
57
58
59 mmsadm dbbackup directory
60
61
62 mmsadm dbrestore file
63
64
65 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
69
70 mmsadm unmount [-A application] [-P file] [-f] volume|pseudodevice
71
72
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
80
81 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
89
90 The mmsinit(1M) command must be run to initialize MMS on a system
91 before you can use the mmsadm command.
92
93
94 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
103 # mmsadm subcommand [options]
104
105
106
107 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
114
115 discover requires the solaris.smf.read.mms authorization. The subcom‐
116 mand has the following syntax:
117
118 mmsadm discover [-H] [-t library|drive|vol]
119 [-S ACSLS-host[:port]] -a
120
121
122
123
124 The subcommand options are described as follows.
125
126 -a
127
128 Displays all discovered resources, including those configured for
129 MMS. By default, only unconfigured resources are displayed.
130
131
132 -H
133
134 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
138
139 -S ACSLS-host[:port]
140
141 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
145
146 -t library|drive|vol
147
148 Displays only the specified type of resource:
149
150 -t library
151
152 Shows discovered libraries.
153
154
155 -t drive
156
157 Shows discovered drives.
158
159
160 -t vol
161
162 Shows discovered volumes.
163
164 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
168
169 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
174
175 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
181
182 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
188
189 These subcommands have the following syntax:
190
191 create -t library|drive|mpool|dpool|app|voltype
192 -o option=x [-o option2=y...] name
193
194 set -t library|drive|mpool|dpool|app|voltype
195 -o option=x [-o option2=y...] name
196
197
198
199
200 The subcommand options and operand are described as follows.
201
202 -t type
203
204 Specifies the type of resource being created or modified. type can
205 be one of:
206
207 library Tape library
208
209
210 drive Tape or disk archiving drive
211
212
213 mpool Media pool
214
215
216 dpool Drive pool
217
218
219 app MMS-aware application
220
221
222 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
226
227
228 -o option=x [-o option2=y...]
229
230 Options are key/value pairs and are specific to the resource type.
231
232 Library Options:
233
234 hwtype=type
235
236 Specify one of the supported library types: L180, L500, L700,
237 SL500, SL8500, or SL3000. This option is required for create
238 operations.
239
240 For disk archiving libraries, specify DISK.
241
242 The following are options for real network attached libraries.
243
244 acs=acs_number
245
246 Specifies the ACSLS ACS number for the library, as shown by the
247 discover subcommand. Required for create.
248
249
250 lsm=lsm_number
251
252 Specifies the ACSLS LSM number for the library, as shown by the
253 discover subcommand. Required for create.
254
255
256 serialno=serial_num
257
258 Specifies the serial number of the library as reported by the
259 discover subcommand. Required for create.
260
261
262 acsls=host[:port]
263
264 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
268 The following are options for disk archiving libraries.
269
270 dkpath=path
271
272 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
276
277 dkaltpath=host1@directory1[,host2@directory2]
278
279 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
284 All libraries have the following options.
285
286 msg-level=emergency|alert|critical|error|warning|notice|
287 information|debug
288
289 Specifies the level of detail in messages written to the log
290 file. The default level is error.
291
292
293 trace-level=emergency|alert|critical|error|warning|
294 notice|information|debug
295
296 Specifies the level of detail in messages written to the trace
297 file. The default level is error.
298
299
300 trace-file-size=size
301
302 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
306 o K for kilobytes
307
308 o M for megabytes
309
310 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
314 trace-file-size=15M
315
316
317
318 Drive Options:
319
320 hwtype=type
321
322 Specifies the drive type as reported from the discover subcom‐
323 mand. Required for create.
324
325
326 serialno=serial
327
328 Specifies the serial number of the drive as reported from the
329 discover subcommand. Required for create.
330
331
332 library=library_name
333
334 Defines the MMS identifier of the library controlling this
335 drive as reported from the list subcommand. Required for cre‐
336 ate.
337
338
339 connection=host,[host]
340
341 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
345
346 apps=app1[,app2,...]
347
348 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
352
353 msg-level=emergency|alert|critical|error|warning|notice|
354 information|debug
355
356 Specifies the level of detail in messages written to the log
357 file. The default level is error.
358
359
360 trace-level=emergency|alert|critical|error|warning|
361 notice|information|debug
362
363 Specifies the level of detail in messages written to the trace
364 file. The default level is error.
365
366
367 trace-file-size=size
368
369 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
373 o K for kilobytes
374
375 o M for megabytes
376
377 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
381 trace-file-size=15M
382
383
384
385
386 unload-time=num_minutes
387
388 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
396
397 reserve=yes|no
398
399 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
406 Drive Pool Options
407
408 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
412 Media Pool Options
413
414 apps=app1[,app2,...]
415
416 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
420 Application Options
421
422 retain=num_days
423
424 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
428
429 validate-expiration=yes|no
430
431 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
436
437 validate-volid=yes|no
438
439 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
445
446 validate-filename=yes|no
447
448 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
454
455 overwrite-existing=yes|no|ask
456
457 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
463 System Options
464
465 log-level=emergency|alert|critical|error|warning|notice|
466 information|debug
467
468 Specifies the level of detail in messages written to the log
469 file. The default level is error.
470
471
472 num-restarts=num
473
474 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
480
481 attended=yes|no
482
483 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
491
492 num-sockets=num
493
494 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
500
501 disk-timeout=seconds
502
503 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
509 dkvol Options
510
511 dirname=path
512
513 Required by (and only valid for) create. Specifies the direc‐
514 tory in which the new disk archiving volume will created.
515
516
517 size=num
518
519 Valid only for create. Specifies the size, in megabytes, of the
520 disk archiving volume.
521
522
523 readonly=true|false
524
525 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
529
530 mpool=pool_name
531
532 Media pool to which this disk archiving volume will be added
533 after it is created. This option is required for create.
534
535 dkdrive Options
536
537 apps=app1[,app2,...]
538
539 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
543
544 msg-level=emergency|alert|critical|error|warning|notice|
545 information|debug
546
547 Specifies the level of detail in messages written to the log
548 file. The default level is error.
549
550
551 trace-level=emergency|alert|critical|error|warning|
552 notice|information|debug
553
554 Specifies the level of detail in messages written to the trace
555 file. The default level is error.
556
557
558 trace-file-size=size
559
560 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
564 o K for kilobytes
565
566 o M for megabytes
567
568 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
572 trace-file-size=15M
573
574
575
576
577 unload-time=num_minutes
578
579 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
587 voltype Options
588
589 mediatype=type
590
591 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
596
597
598 size=num
599
600 The size, in megabytes, of the this volume type. This option is
601 required for create.
602
603
604
605
606 The create and set subcommands have the following operand.
607
608 name
609
610 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
615 For a library: LIB_type_serial
616
617 Example: LIB_L180_MPC02209500
618
619 For a drive: DRV_type_serial
620
621 Example: DRV_T9940B_479000010675
622
623 For a disk archive volume: VOL_xxxxxx
624
625 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
629
630 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
637
638 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
643
644 Deleting a drive is prohibited if it is actively in use.
645
646
647 Deleting a drive pool is prohibited if any of its drives is being used
648 by an application.
649
650
651 Deleting a media pool is prohibited if any of its volumes is being used
652 by an application.
653
654
655 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
660
661 Deleting a voltype is prohibited if any volumes are assigned that type.
662 The -f option cannot be used to force this operation.
663
664
665 The delete subcommand requires the solaris.smf.value.mms and
666 solaris.mms.* authorizations.
667
668
669 This subcommand has the following syntax:
670
671 mmsadm delete -t library|drive|mpool|dpool|app|voltype
672 [-f] name
673
674
675
676
677 The subcommand has the following options:
678
679 -f
680
681 Forces the removal of the specified resource, subject to the
682 restrictions outlined above.
683
684
685 -t library|drive|mpool|dpool|app|voltype
686
687 Specifies the type of resource being deleted.
688
689
690
691 The subcommand has the following operand:
692
693 name
694
695 Identifies the resource as reported by the list subcommand.
696
697
698 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
703
704 This subcommand has the following syntax:
705
706 mmsadm list [-vH] -t library|drive|mpool|dpool|app|voltype
707 -o option[,-o option2,...] [-F filter [-F filter2...] [name]
708
709
710
711
712 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
717 -v
718
719 Verbose.
720
721
722 -H
723
724 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
728
729 -t type
730
731 One of:
732
733 o app
734
735 o drive
736
737 o library
738
739 o mpool
740
741 o dpool
742
743 o voltype
744
745
746 -o option[,-o option2,...]
747
748 Specifies which properties of a resource are displayed. For exam‐
749 ple, to list only drive names and their respective states, enter:
750
751 % mmsadm list -t drive -o name,state
752
753
754
755
756 -F filter [-F filter2...]
757
758 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
763 # mmsadm list -t drive -F hwtype=LTO4
764
765
766 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
772 Library Options
773
774 Options in common with set:
775
776 o acs
777
778 o acsls
779
780 o hwtype
781
782 o lsm
783
784 o msg-level
785
786 o serialno
787
788 o trace-file-size
789
790 o trace-level
791 The following library options are unique to list.
792
793 create-time
794
795 The date and time when the library was added to the MMS.
796
797
798 state
799
800 The current state of the library, one of ready, offline, or
801 broken.
802
803 Drive Options
804
805 Options in common with set:
806
807 o apps
808
809 o connection
810
811 o hwtype
812
813 o library
814
815 o msg-level
816
817 o reserve
818
819 o serialno
820
821 o trace-file-size
822
823 o trace-level
824
825 o unload-time
826 The following drive options are unique to list.
827
828 create-time
829
830 The date and time when the drive was added to the MMS.
831
832
833 device-name
834
835 The Unix device name of the drive, if available.
836
837
838 last-mount
839
840 The date and time when the drive was last mounted.
841
842
843 state
844
845 The current state of the drive, one of ready, offline, or bro‐
846 ken.
847
848
849 total-mount-time
850
851 The total amount of time the drive has had tapes mounted.
852
853
854 volume
855
856 The volume name of the volume loaded in the drive, if any.
857
858 Media Pool Options
859
860 There is one option in common with create, apps.
861
862 The following media pool options are unique to list.
863
864 create-time
865
866 The date and time the media pool was created.
867
868
869 free
870
871 The total amount of free space remaining on volumes in the
872 media pool.
873
874
875 size
876
877 The total capacity of the media pool.
878
879
880 used
881
882 The total amount of data on volumes in the media pool.
883
884 Application Options
885
886 All of the application options are in common with create. These
887 options are as follows:
888
889 o overwrite-existing
890
891 o retain
892
893 o validate-expiration
894
895 o validate-filename
896
897 o validate-volid
898 System Options
899
900 Options in common with set:
901
902 o acsls-install-dir
903
904 o attended
905
906 o disk-timeout
907
908 o host
909
910 o log-file
911
912 o log-level
913
914 o port
915
916 o num-restarts
917
918 o num-sockets
919 There is one system option unique to list.
920
921 active-sessions
922
923 Brief listing of active sessions.
924
925 Volume Options
926
927 All of the volume options are unique to list.
928
929 apps
930
931 Lists the application that has stored data on this volume.
932
933
934 create-time
935
936 Date and time this volume was added to the MMS.
937
938
939 free
940
941 Amount of free space on the volume.
942
943
944 last-mounted
945
946 Date and time this volume was last mounted.
947
948
949 library
950
951 Lists the library controlling this volume.
952
953
954 mpool
955
956 Media pool, of which this volume is a member.
957
958
959 num-mounts
960
961 Number of times this volume has been mounted.
962
963
964 size
965
966 Size of the volume.
967
968
969 total-mount-time
970
971 Total amount of time this volume has been mounted.
972
973
974 used
975
976 Amount of data written to the volume.
977
978
979 voltype
980
981 Lists the volume type as was specified when the volume was
982 added to a media pool.
983
984 Volume Type Options
985
986 Both of the volume type options are unique to list.
987
988 mtype
989
990 MMS media type associated with this voltype.
991
992
993 size
994
995 Default size, in megabytes, for volumes of this type.
996
997
998
999 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
1004
1005 The passwd subcommand has the following syntax.
1006
1007 mmsadm passwd [-P passwdfile] name
1008
1009
1010
1011
1012 This subcommand requires the solaris.smf.value.mms and solaris.mms.*
1013 authorizations.
1014
1015
1016 The passwd subcommand has the following option.
1017
1018 -P passwdfile
1019
1020 Path to a temporary file containing the password.
1021
1022
1023
1024 The passwd subcommand has the following operand.
1025
1026 name
1027
1028 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
1032
1033 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
1040
1041 The syntax for the online and offline subcommands is as follows:
1042
1043 mmsadm online -t library | drive name
1044
1045 mmsadm offline -t library | drive name
1046
1047
1048
1049
1050 The online and offline subcommands require the solaris.smf.read.mms and
1051 solaris.mms.device.state.* authorizations.
1052
1053
1054 The online and offline subcommands have the following option.
1055
1056 -t library | drive
1057
1058 Specifies the type of resource to make unavailable or to restore.
1059
1060 drive
1061
1062 Tape or disk archiving drive.
1063
1064
1065 library
1066
1067 Tape library.
1068
1069
1070
1071
1072 The online and offline subcommands have the following operand.
1073
1074 name
1075
1076 Name of the library or drive, as reported by the list subcommand
1077
1078
1079 The label Subcommand
1080 The label subcommand labels specified volumes. The subcommand has the
1081 following syntax:
1082
1083 mmsadm label [-n] -l library -A application [-P file]
1084 volume[,volume,...]
1085
1086
1087
1088
1089 The label subcommand requires the solaris.smf.read.mms and
1090 solaris.mms.media.* authorizations.
1091
1092
1093 The label subcommand has the following options.
1094
1095 -l library
1096
1097 Name of the library holding the volume.
1098
1099
1100 -n
1101
1102 Do not mount the volume. If this is not specified, the specified
1103 volume will be mounted and header labels will be written.
1104
1105
1106 -A application
1107
1108 Name of the application to which this volume will be assigned after
1109 labeling.
1110
1111
1112 -P file
1113
1114 Path to a file containing the application password. If a file name
1115 is not provided, the user is prompted for the password.
1116
1117
1118
1119 The label subcommand has the following operand.
1120
1121 volume[,volume,...]
1122
1123 Volume(s) to be labeled.
1124
1125
1126 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
1130 mmsadm add-volume -l library_name -o voltype=type
1131 -x vol1[,vol2,...] mpool
1132
1133
1134
1135
1136 The add-volume subcommand requires the solaris.smf.read.mms and
1137 solaris.mms.media.* authorizations.
1138
1139
1140 The add-volume subcommand has the following options.
1141
1142 -l library_name
1143
1144 Name of the library from which volumes are selected.
1145
1146
1147 -o voltype=type
1148
1149 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
1154
1155 -x vol1[,vol2,...]
1156
1157 A comma-separated list of unused volumes in the specified library.
1158
1159
1160
1161 The add-volume subcommand has the following operand.
1162
1163 mpool
1164
1165 Name of the media pool as reported by the list subcommand.
1166
1167
1168 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
1175 mmsadm remove-volume -f -x [-l library] vol1[,vol2,...] mpool
1176
1177
1178
1179
1180 The remove-volume subcommand requires the solaris.smf.read.mms and
1181 solaris.mms.media.* authorizations.
1182
1183
1184 The remove-volume subcommand has the following options.
1185
1186 -f
1187
1188 Forces the removal of the specified volume(s), even if they are in
1189 use by an application.
1190
1191
1192 -l library_name
1193
1194 Name of the library from which volumes are removed.
1195
1196
1197 -x vol1[,vol2,...]
1198
1199 A comma-separated list of volumes.
1200
1201
1202
1203 The remove-volume subcommand has the following operand.
1204
1205 mpool
1206
1207 Name of the media pool as reported by the list subcommand.
1208
1209
1210 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
1214 mmsadm showreq [-H] [drivename]
1215
1216
1217
1218
1219 The showreq subcommand does not require any authorizations.
1220
1221
1222 The showreq subcommand has the following option.
1223
1224 -H
1225
1226 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
1230
1231
1232 The showreq subcommand has the following operand.
1233
1234 drivename
1235
1236 Displays the requests only for the specified drive.
1237
1238
1239 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
1243 mmsadm accept [-r "response text"] requestid
1244
1245
1246
1247
1248 The accept subcommand requires the solaris.mms.request.* and
1249 solaris.smf.read.mms authorizations.
1250
1251
1252 The accept subcommand has the following option.
1253
1254 -r "response text"
1255
1256 Displays the text that explains the reason for the action.
1257
1258
1259
1260 The accept subcommand has the following operand.
1261
1262 requestid
1263
1264 The identifier of the operator request, as displayed by the mmsadm
1265 showreq command.
1266
1267
1268 The reject Subcommand
1269 The reject subcommand rejects the operator request. The subcommand has
1270 the following syntax.
1271
1272 mmsadm reject [-r "response text"] requestid
1273
1274
1275
1276
1277 The reject subcommand requires the solaris.mms.request.* and
1278 solaris.smf.read.mms authorizations.
1279
1280
1281 The reject subcommand has the following option.
1282
1283 -r "response text"
1284
1285 Displays the text that explains the reason for the action.
1286
1287
1288
1289 The reject subcommand has the following operand.
1290
1291 requestid
1292
1293 The identifier of the operator request, as displayed by the mmsadm
1294 showreq command.
1295
1296
1297 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
1305 mmsadm dbbackup directory
1306
1307
1308
1309
1310 The dbbackup subcommand requires the solaris.smf.manage.mms,
1311 solaris.smf.value.mms, and solaris.mms.* authorizations.
1312
1313
1314 The dbbackup subcommand has the following operand.
1315
1316 directory
1317
1318 Specifies the location where the database backup files will be
1319 stored.
1320
1321
1322 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
1328 mmsadm dbrestore filename
1329
1330
1331
1332
1333 The dbrestore subcommand requires the solaris.smf.manage.mms and
1334 solaris.smf.value.mms authorizations.
1335
1336
1337 The dbrestore subcommand has the following operand.
1338
1339 filename
1340
1341 Specifies the complete pathname to the file containing the backup
1342 of the MMS database.
1343
1344
1345 The mount Subcommand
1346 The mount subcommand mounts a specified volume. The subcommand has the
1347 following syntax.
1348
1349 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
1353
1354
1355
1356 The mount subcommand requires the solaris.mms.io.[read|write|*] autho‐
1357 rization.
1358
1359
1360 The mount subcommand has the following options.
1361
1362 -A application
1363
1364 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
1368
1369 -b blocksize
1370
1371 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
1375 9940 and 9840
1376
1377 1 - 262144. If you specify fixed for the -M option (described
1378 below), must be an even number.
1379
1380
1381 LTO (all models)
1382
1383 1 - 16777215. If you specify fixed for the -M option (described
1384 below).
1385
1386 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
1391
1392 -d drive
1393
1394 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
1397
1398 -D density
1399
1400 Specifies the output density. Can be one of:
1401
1402 o high
1403
1404 o medium
1405
1406 o low
1407
1408 o compressed
1409
1410 o den_9840
1411
1412 o den_T9840C
1413
1414 o den_T9940A
1415
1416 o den_T9940B
1417
1418
1419 -l library_name
1420
1421 Library containing the volume to be mounted.
1422
1423
1424 -M mode[,mode...]
1425
1426 The mode argument can be one or more of creat, old, st_nobsd,
1427 st_tm, raw, mms, compression, nocompression, variable, block.
1428
1429
1430 -n
1431
1432 Specifies norewind.
1433
1434
1435 -N
1436
1437 Specifies nowait.
1438
1439
1440 -P file
1441
1442 Path to a file containing the application password. If a file name
1443 is not provided, the user is prompted for the password.
1444
1445
1446 -R
1447
1448 Specifies a read-only mount. The default is read/write.
1449
1450
1451 -u username
1452
1453 Specifies the user who will own the pseudodevice created by mount.
1454
1455
1456
1457 The mount subcommand has the following operand.
1458
1459 volume
1460
1461 Volume to be mounted.
1462
1463
1464 The unmount Subcommand
1465 The unmount subcommand unmounts the specified volume or MMS pseudode‐
1466 vice. The subcommand has the following syntax.
1467
1468 mmsadm unmount [-f] [-l library_name] [-A application]
1469 [-P file] volume|pseudodevice
1470
1471
1472
1473
1474 The unmount subcommand requires the solaris.mms.io.[read|write|*]
1475 authorization.
1476
1477
1478 The unmount subcommand has the following options.
1479
1480 -A application
1481
1482 Application name to be used when authenticating with the MM server.
1483
1484
1485 -f
1486
1487 Forces an unmount operation of this volume even if it is in use by
1488 another user.
1489
1490
1491 -l library_name
1492
1493 Library containing the mounted volume. Required only if using the
1494 volume name operand.
1495
1496
1497 -P file
1498
1499 Path to a temporary file containing the application password.
1500
1501
1502
1503 The unmount subcommand has one of the following operands.
1504
1505 pseudodevice
1506
1507 Device path as returned from the mmsadm mount command. If this form
1508 of unmount is used, the library need not be specified.
1509
1510
1511 volume
1512
1513 Volume to be unmounted.
1514
1515
1517 Example 1 Displaying Available Libraries
1518
1519
1520 To display all libraries available to be managed by the MMS, enter:
1521
1522
1523 # mmsadm discover -t library -S my-acsls-server
1524
1525
1526
1527 Example 2 Creating a Library
1528
1529
1530 To create a library in the MMS, enter:
1531
1532
1533 # 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
1536
1537
1538 Example 3 Creating a Drive
1539
1540
1541 To create a drive in the MMS, enter:
1542
1543
1544 # mmsadm create -t drive -o library=LIB_L180_7493476 \
1545 -o hwtype=LTO2 -o serialno=6453805873 \
1546 -o connection=myhost DRV_LTO2_6453805873
1547
1548
1549
1550 Example 4 Making Library Available
1551
1552
1553 To make a library available for use, enter:
1554
1555
1556 # mmsadm online LIB_L180_7493476
1557
1558
1559
1560 Example 5 Registering an Application
1561
1562
1563 To register an application, enter:
1564
1565
1566 # mmsadm create -t app -P /var/tmp/app_passwd MyBackupApp
1567
1568
1569
1570 Example 6 Allowing an Application to Use a Drive
1571
1572
1573 To allow the MyBackupApp application to use a drive, enter:
1574
1575
1576 # mmsadm set -t drive -o apps=MyBackupApp DRV_LTO2_6453805873
1577
1578
1579
1580 Example 7 Listing Volumes in a Library
1581
1582
1583 To show volumes in library L700_99987004 of type LT03, enter:
1584
1585
1586 # mmsadm list -t vol -o library=L700_99987004 -F mtype=LTO3
1587
1588
1589
1590 Example 8 Listing Unconfigured Volumes
1591
1592
1593 To show volumes not yet configured for the MMS, enter:
1594
1595
1596 # mmsadm discover -t vol -S my_acsls_server
1597
1598
1599
1600 Example 9 Configure an MMS for Three Applications
1601
1602
1603 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
1607
1608
1609 Initialize the MM server and set the administrator password to
1610 mmsadm2008 in the password file, mmsadm_passwd:
1611
1612
1613 # mmsinit -P ~/mmsadm_passwd
1614
1615
1616
1617
1618 Create an application for the engineering application:
1619
1620
1621 # mmsadm create -t app -P ~/eng_passwd eng
1622
1623
1624
1625
1626 Create an application for the finance application:
1627
1628
1629 # mmsadm create -t app -P ~/finance_passwd finance
1630
1631
1632
1633
1634 Create an application for the backup application:
1635
1636
1637 # mmsadm create -t app -P ~/backup_passwd backup
1638
1639
1640
1641
1642 Create an L700 library named library1:
1643
1644
1645 # mmsadm create -t library -o acsls=mms-280-1 -o hwtype=L700 \
1646 -o acs=0 -o lsm=0 -o serialno=MPC02201638 library1
1647
1648
1649
1650
1651 Create a drive pool named org_dpool, to be shared between the engineer‐
1652 ing and finance applications:
1653
1654
1655 # mmsadm create -t dpool -o apps=eng,finance org_dpool
1656
1657
1658
1659
1660 Create a drive pool named shared_dpool, to be shared by the engineer‐
1661 ing, finance, and backup applications:
1662
1663
1664 # mmsadm create -t dpool -o apps=eng,finance,backup shared_dpool
1665
1666
1667
1668
1669 Create an exclusive drive pool for the backup application named
1670 bk_dpool:
1671
1672
1673 # mmsadm create -t dpool -o apps=backup bk_dpool
1674
1675
1676
1677
1678 Add a 9940 drive named drive1 shared by the engineering and finance
1679 applications:
1680
1681
1682 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000002009 \
1683 -o library=library1 -o dpool=org_dpool drive1
1684
1685
1686
1687
1688 Add a 9940 drive named drive2 shared by the engineering, finance, and
1689 backup applications:
1690
1691
1692 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000001954 \
1693 -o library=library1 -o dpool=shared_dpool drive2
1694
1695
1696
1697
1698 Add an exclusive 9940 drive named drive3 for the backup application:
1699
1700
1701 # mmsadm create -t drive -o hwtype=9940 -o serialno=479000001944 \
1702 -o library=library1 -o dpool=bk_dpool drive3
1703
1704
1705
1706
1707 Create media pool for the engineering and finance applications named
1708 org_mpool:
1709
1710
1711 # mmsadm create -t mpool -o apps=eng,finance org_mpool
1712
1713
1714
1715
1716 Create an exclusive media pool for the backup application named
1717 bk_mpool:
1718
1719
1720 # mmsadm create -t mpool -o apps=backup bk_mpool
1721
1722
1723
1724
1725 Add three volumes to the engineering and finance media pool:
1726
1727
1728 # mmsadm add-volume -l library1 -o voltype=9940 \
1729 -x 000220,000221,000222 org_mpool
1730
1731
1732
1733
1734 Add two volumes to the backup media pool:
1735
1736
1737 # mmsadm add-volume -l library1 -o voltype=9940 \
1738 -x 000230,000231 bk_mpool
1739
1740
1741
1742
1743 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
1747
1748 # mmsadm label -P ~/eng_passwd -l library1 -A eng 000220
1749
1750
1751
1752
1753 Verify that the engineering application owns the volume:
1754
1755
1756 # mmsadm label -P ~/finance_passwd -l library1 -A finance 000220
1757
1758
1759
1760
1761 Write a volume label for the finance application:
1762
1763
1764 # mmsadm label -P ~/finance_passwd -l library1 -A finance 000221
1765
1766
1767
1768
1769 Write a volume label for the backup application:
1770
1771
1772 # mmsadm label -P ~/backup_passwd -l library1 -A backup 000230
1773
1774
1775
1776
1777 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
1781
1782 # 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
1786
1787
1788
1789 Unmount the media and unload the drives:
1790
1791
1792 # 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
1796
1797
1798 Example 10 Configure an MMS for Disk Archiving
1799
1800
1801 The following sequence of commands configures a Media Management System
1802 for disk archiving.
1803
1804
1805
1806 Create a test application:
1807
1808
1809 # mmsadm create -t app -P ~/test_passwd test
1810
1811
1812
1813
1814 Create a disk archiving library named dklib1:
1815
1816
1817 # mmsadm create -t library -o hwtype=DISK -o dkpath=/dskpool dklib1
1818
1819
1820
1821
1822 Create a disk archiving media pool named dkcarts:
1823
1824
1825 # mmsadm create -t mpool -o apps=test dkcarts
1826
1827
1828
1829
1830 Create three 100 GB volumes for disk archiving and place the volumes in
1831 the media pool:
1832
1833
1834 # mmsadm add-volume -l dklib1 -o voltype=DISK -x 000000,000001,000002 \
1835 -o size=100g dkcarts
1836
1837
1838
1839
1840 Create a disk archiving drive pool named dkdrives:
1841
1842
1843 # mmsadm create -t dpool -o apps=test dkdrives
1844
1845
1846
1847
1848 Create a disk archiving drive and place it in the drive pool:
1849
1850
1851 # mmsadm create -t drive -o hwtype=DISK -o library=dklib1 \
1852 -o dpool=dkdrives dkdrive1
1853
1854
1855
1856
1857 Create volume labels. The volume will be labeled when it is mounted:
1858
1859
1860 # 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
1864
1865
1866
1867 Mount the volume 000000. Use the returned tape handle in a subsequent
1868 tar command:
1869
1870
1871 # mmsadm mount -P ~/test_passwd -n -l dklib1 -A test 000000
1872
1873
1874
1875
1876 Show the file sizes of the disk archiving volume before creating tar
1877 archive:
1878
1879
1880 % ls -la /dskpool/dklib1/000000
1881
1882
1883
1884
1885 Create a disk archiving tar archive:
1886
1887
1888 # tar -cvf <mms_handle> /var > /tmp/out$$ 2>&1
1889
1890
1891
1892
1893 Show the file sizes of the disk archiving volume after creating the tar
1894 archive:
1895
1896
1897 % ls -la /dskpool/dklib1/000000
1898
1899
1900
1901
1902 Unmount and unload the volume from the drive:
1903
1904
1905 # mmsadm unmount -P ~/test_passwd -U -l dklib1 -A test 000000
1906
1907
1908
1910 0
1911
1912 Command succeeded.
1913
1914
1915 >0
1916
1917 An error occurred.
1918
1919
1921 See attributes(5) for descriptions of the following attributes:
1922
1923
1924
1925
1926 ┌─────────────────────────────┬─────────────────────────────┐
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)
1937
1938
1939
1940SunOS 5.11 16 Apr 2009 mmsadm(1M)