Solaris 10 5/09 Installation Guide: Basic Installations

Performing Initial Installation With the Solaris Interactive Text Installer for ZFS

This procedure describes how to install a standalone SPARC based system from CD or DVD media.

SPARC: How to Install a ZFS Root Pool

Before You Begin

If you want to install the Solaris OS on a machine or domain that does not have a directly attached DVD-ROM or CD-ROM drive, you can use a DVD-ROM or CD-ROM drive that is attached to another machine. For detailed instructions, refer to Appendix B, Installing or Upgrading Remotely (Tasks), in Solaris 10 5/09 Installation Guide: Network-Based Installations.

Ensure that you have the necessary media.

For a DVD installation, you need the Solaris Operating System for SPARC Platforms DVD.
For a CD installation:

You need to following media.
- Solaris Software CDs.
- Solaris Languages for SPARC Platforms CDs – The installation program prompts you for these CDs if necessary to support languages for specific geographic regions.

If you want to preserve any existing data or applications, back up the system.

For backing up a UFS file system, see Chapter 23, Backing Up and Restoring UFS File Systems (Overview), in System Administration Guide: Devices and File Systems
For backing up a ZFS root pool, see Sending and Receiving ZFS Data in Solaris ZFS Administration Guide

Insert the Solaris Operating System for SPARC Platforms DVD or Solaris Software for SPARC Platforms - 1 CD.

Boot the system.
- If the system is new, just removed from its packaging, turn on the system.
- If you want to install a system that is currently running, shut down the system.
The ok prompt is displayed.

Start the Solaris interactive text installer. You cannot run the installation GUI to install a ZFS root pool. To boot from the local DVD or CD and start the text installer in a desktop session, type the following command
ok boot cdrom - text
text

Specifies to run the text installer in a desktop session. Use this option to override the default GUI installer.

If the operating system cannot locate a self-identifying keyboard, the next screen displays keyboard layout selections.

Note –
PS/2 keyboards are not self-identifying. You will be asked to select the keyboard layout during the installation.

(Optional) Select the desired keyboard layout from the following screen and press F2 to continue.

Configure Keyboard Layout
+---------------------------------------------------------------------------+
|   Please specify the keyboard layout from the list below.                 |
|                                                                           |
|   To make a selection, use the arrow keys to highlight the option and     |
|   press Return to mark it [X].                                            |
|                                                                           |
|            Keyboard  Layout                                               |
|            -----------------------                                        |
|       [  ] Serbia-And Montenegro                                          |
|       [  ] Slovenian                                                      |
|       [  ] Slovakian                                                      |
|       [  ] Spanish                                                        |
|       [  ] Swedish                                                        |
|       [  ] Swiss-French                                                   |
|       [  ] Swiss-German                                                   |
|       [  ] Taiwanese                                                      |
|       [  ] TurkishQ                                                       |
|       [  ] TurkishF                                                       |
|       [  ] UK-English                                                     |
|       [ X] US-English                                                     |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

The system configures the devices and interfaces and searches for configuration files. A list of language choices might be displayed. If this screen is not displayed, skip to Step 6.

(Optional) You might see a screen to select a language. Select the language you want to use during the installation, and press F2.

Select a Language
+---------------------------------------------------------------------------+
|   Please specify the the language from the list below.                    |
|                                                                           |
|   To make a selection, use the arrow keys to highlight the option and     |
|   press Return to mark it [X].                                            |
|                                                                           |
|       [  ] English                                                        |
|       [  ] French                                                         |
|       [  ] German                                                         |
|       [  ] Italian                                                        |
|       [  ] Japanese                                                       |
|       [  ] Korean                                                         |
|       [  ] Simplified Chinese                                             |
|       [  ] Spanish                                                        |
|       [  ] Swedish                                                        |
|       [  ] Traditional Chinese                                            |
|       [  ] UK-English                                                     |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

Press F2 to begin the installation. If you are prompted, answer any remaining configuration questions.

Preconfiguring system information.

