Antares-RAID-sparcLinux-HOWTO

Thom Coates (tdc3@psu.edu), Carl Munio, Jim Ludemann

1. Preamble

2. Acknowledgements and Thanks

3. New Versions

4. Introduction

• 4.1 5070 Main Features

5. Background

• 5.1 Raid Levels
• 5.2 RAID Linear
• 5.3 Level 1
• 5.4 Striping
• 5.5 Level 0
• 5.6 Level 2 and 3
• 5.7 Level 4
• 5.8 Level 5

6. Installation

• 6.1 SBUS Controller Compatibility
• 6.2 Hardware Installation Procedure
• 6.3 Serial Terminal
• 6.4 Hard Drive Plant

7. 5070 Onboard Configuration

• 7.1 Main Screen Options
• 7.2 [Q]uit
• 7.3 [R]aidSets:
• 7.4 [H]ostports:
• 7.5 [S]pares:
• 7.6 [M]onitor:
• 7.7 [G]eneral:
• 7.8 [P]robe
• 7.9 Example RAID Configuration Session

8. Linux Configuration

• 8.1 Existing Linux Installation
• 8.2 New Linux Installation

9. Maintenance

• 9.1 Activating a spare
• 9.2 Re-integrating a repaired drive into the RAID (levels 3 and 5)

10. Troubleshooting / Error Messages

• 10.1 Out of band temperature detected...
• 10.2 ... failed ... cannot have more than 1 faulty backend.
• 10.3 When booting I see: ... Sun disklabel: bad magic 0000 ... unknown partition table.

11. Bugs

12. Frequently Asked Questions

• 12.1 How do I reset/erase the onboard configuration?
• 12.2 How can I tell if a drive in my RAID has failed?

13. Advanced Topics: 5070 Command Reference

