1AUTER.CONF(5)                    File Formats                    AUTER.CONF(5)
2
3
4

NAME

6       auter.conf - Config file for auter
7

SYNOPSIS

9       /etc/auter/auter.conf
10

DESCRIPTION

12       This is the default config file for auter.
13

OPTIONS

15       CONFIGSET
16              This is the name tag for this config file. Log files, auter gen‐
17              erated files and postreboot jobs will be named using this tag.
18               IMPORTANT: This auter tag MUST BE UNIQUE on a system
19               Valid options: String with no special characters or spaces
20               Examples:
21               CONFIGSET="default"
22               CONFIGSET="kernelonly"
23               CONFIGSET="dailyupdate"
24
25
26       AUTOREBOOT
27              This controls if auter  will  automatically  reboot  the  server
28              after  updates  have  been  installed.  The  system will only be
29              rebooted if one or more updates were  applied  successfully.  If
30              you  require  a  reboot even when no updates were applied, leave
31              AUTOREBOOT set to "no" and add the --reboot option to the  auter
32              command.
33               NOTES:
34               -  If  yum  fails  to complete the transaction, auter will exit
35              before the reboot phase is initiated
36               - If there are no updates available (relevant to this  profile)
37              auter will not initiate the reboot
38               -  All  relevant  pre-apply,  post-apply and pre-reboot scripts
39              must return a zero exit code
40               Valid options: yes/no
41
42
43       PACKAGEMANAGEROPTIONS
44              Options to pass to the (relevant) package manager  (yum/dnf/apt)
45              when  the  update/upgrade action is called. If dnf is installed,
46              it will be the preferred package manager.
47               Valid options: Space separated package manager options
48               Examples:
49               PACKAGEMANAGEROPTIONS="--disableexcludes=all"
50               PACKAGEMANAGEROPTIONS="--disablerepo=epel"
51               PACKAGEMANAGEROPTIONS="--enablerepo=epel --exclude=auter*"
52
53
54       PREDOWNLOADUPDATES
55              If the --downloadonly option is available then updates  will  be
56              downloaded during the --prep prep stage
57               NOTES:
58               - This is only useful if you run the prep and apply phase's are
59              run at different times.
60               - If you intend to use ONLYINSTALLFROMPREP this needs to be set
61              to yes
62               Valid options: yes/no
63
64
65       ONLYINSTALLFROMPREP
66              Option  to  only  install  the  downloaded packages. This option
67              should be used when getting multiple servers to apply  the  same
68              update  list   (eg  to  keep  a  uat/staging/prod environment in
69              sync), or when you would like to review  the  updates  ahead  of
70              applying  them.  Not  setting  this  option will result in auter
71              installing the latest available packages at the time apply runs.
72               NOTES:
73               - The PREDOWNLOADUPDATES must be set to "yes" for this to  take
74              effect.
75               - The directory must be owned by user and group 'root' and must
76              not be writable by other.
77               Valid options: yes/no
78
79
80       MAXDELAY
81              MAXDELAY is upper limit of a random time to wait before querying
82              repositories.  This  applies to downloading updates (--prep) and
83              installing updates (--apply). This is used to  stagger  load  on
84              the repository servers. Default is 3600 seconds so yum/dnf waits
85              a random time between 1 and 3600 seconds.
86               NOTES:
87               - Value is set in seconds
88               - This delay is ignored when auter is manually executed
89               Valid options: 1-3600
90               Default: 3600
91               Examples:
92               MAXDELAY=60
93
94
95       PACKAGEMANAGERLOCKWAITTIME
96              If there is a package manager lock then auter can be  configured
97              to  wait for the lock to be released. PACKAGEMANAGERLOCKWAITTIME
98              is the amount of time that auter will wait before  retrying  the
99              update.
100               Valid options: Any number greater than 1
101               Default: 60
102
103
104       PACKAGEMANAGERLOCKRETRIES
105              If  there is a package manager lock then auter can be configured
106              to wait for the lock to be  released.  PACKAGEMANAGERLOCKRETRIES
107              is the amount of retry attempts that will be made.
108               Valid options: Any number greater than 1
109               Default: 5
110
111
112
113       Custom script hooks
114              These are the options for setting directories containing scripts
115              to execute before and after updates are prepared,  applied,  and
116              before/after a reboot (if applicable).
117               NOTES:
118               -  If  you are using multiple auter profiles which require dif‐
119              ferent scripts to be executed, this is where you should  specify
120              the script directories.
121               -  Scripts  in  these  directories  must be executable (+x) for
122              auter to run them
123               - If any scripts run by auter exit with a non-zero  exit  code,
124              auter will exit immediately before running any further actions
125
126              PREPREPSCRIPTDIR
127               Default: /etc/auter/pre-prep.d
128
129              POSTPREPSCRIPTDIR
130               Default: /etc/auter/post-prep.d
131
132              PREAPPLYSCRIPTDIR
133               Default: /etc/auter/pre-apply.d
134
135              POSTAPPLYSCRIPTDIR
136               Default: /etc/auter/post-apply.d
137
138              PREREBOOTSCRIPTDIR
139               Default: /etc/auter/pre-reboot.d
140
141              POSTREBOOTSCRIPTDIR
142               Default: /etc/auter/post-reboot.d
143
144

REPORTING BUGS

146       Please  report  any bugs by raising an issue against the github page or
147       email us at:
148               https://github.com/rackerlabs/auter/issues
149               auter-devel@rackspace.com
150
151

SEE ALSO

153         auter(1), cron(8), crontab(5), yum(8)
154
155
156
157auter 0.11                         May 2018                      AUTER.CONF(5)
Impressum