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]
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:
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.
AUTHOR
logprint
was developed by HP.
Printable version
