Storage Automated Diagnostic Environment
Diagnostic Guide
6120ofdg | 6120ofdg - tests the functionality of the Sun StorEdge 6120
array
|
6120ondg | 6120ondg - tests the Fibre Channel loops inside and outside
the Sun StorEdge 6120 array.
|
6120volverify | 6120volverify - Runs manual parity checks on Sun StorEdge
6120 array volumes
|
a3500fctest | a3500fctest - verifies functionality of Sun StorEdge A3500FC
disk tray
|
a5ksestest | a5ksestest - tests Sun StorEdge A5000 and A5200 arrays
|
a5ktest | a5ktest - tests the functionality of disks in the Sun
StorEdge A5000 and A5200 array
|
brocadetest | brocadetest - diagnose Brocade Silkworm Fibre Channel
switches
|
checkcron | checkcron - check crontab entries
|
clearcache | clearcache -clears Storage Automated Diagnostic Environment
cache files
|
config_solution | config_solution - creates a configuration snapshot during
the manufacturing and upgrading of Sun StorEdge 3900 and
6900 series and Sun StorEdge 6320 and 6320SL system solu-
tions.
|
d2disktest | d2disktest - tests the functionality of the Internal Sun
StorEdge D2 Array disk
|
daksestest | daksestest - tests Sun Fire V880 FC-AL disk backplanes
|
daktest | daktest - tests the Sun Fire V880 FC-AL disk
|
dex | dex - Device Exerciser for Sun StorEdge arrays
|
discman | discman - discovery manager
|
disk_inquiry | disk_inquiry - disk-only version of the inquiry program
|
disktest | disktest - tests the functionality of fibre channel disks
|
fcdisktest | fcdisktest - tests the functionality of internal fibre chan-
nel disk
|
fctapetest | fctapetest - tests the functionality of Fibre Channel tape
drives
|
ifptest | ifptest - tests functionality of the PCI FC-100 Fibre
Channel-Arbitrated loops (FC-AL) card
|
jnitest | jnitest - tests the functions of the Sun StorEdge 2 Gbyte
PCI Fibre Channel Network Adapter JNI boards.
|
lbf | lbf - A loop back frame diagnostic utility program that
tests Fibre Channel-Arbitrated loops (FC-AL)
|
linktest | linktest - diagnose Sun StorEdge network passive Fibre Chan-
nel components
|
qlctest | qlctest - tests the functions of the Sun StorEdge 1 Gbyte
and 2 Gbyte PCI and cPCI Fibre Channel Network Adapter
boards.
|
ras_admin | ras_admin - command line interface to Storage Automated
Diagnostic Environment
|
ras_discover | ras_discover - discovers devices and updates the configura-
tion file on the slave and the master.
|
ras_install | ras_install - executes the ras_install command to start the
Storage Automated Diagnostic Environment services.
|
ras_patchlist | ras_patchlist - executes PatchPro software and creates a
list of devices and required patches.
|
ras_remote | ras_remote - executes Storage Automated Diagnostic Environ-
ment commands remotely.
|
ras_revcheck | ras_revcheck - checks the software, hardware, and firmware
revision levels.
|
ras_upgrade | ras_upgrade - upgrades a set of devices using PatchPro.
|
rasagent | rasagent - monitors, collects, and reports information about
Sun storage products.
|
sanbox | sanbox - access the SANbox switch diagnostic facilities
|
save_password | save_password - change the Storage Automated Diagnostic
Environment admin password
|
se2_configcheck | se2_configcheck - Verify the configuration of a Sun StorEdge
Solution System
|
se_configcheck | se_configcheck - Verify the configuration of a Sun StorEdge
Solution System
|
snapshot | snapshot - take snapshot of configuration
|
socaltest | socaltest - tests the SOC+ host adapter card
|
stresstest | stresstest - Checks for possible SAN errors.
|
switch2test | switch2test - diagnose Sun StorEdge Network FC switch-8 and
switch-16 2 Gbyte Fibre Channel switches
|
switchtest | switchtest - diagnose Sun StorEdge Network Fibre Channel
switch-8 and switch-16 switches
|
t3ofdg | t3ofdg - tests the functionality of the Sun StorEdge T3
array
|
t3test | t3test - tests the functionality of the Sun StorEdge T3 and
T3+ array LUNs
|
t3volverify | t3volverify - Runs manual parity checks on Sun StorEdge T3
array volumes
|
testt3 | testt3 - retrieve tokens from a Sun StorEdge T3 array
|
vediag | vediag - Runs virtualization engine diagnostics through
SLICD
|
veluntest | veluntest - tests the functionality of the virtualization
engine by accessing the VLUNs.
|
volverify | volverify - Runs manual parity checks on Sun StorEdge T3,
T3+, and 6120 array volumes
|
volverifytest | volverify - Runs manual parity checks on Sun StorEdge T3,
T3+, and 6120 array volumes
|
Maintenance Commands 6120ofdg(1M)
NAME
6120ofdg - tests the functionality of the Sun StorEdge 6120
array
SYNOPSIS
/opt/SUNWstade/Diags/bin/6120ofdg
[ standard-arguments ]
health_check=[enable|disable] fast_test=[enable|disable]
fast_find=[enable|disable] find=[enable|disable]
syslog=[enable|disable] [ dev=6120IP_address ] [
enc_id=enclosure_ID ]
loop=[1|2] [ usr=6120adminusername ] [ passwd=6120admin-
password ]
DESCRIPTION
The 6120ofdg test runs the internal diagnostics of the Sun
StorEdge 6120 array.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
heath_check=enable|disable
Health check runs fast_test multiple times, one time
for each loop per unit. Default is disable.
fast_test=enable|disable
Fast_test performs a fast Go/No Go test of the selected
enclosure and loop. It does not attempt to detect bad
FRUs. Default is disable.
fast_find=enable|disable
fast_find can be used to detect bad loop cards, inter-
connect cables, and controllers. Fast_find does not
try to isolate down to a single disk port. Run
fast_find before find to eliminate loop cards, inter-
connect cables, and controllers as bad FRU(s) before
the midplane or disks are suspected (which are checked
using find). Default is disable.
find=enable|disable
find performs an extensive Go/No Go test. If loop
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands 6120ofdg(1M)
failures are detected, it automatically initiates the
full loop fault isolation diagnostic. The loop fault
diag has the capability to detect and isolate a single
disk port, but is very time-consuming. Default is dis-
able.
syslog=enable|ofdg|disable
Enable will dump all syslog entries, that have been
added while the test is running, to the screen. ofdg
will dump only OFDG lines, added to the syslog, to the
screen. Default is disable.
dev=6120 IP Address
If a host name is set for the device, it can be used as
well.
enc_id=1|2|all
enc_id applies only to Partner groups and specifies
enclosures on which to run test. all will run on
enclosure 1, then on enclosure 2. The default is 1.
loop=1|2|all
Specifies which loop to test. All tests both. Default
is 1.
usr=6120adminusername
Specify login name.
passwd=6120admin Password
Specify Password.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provide affirmative answer to following question:
WARNING - Volume data will be offline while OFDG is
running. Continue ? [N] :
-k Attempt to abort Tests currently running on specified
Sun StorEdge 6120 array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false .
ATTRIBUTES
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands 6120ofdg(1M)
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands 6120ondg(1M)
NAME
6120ondg - tests the Fibre Channel loops inside and outside
the Sun StorEdge 6120 array.
SYNOPSIS
/opt/SUNWstade/Diags/bin/6120ondg
[ standard-arguments ]
[ip_address=ip_address ] | controller=[primary|alternate|all
] |
ilb-10=[enable|disable] | ilb-1=[enable|disable] |
elb=[enable|disable]
controller-sim=[ front|back-A|back-B|all ] | [
userpattern=0x-pattern ]
selectpattern=[user|critical|all] | [ loopsize=0x-pattern ]
[ echosize=0x-pattern ]
[iterations=number ] | [ usr=6120adminusername ] [
passwd=6120admin-password ]
DESCRIPTION
The 6120ondg test tests the functions of the Sun StorEdge
6120 array controller. Each controller has three chips that
run the Fibre Channel loops inside and outside the array.
OPTIONS
ip_address=ip_address
Specifies the Sun StorEdge 6120 array against which to
run the test.
controller=primary|alternate|all
Specifies which controller sim (chip) will run the
test. Default is Primary.
ilb-10=enable|disable
Enables or disables the internal 10-bit test. Performs
internal loopback test within the host adapter ISP
hardware at the 10-bit interface. Default is Enable.
ilb-1=enable|disable
Enables or disables the internal 1-bit test. Performs
internal loopback test within the host adapter ISP
hardware at the 1-bit interface. Default is Enable.
elb=enable|disable
Enables or disables the external loopback test. The
desired data pattern, transfer length, and iteration
count can be selected via the test parameters menu.
Requires a cable for this intervention test. Default
is Disable.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands 6120ondg(1M)
controller-sim=front|back-A|back-B|all
Specifies which controller sim (chip) the test will run
against. Default is Front.
selectpattern=user|critical|all
Choice of pattern to run. critical is the default pat-
tern.
loopsize=0x-pattern
Specifies the payload size for the 6120_echo test. If
this test is run on a front end external loop, the
attached device must support loopback and the specified
payload size. Options range from 16 bytes to 220
bytes. 0xff8 is the default pattern.
echosize=0x-pattern
Specifies the payload size for the 6120_loop test. The
attached device must support Echo and the specified
payload size. Options range from 16 bytes to 65528
bytes. 0xdc is the default pattern.
iterations=number
Sets the number of times to loop the internal 10-bit,
internal 1-bit, and external loopback tests. The
default value is 1000.
number=passcount
Specifies the number of times the test will run.
Options range from 1 to forever.
usr=6120adminusername
Specify login name.
passwd=6120admin Password
Specify Password.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-k Attempt to abort Tests currently running on specified
Sun StorEdge 6120 array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false .
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands 6120ondg(1M)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
brocadetest(1M), linktest(1M), ras_admin(1M),
stresstest(1M), switchtest(1M), switch2test(1M), t3test(1M),
t3ofdg(1M) t3volverify(1M), vediag(1M) veluntest(1M)
6120volverify(1M) 6120ofdg(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
6120volverify (1M) |
[ Top ] |
Maintenance Commands 6120volverify(1M)
NAME
6120volverify - Runs manual parity checks on Sun StorEdge
6120 array volumes
SYNOPSIS
/opt/SUNWstade/Diags/bin/6120volverify
[ standard-arguments ]
dev=6120_Name_or_Address | usr=6120_admin_username |
passwd=6120_admin_password |
volume_name=volume_name | fix_errors=[yes|no] | rate=[1-16]
DESCRIPTION
The 6120volverify test instantiates and monitors a manual
parity check on existing RAID 5 and RAID 1 volumes. The
HTTP token interface of the Sun StorEdge 6120 Array is util-
ized for communication. If the Ethernet connection to the
Sun StorEdge 6120 Array does not exist or is broken,
6120volverify cannot run properly.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=6120_Address
The IP address of the Sun StorEdge 6120 Array. If a
host name is set for the device, the host name can also
be used.
usr=6120_admin_username
Specifies the login name.
passwd=6120_admin_password
Specifies the password for the Sun StorEdge 6120 Array.
volume_name=volume_name
Specifies the existing volume to run against.
fix_errors=yes|no
The fix_errors option corrects parity errors on RAID 5
volumes and corrects mirrored data errors on RAID 1
volumes. If fix_errors is not enabled, then 6120vol-
verify will report errors, but not correct them. If
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands 6120volverify(1M)
the fix_errors option is specified and an error is
detected, the volverify running on the Sun StorEdge
6120 Array will regenerate parity from the existing
data on the volume.
rate=1-16
1 = the fastest, with the greatest performance loss on
the Host I/O. 16 = the slowest, with the least perfor-
mance loss on the Host I/O.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provides an affirmative answer to the following ques-
tion: WARNING - Volume data will be offline while vol-
verify is running. Continue? [N]:
-k Attempts to abort any and all volume operations
currently running on the specified Sun StorEdge 6120
Array. Will not start any volverify operations on the
Sun StorEdge 6120 Array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M), vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands 6120volverify(1M)
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands a3500fctest(1M)
NAME
a3500fctest - verifies functionality of Sun StorEdge A3500FC
disk tray
SYNOPSIS
/opt/SUNWstade/Diags/bin/a3500fctest
[ standard-arguments ] [defaults]
[-o "dev=logical_path] | partition=0-7(mount_point) |
rawsub=[enable | disable] |
rawcover=number_KB | method=[AsyncIO | SyncIO] |
rawiosize=number_KB | wrdevbuf=[enable | disable] |
fstest=[enable | disable] | fssize=number_KB |
fsiosize=number_KB | wrdevbufiterations=number |
selectpattern=[user | all | critical] |
userpattern=0xpattern |
checkrdls=[enable | disable] ]
DESCRIPTION
The a3500fctest test verifies the functionality for the Sun
StorEdge A3500FC disk tray using Media, File System, Asyn-
chronous I/O, and Write/Read Device Buffer subtests.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
a3500fctest -o
"dev=/dev/rdsk/c3t4d2s2|selectpattern=critical"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=logical_path
The name of the device that is returned by discman(1M);
for example, /dev/rdsk/c0t3d0s2
partition=0-7_mount point
Specifies the partition number to test as
partition=6(/export/s6) if mounted on partition 6. The
default is 2.
rawsub=enable|disable
Enables or disables the media subtest.
method=AsyncIO|SyncIO
Specifies the media access method (SyncIO and AsyncIO).
method can be SyncIO, AsyncIO, or SyncIO+AsyncIO. The
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands a3500fctest(1M)
default is SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100 of the
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following values:
2KB|16KB|32KB|64KB|128KB|256KB|512KB
wrdevbuf=enable|disable
Runs the Write/Read Device Buffer subtest.
wrdeviterations=passes_per_pattern
Runs the specified number of passes to the Write/Read
Buffer on the disk. The default is 1000.
fstest=enable|disable
Run file system subtest.
selectpattern=user|critical|all
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
default pattern.
userpattern=0xpattern
Specifies a user-defined pattern for file system test-
ing.
checkrdls=enable|disable
Check read link status counters for errors. The
default is disable.
fssize=file-system-file-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
The default is 512KB.
fsiosize=file-system-transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands a3500fctest(1M)
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands a5ksestest(1M)
NAME
a5ksestest - tests Sun StorEdge A5000 and A5200 arrays
SYNOPSIS
/opt/SUNWstade/Diags/bin/a5ksestest
[ standard-arguments ]
[ -o "dev=ses-path] | disk access=[enable | disable] |
delay=delay-in-seconds | display=[enable | disable]
DESCRIPTION
The a5ksestest test is used to provide configuration verifi-
cation, fault isolation, and repair validation of the Sun
StorEdge A5000 array. a5ksestest tests both Sun StorEdge
A5000 14- and 22-slot disk arrays.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
a5ksestest -o "dev=dev/esses2 f3| disk_access=enable |
delay=30"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=ses-path
The ses-path is the name of a ses device that is in the
enclosure.
delay=delay-in-seconds
Sets the minimum delay (in seconds) between successive
invocations of the test.
disk_access= enable | disable
Enables or disables disk access.
disp= enable | disable
Enables or disables the display of INFO messages
regarding the enclosure status.
Standard Command-Line Arguments
The following is a lis of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands a5ksestest(1M)
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), brocadetest(1M), d2disktest(1M),
daksestest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands a5ktest(1M)
NAME
a5ktest - tests the functionality of disks in the Sun
StorEdge A5000 and A5200 array
SYNOPSIS
/opt/SUNWstade/Diags/bin/a5ktest
[ standard-arguments ]
[-uvelf] | [-o dev=logical-path] | partition=0-7(mount
point) | rawsub=[enable|disable] | rawiosize=number_KB |
rawcover=number | method= [AsyncIO | SyncIO] |
fssize=number_KB | fsiosize=number_KB |
wrdevbufiterations=number | selftest=[enable|disable] |
wrdevbuf=[enable|disable] |
selectpattern=[user|critical|all] |
userpattern=0xpattern | fstest=[enable|disable] |
checkrdls=[enable|disable]
DESCRIPTION
The a5ktest test verifies the functionality of Sun StorEdge
A5xx00 disk tray disks using Media, File System, Asynchro-
nous I/O, Send Diagnostic, and Write/Read Buffer subtests.
An instance of a5ktest will be present for each disk.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
a5ktest -o "dev=dev/rdsk/c3t4d2s2 | selectpattern=critical"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=logical-path
This is the name of the device that is returned by
discman(1M); for example: /dev/rdsk/c0t3d0s2
partition=0-7
Specifies the partition number to test as
partition=6(/export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
wrdevbuf=enable|disable
Runs the device buffer test.
selectpattern=[user|critical|all]
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands a5ktest(1M)
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
default pattern.
userpattern=0xPattern
Used to specify a user-defined pattern.
method=method
Specifies the Media Access Methods (SyncIO and Asyn-
cIO). The valid values for method are: SyncIO, AsyncIO
or SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100 of the
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following:
2KB|16KB|32KB|64KB|128KB|256KB|512KB.
fstest=enable|disable
Enables or disables the file system subtest.
selftest=enable|disable
Specifies running the disk selftest.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
{512KB|2MB|8MB|20MB|100MB|200MB}
fsiosize=transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
{512B|1024B|10KB|40KB|80KB}
checkrdls=enable|disable
Check read link status counters for errors.
wrdevbufiterations=passes-per-pattern
Runs the specified number of each pattern to the
Read/Write Buffer on the disk.
Standard Command-Line Arguments
The following is a lis of the command-line arguments that
can be specified along with the other options.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands a5ktest(1M)
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), brocadetest(1M), d2disktest(1M),
daksestest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands brocadetest(1M)
NAME
brocadetest - diagnose Brocade Silkworm Fibre Channel
switches
SYNOPSIS
/opt/SUNWstade/Diags/bin/brocadetest
[ standard-arguments ]
[-vu] | [-o dev=port:ip_address] | port=port_number |
passwd=switch_password | ip=ip_address | iterations=number
DESCRIPTION
The brocadetest test is delivered with the SUNWstade
software. This test verifies the functionality of the Bro-
cade switch ports.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
brocadetest -v -o "port=5 | ip=10.0.0.1 | passwd=mypassed |
iterations=10000"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=port:ip_address
Specifies the port and ip address of the switch port to
be tested. This option can be replaced with the port=
and ip= options.
port=number
Specifies the port to test. Port numbers start from 0.
There is no default value.
passwd=switch_password
Specifies the password used by the admin user of the
switch. There is no default value.
ip= Specifies the IP address of the switch to be tested.
There is no default value.
Valid switches include the Brocade Silkworm 2400, 2800,
3200, 3800, and 12000 Fibre Channel switch.
iterations=number
Specifies the number of iterations the port test should
run. Default is 1000000.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands brocadetest(1M)
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test-specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), d2disktest(1M), daksestest(1M),
daktest(1M), dex(1M), discman(1M), fcdisktest(1M),
fctapetest(1M), ifptest(1M), lbf(1M), linktest(1M),
qlctest(1M), ras_admin(1M), ras_revcheck(1M) socaltest(1M),
stresstest(1M), switchtest(1M), switch2test(1M), t3ofdg(1M),
t3test(1M), t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands checkcron(1M)
NAME
checkcron - check crontab entries
SYNOPSIS
/opt/SUNWstade/bin/checkcron
DESCRIPTION
checkcron verifies that the Storage Automated Diagnostic
Environment main program is entered in the crontab. You
must be root to run this program.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
config_solution(1M), crontab(1), cron(1M), clearcache(1M),
disk_inquiry(1M), luxadm(1M), rasagent(1M), ras_install(1M),
sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands clearcache(1M)
NAME
clearcache -clears Storage Automated Diagnostic Environment
cache files
SYNOPSIS
/opt/SUNWstade/bin/clearcache
DESCRIPTION
clearcache clears the Storage Automated Diagnostic Environ-
ment cache files that contain the current report for each
device that is being monitored.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l. ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), config_solution(1M),
disk_inquiry(1M), luxadm(1M), rasagent(1M), ras_install(1M),
sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
config_solution (1M) |
[ Top ] |
Maintenance Commands config_solution(1M)
NAME
config_solution - creates a configuration snapshot during
the manufacturing and upgrading of Sun StorEdge 3900 and
6900 series and Sun StorEdge 6320 and 6320SL system solu-
tions.
SYNOPSIS
/opt/SUNWstade/bin/config_solution
[ standard-arguments ]
[ -m=expected_model | -i=ip_prefix | -h=help |
-p=ve_password | -a=Run rasagent ]
DESCRIPTION
The config_solution command is used to create a snapshot of
a Sun StorEdge 3900 and 6900 series and Sun StorEdge 6320
and 6320SL configuration during the manufacturing and
upgrading of the solution devices.
Running config_solution creates the
/var/opt/DATA/Solution.golden file, which lists the model
number of the Sun StorEdge 3900 and 6900 series or Sun
StorEdge 6320 and 6320SL configuration, the date of crea-
tion, the devices, and the device attributes.
OPTIONS
Example:
config_solution-m=6910 -i=123.456.0"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
-h=Help
Display help information.
-i=ip_prefix
Specifies the subnet prefix. The default is ifconfig
for dmfe1.
-m=expected_model
Specifies the specific model of the configuration.
For example: config_solution -m 6910.
Valid options are 3910, 3960, 3900SL, 6910, 6960,
6910SL and 6960SL, 6320, and 6320SL.
-p=ve_password
Specifies the password for the virtualization engine.
-a=run rasagent
SunOS 5.6 Last change: 07 March 2003 1
Maintenance Commands config_solution(1M)
Will run rasagent as part of the script.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 07 March 2003 2
Maintenance Commands d2disktest(1M)
NAME
d2disktest - tests the functionality of the Internal Sun
StorEdge D2 Array disk
SYNOPSIS
/opt/SUNWstade/Diags/bin/fcdisktest
[ standard-arguments ]
dev=RegisterName, | partition=0-7, | rawsub=[ enable|disable
],
rawiosize=size, | rawcover=percentage, | method=method, |
fstest=[ enable|disable ],
fssize=file-system-size, | fsiosize=transfer-size, |
userpattern=data-pattern, |
selftest=[ enable|disable ], | wrdevbuf=[ enable|disable ] ,
|
selectpattern=[ user|critical|all ], |
wrdevbufiterations=passes-per-pattern
DESCRIPTION
The d2disktest test verifies the functionality of Sun
StorEdge internal fibre channel disk using the Media, File
System, Asynchronous I/O, Send Diagnostic and Write/Read
Buffer subtests. An instance of d2disktest will be present
for each internal fibre channel disk.
OPTIONS
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=RegisterName
This is the name of the disk that is returned by
discman(1M).
partition=0-7
Specifies the partition number to test as
partition=6(/Export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
selftest=enable|disable
Runs the specified disks internal diagnostics if any
are available.
wrdevbuf=enable|disable
Enable the write read device buffer test.
selectpattern=user|critical|allpattern
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands d2disktest(1M)
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
default pattern.
wrdevbufiterations=passes-per-pattern
Runs the specified number of each pattern to the
Write/Read Buffer on the disk.
method=method
Specifies the Media Test Methods (SyncIO and AsyncIO).
The valid values for method are: SyncIO, AsyncIO, or
SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100% of the
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following:
2KB|6KB|32KB|64KB|128KB|256KB|512KB.
fstest=enable|disable
Enables or disables the file system subtest.
userpattern=data-pattern
Specifies a specific pattern for file system testing.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified, along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands d2disktest(1M)
-l Runs the test in Online Functional mode. This is the
same mode as tests run when executed with the
vtsui.online command. It is a non-intrusive version
that doesn't significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
daksestest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands daksestest(1M)
NAME
daksestest - tests Sun Fire V880 FC-AL disk backplanes
SYNOPSIS
/opt/SUNWstade/Diags/bin/daksestest
[ standard-arguments ]
dev=ses-path, | test_ses_path=[ enable|disable ], |
test_i2c_path=[ enable|disable ], | lb=[ enable|disable ], |
fwtest=enable|disable
DESCRIPTION
The daksestest tests the Sun Fire V880 FC-AL disk backplane.
The daksestest verifies the operation of the embedded SES
controller and the disk enclosure system of the Sun Fire 880
workgroup server. tests both Sun StorEdge A5x00 14- and
22-slot disk arrays.
OPTIONS
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=ses-path
The ses-path is the name of the ses device that is
returned by discman(1M).
test_ses_path=enable|disable
Tests the device over the Fibre Channel interface.
test_i2c_path=enable|disable
Tests over the I2C interface.
lb=enable|disable
When enabled, the subtest causes the SES device to loop
a packet around the fibre bus with varying data pat-
terns. The device reads the packet after the packet is
received, and verifies that the data payload is
correct.
fwtest=enable|disable
When enabled, this subtest runs the system friendly
embedded firmware tests on the SES/SSC100 device.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands daksestest(1M)
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands daktest(1M)
NAME
daktest - tests the Sun Fire V880 FC-AL disk
SYNOPSIS
/opt/SUNWstade/Diags/bin/daktest
[ standard-arguments ]
dev=logical-path, | partition=0-7, | rawsub=[ enable|disable
], |
rawiosize=size, | rawcover=percentage, | method=method, |
fssize=file-system-size, |
fsiosize=transfer-size, | wrdevbufiterations=passes-per-
pattern, |
selftest=[ enable|disable ], wrdevbuf=[ enable|disable ], |
selectpattern=[ user|critical|all ], userpattern=0xPattern,
|
fstest=[ enable|disable ], | checkrdls=[ enable|disable ]
DESCRIPTION
The daktest test verifies the functionality of the Internal
Fibre Channel disk using five subtests: Media, File System,
Asynchronous I/O, Write/Read Buffer, and Self Test. The file
system subtest can only be run if the selected partition is
mounted. An instance of daktest is present for each inter-
nal Fibre Channel disk.
OPTIONS
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=logical-path
This is the name of the device that is returned by
discman(1M).
partition=0-7
Specifies the partition number to test as
partition=6(/export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
wrdevbuf=enable|disable
Enable the write read device buffer test.
selectpattern=user|critical|all
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands daktest(1M)
default pattern.
userpattern=0xPattern
Used to specify a specific pattern.
method=method
Specifies the Media Test Methods (SyncIO and AsyncIO).
The valid values for method are: SyncIO, AsyncIO or
SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100 of the
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following:
2KB|16KB|32KB|64KB|128KB|256KB|512KB.
fstest=enable|disable
Enables or disables the file system subtest.
selftest=enable|disable
Specifies running the selftest.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
checkrdls=enable|disable
Monitor read link status counters for errors.
wrdevbufiterations=passes-per-pattern
Runs the specified number of each pattern to the
Read/Write Buffer on the disk.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified, along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands daktest(1M)
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands dex(1M)
NAME
dex - Device Exerciser for Sun StorEdge arrays
SYNOPSIS
dex [-v] [-testinfo range iterations time] [-options] [-pattern] devices
DESCRIPTION
The dex program generates I/O transactions to a device. The
command line options allow you to specify:
+o Test information including the type of test, test-related
flags, and the number of I/O transactions per pass
+o The range across the media to test
+o The number of passes to run
+o The type of I/O transaction
+o Whether to stop after a certain number of errors or an
elapsed time frame
+o The data pattern used during testing
You can use dex to exercise disk drives, tape drives, file
systems, and memory.
OPTIONS
The following options may be used on the command
line:
-r read
-w write
-wr write and read
-rw read and write
-w/r write then read
-help Display help information. This option is used
alone on the command line to display the other
options.
-x [xfersize]
Specifies the size of each I/O transaction. Small
I/O sizes cause many transactions to queue. Large
I/O sizes are used to test buffering (see USAGE).
The following sizes are valid:
g Gigabytes (Gbytes)
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands dex(1M)
m Megabytes (Mbytes)
k Kilobytes (Kbytes)
b Blocks. A block is 512 bytes. To specify a
size in bytes, omit the b from the command
line. For example, -x 32b specifies 32 blocks
and -x 32 specifies 32 bytes.
-m [maxphyssize]
Specifies the maximum transfer size for asynchro-
nous I/O transfers greater than 128 Kbytes. The
default size is bytes. The following additional
sizes are valid:
g Gigabytes
m Megabytes
k Kilobytes
-o [xferoffset]
Specifies the transfer offset in blocks.
-p [processes]
Specifies the number of processes to run to the
same device. Each process performs its own burst
of I/O transactions.
-e [error-limit compare-error-limit]
Specifies the error limit and compare error limit
values. Enter a space between the two values.
Enter 0 to specify no limit. The error limit indi-
cates the number of errors that must occur before
stopping. The compare error limit indicates the
number of compare errors that are treated as a
single error. For example, -e 10 5 means stop
after ten errors, but treat five compare errors as
a single error.
-eh Halt on error.
-eb kadb trap on error.
-s [I/O-delay pass-delay process-start-delay]
Specifies the I/O, pass, and process start delay
times. Use a space between the three values. Enter
0 to specify no delay. For example, -s 1s 3s 1m
specifies that the I/O delay is one second, the
pass delay is three seconds, and the process start
delay is one minute. This means that there is a
one second delay between I/O transactions, a three
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands dex(1M)
second delay between bursts, and a one minute
delay before the first burst if initiated. The
following time values are accepted:
s Seconds
m Minutes
h Hours
-i [increment cluster-increment]
Specifies the increment between I/O transactions
and the cluster increment between I/O bursts. The
cluster increment is used with the -B and -C
tests.
-a [buffer-alignment]
Specifies the starting buffer boundary. This is
option is used for HBA testing.
-f [tape file position]
Specifies the absolute file position.
-v Verbose. This option displays additional output
and is normally listed first on the command line.
-d Debug. Runs the test in debug mode.
PARAMETERS
testinfo Specifies the following test-related parameters:
Test Flags Burst. Enter them in the order given
without delimiting spaces.
Test Specifies one of the following tests:
Sequential Tests
-S Sequential
-SR Sequential Reverse
-M Mmap
-MR Mmap Sequential Reverse
-LS Low-Power Sequential
-C Cluster
-X Transfer
Seek Tests
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands dex(1M)
-R Random
-RV Video
-B Burst Random
-N Mmap Random
-L Low-Power Seek
-LB Low-Power Butterfly
-LR Low-Power Reverse Butterfly
-A Actuator
-AB Actuator Butterfly
-AR Actuator Reverse Butterfly
Tape Tests
-T Tape Sequential
-V Variable
-J Low-Power Sequential
Flags Specifies one of the following optional
flags:
I Initialize the device before
beginning the first pass.
C Open and close the device once
for each pass. Open before the
pass and close after the I/O
transactions have completed.
P Preload. This flag is for Mmap
tests only.
N Normal. This flag is for Mmap
tests only.
Burst Specifies the number of I/O transactions
per pass. If no value is specified, the
default is eight for the S test and six-
teen for the R test.
SunOS 5.6 Last change: 20 December 2002 4
Maintenance Commands dex(1M)
Enter a space between each of the following parameters:
range Specifies the range across the media to test. If
no size is specified, the parameter defaults to
bytes. One of the following range sizes may be
entered:
g Gigabytes
m Megabytes
k Kilobytes
b Blocks
% Specifies a percentage. For example: 90%
iterations
Specifies the number of passes or number of times
to issue the burst of I/Os. If you enter zero, the
number of passes is unlimited.
time Specifies the test execution time. If you omit
this parameter, there is no time limit on testing.
This parameter may be used with or without the
iterations parameter. The following time values
are accepted:
h hours
m minutes
s seconds
pattern Specifies the data pattern used during testing.
The pattern can be specified in hex (-P
0x7e7ebdff) or decimal (-P 255). Patterns that do
not fill 32 bits are prepended with zeros. For
example, 0x55ff becomes 0x000055ff. The following
standard patterns are available:
-P Header ID pattern
-P0 Header ID pattern
-P1 Block ID pattern
-P2 Incrementing Block ID pattern
-P3 Random pattern
-P4 MFM pattern
SunOS 5.6 Last change: 20 December 2002 5
Maintenance Commands dex(1M)
-P5 8-bit Cable pattern
-P6 16-bit Cable pattern
-P7 8-bit Xtalk pattern
-P8 16-bit Xtalk pattern
devices Specifies the device under test.
USAGE
Use the following command line to display the available
options:
dex -help
The system may split large buffers into smaller sizes. To
use sizes above 128 Kbytes, use the -S or -R test with the
-p option to increase the load by increasing the number of
processes per device.
When using dex to exercise a file instead of a device, the
-M (Memory Mapped I/O) test is recommended. Use the I flag
to initialize or increase the file size before testing is
started. For example, the following command line runs the
Memory Mapped I/O test on the specified file (filename). The
file is first initialized and the test performs write then
read operations across 32 Kbytes for five passes or one
minute. Each pass performs eight I/O operations with a one
block transfer size (one block is 512 bytes).
dex -MI8 32k 5 1m -x 1b -wr filename
Transfer size= 512 Bytes
Range= 32 Kbytes
Number of I/O's per process= 8
Mapped Sequential Write-Read Test, 5 Passes for 1 min.
Growing file to 32 Kbytes from 0...
Loading test pattern...done
Pass 0, Errors 0, Elapsed time= 0 sec.
EXAMPLES
The following are command line examples:
o Run the Random test on the specified device:
dex -R /dev/rdsk/c1t0d0s6
o Run the Sequential test, write only, across 100 Mbytes on
the specified device. The test performs eight I/O tran-
sactions per pass.
SunOS 5.6 Last change: 20 December 2002 6
Maintenance Commands dex(1M)
dex -S8 100m -w /dev/rdsk/c1t2d0s6
o Run the Sequential test, read then write, across four
Gbytes
on the specified device. The test performs eight I/O
transactions per pass.
dex -S8 4g -rw /dev/rdsk/c1t3d0s2
o Run the Sequential test across eight Gbytes on the speci-
fied device.
The test performs four I/O transactions per pass for
twenty passes.
dex -S4 8g 20 device
o Run the Sequential test across eight Gbytes on the speci-
fied device
for 20 passes or 60 minutes, whichever comes first. Four
I/O transactions
are performed per pass.
dex -S4 8g 20 60m device
o Run the Random test across 50% of the media for an unlim-
ited number
of passes or until two hours have passed. The test per-
forms ten I/O
transactions per pass.
dex -R10 50% 0 2h device
o Run the Sequential test in verbose mode across four
Gbytes of media.
Each pass performs four I/O transactions.
dex -v -S4 4g device
o Run the Sequential test, read only, across eight Gbytes
of media
for 20 passes or 40 minutes, whichever comes first. The
test performs
four I/O transactions per pass.
dex -S4 8g 20 40m -r device
o Run the Sequential test, read only, in verbose mode
across eight
Gbytes of media for an unlimited number of passes or
until 60
minutes have passed. The test will stop after 1000
errors. The
SunOS 5.6 Last change: 20 December 2002 7
Maintenance Commands dex(1M)
test performs one I/O transaction per pass. The data
transfers are
128 Kilobytes and there is a three-second delay between
passes.
dex -v -S1 8g 0 60m -x 128k -r -e 1000 -s 0 3s 0
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 8
Maintenance Commands discman(1M)
NAME
discman - discovery manager
SYNOPSIS
/opt/SUNWstade/Diags/bin/discman
DESCRIPTION
The discman test displays the system configuration informa-
tion. It attempts to give a text output of how storage is
connected to a UNIX host. It is used by the Storage
Automated Diagnostic Environment to draw the topology of the
system. The information that the Storage Automated Diagnos-
tic Environment gathers from the output of discman is com-
bined with other discovery modules to draw a complete topol-
ogy view of the system.
OPTIONS
There are no options for discman.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a3500fctest(1M), a5ksestest(1M), a5ktest(1M),
brocadetest(1M), d2disktest(1M), daksestest(1M),
daktest(1M), dex(1M), fcdisktest(1M), fctapetest(1M),
ifptest(1M), lbf(1M), linktest(1M), qlctest(1M),
ras_admin(1M), ras_fccheck(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
disk_inquiry (1M) |
[ Top ] |
Maintenance Commands disk_inquiry(1M)
NAME
disk_inquiry - disk-only version of the inquiry program
SYNOPSIS
/opt/SUNWstade/bin/disk_inquiry [-p][-P][-g][-t][-l logfile
][devices] [-d][-q]
DESCRIPTION
The disk_inquiry program runs a scsi_inquiry on each disk
and provides a listing that includes the disk firmware lev-
els.
OPTIONS
The following options are supported:
devices Specify specific devices to query in the format
/dev/rdsk/*.
-d Enable dual port detection.
-g Enable growth defect list display.
-l Log data into the specified logfile.
-p Print the name of the physical device formatted.
-P Print the name of the physical device in long format.
-q Enable quiet printing with no headers displayed.
-t Read thermal values from heads 0-8.
EXAMPLE
The following example shows the output from the disk_inquiry
command.
# disk_inquiry
AVAILABLE SCSI DEVICES:
crp-1 crp-1 crp-1 crp-1 crp-1
r l r r r .
Device Vendor Product Rev Serial Number
0:c0t2d0 SEAGATE ST32171W SUN2.1G 7462 9711793014
1:c0t3d0 SEAGATE ST32171W SUN2.1G 7462 9712812904
2:c1t0d0 SEAGATE ST19171FCSUN9.0G 1178 9735J28021
3:c1t1d0 SEAGATE ST19171FCSUN9.0G 1178 9725B61900
4:c1t2d0 SEAGATE ST19171FCSUN9.0G 1178 9715709389
5:c1t3d0 SEAGATE ST19171FCSUN9.0G 1178 9725B60684
6:c1t4d0 SEAGATE ST19171FCSUN9.0G 1178 9725B62651
7:c1t5d0 SEAGATE ST19171FCSUN9.0G 1178 9725B71152
8:c1t6d0 SEAGATE ST19171FCSUN9.0G 1178 9715709382
9:c1t16d0 SEAGATE ST19171FCSUN9.0G 1178 9725B70578
10:c1t17d0 SEAGATE ST19171FCSUN9.0G 1178 9725B71724
11:c1t18d0 SEAGATE ST19171FCSUN9.0G 1178 9725B61975
12:c1t19d0 SEAGATE ST19171FCSUN9.0G 1178 9725B71012
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands disk_inquiry(1M)
13:c1t20d0 SEAGATE ST19171FCSUN9.0G 1178 9725B72636
14:c1t21d0 SEAGATE ST19171FCSUN9.0G 1178 9725B62749
15:c1t22d0 SEAGATE ST19171FCSUN9.0G 1178 9725B61533
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), luxadm(1M), rasagent(1M),
ras_install(1M), sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands disktest(1M)
NAME
disktest - tests the functionality of fibre channel disks
SYNOPSIS
/opt/SUNWstade/Diags/bin/disktest
[ standard-arguments ]
dev=logical-path, | partition=0-7, |
rawsub=[ enable|disable ], |
rawiosize=size, | rawcover=percentage, | method=method, |
fstest=[ enable|disable ], | fssize=file-system-size, |
fsiosize=transfer-size, | userpattern=data-pattern, |
selectpattern=[ user|critical|all ]
DESCRIPTION
The disktest test verifies the functionality of Sun StorEdge
fibre channel disks using the Media, File System and Asyn-
chronous I/O subtests. An instance of disktest will be
present for each internal fibre channel disk.
OPTIONS
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=logical-path
This is the name of the disk that is returned by luxadm
probe.
partition=0-7
Specifies the partition number to test as
partition=6(/Export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
selectpattern=user|critical|allpattern
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
default pattern.
method=method
Specifies the Media Test Methods (SyncIO and AsyncIO).
The valid values for method are: SyncIO, AsyncIO, or
SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100% of the
SunOS 5.6 Last change: 11 March 2003 1
Maintenance Commands disktest(1M)
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following:
2KB|6KB|32KB|64KB|128KB|256KB|512KB.
fstest=enable|disable
Enables or disables the file system subtest.
userpattern=data-pattern
Specifies a specific pattern for file system testing.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified, along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode as tests run when executed with the
vtsui.online command. It is a non-intrusive version
that doesn't significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SunOS 5.6 Last change: 11 March 2003 2
Maintenance Commands disktest(1M)
SEE ALSO
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 11 March 2003 3
Maintenance Commands fcdisktest(1M)
NAME
fcdisktest - tests the functionality of internal fibre chan-
nel disk
SYNOPSIS
/opt/SUNWstade/Diags/bin/fcdisktest
[ standard-arguments ]
dev=logical-path, | partition=0-7, | rawsub=[ enable|disable
], |
rawiosize=size, | rawcover=percentage, | method=method, |
fstest=[ enable|disable ], | fssize=file-system-size, |
fsiosize=transfer-size, | userpattern=data-pattern, |
selftest=[ enable|disable ], |
wrdevbuf=[ enable|disable ], | selectpattern=[
user|critical|all ], |
wrdevbufiterations=passes-per-pattern, checkrdls=[
enable|disable ] ]
DESCRIPTION
The fcdisktest test verifies the functionality of Sun
StorEdge internal fibre channel disk using the Media, File
System, Asynchronous I/O, Send Diagnostic and Write/Read
Buffer subtests. An instance of fcdisktest will be present
for each internal fibre channel disk.
OPTIONS
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=logical-path
This is the name of the disk that is returned by
discman(1M).
partition=0-7
Specifies the partition number to test as
partition=6(/Export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
selftest=enable|disable
Runs the specified disks internal diagnostics if any
are available.
wrdevbuf=enable|disable
Enable the write read device buffer test.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands fcdisktest(1M)
selectpattern=user|critical|allpattern
Choice of pattern to run. critical is the top-most
critical pattern for fault detection. all patterns also
includes the critical patterns. critical is the
default pattern.
wrdevbufiterations=passes-per-pattern
Runs the specified number of each pattern to the
Write/Read Buffer on the disk.
checkrdls=enable|disable
Monitor read link status counters for errors.
method=method
Specifies the Media Test Methods (SyncIO and AsyncIO).
The valid values for method are: SyncIO, AsyncIO, or
SyncIO+AsyncIO.
rawcover=percentage
Specifies media coverage percentage from 0-100% of the
partition.
rawiosize=size
Specifies the media size to transfer. size can be one
of the following:
2KB|6KB|32KB|64KB|128KB|256KB|512KB.
fstest=enable|disable
Enables or disables the file system subtest.
userpattern=data-pattern
Specifies a specific pattern for file system testing.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=transfer-size
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified, along with the other options.
-u Displays command-line usage information.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands fcdisktest(1M)
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode as tests run when executed with the
vtsui.online command. It is a non-intrusive version
that doesn't significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands fctapetest(1M)
NAME
fctapetest - tests the functionality of Fibre Channel tape
drives
SYNOPSIS
/opt/SUNWstade/Diags/bin/fctapetest
[ standard-arguments ]
[-uvelf ] | [-o "dev=device-name ] | -d=density |
m=mode | l=length | s=block-count | ft=file-test
DESCRIPTION
The fctapetest test verifies the functionality of Sun-
supported Fibre Channel tape drives by writing, reading, and
verifying blocks of data. An instance of fctapetest will be
present for each internal Fibre Channel tape drive.
The fctapetest diagnostic provides a variety of tests for
Sun-supported Fibre Channel tape drives. The fctapetest does
not test the tape library; it presumes that the user of the
diagnostic either uses tape-library management software or
manually inserts tapes into the drives.
If the fctapetest test is not running in the default
compression mode, you need to specify l for low compression
(that is, /dev/rmt/xxl.)
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
fctapetest -o "dev=/dev/rmt/01 | m=Write/Read"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
-odevice-name
Test-specific command arguments.
-d=density
The tape data density. The default is C for compres-
sion. By specifying the l option, you instruct the
tape device to run at "low" compression.
dev=device_name
The name of the tape device. This is a required field.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands fctapetest(1M)
m=mode
Setting m to "Readonly" will test the tape drive as a
read-only device. The default mode is "Readwrite."
l=length
How long the tape test should run. A short test is 1000
blocks; a long test is 70000 blocks. EOT means to con-
tinue to write until end-of-tape. Specified means to
use the exact number of blocks specified in the s argu-
ment.
s=block_count
When the l argument is set to "Specified," use this
argument for the count of the number of blocks to read
or write on the tape.
ft=enable|disable
Enable the file test to write multiple file marks on
the tape.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands ifptest(1M)
NAME
ifptest - tests functionality of the PCI FC-100 Fibre
Channel-Arbitrated loops (FC-AL) card
SYNOPSIS
/opt/SUNWstade/Diags/bin/ifptest
[ standard-arguments ]
-uvelf] | -o dev=physical-path | mbox=[enable|disable] |
fwrevcheck=[enable|disable] | checksum=[enable|disable] |
modrevcheck=[enable|disable]
DESCRIPTION
The ifptest tests the functionality of the PCI FC-100 FC-AL
card when there are no devices attached to the loop. The
driver checks for devices on the fibre loop. If devices are
detected the driver blocks any diagnostic commands. An
error message will be displayed if you are attached to
storage.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
ifptest -o "dev=/devices/pci@f,2000/SUNW,ifp@2:devctl |
mbox=Enable"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=physical-path
There is no default for physical-path.
mbox=enable|disable
Enables or disables the mailbox loopback command. This
test writes data patterns into the mailboxes and then
reads them back from the output mailboxes and verifies
the data is correct.
fwrevcheck=enable|disable
Enables or disables the firmware revision check com-
mand. This test extracts the firmware revision from the
RISC firmware code and verifies against expected
values.
checksum=enable|disable
Enables or disables the firmware checksum command. This
command instructs the interface's RISC processor to
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands ifptest(1M)
calculate the checksum on the current microcode and
then compare it against the checksum that was loaded in
with the microcode.
modrevcheck=enable|disable
Enables or disables the firmware checksum command. This
command returns the revision level of several submo-
dules on the interface card. Although this test is exe-
cuted when enabled, the module revision levels are only
printed out in VERBOSE mode.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands ifptest(1M)
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands jnitest(1M)
NAME
jnitest - tests the functions of the Sun StorEdge 2 Gbyte
PCI Fibre Channel Network Adapter JNI boards.
SYNOPSIS
/opt/SUNWstade/Diags/bin/jnitest
[-uv] | [-o dev=physical-path] |
selftest=[enable|disable] |
ilb=[enable|disable] |
elb=[enable|disable] |
iterations=number |
userpattern=0x-hex-number |
selectpattern=[user|critical|all]
DESCRIPTION
The jnitest tests the functions of the PCI 2 Gbyte FC-AL JNI
board.
OPTIONS
WARNING: Do not run jnitest while other tests are running.
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
jnitest -o
"dev=/devices/pci@8,700000/SUNW,jfca@2/fp@0,0:devctl|ilb=disable"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=physical-path
Specifies the path to the HBA. This is the path
returned by 'luxadm -e port' There is no default.
selftest=enable|disable
Enables or disables the selftest command. Evaluates the
functionality of the ISP hardware. The default is dis-
able.
ilb=enable|disable
Enables or disables the internal loopback test. Per-
forms internal loopback test within the host adapter
ISP hardware. NOTE: A loopback cable must be inserted
in order for this test to run. Default is disable.
elb=enable|disable
SunOS 5.6 Last change: 05 May 2003 1
Maintenance Commands jnitest(1M)
Enables or disables the external loopback test.
Default is enable.
iterations=number
Controls the number of times the loopback test will
run, for example, 100. The default is 1000.
userpattern=0xpattern
Lists the data pattern to loop, for example,
0x7e7e7e7e. Only used if selectpattern is set to user.
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing dev-
ice failure. all is a complete list of patterns. criti-
cal is the default pattern.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test- specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 05 May 2003 2
User Commands lbf(1)
NAME
lbf - A loop back frame diagnostic utility program that
tests Fibre Channel-Arbitrated loops (FC-AL)
SYNOPSIS
-x = xfer-size | -k = xfer-size | -n= passcount | -t = test_pattern |
[-c] | [ -v|-q|-o] | [ -a] | [ -i] | device ]
DESCRIPTION
The lbf test diagnoses a FC-AL by sending a data frame out
of a Host Adaptor transmit port and receiving the frame on
its receive (input) port. If the frame returns with an
error, or does not return at all, lbf flags an error condi-
tion indicating a bad loop; that is - a loop that cannot
transmit data reliably.
Note: This command is not valid on the PCI Qlogic 2100 HBA.
There are many loop components that may cause the failure,
including the Host Adaptor, any attached Sun StorEdge A5x00
storage arrays (Interface Board, Backplane, Disk Drives,
etc), cables, GBICS, hubs, and switches.
If the transfer size is greater than the maximum allowed
FC-AL frame size, lbf sends out multiple frames containing
the data pattern.
Note: 0x7e7e7e7e is a good pattern for testing FC-AL loop
components.
To obtain the correct device path name to pass as an argu-
ment, you must use the luxadm(1M) command with the -e
option. See the example below for instructions.
OPTIONS
The following are valid options for lbf:
-x xfer-size Specifies the byte transfer size. Enter the
byte xfer size in multiples of 4 up to 64K.
Use option -k to specify Kbyte transfers.
-k xfer-size Specifies the Kbyte transfer size. Enter the
Kbyte xfer size in multiples of 4 up to 64K.
Use option -x to specify byte transfers.
-n passcount Specifies the number of passes (passcount).
-t test-pattern
Specifies a 4-byte test pattern (test pat-
tern). For example, 0x7e7e7e7e.
SunOS 5.6 Last change: 20 December 2002 1
User Commands lbf(1)
-c Compares the returned data to the transmitted
data.
-v Enables verbose mode.
-q Enables quiet mode (no output to stdout).
-o Reports throughput.
-a Uses all data patterns.
-i Ignores errors.
device Specifies the Host Adaptor and port to be
tested.
EXAMPLE
The following example shows how to use the luxadm(1M) command to
obtain the device path to pass as an argument to lbf
# luxadm -e port
Found path to 9 HBA ports
/devices/sbus@3,0/SUNW,socal@d,10000:0 NOT CONNECTED
/devices/sbus@3,0/SUNW,socal@d,10000:1 NOT CONNECTED
/devices/sbus@a,0/SUNW,socal@d,10000:0 NOT CONNECTED
/devices/sbus@a,0/SUNW,socal@d,10000:1 CONNECTED
/devices/pci@4,2000/pci@2/SUNW,qlc@4/fp@0,0:devctl CONNECTED
/devices/pci@4,2000/pci@2/SUNW,qlc@5/fp@0,0:devctl CONNECTED
/devices/pci@5,2000/pci@2/SUNW,qlc@4/fp@0,0:devctl CONNECTED
/devices/pci@5,2000/pci@2/SUNW,qlc@5/fp@0,0:devctl NOT CONNECTED
/devices/pci@7,2000/SUNW,qlc@2/fp@0,0:devctl CONNECTED
The following example transmits one hundred 2 Kbyte (2048) data frames
containing the data pattern 0x7e7e7e7e and compares the results.
# lbf -k 2 -n 100 -t 7e7e7e7e -c /devices/sbus@1f,0/SUNW,socal@0,0:1
Example of good return:
PASS Pat=0x7e7e7e7e Cnt=100 /devices/sbus@1f,0/SUNW,socal@1,0:0
Example of bad return:
FAIL=42 Pat=0xaa55aa55 Cnt=0 /devices/sbus@1f,0/SUNW,socal@1,0:0
Example of invalid HBA (Qlogic 2100)
# lbf -k 2 -n 100 -a /devices/pci@1f,2000/SUNW,ifp@1:devctl
WARNING: Device /devices/pci@1f,2000/SUNW,ifp@1:devctl is
not supported by lbf!
SunOS 5.6 Last change: 20 December 2002 2
User Commands lbf(1)
ERROR CODES
If lbf has a failure other than a command line error, it
returns an error code. A one-line description of the code
is output when the -v option is used.
The following error codes are used:
0x41 65 Failed to open the specified device.
0x42 66 Failed to get the Fibre Channel Loop Map.
0x43 67 Failed ioctl to send Loop Back Frame.
0x44 68 Failed transmit / receive frame compare.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands linktest(1M)
NAME
linktest - diagnose Sun StorEdge network passive Fibre Chan-
nel components
SYNOPSIS
/opt/SUNWstade/Diags/bin/linktest
DESCRIPTION
The linktest test is delivered with the Storage Automated
Diagnostic Environment software. This test verifies the
functionality for passive FC components in a SAN or DAS
environment. The passive components include GBICs, fibre
channel, FC-Switch, MIA, and FC adapters. The test will test
both ends of the link segment (if possible) and enter a
guided isolation when a failure is detected.
linktest is executed from the topology view under
"Diagnose->Diagnostic Tests->Test from Topology" or
"Monitor->Monitor Topology-> (Select a topology)" by right
clicking on a link segment's icon. (In order to see the link
segment icon, the Links on/off button at the bottom of the
topology screen must be showing "Links off".) Typically
linktest is run when the user detectes a bad or intermittent
link via an "alert" or by the visual detection on the topol-
ogy graph (a red link).
After starting linktest, the "Test Manager" will be utilized
to guide the user through FRU isolation.
OPTIONS
Options can be one or more of the following and can be used
from the GUI that are listed below.
email=email@address.com
User specific e-mail address for example: user@sun.com.
verbose=verbose
User selects verbose on/off.
userpattern=pattern
User specific pattern in hexadecimal, for example:
pattern=0x4a4a4a4a.
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands linktest(1M)
Standard Command-Line Arguments
Currently the CLI is NOT supported for linktest.
SEE ALSO
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands qlctest(1M)
NAME
qlctest - tests the functions of the Sun StorEdge 1 Gbyte
and 2 Gbyte PCI and cPCI Fibre Channel Network Adapter
boards.
SYNOPSIS
/opt/SUNWstade/Diags/bin/qlctest
[ standard-arguments ]
[-uvelf] | [-o dev=physical-path] | run_connect=[Yes|No] |
selftest=[enable|disable] | mbox=[enable|disable] |
checksum=[enable|disable] |
ilb-10=[enable|disable] |
ilb=[enable|disable] | elb=[enable|disable] | xcnt=Ox-number
|
iterations=number | userpattern=0x-hex-number |
selectpattern=[user|critical|all]
DESCRIPTION
The qlctest tests the functions of the PCI and cPCI 1 Gbyte
and 2 Gbyte FC-AL board.
OPTIONS
WARNING: Do not run qlctest while other tests are running.
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
qlctest -o
"dev=/devices/pci@8,200/pci@2/SUNW,qlc@4/fp@0,0:devctl |
run_connect=No"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=physical-path
Specifies the name of an ses device in the enclosure.
This is the name of the device that is returned by
discman(1M), such as qlc0.Thereisnodefault.
run-connect=Yes|No
If run-connect is set to Yes, qlctest will run when the
tested port is connected to storage. If the port being
tested is not connected to storage, this option has no
effect. There is no default.
selftest=enable|disable
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands qlctest(1M)
Enables or disables the selftest command. Evaluates the
functionality of the ISP hardware. The default is
Enable.
mbox=enable|disable
Enables or disables the mailbox loopback command. This
test writes data patterns into the mailboxes and then
reads them back from the output mailboxes and verifies
the data is correct. Default is Enable.
checksum=enable|disable
Enables or disables the checksum command. Runs an
internal checksum test on the installed firmware. This
verifies that the RISC RAM on the card is fully func-
tional and that the installed firmware is still intact.
This test also serves as a quick RAM check of the RISC
RAM. Default is Enable.
ilb-10=enable|disable
Enables or disables the internal 10-bit test. Performs
internal loopback test within the host adapter ISP
hardware at the 10-bit interface. Default is Enable.
ilb=enable|disable
Enables or disables the internal 1-bit test. Performs
internal loopback test within the host adapter ISP
hardware at the 1-bit interface. Default is Enable.
elb=enable|disable
Enables or disables the external loopback test. The
desired data pattern, transfer length, and iteration
count can be selected via the test parameters menu.
Requires a cable for this intervention test. Default
is Disable.
xcnt=0x-number
Controls the packet size to be transferred, for exam-
ple, 0x1000. The default is 10000.
iterations=number
Controls the number of times the loopback test will
run, for example, 100. The default is 10.
userpattern=0xpattern
Lists the data pattern to loop, for example,
0x7e7e7e7e.
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing dev-
ice failure. all is a complete list of patterns. criti-
cal is the default pattern.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands qlctest(1M)
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
The default is true.
-o Used to indicate that the options and arguments that
follow are test- specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands ras_admin(1M)
NAME
ras_admin - command line interface to Storage Automated
Diagnostic Environment
SYNOPSIS
/opt/SUNWstade/bin/ras_admin command
DESCRIPTION
ras_admin provides a command line interface to the common
Automated Diagnostic Environment administrative tasks.
ras_admin accepts one optional command at a time.
OPTIONS
The following option commands can be passed as arguments to
ras_admin:
agent [ -s | -p ] [ -h host ] [ -? ]
Enables the user to manually start (-s) or stop (-p)
the Storage Automated Diagnostic Environment agents.
alert_list
Displays a list of current alerts (warnings and
errors).
alert_delete
Deletes selected alerts.
device_delete_all
Deletes all devices.
device_detail
Displays the details about the device(s).
device_list
Displays a list of devices in a given configuration.
discover_deviceIP
Discovers devices entered in the /etc/deviceIP.conf
file.
discover_a5k
Discovers a Sun StorEdge A5000 array on a master or
slave.
discover_3510
Discovers a Sun StorEdge 3310 or 3510 array on a master
or slave.
] [ -p prefix ]
SunOS 5.6 Last change: 04 April 2003 1
Maintenance Commands ras_admin(1M)
discover_subnet [ -h host ] [ -s subnet ] [ -
a hostname_as_prefix
[ -m monitoring_off ] [ -? ]
Finds Sun StorEdge T3+ arrays and Sun StorEdge network
FC switches on the subnet. The subnet searches for
valid devices and the search results are sent back to
the Master agent. The Master agent moves valid devices
into the main configuration file.
discover_t3
Finds a Sun StorEdge T3 or T3+ array from the
/var/adm/messages.t3 logfile.
discover_solution
Finds a Sun StorEdge 3900 or 6900 Series system from
the Golden Snapshot.
discover_switch
Finds Sun StorEdge network switches that have been
entered into the /etc/fcswitch file.
email_list
Displays a list of email addresses that have been con-
figured for notification.
ethers_list
Displays a list of the ethers file.
ethers_add
Adds an entry to the ethers file.
ethers_delete
Deletes an entry from the ethers file.
host_list
Displays a list of hosts.
host_detail
Displays the details about the host(s). Current hosts
include: a3500fc, a5k, brocade, host, internal, san,
switch, or t3.
host_delete [ -n hostname ] [ -d delete_devices ]
Deletes a specified host from the configuration..TP
site_info_upd Enables the user to update the customer's
site information.
login_list
Displays a list of all users that are authorized to log
in.
login_add [ -l login ] [ [ -p password ] | -
SunOS 5.6 Last change: 04 April 2003 2
Maintenance Commands ras_admin(1M)
r role1 | role2 ]
[ -? ] [ Roles = { user | admin | script | test}
Adds a new user to the Storage Automated Diagnostic
Environment.
login_delete [ -l login ] [ -? ]
Deletes an existing user's login privileges from the
Storage Automated Diagnostic Environment.
-? ]
login_update [ -l login ] [ [ -p password ] | -
r role1 |role2 ] [
[ Roles = {user | admin | script | test}
Updates a user's password or a user's login privileges.
password_change
Changes the password of a device.
provider_list
Displays a status of providers.
] [ -i ip_address ]
provider_on -p [ sunmc | rss | srs | setconnect ] [ -
f frequency
[ -? ]
Turns on a notification provider.
] [ -i ip_address ]
provider_off -p [ sunmc | rss | srs | setconnect ] [ -
f frequency
[ -? ]
Turns off a notification provider.
push_config [ -h hostname | ALL ] [ -? ]
Updates slave configuration changes. push_config syn-
chronizes all slave instances under a master instance
to ensure proper monitoring and notification.
report_list
Displays a list of all available instrumentation
reports. The reports summarize system information,
including agent statistics and system thresholds, on
every device that is currently supported by the Storage
Automated Diagnostic Environment.
report [ -? ] [ -k report_key ] [ -h host ]
Displays a specified report. Report options include
Agent Statistics, Thresholds List, Traffic Report,
Switch Graph, and Switch Data.
review_config
Reviews the configuration.
SunOS 5.6 Last change: 04 April 2003 3
Maintenance Commands ras_admin(1M)
site_info
Retrieves the customer's site information. The manda-
tory fields, denoted with an asterisk, must be com-
pleted before any other maintenance function.
switch_add [-n name ] [ -i ip_address ] [ -h host ] [ -? ]
Adds a Sun StorEdge network FC switch-8 or switch-16
switch to the configuration.
-? ]
t3_add [-n name ] [ -i ip_address ] [ -h host ] [ -
p password ] [
Adds a Sun StorEdge T3 or T3+ array to the configura-
tion.
topo Displays a list of the current topologies.
topo_list
Displays the details of devices that exist within a
current topology.
EXAMPLE
The following is an example of ras_admin run with the
site_info optional command.
# /opt/SUNWstsade/bin/ras_admin site_info
Customer: Network Storade Serviceability Labs
Contract: 12345678
CustNumber: 5555
Address: 500 Eldorado Blvd, Broomfield, CO, 80026, USA
Contact: John Smith
Phone: 353-555-5555
Email: smith@sun.com
Production: N
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
ras_admin(1M), ras_discover(1M), ras_install(1M),
ras_patchlist(1M), ras_revcheck(1M),
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 04 April 2003 4
ras_discover (1M) |
[ Top ] |
Maintenance Commands ras_discover(1M)
NAME
ras_discover - discovers devices and updates the configura-
tion file on the slave and the master.
SYNOPSIS
/opt/SUNWstade/bin/ras_discover
[ standard-arguments ]
[ -d=device_type ], [ -f=monitoring_frequency ], [ -
h=help ]
DESCRIPTION
ras_discover automatically discovers devices and updates the
configuration file on both the slave and the master. The
monitoring frequency may also be set. This allows installa-
tion scripts to be executed on a host with storage devices
without having to use the GUI on the master. Currently, only
Sun StorEdge A5000 array devices are supported.
Note: ras_discover can be used on a slave.
EXAMPLES
Note:
All types must be separated by a pipe (|).
Example:
/opt/SUNWstade/bin/ras_discover -d a5k|t3 -f 30
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified.
-d Displays device types.
-f Specifies the monitoring frequency (in minutes).
-h Displays help.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands ras_discover(1M)
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands ras_install(1M)
NAME
ras_install - executes the ras_install command to start the
Storage Automated Diagnostic Environment services.
SYNOPSIS
/opt/SUNWstade/bin/ras_install
[ standard-arguments ]
[ -h ] [ -n | -m | -s ]
-S [ Y | N ] [ -c|-p ] [ -A|-C ]
DESCRIPTION
ras_install sets up the HTTP service, adds a cron, and
registers with the Master Agent in the case of a Slave
install. You must run ras_install manually upon completing
the pkgadd - .. Execute ras_install anytime after the ini-
tial execution and setup when you need to modify the cron or
when you need to change the Master/Slave title of a Host
agent.
Once you have executed ras_install, you can launch the
Storage Automated Diagnostic Environment GUI from a web
browser.
OPTIONS
Options can be one or more of the following:
-h Display the usage for the arguments for ras_install.
-n Net-Connect automatic installation.
-m Install this instance of the Agent as Master.
-s master_ip
Install this instance of the Agent as Slave. master_ip
is the IP Address or IP Name of the host configured
with an instance of the Storage Automated Diagnostic
Environment as Master.
-S [Y | N ]
Enable the security. Y is enable the SSL; N is disable
the SSL.
-c Enable the automatic execution of
/opt/SUNWstade/bin/rasagent from cron.
-p Postpone the automatic execution of
/opt/SUNWstade/bin/rasagent from cron.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands ras_install(1M)
-A Install as Agent on any server.
-C Install on Management Console that has no storage dev-
ices. Ignores Solaris version.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), disk_inquiry(1M), luxadm(1M),
rasagent(1M), sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
ras_patchlist (1M) |
[ Top ] |
Maintenance Commands ras_patchlist(1M)
NAME
ras_patchlist - executes PatchPro software and creates a
list of devices and required patches.
SYNOPSIS
/opt/SUNWstade/bin/ras_patchlist
[ standard-arguments ]
[ -s=command_status ], [ -p=print_report ], [ -
S=session_id ], [ -b=background ]
DESCRIPTION
ras_patchlist automatically assesses patches needed for your
system and creates a printable list of devices and requires
patches.
EXAMPLES
Note:
All types must be separated by a pipe (|).
Example:
/opt/SUNWstade/bin/ras_patchlist -S storade | -p
OPTIONS
The following are valid options for ras_patchlist:
-s Displays the status of the current command.
-p Prints the ras_patchlist report.
-S Displays the session ID. (The user should use
'storade'.)
-b Runs the ras_patchlist command in the background.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
ras_admin(1M), ras_discover(1M), ras_install(1M),
ras_patchlist(1M), ras_remote(1M), ras_revcheck(1M),
ras_upgrade(1M)
SunOS 5.6 Last change: 04 April 2003 1
Maintenance Commands ras_patchlist(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 04 April 2003 2
Maintenance Commands ras_remote(1M)
NAME
ras_remote - executes Storage Automated Diagnostic Environ-
ment commands remotely.
SYNOPSIS
/opt/SUNWstade/bin/ras_remote
[ standard-arguments ]
[ -c | - d | -p | -? | -s | -i ]
DESCRIPTION
ras_remote lists and executes commands remotely. Note: The
user must create the '.ras_remote' file in the same direc-
tory that the ras_remote command is located, and must have
the following information:
login login (agent login name)
password password (agent password)
ip ip address of remote agent (optional)
wgetdir path to wget (default is the current directory)
OPTIONS
The following are valid options for ras_remote:
-? Displays the help.
-d Enables debugging.
-c Displays a list of available commands.
-p Use the proxy. This is turned off by
default.
-s Use the secure socket layer (ssl).
-i ip_address Displays the IP address of the device.
-wgetdir Displays the path to wget. The default is
the current directory.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SunOS 5.6 Last change: 04 April 2003 1
Maintenance Commands ras_remote(1M)
SEE ALSO
ras_admin(1M), ras_discover(1M), ras_install(1M),
ras_patchlist(1M), ras_revcheck(1M), ras_upgrade(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 04 April 2003 2
ras_revcheck (1M) |
[ Top ] |
Maintenance Commands ras_revcheck(1M)
NAME
ras_revcheck - checks the software, hardware, and firmware
revision levels.
SYNOPSIS
/opt/SUNWstade/bin/ras_revcheck
[ standard-arguments ]
[ -h=hostname ], [ -m=config-matrix-name ], -M= [A3500 | T3
| A5K | D2 | Driver | FC_DISK | HBA | Silkworm | Switch |
Switch_2GB | TAPE | V880Disk | VE ], [ -e=email_address ], [
-b=background ]
DESCRIPTION
ras_revcheck checks the software, hardware, and firmware
revision levels of all user-selected modules. The report
displays the current revision, the expected revision, and
upgrade information.
OPTIONS
Note: All options must be listed in a quoted list and
separated by a pipe (|).
Example 1:
/opt/SUNWstade/bin/ras_revcheck -h " " -m "config-
matrix_3.13"
-M "A3500 | Driver | FC_Disk | HBA | V880DISK | " -e "
john.smith@sun.com"
Example 2:
/opt/SUNWstade/bin/ras_revcheck -h "crash6"
-m "config-matrix_3.12" -M "A5K | Driver | FC_Disk | HBA |
Brocade | Switch | T3 | " -e " "
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
-h hostname
Runs the hostname command on the specified host-
name. If a hostname is not specified, the command
will run on the local machine. This command is
optional.
-m matrix_name
Specifies the configuration matrix name used to
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands ras_revcheck(1M)
run revision check. If the user specifies an
incorrect or invalid matrix name, an error occurs.
This command is required.
Note: Check for available matrix names in the
opt/SUNWstade/System/Matrix directory. It is
recommended that you use the most recent matrix
name. For example: config-matrix_3.13.
-M Modules
Specifies the module against which revision check
is run. At least one module must be specified for
revision check to run.
The following is a list of the modules that can be speci-
fied.
A3500
Sun StorEdge A3500FC array patches and disk
firmware
T3 Sun StorEdge T3 and T3+ array patches and disk
firmware
A5K Sun StorEdge A5x00 array patches and disk firmware
D2 Sun StorEdge D2 array patches and disk firmware
Driver
Host patches
FC_DISK
Sun Internal Fibre Channel Disk firmware
HBA HBA patches
Silkworm
Brocade Silkworm firmware
Switch
Sun StorEdge network 1 GB FC switch-8 and switch-
16 switch
Switch_2G
Sun StorEdge network 2 GB FC switch-8 and switch-
16 switch
TAPE Sun Fibre Channel Tape firmware
V880DISK
Sun Fire V880 Disk firmware
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands ras_revcheck(1M)
VE Virtualization Engine firmware
-e email_address
Specifies the email address to where revision
check results are sent. If no email address is
specified, then no results are sent. This command
is optional.
-b background
Runs revision check in the background.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
The default is true.
-o Used to indicate that the options and arguments that
follow are test- specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ksestest(1M), a5ktest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands ras_revcheck(1M)
SunOS 5.6 Last change: 20 December 2002 4
Maintenance Commands ras_upgrade(1M)
NAME
ras_upgrade - upgrades a set of devices using PatchPro.
SYNOPSIS
/opt/SUNWstade/bin/ras_upgrade
[ standard-arguments ]
[ -s | - i | -p | -S | -h | -b ]
DESCRIPTION
ras_upgrade automatically upgrades devices using PatchPro.
OPTIONS
The following are valid options for ras_upgrade:
-s Displays the status of the upgrade.
-i Displays the IP list.
-S Displays the session ID. (The user should
use 'storade'.)
-p Prints the ras_upgrade report.
-h Displays the help.
-b Runs the ras_upgrade command in the back-
ground.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
ras_admin(1M), ras_discover(1M), ras_install(1M),
ras_patchlist(1M), ras_revcheck(1M),
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 04 April 2003 1
Maintenance Commands rasagent(1M)
NAME
rasagent - monitors, collects, and reports information about
Sun storage products.
SYNOPSIS
/opt/SUNWstade/bin/rasagent
[ standard-arguments ]
[ -T=test_mode] [ -e=dir] [ -v=version] [ -P=print]
[ -O=dir] [ -d=debug_level] [ -D=directory] [ -?=help]
[ -s=] [ -c=run_from_cron]
DESCRIPTION
rasagent is executed automatically by the cron, or you can
run it manually from the command line. If the Storage
Automated Diagnostic Environment is run from the command
line, it will first check that another process for rasagent
is not already running.
OPTIONS
Options can be one or more of the following:
-T test_mode
while in test mode, the Storage Automated Diagnostic
Environment will not send emails and will not update
cache.
-e dir
determines in which events directory the events are
stored.
-v version
-P print
print output, no email
-O dir
send everything, no cache
-d level
debug levels
1 Minimal output; indicates start time only
2 Verbose output; indicates the steps the Storage
Automated Diagnostic Environment takes during exe-
cution. Also overrides the time limitations
between executions.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands rasagent(1M)
3 Maximum verbosity; indicates each step the Storage
Automated Diagnostic Environment program takes,
along with the commands that loaded modules exe-
cute. toc and xml files can be found in /tmp for
comparisons. Also overrides the time limitations
between executions.
-D directory
directory for system DATA and rasagent.conf file.
-? Help
-s do not save the data found.
-c running from the cron
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), disk_inquiry(1M), luxadm(1M),
ras_install(1M), sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands sanbox(1M)
NAME
sanbox - access the SANbox switch diagnostic facilities
SYNOPSIS
/opt/SUNWstade/bin/sanbox discover base-ip-address
address_range
sanbox version ip_address
sanbox port_status ip_address port
sanbox port_counts ip_address port
sanbox reset_log ip_address
sanbox start_test [-x xfer-size, bytes] [-n
number_of_passes] [-t test_pattern] [-r ] [-w wait_in_msec ]
ip_address port
sanbox stop_test ip_address port
sanbox test_status ip_address port
sanbox port_counts ip_address port
sanbox initiators ip_address
sanbox parameters [-s] [-M mfs_mode ] [-m mfs_timeout ] [-e
edtov ] [-a ratov ] [-t rttov ] ip_address port
DESCRIPTION
The sanbox command provides access to the SANbox diagnostic
facilities. It contains four main functions: discover,
port_status, port_counts, start_test, and test_status.
The discover command returns a list of switch IP addresses
that have been found by probing a specified IP subnet.
The version command returns a report of version information
for the PROM and firmware within the switch.
The port_status command returns a list of all the AL_PAs
attached to the specified port.
The port_counts command returns a list of the key perfor-
mance metrics for the specified port. Included are frames
transmitted and received and various error and re-
initialization events.
The start_test command initiates a loop integrity test for
the specified port. A wait period can be specified before
returning results or the results can be retrieved with the
test_status command. The counts of test frames and errors
detected accumulate for each run of the test; these counts
can be cleared with the -r parameter or the reset_log com-
mand. Only one online test can be active at a time; the
test_status command can be used to determine the completion
of the online test. The test can be terminated with the
stop_test command.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands sanbox(1M)
The stop_test command terminates an active loop integrity
test. It is ignored by the switch if there is no online test
active.
The test_status command polls the SANbox switch for the
results of the loop integrity test.
The reset_log command clears the frame and error counts for
the online tests.
The port_counts command reports performance and error counts
for the port.
The initiators command reports the list of HBAs/initiators
attached to the switch. The switch monitors PLOGIs and
records the port and node WWN for retrieval by this command.
The output lists the switch node, the initiator port and
node WWNs, the port, and the AL_PA, in that order.
The parameters command supports the reporting and changing
of the switch tuning parameters. Modification of these
parameters may be to the temporary active or to the non-
volatile values. If no parameters are specified, the
current active and saved parameters are reported. If only
the -s option is specified, the current active values are
saved and committed to be permanent. Other parameter options
affect only the active values unless the -s flag is used, in
which case the active values are updated and then saved.
RETURN VALUES
Example return values for several commands are shown in the
Examples section. The return value for the test_status com-
mand are further defined here. An example of the command
follows:
% sanbox test_status 123.456.1.22 1 IP: 123.456.1.22
port_test_status: 1 port_test_count: 10
port_fail_count: 0
The port_test_status value reflects overall status: 1 = All
Passed, 2 = At least one failure.
The port_test_count value shows the number of test frames
that have been sent. The port_fail_count value shows the
number of test frames that have failed.
The return value for the initiators command are defined
here. An example follows:
% sanbox initiators 123.456.1.22
IP: 123.456.1.22
100000c0dd00416f 20070200000bd8d8 50800200000bd8d8 1
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands sanbox(1M)
0x01
100000c0dd00416f 20010200000021f9 50200200000021f9 3
0x02
The first column is the switch Node WWN. The second column
is the initiator's Port WWN. The third column is the
initiator's Node WWN. The fourth column is the switch port
number. The last column is the AL_PA of the HBA.
OPTIONS
The following options are supported:
sanbox discover
base_ip_address
The base IP address of the network that contains the
SANbox switches. For example: 123.456.1.22
address_range
The number of consecutive addresses to probe. This is
usually less than 256 and is based on the subnet mask.
sanbox version
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
sanbox port_status
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
port Port number from which to retrieve the attached AL_PAs.
Valid range is 1 to 8 or the word "all" can be used to
specify all ports.
sanbox port_counts
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
port Port number from which to retrieve the statistic
counts. Valid range is 1-to-8 or the word "all" may be
used to specify all ports.
sanbox start_test
-xxfer-size, bytes
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands sanbox(1M)
Set the size of data portion of the Fibre Channel
frame. Default is 2000 bytes. Valid range is 36 to
2000.
-nnumber of passes
The number of frames to send for the test.
-ttest pattern
The data pattern to be sent to fill the frame. Default
is 7e7e7e7e. Any 32-bit hex value is valid.
-r Performs a reset_log command prior to starting the
test. This resets the test counters.
-wwait in seconds
The number of seconds to wait before polling for
results. If zero, the command immediately returns
without polling for results. If a non-zero value is
specified, the command waits, then performs a single
poll for results and exits. The poll for results
returns the same values as returned by sanbox
test_status. The default is to wait for 2 seconds.
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
port Port number on which to run tests. Valid range is 1 to
8.
Note: The word "all" is not supported, since each port
must be tested individually.
sanbox test_status
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
port Port number from which to retrieve test results. Valid
range is 1-to-8, or the word "all" can be used to
specify all ports.
sanbox reset_log
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
sanbox port_counts
ip_address
IP address of the switch. Either a symbolic name or
SunOS 5.6 Last change: 20 December 2002 4
Maintenance Commands sanbox(1M)
decimal-dot notation can be used.
port number from which to retrieve test results.
Valid range is 1-to-8, or the word "all" can be used to
specify all ports.
sanbox initiators
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
sanbox parameters
no options
Show the current active and saved values.
-s Save the active parameters into permanent store.
Changes to the active values are made first if other
parameters are specified.
-Mmfs_mode
Controls the multiframe-sequence mode, also referred to
as "frame bundling." Alternative mode values support
limiting the Loop Tenancy of the switch to a specific
number of frames. The possible values for the mfs_mode
are as follows:
0 = MFS disabled
1 = MFS type: complete non-interleaved sequences
2 = MFS type: non-complete sequences, reserved internal
queues
3 = MFS type: non-complete sequences, soft preference
4 = Maximum of 8 frames transmitted per loop tenancy
5 = Maximum of 32 frames transmitted per loop tenancy
6 = Maximum of 128 frames transmitted per loop tenancy
-m
Sets the wait timeout for mfs_mode values 1 and 2.
-e
Sets the ED_TOV value.
-t
Sets the RT_TOV value.
-a
Sets the RA_TOV value.
ip_address
IP address of the switch. Either a symbolic name or
decimal-dot notation can be used.
SunOS 5.6 Last change: 20 December 2002 5
Maintenance Commands sanbox(1M)
port Port number from which to retrieve test results. Valid
range is 1-to-8, or the word "all" may be used to
specify all ports.
RETURN CODES
0 Successful operation
-1 UNIX error
-2 Timeout error
EXAMPLE
% sanbox discover 123.456.1.22 6
IP: 123.456.1.22
HW: a03
PROM: 3000
FLASH: a0100
WWN: 100000c0dd00411b
MAC: 00c0dd00411a
% sanbox port_counts 123.456.1.22 1
IP: 123.456.1.22
Port: 1
Inframes: 66
Outframes: 1083
Discards: 0
Fbsyframes: 0
C2Rjtframes: 0
LinkFails: 0
SyncLosses: 0
Prim Seq Errs: 0
InvalidTxWds: 280
CRC Errs: 0
DelimiterErrs: 0
AddressIdErrs: 0
Link Reset In: 0
Link Reset Out: 0
OLS In: 0
OLS Out: 0
Total LIP Rcvd: 39
LIP F7 F7: 39
LIP F8 F7: 0
LIP F7 AL_PS: 0
LIP F8 AL_PS: 0
LIP AL_PD, AL_PS: 0
AL Init Errs: 0
AL Inits: 44
% sanbox reset_log 123.456.1.22
IP: 123.456.1.22
% sanbox start_test -w 0 123.456.1.22 1
SunOS 5.6 Last change: 20 December 2002 6
Maintenance Commands sanbox(1M)
IP: 123.456.1.22
% sanbox test_status 123.456.1.22 1
IP: 123.456.1.22
port_test_status: 1
port_test_count: 10
port_fail_count: 0
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), disk_inquiry(1M), luxadm(1M),
rasagent(1M), ras_install(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 7
save_password (1M) |
[ Top ] |
Maintenance Commands savepassword(1M)
NAME
save_password - change the Storage Automated Diagnostic
Environment admin password
SYNOPSIS
/opt/SUNWstade/bin/save_password
DESCRIPTION
save_password provides an interface to perform maintenance
on the password used to access the Storage Automated Diag-
nostic Environment graphical user interface.
You can change the password from inside the GUI or from the
command line.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), disk_inquiry(1M), luxadm(1M),
rasagent(1M), ras_install(1M), sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 April 2002 1
Maintenance Commands sccli(1m)
NAME
sccli - Sun StorEdge 3000 Family CLI
SYNOPSIS
sccli [options] device subcommand [arguments]
sccli help
DESCRIPTION
sccli is a command line interface used to manage the Sun
StorEdge 3000 Family array controllers. It can be used to
examine and configure the array, save and restore configura-
tion data, and download new firmware to the array controll-
ers and enclosure services processors or disks behind the
array.
Except for the about, help and version commands, all sccli
subcommands require the specification of a device filename,
typically specified as /dev/rdsk/cXtYdZs2 or cXtYdZ. On
Microsoft Windows, devices are specified as PhysicalDriven
or by the disk number. This device file needs to correspond
to an array controller device; if the array contains redun-
dant controllers, the device file must correspond to a path
to a logical unit on the primary controller.
To access the array using its out-of-band network interface
rather than via the SCSI or Fibre Channel HBA with which the
array is connected to the host, specify the --oob option.
This will cause sccli to access the device via a local HBA
only briefly, to retrieve the array's network address, and
all subsequent access will be done over the network. This
is useful when heavy SCSI I/O makes in-band access slow; it
can also be used when the host has no path to the primary
controller.
Alternately, if the host on which sccli is run is not con-
nected to the array with a SCSI or FC HBA, a URL can be
specified to indicate that sccli should connect to the
remote array over the network. URLs are specified as:
[se3000://]hostname-or-address[:port-number]
The port-number attribute defaults to 58632.
CAUTION: The download, reset, and shutdown commands all
cause the array to stop responding to I/O requests from the
host for a period of time. This might result in data loss
unless all I/O activity is suspended by halting all applica-
tions that are accessing the array, and unmounting any
filesystems that are mounted from the array. In redundant-
controller configurations, these commands affect all LUNs on
both controllers.
SunOS 5.6 Last change: May 6, 2003 1
Maintenance Commands sccli(1m)
CAUTION: Although redundant controller configurations sup-
port live firmware upgrades using its failover capability,
the failover operation itself might cause warning messages
to be displayed on the console or system log. These mes-
sages can usually be ignored.
NOTE: The secondary controller in dual-controller configura-
tions does not support any administrative functions. In
active/active configurations, where LUNs are assigned to
both the primary and secondary controllers, the sccli com-
mand can be used only with those LUNs assigned to the pri-
mary controller.
OPTIONS
-l, --list
Displays a list of local or remote devices that sccli
knows how to manage, and exits without processing any
commands. The output includes a filename or URL that
can be used to access the device in subsequent commands
and the SCSI INQUIRY data and serial number of the sub-
system. If a network URL is specified on the command
line, the output is limited to that device. If a local
device filename or directory name is specified, the
search is limited to matching devices.
-o, --oob
Access the selected device out-of-band (via its network
interface) rather than using SCSI commands. The device
is specified (or discovered) using its SCSI path name
(do not specify a network address or URL), but once the
device has been selected, all further communication is
performed over the network. This can provide better
performance when the array is processing lots of SCSI
I/O.
-p port, --port port
Access the selected device out-of-band like the --oob
--option, but using the specified TCP port number.
-w password, --password password
Specifies the password assigned to the array con-
troller. The user must supply the correct password when
issuing potentially dangerous commands to the array
over a network connection. For security reasons, it's
preferable to supply this password using the CLI pass-
word command, or enter the password interactively when
prompted for it. No password is required for commands
which do not modify the state of the controller, or
commands issued via in-band SCSI channels.
-y, --yes
Assume a yes response to any yes/no prompts. This is
SunOS 5.6 Last change: May 6, 2003 2
Maintenance Commands sccli(1m)
used to allow particularly dangerous commands to be run
from a script without prompting the user.
-n, --no
Assume a no response to any yes/no prompts.
--version
Displays the version number of the sccli utility and
exits without processing any subcommands.
--usage
Display a usage message and exit without processing any
commands.
--version
Display the program version and exit without processing
any commands.
SYNTAX
In syntax examples, the following terms are used to
represent various parameter types:
disk Physical disk drives are specified as two decimal
integers separated by a period. The first number is
the physical channel number, and the second number is
the SCSI target ID for the drive on that channel. For
example, the drive at ID 2 on channel 1 is specified as
1.2.
disk-list
A list of disk specifiers, separated by commas. For
example, 1.0, 1.1, 1.2.
logical-drive
A logical drive can be represented by a logical drive
index (a small decimal number distinguished by an ld
prefix), or a logical drive identifier (an eight-digit
hexadecimal number). For example, a logical drive
might be identified both by its logical drive index ld3
and its logical drive ID 71038221. Note that logical
drive indices can change whenever a logical drive is
deleted, while a logical drive identifier never changes
over the life of the logical drive.
logical-volume
Logical volumes are specified using either a logical
volume index, such as lv12, or an eight-digit hexade-
cimal logical volume ID.
ld-list
A comma separated list of logical drive indices, for
example, ld0,ld1,ld2, or a list of logical drive
SunOS 5.6 Last change: May 6, 2003 3
Maintenance Commands sccli(1m)
identifiers.
lv-list
A comma separated list of logical volume indices, for
example, lv0,lv1,lv2, or a list of logical volume iden-
tifiers.
target-list
A comma-separated list of SCSI target ID numbers.
lun Partitions of a logical drive or logical volume are
made available to hosts by mapping each partition to a
target ID and logical unit number on one or more chan-
nels on the array controller. Commands with a lun
parameter accept the physical channel number, target
ID, and logical unit as three decimal numbers separated
by periods. For example, 4.1.2 represents physical
channel 4, target ID 1, logical unit number 2.
partition
A logical drive or logical volume identifier with a
suffix indicating a specific partition within the logi-
cal drive or volume, for example, ld2-03 or 2CA48914-
03. The suffix is a hexadecimal number ranging from 0
to 7F.
payload
For diagnostic commands, an eight-digit hexadecimal
number specified with a hexadecimal prefix "0x", for
example, 0xABCDEF01.
SUBCOMMANDS
If no subcommand is entered on the command line, sccli
enters an interactive mode, prompting you to enter subcom-
mands until the quit command is entered. All subcommands
operate on the currently selected device.
If no device is specified on the command line, and more than
one array is connected to the host, a menu of devices is
displayed. The device menu offers only one device filename
for each array, so using a different path requires specify-
ing the pathname on the command line.
The following subcommands are supported in interactive mode,
and with the exception of quit and select, on the command
line:
about
Displays version and copyright information.
clear events
SunOS 5.6 Last change: May 6, 2003 4
Maintenance Commands sccli(1m)
Clears the array's internal event log.
configure channel channel { host | drive } options
Configures a host or drive channel. ch is the physical
drive channel, and options are any of the following:
[-r | --reset]
Specifies that the controller reset immediately so
that the specified changes take effect. By
default, the specified changes do not take effect
until an explicit reset controller command is
issued.
host The channel is used to interface with a host.
drive
The channel is used to connect the array to disk
drives.
sync-clock rate
Specifies the clock rate. rate is specified as
Mhz, for example sync-clock 40Mhz.
primary-id target-list
Specifies one or more target IDs for the primary
controller on the specified channel. primary-id
can be abbreviated pid.
secondary-id target-list
Specifies the target IDs for the secondary con-
troller. secondary-id can be shortened to sid.
configure global-spare disk
Specifies that disk is to be configured as a global
spare disk.
configure local-spare disk logical-drive
Specifies that disk be configured as a dedicated spare
disk for the specified logical drive.
configure network-interface lan0 [options]
Configures the LAN interface, enabling the telnet, ftp,
SNMP, and out-of-band management functions. The fol-
lowing dynamic options are accepted:
bootp
Specifies that the BOOTP protocol be used to
establish an IP address.
rarp Specifies that the RARP protocol be used to estab-
lish an IP address.
SunOS 5.6 Last change: May 6, 2003 5
Maintenance Commands sccli(1m)
dhcp Specifies that the DHCP protocol be used to obtain
an IP address.
The bootp, rarp, and dhcp options can be combined to
specify that multiple protocols be tried in the speci-
fied order. Alternately, if none of the dynamic options
are specified on the same command line, a static IP
address may be specified along with optional netmask
and default gateway parameters. The syntax of the
static IP addressing options is:
ip-address n.n.n.n
The IP address of the array.
netmask m.m.m.m
The netmask, in dotted-decimal format, for exam-
ple,
255.255.255.0
gateway g.g.g.g
The IP address of a default router.
All lan parameters must be specified on the same command
line.
configure partition partition size
configure partition partition delete
Specifies how much disk space to assign to the parti-
tion. Space is allocated from, or yielded to, the adja-
cent (higher-numbered) disk partition. Size is speci-
fied as an integral number of Mbytes, with a suffix of
"MB". For example,
sccli> configure part ld0-0 100mb
To delete a partition, assign a size of zero, or
specify the delete keyword:
sccli> configure part ld0-0 0mb
create logical-drive raidlevel options disks
Creates a logical drive. The raidlevel parameter must
be one of the following:
raid0
Creates a striped array.
raid1
Creates a mirrored array.
raid3
SunOS 5.6 Last change: May 6, 2003 6
Maintenance Commands sccli(1m)
Creates a striped array with a fixed parity disk.
raid5
Creates a striped array with parity.
The options may include one or more of the following:
local-spare
one of the specified disks will be used as a local
spare
max-disk-capacity nMB
only nMB of each drive will be allocated, instead
of entire drive; the remaining space on the drives
can be used to expand the logical drive later on.
The specified parameter should have a MB or GB
suffix.
size nMB
An alternative to the max-disk-capacity keyword
that specifies the total usable size of the
resulting logical drive. The logical drive may
later be expanded until it fills the capacity of
all of the member drives.
primary
The logical drive will be mapped to the primary
controller (default).
secondary
The logical drive will be mapped to the secondary
controller.
The required disks parameter specifies the physical
disks to be used, for example 2.0,2.1,2.2,2.3,2.4.
create logical-volume ld-list [primary | secondary]
Creates a logical volume from the specified logical
drives on the specified controller. Be sure to specify
the secondary keyword if the underlying logical drives
are mapped to the secondary controller.
delete logical-drives ld-list
Deletes the specified logical drives.
delete logical-volumes lv-list
Deletes the specified logical volumes.
diag abort args
Aborts the diagnostic test. Valid args are:
type { loopback | echo | write-buffer }
SunOS 5.6 Last change: May 6, 2003 7
Maintenance Commands sccli(1m)
Specify the test type.
channel ch
Specifies the channel on which the test to be
aborted is running
target id
Optionally, an individual target may be specified.
diag buffer-test args
Performs a read/write buffer test. Valid arguments are:
channel ch
Specify the channel to be tested.
target id
Specify the target on the selected channel.
payload payload
Specify the payload as a 64-bit number (e.g.
"0xA5A5A5A5")
size size
Specify a block size (e.g. 512)
count count
Specify a repetition count.
compare { yes | no }
Compare data read with data written.
stop-on-error { yes | no }
Halt the test if an error is encountered.
diag echo args
Perform a Fibre Channel ECHO test. Valid arguments are:
channel ch
Channel to be tested.
payload payload
Specify the payload as a 64-bit number (e.g.
"0xA5A5A5A5")
size size
Specify a block size (e.g. 512)
count count
Specify a repetition count.
compare { yes | no }
SunOS 5.6 Last change: May 6, 2003 8
Maintenance Commands sccli(1m)
Compare data read with data written.
stop-on-error { yes | no }
Halt the test if an error is encountered.
diag error channel ch [target id]
Display statistics for the specified channel. If the
target is displayed, output is limited to describing
the specified target.
diag loopback args
Performs a loopback test on the specified Fibre Channel
link. Valid arguments are:
channel ch
Specify the channel on which the test is to be
run.
payload payload
Specify a 32-bit hexadecimal value to be used for
the payload (for example, 0xA5A5A5A5))
size size
Specify transfer size (e.g. 512)
mode { 10bit | 1bit | external }
Specify the test mode.
count count
Specify the number of test iterations.
compare { yes | no }
Specify whether read data is compared to data
written.
stop-on-error { yes | no }
Stop when an error is detected
diag status args
Show status of tests running on the specified channel.
Valid arguments are:
type { loopback | echo | write-buffer }
Specify the type of test that's currently running.
channel ch
Specify the channel on which the test is being
performed.
target id
Optionally specify a specific target ID on the
selected channel.
SunOS 5.6 Last change: May 6, 2003 9
Maintenance Commands sccli(1m)
download controller-configuration [ options ] file
Restores controller configuration information previ-
ously saved in file using the upload configuration com-
mand. If the -r or --reset option is specified, the
controller is reset, causing the new configuration to
take effect. Valid options are:
-b, --build
Rebuild RAID sets specified in the saved confi-
guration. If this option is not specified, RAID
sets are not created.
-r, --reset
Reset the controller so that the newly-restored
configuration will take affect immediately.
Note that resetting the controller will cause sccli to
momentarily lose its current connection to the few minutes.
download controller-firmware [options] file [bootrecord]
Downloads firmware into the controller. If bootrecord
is specified, it names an additional file that is down-
loaded at the same time. This command is potentially
dangerous; use only as instructed. In a dual-
controller configuration, the failover capability of
the redundant controller pair is used to activate the
new firmware without requiring the array to be shut
down in what is known as a live upgrade or hot firmware
download operation; in a single-controller configura-
tion, the new firmware is activated by resetting the
controller.
If the -r or --reset options are specified, the con-
trollers will always be reset instead of performing a
live upgrade. This option is faster, and is recommended
when a live upgrade is not required.
The -r (or --reset) option should always be used for
single-controller configurations.
download safte-firmware filename
Downloads firmware into the SAF-TE microprocessor in a
StorEdge 3000 Family LVD enclosure.
download ses-firmware filename
Downloads firmware into the SES microprocessor in Fibre
Channel Sun StorEdge 3000 Family enclosure.
download pld-firmware filename
Downloads PLD firmware into the SES microprocessor in
fibre channel StorEdge 3000 Family enclosures.
SunOS 5.6 Last change: May 6, 2003 10
Maintenance Commands sccli(1m)
download disk-firmware filename [disk-model]
Downloads disk driver firmware into disk drives con-
nected to the StorEdge 3000 Family array. If a disk-
model string is specified, it will be matched against
SCSI INQUIRY data to determine which drives should be
programmed. This function shuts down the array con-
troller first, preventing the host from doing any nor-
mal I/O for several minutes.
fail { primary | secondary }
Simulate a controller failure and cause all the LUNs
assigned to the specified controller to fail over to
the other controller.
help Display a short synopsis of available commands.
map partition ch.tgt.lun { primary | secondary }
Map a partition to the specified host channel, target,
and LUN on the specified controller.
mute Silence the array enclosure's audible alarm.
password password
Specifies the password assigned to the array con-
troller. The user must supply the correct password
when issuing potentially dangerous commands to the
array over a network connection. For interactive ses-
sions, sccli will prompt the user for this password
only when necessary; the password command is provided
for non-interactive applications where the password
must be embedded in a script. No password is required
when accessing the array via in-band SCSI.
quit Exit the interactive command mode.
reset controller
Resets the controller. This will temporarily cause the
array to go offline, which in turn may affect applica-
tions running on any hosts connected to the array, and
might cause data loss if applications are currently
using the array.
reset nvram
Clears the NVRAM configuration memory and restores fac-
tory defaults. After issuing this command, a reset
controller operation needs to be done, and the con-
troller has to be reconfigured to restore any non-
default configuration options (those configuration
options that differ from factory defaults). Logical
devices are not deleted, but they might become inacces-
sible if they relied on non-default configuration
parameters.
SunOS 5.6 Last change: May 6, 2003 11
Maintenance Commands sccli(1m)
select device
Selects a new device to which subsequent commands are
to be issued. If no device is specified, and more than
one choice exists, a menu of choices is displayed. If
only one device is found on the system, the select com-
mand causes it to be selected automatically.
set cache-policy [mode] [policy]
Sets cache mode (write-back or write-through) and
optimization (sequential or random-access) The mode
option may be one of the following:
random-access
Optimizes for random access.
sequential
Optimizes for sequential access.
The policy option may be one of the following keywords:
write-through
Disables the write cache (writes go through to the
disk drives before being acknowledged).
write-back
Enables write caching (also known as "write-back"
or "write-behind" caching).
set controller-name string
Specifies a symbolic name for the array. The specified
string may be between 1 and 15 characters in length,
but the length of the string plus the length of the
current password must not be more than 16.
set drive-parameters parameter value
Sets the specified drive-related parameter value.
Parameters and their default values are:
scsi-io-timeout 7000
Disk drive I/O timeout in milliseconds. The
default value is 7000 (i.e. 7 seconds).
queue-depth 32
Maximum queue depth that the controller uses when
queuing commands for each disk drive. auto or the
value 0 can be specified to indicate that the
queue depth value can be computed automatically.
enclosure-polling-interval 0
Specifies the interval at which the array con-
troller polls the SAF-TE or SES environmental ser-
vices processor in the enclosure. The default
SunOS 5.6 Last change: May 6, 2003 12
Maintenance Commands sccli(1m)
value of 0 specifies that polling is disabled.
auto-detect-swap-interval 0
Interval (in milliseconds) between checks to
determine if a failed drive has been physically
replaced. The default value of 0 specifies that
polling is disabled.
smart { enabled | disabled }
Determines whether the disk drives are to perform
predictive failure analysis.
auto-global-spare { enabled | disabled }
Specifies whether the RAID controller automati-
cally allocates disk drives as global spares.
set host-parameters parameter value
Sets the specified host-channel related parameter.
Host parameters are:
max-luns-per-id 8
This parameter determines the maximum number of
logical units that can be assigned to any one SCSI
target address.
queue-depth 32
Controls the number of I/O operations that can be
queued simultaneously for a given LUN.
set icl { upper | lower } channel ch [dis]connected
This is a shortcut for the set inter-controller-link
command.
set inter-controller-link args
Fibre Channel devices in redundant pairs only. Valid
args must be entered in the order shown below:
{ upper | lower }
The upper or lower keyword specifies the array
controller slot to which the command will be
directed.
channel ch
The channel argument specifies the channel to be
modified by the command. Valid values for ch are
0, 1, 4, and 5.
{ connected | disconnected }
The final argument specifies the desired state for
the port bypass circuit.
This command is used to specify that the port bypass circuit
SunOS 5.6 Last change: May 6, 2003 13
Maintenance Commands sccli(1m)
for the specified channel on the RAID controller in the
specified slot (upper or lower) is to be enabled or dis-
abled. Normally, all inter-controller-links on both the
upper and lower controllers should be connected; disconnect-
ing the upper or lower controllers' inter-controller-link on
any given host channel breaks the internal connection
between the two controllers, and between the upper con-
troller and the external connector on the lower controller
and vice versa. This potentially doubles aggregate
bandwidth because the controllers do not have to share
bandwidth on each channel, but also prevents controller
failover from working in a transparent fashion.
set password string
Specifies a password that protects the RS-232 character
interface, telnet and ftp services from unauthorized
use. The string can be any alphanumeric string up to
15 characters in length, provided that the sum of the
lengths of the password and the controller-name parame-
ter is not more than 16. To remove an existing pass-
word, specify a zero-length string with a pair of
double-quote characters. For example:
set password ""
set rs232-configuration port speed
Specifies the speed, in bits per second, for the speci-
fied port. Single controller configurations have a
single RS-232 port (port 1). Redundant controllers
have a second port (port 2), but normally both ports
are connected together to support controller failover,
so both should be set to the same speed. The default
speed is 38400.
set unique-identifier unique-id
Specifies the unique identifier for the array subsystem
as a 5-digit hexadecimal number. This identifier is
initialized from the chassis serial number automati-
cally, and should not be changed unless the chassis is
replaced. This value is used to construct unique
values for Ethernet address, Fibre Channel WWNs, and
other identifiers, and thus changing it unnecessarily
may cause the logical units to become inaccessible to
hosts. The controller must be reset for this change to
take effect.
show cache-policy
Displays parameters that influence the performance of
the read/write cache.
show channels
Displays information about the host and drive channels.
SunOS 5.6 Last change: May 6, 2003 14
Maintenance Commands sccli(1m)
show configuration [--xml | -x] [filename]
Displays the array configuration on standard output, or
optionally writes it to the specified file. If the -x
or --xml options are specified, XML output is gen-
erated.
show disks
Displays information about the disk drives in the array
enclosure and any expansion chassis.
show events
Displays the contents of the array's event log.
show frus
Displays FRU-ID information for Field Replaceable Units
in the subsystem.
show icl arguments
A shortcut for the show inter-controller-link command,
described below.
show host-parameters
Displays the maximum I/O queue depth per LUN and the
number of LUNs that can be configured per target ID.
show inquiry-data
Displays the SCSI INQUIRY data returned by the array
controller. This command always returns the INQUIRY
vendor ID, product ID, firmware revision and IP
address. Other data can be returned depending on the
type of interface used to query the array.
show inter-controller-link [ args ]
Redundant Fibre Channel arrays only. Displays the
status of the port bypass circuit for the specified
channel on the array controller in the upper or lower
slot. If specified, the args must specify an array
controller slot location and a channel specifier, as
described below. If no arguments are specified, the
upper and lower slots of channels 0, 1, 4, and 5 are
displayed.
{ upper | lower }
Specifies the upper or lower controller.
channel ch
Specifies the channel to examine.
show ip-address
Displays the IP address of the array controller.
SunOS 5.6 Last change: May 6, 2003 15
Maintenance Commands sccli(1m)
show logical-drives [ld-list]
Displays information about all, or a specified list, of
logical drives.
show logical-volumes [lv-list]
Displays information about all, or a specified list, of
logical volumes.
show lun-maps
Shows how logical drives or logical volumes are mapped
to host SCSI channels, targets and LUNs.
show network-parameters
Displays the IP address, netmask, and default router
address of the network management port.
show partitions [ logical-devices ]
Displays information about all disk partitions, or just
those partitions allocated from the specified logical
volumes or logical drives. Valid logical devices may
be specified using one of the following forms:
logical-volumes lv-list
A list of logical volumes.
logical-disks ld-list
A list of logical disks.
show pld-revision
Standalone Fibre Channel expansion chassis SES devices
only. Displays the PLD firmware revision of the speci-
fied standalone StorEdge 3510 FC expansion chassis SES
device. The StorEdge 3510 expansion chassis must be
connected directly to the host (not to a StorEdge 3510
array controller), and the SES device must be specified
explicitly with the select command. To retrieve the
PLD firmware revision of an array controller chassis,
or of an expansion chassis connected to an array con-
troller, use the show ses-devices command instead.
show port-wwns
Fibre Channel devices only. This command displays the
World Wide Port Numbers (WWPNs) associated with each ID
on each channel.
show redundancy-mode
Displays whether the two controllers are operating
correctly as a redundant pair.
show rs232-configuration
SunOS 5.6 Last change: May 6, 2003 16
Maintenance Commands sccli(1m)
Displays RS232 port speeds.
show safte-devices
LVD SCSI array controller devices only. Displays
information returned by the SAF-TE device embedded in
StorEdge 3000 Family LVD RAID enclosures. The output
includes the channel and target ID of the SAF-TE dev-
ice, the serial number of the chassis in which it is
installed, the vendor and product ids and SAF-TE
firmware revision, and the "SAF-TE firmware package"
revision, which refers to firmware for other
microprocesses in the chassis that are managed by the
SAF-TE processor.
show ses-devices
Fibre Channel array controller devices only. Displays
a list of enclosure services devices visible to the
selected standalone array controller. The output
includes the channel and target ID of the SES device,
the serial number of the chassis in which it is
installed, the vendor and product ids and SES firmware
revision, the PLD firmware revision, and the Fibre
Channel World Wide Port Name for the device. In
redundnant configurations, SES devices are installed in
pairs and there should be two devices shown with the
same chassis serial number. Because it is important to
ensure the SES firmware and PLD revisions are con-
sistent for SES devices installed in the same chassis,
any firmware revision mismatches that might result from
replacement of an SES device FRU will be flagged with
an "*", as well as by a visual indicator on the chassis
itself. Information is shown for the array device's
enclosure, as well as any expansion chasses which may
be connected to the array. To view information about
an SES device in an expansion chasses connected
directly to the host instead of an array controller,
use the select command to specify an SES device in the
expansion chassis, and issue a show inquiry and show
pld-revision command to each device.
show unique-identifier
Displays the controller unique identifier, which
defaults to the enclosure serial number.
shutdown controller
Causes the controller to flush its cached data to disk
and then resets the controller. Use this command
before removing power from array controllers to ensure
that the write cache is empty and the data on the disks
is consistent. Otherwise, if power is removed from the
controller while the write cache contains data that has
not been written to disk, the data is preserved only as
SunOS 5.6 Last change: May 6, 2003 17
Maintenance Commands sccli(1m)
long as the battery can supply power to the
controller's memory. Any subsequent access to array
data by the host results in an error, so data loss
might occur if this command is issued while the array
is in use.
shutdown logical-drive ld
Causes the specified logical drive to be taken offline.
All data for the logical drive will be flushed to the
disk drives, and any subsequent access to the logical
drive by a host results in an error. Data loss might
occur if this command is issued while a host is
actively using the logical drive. This function
requires controller firmware revision 325P or later for
LVD array controllers, and revision 327L or later for
Fibre Channel array controllers.
unfail [secondary]
Reverse the effect of the fail secondary command, per-
mitting the secondary controller to resume operation
and restore the controller pair to normal (redundant)
operation.
unmap { partition | channel.target.lun }
Unmap the specified partition, or unmap the partition
currently mapped to the specified channel.target.lun
address.
upload controller-configuration file
Retrieves a binary description of the configuration of
the array and saves it to the specified file. The file
is not human-readable, but can be used to restore the
same configuration to the array at a later date, or to
copy the configuration to another array.
COPYRIGHT
Copyright (C) 2002-2003 Dot Hill Systems Corporation. All
rights reserved. Use is subject to license terms.
SunOS 5.6 Last change: May 6, 2003 18
se2_configcheck (1M) |
[ Top ] |
Maintenance Commands se2_configcheck(1M)
NAME
se2_configcheck - Verify the configuration of a Sun StorEdge
Solution System
SYNOPSIS
/opt/SUNWstade/Diags/bin/se2_configcheck
DESCRIPTION
se2_configcheck Verify the configuration of a Sun StorEdge
Solution System
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
se_configcheck (1M) |
[ Top ] |
Maintenance Commands se_configcheck(1M)
NAME
se_configcheck - Verify the configuration of a Sun StorEdge
Solution System
SYNOPSIS
/opt/SUNWstade/Diags/bin/se_configcheck
DESCRIPTION
se_configcheck Verify the configuration of a Sun StorEdge
Solution System
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands snapshot(1M)
NAME
snapshot - take snapshot of configuration
DESCRIPTION
The snapshot utility is accessed using the stortools(1M)
toolbar buttons "SS Update" and "SS Diff."
A SnapShot of the system is taken the first time stortools
is started. To view the snapshot, click the stortools
log button and select "SnapShot Log" under the Log
File.
Everytime stortools starts, a comparison will be made against
the current configuration and the last saved Snapshot.
If a difference is detected, a popup message will indi-
cate that a difference has been detected.
To view the snapshot differences, click the stortools
Log button and select "SnapShot Diffs" under the Log
File.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), crontab(1), cron(1M), clearcache(1M),
config_solution(1M), disk_inquiry(1M), luxadm(1M),
rasagent(1M), sanbox(1M), testt3(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands socaltest(1M)
NAME
socaltest - tests the SOC+ host adapter card
SYNOPSIS
/opt/SUNWstade/Diags/bin/socaltest
[ standard-arguments ]
[-uvelf] | [-o dev=physical-path] | elb=[enable|disable] |
ilb=[enable|disable] |
lbf=[enable|disable] | userpattern=0x-pattern |
selectpattern=[user|critical|all] |
xcnt=transfer-count | iterations=count
DESCRIPTION
The socaltest test helps in the validation and fault isola-
tion of the SOC+ host adapter card. In the case of a faulty
card, the test attempts ot isolate the fault to the card,
the GBIC module, or the DMA between the host adapter card
and the host memory.
OPTIONS
Note: If storage is connected, you can only run lbf. If no
storage is connected, you can only run ilb. If a loopback
plug is inserted, you can run all options.
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
socaltest -o
"dev=devices/sbus@3,0/SUNW,socal@d,10000/sf@0,0:devctl|
ilb=disable | elb=disable"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=physical-path
The name of the device that is returned by discman(1M).
elb=enable|disable
Enables or disables the External Loopback test.
iterations=count
Controls the number of times the loopback test will
run, for example, 100.
ilb=enable|disable
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands socaltest(1M)
Enables or disables the Internal Loopback test.
lbf=enable|disable
Enables or disables the Loopback Frame test.
xcnt=transfer-count
Buffer sizes of the pattern buffer.
userpattern=0x-pattern
Specify a user defined pattern in hexadecimal, for
example: ptn=0x7e7e7e7e
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
Standard Command-Line Arguments
The following is a lis of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands socaltest(1M)
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands stresstest(1M)
NAME
stresstest - Checks for possible SAN errors.
SYNOPSIS
/opt/SUNWstade/Diags/bin/stresstest
[ standard-arguments ]
[ -h=hostname ], [ -M=module_list ],
[ -e=email_address|email_address|... ], [ -b=background ],
[ -l=display_valid_modules ], [ -T=minutes_to_run ],
[ -N=instances_tests_to_run_per_device ]
DESCRIPTION
The stresstest induces a load on a storage area network
(SAN) and checks for errors that might occur. This program
is most effectively used to verify components that have been
recently added to a SAN.
OPTIONS
Note: All options must be listed in a quoted list and
separated by a pipe ( | ).
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
-h hostname
Runs the hostname command on the specified host-
name. If a hostname is not specified, the command
will run on the local machine. This command is
optional.
-M Modules
Specifies the module against which stresstest is
run. Determine which modules are currently valid
using the stresstest -l command. At least one
module must be specified for the stresstest to
run.
-e email_address|email_address|...
Specifies the email address(es) to where
stresstest results are sent. If no email address
is specified, then no results are sent. This com-
mand is optional.
-b background
Runs stresstest in the background. You must
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands stresstest(1M)
specify the time limit using the stresstest -T
command. The default is foreground.
-T minutes_to_run
Specifies the number of minutes to run the I/O.
This command is optional if stresstest-b is not
specified. If -T minutes_to_run is not specified,
the stresstest will run indefinitely until stopped
by a Ctrl-C or an Int signal.
-N instances_test_to_run
Specifies the number of test instances to run per
device.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), brocadetest(1M), d2disktest(1M),
daksestest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), switchtest(1M), switch2test(1M), t3ofdg(1M),
t3test(1M), t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands switch2test(1M)
NAME
switch2test - diagnose Sun StorEdge Network FC switch-8 and
switch-16 2 Gbyte Fibre Channel switches
SYNOPSIS
/opt/SUNWstade/Diags/bin/switch2test
[ standard-arguments ]
[-uvelf] [-o dev=port:ip_address:fcaddr | userpattern=0x-
pattern ]
[ iterations=number ] [ xfersize=number ] [ selectpattern= ]
[ user|critical|all] ] [ password=password ]
DESCRIPTION
The switch2test test is delivered with the SUNWstade
software. This test verifies the functionality of the Fibre
Channel ports on the Sun StorEdge Network 2 GB Fibre Channel
switch.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
switch2test -o "dev=7:172.20.67.198:0 | xfersize=250"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=port:ip_address:fcaddr
Specifies the name of the switch port to be tested.
The port:ip_address:fcaddr is the name of the device
that is returned by discman(1M). There is no default.
userpattern=0x-pattern
User specific pattern in hexadecimal, for example:
pattern=0x4a4a4a4a. Default is 7e7e7e7e.
iterations=number
Specifies the number of iterations the port test should
run. The range is 0 to 1000000. Default is 1000000.
xfersize=number
Specifies the transfer count. The range is 250 to 2000.
Default is 2000.
selectpattern=user|critical|all
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands switch2test(1M)
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
passwd
A password is required for the Sun StorEdge Network 2
GB Fibre Channel switches.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-c Enables a core image of the test process to be created
in the current working directory upon receipt of cer-
tain signals, otherwise those signals are caught and
handled to prevent a core from being generated. The
default is to disable the creation of a core image.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-f Runs the test in full Functional test mode. This mode
assumes that the test has complete control of the dev-
ice under test. See the note below. The default is
false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), brocadetest(1M), d2disktest(1M),
daksestest(1M), daktest(1M), dex(1M), discman(1M),
fcdisktest(1M), fctapetest(1M), ifptest(1M), lbf(1M),
linktest(1M), qlctest(1M), ras_admin(1M), ras_revcheck(1M)
socaltest(1M), stresstest(1M), switchtest(1M), t3ofdg(1M),
t3test(1M), t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands switch2test(1M)
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands switchtest(1M)
NAME
switchtest - diagnose Sun StorEdge Network Fibre Channel
switch-8 and switch-16 switches
SYNOPSIS
/opt/SUNWstade/Diags/bin/switchtest
[ standard-arguments ]
[-uvelf] [-o dev=port:ip_address:fcaddr] [ userpattern=0x-
pattern ]
[iterations=number ] [xfersize=number ]
selectpattern=[user|critical|all]
DESCRIPTION
The switchtest test is delivered with the SUNWstade
software. This test verifies the functionality for the
Media, File System, and Asynchronous I/O subtests.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
switchtest -o "dev=7:172.20.67.198:0 | xfersize=250"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=port:ip_address:fcaddr
Specifies the name of the switch port to be tested.
The port:ip_address:fcaddr is the name of the device
that is returned by discman(1M). There is no default.
userpattern=0x-pattern
User specific pattern in hexadecimal, for example:
pattern=0x4a4a4a4a. Default is 7e7e7e7e.
iterations=number
Specifies the number of iterations the port test should
run. The range is 0 to 1000000. Default is 1000000.
xfersize=number
Specifies the transfer count. The range is 250 to 2000.
Default is 2000.
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands switchtest(1M)
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
See the note below. The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), t3volverify(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands t3ofdg(1M)
NAME
t3ofdg - tests the functionality of the Sun StorEdge T3
array
SYNOPSIS
/opt/SUNWstade/Diags/bin/t3ofdg
[ standard-arguments ]
health_check=[enable|disable] fast_test=[enable|disable]
fast_find=[enable|disable] find=[enable|disable]
syslog=[enable|disable] [ dev=T3-name-IP address ] [
enc_id=enclosure_ID ]
loop=[1|2] [ usr=T3adminusername ] [ passwd=T3admin-password
]
DESCRIPTION
The t3ofdg test runs the internal diagnostics of the Sun
StorEdge T3 array.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe (|), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
heath_check=enable|disable
Health check runs fast_test multiple times, one time
for each loop per unit. Default is disable.
fast_test=enable|disable
Fast_test performs a fast Go/No Go test of the selected
enclosure and loop. It does not attempt to detect bad
FRUs. Default is disable.
fast_find=enable|disable
fast_find can be used to detect bad loop cards, inter-
connect cables, and controllers. Fast_find does not
try to isolate down to a single disk port. Run
fast_find before find to eliminate loop cards, inter-
connect cables, and controllers as bad FRU(s) before
the midplane or disks are suspected (which are checked
using find). Default is disable.
find=enable|disable
find performs an extensive Go/No Go test. If loop
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands t3ofdg(1M)
failures are detected, it automatically initiates the
full loop fault isolation diagnostic. The loop fault
diag has the capability to detect and isolate a single
disk port, but is very time-consuming. Default is dis-
able.
syslog=enable|ofdg|disable
Enable will dump all syslog entries, that have been
added while the test is running, to the screen. ofdg
will dump only OFDG lines, added to the syslog, to the
screen. Default is disable.
dev=T3 IP Address
If a host name is set for the device, it can be used as
well.
enc_id=1|2|all
enc_id applies only to Partner groups and specifies
enclosures on which to run test. all will run on
enclosure 1, then on enclosure 2. The default is 1.
loop=1|2|all
Specifies which loop to test. All tests both. Default
is 1.
usr=T3adminusername
Specify login name.
passwd=T3admin Password
Specify Password.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provide affirmative answer to following question:
WARNING - Volume data will be offline while OFDG is
running. Continue ? [N] :
-k Attempt to abort Tests currently running on specified
Sun StorEdge T3 array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false .
ATTRIBUTES
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands t3ofdg(1M)
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands t3test(1M)
NAME
t3test - tests the functionality of the Sun StorEdge T3 and
T3+ array LUNs
SYNOPSIS
/opt/SUNWstade/Diags/bin/t3test
[ standard-arguments ]
[-uvelf] | [-o "dev=DeviceName"] | partition=0-7(mount-
point) | rawsub=[enable|disable] |
method=[AsyncIO | SyncIO] | rawiosize=size |
fstest=[enable|disable] |
userpattern=0xPattern | fssize=file-system-size |
fsiosize=IO-transfer-size |
selectpattern=[user|critical|all] |
logcheck=[enable|disable] |
rawcoverage=number | checkrdls=[enable|disable] ] |
wrdevbuf=[enable|disable] |
wrdevbufiterations=number
DESCRIPTION
The t3test test verifies the functionality of Sun StorEdge
T3 array logical unit numbers (LUNs) using three subtests:
Media, File System, and Asynchronous I/O. An instance of
t3test is present for each LUN.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
t3test -o "dev=/dev/rdsk/c3t4d2s2 | selectpattern=critical"
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=DeviceName
The name of the device that is returned by discman(1M).
For example, /dev/rdsk/c0t3d0s2.
partition=0-7(mount-point)
Specifies the partition number to test as
partition=6(/export/s6) if mounted on partition 6.
rawsub=enable|disable
Enables or disables the media subtest.
method=SyncIO|AsyncIO|SyncIO+AsyncIO
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands t3test(1M)
Specifies the Media Test Methods (SyncIO and AsyncIO).
rawiosize=number
Specifies the media size to transfer. number can be one
of the following:
2KB|16KB|32KB|64KB|128KB|256KB|512KB
userpattern=0xPattern
Specifies a specific pattern for file system testing.
fstest=enable|disable
Enables or disables the File System subtest.
selectpattern=user|critical|all
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
fssize=number
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=numberKB
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
[ 512B|1024B|10KB|40KB|80KB ]
logcheck=enable|disable
Checks the Sun StorEdge T3 array log for errors during
test.
checkrdls=enable|disable
Monitor read link status counters for errors.
rawcover=coverage
Specifies media coverage from 0-100% of the partition.
W/R Device Buffer Test=enable|disable
Enables or disables the W/R buffer test.
W/R Device Buffer Iterations=number
Specifies the number of times to loop the W/R Device
Buffer Test.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands t3test(1M)
-c Enables a core image of the test process to be created
in the current working directory upon receipt of cer-
tain signals, otherwise those signals are caught and
handled to prevent a core from being generated. The
default is to disable the creation of a core image.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-f Runs the test in full Functional test mode. This mode
assumes that the test has complete control of the dev-
ice under test. The default is false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands t3volverify(1M)
NAME
t3volverify - Runs manual parity checks on Sun StorEdge T3
array volumes
SYNOPSIS
/opt/SUNWstade/Diags/bin/t3volverify
[ standard-arguments ]
dev=T3_Name_or_Address | usr=T3_admin_username |
passwd=T3_admin_password |
volume_name=volume_name | fix_errors=[yes|no] | rate=[1-16]
DESCRIPTION
The t3volverifytest instantiates and monitors a manual par-
ity check on existing RAID 5 and RAID 1 volumes. The HTTP
token interface of the Sun StorEdge T3 Array is utilized for
communication. If the Ethernet connection to the Sun
StorEdge T3 Array does not exist or is broken, t3volverify
cannot run properly.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=T3_Name_or_Address
The IP address of the Sun StorEdge T3 Array. If a host
name is set for the device, the host name can also be
used.
usr=T3_admin_username
Specifies the login name.
passwd=T3_admin_password
Specifies the password for the Sun StorEdge T3 Array.
volume_name=volume_name
Specifies the existing volume to run against.
fix_errors=yes|no
The fix_errors option corrects parity errors on RAID 5
volumes and corrects mirrored data errors on RAID 1
volumes. If fix_errors is not enabled, then
t3volverify will report errors, but not correct them.
SunOS 5.6 Last change: 04 April 2002 1
Maintenance Commands t3volverify(1M)
If the fix_errors option is specified and an error is
detected, the volverify running on the Sun StorEdge T3
Array will regenerate parity from the existing data on
the volume.
rate=1-8
8 = the fastest, with the greatest performance loss on
the Host I/O. 1 = the slowest, with the least perfor-
mance loss on the Host I/O.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provides an affirmative answer to the following ques-
tion: WARNING - Volume data will be offline while vol-
verify is running. Continue? [N]:
-k Attempts to abort any and all volume operations
currently running on the specified Sun StorEdge T3
Array. Will not start any volverify operations on the
Sun StorEdge T3 Array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
6120ofdg(1M), 6120ondg(1M), 6120volverify(1M) vediag(1M),
veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 04 April 2002 2
Maintenance Commands t3volverify(1M)
SunOS 5.6 Last change: 04 April 2002 3
Maintenance Commands testt3(1M)
NAME
testt3 - retrieve tokens from a Sun StorEdge T3 array
SYNOPSIS
/opt/SUNWstade/bin/testt3
DESCRIPTION
testt3 is used to retrieve tokens from a Sun StorEdge T3,
T3+, and 6120 array. This test is used to verify that the
IP that was used is correct and IP points to a Sun StorEdge
T3, T3+, or 6120 array.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
checkcron(1M), clearcache(1M), disk_inquiry(1M) luxadm(1M),
rasagent(1M), ras_install(1M), sanbox(1M), attributes(5)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands vediag(1M)
NAME
vediag - Runs virtualization engine diagnostics through
SLICD
SYNOPSIS
/opt/SUNWstade/Diags/bin/vediag
[ standard-arguments ]
dev=login | target=target | sddiag=[enable|disable] |
sudiag=[enable|disable] | initiator=[I1|I2]
DESCRIPTION
The ve_diag test instantiates and monitors diagnostics on
the virtualization engine. SLICD is utilized to start and
stop the virtualization engines; hence, SLICD must be
operating properly to run the VE diagnostics.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=login
Specifies the signon path, as specified in the SLICD
configuration file.
target=target
Specifies the target number of a LUN on the Sun
StorEdge T3 Array. The target number only needs to be
specified if SDDIAG is enabled.
SDDIAG=enable|disable
Enables or disables the SD diagnostic on the virtuali-
zation engine. Tests the connection to the Sun
StorEdge T3 Array LUN, specified by the target.
SUDIAG=enable|disable
Enables or disables the SU diagnostic on the virtuali-
zation engine. Tests buffer memory, CPU memory, FC
chip, and Ethernet chip.
initiator=I1|I2
Specifies on which virtualization engine to run diag-
nostics: I1 is for the master and I2 is for the slave.
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands vediag(1M)
WARNING: This test will reboot the router.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test- specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands veluntest(1M)
NAME
veluntest - tests the functionality of the virtualization
engine by accessing the VLUNs.
SYNOPSIS
/opt/SUNWstade/Diags/bin/veluntest
[ standard-arguments ]
[-uvelf] | [-o dev=DeviceName] | partition=0-7(mount-point)
|
rawsub=[enable|disable] | method=[AsyncIO | SyncIO] |
rawiosize=size |
fstest=[enable|disable] | userpattern=0xPattern |
fssize=file-system-size | fsiosize=IO-transfer-size |
selectpattern=[user|critical|all] | rawcoverage=number
DESCRIPTION
The veluntest test verifies the functionality of the in-band
virtualization engine logical unit numbers (LUNs) using
three subtests: Media, File System, and Asynchronous I/O.
An instance of veluntest is present for each LUN.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
veluntest -o dev=/dev/rdsk/c3t4d2s2 | selectpattern=critical
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=DeviceName
The name of the device that is returned by discman(1M).
For example, /dev/rdsk/c0t3d0s2.
partition=0-7 (mount-point)
Specifies the partition number to test as
partition=6(/export/s6) if mounted on partition 6.
rawsub=[ enable|disable ]
Enables or disables the media subtest.
method=SyncIO|AsyncIO|SyncIO+AsyncIO
Specifies the Media Test Methods (SyncIO and AsyncIO).
rawiosize=number
Specifies the media size to transfer. size can be one
SunOS 5.6 Last change: 20 December 2002 1
Maintenance Commands veluntest(1M)
of the following:
2KB|16KB|32KB|64KB|128KB|256KB|512KB
userpattern=0xPattern
Specifies a specific pattern for file system testing.
fstest=[ enable|disable ]
Enables or disables the File System subtest.
selectpattern=[ user|critical|all ]
Choice of pattern to run. user is the one pattern
entered above. critical is the I/O pattern causing
device failure. all is a complete list of patterns.
critical is the default pattern.
fssize=file-system-size
Indicates the file system subtest size in kilobytes or
megabytes:
K|k|KB|kb-kilobytes
M|m|MB|mb-megabytes
[ 512KB|2MB|8MB|20MB|100MB|200MB ]
fsiosize=numberKB
Indicates the size of the file system subtest I/O
transfer in bytes or kilobytes:
{512B|1024B|10KB|40KB|80KB}
rawcover=number
Specifies media coverage from 0-100 of the partition.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-l Runs the test in Online Functional mode. This is the
same mode that tests run in when executed with the
vtsui.online command. It is a non-intrusive version
that will not significantly affect other applications.
The default is true.
-o Used to indicate that the options and arguments that
follow are test specific.
SunOS 5.6 Last change: 20 December 2002 2
Maintenance Commands veluntest(1M)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), dex(1M),
discman(1M), fcdisktest(1M), fctapetest(1M), ifptest(1M),
lbf(1M), linktest(1M), qlctest(1M), ras_admin(1M),
ras_revcheck(1M) socaltest(1M), stresstest(1M),
switchtest(1M), switch2test(1M), t3ofdg(1M), t3test(1M),
t3volverify(1M), 6120ofdg(1M), 6120ondg(1M),
6120volverify(1M) vediag(1M),
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 20 December 2002 3
Maintenance Commands volverify(1M)
NAME
volverify - Runs manual parity checks on Sun StorEdge T3,
T3+, and 6120 array volumes
SYNOPSIS
/opt/SUNWstade/Diags/bin/volverify
[ standard-arguments ]
dev=T3_Name_or_Address | usr=T3_admin_username |
passwd=T3_admin_password |
volume_name=volume_name | fix_errors=[yes|no] | rate=[1-16]
DESCRIPTION
The volverify instantiates and monitors a manual parity
check on existing RAID 5 and RAID 1 volumes. The HTTP token
interface of the Sun StorEdge T3, T3+, or 6120 Array is
utilized for communication. If the Ethernet connection to
the Sun StorEdge T3, T3+, or 6120 Array does not exist or is
broken, volverify cannot run properly.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=T3_Name_or_Address
The IP address of the Sun StorEdge T3 Array. If a host
name is set for the device, the host name can also be
used.
usr=T3_admin_username
Specifies the login name.
passwd=T3_admin_password
Specifies the password for the Sun StorEdge T3 Array.
volume_name=volume_name
Specifies the existing volume to run against.
fix_errors=yes|no
The fix_errors option corrects parity errors on RAID 5
volumes and corrects mirrored data errors on RAID 1
volumes. If fix_errors is not enabled, then volverify
will report errors, but not correct them. If the
SunOS 5.6 Last change: 07 April 2003 1
Maintenance Commands volverify(1M)
fix_errors option is specified and an error is
detected, the volverify running on the Sun StorEdge T3
Array will regenerate parity from the existing data on
the volume.
rate=1-8
8 = the fastest, with the greatest performance loss on
the Host I/O. 1 = the slowest, with the least perfor-
mance loss on the Host I/O.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provides an affirmative answer to the following ques-
tion: WARNING - Volume data will be offline while vol-
verify is running. Continue? [N]:
-k Attempts to abort any and all volume operations
currently running on the specified Sun StorEdge T3
Array. Will not start any volverify operations on the
Sun StorEdge T3 Array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), fcdisktest(1M),
fctapetest(1M), ifptest(1M), linktest(1M), qlctest(1M),
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), 6120ofdg(1M),
vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 07 April 2003 2
Maintenance Commands volverify(1M)
SunOS 5.6 Last change: 07 April 2003 3
volverifytest (1M) |
[ Top ] |
Maintenance Commands volverify(1M)
NAME
volverify - Runs manual parity checks on Sun StorEdge T3,
T3+, and 6120 array volumes
SYNOPSIS
/opt/SUNWstade/Diags/bin/volverify
[ standard-arguments ]
dev=T3_Name_or_Address | usr=T3_admin_username |
passwd=T3_admin_password |
volume_name=volume_name | fix_errors=[yes|no] | rate=[1-16]
DESCRIPTION
The volverify instantiates and monitors a manual parity
check on existing RAID 5 and RAID 1 volumes. The HTTP token
interface of the Sun StorEdge T3, T3+, or 6120 Array is
utilized for communication. If the Ethernet connection to
the Sun StorEdge T3, T3+, or 6120 Array does not exist or is
broken, volverify cannot run properly.
OPTIONS
Note: All options must be listed in a quoted list following
the standard argument -o option. The options must be
separated by a pipe ( | ), for example:
command-name -o "dev=path | ..."
Options can be one or more of the following and can be used
with the standard command-line arguments that are listed
below.
dev=T3_Name_or_Address
The IP address of the Sun StorEdge T3 Array. If a host
name is set for the device, the host name can also be
used.
usr=T3_admin_username
Specifies the login name.
passwd=T3_admin_password
Specifies the password for the Sun StorEdge T3 Array.
volume_name=volume_name
Specifies the existing volume to run against.
fix_errors=yes|no
The fix_errors option corrects parity errors on RAID 5
volumes and corrects mirrored data errors on RAID 1
volumes. If fix_errors is not enabled, then volverify
will report errors, but not correct them. If the
SunOS 5.6 Last change: 07 April 2003 1
Maintenance Commands volverify(1M)
fix_errors option is specified and an error is
detected, the volverify running on the Sun StorEdge T3
Array will regenerate parity from the existing data on
the volume.
rate=1-8
8 = the fastest, with the greatest performance loss on
the Host I/O. 1 = the slowest, with the least perfor-
mance loss on the Host I/O.
Standard Command-Line Arguments
The following is a list of the command-line arguments that
can be specified along with the other options.
-y Provides an affirmative answer to the following ques-
tion: WARNING - Volume data will be offline while vol-
verify is running. Continue? [N]:
-k Attempts to abort any and all volume operations
currently running on the specified Sun StorEdge T3
Array. Will not start any volverify operations on the
Sun StorEdge T3 Array.
-u Displays command-line usage information.
-v Runs the test in Verbose mode and displays messages
with more detailed information about the testing pro-
cess. The default is false.
-o Used to indicate that the options and arguments that
follow are test specific.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute: box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE
VALUE = Availability SUNWstade
SEE ALSO
a5ktest(1M), a5ksestest(1M), brocadetest(1M),
d2disktest(1M), daksestest(1M), daktest(1M), fcdisktest(1M),
fctapetest(1M), ifptest(1M), linktest(1M), qlctest(1M),
socaltest(1M), stresstest(1M), switchtest(1M),
switch2test(1M), t3ofdg(1M), t3test(1M), 6120ofdg(1M),
vediag(1M), veluntest(1M)
Storage Automated Diagnostic Environment User's Guide
SunOS 5.6 Last change: 07 April 2003 2
Maintenance Commands volverify(1M)
SunOS 5.6 Last change: 07 April 2003 3