Running OpenSolaris Using VirtualBox

Note - If you have the OpenSolaris Student Pack DVD, use the DVD-specific VirtualBox instructions that are available on the DVD instead of the general instructions below.

The VirtualBox runs as an application in your operating system, providing an environment, called a virtual machine, which enables you to install other operating systems as “guests” inside the virtual machine.

The VirtualBox software supports the following host operating systems:

Table 1-5 VirtualBox Hosts

Host Operating Systems	Supported Versions
Windows	Windows XP – All service packs Windows Server 2003 Windows Vista – 32-bit and 64-bit
Linux on 32-bit and 64-bit systems	Debian GNU/Linux 3.1 at minimum Fedore Core 4 at minimum Gentoo Linux Redhat Enterprise Linux 3 at minimum SuSE Linux 9 at minimum OpenSuSE 10.1 at minimum Ubuntu 5.10 at minimum Mandriva 2007.1 and 2008.0
Apple Mac OS X (Intel)	All

Before running OpenSolaris inside your existing operating system, you must first install the VirtualBox application. After VirtualBox is successfully installed on your computer, you can run the OpenSolaris ISO image or the Live CD as a virtual guest “in the box.” You do not need to burn a DVD.

Note - A minimum or 10 GB of disk space or virtual disk space is recommended in order to install the VirtualBox and to install the OpenSolaris release inside the VirtualBox.

The basic procedure to set up OpenSolaris in VirtualBox is the following:

If you do not have the OpenSolaris Student Pack DVD, download and install VirtualBox.

Note - If you do have the OpenSolaris Student Pack DVD, use the DVD-specific VirtualBox instructions that are available on the DVD.
If you do not have the OpenSolaris Live CD or the OpenSolaris Student Pack DVD, download the OpenSolaris ISO image.
Set up VirtualBox for OpenSolaris.
Start OpenSolaris inside VirtualBox.

See the following specific instructions for each step.

How to Download the VirtualBox Application

VirtualBox is available at the Sun Download Center.

Go to Downloading VirtualBox and select the VirtualBox Binaries option.
Select the platform for your machine from the drop-down menu.
Mark acceptance of the license agreement and click Continue.
Click the link for virtualbox_1.6.
Alternatively, you can use the Sun Download Manager.
Save the file to your desktop or local disk.
When the download is complete, close the browser.

How to Download the OpenSolaris ISO Image

Before You Begin

You can go to OpenSolaris.com and either download the OpenSolaris 2008.05 ISO image or order a free OpenSolaris 2008.05 Live CD. The following procedure describes the download option.

Note - The ISO image requires about 685 Mbytes on your hard drive.

Go to http://www.opensolaris.com/get/ site.
Select the link to download the OpenSolaris 2008.05 image file.
Note - At this site, you can choose between a complete installation with all available languages, or a “slimmer” installation with selected languages and faster installation time.
Save the OpenSolaris image file to a location on your computer.
For convenience, download to the same disk drive or partition where you placed your VirtualBox files.
Depending on the speed of your Internet connection, the download takes several minutes.

How to Install VirtualBox on a Windows Machine

Navigate to the downloaded VirtualBox installation files or folder.
To start the installation, double-click the VirtualBox installation file and click Next on the pop-up window.
Accept the license agreement and click Next.
In the pop-up window, choose a location for the VirtualBox software.
Note - You need 10 GB or more disk space to install both VirtualBox and the OpenSolaris image.
Accept the default location, or click the Browse button and type your preferred location. Then click Next.
Click the Install button.
When the completion message is displayed, click Finish.

How to Install VirtualBox on a Linux Machine

Note - Download the latest version of VirtualBox as described previously even if your Linux distribution comes with a VirtualBox version preinstalled. The preinstalled VirtualBox software is usually the Open Source Edition (OSE), which might not be suitable for running the OpenSolaris 2008.05 release.

Open a terminal window and become root.
Navigate to the downloaded VirtualBox installation file.
Depending on your Linux distribution, start the installation process by using one of the following commands:
- On rpm-based systems, such as Fedora, SuSE, or Red Hat, type the following:
```
rpm -ihv filename
```
  Replace filename with the name of the downloaded installation file.
- On deb-based systems, like Debian, or Ubuntu, type the following:
```
dpkg -i filename
```
  Replace filename with the name of the downloaded installation file.
Note - You might need to install additional packages to fulfill dependencies.

The installer searches for a precompiled kernel module. If no kernel module is available that is precompiled for your system, the installer attempts to compile and install a kernel module.

Note - You need to have basic build utilities, such as gcc, make, binutils, and kernel header, installed for the installer to be able to build the kernel module. Usually, these utilities are part of the standard installation of your Linux system. If these utilities are not present, the installer will be unable to build the kernel module. In this case, install the build utilities and manually start the kernel module compilation later by running /etc/init.d vboxdrv setup as root.
Add the current user to the vboxusers group.
1. In a terminal window, type:
```
sudo usermod -G vboxusers -a username
```
  Replace username with the name of the current user.
