Building and testing ON

Building and testing ON on the OpenSolaris Distribution

 ON developers can build and test almost all of their source changes on OpenSolaris today. A number of enhancements are being made over the coming months to make the process simpler and closer to testing the customer experience, but all ON development tasks except for old install and upgrade testing are easy to do on an OpenSolaris system today. Please raise questions or comments about these procedures in the ON community through on-discuss@opensolaris.org.

Building ON on OpenSolaris

 It is easy to build ON on OpenSolaris by adding a few extra packages to the default install.

• Set your primary authority to the development repository, and upgrade to the latest OpenSolaris development bits.

user@opensolaris:~$ pfexec pkg set-authority \
  -O http://pkg.opensolaris.org/dev opensolaris.org
user@opensolaris:~$ pfexec pkg image-update

• Make sure you've got access to the pkg.sun.com extras repository. If you haven't already registered for goodies like flash, start at https://pkg.sun.com/register/ and follow the instructions to add the extras repository there.
   Instructions on using an already granted key are under the Help link at the top of the page.
   If you're a Sun employee, your "Sun Online" login is first.last@sun.com and your LDAP password.

• If you've image-updated to the latest development bits, you now have at least build 128. Install the required packages for ON development.

user@opensolaris:~$ pfexec pkg install developer/opensolaris/osnet

• If you haven't upgraded to the latest development bits, you may see an error that the constraints for osnet are unsatisfied. The best way to deal with this is to upgrade to the latest development bits, then install osnet. If that is impossible, you can explicitly select to install the version of osnet that matches your OS version. e.g. if you're on build 124:

user@opensolaris:~$ pfexec pkg install osnet@0.5.11,5.11-0.124

• If you're not a Sun employee with standard NIS maps, install the appropriate compiler tarball available at http://opensolaris.org/os/community/tools/sun_studio_tools/.

For more questions about the actual ON build process, see the ON developer reference.

Testing ON on OpenSolaris

 BFU (and Install) are operational on OpenSolaris systems. Eventually, ON developers will be able to simply pkg image-update their bits, but in the meantime BFU can be used in the usual way. An example to get started:

# beadm create bfu
# beadm mount bfu /mnt
# /opt/onbld/bin/bfu <archive> /mnt
# acr /mnt

 Then reboot to your 'bfu' menu entry.

 Alternatively, you can try out the ON IPS project which is an early access version of the changes that will be integrated into ON to natively build an IPS repository from the ON bits. Start reading the instructions and signing up for the alias mentioned in the project's README.src