An OpenSSO Lab using VirtualBox
By warren on May 05, 2009
As part of the Reboot conference in Victoria, I developed a hands on OpenSSO lab using VirtualBox. The virtual image is running OpenSolaris 2009.06 (dev), GlassFish v3, and OpenSSO (express build 7).
The goal of the lab is to provide a short (it should take you 4-5 hours to complete) introduction to OpenSSO that covers basic installation, SAML federation using Fedlets, and installing Policy Agents.
The intended audience for the lab are developers or those that want to understand the functional aspects of OpenSSO. David Goldsmith has developed a much more comprehensive OpenSSO lab that focuses on complex, load balanced configurations. If you are more interested in the infrastructure side of things, check out his blog posting on the lab. David is a training pro - and his stuff is always top notch.
This lab is meant to be facilitated, but if you want to follow along at home, read on:
- Make sure you have a computer with a MINIMUM of 2GB of RAM, 10GB free disk. Dual core CPU is strongly recommended.
- Download and install VirtualBox 2.2.2. or later (earlier versions are not compatible with this lab)
- You should have an ssh client (e.g. putty.exe on Windows) installed.
The lab documents (zipped pdf) can be downloaded here.
The Virtual Image is split into four zip fragments:
These fragments needs to be pasted together, and then unzipped.
On Unix-ish systems:
cat xa[abcd].zip > bigfile.zip
On Windows use can use the copy command:
copy /b xaa.zip+xab.zip+xac.zip+xad.zip bigfile.zip
Unzip the file, and then import the appliance into VirtualBox.
The image is a \*completed\* version of the lab (everything is installed). The idea is to give you a known starting point. If you want to experiment with the lab, start with the uninstall procedures first. You can take a VirtualBox snapshot to save the lab state, or use ZFS snapshots from within the OpenSolaris image.
To save some memory, the OpenSolaris GUI has been disabled. You can enable the GUI with the following command:
pfexec svcadm enable gdm
Note: When importing the appliance you may encounter a bug where the import "hangs". After letting the disk fully import, you will need to kill VirtualBox and start it again. You will find that the imported disk image is now in the Media Manager - and can be added to the new Virtual machine. You should be able to boot the image after assigning the disk.
Running a Solaris 64 bit kernel under VirtualBox can occasionally trigger very high CPU consumption- making the startup of OpenSSO take a long time (10+ minutes). See this bugid for details. To get around this problem boot the image in 32 bit mode. The easiest way to do this is to change your VirtualBox settings to select "OpenSolaris" as the OS Type instead of "OpenSolaris 64 bit".