unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 arraylog(1M)							arraylog(1M)




 NAME
      arraylog - accesses and clears disk array logs.

 SYNOPSIS
      arraylog [-u] [-e] [ -d slot [-p pagecode] ] [ -C { -c | -d slot} ]
	   [-?] array-id

 DESCRIPTION
      arraylog provides access to the controller and disk logs maintained by
      the disk array identified by array-id.  These logs contain information
      useful for diagnosing and troubleshooting the disk array. The logs can
      also be cleared using arraylog.

      The array-id used to address the disk array can be the disk array
      serial number, the character device file name of any LUN on the array
      (LUN 0 if no LUNs are created), or the alias text string assigned to
      the disk array.

    Options
      arraylog supports the following options:

	   -C { -c | -d slot }
			  Clear the specified logs. If -c is specified,
			  clear the disk array controller usage and event
			  logs.	 Both logs will be cleared when using this
			  option. It is not possible to clear just one of
			  the logs.

			  If -d is specified, clear the log for the disk
			  installed in the cabinet slot identified by slot.

	   -d slot [-p pagecode]
			  Display the contents of the log for the disk
			  installed in the cabinet slot identified by slot.
			  Slot numbers must be of the form An or Bn, where A
			  or B correspond to a cabinet column, and n
			  corresponds to a shelf position (1-6).

			  The -p option returns the log information
			  identified by pagecode.  The use of the -p option
			  is intended primarily for accessing logs on
			  unsupported disks.

	   -e		  Display the contents of the disk array controller
			  event log.

	   -u		  Display the contents of the disk array controller
			  usage log.

	   -?		  Display expanded usage message. This option
			  overrides all others.



				    - 1 -	  Formatted:  August 2, 2006






 arraylog(1M)							arraylog(1M)




 EXTERNAL INFLUENCES
    Environment Variables
      LC_MESSAGES determines the language in which messages are displayed.
      The current language settings can be checked with locale(1).

 RETURN VALUE
      arraylog returns the following values:

	   0  Successful completion.
	   1  An error in execution (I/O, subsystem, security, etc.)
	      occurred.
	   2  An error in command syntax occurred: for example, an unknown
	      command-line option was passed.
	   3  Timeout in communication to server. May indicate ARMServer is
	      not running.

 DIAGNOSTICS
      The following messages can be generated by arraylog:

      Usage: arraylog {[-u] [-e] [-d n [-p n]] [-C -c] [-C -d n]} [-?]
      <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

      arraylog: Arg out of range
	   One of the arguments has exceeded its maximum or minimum size, or
	   is incorrect in form.  Check the size and form of each argument.

      arraylog: No such file or directory
	   The specified array-id does not exist or does not identify a disk
	   array that is communicating with the system.	 Verify the correct
	   array-id with ioscan(1M) or arraydsp(1M).

      arraylog: Unknown argument
	   An invalid argument was specified. Check command usage.

      arraylog: Error in command execution, <&lt&lt&lt;Additional Error Info>&gt&gt&gt;:
      <&lt&lt&lt;Error Info Decode>&gt&gt&gt;
	   The command failed due to a device error, an internal error, or a
	   system error. The Additional Error Info and Error Info Decode
	   fields will hold specifics about the failure and its cause.

      arraylog: Cannot clear logs on an unsupported disk.
	   An attempt was made to clear the logs on an unsupported disk.
	   The logs on an unsupported disk cannot be cleared using this
	   command.

      arraylog: No disk in slot n.
	   There is no disk in the indicated slot.





				    - 2 -	  Formatted:  August 2, 2006






 arraylog(1M)							arraylog(1M)




      Use the -p [pagecode] option to attempt to recover any log information.
      Any recoverable log data will be displayed as a hex dump.
	   The logs on an unsupported disk cannot be interpreted by the
	   arraylog utility. Using the -p [ pagecode ] option will cause the
	   utility to retrieve any log information it can from the disk.

      arraylog: Array was just powered-on or reset.
	   The command failed because the disk array has been powered-on or
	   reset.  Reissue the command and it should succeed.

 EXAMPLES
      Display the controller usage log for the disk array identified by
      device file /dev/rdsk/c2t0d0:

	   arraylog -u /dev/rdsk/c2t0d0

      Display the controller event log for disk array serial number
      00786b5c0000:

	   arraylog -e 00786b5c0000

      Display the log information for the disk installed in slot A2 of the
      disk array identified by device file /dev/rdsk/c2t0d0:

	   arraylog -d A2 /dev/rdsk/c2t0d0

      Clear the controller event and usage logs for disk array serial number
      00786b5c0000:

	   arraylog -C -c 00786b5c0000

      Clear the log for the disk installed in slot B1 of disk array serial
      number 00786b5c0000:

	   arraylog -C -d B1 00786b5c0000

 DEPENDENCIES
      ARMServer must be running to execute this command. See ARMServer(1M).

 SECURITY CONFIGURATION
      This command is modified for all security configurations.

    Security Behavior/Restrictions
      Use of this command is restricted to authorized users only.

    Command Authorizations
      This command requires the sysadmin authorization to successfully
      execute.

    Privileges
      The command has been modified to support least privilege. The



				    - 3 -	  Formatted:  August 2, 2006






 arraylog(1M)							arraylog(1M)




      potential privileges possessed by the command and their uses include:

      allowdacread	  This privilege is raised to provide discretionary
			  read access to the devices.

      allowdacwrite	  This privilege is raised to provide discretionary
			  write access to the devices.

      allowmacread	  This privilege is raised to provide mandatory read
			  access to the devices.

      allowmacwrite	  This privilege is raised to provide mandatory
			  write access to the devices.

      filesysops	  This privilege is raised to allow the mknod(2)
			  system call to succeed.

      writeaudit	  The command generates its own audit records and
			  submits these directly to the system audit trail.
			  This privilege is raised whenever the command
			  needs to write an audit record.

 AUTHOR
      arraylog was developed by HP.

 SEE ALSO
      ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraymgr(1M),
      arrayrbld(1M), arrayrecover(1M), download(1M), drivetest(1M),
      dteststat(1M), logprint(1M).

























				    - 4 -	  Formatted:  August 2, 2006