Setup GAR on your own build machine

To get started you first need to equip your machine with pkgutil from OpenCSW and use it to install a set of base packages that are required for GAR.

pkgutil -y -i gar_dev

Oracle Solaris Studio Compiler

You need a compiler. Most of the packages use Oracle Solaris Studio (historically called 'SOS'), which you can download from Oracle. You want to go with the packaged (non-tar) version. In case you have access to an Oracle Solaris development tools support contract, please make sure to also install the latest Oracle Solaris Studio compiler patches. The compilers should be installed at the following locations:

/opt/studio/SOS<version>

You can install multiple versions of SOS on one system. If you have your compiler installed at a different location you can set it in your ~/.garrc with the following lines:

SOS11_CC_HOME = /opt/SUNWspro
SOS12_CC_HOME = /opt/studio12/SUNWspro

Installing Oracle Solaris Studio 12

1. cd ss12
2. ./batch_installer -d /opt/studio/SOS12 --accept-sla

Remember to patch the compilers, with PCA or manually.

GNU C/C++ Compiler

Some packages require the GNU C compiler in version 3 or 4. The easiest way is to install the CSW packages:

pkgutil -y -i gcc3core gcc3g++
pkgutil -y -i gcc4core gcc4g++

Setup ~/.garrc

Finally, you need to create your personal ~/.garrc configuration file. It contains your name and e-mail adress, both of which are included in the metadata of built packages. Further, GAR needs to know where to put these packages.

Here's an example:

SPKG_PACKAGER   = Dagobert Michelsen
SPKG_EMAIL      = dam@opencsw.org
SPKG_EXPORT     = /home/dam/pkgs

In case you are sitting behind a proxy, you would also want to configure this in ~/.garrc.

http_proxy = http://proxy[:port]

You can customize several other things in ~/.garrc which we'll see later. Do not customize anything which makes the build dependant on your ~/.garrc-settings! This includes changing compilers flags, PATH, etc. This is equally true for gar.conf.mk - please don't modify it! If you feel it needs change please subscribe to the users@ mailing list and discuss your change there.

Install The GAR System

Next you need to install the GAR system itself. There are two different ways to get the files installed depending on your need:

• GAR Package: If you want to peek at how GAR works without a steep learning curve
• GAR Subversion Repository: If you are a CSW maintainer and want to contribute package descriptions. However, a more automated setup can be achieved with mgar http://wiki.opencsw.org/gar-wrapper.