1 ==============

     2 Installing vmm

     3 ==============

     4 After you've prepared everything, it's time to install vmm.

     5 Change into the :file:`vmm-0.6.2` directory an execute the

     6 :file:`install.sh` script.

     7 You can adjust the installation prefix by modifying line 8 of the script.

     8 

     9 .. code-block:: console

    10 

    11  root@host:~# cd /path/to/vmm-0.6.2

    12  root@host:/path/to/vmm-0.6.2# ./install.sh

    13 

    14  Don't forget to edit /usr/local/etc/vmm.cfg - or run: vmm cf

    15  and /etc/postfix/pgsql-*.cf files.

    16 

    17  root@host:/path/to/vmm-0.6.2#

    18 

    19 pgsql-\*.cf files

    20 -----------------

    21 After executing the install script you have to edit all :file:`pgsql-{*}.cf`

    22 files in `postconf -h config_directory`. For details see `pgsql_table(5)`_.

    23 

    24 The used parameter values are:

    25 

    26 ========= =============

    27 parameter value

    28 ========= =============

    29 dbname    mailsys

    30 hosts     localhost

    31 password  some_password

    32 user      postfix

    33 ========= =============

    34 

    35 So it's easy to use just the :command:`sed` command, in order to edit all

    36 files at once. For example:

    37 

    38 .. code-block:: console

    39 

    40  root@host:~# sed -i "s|\bpostfix\b|_postfix|g" `postconf -h config_directory`/pgsql-*.cf

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

    42  root@host:~#

    43 

    44 If your `sed` doesn't like the `-i` option (is unable to edit files in place),

    45 you can do it with :command:`perl`:

    46 

    47 .. code-block:: console

    48 

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

    50 

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

    52 

    53 vmm configure

    54 -------------

    55 Finally you have to edit your :file:`vmm.cfg`. You can edit the configuration

    56 file in your favorite editor or execute :command:`vmm configure`.

    57 vmm's configuration parameters are described in :manpage:`vmm.cfg(5)`.

    58 The initial :doc:`../vmm.cfg` is also well documented.

    59 

    60 Ready, set, go!

    61 ---------------

    62 For a list of available subcommands execute :command:`vmm help`.

    63 For details about the subcommands see :manpage:`vmm(1)` or continue reading

    64 at :doc:`../howto`.

    65 

    66 .. include:: ../ext_references.rst