doc/web/source/installation/install_vmm.rst
author Pascal Volk <user@localhost.localdomain.org>
Mon, 27 Aug 2012 20:49:31 +0000
changeset 594 cdbe200c0ecc
parent 591 2b165e90e225
child 626 f151defe7078
permissions -rw-r--r--
VMM/serviceset: Fixed a conditional ProgrammingError. Affects only setups with Dovecot < v1.2.beta2. Actually the SQL query in method ServiceSet._load_by_services wasn't updated. Removed unnecessary code, which would have also produced a ProgrammingError, if it would have been correct.

==============
Installing vmm
==============
After you've prepared everything, it's time to install vmm.
Change into the :file:`vmm-0.6.0` directory an execute the
:file:`install.sh` script.
You can adjust the installation prefix by modifying line 8 of the script.

.. code-block:: console

 root@host:~# cd /path/to/vmm-0.6.0
 root@host:/path/to/vmm-0.6.0# ./install.sh

 Don't forget to edit /usr/local/etc/vmm.cfg - or run: vmm cf
 and /etc/postfix/pgsql-*.cf files.

 root@host:/path/to/vmm-0.6.0#

pgsql-\*.cf files
-----------------
After executing the install script you have to edit all :file:`pgsql-{*}.cf`
files in `postconf -h config_directory`. For details see `pgsql_table(5)`_.

The used parameter values are:

========= =============
parameter value
========= =============
dbname    mailsys
hosts     localhost
password  some_password
user      postfix
========= =============

So it's easy to use just the :command:`sed` command, in order to edit all
files at once. For example:

.. code-block:: console

 root@host:~# sed -i "s|\bpostfix\b|_postfix|g" `postconf -h config_directory`/pgsql-*.cf
 root@host:~# sed -i "s|some_password|3Q>MO…|g" `postconf -h config_directory`/pgsql-*.cf
 root@host:~#

If your `sed` doesn't like the `-i` option (is unable to edit files in place),
you can do it with :command:`perl`:

.. code-block:: console

 # perl -pi -e "s|\bpostfix\b|_postfix|g" `postconf -h config_directory`/pgsql-*.cf

.. note:: Don't forget to start or restart Dovecot and Postfix.

vmm configure
-------------
Finally you have to edit your :file:`vmm.cfg`. You can edit the configuration
file in your favorite editor or execute :command:`vmm configure`.
vmm's configuration parameters are described in :manpage:`vmm.cfg(5)`.
The initial :doc:`../vmm.cfg` is also well documented.

Ready, set, go!
---------------
For a list of available subcommands execute :command:`vmm help`.
For details about the subcommands see :manpage:`vmm(1)` or continue reading
at :doc:`../howto`.

.. include:: ../ext_references.rst