Oracle® Hierarchical Storage Manager and StorageTek QFS Software samu User Interface GuideRelease 6.0 E48431-03 |
|
 Previous |
 Next |
Oracle® Hierarchical Storage Manager and StorageTek QFS Software samu User Interface GuideRelease 6.0 E48431-03 |
|
Previous |
Next |
samuThis document describes the Oracle HSM samu operator utility, a menu-driven, commandline user interface that greatly simplifies configuration and management tasks. With samu, you can monitor Oracle HSM devices and file system activity, control access to devices and file systems. and tune running file systems.
The samu utility is in some respects similar to the UNIX vi editor. You select displays, set display options, navigate within and between displays, enter commands, refresh displays, and quit the utility using similar control key sequences. The last line of each display window displays error messages. Displays refresh automatically unless an error occurs, in which case the display halts until the operator takes further action. When desired, you can take snapshots of display windows for later reference.
The remainder of this introduction describes Prerequisites for using samu and some Common Tasks. Subsequent chapters provide detailed descriptions of the available commands.
The samu operator utility requires a display terminal that is at least 24 lines long by 80 characters wide.
Like the vi editor, samu is based on the UNIX curses(3CURSES) library. If you have trouble invoking samu, make sure that your terminal type is defined correctly.
Note that what you see in the sample screens below may differ from what you see online. The samples are representative rather than exact representations of any given installation. Actual displays depend on your terminal characteristics and on your file-system configuration. Many samu screens relate to storage and archive management, for example, and will not appear if you are using QFS file systems without archiving.
The following sections describe how to start and stop samu, interact with the utility, access the help windows, view operator displays, and bring up drives.
samuYou can start the samu operator utility using the utility's defaults or you can specify display and/or command options:
To start the operator utility using the default display options, enter the samu command at the system command prompt:
root@solaris:~# samu
The samu interface starts and displays the default initial screen, the help:
Help information page 1/15 samuversiontimedateDisplay control commands: Displays: a Archiver status w Pending stage queue c Device configuration C Memory d Daemon trace controls D Disk volume dictionary f File systems F Optical disk label g Shared clients I Inode h Help information J Preview shared memory l Usage information K Kernel statistics m Mass storage status L Shared memory tables n Staging status M Shared memory o Optical disk status N File system parameters p Removable media load requests P Active Services r Removable media R SAM-Remote s Device status S Sector data t Tape drive status T SCSI sense data u Staging queue U Device table v Robot catalog more (ctrl-f) samu onhost
To start the operator utility with a specified display, enter the samu command with the -d switch and the name of the command:
# samu -d commandname
The samu interface starts and shows the specified screen display. For example, to start samu with the configuration screen, you would enter the following:
# samu -d c
The utility starts with the device configuration screen:
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 on /dev/rmt/2cbn 100 libraryA hy 104 on historian 104
To start the operator utility and change the default display refresh interval, enter the samu command with the -r switch and the length of the interval in seconds:
# samu -r seconds
To start the operator utility and immediately run a specified command, enter the samu command with the -c switch and the name of the command:
# samu -c commandname
To start the operator utility and immediately run a series of commands from a file containing one command per line, enter the samu command with the -f switch and the name of the command file:
# samu -c filename
samuTo exit samu, enter :q or q.
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 on /dev/rmt/2cbn 100 libraryA hy 104 on historian 104q
The samu operator utility exits and returns you to the command shell.
To display a particular samu screen, proceed as follows.
If you do not know the display control command that corresponds to the desired screen, enter h to call up the help screen. Lookup the required command in the list displayed.
Enter the display control command that corresponds to the desired screen.
For example, to display the library catalog and list the volume serial numbers (VSNs) for the tapes in the robotic tape library, enter v.
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 on /dev/rmt/2cbn 100 libraryA hy 104 on historian 104v
The utility displays the Robot VSN catalog:
Robot VSN catalog by slot : eq 900 samuversiontimedatecount 32 slot access time count use flags ty vsn 0 2013/05/01 13:36 2 86% -il---b----- li S00001 1 2013/05/03 14:14 0 98% -il---b----- li S00002 2 2013/05/03 14:17 0 86% -il---b----- li S00003 3 2013/05/03 14:20 0 95% -il---b----- li S00004 4 none 0 0% -il-o-b----- li S00005 ...
If the display is longer than the available screen area, the utility breaks the information into pages and displays the prompt more near the bottom of the screen. To navigate between pages, press the Ctrl-F (^f) key combination to move forward to the next page, or Ctrl-B (^b) to move back to the previous page.
samu CommandYou enter commands from the display screens using the procedure below:
On any samu screen, enter a : (colon).
When the command: prompt appears, enter the samu command.
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 down /dev/rmt/2cbn 100 libraryA hy 104 on historian 104:command:q
You run operating system shell commands from samu as follows:
On any samu screen, enter a : (colon).
When the command: prompt appears, enter ! (exclamation point) followed by the shell command.
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 down /dev/rmt/2cbn 100 libraryA hy 104 on historian 104:command:!lscores faults log reports sendtrap.log tmpfiles Press Return to continue
When you are ready to return to the samu interface, press Return.
down to onOpen a samu display that shows drive and automated library device states. Enter c, m, o, r, s, or t.
In the eq field of the screen, note the equipment ordinal number for the down device.
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti103down/dev/rmt/2cbn 100 libraryA hy 104 on historian 104
Stop all device activity. Enter the command character: and, when the command prompt appears, enter the off command with the equipment ordinal number for the down device:
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti 103 down /dev/rmt/2cbn 100 libraryA hy 104 on historian 104:command:off 103
Enter the command character: and, when the command prompt appears, enter the on command with the equipment ordinal number for the off device:
For example:
Device configuration: samuversiontimedatety eq state device_name fs family_set sk 100 on /etc/opt/SUNWsamfs/libraryA_T10K_parms 100 libraryA ti 101 on /dev/rmt/0cbn 100 libraryA ti 102 on /dev/rmt/1cbn 100 libraryA ti103off/dev/rmt/2cbn 100 libraryA hy 104 on historian 104:command:on 103
You can reach the help pages from any samu display by entering :h or h.
