doc/web/source/installation/install_vmm.rst
changeset 579 be0906181a10
child 591 2b165e90e225
equal deleted inserted replaced
578:20141b967c0b 579:be0906181a10
       
     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.0` 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.0
       
    12  root@host:/path/to/vmm-0.6.0# ./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.0#
       
    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)`.
       
    64 
       
    65 .. include:: ../ext_references.rst