doc/web/source/installation/prerequisites.rst
changeset 760 b678a1c43027
parent 748 659c4476c57c
child 761 e4e656f19771
--- a/doc/web/source/installation/prerequisites.rst	Mon Mar 24 19:22:04 2014 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,116 +0,0 @@
-==========================
-Installation Prerequisites
-==========================
-You already should have installed and configured Postfix and Dovecot with
-PostgreSQL support. You also need access to a local or remote PostgreSQL
-server.
-
-Check for pgsql support in Dovecot and Postfix
-----------------------------------------------
-To verify that your Dovecot and Postfix installation has support for
-PostgreSQL use the :command:`postconf` and :command:`dovecot` commands as
-shown below:
-
-.. code-block:: console
-
-  root@host:~# postconf -m | grep pgsql
-  pgsql
-  root@host:~# postconf -a | grep dovecot
-  dovecot
-  root@host:~# dovecot --build-options | grep postgresql
-  SQL drivers: mysql postgresql sqlite
-
-vmm depends on Python (≥ 2.4.0) and Psycopg_ (≥ 2.0) or pyPgSQL_ (≥ 2.5.1)
-[#]_. Psycopg and pyPgSQL are depending on parts of the *eGenix.com mx Base
-Distribution* (mxDateTime_ and mxTools_).
-
-If you are using Python ≤ 2.5.0:
-
- ‣ if you want to store your users' passwords as ``PLAIN-MD4`` digest in
-   the database, vmm will try to use ``Crypto.Hash.MD4`` from PyCrypto_
- ‣ if you are using Dovecot ≥ v1.1.0 and you want to store your users'
-   passwords as ``SHA256`` or ``SSHA256`` hashes, vmm will try to use
-   ``Crypto.Hash.SHA256`` from PyCrypto. For ``SHA256``/``SSHA256`` you
-   should have installed PyCrypto, at least in version 2.1.0alpha1.
-
- When the Crypto.Hash module couldn't be imported, vmm will use
- dovecotpw/doveadm, if  the *misc.password_scheme* setting in your
- :file:`vmm.cfg` is set to ``PLAIN-MD4``, ``SHA256`` or ``SSHA256``.
-
-If your Dovecot and/or Postfix installation shouldn't support PostgreSQL you
-could possibly fix this by installing the missing package (see below) or by
-recompiling the corresponding part.
-
-Package names by OS/Distribution
---------------------------------
-Debian GNU/Linux (Squeeze/Wheezy)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- ‣ `postfix <http://packages.debian.org/postfix>`_ and
-   `postfix-pgsql <http://packages.debian.org/postfix-pgsql>`_
- ‣ Squeeze:
-
-   * `dovecot-common <http://packages.debian.org/dovecot-common>`_
-
- ‣ Wheezy (and Squeeze backports):
-
-   * `dovecot-core <http://packages.debian.org/dovecot-core>`_ and
-     `dovecot-lmtpd <http://packages.debian.org/dovecot-lmtpd>`_
-
- ‣ `dovecot-imapd <http://packages.debian.org/dovecot-imapd>`_ and/or
-   `dovecot-pop3d <http://packages.debian.org/dovecot-pop3d>`_
- ‣ `postgresql-client <http://packages.debian.org/postgresql-client>`_
-   (or `postgresql <http://packages.debian.org/postgresql>`_ , if you do not
-   have a dedicated PostgreSQL server.)
- ‣ `python <http://packages.debian.org/python>`_,
-   `python-egenix-mxdatetime \
-   <http://packages.debian.org/python-egenix-mxdatetime>`_
-   and `python-psycopg2 <http://packages.debian.org/python-psycopg2>`_
-   optionally `python-crypto <http://packages.debian.org/python-crypto>`_
- ‣ `gettext <http://packages.debian.org/gettext>`_
-
-FreeBSD
-^^^^^^^
-Packages or build from ports:
- ‣ dovecot
- ‣ postfix
- ‣ postgresql-client (and postgresql-server, if you do not have a dedicated
-   PostgreSQL server.)
- ‣ python25, py25-mx-base and py25-pyPgSQL optionally py25-pycrypto
-
-Gentoo Linux
-^^^^^^^^^^^^
- ‣ `dev-python/pypgsql <http://gentoo-portage.com/dev-python/pypgsql>`_
- ‣ `mail-mta/postfix <http://gentoo-portage.com/mail-mta/postfix>`_
- ‣ `net-mail/dovecot <http://gentoo-portage.com/net-mail/dovecot>`_
- ‣ `dev-db/postgresql-base <http://gentoo-portage.com/dev-db/postgresql-base>`_
- ‣ `dev-db/postgresql-server \
-   <http://gentoo-portage.com/dev-db/postgresql-server>`_
-
-Applied use-Flags (/etc/portage/package.use)::
-
- mail-mta/postfix dovecot-sasl postgres -pam sasl
- net-mail/dovecot postgres -pam pop3d sieve
- dev-db/postgresql-server -perl
-
-OpenBSD (5.x)
-^^^^^^^^^^^^^
-Packages
- ‣ postfix-2.x.y-pgsql
- ‣ dovecot-2.x.y and dovecot-postgresql-2.x.y
- ‣ postgresql-client
- ‣ python-2.7.x, py-psycopg2 and optionally py-crypto
-
-Or build the above mentioned software from ports.
-
-openSUSE Linux
-^^^^^^^^^^^^^^
- ‣ postfix and postfix-postgresql
- ‣ postgresql-server and postgresql
- ‣ dovecot
- ‣ python and pyPgSQL optionally python-crypto
-
-
-.. rubric:: Footnotes
-.. [#] Beginning with version 0.7.0 of vmm support for pyPgSQL will be dropped.
-
-.. include:: ../ext_references.rst