|
|
b11fe1 |
You have upgraded your openldap-servers package.
|
|
|
b11fe1 |
Any major version upgrade can cause database corruption or loss.
|
|
|
b11fe1 |
Please, make sure that you have up-to-date back up and read this document carefully.
|
|
|
b11fe1 |
|
|
|
b11fe1 |
It's still recommended to do the backup even on the minor version upgrade.
|
|
|
b11fe1 |
|
|
|
b11fe1 |
Please, review the next links before performing any action:
|
|
|
b11fe1 |
|
|
|
b11fe1 |
Upgrading from 2.4.x - https://www.openldap.org/doc/admin25/appendix-upgrading.html
|
|
|
b11fe1 |
Upgrading from 2.5.x - https://www.openldap.org/doc/admin26/appendix-upgrading.html
|
|
|
b11fe1 |
The normal upgrade procedure - https://www.openldap.org/doc/admin26/maintenance.html
|
|
|
b11fe1 |
|
|
|
b11fe1 |
Additionally, please, review and perform the following steps that can help you with the upgrade:
|
|
|
b11fe1 |
|
|
|
b11fe1 |
1. Back up both data and configuration directories into a safe place;
|
|
|
b11fe1 |
2. Export data to an LDIF file using slapcat;
|
|
|
b11fe1 |
a. If you have the deprecated DB type and you haven't performed the slapcat command, you need to move your data and configuration to the system with OpenLDAP 2.4 version and run slapcat command there;
|
|
|
b11fe1 |
3. Change the server's configuration according to the changes in the above documents;
|
|
|
b11fe1 |
a. If you are replacing the BDB/HDB with MDB, make sure to replace the BDB/HDB sections with their MDB counterparts;
|
|
|
b11fe1 |
4. Clear out the current data directory;
|
|
|
b11fe1 |
5. Import data to a new database from the LDIF file using slapadd;
|
|
|
b11fe1 |
6. Make sure that your data is intact.
|
|
|
b11fe1 |
|
|
|
b11fe1 |
After you have completed the above operations, you can remove this file (/usr/share/openldap-servers/UPGRADE_INSTRUCTIONS) and start the server:
|
|
|
b11fe1 |
|
|
|
b11fe1 |
systemctl start slapd.service
|
|
|
b11fe1 |
|
|
|
b11fe1 |
Be careful with this document's procedure, make sure you understand it, and test it in a non-production environment first. Always make sure that all backups are in place.
|
|
|
b11fe1 |
|
|
|
b11fe1 |
You have been warned about the possibility of data corruption or loss.
|