====== Technical Topic:  oi-userland ======

=== Install from ISO ===
  * As of 2015-03-30, use hipster ISO for userland building
  * Once logged in, use nwam applet to disable NICs for zones ===
    * Create a profile named "Zones"
    * Add only global zone NIC in the "Activate every time" section
  * Shutdown and remove virtual installation ISO
  * Boot up and install Solaris guest additions
  * Shutdown and remove virtual guest-additions ISO
  * Boot into new system, ready to proceed

=== Make basic preference/environment changes, as desired ===
  * Entries in /etc/hosts
  * Desktop preference changes
  * Shell initialization and ~/.* files

=== Change package repository settings (only if switching from non-hipster): ===
  * ''pkg unset-publisher openindiana.org''
  * ''pkg set-publisher -p %%http://pkg.openindiana.org/hipster-2015%%''
  * ''pkg install -v package/pkg''
  * ''pkg update -v''

=== Set up zone for building ===
See [[:tech:openindiana:start|OpenIndiana]] for zone basics

=== Take a snapshot of the zone ===
  * ''zlogin oibld init 5''
  * ''cp -pf /etc/zones/oibld.xml /zones/oidev/oibld''
  * ''zfs snapshot -r zonepool/zones/oidev/oibld@snapshotname''
  * ''zoneadm -z oibld boot''

// **Following guide at http://wiki.openindiana.org/oi/Building+with+oi-userland ...** //

=== Ensure up-to-date with pre-requisites ===
  * Update zone // (if installed from hipster ISO) // : ''pkg update -v''
  * Install prerequisite packages in the zone: ''pkg install build-essential''

=== Set up build environment for use ===
  * Create a fork of OpenIndiana/oi-userland in your own github account space
  * Clone your fork and set up for use<code>git clone https://www.github.com/yourlogin/oi-userland
cd $HOME/oi-userland ; gmake setup ; gmake check-environment</code>
  * Set your local repo as publisher:<code>pkg set-publisher -p file://$HOME/oi-userland/i386/repo
pkg set-publisher -P userland</code>
  * Run a local package server for other zones or hosts:<code>/usr/lib/pkg.depotd -d $HOME/oi-userland/i386/repo -p 10000</code>

 \\
// Links: [[:tech:start|Tech Info]] ... [[:tech:openindiana:start|OpenIndiana]] ... [[:mantis:start|Mantis Area]] //