2. Log out and log in again to apply the changes.
Open a terminal window, type VirtualBox, and press Enter to start the VirtualBox.
Accept the license agreement.

How to Install VirtualBox on a Macintosh (Intel) Machine

Navigate to and mount the downloaded VirtualBox .dmg disk image file.
To start the installation, double-click the VirtualBox .mpkg file and click Continue.
Accept the license agreement and click Continue.
Select the destination volume and click Continue
Click Install to install VirtualBox in the default Applications folder, or click Change Install Location to install in another location.
Enter your user password.
When the completion message displays, click Close.

How to Set up VirtualBox for Use with OpenSolaris

Before You Begin

If you have the OpenSolaris Live CD, boot to your host operating system, then insert the Live CD. Then, open the VirtualBox application.

Start VirtualBox by using one of the following steps:
- On Windows, click the Start button, and select VirtualBox from the list of programs.
- On Linux, open a terminal window, type VirtualBox, and press Enter.
- On Mac OS X, open Applications in the Finder and double-click VirtualBox.
On the first start of VirtualBox, type your registration information and click Confirm.
The main VirtualBox window appears.
Click the New icon on the left side of the GUI, and click Next in the pop-up window.
Type a name for your virtual machine, and select OpenSolaris as the operating system, from the drop-down list. Click Next.
Select the amount of RAM to allocate to the OpenSolaris installation inside VirtualBox. Click Next.
Note - 512 Mbytes is the recommended minimum size. If you have 2 Gbytes or more of memory on your machine, you should choose 1 Gbytes for optimum performance. See the substep C in the following step.
Add a Virtual Disk Image (vdi) by selecting a name or adding a new name to the list. For the initial installation, follow these substeps:
1. Select New and click Next.
2. Accept the default Dynamically Expanding Image and click Next.
3. Accept the default name, or type a path and name, and allocate space for the image.
4. When you've completed the settings, click Next.
5. Click Finish to create the disk image.
When the initial Virtual Disk Manager GUI appears with your new vdi file selected, click Next.
In the Summary screen, click Finish.
The main VirtualBox window appears. Your virtual OpenSolaris machine is displayed in the left panel, and is ready to use as a virtual machine.
Click the CD/DVD-ROM link on the right-hand side, in the Details tab.
Check Mount CD/DVD Drive and select one of the following:
- If you are using the OpenSolaris Live CD, select Host CD/DVD Drive and close the Settings screen. Skip step 11.
- If you are using a downloaded OpenSolaris ISO image, select ISO Image File and go to step 11.
In the drop-down list, select the downloaded OpenSolaris ISO image. If the ISO image is not in the list, add the image as follows:
1. Click the Select icon in the right of the drop-down list.
2. Click the CD/DVD Images tab.
3. Click the Add icon.
4. Navigate to the downloaded OpenSolaris ISO image file and click Open.
5. Click Select and close the Settings screen.
6. Close the Settings screen.

How to Start OpenSolaris 2008.05 Using VirtualBox

Start VirtualBox by using one of the following options:
- On Windows, click the Start button and select VirtualBox from the list of programs.
- On Linux, select VirtualBox from the System Tools menu (GNOME desktop) or from the System menu (KDE desktop).
- On Mac OS X, open Applications in the Finder and double-click VirtualBox.
Double-click your virtual machine icon or select it and click Start.
Caution - Unless you have the ISO on a CD, click the CD/DVD-ROM link and verify that the OpenSolaris ISO image file is selected.

The GRUB boot menu with three options is displayed. Then a SunOS Release message is displayed. Finally, a list of languages appears.
When the list of keyboard layouts appears, press Enter to accept the English default. Or, type the number for your keyboard layout and press Enter.
Note - When you click inside the VirtualBox window with your virtual machine running, the mouse cursor is trapped inside the virtual desktop. Use the Host Key to release the mouse cursor again. The Host Key is indicated at the lower right corner of the VirtualBox window. By default, the Host Key is the right Ctrl key on Windows and Linux, and the left Cmd key on Mac OS X.
When the list of desktop languages appears, press Enter to accept the English default, or type the number to select another language and then press Enter.
Review and close the licensing agreement.
The application takes one or two minutes to load.
When the desktop screen appears, you are “in the box,” running the OpenSolaris 2008.05 release.

Note - You should install OpenSolaris to your virtual hard drive in order to be able to install programs and save configurations.
To install OpenSolaris 2008.05 on your virtual hard disk, click the Install OpenSolaris icon on the OpenSolaris desktop.
See Installing OpenSolaris 2008.05 for installation instructions.