• 13.1 AUTOBOOT - script to automatically create all raid sets and scsi monitors
• 13.2 AUTOFAULT - script to automatically mark a backend faulty after a drive failure
• 13.3 AUTOREPAIR - script to automatically allocate a spare and reconstruct a raid set
• 13.4 BIND - combine elements of the namespace
• 13.5 BUZZER - get the state or turn on or off the buzzer
• 13.6 CACHE - display information about and delete cache ranges
• 13.7 CACHEDUMP - Dump the contents of the write cache to battery backed-up ram
• 13.8 CACHERESTORE - Load the cache with data from battery backed-up ram
• 13.9 CAT - concatenate files and print on the standard output
• 13.10 CMP - compare the contents of 2 files
• 13.11 CONS - console device for Husky
• 13.12 DD - copy a file (disk, etc)
• 13.13 DEVSCMP - Compare a file's size against a given value
• 13.14 DFORMAT- Perform formatting functions on a backend disk drive
• 13.15 DIAGS - script to run a diagnostic on a given device
• 13.16 DPART - edit a scsihd disk partition table
• 13.17 DUP - open file descriptor device
• 13.18 ECHO - display a line of text
• 13.19 ENV- environment variables file system
• 13.20 ENVIRON - RaidRunner Global environment variables - names and effects
• 13.21 EXEC - cause arguments to be executed in place of this shell
• 13.22 EXIT - exit a K9 process
• 13.23 EXPR - evaluation of numeric expressions
• 13.24 FALSE - returns the K9 false status
• 13.25 FIFO - bi-directional fifo buffer of fixed size
• 13.26 GET - select one value from list
• 13.27 GETIV - get the value an internal RaidRunner variable
• 13.28 HELP - print a list of commands and their synopses
• 13.29 HUSKY - shell for K9 kernel
• 13.30 HWCONF - print various hardware configuration details
• 13.31 HWMON - monitoring daemon for temperature, fans, PSUs.
• 13.32 INTERNALS - Internal variables used by RaidRunner to change dynamics of running kernel
• 13.33 KILL - send a signal to the nominated process
• 13.34 LED- turn on/off LED's on RaidRunner
• 13.35 LFLASH- flash a led on RaidRunner
• 13.36 LINE - copies one line of standard input to standard output
• 13.37 LLENGTH - return the number of elements in the given list
• 13.38 LOG - like zero with additional logging of accesses
• 13.39 LRANGE - extract a range of elements from the given list
• 13.40 LS - list the files in a directory
• 13.41 LSEARCH - find the a pattern in a list
• 13.42 LSUBSTR - replace a character in all elements of a list
• 13.43 MEM - memory mapped file (system)
• 13.44 MDEBUG - exercise and display statistics about memory allocation
• 13.45 MKDIR - create directory (or directories)
• 13.46 MKDISKFS - script to create a disk filesystem
• 13.47 MKHOSTFS - script to create a host port filesystem
• 13.48 MKRAID - script to create a raid given a line of output of rconf
• 13.49 MKRAIDFS - script to create a raid filesystem
• 13.50 MKSMON - script to start the scsi monitor daemon smon
• 13.51 MKSTARGD - script to initialize a scsi target daemon for a given raid set
• 13.52 MSTARGD - monitor for stargd
• 13.53 NICE - Change the K9 run-queue priority of a K9 process
• 13.54 NULL- file to throw away output in
• 13.55 PARACC - display information about hardware parity accelerator
• 13.56 PEDIT - Display/modify SCSI backend Mode Parameters Pages
• 13.57 PIPE - two way interprocess communication
• 13.58 PRANKS - print or set the accessible backend ranks for the current controller
• 13.59 PRINTENV - print one or all GLOBAL environment variables
• 13.60 PS - report process status
• 13.61 PSCSIRES - print SCSI-2 reservation table for all or specific monikers
• 13.62 PSTATUS - print the values of hardware status registers
• 13.63 RAIDACTION- script to gather/reset stats or stop/start a raid set's stargd
• 13.64 RAID0 - raid 0 device
• 13.65 RAID1 - raid 1 device
• 13.66 RAID3 - raid 3 device
• 13.67 RAID4 - raid 4 device
• 13.68 RAID5 - raid 5 device
• 13.69 RAM - ram based file system
• 13.70 RANDIO - simulate random reads and writes
• 13.71 RCONF, SPOOL, HCONF, MCONF, CORRUPT-CONFIG - raid configuration and spares management
• 13.72 REBOOT - exit K9 on target hardware + return to monitor
• 13.73 REBUILD - raid set reconstruction utility
• 13.74 REPAIR - script to allocate a spare to a raid set's failed backend
• 13.75 REPLACE - script to restore a backend in a raid set
• 13.76 RM - remove the file (or files)
• 13.77 RMON - Power-On Diagnostics and Bootstrap
• 13.78 RRSTRACE - disassemble scsihpmtr monitor data
• 13.79 RSIZE - estimate the memory usage for a given raid set
• 13.80 SCN2681 - access a scn2681 (serial IO device) as console
• 13.81 SCSICHIPS - print various details about a controller's scsi chips
• 13.82 SCSIHD - SCSI hard disk device (a SCSI initiator)
• 13.83 SCSIHP - SCSI target device
• 13.84 SET - set (or clear) an environment variable
• 13.85 SCSIHPMTR - turn on host port debugging
• 13.86 SETENV - set a GLOBAL environment variable
• 13.87 SDLIST - Set or display an internal list of attached disk drives
• 13.88 SETIV - set an internal RaidRunner variable
• 13.89 SHOWBAT - display information about battery backed-up ram
• 13.90 SHUTDOWN - script to place the RaidRunner into a shutdown or quiescent state
• 13.91 SLEEP - sleep for the given number of seconds
• 13.92 SMON - RaidRunner SCSI monitor daemon
• 13.93 SOS - pulse the buzzer to emit sos's
• 13.94 SPEEDTST - Generate a set number of sequential writes then reads
• 13.95 SPIND - Spin up or down a disk device
• 13.96 SPINDLE - Modify Spindle Synchronization on a disk device
• 13.97 SRANKS - set the accessible backend ranks for a controller
• 13.98 STARGD - daemon for SCSI-2 target
• 13.99 STAT - get status information on the named files (or stdin)
• 13.100 STATS - Print cumulative performance statistics on a Raid Set or Cache Range
• 13.101 STRING - perform a string operation on a given value
• 13.102 SUFFIX - Suffixes permitted on some big decimal numbers
• 13.103 SYSLOG - device to send system messages for logging
• 13.104 SYSLOGD - initialize or access messages in the system log area
• 13.105 TEST - condition evaluation command
• 13.106 TIME - Print the number of seconds since boot (or reset of clock)
• 13.107 TRAP - intercept a signal and perform some action
• 13.108 TRUE - returns the K9 true status
• 13.109 STTY or TTY - print the user's terminal mount point or terminfo status
• 13.110 UNSET - delete one or more environment variables
• 13.111 UNSETENV - unset (delete) a GLOBAL environment variable
• 13.112 VERSION - print out the version of the RaidRunner kernel
• 13.113 WAIT - wait for a process (or my children) to terminate
• 13.114 WARBLE - periodically pulse the buzzer
• 13.115 XD- dump given file(s) in hexa-decimal to standard out
• 13.116 ZAP - write zeros to a file
• 13.117 ZCACHE - Manipulate the zone optimization IO table of a Raid Set's cache
• 13.118 ZERO - file when read yields zeros continuously
• 13.119 ZLABELS - Write zeros to the front and end of Raid Sets

14. Advanced Topics: SCSI Monitor Daemon (SMON)

15. Further Reading