Sun Microsystems Storedge A7000 User manual

901 San Antonio Road
Palo Alto, CA 94303-4900 USA
650 960-1300 Fax [phone]
Sun StorEdge™A7000
System Test Package
Reference Manual
Part No. 805-4890-10
December 1998, Revision A
Sun Microsystems, Inc.
Send comments about this document to: [email protected]

Please
Recycle
Copyright 1998 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 USA. All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and
decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization
of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in
the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, AnswerBook, Java, the Java Coffee Cup, StorEdge, and Solaris are trademarks, registered trademarks, or
service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an
architecture developed by Sun Microsystems, Inc.
The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges
the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun
holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN
LOOK GUIs and otherwise comply with Sun’s written license agreements.
RESTRICTEDRIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR 52.227-14(g)(2)(6/87) and
FAR 52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR 227.7202-3(a).
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-
INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright 1998 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 Etats-Unis. Tous droits réservés.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la
décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans
l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie
relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque
déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, AnswerBook, Java, le logo Jave Coffee Cup, StorEdge, et Solaris sont des marques de fabrique ou des
marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont
utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres
pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.
L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun
reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique
pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence
couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux
licences écrites de Sun.
CETTE PUBLICATION EST FOURNIE "EN L’ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y
COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE
UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE
GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

Contents iii
Contents
Preface vii
1. Starting and Configuring STP 1
Starting STP 1
Main Menu Selections 2
1 Configuration Menu 2
2 Online-Exerciser 2
3 BSC-SDLC 2
4 fsx 2
5 Disk Read Write 2
6 Disk Read Only 2
7 Done Select 3
8 List Selections 3
9 Clear Selections 3
10 HELP 3
11 EXIT 3
Configuring STP 4
Configuration Menu Selections 5
1 RETURN 5

Contents iv
2 Show OE Test Configuration 5
3 Show OE Trusted Hosts 6
4 Show FSX Configuration 6
5 Check OE Test Configuration 6
6 Change OE Trusted Hosts 7
7 Change OE Test Configuration 8
8 Change FSX Configuration 12
9 Show Disks to be Partitioned 12
10 Change Disks to be Partitioned 13
11 Setup Disks to be Partitioned 13
12 Partition Disks 13
13 Make Filesystems 13
14 Mount Disks 13
15 Show Disk Test Configuration 13
16 Change Disk Test Configuration 14
17 Setup Disk Test Configuration 14
2. Using STP 1
Single Point Of Control (SPOC) 1
OE Test 1
Test Selection 2
STP Commands 3
do_stp 3
kill_stp 3
analyze 3
clean_stp 4

Tables v
Tables
TABLE P-1 Typographic Conventions viii
TABLE P-2 Related Documentation ix

vi Sun StorEdge A7000 System Test Package Reference Manual •December 1998

vii
Preface
Sun StorEdge A7000 System Test Package Reference Manual describes a menu-driven test
facility used to exercise the Sun StorEdge A7000 Intelligent Storage Server System. The
System Test Package (STP) provides a method for configuring a variety of tests that you can
run against a system. It also provides a central location for reviewing log files and allows you
to set up test combinations and save them for later use. This manual contains information
about:
■Starting and configuring STP
■STP Menu selections
■STP Error messages
■Building a test group and using single point of control to run the tests on multiple
subsystems.
How This Book Is Organized
Chapter 1 “Starting and Configuring STP” describes how to access the System Test
Package (STP) and the configuration requirements for using it. It also describes each of the
selections available from the Main Menu and Configuration Menu and related error
messages.
Chapter 2 “Using STP” describes how to build a test group and the commands used to
start and stop test group execution and analyze test results.

viii Sun StorEdge A7000 System Test Package Reference Manual • December 1998
Typographic Conventions
TABLE P-1 Typographic Conventions
Typeface or
Symbol Meaning Examples
AaBbCc123 The names of commands,
files, and directories;
on-screen computer
output.
/.rhosts
do_stp
AaBbCc123 What you type, when
contrasted with on-screen
computer output.
Enter Trusted Hosts for OE nettest
separated by spaces. i.e. sysgem4
steroid manmax08...
(<CR> for none): sysgem4
AaBbCc123 Variable expressions;
replaced with a real name
or value.
do_stp filename
.
.
.
The vertical ellipsis
indicates continuation
of system output.
In the following example, additional information
would be displayed in place of the vertical
ellipsis:
sysgem4 root
gem60 root
gem70 root
.
.
.
<> In examples of
command input, an
item surrounded by a
greater than and less
than sign must be
replaced with an
action. The greater than
and less than signs are
omitted when
performing the action.
<CR> means press the Return key.

