Chapter 10. Variables of the postfix role in System Roles
The postfix role variables allow the user to install, configure, and start the postfix Mail Transfer Agent (MTA).
The following role variables are defined in this section:
-
postfix_conf: It includes key/value pairs of all the supportedpostfixconfiguration parameters. By default, thepostfix_confdoes not have a value.
postfix_conf: relayhost: example.com
If your scenario requires removing any existing configuration and apply the desired configuration on top of a clean postfix installation, specify the previous: replaced option within the postfix_conf dictionary:
An example with the previous: replaced option:
postfix_conf: relayhost: example.com previous: replaced
-
postfix_check: It determines if a check has been executed before starting thepostfixto verify the configuration changes. The default value is true.
For example:
postfix_check: true
-
postfix_backup: It determines whether a single backup copy of the configuration is created. By default thepostfix_backupvalue is false.
To overwrite any previous backup run the following command:
# *cp /etc/postfix/main.cf /etc/postfix/main.cf.backup*
If the postfix_backup value is changed to true, you must also set the postfix_backup_multiple value to false.
For example:
postfix_backup: true postfix_backup_multiple: false
-
postfix_backup_multiple: It determines if the role will make a timestamped backup copy of the configuration.
To keep multiple backup copies, run the following command:
# *cp /etc/postfix/main.cf /etc/postfix/main.cf.$(date -Isec)*
By default the value of postfix_backup_multiple is true. The postfix_backup_multiple:true setting overrides postfix_backup. If you want to use postfix_backup you must set the postfix_backup_multiple:false.
-
postfix_manage_firewall: Integrates thepostfixrole with thefirewallrole to manage port access. By default, the variable is set tofalse. If you want to automatically manage port access from thepostfixrole, set the variable totrue. -
postfix_manage_selinux: Integrates thepostfixrole with theselinuxrole to manage port access. By default, the variable is set tofalse. If you want to automatically manage port access from thepostfixrole, set the variable totrue.
The configuration parameters cannot be removed. Before running the postfix role, set the postfix_conf to all the required configuration parameters and use the file module to remove /etc/postfix/main.cf.
10.1. Additional resources
-
/usr/share/doc/rhel-system-roles/postfix/README.md
