INSTALL

Requirements:

* Python 2.7 or later (Python 3 not supported yet)

* Python Dateutil (http://labix.org/python-dateutil)

* Twisted 12.2.0 or later, http://twistedmatrix.com/trac/

* Psycopg 2.5.0 or later (http://initd.org/psycopg/, 2.4.6 _might_ work)

* Twistar 1.1 or later (https://pypi.python.org/pypi/twistar/ & http://findingscience.com/twistar/ )

* PostgreSQL (just needs a database)

* pyOpenSSL 0.14 (when running with SSL/TLS)

Python and Twisted should be included in the package system in most recent
Linux distributions.

Furthermore, for SSH based backends (Brocade, Force10, and Juniper), the
packages pyasn1 and python-crypto are also required.

If you use a backend which uses SSH (JunOS, Force10), there is a patch to
remove some of the log statements in the Twisted SSH module, which is rather
noisy. This makes the log a lot easier to read.


Installation:

python setup.py build
sudo python setup.py install


Database setup:

You need to have a postgresql database setup and the user should have access to
it (if you use OS access - which is the easiest - you can put whatever in the
password field, it isn't used). Usually like this: 

$ su - postgres
$ createdb opennsa
$ createuser opennsa
$ exit
$ psql opennsa # as the user that runs opennsa
$ \i datafiles/schemq.sql


Configuration:

Edit /etc/opennsa.conf. Configuring the service is relatively straightforward,
but creating the topology specification is still somewhat tricky. Look at the
.nrm file in opennsa distribution for an example.


Command line tool:

Make a reservation:
onsa reserve -u http://localhost:9080/NSI/services/ConnectionService -p OpenNSA-TestClient -r Aruba -s Aruba:A1 -d Aruba:A4

Do a ./onsa --help for more information.


Development

To start a test service:

twistd -noy opennsa.tac

Note that opennsa.conf must exists in the source directory for this to work.