Ordered guest boot-up and shutdown sequences for SmartOS
Go to file
Tamás Gérczei 679472a2e3 license provided 2016-04-19 15:37:28 +02:00
LICENSE license provided 2016-04-19 15:37:28 +02:00
README.md provided README 2016-04-19 15:26:39 +02:00
guesthandler-disarm.xml added convenience property 'config/method_prefix' defaulting to '/opt/custom/bin' to both services 2016-04-19 09:35:03 +02:00
guesthandler.xml fixed broken method script plus removed property 'config/delay' since SMF does not do token expansion anywhere outside 'exec' 2016-04-19 10:44:11 +02:00
svc-guesthandler disarm will now really make 'em stay put 2016-04-19 15:23:47 +02:00

README.md

A makeshift solution to extend SmartOS with the capability to order VM boot and shut-down sequences by priority. It leverages SMF 'hot-plugging' built into the platform as well as vmadm's ability to tag guests. Technically it mitigates the built-in auto-boot procedure by intervening in due time and afterwards starts/stops VMs in an order derived from the numerical value of the 'property' tag. My use-case: a single toy rig running vanilla SmartOS acting as an all-in-one system providing a range of services including infrastructural ones like name resolution and IP address allocation as well as an edge firewall; each contained in a dedicated guest which will, in turn, depend on another.

A logical pre-requisite of all this is tagging the VMs ideally upon creation or otherwise:

vmadm list -Ho uuid | while read UUID; do vmadm update $UUID <<< "{"set_tags": {"priority": 0}}"; done

This will tag all VMs with the priority of 0 which will leave them stopped. Afterwards an actual order needs to be established by assigning non-zero values to them one by one in ascending order where lesser values represent higher priorities - with the notable exception of 0 - and thus earlier start-up:

vmadm update <UUID> <<< "{"set_tags": {"priority": 100}}"; done

...and so on. Informational messages are logged via the syslog facility as 'daemon.notice' entries tracking the determined order as well as the outcome for every step taken. The solution comprises two services backed by the same single method script: one activated before svc:/system/zones in order to convince it not to start any guests and the actual payload starting once vmadmd is available to evaluate the tags and complete the sequence.

SMF will import the manifests for the services upon boot-up when it initializes its repository. The location of the method script is configurable via the service property config/method_prefix, defaulting to /opt/custom/bin. The start-up delay defaults to 30 seconds, also configurable via the context environment variable DELAY for the method start.

In the future the method script might get re-written in node.js in order to make a more human-friendly dependency notation/handling possible. This is merely the shortest path.