ix
Related Documentation
Sun Documentation on the Web
The docs.sun.comsm web site enables you to access Sun technical documentation on the
Web. You can browse the docs.sun.com archive or search for a specific book title or
subject at:
http://docs.sun.com
Sun Welcomes Your Comments
We are interested in improving our documentation and welcome your comments and
suggestions. You can email your comments to us at:
[email protected]
Please include the part number of your document in the subject line of your email.
TABLE P-2 Related Documentation
Type Title
Software reference Sun StorEdge A7000 Online Exerciser Reference Manual

xSun StorEdge A7000 System Test Package Reference Manual • December 1998

1-1
CHAPTER 1
Starting and Configuring STP
Starting STP
To start the System Test Package (STP), log in to the system as user stp and become
Super User. Then enter ./stp to display the Main Menu in the following format:
********************************************************************
System Test Package Rev: 10.x
********************************************************************
1) CONFIGURATION MENU
2) Online-Exerciser
3) BSC-SDLC
4) fsx
5) Disk Read Write
6) Disk Read Only
7) Done Select
8) List Selections
9) Clear Selections
10) HELP
11) EXIT
Select from the above choices. Choose #7 to Continue:

1-2 Sun StorEdge A7000 System Test Package Reference Manual • December 1998
Main Menu Selections
A brief description of each main menu selection follows.
1 Configuration Menu
Use this selection to display the Configuration Menu. The Configuration Menu
allows you to configure the tests you want to execute.
2 Online-Exerciser
Use this selection to start the Online Exerciser (OE). The Online Exerciser runs a test
group containing all the tests listed in the OE config file. You must set up the OE
config file using the appropriate selection from the Configuration Menu.
3 BSC-SDLC
This selection is not supported on the Sun StorEdge A7000 Intelligent Storage Server
System.
4 fsx
Use this selection to start the File System Exerciser, which causes heavy disk activity.
You select the file systems to exercise from the Configuration Menu.
5 Disk Read Write
Use this selection to start the disk read/write test.
6 Disk Read Only
Use this selection to start the disk read only test.

Chapter 1 Starting and Configuring STP 1-3
7 Done Select
Selection of Main Menu items continues until you select this option. Use this option
to start processing your selections.
8 List Selections
Use this selection to display the currently selected tests.
9 Clear Selections
Use this selection to clear the currently selected tests.
10 HELP
Use this selection to display the Help Menu. Choose the topic where help is needed.
11 EXIT
Use this selection to immediately end your STP session and return to the shell
prompt.

1-4 Sun StorEdge A7000 System Test Package Reference Manual • December 1998
Configuring STP
Before using the System Test Package, you must set up a Trusted Hosts (/.rhosts)
file. To run STP you must have root privileges on the systems to be used as the
Trusted Hosts for the tests. The /.rhosts file on each system must be modified to
give you and your system root privileges. The following is an example of a
/.rhosts file:
Note – The /.rhosts file must be modified for each system that is used as a
Trusted Host.
sysgem4 root
gem60 root
gem70 root
gemimax root
.
.
.

Chapter 1 Starting and Configuring STP 1-5
Configuration Menu Selections
Select item 1 on the Main Menu to display the Configuration Menu in the following
format:
A description of each menu selection and, if applicable, error messages with
explanations follows.
1 RETURN
Use this selection to return to the Main Menu.
2 Show OE Test Configuration
Use this selection to show the current configuration of the Online Exerciser (OE) test.
*********************************************************************
System Test Package Rev: 10.x
*********************************************************************
CONFIGURATION MENU
1) RETURN 10) Change Disks to be Partitioned
2) Show OE Test Configuration 11) Setup Disks to be Partitioned
3) Show OE Trusted Hosts 12) Partition disks
4) Show FSX Configuration 13) Make filesystems
5) Check OE Test Configuration 14) Mount disks
6) Change OE Trusted Hosts 15) Show Disk Test Configuration
7) Change OE Test Configuration 16) Change Disk Test Configuration
8) Change FSX Configuration 17) Setup Disk Test Configuration
9) Show Disks to be Partitioned
Select from the above choices. Choose #1 to Continue:

