unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 irconcheck(1M)						      irconcheck(1M)




 NAME
      irconcheck - Internal RAID Consistency Check

 SYNOPSIS
      /opt/raid4si/bin/irconcheck
	   [-d device_file -l logical_drive_number]
	   [-d device_file -a -l logical_drive_number]
	   [-d device_file -q]


 DESCRIPTION
      On systems with RAID 4Si controllers installed, consistency checks
      should be performed regularly since

      1. Consistency checks for logical drives at RAID levels 1, 3 and 5
	 correct any parity or mirror errors.

      2. Consistency checks help prevent disk rebuilds from failing.  If
	 there are bad blocks present on a drive, a disk rebuild using
	 data from that drive would fail.  Consistency checks force every
	 block on the drive to be read, and any bad blocks to be marked.
	 Hence while rebuilding, bad blocks will be skipped.

      You should create a cron(1M) job to perform consistency checks
      regularly at a time when the system load allows the consequent
      decrease in performance.	Running the command once per week is
      recommended.  The cron(1M) would run irconcheck with no options.

      As an example, the following cron entry will run irconcheck once per
      week, on Saturday night at 10pm.

      # Run a consistency check weekly on all logical drives on all
      # RAID 4Si controllers in the system.
      #
      # minute hour monthday month weekday command
	00     22   *	     *	   6	   /opt/raid4si/bin/irconcheck

      You can also run irconcheck in an interactive mode.  You could specify
      the controller and the logical drive on that controller on which you
      wish to perform consistency check.  You can abort consistency check on
      the specified drive of the specified controller.	You can also query
      to see the consistency check progress on all the logical drives of the
      specified controller.

    Options
      None		  Run consistency check on all logical drives on
			  each RAID 4Si controller present in the system.
			  Best when used with cron(1M) ,since it may take
			  several hours to complete.





 Hewlett-Packard Company	    - 1 -	  Formatted:  August 2, 2006






 irconcheck(1M)						      irconcheck(1M)




      [-d device_file -l logical_drive_number]
			  Start a consistency check on the specified logical
			  drive on the specified RAID 4Si controller.  This
			  command completes immediately after the
			  consistency check is started.	 The consistency
			  check will run to completion.

      [-d device_file -a  -l logical_drive_number]
			  Aborts the consistency check on the specified
			  logical drive on the specified RAID 4Si
			  controller.

      [-d device_file -q] Displays the consistency check progress on all
			  logical drives on the specified RAID 4Si
			  controller.  When a consistency check is not in
			  progress, the query option will normally report
			  the status of the last consistency check that
			  completed.

    Messages
      Starting consistency check

	Message - Consistency check started successfully on logical
		  drive [logical drive #] on controller at /dev/iopX
	Cause	- Success in starting consistency check on the logical
		  drive.
	Action	- No action necessary.

	Message - Cannot perform consistency check on logical
		  drive [logical drive #] on controller at /dev/iopX
		  since the logical drive is not in OPTIMAL state
	Cause	- The logical drive is not configured on the controller at
		  /dev/iopX or the logical drive is not in OPTIMAL state.
	Action	- Use irm(1M) to determine why the drive is not in OPTIMAL.
		  state.

	Message - Cannot perform consistency check on logical
		  drive [logical drive #] on controller at /dev/iopX
		  since it has a RAID level of 0
	Cause	- Consistency checks can be performed only on logical drives
		  that have RAID levels of 1, 3 or 5.
	Action	- Need to specify a logical drive with RAID level 1, 3 or 5.

	Message - Consistency check already in progress on logical
		  drive [logical drive #] on controller at /dev/iopX
	Cause	- There is already a consistency check in progress on the
		  logical drive.
	Action	- No action necessary.

	Message - Consistency check not started on logical
		  drive [logical drive #] on controller at /dev/iopX



 Hewlett-Packard Company	    - 2 -	  Formatted:  August 2, 2006






 irconcheck(1M)						      irconcheck(1M)




	Cause	- This error message is for errors in starting consistency
		  checks other than those stated above.
	Action	- Retry the command.

      Aborting consistency check

	Message - Success
	Cause	- Consistency check aborted successfully.
	Action	- No action necessary.

	Message - Nothing to abort
	Cause	- Cannot abort consistency check since the logical drive
		  is not configured on the controller at /dev/iopX.
	Action	- Use irm(1M) to determine which adapter and logical drive
		  to specify.

	Message - Unable to abort since consistency check not in progress
	Cause	- There is no check in progress on the logical drive.
	Action	- Need to check the logical drive number specified.

	Message - Command failed
	Cause	- This error message is for errors in aborting consistency
		  checks other than those stated above.
	Action	- Retry the command.

      Checking consistency check progress

	Message - [progress %]
	Cause	- Consistency check in progress (progress % indicates the
		  percentage of check completed)
	Action	- No action necessary.

	Message - Errors were corrected (progress = %)
	Cause	- The consistency check found and corrected errors on the
		  logical drive (progress % indicates the percentage of
		  check completed).  Note that it is normal for errors to be
		  corrected the first time this command is run on a
		  particular logical drive.
	Action	- No action necessary.

	Message - Consistency check not in progress
	Cause	- There is no check in progress on the logical drive.
	Action	- No action necessary.

	Message - Command failed
	Cause	- This error message is for errors in reporting consistency
		  check progress other than those stated above.
	Action	- No action necessary.

 EXAMPLES
      Start a consistency check on logical drive 0 on the controller at



 Hewlett-Packard Company	    - 3 -	  Formatted:  August 2, 2006






 irconcheck(1M)						      irconcheck(1M)




      /dev/iop0
	       irconcheck -d /dev/iop0 -l 0

      Check the progress of the consistency checks on the controller at
      /dev/iop0
	       irconcheck -d /dev/iop0 -q

      Abort the consistency check on logical drive 0 on the controller at
      /dev/iop0
	       irconcheck -d /dev/iop0 -a -l 0

 AUTHOR
      irconcheck was developed by HP.

 FILES
      /opt/raid4si/bin	       Executable file.

      /dev/console	       Console device file.

      /var/adm/syslog/syslog.log
			       System log.

      /sbin/init.d/i2o_raid    Control script.

 SEE ALSO
      irm(1M), irdisplay(1M), irdiag(1M)

      System Administration Tasks
      RAID 4Si User's Guide

























 Hewlett-Packard Company	    - 4 -	  Formatted:  August 2, 2006