[OmniOS-discuss] FLAG DAY - 4719 affects nightly, package, and poold

[Dan McDonald]

Illumos #4719 introduces a flag day for people who build illumos-gate.
Starting now, you will need a Java Developers Kit (JDK) 7 or later.
OpenIndiana 151a9 does NOT have this by default.  Builders must either set
JAVA_ROOT to a source of JDK7, or must have /usr/java populated with JDK7.

Users still on JDK6 will see build errors in the packaging portions like
such:

==== package build errors (non-DEBUG) ====

dmake: Warning: Command failed for target `packages.i386/developer-dtrace.dep'
dmake: Warning: Command failed for target `packages.i386/service-network-dns-mdns.dep'
dmake: Warning: Target `install' not remade because of errors

.  .  .


These are due to javadoc changes between 6 and 7.  The dtrace and mdns
packages generate javadoc, so their packaging manifests are updated to the 7
versions.


ALSO, because poold defines JAVA_ROOT in its binaries, you must set JAVA_ROOT
when building poold to match the runtime java on your ONU or
otherwised-packaged target.  For example, on my OI 151a9 test builder, I
untarred an openjdk7 in /usr/jdk/instances/openjdk7/ and set
JAVA_ROOT=/usr/jdk/instances/openjdk7/.


IMPORTANT --> If you are an OI 151a9 user, and wish to use poold, installing
openjdk7 in instances is not sufficient.  You will need to set /usr/java to
point to the openjdk7 instance as well.  Illumos bug 5851 tracks this.


This change is the last of several steps that will allow other platforms
(like OmniOS, e.g.) to build stock illumos-gate.  I will post a separate note
on building illumos-gate on OmniOS.


Thanks to Richard PALO for creating these diffs in the first place.

Thanks!
Dan