logprint(1M)

NAME

logprint — allows you to format and print the contents of the ARMServer log files.

SYNOPSIS

logprint [-d log_directory_name] [-s start_time] [-e stop_time] [-t record_type...] [-a array_serial_number]

Remarks

This command and the HP Advanced Disk Array management software are not supported on systems running HP-UX 11i Version 1.5, HP-UX 11i Version 1.6, and later versions.

DESCRIPTION

logprint allows you to select and print the contents of the various log files maintained by ARMServer.

Options

logprint supports the following options:

none

Print all log records, except performance records, from the default ARMServer log directory.

-a array_serial_number

Limit the records printed to those associated with the disk array identified by array_serial_number The default is to print the records for all disk arrays.

-d log_directory_name

Specify the directory that contains the ARMServer log files. If not specified, the default is /var/opt/hparray/log.

-e stop_time

Specify the latest log record to print. Any log records with a time later than stop_time will not be printed. The default is the time of the latest log record.

The format for entering time is mmddhhmm[yy]:

mm: Month (01-12)
dd: Day (01-31)
hh: Hour (00-23)
mm: Minute (00-59)
yy: Year (optional)

-s start_time

Specify the earliest log record to print. Any log records with a time earlier than start_time will not be printed. The default is the time of the oldest log record. See above for the format for entering time.

-t record_type

Specify the type(s) of log records to print. If not specified, the default log records include usage, disk, controller, and change.

Valid log types include the following:

usage: System usage log
disk: Disk error log
ctrlr: Controller error log
change: System change log
perf: Performance log

RETURN VALUE

logprint 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.

EXAMPLES

Print all log records that occurred after 0800 on 16 April:

logprint -s 04160800 

Print only the log records for disk array serial number 00786b5c0000. Further limit the log records to usage log and disk log entries that occurred before 0800 on April 16:

logprint -e 04140800 -t usage -t disk -a 00786b5c0000 

LOG OUTPUT DATA

logprint outputs the following data fields:

Controller timestamp

A number indicating the elapsed time since the disk array was commissioned. The number is incremented each millisecond the disk array is operating. This number does not relate in any way to system time and is primarily intended to show the temporal relationship between the log entries on a disk array. If there are multiple disk arrays on the system, each will maintain its own unique timestamp.

Event code

A brief description of the event.

Event count

Indicates the number of times the event occurred.

Component ID

Indicates which disk array controller was involved (6 = controller Y, 7 = controller X).

FRU ID

The code for the hardware assembly involved. The FRU codes map to the disk array hardware assemblies as follows:

0: Disk in slot A1
1: Disk in slot B1
2: Disk in slot A2
3: Disk in slot B2
4: Disk in slot A3
5: Disk in slot B3
6: Disk in slot A4
7: Disk in slot B4
8: Disk in slot A5
9: Disk in slot B5
10: Disk in slot A6
11: Disk in slot B6
129: Reporting controller, or No FRU
130: First installable SIMM on X controller
131: Second installable SIMM on X controller
132: First installable SIMM on Y controller
133: Second installable SIMM on Y controller
134: Other (non-reporting) controller
135: Battery
136: Fan 1
137: Fan 2
138: Fan 3
139: Power Supply 1
140: Power Supply 2
141: Controller X
142: Controller Y
192: Internal SCSI Bus 0
193: Internal SCSI Bus 1
194: Internal SCSI Bus 2
195: Internal SCSI Bus 3

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 potential privileges possessed by the command and their uses include:

allowdacread: This privilege is raised to provide discretionary read access to the devices.
allowmacread: This privilege is raised to provide mandatory read access to the devices.
filesysops: This privilege is raised to allow the mknod(2) system call to succeed.

WARNINGS