diff -r 20141b967c0b -r be0906181a10 doc/web/source/installation/install_vmm.rst --- /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