PacketFence Upgrade Guide PacketFence v11.0.0 Version 11.0.0 - September 2021 Table of Contents 1. About this Guide . 2 1.1. Other sources of information . 2 2. General Upgrade Tips . 3 2.1. Prerequisites . 3 2.2. Database and configurations backup . 3 2.3. Disable monit alerts (only if you have monit installed) . 3 3. Type of upgrades. 4 4. Upgrade to a patch version (X.Y.PATCH). 5 4.1. Upgrade packages . 5 4.2. New versions of config files . 5 4.3. Restart PacketFence services . 6 5. Upgrade to a major or minor version (MAJOR.MINOR.Z). 7 5.1. Update repository definition. 7 5.2. Upgrade packages . 7 5.3. New versions of config files . 8 5.4. Export/Import your configuration . 8 6. Upgrade procedure . 9 6.1. Clustered environment: specific procedure. 9 6.2. Stop all PacketFence services . 9 6.3. Packages upgrades . 10 6.4. Restart all PacketFence services. 12 6.5. Regenerate Monit configuration. 12 7. Upgrading from a version prior to 8.0.0 . 13 7.1. Realms upgrade . 13 7.2. Fingerbank v2. 13 7.3. Changes to the default switch roles . 14 7.4. Removal of the graphite database . 14 7.5. Changes to DNS filters . 14 7.6. Database schema update (all Linux distributions). 15 8. Upgrading from a version prior to 8.1.0 . 16 8.1. Changes on unreg_on_accounting_stop parameter . 16 8.2. Database schema update (all Linux distributions). 16 9. Upgrading from a version prior to 8.2.0 . 17 9.1. Queue Stats maintenance job removal . 17 9.2. Upgrade pfdetect Perl regex to the go RE2 regex . 17 9.3. Upgrade realm.conf to be tenant aware . 17 9.4. The api_user table has been deprecated . 17 9.5. Upgrade pf user privileges . 17 9.6. Update connection_type from WIRED_MAC_AUTH to Ethernet-NoEAP . 18 9.7. Database schema. 18 10. Upgrading from a version prior to 8.3.0. 19 10.1. Upgrade pf.conf to rename configuration parameters. 19 10.2. Upgrade authentication.conf to add searchattributes parameter. 19 10.3. Adjustment to the encoding of the configuration files and templates . 19 10.4. Database schema . 19 11. Upgrading from a version prior to 9.0.0. 21 11.1. Support for Debian 8 dropped. 21 11.2. Necessity to use MariaDB . 21 11.3. Deprecate the classic dhcp filters . 21 11.4. Violations have been renamed to Security Events . 21 11.5. Removed MAC detection setting. 21 11.6. Modifications to accounting cleanup. 22 11.7. Admin roles configuration. 22 11.8. Database schema . 22 12. Upgrading from a version prior to 9.1.0. 23 12.1. Now possible to disable a domain . 23 12.2. pfperl-api port . 23 12.3. Linkedin OAuth2 . 23 12.4. VLAN pool configuration . 23 12.5. Remove Useragent Triggers . 23 12.6. Self service portal . 24 12.7. Password of the day rotation . 24 12.8. Database schema . 24 13. Upgrading from a version prior to 9.2.0. 25 13.1. Merge of all RPM packages into one (RHEL / CentOS only). 25 13.2. New GPG key for Debian installations (Debian only). 25 13.3. Database schema . 26 14. Upgrading from a version prior to 9.3.0. ..