Getting Started with OmniOS
A note on privilege escalation
OmniOS ships with two different methods for privilege escalation.
pfexec is the Solaris/OmniOS/illumos
standard which uses profiles to specify privileges, however
sudo is also
included and supported.
If you created a user through the post-installation menu you
will have been asked if you wish to assign the Primary Administrator role
to that user. That’s a user profile effectively enabling root access for
the user via
The examples on the rest of this page use
pfexec - if you configured
sudo, then that can be used instead.
Update all packages
The first thing that you should do with a fresh installation of OmniOS is to
make sure that all packages are up-to-date. Packages in OmniOS are managed
pkg command-line utility.
First make sure the list of available packages is up-to-date:
$ pfexec pkg refresh Refreshing catalog 1/1 omnios
and show the available updates (no privileges required):
$ pkg list -u NAME (PUBLISHER) VERSION IFO archiver/gnu-tar 1.29-0.151024 i-- ...
and to apply all updates, simply:
$ pfexec pkg update
If any of the updates require a reboot, then a new boot environment will be created and this will be shown in the output.
A clone of omnios exists and has been updated and activated. On the next boot the Boot Environment omnios-1 will be mounted on '/'. Reboot when ready to switch to this updated BE.
$ pfexec init 6 ... or ... $ pfexec shutdown -i 6
Do not be tempted to use
reboot nowas this will result in the boot loader trying to load a kernel named now, failing and dropping to its forth interpreter with an
okprompt. If you do this, recovery is possible via the following two commands:
ok set bootfile=platform/i86pc/kernel/amd64/unix ok boot
Development Environment Setup
If you wish to compile software, you will need to install a compiler and supporting utilities. To see the list of available compilers, query the package system as follows:
If you’re interested in building illumos or OmniOS, refer to the Building OmniOS page.
$ pkg list -a 'developer/gcc?' NAME (PUBLISHER) VERSION IFO developer/gcc5 5.5.0-0.151024 --- developer/gcc6 6.4.0-0.151024 ---
and then install the desired version along with the
$ pfexec pkg install developer/gcc6 system/header
This will give you enough to build simple software but you may also want to install the following packages to provide additional utilities.
$ pfexec pkg install \ developer/build/autoconf \ developer/build/automake \ developer/build/gnu-make \ developer/build/make \ developer/lexer/flex \ developer/object-file \ developer/parser/bison
From OmniOS r151026 onwards, a
build-essentialmeta-package will be available to install the latest compiler version along with other packages generally required for a development environment.
If you install multiple versions of
gcc, then you can switch the links in
/usr/bin between versions by changing the pkg system mediator. Alternatively
you can use a specific version by invoking it directly or changing your PATH.
$ gcc -v gcc version 6.4.0 (GCC) $ pfexec pkg set-mediator -V 5 gcc $ gcc -v gcc version 5.5.0 (GCC)
This page is a work-in-progress and contributions are very welcome. The system administration page in the wiki provides some further information that may eventually be incorporated into this page.