Creating a simple zone

The following steps show how to create a simple sparse-branded zone on a freshly installed OmniOS r151026 server.

Create a dataset to hold the zones

Each zone ends up with its own ZFS dataset and it’s good practice to create a parent dataset under which the zones will live. Since this test server only has a root ZFS pool, we’ll create it under there but mount it at /zone.

root@omnios:~# zfs create -o mountpoint=/zone rpool/zone
root@omnios:~# df -h | grep zone
rpool/zone            7.27G    23K      6.77G     1%    /zone

Install the zone brand package

The ipkg and lipkg brands are installed by default, but others need to be installed before they can be used. For this example, we’ll use the sparse brand so let’s install it:

root@omnios:~# pkg list '*/brand/*'
NAME (PUBLISHER)                                  VERSION                    IFO
system/zones/brand/ipkg                           0.5.11-0.151026            i--
system/zones/brand/lipkg                          0.5.11-0.151026            i--

root@omnios:~# pkg install brand/sparse
           Packages to install:  1
       Create boot environment: No
Create backup boot environment: No

DOWNLOAD                                PKGS         FILES    XFER (MB)   SPEED
Completed                                1/1         14/14      0.0/0.0 33.2k/s

PHASE                                          ITEMS
Installing new actions                         26/26
Updating package state database                 Done
Updating package cache                           0/0
Updating image state                            Done
Creating fast lookup database                   Done
Reading search index                            Done
Updating search index                            1/1
Updating package cache                           1/1

Create a virtual NIC (VNIC) for the zone

root@omnios:~# dladm show-link
e1000g0     phys      1500   up       --         --

root@omnios:~# dladm create-vnic -l e1000g0 firstzone0

Create the zone

In this example, we’re creating a zone with the sparse brand. To create lipkg or ipkg brand zones, just substitute the desired brand for sparse. We’re also configuring an allowed address property on the network interface - this is optional but if set it will apply layer-3 protection to the VNIC so that the IP address cannot be changed from within the zone and will be automatically configured.

root@omnios:~# zonecfg -z firstzone
firstzone: No such zone configured
Use 'create' to begin configuring a new zone.
zonecfg:firstzone> create
zonecfg:firstzone> set brand=sparse
zonecfg:firstzone> set ip-type=exclusive
zonecfg:firstzone> set zonepath=/zone/firstzone
zonecfg:firstzone> add net
zonecfg:firstzone:net> set physical=firstzone0
zonecfg:firstzone:net> set allowed-address=
zonecfg:firstzone:net> set defrouter=
zonecfg:firstzone:net> end
zonecfg:firstzone> verify
zonecfg:firstzone> commit
zonecfg:firstzone> exit

Install the zone

root@omnios:~# zoneadm -z firstzone install
A ZFS file system has been created for this zone.

       Image: Preparing at /zone/firstzone/root.
Sanity Check: Looking for 'entire' incorporation.
   Publisher: Using omnios (
       Cache: Using /var/pkg/publisher.
  Installing: Packages (output follows)
Packages to install: 186
Mediators to change:   2
 Services to change:   5

DOWNLOAD                                PKGS         FILES    XFER (MB)   SPEED
Completed                            186/186     1448/1448      4.8/4.8  212k/s

PHASE                                          ITEMS
Installing new actions                     5497/5497
Updating package state database                 Done
Updating package cache                           0/0
Updating image state                            Done
Creating fast lookup database                   Done
 Postinstall: Copying SMF seed repository ... done.
        Done: Installation completed in 68.616 seconds.

Boot the zone

root@omnios:~# zoneadm -z firstzone boot

Log in

root@omnios:~# zlogin firstzone
[Connected to zone 'firstzone' pts/2]
OmniOS 5.11     omnios-r151026-b6848f4455       June 2018
root@firstzone:~# ipadm show-addr
ADDROBJ           TYPE     STATE        ADDR
lo0/v4            static   ok 
firstzone0/_a     from-gz  ok 
lo0/v6            static   ok           ::1/128

Configure DNS

root@omnios:~# cp /etc/nsswitch.{dns,conf}
root@omnios:~# echo nameserver > /etc/resolv.conf