1AUTER.CONF(5) File Formats AUTER.CONF(5)
2
6 auter.conf - Config file for auter
7
9 /etc/auter/auter.conf
10
12 This is the default config file for auter.
13
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 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 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 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 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 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 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 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 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 PREPREPSCRIPTDIR
127 Default: /etc/auter/pre-prep.d
128 POSTPREPSCRIPTDIR
130 Default: /etc/auter/post-prep.d
131 PREAPPLYSCRIPTDIR
133 Default: /etc/auter/pre-apply.d
134 POSTAPPLYSCRIPTDIR
136 Default: /etc/auter/post-apply.d
137 PREREBOOTSCRIPTDIR
139 Default: /etc/auter/pre-reboot.d
140 POSTREBOOTSCRIPTDIR
142 Default: /etc/auter/post-reboot.d
143
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
153 auter(1), cron(8), crontab(5), yum(8)
154auter 0.11 May 2018 AUTER.CONF(5)