mirror of
https://github.com/jwinterm/modoboa.git
synced 2026-10-18 05:51:26 +02:00
65 lines
1.9 KiB
ReStructuredText
65 lines
1.9 KiB
ReStructuredText
#############################
|
|
Migrating from other software
|
|
#############################
|
|
|
|
************
|
|
PostfixAdmin
|
|
************
|
|
|
|
Modoboa provides a simple script to migrate an
|
|
existing `PostfixAdmin (version 2.3.3+)
|
|
<http://postfixadmin.sourceforge.net/>`_ database to a Modoboa one.
|
|
|
|
.. note::
|
|
This script is only suitable for a new installation.
|
|
|
|
First, you must follow the :ref:`installation` step to create a fresh
|
|
Modoboa database.
|
|
|
|
Once done, edit the :file:`settings.py` file. First, add a new database
|
|
connection named ``pfxadmin`` into the ``DATABASES`` variable
|
|
corresponding to your PostfixAdmin setup::
|
|
|
|
DATABASES = {
|
|
"default" : {
|
|
# default connection definition
|
|
},
|
|
"pfxadmin" : {
|
|
"ENGINE" : "<engine>",
|
|
"NAME" : "<database name>",
|
|
"USER" : "<database user>",
|
|
"PASSWORD" : "<user password>",
|
|
}
|
|
}
|
|
|
|
This connection should correspond to the one defined in PostfixAdmin's
|
|
configuration file.
|
|
|
|
Then, uncomment the line containing
|
|
``'modoboa.tools.pfxadmin_migrate'`` inside the ``MODOBOA_APPS``
|
|
variable and save your changes.
|
|
|
|
You are now ready to start the migration so run the following commands::
|
|
|
|
$ cd <modoboa_site>
|
|
$ python manage.py migrate_from_postfixadmin -r -p <directory that stores mailboxes>
|
|
|
|
Depending on how many domains/mailboxes your existing setup contains,
|
|
the migration can be long. Just wait for the script's ending.
|
|
|
|
.. note::
|
|
|
|
The rename operation is not synchronous. If you choose this option,
|
|
you must enable **Handle mailboxes on filesystem** option. See
|
|
:ref:`fs_operations`.
|
|
|
|
The procedure is over, edit the :file:`settings.py` file and:
|
|
|
|
* remove the ``pfxadmin`` database connection from the ``DATABASES``
|
|
variable
|
|
* remove the ``'modoboa.tools.pfxadmin_migrate',`` from the
|
|
``INSTALLED_APPS`` variable
|
|
|
|
You should be able to connect to Modoboa using the same credentials
|
|
you were using to connect to PostfixAdmin.
|