Installing Agnos

Compiler

The agnos_compiler is a python package, so obviously you will need to have python installed. If you’re running on Windows, you can next-next-next your way with executable installer; otherwise, install it like any other python package: either use easy_install agnos_compiler or do it manually, by extracting compressed package and running

$ python setup.py install       # you might need to sudo that command

For more info, refer to Installing Python Modules

Dependencies:

• python 2.6 and up or 3.0 and up.

---

Library

libagnos is provided as a set of independent libraries, for each target language. If you wish to write a client in language X and a server in language Y, you’ll need to install libagnos for both X and Y.

---

C++

The C++ implementation of the protocol is provided as in a source-only distribution (not precompiled), becuase C++ has no standard ABI.

You can either compile the code into a library (which depends on your compiler), or add it to your project directly. Don’t forget to set the include path so that #include <agnos.hpp> works.

Note

In order to produce an executable, you will need to link with boost_thread, boost_date_time, boost_iostreams and boost_system

Dependencies::

• A modern C++ toolchain, compatible with Boost (g++, VisualStudio 2003 and up, etc.)
• The Boost library, version 1.40 and up.
  • Windows users: you can download compiled versions of Boost
• Optionally: Boost::Process. This nice library allows executing child processes in a cross-platform manner. Sadly, though, it is not yet officially included in Boost, so you have to install it separately.
  • It’s a header-only library. Simply download the zip and extract it to where your Boost include directory is (e.g., /usr/include/boost).
  • You can specify in build-time whether this library is supported by defining BOOST_PROCESS_SUPPORTED (or not defining it)
• Optionally: The scons build system; libagnos-cpp uses scons to build itself; of course you can use whatever build system you like.

---

C#

The recommended way is to download the latest Agnos.dll, and either install it into the GAC or explicitly reference it in your project. Alternatively, you can download the source and build it on your own.

Dependencies:

• .NET Framework 3.0 and up or mono 2.6 and up.

---

java

The recommended way is to download the latest agnos.jar, and either put it in your JAVAPATH, or explicitly reference it in your project. Alternatively, you can download the source and build it on your own.

Dependencies:

• JDK 1.5 (also known as “Java 5”) and up
• Optionally: The scons build system; libagnos-java uses scons to build itself; of course you can use whatever build system you like.

---

python

libagnos-python is a normal python package, which is accessed as import agnos. You can easy_install libagnos; install it like any other python package (by extracting the package and running python setup.py install), and if you’re running on Windows, you can next-next-next your way through the GUI installer.

For more info, refer to Installing Python Modules

Dependencies:

• python 2.6 or 3.0 and up.