doc/web/source/installation/install_vmm.rst
changeset 579 be0906181a10
child 591 2b165e90e225
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/web/source/installation/install_vmm.rst	Sun Jul 29 14:46:52 2012 +0000
@@ -0,0 +1,65 @@
+==============
+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)`.
+
+.. include:: ../ext_references.rst