sasmgr(1M)sasmgr(1M)NAMEsasmgr - utility to manage HP-UX Serial Attached SCSI (SAS) Mass Stor‐
age I/O cards / HBAs
SYNOPSIS
lun_dsf}
phy_id}
phy_id}
sasaddr}
rvol_id |
lun_dsf}
lun_dsf}
phy_id}
phy_id}
offset}
sasaddr}
phy_id}
phy_id}
sasaddr}
DESCRIPTION
is a common diagnostic tool used for all Serial Attached SCSI (SAS) I/O
cards / Host Bus Adapters (HBAs). requires the use of a device file to
indicate the interface over which the requested command needs to be
performed.
Options
recognizes the following command-line options:
Suppresses the warning messages and continues executing the com‐
mand.
Provides a brief description of what the command does.
Displays information for persistent device files
(see intro(7)). If the command also displays hardware
path information, then it shows the hardware path corre‐
sponding to the persistent device file. For example, if
you use this option with the command and the and quali‐
fiers, will print information for the persistent device
files and display the corresponding lun hardware paths.
Describes the command's qualifiers.
A command is defined by a set of qualifiers which must be
specified after the command name. Each qualifier is pro‐
ceeded by the option. Some qualifiers can take one or
more values and are given as ={x | y} where quali‐
fier_name can take either the value x or y.
Provides verbose information.
For example, if you use this option with the command and
qualifiers and will print additional header information.
Commands
recognizes the following commands. A command is defined by a set of
qualifiers. Qualifiers are specified with the option. All keywords
are case-sensitive.
One of the following sets of qualifiers must be specified with
the
command:
This
set
of
qual‐
i‐
fiers
is
used
to
cre‐
ate
a
RAID
vol‐
ume
with
the spec‐
i‐
fied
RAID
level,
vol‐
ume
size
and
phys‐
i‐
cal
disks.
The
value
spec‐
i‐
fied
for
the
qual‐
i‐
fier
deter‐
mines
the
RAID
level
for
the
vol‐
ume.
For
exam‐
ple,
spec‐
i‐
fies
that
a
RAID1
vol‐
ume
should
be
cre‐
ated.
The
qual‐
i‐
fier
defines
or
spec‐
i‐
fies
the
enclo‐
sure
and
bay
of
each
phys‐
i‐
cal
disk
of
the
RAID
vol‐
ume.
If
the
phys‐
i‐
cal
disks
in
a
RAID
vol‐
ume
are
dif‐
fer‐
ent
sizes,
then
some
disk
space
will
be
wasted.
Vol‐
ume
expan‐
sion
is
not
sup‐
ported;
once
a
vol‐
ume
has
been
cre‐
ated,
its
size
can‐
not
be
increased.
If
the
qual‐
i‐
fier
is
not
spec‐
i‐
fied,
then
the
vol‐
ume
is
cre‐
ated
with
a
max‐
i‐
mum
pos‐
si‐
ble
size
based
on
the
size
of
the
phys‐
i‐
cal
disks
spec‐
i‐
fied.
If
the
qual‐
i‐
fier
is
not
spec‐
i‐
fied,
then
the
default
of
20%
will
be
used
for
the
vol‐
ume.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
and
exe‐
cutes
the
com‐
mand.
This
com‐
mand
requires
supe‐
ruser
priv‐
i‐
leges.
Refer
to
the
sec‐
tion
below.
This
set
of
qual‐
i‐
fiers
is
used
to
add
a
global
spare
disk. The
global
spare
disk
is
used
when‐
ever
a
phys‐
i‐
cal
disk
in
any
RAID
vol‐
ume
on
the
Core
I/O
card
/
HBA
fails.
The
qual‐
i‐
fier
defines
or
spec‐
i‐
fies
the
enclo‐
sure
and
bay
of
the
global
spare
disk.
The
size
of
the
disk
spec‐
i‐
fied
should
be
greater
than
the
size
of
at
least
one
of
the
phys‐
i‐
cal
disks
in
the
vol‐
ume.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
This
com‐
mand
requires
supe‐
ruser
priv‐
i‐
leges.
Refer
to
the
sec‐
tion
below.
The
fol‐
low‐
ing
qual‐
i‐
fier
must
be
spec‐
i‐
fied
with
the com‐
mand:
Resets
the
spec‐
i‐
fied
tar‐
get
device.
This
is
a
destruc‐
tive
oper‐
a‐
tion.
If
the
option
is
not
spec‐
i‐
fied
with
this
com‐
mand,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
When
the com‐
mand
is
run
with‐
out
qual‐
i‐
fiers,
it
clears
sta‐
tis‐
tics
of
the
SAS
I/O
card
/
HBA
rep‐
re‐
sented
by
device_file.
The
fol‐
low‐
ing
qual‐
i‐
fiers
are
spec‐
i‐
fied
with
the
com‐
mand:
Clears
all
sta‐
tis‐
tics
for
the
SAS
I/O
card
/
HBA,
all
PHYs,
all
ports, and
all
tar‐
gets.
Clears
sta‐
tis‐
tics
for
all
PHYs
or
a
spe‐
cific
PHY.
Clears
sta‐
tis‐
tics
for
a
port
to
which
the
spec‐
i‐
fied PHY
belongs
to
or
clears
sta‐
tis‐
tics
for
all
ports.
Clears
sta‐
tis‐
tics
for
a
spe‐
cific
tar‐
get
or
all
tar‐
gets.
One
of
the
fol‐
low‐
ing
sets
of
qual‐
i‐
fiers
must
be
spec‐
i‐
fied
with
the com‐
mand:
This
set
of
qual‐
i‐
fiers
is
used
to
delete
the
RAID
vol‐
ume
given
by the
vol‐
ume
ID.
The
vol‐
ume
ID
can
be
obtained
from
the
com‐
mand
using
the
qual‐
i‐
fier.
If
a
vol‐
ume
ID
of
is
spec‐
i‐
fied,
then
all
the
RAID
vol‐
umes
will
be
deleted.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
This
com‐
mand
requires
supe‐
ruser
priv‐
i‐
leges.
Refer
to
the
sec‐
tion
below.
This
set
of
qual‐
i‐
fiers
is
used
to
delete
the Core
I/O
card
/
HBA
spare
disk.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
This
com‐
mand
requires
supe‐
ruser
priv‐
i‐
leges.
Refer
to
the
sec‐
tion
below.
Dis‐
ables
the
SAS
I/O
card
/
HBA. This
is
a
destruc‐
tive
oper‐
a‐
tion.
The
SAS
I/O
card
/
HBA
will
become
off‐
line,
all
cur‐
rent
I/Os
will
be
aborted,
and
new
I/Os
will
fail.
An
enable
oper‐
a‐
tion
must
be
per‐
formed
in
order
to
bring
the
SAS
I/O
card
/
HBA
back
online.
If
the
option
is
not
spec‐
i‐
fied
with
this
com‐
mand,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
The
fol‐
low‐
ing
qual‐
i‐
fiers
must
be
spec‐
i‐
fied
with
the com‐
mand:
Updates
the
firmware
on
a
SAS
disk.
The
com‐
mand
will
update
disk
firmware
for
reg‐
u‐
lar
phys‐
i‐
cal
disks,
as
well
as
those
that
are
part
of
a
RAID
vol‐
ume.
The
qual‐
i‐
fier
takes
the
name
of
the
file
con‐
tain‐
ing
the
new
disk
firmware.
The
qual‐
i‐
fier
takes
the
enclo‐
sure
and
bay
of
the
disk
for
which
the
firmware
update
is
to
be
done.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
Updates
the
firmware
on
the
spec‐
i‐
fied
enclo‐
sure.
The
qual‐
i‐
fier
takes
the
name
of
the
file
con‐
tain‐
ing
the
new
firmware.
The
qual‐
i‐
fier
takes
the
enclo‐
sure
device
file
for
which
the
firmware
update
is
to
be
done.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
Updates
the
firmware
on
the
spec‐
i‐
fied
HBA.
The
qual‐
i‐
fier
takes
the
name
of
the
file
con‐
tain‐
ing
the
new
firmware.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing
the
com‐
mand.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
This
com‐
mand
requires
supe‐
ruser
priv‐
i‐
leges.
Refer
to
the
sec‐
tion
below.
NOTE:
If
the
firmware
is
being
down‐
graded
to
a
lower
ver‐
sion,
an
incom‐
pat‐
i‐
ble
older
ver‐
sion
of
the
firmware
may
get
rejected.
This
typ‐
i‐
cally
hap‐
pens
if
the
down‐
graded
ver‐
sion
of
firmware
is
very
old
com‐
pared
to
the
cur‐
rent
one
on
the
card.
Enables
the
SAS
I/O
card
/
HBA
and
brings
it
back
online.
This
com‐
mand
causes
the
driver
to
ini‐
tial‐
ize
the
SAS
I/O
card
/
HBA.
When
the com‐
mand
is
run
with‐
out
qual‐
i‐
fiers,
it
returns
infor‐
ma‐
tion
about
the
SAS
I/O
card
/
HBA
rep‐
re‐
sented
by
device_file.
The
fol‐
low‐
ing
qual‐
i‐
fiers
are
spec‐
i‐
fied
with
the
com‐
mand:
Shows
hard‐
ware
path
and
SAS
address
infor‐
ma‐
tion
for
a
spe‐
cific
lun
or
all
luns.
If
the
option
and
the
qual‐
i‐
fier
are
spec‐
i‐
fied
with
this
com‐
mand,
then
it
dis‐
plays
per‐
sis‐
tent
device
file
infor‐
ma‐
tion.
Shows
lun
loca‐
tion
infor‐
ma‐
tion
for
the
lun
spec‐
i‐
fied
with
the qual‐
i‐
fier.
If
the
option
and
the
qual‐
i‐
fier
are
spec‐
i‐
fied
with
this
com‐
mand,
then
it
dis‐
plays
per‐
sis‐
tent
device
file
infor‐
ma‐
tion
with
the
lun
loca‐
tion
infor‐
ma‐
tion.
Shows
PCI
ID
infor‐
ma‐
tion
for
the
SAS
I/O
card
/
HBA.
Shows
infor‐
ma‐
tion
about
all
PHYs
or
a
spe‐
cific
PHY.
Shows
infor‐
ma‐
tion
about
a
port
to
which
the
spec‐
i‐
fied
PHY
belongs
or
pro‐
vides
infor‐
ma‐
tion
about
all
ports.
Shows
RAID
con‐
fig‐
u‐
ra‐
tion
infor‐
ma‐
tion
for
the
Core
I/O
card
/
HBA. If
the
option
is
spec‐
i‐
fied
with
this
com‐
mand,
then
it
dis‐
plays
per‐
sis‐
tent
device
file
infor‐
ma‐
tion.
Dis‐
plays
the
con‐
tents
of
a
spe‐
cific
PCI
con‐
fig
space
or
MMIO reg‐
is‐
ter
or
all
PCI
con‐
fig
spa‐
ces
or
MMIO
reg‐
is‐
ters.
PCI
con‐
fig
space
or
MMIO
reg‐
is‐
ter
type
is
spec‐
i‐
fied
with
the
qual‐
i‐
fier.
If
is
not
spec‐
i‐
fied,
then
the
com‐
mand
assumes
a
default
reg‐
is‐
ter
type
of
MMIO.
Issues
a
SMP
com‐
mand. The
file_name
must
con‐
tain
the
SMP
request
frame.
Shows
the
SMP
ini‐
tia‐
tor
SAS
address
to
send
SMP
requests.
Shows
infor‐
ma‐
tion
about
a
spe‐
cific
tar‐
get
or
all
tar‐
gets.
Shows
vital
prod‐
uct
data
infor‐
ma‐
tion
for
the
SAS
I/O
card
/
HBA.
When
the com‐
mand
is
run
with‐
out
qual‐
i‐
fiers,
it
shows
sta‐
tis‐
tics
about
the
SAS
I/O
card
/
HBA
rep‐
re‐
sented
by
device_file.
The
fol‐
low‐
ing
qual‐
i‐
fiers
are
spec‐
i‐
fied
with
the
com‐
mand:
Shows
sta‐
tis‐
tics
for
all
PHYs
or
a
spe‐
cific
PHY.
Shows
sta‐
tis‐
tics
for
a
port
to
which
the
spec‐
i‐
fied PHY
belongs
to
or
pro‐
vides
sta‐
tis‐
tics
for
all
ports.
Shows
sta‐
tis‐
tics
for
a
spe‐
cific
tar‐
get
or
all
tar‐
gets.
The
fol‐
low‐
ing
qual‐
i‐
fiers
must
be
spec‐
i‐
fied
with
the com‐
mand:
Allows
the lun_dsf
spec‐
i‐
fied
with
to
be
asso‐
ci‐
ated
with
a
new
SAS
tar‐
get,
which
is
spec‐
i‐
fied
with
the
qual‐
i‐
fier.
The
lun_dsf
must
be
the
legacy
device
file
and
the
new_hw_path
must
be
the
legacy
hard‐
ware
path.
This
com‐
mand
does
not
allow
a
per‐
sis‐
tent
device
file
or
the
new
style
hard‐
ware
path
to
be
spec‐
i‐
fied
with
the
and
qual‐
i‐
fiers.
For
per‐
sis‐
tent
device
files,
please
use
the
com‐
mand.
See
io_re‐
di‐
rect_dsf(1M)
for
more
infor‐
ma‐
tion.
This
com‐
mand
is
typ‐
i‐
cally
intended
for
replac‐
ing
a
bad
drive.
This
oper‐
a‐
tion
must
not
be
used
while
there
are
out‐
stand‐
ing
I/O
requests
to
the
lun_dsf
or
to
any
LUNs
under
the
new_hw_path.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
pro‐
ceed‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
Allows
the lun_dsf
spec‐
i‐
fied
with
to
be
asso‐
ci‐
ated
with
a
new
SAS
tar‐
get,
which
is
spec‐
i‐
fied
with
the
qual‐
i‐
fier.
The
lun_dsf
must
be
the
legacy
device
file.
This
com‐
mand
does
not
allow
per‐
sis‐
tent
device
files
to
be
spec‐
i‐
fied
with
the
and
qual‐
i‐
fiers.
For
per‐
sis‐
tent
device
files,
please
use
the
com‐
mand.
See
io_re‐
di‐
rect_dsf(1M)
for
more
infor‐
ma‐
tion.
This
com‐
mand
is
typ‐
i‐
cally
intended
for
replac‐
ing
a
bad
drive.
This
oper‐
a‐
tion
must
not
be
used
while
there
are
out‐
stand‐
ing
I/O
requests
to
the
new
lun_dsf.
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
pro‐
ceed‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
Allows
the
HW
path
spec‐
i‐
fied
with to
be
asso‐
ci‐
ated
with
a
new
SAS
tar‐
get,
which
is
spec‐
i‐
fied
with
the
qual‐
i‐
fier.
The
and
the
must
be
the
legacy
hard‐
ware
paths.
This
com‐
mand
does
not
allow
the
new
style
hard‐
ware
paths
to
be
spec‐
i‐
fied
with
the
and
qual‐
i‐
fiers.
For
per‐
sis‐
tent
lun
hard‐
ware
paths,
please
use
the
com‐
mand.
See
io_re‐
di‐
rect_dsf(1M)
for
more
infor‐
ma‐
tion.
This
com‐
mand
is
typ‐
i‐
cally
intended
for
replac‐
ing
a
bad
drive.
This
oper‐
a‐
tion
must
not
be
used
while
there
are
out‐
stand‐
ing
I/O
requests
to
any
LUNs
under
the
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
pro‐
ceed‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
Resets
the
SAS
I/O
card
/
HBA
and
per‐
forms
a
com‐
plete
re-
ini‐
tial‐
iza‐
tion. This
is
a
destruc‐
tive
oper‐
a‐
tion.
Some
I/Os
can
be
aborted
by
this
com‐
mand.
If
the
option
is
not
spec‐
i‐
fied
with
this
com‐
mand,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
con‐
tin‐
u‐
ing.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
exe‐
cutes
the
com‐
mand.
One
of
the
fol‐
low‐
ing
sets
of
qual‐
i‐
fiers
must
be
spec‐
i‐
fied
with
the com‐
mand:
This
set
of
qual‐
i‐
fiers
is
used
to
turn
on
or
off
the
locate LED
for
the
spec‐
i‐
fied
lun.
If
it
is
a
RAID
device
lun,
then
this
com‐
mand
turns
on
or
off
the
LOCATE
LED
for
all
the
phys‐
i‐
cal
disks
that
are
part
of
the
RAID
vol‐
ume.
This
set
of
qual‐
i‐
fiers
is
used
to
change
the
state of
the
vol‐
ume
based
on
the
value
spec‐
i‐
fied
by
the
qual‐
i‐
fier
and
the
vol‐
ume
spec‐
i‐
fied
by
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
pro‐
ceed‐
ing
with
the
oper‐
a‐
tion.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
This
set
of
qual‐
i‐
fiers
is
used
to
change
the
rebuild
rate
of
the
vol‐
ume
spec‐
i‐
fied
by
based
on
the
rate
spec‐
i‐
fied
by
the
If
the
option
is
not
spec‐
i‐
fied,
dis‐
plays
a
warn‐
ing
mes‐
sage
before
pro‐
ceed‐
ing
with
the
oper‐
a‐
tion.
Oth‐
er‐
wise,
it
sup‐
presses
the
warn‐
ing
mes‐
sage
and
con‐
tin‐
ues
exe‐
cut‐
ing
the
com‐
mand.
Secu‐
rity
Restric‐
tions
requires
either
supe‐
ruser
priv‐
i‐
lege
or
and
priv‐
i‐
leges
for
RAID
con‐
fig‐
u‐
ra‐
tions.
See
priv‐
i‐
leges(5)
for
more
infor‐
ma‐
tion
about
priv‐
i‐
leged
access
on
sys‐
tems
that
sup‐
port
fine-
grained
priv‐
i‐
leges.
EXAM‐
PLES
Dis‐
play
all
PHY
sta‐
tis‐
tics
of
the
SAS
I/O
card
/
HBA
whose
device
file
is
Dis‐
play
all
RAID
vol‐
ume
infor‐
ma‐
tion
of
the
Core
I/O
card
/
HBA
whose
device
file
is
Clear
sta‐
tis‐
tics
for
a
port
with
PHY
ID
1
of
the
SAS
I/O
card
/
HBA
whose
device
file
is
Force‐
fully
issue
dis‐
able
request
to
the
SAS
I/O
card
/
HBA
whose
device
file
is
Add
a
RAID
vol‐
ume
with
size
34000
(MB),
level
1
(RAID1),
and
enc_bay
1:4,1:5
to
the
Core
I/O
card
/
HBA
whose
device
file
is
Add
a
spare
disk
to
the
Core
I/O
card
/
HBA
whose
device
file
is
Delete
a
RAID
vol‐
ume
with
vol‐
ume
ID
4
to
the
Core
I/O
card
/
HBA
whose
device
file
is
Delete
the
Core
I/O
card
/
HBA
Spare
on
the
HBA
whose
device
file
is
Change
the
state
to
ACTIVE
for
the
RAID
vol‐
ume
with
vol‐
ume
id
3.
Change
the
rebuild
rate
to
20%
for
the
RAID
vol‐
ume
with
vol‐
ume
id
3.
Update
the
firmware
on
the
spec‐
i‐
fied
HBA.
AUTHOR
was
devel‐
oped
by
HP.
SEE
ALSO
priv‐
i‐
leges(5),
intro(7).
at
sasmgr(1M)