Select one of the following options:
- If you preconfigured all of the system information, the installation program does not prompt you to type any configuration information. See Chapter 2, Preconfiguring System Configuration Information (Tasks), in Solaris 10 5/09 Installation Guide: Network-Based Installations for more information.
- If you did not preconfigure all the system information, the installation program prompts you for this information on several screens. Use the Checklist for Installation to help you answer the configuration questions.
Network configuration.

One configuration question asks you whether you want to enable network services for use by remote clients. The default response is “Yes, I would like to enable network services for use by remote clients.”

Selecting “No” provides a more secure configuration in which Secure Shell is the only network service provided to remote clients. Selecting “Yes” enables a larger set of services as in previous Solaris releases. You can safely select “No,” as any services can be enabled after installation. For further information about these options, see Planning Network Security in Solaris 10 5/09 Installation Guide: Planning for Installation and Upgrade.

The network services can be enabled after installation by using the netservices open command or by enabling individual services by using SMF commands. See Revising Security Settings After Installation in Solaris 10 5/09 Installation Guide: Planning for Installation and Upgrade.

After you answer the configuration questions and set the root password, the Solaris Interactive Installation screen is displayed.

Solaris Interactive Installation
+---------------------------------------------------------------------------+
|On the following screens, you can accept the defaults or you can customize |
| how Solaris software will be install by:                                  |
|  - Selecting the type of Solaris software to install                      |
|  - Selecting disks to hold the software you've selected                   |
|  - Selecting unbundled products to be installed with Solaris              |
|  - Specifying how file systems are laid out on the disks                  |
|                                                                           |
|After completing these tasks, a summary of your selections                 |
|(called a profile) will be displayed.                                      |
|                                                                           |
|There are two ways to install your Solaris software:                       |
|                                                                           |
|  - "Standard" installs your system from a standard Solaris                |
|     Distribution. Selecting "standard" allows you to choose               |
|     between initial install and upgrade, if your system is upgradeable.   |
|                                                                           |
|  - "Flash" installs your system from one or more Flash Archives.          |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

Decide if you want to reboot the system automatically and if you want to automatically eject the disc. Press F2.

If you already have ZFS storage pools on the system, they are acknowledged by the following message, but remain untouched, unless you select the disks in the existing pools to create the new storage pool.

There are existing ZFS pools available on this system.  However, they can only be upgraded 
using the Live Upgrade tools.  The following screens will only allow you to install a ZFS root system, 
not upgrade one.

The License screen appears.

Accept the license agreement to continue the installation. Press F2.

The Select Upgrade or Initial Install screen might display. If you have UFS file system that is upgradeable, this screen is displayed. If this screen does not display, skip to Step 10.

To perform a ZFS installation, you must press F4 for an initial installation.

Screens for choosing geographic regions, locales, and additional products are displayed.

Make your choices for geographic regions, locales, and additional products.

The Choose a Filesystem Type screen is displayed.

To create a ZFS root pool, select the ZFS option and press F2.

Choose a Filesystem Type
+---------------------------------------------------------------------------+
|   Select the filesystem to use for your Solaris installation              |
|                                                                           |
|           [ ] UFS                                                         |
|           [X] ZFS                                                         |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

The Select Software screen is displayed.

Select the type of installation you want to perform. Press F2.

To perform a default installation, accept the default value that is provided. To perform a custom installation, edit the values in the text installer screen. In this example screen, the default Entire Distribution Software Group is checked for installation.

For more information about software groups, see Disk Space Recommendations for Software Groups.

Select Software
+---------------------------------------------------------------------------+
|Select the Solaris software to install on the system                       |
|                                                                           |
|Note: After selecting a software group, you can add or remove              |
|software by customizing it. However this requires understanding of         |
|software dependencies and how Solaris software is packaged.                |
|                                                                           |
|  [ ] Entire Distribution plus OEM support ......5838.00 MB                |
|  [X] Entire Distribution........................5830.00 MB                |
|  [ ] Developer System Support...................5695.00 MB                |
|  [ ] End User System Support....................4747.00 MB                |
|  [ ] Core System Support........................1558.00 MB                |
|  [ ] Reduced Networking Core System Support.....1512.00 MB                |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

