service-dependencies.html

m4_include(/mcs/m4/worksp.lib.m4)
_NIMBUS_HEADER(2.5 Zero To Cloud Guide)
_NIMBUS_HEADER2(n,n,y,n,n,n,n)
_NIMBUS_LEFT2_COLUMN
_NIMBUS_LEFT2_Z2C_SIDEBAR(y)
_NIMBUS_LEFT2_COLUMN_END
_NIMBUS_CENTER2_COLUMN
_NIMBUS_2_5_DEPRECATED


<h2>Service Dependencies</h2>

<p>
    The Nimbus service node interacts with clients and manages backend hypervisor nodes. We strive to make it as simple
    as possible to install and configure, but there are a few system dependencies and requirements you will need.
</p>


<h3>Sun Java 1.5 or later</h3>
<p>
    The <tt class="literal">java</tt> and <tt class="literal">javac</tt> commands should be on your path. You can check your
    Java version with these commands:
</p>
<pre class="panel">
$ java -version
$ javac -version
</pre>

<p>
    Note that OpenJDK is not supported.
</p>

<h3>Python 2.5 or later (but not 3.x)</h3>
<p>
    You can check the version of your system Python with this command:
</p>
<pre class="panel">
$ python -V
</pre>

<p>
    Note that Nimbus does not support the Python 3 development branch at this time. The most recent compatible Python
    version is 2.7.
</p>
<p>
    If you cannot safely upgrade the system Python, you can use an alternate location such as
    <tt class="literal">/usr/local/bin/python2.5</tt>.
    You will have an opportunity to specify this alternate path during the service node install.
</p>
<p>
    Your Python must have support for <tt class="literal">sqlite 2</tt>, which is often installed separately, in a
    package called <tt class="literal">python-sqlite2</tt> (Redhat) or <tt class="literal">python-pysqlite2</tt>
    (Debian). The versioning is confusing for this package
    and the module we actually need is called <tt class="literal">sqlite3</tt>, so the best way to check for availability
    is with this command. if you don't get an error, you are in good shape.
</p>
<pre class="panel">
$ python -c "import sqlite3"
</pre>

<h3>GCC</h3>
<p>
    Cumulus is bundled with several other Python dependencies, some of which require building from source (C). This
    requires <tt class="literal">gcc</tt>. If you cannot install gcc, you can get around the requirement by directly
    installing these Python packages to your system: <tt class="literal">pyOpenSSL</tt> and
    <tt class="literal">Twisted 10.0.0</tt>.
</p>

<p>
    When going the GCC route you would also need the Python development 
    package (<tt class="literal">python-dev</tt> in Debian) and the OpenSSL
    development package (<tt class="literal">libssl-dev</tt> in Debian).
</p>

        
<h3>Apache Ant 1.6.2 or later</h3>
<p>
    You must also have the <tt class="literal">propertyfile</tt> task available which
    is usually installed separately from Ant itself. On Redhat-compatible systems this is often a package called
    <tt class="literal">ant-nodeps</tt>. On Debian/Ubuntu the package is <tt class="literal">ant-optional</tt>.
    To be sure, you can check for the presence of a library called <tt class="literal">ant-nodeps.jar</tt>
    in your Ant installation.
</p>


<p>
    If you have all of these dependencies, you can safely move on to the next section,
    <a href="service-setup.html">Service Installation</a>.
</p>




_NIMBUS_CENTER2_COLUMN_END
_NIMBUS_FOOTER1
_NIMBUS_FOOTER2
_NIMBUS_FOOTER3