amanda-interactivity — Configuring Interactivity with Amanda Amanda
Amanda uses interactivity to ask user to load specific volumes when they are needed. This manual page describes the interactivity modules included with Amanda.
This is a user-level description of the API, and does not address details that are only of concern to developers of new interactivity plugins. For that purpose, consult the Amanda source code, perldoc 'Amanda::Interactivity' and http://wiki.zmanda.com.
Interactivity is specified in amanda.conf(5) as follows:
define interactivity $interactivity_name { comment "$comment" plugin "$pluginname" property "$PROPERTY_NAME" "$PROPERTY_VALUE" ... }
and then referenced in the global section as
interactivity "$interactivity_name"
Interactivity properties, like Amanda configuration parameters, are
insensitive to case, and -
(dash) and
_
(underscore) may be used interchangeably.
See the individual plugin sections, below for properties applicable to each plugin.
Amanda provides three interactivity modules, tty, email and tty_email.
The tty interactivity module uses the tty to communicate with the user, it works only if a terminal is available, which is the case if amanda is executed from a command line.
When promted for a volume, the user must put the requested volume in the changer and type <enter>. User can type the name of another changer if the volume is available in that changer. Typing 'abort' will abort the operation.
The email interactivity module uses email to send requests to the user, and reads replies from the filesystem.
The email module has many properties:
define interactivity "by-tty-or-email" { comment "Send email on runs from cron; use terminal on command line" plugin "tty_email" property "mailto" "admin1" "admin2" "me@home" property "resend-delay" "1800" #every 30 minutes property "check-file" "/tmp/email_input" property "check-file-delay" "10" #every 10 seconds }
This manual page was written by
.