Solaris 10 10/08 Installation Guide: Custom JumpStart and Advanced Installations

root_device Profile Keyword (UFS and ZFS)


Note –

The root_device keyword can be used when you install either a UFS file system or a ZFS root pool. The usage for this keyword is the limited to a single system for ZFS installations.


root_device slice

root_device designates the system's root disk. How the System's Root Disk Is Determined contains additional information.


Note –

The root disk is determined by the JumpStart program and determines where the OS is to be installed. The rules file uses a probe keyword “rootdisk,” but this keyword is used differently than the "rootdisk" keyword used in the JumpStart profile. You cannot set the place of installation by using the probe keyword “rootdisk” in the rules file. The probe keyword, rootdisk, determines where to boot from during the installation. See Table 8–10.


When you are upgrading a system, root_device designates the root (/) file system and the file systems that are mounted by its /etc/vfstab file to be upgraded. You must specify root_device if more than one root (/) file system can be upgraded on a system. You must specify slice in the form cwtxdysz or cxdysz.

When you use the root_device keyword, consider the following:


Example 8–26 root_device Profile Keyword

root_device c0t0d0s2

How the System's Root Disk Is Determined

A system's root disk is the disk on the system that contains the root (/) file system. In a profile, you can use the rootdisk variable in place of a disk name, which the JumpStart program sets to the system's root disk. Table 8–8 describes how the JumpStart program determines the system's root disk for the installation.


Note –

The JumpStart program only determines a system's root disk size during an initial installation. You cannot change a system's root disk during an upgrade.


Table 8–8 How JumpStart Determines a System's Root Disk (Initial Installation)

Stage 

Action 

If the root_device keyword is specified in the profile, the JumpStart program sets rootdisk to the root device.

If rootdisk is not set and the boot_device keyword is specified in the profile, the JumpStart program sets rootdisk to the boot device.

If rootdisk is not set and a filesys cwtxdysz size / entry is specified in the profile, the JumpStart program sets rootdisk to the disk that is specified in the entry.

If rootdisk is not set and a rootdisk.sn entry is specified in the profile, the JumpStart program searches the system's disks in kernel probe order for an existing root file system on the specified slice. If a disk is found, the JumpStart program sets rootdisk to the found disk.

If rootdisk is not set and partitioning existing is specified in the profile, the JumpStart program searches the system's disks in kernel probe order for an existing root file system. If a root file system is not found or more than one is found, an error occurs. If a root file system is found, the JumpStart program sets rootdisk to the found disk.

If rootdisk is not set, the JumpStart program sets rootdisk to the disk where the root (/) file system is installed.