Antares-RAID-sparcLinux-HOWTO
Thom Coates (tdc3@psu.edu), Carl Munio, Jim Ludemann
v0.1, 28 April 2000This document describes how to install, configure, and maintain a hardware RAID built around the 5070 SBUS host based RAID controller by Antares Microsystems. Other topics of discussion include RAID levels, the 5070 controller GUI, and 5070 command line. A complete command reference for the 5070's K9 kernel and Bourne-like shell is included.
1. Preamble
2. Acknowledgements and Thanks
3. New Versions
4. Introduction
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
9. Maintenance
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
Next Previous Contents