doc/web/source/download.rst
author Pascal Volk <user@localhost.localdomain.org>
Sun, 30 Dec 2012 16:10:29 +0000
branchv0.7.x
changeset 665 33d15936b53a
parent 629 8009e87c7a20
child 706 6c369b680ab0
permissions -rw-r--r--
VMM/cli/subcommands: Switched argument parsing over to argparse.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     1
===============
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     2
Downloading vmm
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     3
===============
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     4
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     5
Current version
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     6
---------------
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     7
|curr_vers_rel_date|
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     8
|rel_hist|
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     9
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    10
Download a gzip compressed archive
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    11
----------------------------------
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    12
vmm could be downloaded from the `download page`_ at `SourceForge`_. To
626
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    13
extract the downloaded archive use ``tar xzf vmm-0.6.1.tar.gz``. This will
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    14
create the new directory :file:`vmm-0.6.1` in the current working directory.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    15
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    16
Verify the downloaded archive
629
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    17
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    18
If you have downloaded the archive from the download site you can
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    19
optionally verify the integrity_ of this archive.
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    20
In order to verify the integrity of the archive you have to download the
626
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    21
corresponding signature file (:file:`vmm-0.6.1.tar.gz.sig`) too.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    22
The signature can be verified using GPG_ or PGP_.
626
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    23
For example to check the signature of the archive :file:`vmm-0.6.1.tar.gz`
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    24
you can execute this command ``gpg --verify vmm-0.6.1.tar.gz.sig``.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    25
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    26
The tarball was signed by Pascal Volk (ID: CEC0904E).
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    27
You can fetch the public key from a key server using the command
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    28
``gpg --recv-keys 0xCEC0904E``.
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    29
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    30
Get vmm from the Mercurial repository
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    31
-------------------------------------
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    32
To get a tagged clone of the current vmm release from the Mercurial_
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    33
repository use:
626
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    34
``hg clone http://hg.localdomain.org/vmm/ -r vmm-0.6.1 vmm-0.6.1``.
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    35
This will put the files into the new created directory :file:`vmm-0.6.1`.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    36
626
f151defe7078 doc/web: Updated documentation for vmm-0.6.1.
Pascal Volk <user@localhost.localdomain.org>
parents: 579
diff changeset
    37
When you omit the ``-r vmm-0.6.1`` option, you will get the latest changes
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    38
from the `vmm repository`_. This code may work for you or not.
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    39
629
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    40
Get vmm from the Git repository
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    41
-------------------------------
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    42
The Debian project is hosting the `Git repository of vmm
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    43
<http://anonscm.debian.org/gitweb/?p=collab-maint/vmm.git>`_.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    44
The *upstream* branch is a mirror of the Mercurial *default* branch.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    45
The *master* branch is for Debian packaging.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    46
In order to clone the *upstream* branch use:
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    47
``git clone --branch upstream git://anonscm.debian.org/collab-maint/vmm.git``
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    48
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    49
Packages
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    50
--------
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    51
Debian
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    52
^^^^^^
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    53
Since Debian Wheezy vmm is also `available <http://packages.debian.org/vmm>`_
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    54
in the Debian package repository.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    55
The vmm package is `maintained <http://packages.qa.debian.org/v/vmm.html>`_
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    56
by Martin F. Krafft.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    57
Take a look at the file :file:`/usr/share/doc/vmm/README.Debian` for Debian
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    58
specific modifications.
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    59
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    60
.. include:: substitutions.rst
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    61
.. include:: ext_references.rst