amconfig(1m)amconfig(1m)NAMEamconfig - check or modify availmon configuration values
SYNOPSIS
/usr/etc/amconfig [ {autoemail|shutdownreason|
tickerd|hinvupdate} [ {on|off} ] ]
/usr/etc/amconfig statusinterval [ days ]
/usr/etc/amconfig tickduration [ seconds ]
/usr/etc/amconfig autoemail.list
DESCRIPTIONamconfig is used to configure availmon(5) via four configuration flags,
two configuration values, and a list of email addresses. If no argument
is given, amconfig shows the status of all flags and values and the
content of the email lists.
The first synopsis is for configuration flags. In this case, usage for
showing status and turning flags on or off is the same as for
chkconfig(1M).
The autoemail flag controls automatic distribution of availmon reports
according to autoemail.list.
The shutdownreason flag enables prompting for the reason for taking the
system down.
The tickerd flag enables system uptime monitoring.
The hinvupdate flag enables checking for hardware inventory changes on
each reboot and include such information in diagnosis reports.
The second synopsis is for modifying the interval of sending status
reports. Availmon will send status reports periodically if the system is
up for an extended period of time, according to the value of
statusinterval. If the interval is zero, no status reports will be sent.
The status reports will be sent only if tickerd is on.
The third synopsis is for modifying tickduration value. Eventmond(1M)
records system uptime in tickfile (/var/adm/avail/.save/lasttick) every
tickduration seconds. This information is used to estimate uptime in the
case of a system hang.
The fourth synopsis is for modifying email lists for automatic
distribution of availmon reports. There are three kinds of reports:
availability, diagnosis and pager. Availability and diagnosis reports
can be sent in any of three formats: compressed and encrypted,
compressed, and plain text. Pager reports are formatted only as concise
plain text. amconfig invokes vi(1) to edit the email lists, which
consist of report format specifications and associated address lists.
The address lists can be edited, but the report format specifications
should not be modified. If an address list is long, it can be split into
several entries (lines) with the same report format specification, but
Page 1
amconfig(1m)amconfig(1m)
and the total length of the addresses list cannot exceed 1024 characters.
An alias can be used to shorten the total length.
If an address is added to autoemail.list and autoemail is on, amconfig
will send a registration report to the newly configured address. Or if
an existing address is deleted (and autoemail is on), amconfig will send
a deregistration report to the deleted address. For either action, there
is no need to change the autoemail setting.
Default configuration upon installation is:
autoemail
off
shutdownreason
on for high-end systems
off otherwise
tickerd
on for high-end systems
off otherwise
hinvupdate
on for high-end systems
off otherwise
statusinterval
60 (disabled if tickerd is off)
tickduration
300 (disabled if tickerd is off)
autoemail.list
availability (compressed,encrypted):
availability (compressed):
availability (text):
diagnosis (compressed,encrypted): availmon@csd.sgi.com
diagnosis (compressed):
diagnosis (text):
pager (text):
SYSLOGD CONFIGURATION REQUIREMENT
In order for esp(5) to capture Kernel Availability events and send
reports ( if configured ), it is necessary to configure the file
/etc/syslog.conf. Make sure the following entry is present:
*.notice |/usr/etc/amfilter
The following are the Availability Events captured in the Kernel:
MAINT-NEEDED SYS-DEGRADED CONFIG-ISSUE TOOK-ACTION
Page 2
amconfig(1m)amconfig(1m)SEE ALSOesp(5), availmon(5), eventmond(1M), chkconfig(1M), vi(1).
Page 3
