
ARIA Installation Instructions
===============================
Version 2.7.1

Don't forget to sign up for the Aria-Users mailing list by sending a message 
with the subject 'subscribe' to aria-users-request@mobilerobots.com.

ARIA software development is supported on Windows 2000 using MS Visual 
C++ .NET 2003 (Version 7) and Visual C++ 2008 (Version 9), and on 
GNU/Linux using GNU development tools (make, GCC).

See README.txt for more information.


Windows:
--------

Run Aria-2.7.1.exe to invoke the setup program, then simply
follow the prompts.  All ARIA software will be installed in 
C:\Program Files\MobileRobots\Aria.  Shortcuts will be installed
in the Start menu to documentation, examples, and the Aria directory.

The kit includes the Aria library and two pre-built examples
that you can run from the bin directory. To see more examples, 
open Microsoft Visual Studio and load the example projects
(examples\All_Examples.sln).

In order to compile ARIA and the examples, you should use Microsoft 
Visual C++ .NET 2003 or Visual C++ Express 2008.  Use the "-vc2003.sln"
solution files if using VC 2003, and use the "-vc2008.sln" files
if using VC 2008.

We have discontinued support Visual C++ 6.0.  We only support Visual
C++ .net 2003 now.  We switched to Visual C++ .net since it was no
longer possible to obtain Visual C++ 6.0 and we are now discontinuing
support for Visual C++ 6.0.  The libraries compiled between the two
versions in our experience do not work either forwardly compatible or
backwardly compatible.  If you really want to use Visual C++ 6.0 the 
old files are in the vc++6 directory, see the README.txt in that directory, 
note that these files are unsupported.


GNU/Linux:
----------

To use the precompiled Aria library under Linux, you will need GCC 3.4 
(with the C++ compiler, g++) and Make.  The ARIA libraries and examples 
come built with GCC 3.4.  If you would like to rebuild them with a 
different compiler or version, run "make clean; make" from the top 
level /usr/local/Aria directory.  You can also set environment 
variables to affect compilation with make, such as CXX and CXXFLAGS. 
For example, if you want to use the command "g++-3.4" to compile, set
CXX to g++-3.4 and export the variable. See README.txt for more discussion
of this.

The ARIA and ArNetworking libraries and some pre-built examples are included.
You can run these examples and find more examples in the examples 
directory.  All ARIA software is placed in /usr/local/Aria.  In addition, 
the file /etc/Aria will be created with the ARIA installation location, 
and /etc/ld.so.conf may be updated to include /usr/local/Aria/lib. 



To install on RedHat:
---------------------

For RedHat, the ARIA and ArNetworking libraries are provided by the
"ARIA" RPM package, which provides libAria, libArNetworking, all 
documentation, source code, example programs, and Java and Python
wrapper libraries.

To install the ARIA RPM package, log in as the 'root' user, or use the
'su' command to become root. Then install with 'rpm':
   rpm -i ARIA-2.7.1-0.i386.rpm

Aria will be installed in /usr/local/Aria.

To upgrade an existing ARIA install use 'rpm -U' instead of 'rpm -i'.  
To remove  the currently installed Aria package, use:
   rpm -e ARIA
   
See the documentation for 'rpm' for more options:
   man rpm


To install on Debian:
---------------------

ARIA libraries are provided by the following Debian packages: libaria, 
libaria-python, libaria-java.  libaria provides libArNetworking as well 
as libAria, and all documentation, source code, and example programs.
libaria-python and libaria-java provide the Python and Java wrapper 
libraries respectively.

To install a .deb package file downloaded from the website, use dpkg:
   dpkg -i libaria_2.7.1_i386.deb

Aria will be installed in /usr/local/Aria.

You may also need to install dependencies using aptitude, synaptic, or 
apt-get.

To uninstall the ARIA libraries, use 'apt-get remove libaria'. Any
packages that depend on libaria will also be removed.


To install on other GNU/Linux systems:
--------------------------------------

Many Linux systems use either the RPM or DEB packaging formats, or
a tool such as "alien" can be used to convert.  Alternatively, you
may download the source code as a compressed 'tar' archive and 
compile Aria yourself (See README.txt for notes about compiling 
the source).

Unpack the .tar.gz archive:
   tar xzvf ARIA-2.7.1.tgz

Enter the new directory, and use make to build ARIA:
   cd Aria-2.7.1
   make

To install Aria, become the root user and use make again:
   su
   ...
   make install

Aria will be installed in /usr/local/Aria.   The dynamic (shared) 
libraries are in /usr/local/Aria/lib and the header files are in
/usr/local/Aria/include and /usr/local/Aria/ArNetworking/include.

Next, you will then need to tell the dynamic linker where to find the ARIA 
libraries: either add "/usr/local/Aria/lib" to /etc/ld.so.conf for 
permanent effect, or add it to the LD_LIBRARY_PATH environment variable 
for temporary effect.

All future development should use the installed Aria, not the source
you unpacked, so that directory may be removed.

The ARIA libraries depend require only the following standard Linux 
system libraries: libpthread, libdl 2, librt 1, libm 6, libc 6, libstdc++ 6.
So on most current systems you should not need to install anything 
extra to use ARIA.

------------ 
MobileRobots Inc
support@mobilerobots.com
http://www.mobilerobots.com
http://robots.mobilerobots.com