1-6 Sun StorEdge A7000 System Test Package Reference Manual • December 1998
3 Show OE Trusted Hosts
Use this selection to show the hostnames of the systems to which the Online
Exerciser (OE) net test will be run.
4 Show FSX Configuration
Use this selection to show the directories where FSX is configured. The following
display appears. This example shows that the File System Exerciser is configured in
the directory /user1.
5 Check OE Test Configuration
Use this selection to perform a check on the Online Exerciser (OE) config file. If an
error is found, one of the following messages is displayed:
File System Exerciser -> configured on: /user1
(EOF)<q>uit <CR> to page through
Message Description
Non-numeric field, xxx, found in yyy
entry. The specific field, xxx, in entry yyy is expected to be numeric and it is not.
Trusted Hosts has not been set up in
stp. The selected Trusted Hosts for the OE net test have not been entered. To
enter, select item 6 from the
Configuration Menu and enter the
desired Trusted Hosts.
xxx is not responding The selected entry for the net test is
not responding to the ping command.
You do not have root privileges on xxx
Check the /.rhosts file on xxx.The hostname is not in xxx’s /.rhosts file.
Invalid number of fields (xof 8)-> xxx
entry in config file. An invalid number of fields is in the xxx entry.

Chapter 1 Starting and Configuring STP 1-7
6 Change OE Trusted Hosts
Use this selection to enter the Trusted Hosts to be configured for the Online
Exerciser (OE) net test. The following message is displayed. Enter a host or hosts
separated by spaces or press the Return key to specify no host configuration.
The STP program then performs a query to the /.rhosts file on the selected host
(sysgem4) to verify root privileges.
In the following example, the STP program determined that the user did not have
root privileges and instructed the user to re-enter a Trusted Host. Pressing the
Return key does not automatically configure root privileges on the specified host.
Error in RMS entry
Field xmust be in the form 0x.... The short I/O address of the RMS must be in the following format:
0x0000 for 0xfff40000, 0x1000 for
0xfff41000, 0x2000 for 0xfff42000, etc.
Unknown entry xxxx xxxx is not a known entry.
There are no entries in your Config
File!! You must have at least one valid entry in your Config File.
Enter Trusted Hosts for OE nettest separated by spaces.
i.e. sysgem4 steroid manmax08...
(<CR> for none): sysgem4 <CR>
Checking root privileges on sysgem4...
You do not have root privileges on sysgem4.
Check the /.rhosts file on sysgem4.
Enter Trusted Hosts for OE nettest separated by spaces.
i.e. sysgem4 steroid manmax08...
(<CR> for none): gemimax <CR>
Message Description

1-8 Sun StorEdge A7000 System Test Package Reference Manual • December 1998
7 Change OE Test Configuration
Use this selection to display a file you can edit to change the information in the OE
Test configuration. Use the vi text editor to edit the file. The OE configuration file is
displayed in the following format:
# Test Name -> The name of the test to run.
# Valid Names are: core,disk,cd,tape,mem,umax,net,rms,
# vssc,tapecar,umaxhsdv,readmem and hsd
#
# *****************************************************
# If the test name is not one of the above it is
# assumed to be a hostname for remote tests.
# *****************************************************
#
# core -> includes disk,tape,mem,cd and umax
#disk -> runs OE disk test on all disks
# currently configured in the system
# (msd,m328d)
# tape -> runs OE tape test on all tapes
# currently configured in the system
# (mst,m328t)
# cd -> runs OE cd test on all cd's currently
# configured in the system(cdr)
# tapecar -> runs OE Tape Carousel test on
# specified tape
# mem -> runs OE mem test on specified size of
# memory
# readmem -> runs OE Read-Only memtest on specified
# size of memory
# lp -> runs OE generic test as follows:
# ~stp/lp/lptest | lp
# umax -> runs OE Umax test
# net -> runs OE net test on specified host
# or hosts
# rms -> runs OE rms test in loopback or
# remotely on specified host
# vssc -> runs OE vssc test on specified boards
# hsd -> runs OE hsd test on specified boards
# umaxhsdv -> runs OE hsd test on specified boards
#
# Passes -> The number of passes of this test to run.(0 means
# run forever) If 0 is pass count for core, tape is
# set to 10.
#
#

