StorageTek Storage Archive Manager and StorageTek QFS Software samu User Interface GuideRelease 5.4 E48431-02 |
|
Previous |
Next |
samu
This document describes the SAM-QFS samu
operator utility, a menu-driven, commandline user interface that greatly simplifies configuration and management tasks. With samu
, you can monitor SAM-QFS 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.
samu
You 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 samuversion
time
date
Display 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: samuversion
time
date
ty 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
samu
To exit samu
, enter :q
or q
.
Device configuration: samuversion
time
date
ty 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: samuversion
time
date
ty 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 samuversion
time
date
count 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: samuversion
time
date
ty 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: samuversion
time
date
ty 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:!ls
cores faults log reports sendtrap.log tmpfiles Press Return to continue
When you are ready to return to the samu
interface, press Return.
down
to on
Open 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: samuversion
time
date
ty 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 ti103
down
/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: samuversion
time
date
ty 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: samuversion
time
date
ty 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 ti103
off
/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
.