HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

a
amlog(1M) amlog(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 potential privileges possessed by the com-
mand 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 sys-
tem audit trail. This privilege is raised whenever the command needs to write an
audit record.
EXTERNAL INFLUENCES
Environment Variables
LC_MESSAGES determines the language in which messages are displayed. The current language set-
tings can be checked with locale(1).
AM60_MAX_LOG_SIZE_MB
defines the maximum size (in megabytes) allocated for storage of the disk
array log files. The log files are stored as individual files in
/var/opt/hparray/log
. All log files will
be maintained until the specified maximum value is exceeded. At that point, the oldest log file will be
deleted to make room for the new file (FIFO).
The valid range for this variable is 100 to 4096 (100 MB to 4 GB). If a value outside of this range is
specified, it will be ignored, and the default value will be used. The default value for allocated log storage
area is 100 MB. When setting a value, make sure the
/var file system is large enough to accommodate
the logs files. If it is not, the log files may overflow the file system.
RETURN VALUE
amlog 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.
DIAGNOSTICS
The following message can be generated by
amlog:
Usage: amlog [-s <StartTime>] [-e <EndTime>]
[-t <RecordType[,RecordType...]>] [-c]
[-d <LogDir>] [-S] [-V] [-a <ArrayID>]
Extended help: amlog -?
An error in command syntax has occurred. Re-enter the command with all necessary arguments.
EXAMPLES
Display the controller log for disk array 000200A0B805E798. Display the log entries entered since
6/1/99.
amlog -s 0601000099 -a 000200A0B805E798
Display the controller log for all disk arrays on the host. Use the default settings to display all log
entries.
HP-UX 11i Version 2: September 2004 − 2 − Hewlett-Packard Company Section 1M−−33