System software provides Solaris operating system commands that you can use to diagnose problems, and OBP commands that enable you to diagnose problems even if the Solaris operating environment is unavailable for any reason. For more information on Solaris commands, see the appropriate man pages. For additional information on OBP commands, see the OpenBoot 3.x Command Reference Manual. (An online version of the manual is included with the Solaris System Administrator AnswerBook that ships with Solaris software.)
The prtdiag command is a UNIX shell command used to display system configuration and diagnostic information, such as:
System configuration, including information about clock frequencies, CPUs, memory, and I/O card types
Diagnostic information
Failed field-replaceable units (FRUs)
To run prtdiag, type:
% /usr/platform/sun4u/sbin/prtdiag |
To isolate an intermittent failure, it may be helpful to maintain a prtdiag history log. Use prtdiag with the -l (log) option to send output to a log file in /var/adm.
Refer to the prtdiag man page for additional information.
An example of prtdiag output follows. The exact format of prtdiag output depends on which version of the Solaris operating environment is running on your system.
prtdiagoutput:
ok /usr/platform/sun4u/sbin/prtdiag -v System Configuration: Sun Microsystems sun4u Sun Enterprise 220R (UltraSPARC-II 450MHz) System clock frequency: 112 MHz Memory size: 128 Megabytes ========================= CPUs ======================== Run Ecache CPU CPU Brd CPU Module MHz MB Impl. Mask --- --- ------- ----- ------ ------ ---- 0 0 0 450 4.0 US-II 10.0 ========================= IO Cards ========================= Bus Brd Type MHz Slot Name Model --- ---- ---- ---- ------------------ ---------------------- 0 PCI 33 1 network-SUNW,hme 0 PCI 33 3 scsi-glm/disk (block) Symbios,53C875 0 PCI 33 3 scsi-glm/disk (block) Symbios,53C875 No failures found in System =========================== ====================== HW Revisions ====================== ASIC Revisions: PCI: pci Rev 4 Cheerio: ebus Rev 1 System PROM revisions: ---------------------- OBP 3.23.0 1999/06/30 14:57 POST 2.0.2 1998/10/19 10:46 ok |
The eeprom command is a UNIX shell command. You invoke it to list the names and current values of the OpenBoot PROM configuration variables stored in system NVRAM. You can also use the eeprom command to set new values for the OpenBoot PROM configuration variables.
To run the eeprom command:
Boot the operating system.
Become root.
Type the following command at the command-line prompt:
% eeprom % scsi-initiator-id=7 keyboard-click?=false keymap: data not available. ttyb-rts-dtr-off=false ttyb-ignore-cd=true ttya-rts-dtr-off=false ttya-ignore-cd=true ttyb-mode=9600,8,n,1,- ttya-mode=9600,8,n,1,- pcia-probe-list=1 pcib-probe-list=1,3,2,4,5 enclosure-type: 540-4284 banner-name: Sun Enterprise 220R energystar-enabled?=false mfg-mode=off diag-level=min #power-cycles=35 system-board-serial#=5014450071228 system-board-date=371c1bc9 fcode-debug?=false output-device=screen input-device=keyboard load-base=16384 boot-command=boot auto-boot?=true watchdog-reboot?=false diag-file: data not available. diag-device=net boot-file: data not available. boot-device=disk net local-mac-address?=false ansi-terminal?=true screen-#columns=80 screen-#rows=34 silent-mode?=false use-nvramrc?=false |
nvramrc: data not available. security-mode=none security-password: data not available. security-#badlogins=0 oem-logo: data not available. oem-logo?=false oem-banner: data not available. oem-banner?=false hardware-revision: data not available. last-hardware-update: data not available. diag-switch?=true |
If the NVRAM is a new part, you must reset the values of the following OpenBoot PROM configuration variables: banner-name= Sun Enterprise 220R, enclosure-type= , 540-4284and energystar-enabled?= false.
To set the values for the OpenBoot PROM configuration variables shown in the following example, boot the operating system, log on as root, and enter the following commands.
% % eeprom banner-name="Sun Enterprise 220R" % eeprom enclosure-type="540-4284" % eeprom energystar-enabled?=false |
Verify the variable settings by running the eeprom command without any parameters, as shown in the following example.
% eeprom % scsi-initiator-id=7 keyboard-click?=false keymap: data not available. ttyb-rts-dtr-off=false ttyb-ignore-cd=true ttya-rts-dtr-off=false ttya-ignore-cd=true ttyb-mode=9600,8,n,1,- ttya-mode=9600,8,n,1,- pcia-probe-list=1 pcib-probe-list=1,3,2,4,5 enclosure-type: 540-4284 banner-name: Sun Enterprise 220R energystar-enabled?=false mfg-mode=off diag-level=min #power-cycles=35 system-board-serial#=5014450071228 system-board-date=371c1bc9 fcode-debug?=false output-device=screen input-device=keyboard load-base=16384 boot-command=boot auto-boot?=true watchdog-reboot?=false diag-file: data not available. diag-device=net boot-file: data not available. boot-device=disk net local-mac-address?=false ansi-terminal?=true screen-#columns=80 screen-#rows=34 silent-mode?=false use-nvramrc?=false |
To display the names, current values, and default values of the OpenBoot PROM configuration variables stored in NVRAM, enter the OBP printenv command at the OBP ok prompt, as shown in the following example
ok printenv variable name Value Default Value scsi-initiator-id 7 7 keyboard-click? false false keymap ttyb-rts-dtr-off false false ttyb-ignore-cd true true ttya-rts-dtr-off false false ttya-ignore-cd true true ttyb-mode 9600,8,n,1,- 9600,8,n,1,- ttya-mode 9600,8,n,1,- 9600,8,n,1,- pcia-probe-list 1 1 pcib-probe-list 1,3,2,4,5 1,3,2,4,5 enclosure-type 540-4284 banner-name Sun Enterprise 220R energystar-enabled? false true mfg-mode off off diag-level min min #power-cycles 35 system-board-serial# 5014450071228 system-board-date 371c1bc9 fcode-debug? false false output-device screen screen input-device keyboard keyboard load-base 16384 16384 boot-command boot boot auto-boot? true true watchdog-reboot? false false diag-file diag-device net net boot-file boot-device disk net disk net local-mac-address? false false ansi-terminal? true true screen-#columns 80 80 screen-#rows 34 34 silent-mode? false false use-nvramrc? false false |
silent-mode? false false security-mode none security-password security-#badlogins 0 oem-logo oem-logo? false false oem-banner oem-banner? false false hardware-revision last-hardware-update diag-switch? true false |
To set the value of an OpenBoot PROM configuration variable stored in NVRAM, enter the OBP setenv command at the OBP ok prompt, as shown in the following example.
If the NVRAM is a new part, you must reset the three OpenBoot PROM configuration variables shown in this example. These variables are named banner-name, enclosure-type, and energystar-enabled? and they must be set to the values shown in the example.
ok setenv banner-name = Sun Enterprise 220R ok setenv enclosure-type = 540-4284 ok setenv energystar-enabled? = false ok printenv variable name Value Default Value scsi-initiator-id 7 7 keyboard-click? false false keymap ttyb-rts-dtr-off false false ttyb-ignore-cd true true ttya-rts-dtr-off false false ttya-ignore-cd true true ttyb-mode 9600,8,n,1,- 9600,8,n,1,- ttya-mode 9600,8,n,1,- 9600,8,n,1,- pcia-probe-list 1 1 pcib-probe-list 1,3,2,4,5 1,3,2,4,5 enclosure-type 540-4284 banner-name Sun Enterprise 220R energystar-enabled? false mfg-mode off off diag-level min min #power-cycles 35 system-board-serial# 5014450071228 system-board-date 371c1bc9 fcode-debug? false false output-device screen screen input-device keyboard keyboard load-base 16384 16384 boot-command boot boot auto-boot? true true watchdog-reboot? false false diag-file diag-device net net boot-file boot-device disk net disk net local-mac-address? false false ansi-terminal? true true screen-#columns 80 80 screen-#rows 34 34 silent-mode? false false use-nvramrc? false false |
nvramrc security-mode none security-password security-#badlogins 0 oem-logo oem-logo? false false oem-banner oem-banner? false false hardware-revision last-hardware-update diag-switch? true false |
To diagnose problems with the SCSI subsystem, you can use the OBP probe-scsi and probe-scsi-all commands. Both commands require that you halt the system.
When it is not practical to halt the system, you can use SunVTS software as an alternative method of testing the SCSI interfaces. See "7.1 About Diagnostic Tools" for more information.
The probe-scsi command transmits an inquiry command to all SCSI devices connected to the main logic board SCSI interfaces. These include any tape or CD-ROM drive in the removable media assembly (RMA), any internal disk drive, and any device connected to the external SCSI connector on the system back panel. For any SCSI device that is connected and active, its target address, unit number, device type, and manufacturer name are displayed.
The probe-scsi-all command transmits an inquiry command to all SCSI devices connected to the system SCSI host adapters, including any host adapters installed in PCI slots. The first identifier listed in the display is the SCSI host adapter address in the system device tree followed by the SCSI device identification data.
The first example that follows shows a probe-scsi output message. The second example shows a probe-scsi-all output message.
probe-scsi output:
ok probe-scsi This command may hang the system if a Stop-A or halt command has been executed. Please type reset-all to reset the system before executing this command. Do you wish to continue? (y/n) n ok reset-all ok probe-scsi Primary UltraSCSI bus: Target 0 Unit 0 Disk SEAGATE ST34371W SUN4.2G3862 Target 4 Unit 0 Removable Tape ARCHIVE Python 02635-XXX5962 Target 6 Unit 0 Removable Read Only device TOSHIBA XM5701TASUN12XCD0997 Target 9 Unit 0 Disk SEAGATE ST34371W SUN4.2G7462 Target b Unit 0 Disk SEAGATE ST34371W SUN4.2G7462 ok |
probe-scsi-all output:
ok probe-scsi-all This command may hang the system if a Stop-A or halt command has been executed. Please type reset-all to reset the system before executing this command. Do you wish to continue? (y/n) y /pci@1f,4000/scsi@4,1 Target 0 Unit 0 Disk SEAGATE ST39102LC SUN9.0G0828 Target 1 Unit 0 Disk SEAGATE ST39102LC SUN9.0G0828 Target 6 Unit 0 Removable Read Only deviceTOSHIBA XM6201TA SUN32XCD1103 ok |