doc/web/source/download.rst
author Pascal Volk <user@localhost.localdomain.org>
Sat, 01 Feb 2014 18:18:06 +0000
changeset 706 6c369b680ab0
parent 629 8009e87c7a20
permissions -rw-r--r--
doc/web: Updated documentation for vmm-0.6.2.
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
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    13
extract the downloaded archive use ``tar xzf vmm-0.6.2.tar.gz``. This will
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    14
create the new directory :file:`vmm-0.6.2` 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
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    21
corresponding signature file (:file:`vmm-0.6.2.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_.
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    23
For example to check the signature of the archive :file:`vmm-0.6.2.tar.gz`
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    24
you can execute this command ``gpg --verify vmm-0.6.2.tar.gz.sig``.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    25
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    26
The tarball was signed by Pascal Volk (ID 0xC51139FE).
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    27
Older releases (≦ 0.6.1) were signed with key ID 0xCEC0904E).
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    28
You can fetch the public key from a key server using the command
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    29
``gpg --recv-keys 0xC51139FE``.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    30
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    31
Get vmm from the Mercurial repository
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    32
-------------------------------------
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    33
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
    34
repository use:
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    35
``hg clone http://hg.localdomain.org/vmm/ -r vmm-0.6.2 vmm-0.6.2``.
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    36
This will put the files into the new created directory :file:`vmm-0.6.2`.
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    37
706
6c369b680ab0 doc/web: Updated documentation for vmm-0.6.2.
Pascal Volk <user@localhost.localdomain.org>
parents: 629
diff changeset
    38
When you omit the ``-r vmm-0.6.2`` 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
    39
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
    40
629
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    41
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
    42
-------------------------------
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    43
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
    44
<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
    45
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
    46
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
    47
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
    48
``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
    49
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    50
Packages
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    51
--------
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    52
Debian
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    53
^^^^^^
8009e87c7a20 doc/web: Added links to the Debian package and the git repos.
Pascal Volk <user@localhost.localdomain.org>
parents: 626
diff changeset
    54
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
    55
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
    56
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
    57
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
    58
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
    59
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
    60
579
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    61
.. include:: substitutions.rst
be0906181a10 doc: Added source of http://vmm.localdomain.org/.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    62
.. include:: ext_references.rst