Sun System Diagnostics Manual 800-1738
Contents
1. 2 2 1 Editing the passwd File 2 2 Logging In OI g AI EISEN poo UU Xn GUI uen RD UID UU OU UU Using Sun System Diagnostics You will not be able to log in and run sysdiag unless you do the following first while running the SunOS operating system You will now see a line in the passwd file that looks like this sysdiag 0 1 System Diagnostic pathname Take the asterisk out of that line it keeps anyone from logging in as sysdiag When you are done the line should look like this sysdiag 0 1 System Diagnostic pathname If you are logged in presently you must fully log out If you are using the win dow system you must exit SunView first then log out Once you are logged out and have received the login prompt login as sysdiag Select the p option from the main menu to create a sysdiag password The Main Menu section in this chapter describes this command Sysdiag will then place the password where the asterisk wasinthe etc passwd file and whenever anyone logs in as sysdiag t2. Chapter 2 Using Sun System Diagnostics 2 1 Editing the passwd File ua 2 2 Logging In 2 3 Main Menu 2 4 Options Menu remetente Intervention Test Configuration Tape Drive Options Serial Port Options 1 YYKYKKTYKXLKYTYYYXXYYTYIYYYYY Contents Continued A E E E O O m A SunLink Test Options 4 23 Printer Port Test Options 24 AAA ON 23 Manufacturing Test Options 27 Option Help Mei u ae 31 23 RINDO SYS ag LR ne de 32 Chapter 3 Tests and Messages ir 37 C8 ERIT S EE E E fa RR 37 RZ MESA DOS ee 39 SYSdiag Messages nee 39 SunOS Messages ee 39 Appendix A Tape Drive Hardware nn 43 AJ Parameters ee a en ie ta at 43 A Identifying Your Tape Drive and Controller nn 43 Number of Tracks ee 44 Tape Formats O A EAEE E A 44 Controll
3. 0000000000 A 1 Parameters 43 POCO 000000000000 000900000 000000 na nen rear ros dette enorcrcore A 2 Identifying Your Tape Drive and Controller TS XXXKXYYYYTXTYYYYYYYYYY YY 3 Nos A 1 Parameters A 2 Identifying Your Tape Drive and Controller Tape Drive Hardware Use this appendix to identify the type of tape drive hardware on your Sun work station You need this information to correct
4. 39 3 1 Tests Tests and Messages This section briefly describes the tests run by sysdiag It contains descriptions
5. 2 Conventions Introduction The Sun System Diagnostic test system which we shall call sysdiag is a high level diagnostic designed to exercise system hardware It runs under the SunOS operating system and is divided into two sections the tests themselves and the sysdiag menus used to select and configure the tests The tests cover three major hardware resources memory secondary memory disk and tape and peripherals By placing a heavy load on the system sysdiag tests these resources under less than ideal conditions Heavy loading uncovers problems that do not show up when the tests are run under a light or normal load To make things a little clearer this manual uses different fonts to identify text used in special ways The fonts are Roman typewriter typewriter bold Roman bold Roman italic and typewriter italic They are used as follows Roman Roman font is the standard for normal text just as it appears here Typewriter Typewriter font has two meanings depending on where it appears It may represent something that appears in the manual exactly as the computer displays it on the screen or it may represent a program path name Typewriter bold Typewriter bold also has two meanings when it is used in a section of dialogue in a display for example it represents something that you must type verbatim into the computer It sometimes appears together with regular typewriter font the computer output ap
6. example above requires a single port loopback connector for SCSI port 0 and a Revision A of 9 May 1988 d f d Chapter 2 Using Sun System Diagnostics 23 M pier Using Sun System Diagnostics 25 SunLink Test Options The data communication processor test will not pass unless you install the correct loopback connectors on the ports you are testing On every port you enter in the configuration line attach a loopback connector gt To enable or reconfigure the data communications processor test enter s1 in the options menu This option is only visible after enabling the interventions test option see the options menu section for details After entering sl you are prompted for the the ports you want to test Type in the ports you want tested as shown below To disable the test enter none or simply press without entering any ports To select which ports to test enter the port names separated by spaces The dcp port names consist of a letter a b c or d followed by a number 0 3 The mcp port names are a number from 0 15 The letter indicates the data communica tions processor board and the number shows which port on that board to check For the SCP board the RS 232 ports are O and 3 while the RS 449 ports are numbers 1 and 2 The MCP controller board port numbers are assigned as follows RS 232 423 RS 449 P
7. sun microsystems NN A A rr ww COREANO 2000 RANE arcano OOTP HOSTELS V ui aa RM SQ QE CERRO ES QE E EHRGEQAPHNR 8A5 EMAETSSA AMW m VICO NNT Part Number 800 1738 10 Revision A of 9 May 1988 Sun is a trademark of Sun Microsystems Incorporated a Sun Microsystems SunStation and Sun Workstation are registered trademarks of Sun Microsystems Incorporated SunIPC and PC NFS are trademarks of Sun Microsystems Incorporated Sun 2 Sun 3 and Sun 4 are trademarks of Sun Microsystems Incorporated SunLink and SunView are trademarks of Sun Microsystems Inc S The Sun logo Qu is a registered trademark of Sun Microsystems Incor porated SunOS is a trademark of Sun Microsystems Inc ALM and ALM2 are trademarks of Sun Microsystems Inc UNIX is a registered trademark of AT amp T Multibus is a trademark of Intel Corporation All other products or services mentioned in this document are identified by the trademarks or service marks of their respective companies or organizations Copyright 1987 1988 by Sun Microsystems Inc This publication is protected by Federal Copyright Law with all rights reserved No part of this publication may be reproduced stored in a retrieval system translated transcribed or transmitted in any form or by any means manual electric electronic electro magnetic mechanical chemical optical or other wise wi
8. icrosystems 8 Sun System Diagnostics sysdiag Organization password sysdiag will place the password where the asterisk was in the etc passwd file and whenever anyone logs in as sysdiag the program will ask for that password Another way to change the password is to log in as root and enter example passwd sysdiag You will then receive the usual password prompts When you login as sysdiag its login file starts up the sysdiag program which in turn displays the main menu If you select menu items 1 2 or 3 sys diag starts devtop memtop disktop tapetop and when an IPC board is present ipctop These programs determine how the system is configured then start one or more of the following tests f D ipctest The sysdiag program uses the contents of the dev directory to help deter mine the system hardware configuration The filesin dev should accurately reflect the actual hardware on the system The list of tests sysdiag runs is determined by the dev directory commands entered in the options menu and C use of the Select Mode option in the main menu sun Revision A of 9 May 1988 microsystems Chapter 1 Introduction 9 e e e e Ne A sysdiag With SunView sysdiag with a Terminal You may run sysdiag from a workstation or an ASCT terminal The menus appear the same regardless of the type of display you use When sysdiag is running tests the display varies depending on whether you use
9. move from window to window 2 Next use the mouse to move to the gray background area and press the right hand mouse button to activate the SunView menu Select Exit Sun View and press the left button to confirm If no gray area is visible use D while holding down the key press D to remove one of the test windows but NOT the console window 3 Before retuming to the main menu sysdiag displays the log files using the SunOS more command Use the space bar to look at all the files and if you want to stop viewing them simply enter q Sysdiag then asks if y you want to reset the log files Answer y if you want to throw away the data in all of the log files and n if you want to save it When you have dealt with the log files the main menu is displayed CAUTION Alllog files are removed when you answer y To save log files for future viewing cdto usr admand move sysdiaglog to sysdiaglog old A usr adm sysdiaglog directory is automati cally created when sysdiag is started 4 When the main menu appears enter your next selection enter q to exit sysdiag sun Revision A of 9 May 1988 Chapter 2 Using Sun System Diagnostics 33 _ _ E ESS 2 sing Sun System Diagnostics 33 NOTE 4 Stopping sysdiag from a terminal 1 Enterthe command endt When the message appears enter exit Expect the endt command to take some time to halt all of the tests If it appears that the command didn t kill a
10. SunOS passwd command q ES Selecting the q option causes sysdiag to quit System Diagnostics ne sun Revision A of 9 May 1988 microsystems Chapter 2 Using Sun System Diagnostics 17 000 apur 2 Using Sun System Diagnostics 17 2 4 Options Menu Selecting o from the main menu displays the options menu If you enter i in the options menu you enable the intervention tests The options menu is redisplayed with additional intervention menu items The intervention tests and the new menu items are described in a later section _ If you enter the m command in the options menu you will start the manufacturing tests dialogue This dialogue is described in a later section NOTE The commands in the manufacturing test dialogue are designed for use during the manufacture of Sun hardware Most of the tests require special fixtures or provide functionality that is not useful to the customer filename Entering f allows you to file current options that have been set in this session The current configuration of sysdiag is saved in filename which can be any name you choose These options can be used later to configure sysdiag during another session see the o option below o filename The o option is used to configure sysdiag with the option settings saved in a configuration file named filename The file is built using the command All of the configuration files are stored in the usr adm sysdiaglog directory lo This selec
11. continuously The Emulex Controller takes about two or three seconds to find the beginning of the tape and then stop The Sysgen Controller takes about one second to find the beginning and stop S DI i un Revision A of 9 May 1988 icrosystems Multiple Disk Drive Testing Multiple Disk Drive Testing 49 EOS zm RR SRESFEITTH x RR EEE BRIERE ROR OR IRIE RRP RE RED FR SEE Multiple Disk Drive Testing sysdiag automatically tests the first disk drive it finds in the system If more than one drive is to be tested these procedures are required For unformatted disks 1 Refer to the appropriate manual such as Installing the Sun Operating Sys tem and format partition and label the disk 2 Createa dev entry as shown under For formatted disks below Use the command etc newfs to create a new filesystem for the disk as shown in this example for a second SCSI disk Refer to the Maintenance Commands section of the SunOS Reference Manual NEWFS 8 for more information on the newfs command For formatted disks 1 Make sure a MAKEDEV diskname is done for each disk to be tested S RY 49 Revision A of 9 May 1988 mic 50 Sun Syste
12. single port loopback and dual port loop back To select a single port loopback enter the ports you want to test a or b for internal ports 0 through 3 for SCSI ports and 00 to 3F for ALM ports individually sun Revision A of 9 May 1988 microsystems 22 Sun System Diagnostics ALM ports are more easily selected for test under the manufacturing tests sub menu Serial port tests will not pass unless you install the correct loopback con nectors on the serial ports you are testing On every single port in the configuration line attach a single port loopback connector For every pair of ports connected by a dash link them with a loopback cable For a dual port loopback enter a pair of ports connected by a dash Separate each single and dual loopback entry with a space The test refers to ALM2 ports as ttyhO ttykf When you have selected the desired ports sysdiag warns you to install the correct loopback connectors then re displays the options menu with the options updated to reflect your choices as shown in the following diagram selected ports appear in the serial port menu entry The new serial port configuration is shown above in boldface type All of the After indicating the serial ports to test install a loopback cable between every port pair and a loopback connector on every single port you indicated The dual port loopback cable between internal ports a and b S amp sun rosystems
13. 4 selection 13 manufacturing tests 17 27 MC68881 38 MCP 19 23 24 39 memtop 8 messages 10 39 thru 40 diagnostic 39 SunOS 39 multiple disks 6 O options menu 15 17 Index Continued P passwd 7 13 password changing under sysdiag 16 file editing 7 13 pmem 8 37 printenv 5 printer port options 19 24 printer ports test 38 programs 8 QIC 11 tape format 44 QIC 24 tape format 6 20 44 quitting sysdiag 16 18 the main menu 18 R reset log files 16 S SCP 23 39 script files 10 security 7 selections date and time 15 hardware to test 15 37 main menu 14 serial port options 19 21 30 test hardware 22 test program 39 setterm 5 single test mode 15 Sky board renaming files 6 softdcp 39 softfp 39 software environment 4 storing current options 17 SunIPC 18 19 25 38 SunLink 19 23 39 SunView 9 sysdiag cautions 6 caveats 6 core dumps 10 exiting 32 introduction 3 messages 39 password 8 problems 6 programs 8 setting terminal type 5 what it tests 4 windows 9 52 T tape drive identification 43 information 43 options 19 20 21 tapetop 8 termcap 6 terminal 9 16 tests 8 37 typewriter font 3 U using sysdiag 13 thru 33 V valid terminal types 6 verify mode 14 vmem 8 28 30 37
14. All Sun 2 120s shipped after 6 1 85 The drives in the older systems Cipher or early Archive drives for example only support QIC 11 Cipher drives are identified by the presence of an opaque mylar protective sheet located across the top surface inside the tape drive car tridge opening Revisions of the Sun 3 PROMs that are below 1 8 do not understand QIC 24 tape format You can check the revision level of your PROM by becoming super user and halting the system with example sync example sync example etc halt and typing kb after the gt prompt from the PROM monitor Any system with a Boot PROM of revision 1 8 or higher will read the new 9 track QIC 24 tapes Also if you load a QIC 24 tape into a workstation that can read only a QIC 11 tape you will see an 86A8 oran 86A0 error message from the controller This error indicates the controller was unable to read the header block on the tape It is possible that this error will result from a faulty tape even if the tape controller will read QIC 24 tapes so check your PROM revision level or try another tape if you get this error message Every inch tape drive has a tape controller board driving it This is a small printed circuit board located inside the workstation To tell if you have an Emulex controller board insert a tape into your system If the tape is running off an Emulex controller the tape automatically rewinds and the drive s LED stays on
15. C boards pcO pc3 dO d3 and pp0 pp3 for parallel ports o GP GP GP2 and GB Graphics Processor and Buffer boards manufac turing test only o Physical memory n Virtual memory Sun 3 Systems Only in addition to components listed above o FPA Floating Point Accelerator board o MC68881 Floating Point Coprocessor a Data Ciphering Processor DCP not available outside the United States Sun 4 Systems Only in addition to components listed above SF9010FPC Floating Point Coprocessor S RY S un Revision A of 9 May 1988 icrosysterns U Chapter 1 Introduction 5 a _ is CD Sl ST TESS cer 1 1 Environment Setting the Display The sysdiag system is run as a separate user under the SunOS operating sys tem from the usr diag sysdiag directory The environment is set by the login cshrc and sunview files in that directory You can change the test environment by altering these files or by altering the sysdiag shell script file Because of the heavy demand sysdiag places on system resources the system may sometimes appear to be stopped when it is only running very slowly This effect is most pronounced on systems with less than 4 Mbytes of memory Touse sysdiag the SunOS environment variable TERM must reflect the termi nal type used as the sysdiag console If the variable isn t set correctly sys diag will not wo
16. PP board on Sun 2s by using it to perform calculations LOAN then repeating the calculations in software and comparing the results DA fputest This test checks the floating point unit on Sun 4 systems gpmtest gpmtest only runs if it is enabled from the options menu and requires that you editthe etc rc local file and re boot the system before starting sysdiag The menu selection for gpmtest can only be chosen after enabling the manufacturing tests see the manufacturing test section for details gpmtest tests the graphics processor and graph ics buffer if they are installed gp2test This test only runs if a GP2 board is present in the system and the g option is selected from the manufacturing tests menu ipctest This test checks SunIPC floppy B drives and the SunIpc printer ports These tests are only available from the intervention test menu MC68881 This test checks the floating point coprocessor on Sun 3 systems only printer This test checks the printer ports on the MCP board A reply This test sends test packets to other systems in the etc hosts file sun Revision A of 9 May 1988 microsys tems Loopback connectors must be installed on the serial ports and data communication ports to be tested Since they are optional tests the SunLink and sptest tests do not run unless you enable them from the intervention tests in the options menu see the intervention test section in this manua
17. Y YY rro rro YY XY YY 13 13 13 14 17 32
18. a workstation or a terminal When running tests on a Sun workstation sysdiag creates a SunView environment with one window each for primary memory secondary memory disk and tape and peripherals in addition to a console window a window con taining performance charts and when an IPC board is present an IPC window Here is a diagram showing the positions of sysdiag windows Disktop Performance Chart Console Window Tapetop Open the left clocktool to display the precise time in 24 hour mode In the event ofa system crash the clock will reflect the time of the crash When run from an ASCT terminal sysdiag cannot create separate windows for each test It runs the same tests and creates the same files but it displays its mes sage output onto the terminal screen As a result the test message lines are mixed together sun Revision A of 9 May 1988 microsystems 10 Sun System Diagnostics Log Files The sysdiag program stores messages in log files Log files are regular SunOS N 4 text files that live in the directory usr adm sysdiaglog sysdiag gen erates several types of log files O lc Logtimes A text file containing the starting and ending messages for sysdiag Core files Certain error conditions cause core dumps sysdiag changes the name ofthe core file to core n where n starts at 1 and increments for each new core dump log script files Scripts place messages in text fil
19. ape drive message shown above is displayed when you press Return sysdiag displays the options menu showing additional intervention test selections The options menu now has four new entries t tape s serial port pp printer port and s1 SunLink and when an SunICP board is present p Sun ICP These lines appear between the i and m options The following menu shows the options menu with the intervention tests enabled The new options are shown here in boldface type Any tape in the 1 4 inch tape drive will have its data destroyed when the tape test runs Make sure you insert a scratch tape in the drive if you enable the tape test The tape drive test is enabled and set to its default configuration when the inter vention tests are enabled To prevent errors you must load a scratch tape in the f tape drive see the Tape Test section for details The data communications pro cessor and serial port tests remain inactive until you select ports for them to test Su sun Revision A of 9 May 1988 microsystems Chapter 2 Using Sun System Diagnostics 19 tape drive options allows you to describe the type oftape drive you have on your system The system prompts you for specific tape drive infor di mation Details concerning this command are in the Tape Drive Options sec tion of this manual s The serial port options selection allows you to select the serial ports you want to test on your system The serial port tes
20. cs 21 The new text in parentheses shown in bold in this menu displays what options are currently selected In this case the example reflects the answers given in the example on the previous page The display line t 1 4 inch tape drive options long test 9 tracks QIC 24 Emulex ctlr can be interpreted from these descriptions long test the long tape test is enabled short test the short tape test is enabled 9 tracks the workstation has a 9 track tape drive 4 tracks the workstation has a 4 track tape drive QIC 24 the workstation s tape drive supports the QIC 24 tape format Emulex ctlr the workstation uses an Emulex tape controller board DD 00020 Appendix A contains more information on tape drives and controller boards After you have configured the tape options you can make other configuration changes or enter q if you are finished To turn off intervention tests enter i then answer n o to the prompt Serial Port Options To enable or reconfigure the serial port test enter s in the options menu This option is only visible after enabling the interventions test option see the options menu section for details After entering s you are prompted for the names of the ports you want to test Type in the ports you want to test after the prompt using the format described below To disable the test enter none or simply press without entering any ports There are two types of serial port tests
21. d Side Load 4 inch Tape Drives n 5 1 i 8 Ya Tape Drive Tape Drive El The side load drives support new features they are 9 track drives that support QIC 24 format and are the only drives that use the Emulex tape controller board See the sections that follow for details All tape drives in Sun workstations have either 4 or 9 tracks A workstation with 9 tracks can record more information on a given tape than can be recorded on a 4 track system Sun 2 120s and fatboxes archive tape drives in a black metal box used with the 2 120 and 100U 150U contain 4 track drives All other drives are 9 track QIC 24 is a data format used on Ya inch tapes Sun systems support two inch tape formats QIC 11 and QIC 24 All inch tape drives support QIC 11 and sysdiag knows that QIC 24 is a new reliable format that is supported on Sun s newer workstations All of the drives that can use QIC 24 also support QIC 11 RY sun Revision A of 9 May 1988 icrosystems Appendix A Tape Drive Hardware 45 TSI TIT Si a en Controller Board Many tape drives support QIC 24 format including those listed below Not all Sun systems support that format however due to the revision level of the Boot PROM which is located on the CPU board These drives are capable of support ing QIC 24 n All inch side load 5 inch tape drives see previous section for details o All drives in Sun 3 Mass Storage Subsystems a
22. er Board LL 45 Appendix B Multiple Disk Drive Testing nn 49 iv Figure A 1 Front Load and Side Load inch Tape Drives Figures Introduction Introduction 3 1 1 Environment 5 YY DIL
23. es of all these messages in their log files When sysdiag generates a message it identifies the test that is responsible for the message by appending the test name to the message Messages that appear on the screen without a test name prefix are probably not from sysdi ag Some times sysdiag generates a message and appends a SunOS error message to it sysdiag generates routine messages when it starts and stops a test and when it finds or fails to find a device It generates an error message when it encounters an error It displays messages in the appropriate window and it places copies of them in the appropriate log file SunOS messages normally appear in the console window if the windows environment is active and they appear mixed with the other messages if you are using a terminal The most common SunOS messages are sun microsystems Revision A of 9 May 1988 40 Sun System Diagnostics 1 The first message occurs when the system is overloaded a condition that sysdiag creates on purpose 2 The second occurs when the disk server is busy responding to requests from other systems on its local area network 3 The third only occurs when sysdiag tries to retension a tape if the sys tem doesn t support the retension command X sun Revision A of 9 May 1988 microsystems Tape Drive Hardware Tape Drive Hardware
24. es with the name log script n where script is the name of the script and n is a number that starts at 1 and increments each time you run sysdiag without reset ting log files log test files Test routines place messages in text files with the name log test pid where test is the name of the test routine and pidis the SunOS process number of the test Every time it runs sysdiag creates new test files log sky The Sky board test Sun 2 only puts messages into files with the name log sky n where nisa number that starts at 1 and increments each time you run sysdiag without resetting log files A Revision A of 9 May 1988 Using Sun System Diagnostics Using Sun System Diagnostics 2 1 Editingthe passwd File 2 2 Logging In 2 3 Main Menu 2 4 Options Menu 000200009 000000000 000020000 2 5 Exiting sysdiag 400001000000 000 000000200 000000 200000000 ses oco aca store dadas 1040001002009 000 000000 000000000 esses 000000000000 see rr rr EEE as ne o er oro so ann sas 44 1 Y
25. examples that follow you have selected p from the options menu and are asking sysdiag to test the B disk drives on IPC boards 2 0 and 3 and the parallel ports on IPCs 1 and 3 RA Gs Un Revision A of 9 May 1988 microsystems 26 Sun System Diagnostics 3 This message now appears on the screen This message now appears on the screen Here are descriptions of entries that may be made after the appropriate prompt Port entry What is tested dO test the B disk drive on IPC O d2 dO d3 test the B disk drives on IPCs 2 0 and 3 ppo test the parallel port on IPC O She E pp pp3 test the parallel ports on IPCs 1 and 3 AII B disk drives to be tested must have a formatted double density floppy diskette installed AII parallel ports to be tested must have a loopback connector installed After you have entered the drives and or ports that you want to test the options menu is displayed again echoing your choices Revision A of 9 May 1988 Chapter 2 Using Sun System Diagnostics 27 _ _ao o a Q _ _ o _ _ _o AAA per 4 Using Sun System Diagnostics 27 To run the test enter q to return to the main menu and select a test mode A personal computer icon will appear at the bottom of the screen If you la click the left mouse button on the icon a window that contains PC NFS ER messages will be displayed Manufacturing Test Options CAUTION Manufacturing tests are for use by manufacturi
26. he name used to set sysdi ag to look for that terminal terminal type The terminal type is usually sun which is the bit mapped display on the workstation monitor If you are using a terminal connected to the Sun workstation through its RS 232 ports use the setting that most closely corresponds to the terminal you are using If you can t find the setting for your terminal in the termcap file try using ansi sysdiag automatically tests the first disk drive it finds in the system If you want it to test multiple disk drives you must make sure that the device special files are created in the dev directory Refer to Appendix A Multiple Disk Drive Testing for more information This section describes some side effects of sysdi ag that can cause problems All of them can be avoided if you take proper precautions The 1 4 tape test has a number of configuration options One of the options LN selects the QIC 24 tape format to write and read the tape with Exercise extreme caution when testing a tape drive using the QIC 24 format If you test a drive with the QIC 24 option and the drive does not support it the SCSI bus may lock up The only way to free up the system is to cycle the power and reboot To avoid this only test the drive using QIC 24 when you are certain the drive supports it Read the Tape Test section in Chapter 2 and Appendix A for details Under certain circumstances sysdiag will rename the files dev Sky when a Sky board
27. he program will ask for that password sun 13 Revision A of 9 May 1988 microsystems 14 Sum System Diagnostics o it loc s O Ehe 25 You can run sysdiag as long as you like However to obtain accurate test results you should run the tests until they all have finished at least one complete pass If a test finds a hardware error it displays a message places an entry in the appropriate log file and quits When you stop the tests sysdiag displays the log files using the SunOS more command then asks if you want to reset them If you answer y it erases all of the log files if you answer n they remain and the next time you run sysdiag it generates a new set of log files with a higher number appended to the file names After taking care of the log files sysdiag returns to the main menu 2 3 Main Menu The sysdiag main menu will look something like this Menu Selections 1 Selecting 1 from the main menu starts sysdi ag s Automatic mode This is the simplest way to test the system and the method most users choose If you choose Automatic mode sysdiag immediately enters its SunView environment if you re on a workstation and begins probing for devices to test It starts all appropriate tests for the devices it finds sysdiag runs each test continuously until you halt it it finds a hardware error or there is a problem with sysdiag itself Selecting 2 from the main menu starts sysdiag s Verif verify mode sysdiag probe
28. is tested and etc ttys to dev sky sd and etc ttys sd respectively Before it exits sysdiag changes the files back to their proper names If sysdiag terminates abnormally however one or both of the files may still have the wrong name To check change directories to dev and etc and look foreithera sky sdor ttys sd file If you find either of these files you may do one of the following 1 Login then log out as sysdiag When s ysdiag exits normally it changes the files to their proper names ri i S E un Revision A of 9 May 1988 microsystems Chapter 1 Introduction 7 j System Security i 2 Rename the files yourself Become root super user and use the mv com mand to rename the files Because sysdiag has its own user ID with root permissions it should have a password installed You will not be able to log in and run sysdiag unless you edit the passwd file To do so you may use the vipw command or the follow ing You will now see a line in the passwd file that looks like this sysdiag 0 1 System Diagnostic pathname Take the asterisk out of that line it keeps anyone from logging in as sysdiag When you are done the line should look like this sysdiag 0 1 System Diagnostic pathname Now log in as sysdiag Now by selecting the p option from the main menu you can create a sysdiag q GS sun Revision A of 9 May 1988
29. l for details 3 2 Messages Sysdiag Messages SunOS Messages G Chapter 3 Tests and Messages 39 BCS DI and requests acknowledgement that they have received them In this way the Ethernet board is tested softdcp On domestic systems this test checks data encryption software when a data ciphering chip is not present on the CPU board softfp This test checks the software floating point routines on Sun 3 systems only sptest The sptest only runs if it is enabled from the options menu The menu selection for sptest s can only be chosen after enabling the inter vention tests see the intervention test section for details or manufactur ing tests see the manufacturing test section sptest tests the serial ports not located on the CPU board such as those found on the ALM2 board SunLink This test checks the SCP and MCP data communications processor ports installed on the system It only runs if it is enabled from the options menu The menu selection for SunLink can only be chosen after ena bling the intervention tests see the intervention test section for details Most sysdiag messages fall into one of three categories routine messages from tests messages from the SunOS operating system and error messages from tests The tests generate routine messages in their windows or on the terminal Screen each time they start and stop and they generate error messages when they encounter an error They place copi
30. ll of the tests run endt again 2 Before returning to the main menu sysdiag displays the log files using the SunOS more command then asks if you want to reset them Answer y if you want to throw away the data in all the log files and n if you want to save it You will then be returned to the main menu from which you may enter q to exit If sysdiag terminates unexpectedly before attempting to run sysdiag again log in as root and if testing a Sky board check to see if dev Sky sd exists If so rename it dev sky Alsocheckfor tt ys sd which should be etc ttys Referto the Caveats sub section sun Revision A of 9 May 1988 microsystems Tests and Messages Tests and Messages 3 7 3 1 Tests 37 CY 920000 000000 000 990909000000 000000000 000000 0000000000 CO CCO UE COCCO LO SOC OLEO 0000900090099 9090000000000900000009 0999 9009000009909 09 3 2 Messages 0000000000
31. ly configure the tape test see the Tape Test section in chapter 2 for details If the tape test is not configured properly the SCSI bus can hang freezing up the _ system If this happens you may have to cycle the system s power and reboot to start it up again In order to test your tape drive correctly you must know this about the drive o Number of Tape Tracks does your tape drive have 4 or 9 tape tracks o Tape Formats Supported does your tape drive support the QIC 24 tape format o Tape Controller Board does your tape drive use the Emulex tape con troller board If you know the answers to these questions go no further You have the informa tion you need to configure the tape test You also are finished if you do not plan to test the tape drive at all or are using the the default short test 4 tracks configuration Otherwise proceed to the next section There are two types of Y4 inch tape drives on Sun systems the 1 4 inch front load 8 1 4 inch drive and the V4 inch side load 5 1 4 inch drive the numbers in parentheses refer to the width of the drive Tape cartridges are inserted in these drives differently The front load drive cartridge is inserted by its wide end the side load drive cartridge is inserted by its narrow end Both drives are represented in the following figure 43 Revision A of 9 May 1988 44 Sun System Diagnostics Number of Tracks Tape Formats ON Figure A 1 Front Load an
32. m Diagnostics 2 Make sure at least one partition of the to be tested disk is mounted onto a file system Normally this is already done on the first disk during SunOS operating system installation The other disks need to be mounted manu ally If permanent disk additions are to be made manually add the line entries for each disk to etc stab and then use the mount a command to mount each partition Refer to mount 8 fstab 5 and mtab 5 in the SunOS Reference Manual o D S un Revision A of 9 May 1988 Index A ALM 18 21 28 39 B boldfaced type 3 C changing the display 5 color 38 console type 16 controller identification 45 options 21 conventions 3 core dumps 10 customizing windows 29 D data communication ports 19 data communications processor 23 date and time 15 DCP 39 dev 8 device list verify 14 device tests 37 devtest 37 devtop 8 disks testing multiple 6 49 disktop 8 display type 5 E exiting sysdiag 32 F ffpusr 8 38 floppy tests 19 26 fonts italic 3 Roman bold 3 typewriter bold 3 fpatest 38 gt FPC 38 G GP1 28 GP2 28 gp2test 38 gpmtest 38 graphics processor tests 28 H halting tests 32 hardware tested 4 8 15 help 17 31 I intervention tests 17 18 introduction 3 IPC 18 19 25 ipctop 8 italic type 3 L log files 10 15 logging in 13 loopback connectors 22 M main menu example 1
33. nd the SKY board by directly probing for it If a data ciphering processor is present sysdiag runs the dcp test otherwise it runs tests the DCP software with softdcp The dcp tests are only offered in the United States Sun 37 Revision A of 9 May 1988 microsystems 38 Sun System Diagnostics The 1 2 inch tape drive should have a scratch tape installed Since it is an optional test the tape is not tested unless you select interven tion tests in ihe options menu see the intervention tests section in thi manual for details S NN R sysdiag runs gpmtest sptest SunLink ipctest and printer if they were enabled in the options menu through the intervention selection ipctest automati cally runs if a SunIPC board is present in the system but requires user input con ceming the printer port color This test checks the system s color board if it is installed dcp This test automatically runs on domestic systems when a Data Cipher ing Processor is present on the CPU board devtest tests local disks and 1 2 inch tape drives using generic SunOS routines It only reads disks but it writes and reads tape drives For 1 2 inch tape drives it starts by using the largest block size available 64 Kbytes and when it gets near the end where 64K is too big it uses 512 byte blocks for the remainder Jpatest This test checks the floating point accelerator board on Sun 3 systems only fpusr tests the Sky F
34. ng only They require cus tom test jigs and may interfere with other tests if you select conflicting options When you select manufacturing tests interactive dialog takes place if manufacturing tests are formerly enabled as shown below X u Revision A of 9 May 1988 28 Sun System Diagnostics The following paragraphs give a brief description of each option v vmem wait delay determines how long to wait before re running the virtual memory test The delay can be 0 30 60 or 90 minutes This option is intended solely for use on diskless systems to reduce network traffic s If you selectthe s option from the manufacturing test options this menu prompts you to enter the number of device drivers on each board you intend to test When testing the ALM2 board you are assumed to have a fixed loopback configuration and you will need a special 1oopback cable The test refers to the ALM2 as sph spi spj and spk The serial port board test uses a special test jig capable of connecting 8 or 14 serial ports for the Sun 2 120 or Sun 2 170 ALM option Eight loopback cables are required to test the Sun VME ALM option g When a GP1 board is installed this selection brings up a prompt that asks if you want to test the graphics processor board Enter y for yes n for no and then press If aGP2 board is present sysdiag announces the fact and assumes that the test is to be performed on it NOTE Before running the g
35. of the the tests themselves and some of the more common messages that these tests might produce To check out the hardware sysdiag uses one or more of the following tests n The test disk exercises the disk controller and drive It writes two 5 MB files with random datain tmp then reads and compares them If the system has no tmp directory sysdiag creates a tmp disktop sd direc tory to fill with random data and removes it when you exit sysdiag selects the drive by issuing the SunOS command df and uses each local drive listed o sysdiag tests physical memory with pmem and virtual memory with vmem pmem locates parity errors hard and soft ECC errors memory read errors and addressing problems It maps then reads a page repeatedly throughout memory vmem tests virtual memory by allocating writing and reading as much virtual memory as feasible It leaves only the memory necessary for the operat ing system to function and for device tests to load and execute If vmem decides it does not have enough virtual memory to run prop erly it exits without testing generates a proper ending message on the screen and in its log file with a pass count of 0 D sysdiag provides these device tests devtest ffpusr gpmtest color Sun Link enet fpatest mc68881 dcp softdcp softfp fputest sptest ipctest and printer It decides whether to run devtest by scanning dev for devices that may be tested and it runs ffpusr if it can fi
36. ort s Port s 1 0 3 12 2 6 7 4 5 3 10 11 8 9 4 14 15 12 13 If you only have one board on your system it will be board a Additional boards are lettered in increasing order In this example the first three ports on the first data communications processor board are being tested This message now appears on the screen After you install the loopback connectors on the ports to be tested press Return and the program informs you After you have entered the data communication ports to test and installed loop back connectors in this example on ports 0 1 and 2 onboard a sun microsystems Revision A of 9 May 1988 24 Sun System Diagnostics Printer Port Test Options sysdiag displays the loopback connector warning then redisplays the options menu with the options updated to reflect your choices To begin testing enter q to bring up the main menu and select a test mode from that menu After you enter the printer port selection P sysdiag will prompt you to select the printer ports to test The entry in the example above would test all Multiple Communication Proces sor MCP printer ports If none are to be tested just press Retum You may enter any number of printer ports as long as they are separated by spaces Here are example entries Port entry What is Tested 0 test single port mcppO 02 test ports mcppO and mcpp2 0123 test all mcp printer ports mcpp0 mcpp3 The program n
37. ow prompts you to install loopback connectors for every port you intend to test S un Revision A of 9 May 1988 microsystems IPC Test Options NOTE CAUTION Chapter 2 Using Sun System Diagnostics 25 Install a parallel printer loopback connector on each port to be tested and then press Return Sysdiag now displays your choices and lets you know that it has initialized the multiple communications processor board This option will appear on the options menu ONLY when SunIPC hardware is present in the system In that case a special ipctop window appears in the upper right corner of the screen and a pc icon is at the bottom of the screen during a test cycle ONLY DRIVE B ON A SunIPC WILL BE TESTED DRIVE A MUST NOT HAVE A DISKETTE INSERTED OR THE IPC TEST WILL FAIL After you select the IPC test option sysdiag prompts you to enter which SunIPC disk drives to test and then which SunIPC parallel ports to test When prompted enter the disk drives and or parallel ports that you wish to test If none are to be tested enter none or press Return At the prompt you may enter any number of disk drives or parallel ports in any order separated by a space Sysdiag only tests the B disk drives The SunIPc disk drives are entered as dO through d3 The SunIPC parallel ports are entered as ppO through pp3 The suffix number signifies to which SunIPC board the disk or parallel port is attached In the
38. pe drive and select which test to run long or short test Appendix A will help you determine the answers required for your specific configuration The example that follows shows every question sysdiag can ask You may not be asked all of the ques tions in this example if you answer differently After describing the tape drive to sysdiag load a scratch tape tape that can be overwritten into the drive It is a good idea to clean the tape read write heads so the tape test returns accurate results Use a good quality tape If you are running the long test use a tape that is 450 feet long The test may write past the end of a tape that is too short producing incorrect test results or it may not test all of the tape drive tracks on a tape that is too long 3 i i CAUTION lf the QIC 24 option is selected and the tape drive does not support it the SunOS operating system will display an error mes sage on the console To avoid this problem read Appendix A to deter mine what options your tape drive supports before configuring this test 17 7 When you answer all of the questions sysdiag re displays the options menu with the new tape options shown on the following page in bold type updated to reflect your choices The example on the following page is what the menu looks like after entering the choices shown above S u n Revision A of 9 May 1988 microsystems Chapter 2 Using Sun System Diagnosti
39. pears in typewriter and what you must type appears in typewriter bold If Typewriter bold appears in a menu it is used to highlight the aspect of the menu under discussion Bold Bold Roman font indicates that something deserves more attention than the surrounding text 3 Revision A of 9 May 1988 microsystems 4 SunSystem Diagnostics ee ni iii e ul A ss Coverage S Italic Roman italic font is used for emphasis typewriter italic font appears in display examples to represent variables for which you or the com puter must provide the exact details For example sysdiag can test the following hardware components if they are installed correctly Sun 2 or Sun 3 Systems o Xylogics disks xy or xd 0 1 2 and 3 n SCSI disks sd0 sd1 and sd2 SCSI Y4 in tape drive stO Archive in tape drive arO Sun 100U and 150U only Ya in Magnetic tapes mt0 mt1 1600 and or 6250 BPI SKY FPP Floating Point Processor board Sun 2 Only o Serial ports a and b all CPU s 0 through 3 Multibus SCSI tty00 through tty3F ALM and hO through kf ALM2 use the s option from D O D D t the Intervention menu O Data Communications ports AO D3 BO B3 SCP and 0 15 MCP o Color board CG2 for Sun 2 or single buffered CG3 o Ethernet boards Multibus ie0 iel ec0 ecl VME iel for second Ether net controller first is on the CPU board o SunIP
40. raphics processor tests you must become super user and edit the etc rc local file so that the line shown below has a symbol in front of it and then re boot the system By commenting out this line of code you disable the ability of the operating system to use the graphics proces sor board When you are finished testing be sure to remove the symbol from the file and re boot again N RY u Revision A of 9 May 1988 Chapter 2 Using Sun System Diagnostics 29 m a ee ES o del ados cd dz sb Now re boot the system so that the change you have just made can take effect This selection asks if you want to test a shoebox mass storage subsys tem It only tests SCSI disks and tapes 1 7 using diskt op devtop and tapetop This selection brings up a menu that customizes the test windows if desired Itchanges sysdiag window placement and the font and point size of the displayed text The menu looks like this re Ifyou select 1 the windows are sized according to the parameters in the usr diag sysdiag sunview manuf 1 file If you select 2 the windows are sized according to the usr diag sysdiag sunview manuf 2 file If you select 3 the windows are sized according to the usr diag sysdiag sunview manuf 3 file If you select 4 the windows are placed as shown in Chapter 1 and use whatever font and point size are present in the sunview file This selection ask
41. rk properly To fix this change TERM using the setterm command or the c command from the sysdiag main menu refer to the Main Menu section of Chapter 2 Before changing anything see what display type is set now To do this log in to the device console or terminal you plan to run sysdiag from do not log in as sysdiag and enter the following commands The terminal type variable shows what type of terminal the operating sys tem thinks you are working from The default setting for a user working from the bitmapped display is sun A common setting for a user on a terminal is tvi925 a Televideo terminal vt100 or ansi a generic ansi terminal If the terminal type accurately describes the device you are using don t change anything If you need to change the terminal type log into the system on the device where you plan to run sysdiag become root super user and use settermto change terminal type to the device type you are using un Revision A of 9 May 1988 microsystems 6 Sun System Diagnostics Testing Multiple Disks Caveats QIC 24 Renamed files da The etc termcap file contains a list of all valid terminal types and their characteristics In order to see the list of valid terminals change directories to etc and view the termcap file A typical output line would look like this Vertical bars divide the termcap fields The last field contains a description of the terminal The second field is t
42. s dev for the devices insta tem It lists the devices it found then asks you if the list is c 2 answer n it asks you to correct the problem and returns tr E S sun icrosystems gt Chapter 2 Using Sun System Diagnostics 15 CS HET 2 Using Sun System Diagnostics 15 If you answer y it continues and performs all of the operations described in Automatic mode If you have any doubt about the system configuration or of the accuracy of the dev directory you should run Verify mode Selecting 3 from the main menu starts sysdiag s Select Mode This mode starts the same way automatic mode does sysdiag immedi ately enters its SunView environment if you re on a workstation and starts probing for devices to test But instead of running a test for every device it finds the program first prompts you for the individual hardware tests you want to run Selecting 4 from the main menu starts sysdiag s single test mode This mode brings up a new menu from which you may select one of these tests o disktop tests o memtop tests n tapetop tests o devtop tests In this mode the message display is similar to that when running sysdiag on an ASCII terminal After you have selected the tests sysdiag performs according to a lim ited sub set of parameters for the operations described in Automatic mode using only the tests chosen Note that sysdiag stresses the system more when many tests are run simultaneousl
43. s you if you want to enable run on error If enabled sysdiag either retries or starts over when tests fail If this option is dis abled tests are stopped when an error occurs After the selections have been entered sysdiag redisplays the menu showing the options that have been entered during the dialog The new options are displayed in boldface type as shown for the regular options sun microsystems Revision A of 9 May 1988 30 Sun System Diagnostics The new text in parentheses displayed in the manufacturing test selection shows what options are currently selected The line can be interpreted as follows O O o enabled manufacturing test is enabled gp amp b both the graphics processor and graphic buffer are selected gp in place of gp amp b only the graphics processor is selected spboard fofports one or more of the serial port board tests are selected One entry per board The number of ports can be 8 for the Sun 2 120 8 or 14 for the Sun 2 170 and 0 16 1 16 or 2 16 for Sun VME ALM dii boards Sea vmem wait delay how long to wait before re running the vmem test The delay can be 0 30 60 or 90 minutes S un Revision A of 9 May 1988 Chapter 2 Using Sun System Diagnostics 31 e 0000 sing Sun System Diagnostics 31 A Option Help Menu When you select h from the options menu sysdiag displays the the help menu This menu has an entry for each of
44. t is disabled until you select which ports you want to test Details for selecting the serial ports to test are in the Serial Port Options section of this manual and in on line help sl SunLink test options provide a selection of data communication ports to test The data communications processor test is disabled until you actually select which ports to test Details for selecting the data communica tion ports to test are in the Data Communications Port Options section of this manual and in on line help PP printer port test options provide a selection of MCP based printer ports to test The printer port test is disabled until you select which ports to test Details for selecting the printer ports are in the Printer Port Test Options section of this manual and in on line help p IPC test options provide a selection of floppy disk drives and SunIPC board printer ports to test This option only appears on the menu when a SunIPC board is present in the system Details for selecting drives and printer ports are found in IPC Test Options and in on line help S 2 Sun Revision A of 9 May 1988 crosystems 20 Sun System Diagnostics eee Tape Drive Options NOTE To change the configuration of the tape drive test enter t from the options menu This option is only visible after enabling the intervention tests option see the Options Menu section for details After entering t you answer a Series of questions Your answers configure the ta
45. the major commands in the option menu Each help menu entry has the same name as the option command it describes The on line menu represents the latest version of this software and supercedes the examples shown here A special Manufacturing Option menu fol lows the one shown below This menu contains an entry for every selection in the options menu For infor mation abouta sysdiag option enter the corresponding letter at the prompt The menu will display a screen full of text about the option Press to ET go back to the help menu From the help menu use q to return to the options LU menu or Q toexit sysdiag sun Revision A of 9 May 1988 microsystems 32 Sun System Diagnostics You can display a help message directly from the options menu From the options menu enter h followed by the help option letter The corresponding help message is displayed immediately without going through the help menu After displaying the help message the program redisplays the options menu 2 5 Exiting sysdiag The procedure for stopping sysdiag involves two steps stopping the tests that are running if any and exiting from sysdiag itself The procedure for stopping the tests in progress varies depending on whether sysdiag is running from a terminal or a workstation To halt sysdiag from a workstation 1 First end any tests in progress Enter C while holding down the key press C in each window that has a test running Use the mouse to
46. thout prior explicit written permission from Sun Microsystems Contents 3 3 4 5 5 6 6 6 6 7 8 9 9 Chapter 1 Introduction 00001900000 000000900000 errr UC 099900090 000000000 000209205 000900099 00090996 Conventions COLOCO ecsscccsset L00000 090000090000 000 000000202000 000 ONO 000000909 990 900000000099 000099 909090 909 0090000400009 9009 Coverage COOL OLEOLE LLC E TODO CEDO OCO USD COLOCOU CRE COLO OCO 9090099 e 0 0990 009090000000 90 900 0099900090 009 900090 00096 LE Si AAA A ballano SE A has Testing Multiple Disks Caveats COOL O LOL rr 9990090 000090000 O UU rr A AM A OO O UC COR O O RCA 090 9 Uno Poo sas 00 CS III EEE OSLO COLOCO LC ON UE O O O O OO 9000000090090 90090909909 COLOCOU CCO RO O LOCO UC UMA O O CO ONO CO OU Con 0 9099 1000000000000 000000 000000000000 rrr OO OC O O LOU CO a 909090000090 000 nes 95909 System Security COCO DLC OO OCO OR LO MOU EUER SECO E COL OD III EEE HESS OCO UC OO O USO en en nes ss sos doada COCO CO CIO COL CU e nn a OO OO rr O O CC ALE O OR OU cos On aC Co nora a er era a cr sysdiag Organization sysdiag With SunView COCO LOU OO O ONO LL CO ostoscscs O OO O COCO 000990000900 09 900090 re nos 0099 sysdiag with a Terminal 909699949000000000000000000000400000000090000009990 0009900000 00000 909990000009 09000 Log Files pai
47. tion lists sysdiag option names previously filed by the file current options selection h menu option Entering h with no argument displays the help information menu This menu displays help messages that describe the different option com E mands The help menu is described in a later section tems Gy SUN Revision A of 9 May 1988 N microsys 18 _ Sun System Diagnostics Intervention Test Configuration CAUTION I Entering h witha menu option argument displays the help message for the specified selection directly without leaving the options menu menu option can be any of the selections listed in the options menu including the help selection Entering q from the options menu causes youto return to the main menu This command is used to exit the options menu Selecting the Q option causes sysdiagto quit System Diagnos tics Ifyou logged in as sysdiag this command logs you out If you logged in as super user root and invoked sysdiag from the SunOS com mand prompt the Q command returns the SunOS prompt The serial port tape printer port SunLink SunIPC and ALM tests are intervention tests they require you to perform some actions before running them If you choose intervention tests inthe options menu sysdiag displays the prompt shown below Choose y to enable the intervention tests or choose n to disable them If you answer n the options menu is redisplayed If you answer y the t
48. y thus providing more accurate test results filename Selecting o with no argument displays the options menu Itis described in the next section If the o option is entered followed bya filename sysdiag will immediately execute the restore options command from the options menu This method can be used as a shortcut to configure sysdiag from the configuration information that has been previously stored in the file Seethe Options Menu section for informa tion on storing and saving sysdiag configurations Tests for options such as the Integrated Personal Computer SunIPC and data communications boards reside in this menu Selecting s allows youto set date and time You are shown the current system time and asked to enter a new time If the time is correct press return Otherwise enter the new time and date then press return When you select d sysdiag displays log files The program uses the SunOS more command to display all of the log files in the usr adm sysdiaglog directory S u Revision A of 9 May 1988 icrosystems 16 Sun System Diagnostics SS od r A A 5 When r is selected in the main menu sysdiag resets log files The pro gram removes all of the log files in the usr adm sysdiaglog direc tory c With this option you may leave the sysdiag console type unchanged or enter the type of terminal you wish to use p Entering p prompts you to change the sysdiag password The interac tion is very similar to the
Download Pdf Manuals
Related Search