Section 6 - Guest Domain OS

h2. Linux Installation Overview
The support for the sun4v architecture and LDoms virtual device drivers have been integrated into the Linux 2.6.23 kernel. However the installer of most Linux distributions does not include the LDoms virtual device drivers (sunvnet and sunvdc), so this prevents installing those Linux distributions.

h2. Ubuntu 7.10 (Gusty) on LDoms Procedure
* Download the Ubuntu 7.10 installation image for SPARC
http://ftp.osuosl.org/pub/ubuntu/dists/gutsy/main/installer-sparc/current/images/sparc64/netboot/2.6/boot.img

* Create a boot server for downloading the install image (this can done on the primary domain):
** edit /etc/ethers with the ethernet address and hostname of the guest domain
** edit /etc/nsswitch.conf and make sure that the line starting with "ethers:" contents "nis files" or "files"
** start the rarp service:
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# *svcadm enable rarp*}}
{panel}
** create the /tftpboot directory
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# *mkdir /tftpboot*}}
{panel}
** edit /etc/inetd.conf and uncomment the line for the tftp service (last line)
** activate the tftp service
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# *inetconv*}}
{panel}
** copy the downloaded boot.img file into the /tftpboot directory
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# *cp boot.img /tftpboot/XXXXXXXX*}}
{panel}

* Create a guest domain with one virtual disk to which you will install linux (Note: other creation commands have been removed):
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# *ldm add-vdsdev /ldg1/bootdisk vol0@primary-vds0*}}
{{primary# *ldm add-vdisk vdisk0 vol0@primary-vds0 ldg1*}}
{panel}

* Bind and start the domain:
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{primary# ldm bind ldg1*}}
{{primary# ldm start ldg1*}}
{{primary# telnet localhost <port number>}}
{panel}

* Boot the domain over the network:
{panel:borderStyle=solid| borderColor=black|bgColor=#e6e6e6}
{{ok *boot vnet*}}
{panel}

The Ubuntu installer will be downloaded and you should be able to install Linux on the virtual disk. Remember the control domain must be configured to use the vswitch for traffic to ldg1.
{column}
{section}