The Select Disks screen is displayed.

After you select the software to be installed, you are prompted to select the disks to create your ZFS storage pool. This screen is similar to previous Solaris releases, except for the following text:

For ZFS, multiple disks will be configured as mirrors, so the disk you choose, 
or the slice within the disk must exceed the Suggested Minimum value.

You can select the disk or disks to be used for your ZFS root pool.

If you select a single disk and want to configure mirroring later, see the zpool attach command in Managing Devices in ZFS Storage Pools in Solaris ZFS Administration Guide.
If you select two disks, a mirrored two-disk configuration is set up for your root pool. Either a two-disk or three-disk mirrored pool is optimal.
If you have eight disks and you select all eight disks, those eight disks are used for the root pool as one big mirror. This is not an optimal configuration.

A RAID-Z pool configuration for the root pool is not supported. For more information about configuring ZFS storage pools, see Replication Features of a ZFS Storage Pool in Solaris ZFS Administration Guide.

Select Disks
+---------------------------------------------------------------------------+
|On this screen you must select the disks for installing Solaris            |
|software. Start by looking at the Suggested Minimum Field;                 |
|this value is the approximate space needed to install the software         |
|you've selected. For ZFS, multiple disks will be configured as mirrors,    |
|so the disk you choose on the slice within the disk must exceed            |
|the Suggested Minimum Value.                                               |
|                                                                           |
|  Note: xx denotes the current boot disk                                   |
|                                                                           |
|Disk Device                                        Available Space         |
|========================================================================== |
|                                                                           |
|[X]xx c0t0d0                                        29164 MB (F4 to edit)  |
|                                                                           |
|                                 Maximum Root Size: 29164 MB               |
|                                 Suggested Minimum: 5838 MB                |
|                                                                           |
|    F2_Continue      F6_Help                                               |
+---------------------------------------------------------------------------+

The Preserve Data screen is displayed.

(Optional) Preserve data on the disk where you are installing the software.

If a disk tha you have selected for installing contains file systems or has unnamed slices that you want to save, you can save these file systems or unnamed slices now.

Preserve Data?
+---------------------------------------------------------------------------+
|Do you want to preserve existing data? At least one of the disks you've    |
|selected for installing Solaris software has file systems or unnamed slices|
|that you may want to save                                                  |
|                                                                           |
|                                                                           |
|    F2_Continue      F4_Preserve    F6_Help                                |
+---------------------------------------------------------------------------+

If you pressed F4 to save data, the screen for saving data is displayed.

(Optional) Select the data to save.

Preserve Data
+---------------------------------------------------------------------------+
|On this screen you can perserve the data on some or all disk slices. Any   |
|slice you preserve will not be touched when Solaris software is installed  |
|If  you preserve data on / (root), /usr, or /var you  must rename them     |
|because new versions of these file systems are created when Solaris        |
|software is installed.                                                     |
|                                                                           |
|Warning: Preserving an 'overlap' slice will not preserve any data within   |
|it. To preserve this data, you must explicitly set the mount point name.   |
|                                                                           |
|Mount Point or Pool                   State    Disk/Slice             Size |
|========================================================================== |
|[ ] zfs: rpool                        Online    c0t0d0s0          27133 MB |
|[ ]swap                                         c0t1d0s1           2047 MB |
|[X]overlap                                      c0t2d0s2          29188 MB |
|                                                                           |
|                                                                           |
|    F2_Continue                     F6_Help                                |
+---------------------------------------------------------------------------+

The screen for configuring ZFS settings is displayed.

You can accept the default values. Or, you can change the name of the ZFS pool, the dataset name, the pool size, swap and dump. In addition, you can modify the way the /var file system is created and mounted.

