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).
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.
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.