amconfig(1M)                                                      amconfig(1M)



NAME
     amconfig - check or modify availmon configuration values

SYNOPSIS
     /usr/etc/amconfig [ { autoemail | shutdownreason | tickerd
                         | hinvupdate | livenotification }
                         [ { on | off } ] ]
     /usr/etc/amconfig statusinterval [ days ]
     /usr/etc/amconfig autoemail.list

DESCRIPTION
     amconfig is used to configure availmon(5) via five configuration flags,
     one configuration value, 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.  Its default is off.  The amregister(1M)
     command is normally used to "enable" automatic email distribution; it
     sets autoemail on, and sends a registration report to addresses in
     autoemail.list.

     The shutdownreason flag enables prompting for the reason for taking the
     system down.  The tickerd flag enables running a lightweight daemon to
     monitor uptime.  The hinvupdate flag enables checking for hardware
     inventory changes on each reboot and including such information in
     diagnosis reports.  The livenotification flag enables notification of
     important system log messages to configured e-mail recipients. For each
     of these flags, the default is on for high-end systems; off otherwise.

     The second synopsis is for modifying the interval of sending status
     reports.  The default value is 60 days.  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 uptime is checked by the availmon
     ticker daemon, so status reports will be sent only if tickerd is on.

     The third synopsis is for modifying the auto-email.list configuration
     file.  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 two entries (lines) with the same report
     format specification, but the total length of the addresses in one email
     list cannot exceed 1024 characters.  An alias can be used to shorten the



                                                                        Page 1

amconfig(1M)                                                      amconfig(1M)



     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    (turned on by amregister(1M))

     shutdownreason
          on     for high-end systems
          off    otherwise

     tickerd
          on     for high-end systems
          off    otherwise

     hinvupdate
          on     for high-end systems
          off    otherwise

     livenotification
          on     for high-end systems
          off    otherwise

     statusinterval
          60     (not enabled 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):

FILES
     /var/adm/avail/config/{autoemail,shutdownreason,tickerd,hinvupdate,livenotification}
               configuration files containing flag values for autoemail,
               shutdownreason, tickerd, hinvupdate, livenotification.
     /var/adm/avail/config/statusinterval
               configuration file containing the value of statusinterval.
     /var/adm/avail/config/autoemail.list
               configuration file containing the autoemail.list address lists.






                                                                        Page 2

amconfig(1M)                                                      amconfig(1M)



SEE ALSO
     amnotify(1M), amregister(1M), amreport(1M), amsend(1M), amsysinfo(1M),
     amtickerd(1M), chkconfig(1M), vi(1), availmon(5).




















































                                                                        Page 3