Jet and WanBoot

(Note this page is derived from an internal wiki page originally written by Marco Stadler and updated by Steve Putre)

Wanboot is a useful technology when thee are restrictions on the network connectivity between the Jumpstart server and the client to be built. We can boot clients anywhere, independent of subnets, routers, firewalls or other stuff, which could block the booting or install process of a system. Unfortunately, JET did not initially support the use of Wanboot.

Wanboot was introduced Solaris 9 for SPARC, but many of the server's OBPs were not able to handle the boot process. Since OBP 4.17.1 we have the possibility to boot over http directly on the Open Boot Prompt.

Wanboot only works on SPARC based Sun servers, requires that you install a Flash Archive, and that it is possible to pass http(s) traffic over IP between the Jumpstart server and the client.

h2. How to setup JET with wanboot

JET now supports installations fully over http. This includes the boot process and the installation itself. The Module 'JetWanBoot' brings this feature into the JET framework. The Module comes with a new media management method of 'http'. This means all the packages and patches and other files, which use the JET media management methods will be transferred over http to the client and are installed from there. After the installation the files are removed, if wished. The Method is based on the wget utility and a CGI on the server side. Wget does not have be part of the to be installed OS. It will be installed at the beginning and removed at the end of the installation. In this way the user hasn't to care about this.

To use the 'JetWanBoot' package, the minimum SUNWjet version must be 4.3

To enable wanboot, edit the /opt/SUNWjet/etc/wanboot.conf file to tell JET where the webserver document root area is and what the base uri will be for the clients. A webserver (ex. apache2) must also be set up on the Jet server. It must also provide a cgi-bin directory. The minimum config for apache is to set the 'ServerName' var in the /etc/apache2/httpd.conf file to make it running.

To use wanboot for a particular client, update the client template:

base_config_client_allocation="wanboot"

Or set it for all clients in /opt/SUNWjet/etc/jumpstart.conf at the var JS_CLIENT_MANAGEMENT

After make_client configure the clients OBP var with the given arguments. Then start installation with:

boot net - install

h2. Supported Modules, Hardware and OS Versions.

h3. Supported Platforms:

All Platform, which have the minimum required OBP Version 4.17.1 installed and the 'network-boot-arguments' var available with 'setenv'. Otherwise you have to boot from cdrom with:

boot cdrom -o prompt -F wanboot - install

Or use the 'Tar installation' method decribed in the Release Notes

h3. Supported OS Versions:

* Solaris 8 (No wanboot, but install over http)
* Solaris 9

Basically all the modules, which access the pkg and patches through the standard media management methods should work. This means they have to be accessed by the JS_get_media function. This is done, if the modules install the packages and patches with JS_install_pkg, JS_install_pkgclust, JS_install_patch or JS_install_patchclust.

This modules are known to be working:

* base_config
* flash (required for wanboot installations!)
* custom
* sds
* vxvm4
* explo
* jass

Please also read the Releasenotes of the module. You can find more information there.