Table of Contents

• Chapter�1��Preliminaries
  • 1.1��Preamble
  • 1.2��Acknowledgements and Thanks
  • 1.3��New Versions
• Chapter�2��Introduction
  • 2.1��5070 features5070 Main Features
  • 2.2��Background
    • 2.2.1��RAID levelsRaid Levels
    • 2.2.2��RAID linearRAID Linear
    • 2.2.3��RAID 1Level 1
    • 2.2.4��stripingStriping
    • 2.2.5��RAID 0Level 0
    • 2.2.6��RAID 2RAID 3Level 2 and 3
    • 2.2.7��RAID 4Level 4
    • 2.2.8��RAID 5Level 5
• Chapter�3��Installation
  • 3.1��compatibilitySBUS Controller Compatibility
  • 3.2��hardware installationHardware Installation Procedure
    • 3.2.1��Serial Terminal
    • 3.2.2��Hard Drive Plant
  • 3.3��5070 Onboard Configuration
    • 3.3.1��Main Screen Options
    • 3.3.2��[Q]uit
    • 3.3.3��[R]aidSets:
    • 3.3.4��[H]ostports:
    • 3.3.5��[S]pares:
    • 3.3.6��[M]onitor:
    • 3.3.7��[G]eneral:
    • 3.3.8��[P]robe
    • 3.3.9��Example RAID Configuration Session
  • 3.4��Linux Configuration
    • 3.4.1��Existing Linux Installation
    • 3.4.2��New Linux Installation
  • 3.5��Maintenance
    • 3.5.1��spares, activatingActivating a spare
    • 3.5.2��re-integrating repaired driveRe-integrating a repaired drive into the RAID (levels 3 and 5)
  • 3.6��Troubleshooting / Error Messages
    • 3.6.1��Out of band temperature detected...
    • 3.6.2��... failed ... cannot have more than 1 faulty backend.
    • 3.6.3��When booting I see: ... Sun disklabel: bad magic 0000 ... unknown partition table.
  • 3.7��Bugs
  • 3.8��Frequently Asked Questions
    • 3.8.1��How do I reset/erase the onboard configuration?
    • 3.8.2��How can I tell if a drive in my RAID has failed?
  • 3.9��command referenceAdvanced Topics: 5070 Command Reference
    • 3.9.1��autobootAUTOBOOT - script to automatically create all raid sets and scsi monitors
    • 3.9.2��AUTOFAULT - script to automatically mark a backend faulty after a drive failure
    • 3.9.3��AUTOREPAIR - script to automatically allocate a spare and reconstruct a raid set
    • 3.9.4��BIND - combine elements of the namespace
    • 3.9.5��BUZZER - get the state or turn on or off the buzzer
    • 3.9.6��CACHE - display information about and delete cache ranges
    • 3.9.7��CACHEDUMP - Dump the contents of the write cache to battery backed-up ram
    • 3.9.8��CACHERESTORE - Load the cache with data from battery backed-up ram
    • 3.9.9��CAT - concatenate files and print on the standard output
    • 3.9.10��CMP - compare the contents of 2 files
    • 3.9.11��CONS - console device for Husky
    • 3.9.12��DD - copy a file (disk, etc)
    • 3.9.13��DEVSCMP - Compare a file's size against a given value
    • 3.9.14��DFORMAT- Perform formatting functions on a backend disk drive
    • 3.9.15��DIAGS - script to run a diagnostic on a given device
    • 3.9.16��DPART - edit a scsihd disk partition table
    • 3.9.17��DUP - open file descriptor device
    • 3.9.18��ECHO - display a line of text
    • 3.9.19��ENV- environment variables file system
    • 3.9.20��ENVIRON - RaidRunner Global environment variables - names and effects
    • 3.9.21��EXEC - cause arguments to be executed in place of this shell
    • 3.9.22��EXIT - exit a K9 process
    • 3.9.23��EXPR - evaluation of numeric expressions
    • 3.9.24��FALSE - returns the K9 false status
    • 3.9.25��FIFO - bi-directional fifo buffer of fixed size
    • 3.9.26��GET - select one value from list
    • 3.9.27��GETIV - get the value an internal RaidRunner variable
    • 3.9.28��HELP - print a list of commands and their synopses
    • 3.9.29��HUSKY - shell for K9 kernel
    • 3.9.30��HWCONF - print various hardware configuration details
    • 3.9.31��HWMON - monitoring daemon for temperature, fans, PSUs.
    • 3.9.32��INTERNALS - Internal variables used by RaidRunner to change dynamics of running kernel
    • 3.9.33��KILL - send a signal to the nominated process
    • 3.9.34��LED- turn on/off LED's on RaidRunner
    • 3.9.35��LFLASH- flash a led on RaidRunner
    • 3.9.36��LINE - copies one line of standard input to standard output
    • 3.9.37��LLENGTH - return the number of elements in the given list
    • 3.9.38��LOG - like zero with additional logging of accesses
    • 3.9.39��LRANGE - extract a range of elements from the given list
    • 3.9.40��LS - list the files in a directory
    • 3.9.41��LSEARCH - find the a pattern in a list
    • 3.9.42��LSUBSTR - replace a character in all elements of a list
    • 3.9.43��MEM - memory mapped file (system)
    • 3.9.44��MDEBUG - exercise and display statistics about memory allocation
    • 3.9.45��MKDIR - create directory (or directories)
    • 3.9.46��MKDISKFS - script to create a disk filesystem
    • 3.9.47��MKHOSTFS - script to create a host port filesystem
    • 3.9.48��MKRAID - script to create a raid given a line of output of rconf
    • 3.9.49��MKRAIDFS - script to create a raid filesystem
    • 3.9.50��MKSMON - script to start the scsi monitor daemon smon
    • 3.9.51��MKSTARGD - script to initialize a scsi target daemon for a given raid set
    • 3.9.52��MSTARGD - monitor for stargd
    • 3.9.53��NICE - Change the K9 run-queue priority of a K9 process
    • 3.9.54��NULL- file to throw away output in
    • 3.9.55��PARACC - display information about hardware parity accelerator
    • 3.9.56��PEDIT - Display/modify SCSI backend Mode Parameters Pages
    • 3.9.57��PIPE - two way interprocess communication
    • 3.9.58��PRANKS - print or set the accessible backend ranks for the current controller
    • 3.9.59��PRINTENV - print one or all GLOBAL environment variables
    • 3.9.60��PS - report process status
    • 3.9.61��PSCSIRES - print SCSI-2 reservation table for all or specific monikers
    • 3.9.62��PSTATUS - print the values of hardware status registers
    • 3.9.63��RAIDACTION- script to gather/reset stats or stop/start a raid set's stargd
    • 3.9.64��RAID0 - raid 0 device
    • 3.9.65��RAID1 - raid 1 device
    • 3.9.66��RAID3 - raid 3 device
    • 3.9.67��RAID4 - raid 4 device
    • 3.9.68��RAID5 - raid 5 device
    • 3.9.69��RAM - ram based file system
    • 3.9.70��RANDIO - simulate random reads and writes
    • 3.9.71��RCONF, SPOOL, HCONF, MCONF, CORRUPT-CONFIG - raid configuration and spares management
    • 3.9.72��REBOOT - exit K9 on target hardware + return to monitor
    • 3.9.73��REBUILD - raid set reconstruction utility
    • 3.9.74��REPAIR - script to allocate a spare to a raid set's failed backend
    • 3.9.75��REPLACE - script to restore a backend in a raid set
    • 3.9.76��RM - remove the file (or files)
    • 3.9.77��RMON - Power-On Diagnostics and Bootstrap
    • 3.9.78��RRSTRACE - disassemble scsihpmtr monitor data
    • 3.9.79��RSIZE - estimate the memory usage for a given raid set
    • 3.9.80��SCN2681 - access a scn2681 (serial IO device) as console
    • 3.9.81��SCSICHIPS - print various details about a controller's scsi chips
    • 3.9.82��SCSIHD - SCSI hard disk device (a SCSI initiator)
    • 3.9.83��SCSIHP - SCSI target device
    • 3.9.84��SET - set (or clear) an environment variable
    • 3.9.85��SCSIHPMTR - turn on host port debugging
    • 3.9.86��SETENV - set a GLOBAL environment variable
    • 3.9.87��SDLIST - Set or display an internal list of attached disk drives
    • 3.9.88��SETIV - set an internal RaidRunner variable
    • 3.9.89��SHOWBAT - display information about battery backed-up ram
    • 3.9.90��SHUTDOWN - script to place the RaidRunner into a shutdown or quiescent state
    • 3.9.91��SLEEP - sleep for the given number of seconds
    • 3.9.92��SMON - RaidRunner SCSI monitor daemon
    • 3.9.93��SOS - pulse the buzzer to emit sos's
    • 3.9.94��SPEEDTST - Generate a set number of sequential writes then reads
    • 3.9.95��SPIND - Spin up or down a disk device
    • 3.9.96��SPINDLE - Modify Spindle Synchronization on a disk device
    • 3.9.97��SRANKS - set the accessible backend ranks for a controller
    • 3.9.98��STARGD - daemon for SCSI-2 target
    • 3.9.99��STAT - get status information on the named files (or stdin)
    • 3.9.100�� � STATS - Print cumulative performance statistics on a Raid Set or Cache Range
    • 3.9.101�� � STRING - perform a string operation on a given value
    • 3.9.102�� � SUFFIX - Suffixes permitted on some big decimal numbers
    • 3.9.103�� � SYSLOG - device to send system messages for logging
    • 3.9.104�� � SYSLOGD - initialize or access messages in the system log area
    • 3.9.105�� � TEST - condition evaluation command
    • 3.9.106�� � TIME - Print the number of seconds since boot (or reset of clock)
    • 3.9.107�� � TRAP - intercept a signal and perform some action
    • 3.9.108�� � TRUE - returns the K9 true status
    • 3.9.109�� � STTY or TTY - print the user's terminal mount point or terminfo status
    • 3.9.110�� � UNSET - delete one or more environment variables
    • 3.9.111�� � UNSETENV - unset (delete) a GLOBAL environment variable
    • 3.9.112�� � VERSION - print out the version of the RaidRunner kernel
    • 3.9.113�� � WAIT - wait for a process (or my children) to terminate
    • 3.9.114�� � WARBLE - periodically pulse the buzzer
    • 3.9.115�� � XD- dump given file(s) in hexa-decimal to standard out
    • 3.9.116�� � ZAP - write zeros to a file
    • 3.9.117�� � ZCACHE - Manipulate the zone optimization IO table of a Raid Set's cache
    • 3.9.118�� � ZERO - file when read yields zeros continuously
    • 3.9.119�� � ZLABELS - Write zeros to the front and end of Raid Sets
  • 3.10��Advanced Topics: SCSI Monitor Daemon (SMON)
  • 3.11��Further Reading