Installing VADM 
===================================================

.. contents::
    :local:
    :depth: 2


Installing VADM 
-----------------

**vadm** depends on the `py lib`_ which provides programmatic access to subversion
by using the 'svn' command line tool.  The **vadm** scripts also will make use 
of the **sudo** command which usually is available on Unix and OSX systems. 

.. _`py lib`: http://pylib.org 

with easy_install 
+++++++++++++++++++

1. `Install easy_install`_ if you don't have it.  On linux distributions the package name you should look for is "setuptools" or "python-setuptools". 
2. type ``easy_install vadm`` (this also installs the py lib dependency).

.. _`Install easy_install`: http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install

manually with setup.py                                                         
++++++++++++++++++++++++

.. _`install the py lib without setuptools`: http://pylib.org/download.html#no-setuptools

1. `install the py lib without setuptools`_. 

2. download the `vadm tarball`_  and install it like this (substitute
   the version number as appropriate)::

     tar zxvf vadm-X.Y.Z.tar.gz
     cd vadm-X.Y.Z
     python setup.py install 

working from development 
++++++++++++++++++++++++++++

If you want to follow the development version you can type 
something like this::

     svn co https://codespeak.net/svn/vadm/dist/vadm 

and add the ``vadm/bin/`` directory to your ``$PATH`` variable. 
The **vadm** script will automatically use the development version. 


.. _`vadm tarball`: http://pypi.python.org/packages/source/v/vadm/vadm-0.6.0-beta5.tar.gz