Chapter 1 Starting and Configuring STP 1-9
# Copies -> The number of copies of a particular test to run.
# ONLY “1” IS VALID FOR core.(core runs 1 copy of each
# test)
# ONLY “1” IS VALID FOR rms. (rms can only run 1 copy
# at a time)
# ONLY “1” IS VALID FOR vssc.(vssc can only run 1 copy
# at a time)
# ONLY “1” IS VALID FOR hsd. (hsd can only run 1 copy
# at a time)
# ONLY “1” IS VALID FOR umaxhsdv.(can only run 1 copy
# at a time)
# ONLY “1” IS VALID FOR lp. (lp can only run 1 copy
# at a time)
#
# !!!!!!!!!! WARNING: The following tests gang cpu's: hsd,
# !!!!!!!!!! mem(gang), readmem and umax. You can
# !!!!!!!!!! not run more copies of these tests
# !!!!!!!!!! together, than your system has
# !!!!!!!!!! (cpu's - 1).
#
# !!!!!!!!!! WARNING: When Multiple RMS Boards are
# !!!!!!!!!! configured to be tested on the same
# !!!!!!!!!! machine, they must be placed in
# !!!!!!!!!! descending order with respect to their
# !!!!!!!!!! memory size.(i.e. 64 before 16 before
# !!!!!!!!!! 4)
#
# Field1 -> This field has different meanings for the following
# tests.
# disk,cd NO MEANING -> MUST BE "------"
#
# tape Delay between passes in seconds
# core Umaxtest run Mode(must be gang or
# ungang)
# umax Test run Mode(must be gang or ungang)
# tapecar Logical tape id 0 -> /dev/rmt/0h
# 1 -> /dev/rmt/1h
# 2 -> /dev/rmt/2h
# v0 -> /dev/rmt/v0h
# v2 -> /dev/rmt/v2h
# mem Size of memory area in Megabytes
# readmem Address of memory area in hex
# Only valid if test run in USER mode!!!
# net Host to test.(must be a valid hostname
# or TRUSTED_HOSTS) TRUSTED_HOSTS means:
# use the response from OE Trusted
# Hosts(CONFIG MENU) for test host(s).

1-10 Sun StorEdge A7000 System Test Package Reference Manual • December 1998
# rms Number of rms_tests to run per board
# vssc Number of vssc's to run
# hsd Number of VMIC HSD's
# umaxhsdv First hsdv device e.g. hsdv0
# lp Number of Columns on page
#
# Field2 -> This field has different meanings for the following
# tests:
# disk,tape,net,cd and
# umax NO MEANING -> MUST BE “------”
#
# core Tapetest Delay in seconds
# mem Test run Mode(must be gang or ungang)
# readmem Size of memory area in Megabytes
# Only valid if test run in USER mode!!!
# tapecar Carousel drive number(must be 1 or 2)
# rms Short IO address of board on local
# host
# vssc Internal Pass count(0 means only 1
# download)
# hsd VMIC HSD MODE(EFC,IBLE or IBL)
# umaxhsdv Second hsdv device e.g. hsdv1
# lp Number of pages to print
#
# Field3 -> This field has different meanings for the following
# tests:
# core,disk,tape,vssc,net,mem,cd,umaxhsdv and
# umax NO MEANING -> MUST BE “------”
#
# readmem Test run mode(must be CPU, EXP, ALL or
# USER)
# tapecar Serial port connected to tape Carousel
# (must be tty01, tty02 or tty03.)
# rms Size of board in Megabytes
# hsd Number of HSDV's
# lp Number of lines per page
#
# Field4 -> This field has different meanings for the following
# tests.
# core,disk,tape,vssc,net,mem,readmem,cd,umaxhsdv and
# umax NO MEANING -> MUST BE “------”
#
# tapecar Tape slot number must be in the range
# 0-40.
# rms Remote Host(Local or a Trusted Host)
# hsd HSDV MODE(EFC,IBLE or IBL)
# lp Name of lp printer
#