Installation

Installing the Source Distribution

The Zorba source is available as tar.gz and zip files. The Zorba sources can be installed by extracting the compressed files (e.g., tar xvfz zorba-version.tar.gz). This creates a zorba-version directory in your current working directory.

To build Zorba, please follow the build instructions (see Building Zorba).

Installing

Once you have successfully built Zorba using the "Unix Makefile" generator (see Installing the Source Distribution), you can execute make install from within the build directory to install Zorba. This will install Zorba into the path specified by the CMAKE_INSTALL_PREFIX variable.

Note that for setting the install prefix, you can use the CMAKE_INSTALL_PREFIX variable. For example, in order to install Zorba in /opt use cmake -D CMAKE_INSTALL_PREFIX=/opt zorba source directory. (Note that while CMake-generated Makefiles support the DESTDIR variable, this will NOT work with Zorba as certain installation paths are hard-coded in the binary files.)

There is also a make uninstall command available (also to be called from the build directory).

Alternatively, you can use one of Zorba's binary distributions if it is available for your platform. For example, download and decompress the tar-ball for Mac OS X (e.g., zorba-version-Darwin-i386.tar.gz).

For both installations, you will need to add Zorba's bin directory (e.g., CMAKE_INSTALL_PREFIX/bin or zorba-0.9.2541-Darwin-i386/bin) to your PATH environment variable.

Additionally, you will need to add the corresponding library search path (e.g., LD_LIBRARY_PATH on Linux, DYLD_LIBRARY_PATH on Mac, and PATH on Windows) to point to the lib directory (e.g., CMAKE_INSTALL_PREFIX/lib or zorba-version-Darwin-i386/lib). Also, please make sure that the directories of the required libraries (see Zorba Build Instructions) are present in your library search path.

After that, try typing zorba -q "1+1" and you should see

<?xml version="1.0" encoding="UTF-8"?>
2

as a result. Congratulations -- you're done and ready to use Zorba. Otherwise, please consult the zorba-users mailing list for help.

For programming against the Zorba library, we refer to the API examples provided with the source and binary distribution (see simple.cpp for an example).

In order to make the installation process easier, we also provide graphical installers for Windows and Mac OS X.

Additional notes for Ubuntu systems installations

The recommended way of installing the Zorba library on an Ubuntu system is to add the lib directory as a .conf file in /etc/ld.so.conf and then run sudo ldconfig. For a personal (non-root non-system wide) installation, employing LD_LIBRARY_PATH is the only valid approach, but it needs to be done in the shell's .rc file not in the .profile file. Additional information can be found here: LD_LIBRARY_PATH not loading from .profile nor /etc/environment.

blog comments powered by Disqus