These instructions show how to build BlackTie on a Solaris 10 platform. They may work with other SunOS releases but have only been validated on Solaris 10 update 8. The instructions are sufficiently different from the generic build instructions that a separate page is warranted.

Caveat: there are still some teething problems with running the tests and examples:- some of them fail intermittently and it currently takes multiple passes to get successful test run. You might want to track the issue via JIRA to see our progress.

Firstly, obtain a copy of Solaris 10 update 8 - I got my copy as a virtual appliance from the Oracle download center. Note that the standard VM does not come with enough disk space or swap space to run BlackTie so I'll include instructions as if you are building from such an appliance.

Add an extra disk using your virtualisation software, for example with VirtualBox use File->Virtual Media Manager to add an expandable disk of size 100 GB (that should be plenty though 10 - 20 may be enough too, but if the disk is expandable it will not matter). Boot Solaris and run format to see the device name of the new disk (format should report it as a VBOX disk of the size you chose, 100.00GB - the device name for my appliance is c0d1 because it is the second disk). Solaris comes with a nice tool for managing disks called zpool. Add the new disk to a new pool and give it a name such as data:

    zpool create data c0d1

By default a zfs filesystem is created on the new disk (the mount point defaults to the pool name).

Add more swap backed by space on the new disk. My virtual appliance came with 500 MB and a test build will definitely fail unless you add more. So, create a 1 GB swap mounted a /data/swap:

    zfs create -V 1gb data/swap

and ask the OS to use it for swapping:

    swap -a /dev/zvol/dks/data/swap

(if you want it to be permanent don't forget to add the entry to vfstab)

Solaris comes with a set of useful utilities located in /usr/sfw/bin so put this early on in your PATH. Also the standard tar and patch do not work with GNU tools, use gtar and gpatch instead (use alias if you keep forgetting: alias tar="gtar"). /usr/ccs/bin must be in you path as well. My PATH looks like this:

    PATH=$HOME/bin:$ANT_HOME/bin:$MAVEN_HOME/bin:/usr/sbin:/usr/sfw/bin:/usr/local/bin:/usr/ucb:/usr/ccs/bin

Much of the needed support software is not installed on Solaris so you'll need to get it from a third party such as sunfreeware.com which contains many pre-built SunOS packages for popular projects.

Important note - when using sunfreeware it is polite to use local mirrors.

I found it useful to install sudo (the sudoers file installs into /usr/local/etc):

 

# install sudo (as root)

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/sudo-1.7.4p4-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libintl-3.4.0-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libgcc-3.4.6-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libiconv-1.13.1-sol10-x86-local.gz

# install sudo (as root)

 

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/sudo-1.7.4p4-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libintl-3.4.0-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libgcc-3.4.6-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/libiconv-1.13.1-sol10-x86-local.gz

# also get build dependencies:

# gdbm, expat, Berkeley db (need for compilations)

# apr and aprutil

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/gdbm-1.8.3-sol10-intel-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/expat-2.0.1-sol10-x86-local.gz

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/db-4.4.20.NC-sol10-x86-local.gz

   wget http://www.mirrorservice.org/sites/ftp.apache.org/apr/apr-1.4.2.tar.gz

   wget http://www.mirrorservice.org/sites/ftp.apache.org/apr/apr-util-1.3.10.tar.gz

# ACE requires GNU make

   wget ftp://ftp.sunfreeware.com/pub/freeware/intel/10/make-3.82-sol10-x86-local.gz

# install all of the above packages:

   su

   gunzip *.gz

   for i in *local; do pkgadd -d $i; done

   echo "unixusername ALL=(ALL) ALL" >> /usr/local/etc/sudoers

# the APR install puts some of its includes in locations not recognised by log4cxx. As a quick fix I just copied them over:

   sudo cp /usr/local/apr/include/*.h /usr/local/apr/include/apr-1