Configure ZFS Settings
+-------------------------------------------------------------------------- -+
|Specify the name of the pool to be created from the disk(s) you have chosen.|
|Also specify the name of the dataset to be created within the pool that is  |
|to be used as the root directory for the filesystem.                        |
|                                                                            |
|                                                                            |
|              ZFS Pool Name: rpool                                          |
|      ZFS Root Dataset Name: szboot_0507                                    |
|          ZFS Pool Size in (MB): 17270                                      |
|          Size of swap area in (MB): 1024                                   |
|          Size of dump area in (MB): 1024                                   |
|        (Pool size must be between 9472 MB and 17270 MB)                    |
|                                                                            |
|                         [X] Keep / and /var combined                       |
|                         [ ] Put /var on a separate dataset                 |
|                                                                            |
|    F2_Continue      F6_Help                                                |
+------------------------------------------------------------------------- --+

The screen for mounting a remote file system is displayed.

Decide if you want to mount a remote file system.

Mount Remote File System
+-------------------------------------------------------------------------- -+
|Do you want to mount a software from a remote file server? This may         |
|be necessary if you had to remove software because of disk space problems.  |
|                                                                            |
|                                                                            |
|    F2_Continue      F6_Help                                                |
+------------------------------------------------------------------------- --+

The final installation screen is displayed.

Review the Profile screen that displays your choices for installation. You can change the installation profile if needed. The following example is of a final installation Profile screen.

Profile
+-------------------------------------------------------------------------- -+
|The information shown below is your profile for installing Solaris software.|
|It reflects the choices you've made on previous screens.                    |
|                                                                            |
|============================================================================|
|                                                                            |
|                Installation Option: Initial                                |
|                        Boot Device: c1t2d0                                 |
|              Root File System Type: ZFS                                    |
|                    Client Services: None                                   |
|                                                                            |
|                            Regions: North America                          |
|                      System Locale: C ( C )                                |
|                                                                            |
|                           Software: Solaris 10, Entire Distribution        |
|                          Pool Name: rpool                                  |
|              Boot Environment Name: szboot_0507                            |
|                          Pool Size: 17270 MB                               |
|                    Devices in Pool: c1t2d0                                 |
|                                                                            |
|                                                                            |
|    F2_Continue      F6_Help                                                |
+------------------------------------------------------------------------- --+

To install the Solaris software, press F2. Follow the instructions on the screen to install the Solaris software.

When the Solaris interactive text program finishes installing the Solaris software, the system reboots automatically or prompts you to reboot manually.

If you are installing additional products, you are prompted to insert the DVD or CD for those products. For installation procedures, refer to the appropriate installation documentation.

After the installation is finished, installation logs are saved in a file. You can find the installation logs in the /var/sadm/system/logs and /var/sadm/install/logs directories.

The installation is complete.

If you did not select automatic reboot during the installation, reboot the system.
# reboot
Your system boots to the ZFS root pool that you installed.

You can display a list of available boot environments by using the boot command with the -L option. For more information about SPARC based booting, see Booting From a ZFS Root File System on a SPARC Based System in System Administration Guide: Basic Administration.

When the installation completes, review the resulting ZFS storage pool and file system information, as in the following example.

The ZFS root pool is a special kind of pool that requires no administration. The sample zfs list output identifies the root pool components, such as the rpool/ROOT entries that are not accessible by default.

# zpool status
  pool: rpool
 state: ONLINE
 scrub: none requested
config:

        NAME        STATE     READ WRITE CKSUM
        rpool       ONLINE       0     0     0
        c1t2d0s0  ONLINE       0     0     0

errors: No known data errors
# zfs list
NAME                     USED  AVAIL  REFER  MOUNTPOINT
rpool                   6.83G  9.66G    62K  /rpool
rpool/ROOT              5.82G  9.66G    18K  legacy
rpool/ROOT/szboot_0507  5.82G  9.66G  5.82G  
rpool/dump               512M  9.66G   512M  -
rpool/swap               518M  9.66G   518M  -

If you initially created your ZFS storage pool with one disk, you can convert the disk to a mirrored ZFS configuration after the installation. For more information about adding or attaching disks, see Managing Devices in ZFS Storage Pools in Solaris ZFS Administration Guide.

Troubleshooting

If you encountered any problems during the installation, see Appendix A, Troubleshooting (Tasks), in Solaris 10 5/09 Installation Guide: Custom JumpStart and Advanced Installations.