Skip to end of metadata
Go to start of metadata
If anything on this page looks "too old" to you, check the "last edited" date above and be reassured that this page is still accurate and should still be followed exactly.

Host Version

SmartOS is self hosting. Make sure you are running the latest release of SmartOS to do your builds. If you're on a build from before the fake subset was killed – April 2013, there is a high likelihood the build will fail. Please update your platform.

Zone creation

SmartOS is built in a zone. Use the smartos multiarch 13.3.0 zone image (UUID a1d74530-4212-11e3-8a71-a7247697c8f2)
Do not use any other zone image.

Import the zone image:

Your zone will need sufficient memory, space, space in tmpfs, and access to the ufs, pcfs, and tmpfs drivers. Below are some settings to make sure to include in your zone's json specification (make sure to set up a NIC as well... see How to create a zone ( OS virtualized machine ) in SmartOS for further details):

Use vmadm to create your zone, then you can use zlogin to log in.

Getting the source trees

SmartOS requires the illumos kernel source tree and a couple more repositories (kvm, ...) as well as various compilation tools to build. The following steps download the various source trees and binaries required for the build:

If any git clone operation launched by configure hangs, it can be interrupted with Ctrl-C and configure can be restarted (it will pick up at the last unfinished step). After configure finishes successfully, the build zone is ready for the build. One can make a snapshot of the build zone at this point and rollback later if the build fails for any reason.

Building SmartOS

Building on an "underpowered" system
If your system doesn't actually have a lot of RAM or CPU, the following tweak may prevent resource exhaustion from interrupting your build:

You are now ready to build.

Good luck! Build times for SmartOS on various hardware configurations should be similar to the build times for the illumos kernel itself which can be found in the illumos wiki, plus of course the time required to build the SmartOS-specific parts.

Packaging SmartOS

Before you can distribute your new SmartOS build, you need to install a couple of packages.

With those packages installed, you can now use the scripts in smartos-live/tools to build an iso or usb image.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Oct 10, 2012

    Doesn't seem to want to build like this with the latest bits... issue created in smartos-live.

    BTW, since a while the WIKI behaves quite strangely.. the "code panels" blank out and back in [sometimes] while scrolling, extremely annoying.

    [updated 10/10/2012]

    the resources mentioned 'sufficient memory, space, space in tmpfs' are unforgiveable and lack of resources will fail in bizarre ways....  add swap if need be(via the global zone).  Only smartos:1.6.3 will work, apparently not the latest base.

    1. Oct 10, 2012

      It should be noted that this document is pretty explicit about which datasets to use and what resource controls to set.  If you deviate from anything on this page, then yes, it may well not work.