FAQ Migrate my Mysql database to PostgreSQL

= Prerequisite= Your Dolibarr version must be at least version 3.2.0. If not, first upgrade your Dolibarr keeping MySq. Once upgrade is ok, you must clean database from old tables by running following request on your Mysql database:

=Process=

Export Mysql

 * Go onto page Setup - Tools - Backup.
 * Choose export method "MySql dump".
 * Choose export compatibility "POSTGRESQL".
 * Uncheck "Structure".
 * Check "Name columns".
 * Uncheck "Use extended INSERT".
 * Choose "No LOCK command around INSERT".
 * Into Compression area, choose "Compress None"
 * Then click on "Build backup".
 * Go into directory of your Dolibarr data files (directory is defined into "Setup - System information - Dolibarr - All parameters" on line "Root directory for data files"). Go into subdirectory admin/backup. You will find the dump of database you just build with previous step. Copy this file into /tmp directory.

Create a PostGreSQL database
Note: If you experience problem, you can go back to your Mysql database by restoring files renamed previsously into its original name conf.php.
 * Rename your conf.php file of Dolibarr into conf.php.mysql (file should be into /etc/dolibarr or htdocs/conf)
 * Create an empty file conf.php to replace the renamed one, with read and write permission for everybody.
 * Run Dolibarr. Because the conf.php file is empty, the install process will be suggested instead of logon page. Choose first installation and provide all informations of your postgresql database as data source. Run process until the end. About administrator account asked at end, choose same than the one existing into your MySql sessions.
 * Connect. You are now into an empty new instance of Dolibarr without old data.
 * Enable all modules that were enabled into old database (enable is enough to create modules specific tables, that's all what we want: having same structure than old database).
 * If you added "complementary fields" for some element, you must also defined them into this new instance (again, to have same fields into database than previous instance).
 * We will load old data at next step.

Import dump file
Restart postgresql. Take a look at output log file resimport.log. If target structure was correctly matching mysql structure (no less tables nor fields), you should get no error. If you have error, please report them onto dolibarr forum. Note that you can run this import several time if you fixed error manually to your structure. It is safe because all dolibarr tables are protected by a "unique key". So if you do so, you will just get "duplicate record" errors, that you can ignore. Take care only on others. You can also restore the postgresql.conf file to its initial value.
 * Modify postgresql configuration to accept syntax from mysql file by setting the directive escape_string_warning to off into file postgresql.conf
 * Disable all constraint checks to allow import. For this, connect to database and run the procedure provided by Dolibarr installation:
 * Modify the generated export dump file to set escape characters with correct value for postgres:
 * After conversion of file, import it into your empty postgresql database:
 * Once import is finished, you must enable constraint check and update all sequences to match imported data.

Modify your Dolibarr setup file

 * Open with a file editor, the file conf/conf.php that you can find into your Dolibarr root installation.
 * Modify lines to make program files to point to the new database

Test
You should now have an application 100% working with all its data. Old MySql database can be closed.