samu - StorageTek QFS and Oracle HSM operator utility
samu
[-d
c] [-r
i] [-c
string] [-f
cmd-file]
SUNWqfs
SUNWsamfs
samu
is a full screen operator
interface for StorageTek QFS and Oracle HSM environments.
It has a number of displays that show the
status of file systems and devices and allows the operator to control
file systems and removable media devices.
-d
cSpecifies the initial display when samu
starts execution. See DISPLAYS
below.
-r
iSpecifies the time interval in seconds for refreshing the display window.
-c
stringSpecifies an initial command string that should be executed when samu
starts execution.
-f
cmd-fileSpecifies a file from which to read samu commands. Each line in the file is a command.
The following "hot" keys are available for all displays:
Key | Description |
---|---|
q | Quit |
: | Enter command |
space | Refresh display |
control-l | Refresh display (clear) |
control-r | Enable∕disable refresh (default is enabled) |
The following keys perform the listed functions for each of the displays shown:
Key | Function | Display |
---|---|---|
control-f | Next file system | :a,a,g |
Page forward | c,h,o,p,s,t,u,v,w,x,y,z,A,J,K,M,P | |
Next stage request | n | |
Next inode | I | |
Next sector | S | |
Next equipment | T,U | |
Next filesystem | N | |
control-b | Previous file system | :a,a,g |
Page backward | c,h,o,p,s,t,u,v,w,x,y,z,A,J,K,M,P | |
Previous stage request | n | |
Previous inode | I | |
Previous sector | S | |
Previous equipment | T,U | |
Previous filesystem | N | |
control-d | Half-page forward | c,p,s,u,w,x,y,z,A,J,M |
Next robot catalog | v | |
Page forward | g,h,S | |
Page arcopies forward | a | |
Page stage queue forward | n | |
Page partitions forward | N | |
control-u | Half-page backward | c,p,s,u,w,x,y,z,A,J,M |
Previous robot catalog | v | |
Page backward | g,h,S | |
Page arcopies backward | a | |
Page stage queue backward | n | |
Page partitions backward | N | |
control-k | Advance display format | A,I,S |
Select (manual,robotic,both,priority) | p | |
Advance sort key | v | |
Toggle path display | n,u,w | |
control-i | Detailed (3-line) arcopy format | a |
Detailed (2-line) display format | v,x,y,D | |
Detailed status interpretations | g,n,N | |
Detailed (show cloud drives) display | s,t,z | |
control-j | Size display unit (base 2 or 10) | D,:a,l,n,m,v,x,y |
1-7 | Select sort key | v |
∕ | Search for VSN | v |
% | Search for barcode | v |
$ | Search for slot | v |
The sort selections for the v display are: 1 slot, 2 count, 3 usage, 4 VSN, 5 access time, 6 barcode, 7 label time.
The following displays are available. Those displays marked with '*'
are the only ones available for StorageTek QFS. All others are
available in Oracle HSM environments
only if samd start
has been executed.
Key | Display | ||
---|---|---|---|
a | Display archiver status | ||
c | Display configuration | C | Memory |
d* | Display tracing info. | D | Display disk volume dictionary |
f* | Display filesystem info. | F | Optical disk label |
g* | Display client information | ||
h* | Display help information | ||
l | Display usage information | I* | Inode |
m* | Display mass-storage status | J | Preview shared memory |
n | Display staging activity | K | Kernel statistics |
o | Display optical disk status | L | Shared memory tables |
p | Display mount request preview | M | Shared memory |
r | Display removable media | N* | File system parameters |
s | Display device status summary | P | Active Services |
t | Display tape status | R | SAM-Remote info |
u | Display stage queue | S | Sector data |
v | Display robot VSN catalog | T | SCSI sense data |
w | Display pending stage queue | U | Device table |
x | Display active migration | ||
y | Display migration vsns | ||
z | Display cloud library status |
The following commands may be entered after a colon (:).
Command | Function |
---|---|
aridle [ dk | rm | fs.fsname ] | Idle archiving |
arrerun | Soft restart archiver |
arrestart | Restart archiver |
arrmarchreq fsname.[* | archreq] | Remove ArchReq |
arrun [ dk | rm | fs.fsname ] | Start archiving |
arscan fsname[.dir | ..inodes][int] | Scan filesystem |
arstop [ dk | rm | fs.fsname ] | Stop archiving |
artrace [fs.fsname] | Trace archiver |
Command | Function |
---|---|
refresh i | Set refresh time |
a filesystem | Select detailed "a" display |
n media | Set n display media selection |
p media | Set p display media selection |
r media | Set r display media selection |
u media | Set u display media selection |
v eq | Set v display robot catalog |
w media | Set w display media selection |
devlog | eq [option …] | Set device logging options |
idle | eq | Idle equipment |
off | eq | Off equipment |
on | eq | On equipment |
readonly | eq | Mark equipment read-only |
ro | eq | Mark equipment read-only |
unavail | eq | Mark equipment unavailable |
unload | eq | Unload mounted media∕magazine |
Command | Arguments | Function |
---|---|---|
stripe | eq value | Set stripe width |
suid | eq | Turn on setuid capability |
nosuid | eq | Turn off setuid capability |
sync_meta | eq value | Set sync_meta mode |
atime | eq value | Set access time (atime) update mode |
trace | eq | Turn on file system tracing |
notrace | eq | Turn off file system tracing |
add | eq | Add eq to mounted file system |
remove | eq | Remove eq; copy files to eqs with ON state |
release | eq | Release eq; mark files offline |
alloc | eq | Enable allocation on partition |
noalloc | eq | Disable allocation on partition |
def_retention | eq interval | Set default WORM retention time |
Command | Arguments | Function |
---|---|---|
hwm_archive | eq | Turn on hwm archiver start |
nohwm_archive | eq | Turn off hwm archiver start |
maxpartial | eq value | Set maximum partial size in kilobytes |
partial | eq value | Set size to remain online in kilobytes |
partial_stage | eq value | Set where to start staging if partial |
stage_flush_behind | eq value | Set stage flush behind size in kilobytes |
stage_n_window | eq value | Set direct stage size in kilobytes |
thresh | eq high low | Set high and low release thresholds |
Command | Arguments | Function |
---|---|---|
dio_rd_consec | eq value | Set number of consecutive dio reads |
dio_rd_form_min | eq value | Set size of well-formed dio reads |
dio_rd_ill_min | eq value | Set size of ill-formed dio reads |
dio_wr_consec | eq value | Set number of consecutive dio writes |
dio_wr_form_min | eq value | Set size of well-formed dio writes |
dio_wr_ill_min | eq value | Set size of ill-formed dio writes |
flush_behind | eq value | Set flush behind value in kilobytes |
forcedirectio | eq | Turn on directio mode |
noforcedirectio | eq | Turn off directio mode |
force_nfs_async | eq | Turn on NFS async |
noforce_nfs_async | eq | Turn off NFS async |
readahead | eq value | Set maximum readahead in kilobytes |
writebehind | eq value | Set maximum writebehind in kilobytes |
sw_raid | eq | Turn on software RAID mode |
nosw_raid | eq | Turn off software RAID mode |
wr_throttle | eq value | Set outstanding write size in kilobytes |
abr | eq | Enable Application Based Recovery |
noabr | eq | Disable Application Based Recovery |
dmr | eq | Enable Directed Mirror Reads |
nodmr | eq | Disable Directed Mirror Reads |
dio_szero | eq | Turn on dio sparse zeroing |
nodio_szero | eq | Turn off dio sparse zeroing |
Command | Arguments | Function |
---|---|---|
mm_stripe | eq value | Set meta stripe width |
qwrite | eq | Turn on qwrite mode |
noqwrite | eq | Turn off qwrite mode |
Command | Arguments | Function |
---|---|---|
invalid | eq interval | Set multireader invalidate cache delay |
refresh_at_eof | eq | Turn on refresh at eof mode |
norefresh_at_eof | eq | Turn off refresh at eof mode |
Command | Arguments | Function |
---|---|---|
minallocsz | eq value | Set minimum allocation size |
maxallocsz | eq value | Set maximum allocation size |
meta_timeo | eq interval | Set shared fs meta cache timeout |
mh_write | eq | Turn on multihost read∕write |
nomh_write | eq | Turn off multihost read∕write |
aplease | eq interval | Set append lease time |
rdlease | eq interval | Set read lease time |
wrlease | eq interval | Set write lease time |
Command | Arguments | Function |
---|---|---|
audit | [-e] eq[:slot[:side]] | Audit slot or library. See auditslot (1m) for information on -e. |
import | eq | Import cartridge from mailbox |
export | eq:slot | Export cartridge to mailbox |
export | mt.vsn | Export cartridge to mailbox |
load | eq:slot[:side] | Load cartridge in drive |
load | mt.vsn | Load cartridge in drive |
priority | pid newpri | Set load priority for process 'pid' |
Command | Arguments | Function |
---|---|---|
stclear | mt.vsn | Clear stage request |
stidle | Idle staging | |
strun | Start staging |
Command | Arguments | Function |
---|---|---|
migconfig | Configure migration | |
migstart | Start migration | |
migidle | Idle migration | |
migstop | Stop migration |
Command | Arguments | Function |
---|---|---|
clear | vsn [index] | Clear load request |
diskvols | volume [+flag | -flag] | Set or clear disk volume dictionary flags |
dtrace | daemon[.variable] value | Set daemon trace controls |
fs | fsname | Set filesystem (N display) |
mount | mntpt | Select a mount point (I, N displays) |
open | eq | Open device (F, S displays) |
read | addr | Read device |
snap | file | Snapshot screen to file |
!shell-command | Run shell command |