> Tribblix Upgrades

There are two paths to get newer versions of software in Tribblix, both using the zap utility. An update will install newer versions of packages or overlays, while an upgrade will install a newer version of Tribblix.

In general, updates affect the current system and can be applied with the system running. You'll have to restart any application you've updated. Whereas an upgrade creates a new boot environment, installs new packages to that, and you reboot to activate the upgraded system.

Before doing an upgrade, you must ensure that the system has the latest versions of the appropriate software. As root, issue:

zap refresh
followed by
zap update TRIBzap-upgrade

You will then be able to check whether an upgrade is available:

zap upgrade list
and you should be given a list similar to the following:
m18: (current)
m19: Milestone 19
which shows that you're currently running the m18 release, and that an upgrade to m19 (Milestone 19) is available.

To perform the upgrade:

zap upgrade m19
and then to boot into the newly upgraded system, use beadm to activate it and then reboot - the appropriate commands will be printed at the end of the upgrade process, but will be something like
beadm activate m19
init 6

If you want to see what would happen (this isn't a proper dry run, and will create a number of errors) then

zap upgrade -n m19

If the newly upgraded system fails to work properly, then you can roll back to the previous version. If you're in a running system then you can use beadm list to see the available boot environments

BE       Active Mountpoint      Space Policy Created
tribblix -      -               28.0M static 2016-03-13 15:40
m18      NR     /               12.2G static 2016-11-06 18:42
(note that the initially installed boot environment will usually be called tribblix), and then
beadm activate tribblix
init 6
to go back to the older boot environment.

If the new boot environment won't boot properly, simply select the old one from the boot menu, and then beadm activate it so it will be the default next time.

The milestone 19 release includes the new bootloader, which is not active by default. Read more on how to activate the new loader.

If you have the ISO for the new release, then you might save some time and bandwidth by copying the zap files from the pkgs directory on the ISO into the /var/zap/cache directory. And if you're upgrading more than one system, copying /var/zap/cache will do even better.

Once you're happy that the new version of Tribblix is working well, you can remove older versions with the beadm destroy command.