(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
* Solaris 10
Please be aware, that Solaris 10 1/06 (update 1) has broken wanboot support! See Bug ID 6369598.
h3. Supported Jet Modules:
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.
Please report problems to the jet external alias.
h2. JetWanBoot notes and caveats:
# Wanboot has dependencies on the following Solaris packages: SUNWgetu, SUNWgetr, SUNWmkcd
# When running make_client for the first time with JetWanBoot?, JetWanBoot? will need a signifigant amount of disk space in which to create the miniroot. Before running make_client, ensure that the variable WANBOOT_SCRATCH_AREA in /opt/SUNWjet/etc/wanboot.conf points to a filesystem with at least 3Gb of free space.
# During the jumpstart process Wanboot will need access to the wget binary. To facilitate this, copy /usr/sfw/bin/wget to $HTDOCS/wanboot/wget.sparc
# Note the following restrictions with the current implementation of Wanboot and the JetWanBoot? module:
* https (SSL) builds are not supported in JetWanBoot?,
* Wanboot only works with SPARC-based hosts at this time,
* Wanboot supports Flash-based installs only; no pkgadd.
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
* Solaris 10
Please be aware, that Solaris 10 1/06 (update 1) has broken wanboot support! See Bug ID 6369598.
h3. Supported Jet Modules:
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.
Please report problems to the jet external alias.
h2. JetWanBoot notes and caveats:
# Wanboot has dependencies on the following Solaris packages: SUNWgetu, SUNWgetr, SUNWmkcd
# When running make_client for the first time with JetWanBoot?, JetWanBoot? will need a signifigant amount of disk space in which to create the miniroot. Before running make_client, ensure that the variable WANBOOT_SCRATCH_AREA in /opt/SUNWjet/etc/wanboot.conf points to a filesystem with at least 3Gb of free space.
# During the jumpstart process Wanboot will need access to the wget binary. To facilitate this, copy /usr/sfw/bin/wget to $HTDOCS/wanboot/wget.sparc
# Note the following restrictions with the current implementation of Wanboot and the JetWanBoot? module:
* https (SSL) builds are not supported in JetWanBoot?,
* Wanboot only works with SPARC-based hosts at this time,
* Wanboot supports Flash-based installs only; no pkgadd.