Copyright (C) 1998-2024 OpenLink Software [email protected]
This document describes how to checkout a copy of the git tree for development purposes on Mac OS X.
It also lists the packages that need to be installed prior to generating the necessary scripts and Makefiles to build the project.
If you have any questions, please email us at mailto:[email protected].
OpenLink Software frequently pushes updates to the Virtuoso Open Source tree on GitHub.
Developers who just want to build Virtuoso on their own machine can make a local clone of the source tree using the following command:
$ git clone git://github.com/openlink/virtuoso-opensource.git
At this point you can create your own work branch based on any of the branches available, create bugfixes and commit them to your own branch and then use the 'git format-patch' command to generate the appropriate diffs to send to mailto:[email protected].
OpenLink Software encourages developers to create their own account on GitHub, after which they can fork the project by going to the following URL with any web browser and pressing the Fork button:
https://github.com/openlink/virtuoso-opensource
At this point you can clone your fork to your local Mac OS X system, create your own branches to make enhancements/bugfixes, push these branches back to GitHub and then send pull requests using the excellent GitHub interface for the OpenLink team to examine and incorporate the fixes into the master tree for an upcoming release.
Github has excellent documentation on how to fork a project, send pull requests, track the project etc. on:
http://help.github.com/
Developers who do not want to mess with git can also download a source tar archive from:
https://github.com/openlink/virtuoso-opensource/archive/develop/7.x.tar.gz
This tar archive can be extracted using the following command:
$ tar xvfz virtuoso-opensource-development-7.tar.gz
Configuration and building is exactly the same as for the cloned git tree.
Apple removed a number of programs from their Xcode.app command line installation including the autoconf, automake, libtool, gperf and some other tools needed to build Virtuoso from a newly checked out git tree.
OpenLink Software suggest using the HomeBrew package manager from http://brew.sh/ to install these tools.
After the installation of HomeBrew you need to install the following package:
$ brew install autoconf automake libtool
$ brew install gperf bison flex git gawk pkg-config
By default brew installs all packages and libraries into subdirectories under the /usr/local directory.
Comparable packages can also be installed via MacPorts which installs into /opt/local directory.
Optional features like command line editing in the isql tool require:
$ brew install libedit
or
$ brew install readline
As Apple is actively deprecating OpenSSL from Mac OS X, your system either has a pretty old version of openssl, and in case of High Sierra (10.13) Apple removed the required include files from the /usr/include/openssl directory completely.
We recommend installing the OpenSSL 1.0.2 library using:
$ brew install openssl
And at configure time you can use the following:
$ sh ./configure \
..... \
..... \
--enable-openssl=/usr/local/opt/openssl/
The ImageMagick plugin requires the following packages to be installed:
$ brew install pkg-config
$ brew install imagemagick@6
This installs ImageMagick 6.x together with a number of libraries to work with specific graphic formats.
At configure time you can use the following line:
$ sh ./configure \
..... \
--enable-imagemagick=/usr/local/opt/imagemagick\@6/
First we set some environment variables:
$ export CFLAGS="-O -arch x86_64"
$ export LDFLAGS="-g"
$ export CC="clang"
Note: On macOS 11 (Big Sur) and later we can set the CFLAGS to make a universal binary that runs on both Intel and Apple Silicon platforms:
$ export CFLAGS="-O -arch arm64 -arch x86_64"
Next we (re)generate the configure script and all related build files, using the supplied script in your working directory:
$ sh ./autogen.sh
Assuming this did not return an error we can now configure Virtuoso.
For a full list of available configure options, including various optional subpackages, check the output of:
$ sh ./configure --help
The following command includes a number of options we recommend for an initial build of Virtuoso on Mac OS X:
$ sh ./configure \
--enable-maintainer-mode \
--enable-silent-rules \
--prefix=/usr/local/vos \
--with-layout=openlink \
--enable-openssl=/usr/local/opt/openssl/ \
--enable-imagemagick=/usr/local/opt/imagemagick@6/ \
--enable-openldap \
--disable-python \
--with-editline \
--with-jdk4=/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0 \
--with-jdk4_1=/Library/Java/JavaVirtualMachines/jdk1.7.0_71.jdk/Contents/Home/ \
--with-jdk4_2=/Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/
If the above steps return without error you should now be able to build the archive using the following commands:
$ make
After building you can run the testsuite to verify your binaries are in working order:
$ make check
And finally to install the resulting binaries into the /usr/local/vos directory:
$ make install
The build produces a demo database and Virtuoso application packages that are quite large.
At least 1.1GB of free space should be available on the build file system.
Running the testsuite requires an additional 2.8GB of free space on the system.
An installation containing the virtuoso server executable and supporting binaries, all the hosting plugins, VAD packages, config files etc excluding the database will take around 350MB of disk space.
Please read the files INSTALL and README in this directory for further information on how to configure the package and install it on your system.