Skip to main content
Last updated March 12, 2013 01:17, by Alan Coopersmith
Feedicon  

Building the X gate

These instructions cover the current pre-release development gates for Solaris 11.x updates and Solaris 12. For building the older XNV gate for OpenSolaris or Solaris 11 Express, see the Build Instructions - XNV page instead.


Downloads

To get the X gate, clone the Mercurial repostory by running:

 hg clone https://hg.java.net/hg/solaris-x11~x-s12-clone 

or

 hg clone https://hg.java.net/hg/solaris-x11~x-s11-update-clone 


After cloning the X gate repository, you will need to download the original open source packages they modify.

The sources include a script named download-tarballs that you can run to do this. It assumes running /usr/bin/wget can connect to Internet websites. If you need to set it to use web proxies, run "man wget" for instructions.

To download all needed sources:

 ./download-tarballs

To delete all current tarballs and re-download all needed sources:

 ./download-tarballs -c

(c for “clobber”)

To see what it will do without connecting to any sites:

 ./download-tarballs -n




Build requirements & preparation

  • Current/target release of Solaris 11.x/12
  • Studio 12 Update 1
  • GNU autotools, gettext, and make

The recommended source for most the GNU tools needed to build the X consolidation are the packages included in the Solaris Userland consolidation, installed from the Solaris IPS repository. The easiest way to install all the needed tools is to install the dependency group package developer/opensolaris/X.



Building the software

To build the software, simply cd into the top level directory and run

 ./buildit

To build the software and create packages, add the -p flag to buildit:

 ./buildit -p

Output of various stages is stored into log files which you can check for errors with the included open-src/util/build-tools/find-build-errors script:

build files under log/ directory in build tree
Software build buildit-XW, check-rtime
IPS packaging make-pkgs, check-pkgs

The built binaries are found after the build in a proto area:

SPARC proto/root_sparc/
x86/x64 proto/root_i386/


Installing IPS packages

The built packages will be found in a repository in the directory proto/pkg_sparc or proto/pkg_i386 as appropriate.

Builds made by individual developers default to using the publisher name xnv-devel but that can be overridden via flags to the buildit or make_release_packages scripts. They will depend on the versions of packages from other consolidations that were installed on the system they built them on.

The recommended mechanism for installing any of these builds is the onu tool provided by ON. You can install the pkg:/developer/build/onbld package to get a local copy installed as /opt/onbld/bin/onu .

onu will create a new boot environment and install the packages there - you will then need to reboot into that BE to use them. Since none of the X packages have the reboot required flag, it is possible to use pkg to directly install them to the live BE, but then you have more work to do if you need to switch back to the previous versions.

Note that onu uses pkg image-update, which means there are two important things to remember:

  1. It will upgrade all of your packages and not just the X packages.
  2. It will normally only upgrade the X packages you already have installed on the system, though it will leave the BE mounted so that you can add other packages via pkg -R /tmp/onu.* install package-name. To install all the packages provided by the X consolidation for the build in your BE, you can install the group package pkg:/consolidation/X/X-all.

Example: Install to a new BE named "X14" that is cloned from the current BE:

 # onu -O -u file://`pwd`/proto/pkgs_i386 -U xnv-devel -t X14
 
 
Close
loading
Please Confirm
Close