test

Solaris 9 9/04 Installation Guide

Chapter 18 Using the Solaris suninstall Program (Tasks)

This chapter explains how to use the Solaris suninstall program on the Solaris Software 1 of 2 CD to install or upgrade the Solaris software.

Solaris suninstall Program

You can run the Solaris suninstall program with a CLI. For x86 systems, the Device Configuration Assistant is included in the Solaris suninstall program. The Solaris suninstall program requires a local or remote CD-ROM drive or network connection, keyboard, and monitor. You can run the Solaris suninstall program with the tip command. For more information, see the man page, tip(1).

Note –

To navigate through the text, use Control-U to move up a page and Control-D to move down a page.

SPARC: Performing an Installation or Upgrade With the Solaris suninstall Program

You can either install or upgrade the Solaris operating environment on your SPARC system by using the Solaris suninstall program on the Solaris Software 1 of 2 CD. You cannot install any additional software with the Solaris suninstall program.

Ensure that you have the following CDs:

SPARC: Task Map: Performing a Solaris suninstall Program Installation

Table 18–1 SPARC: Task Map: Performing a Solaris suninstall Program Installation

Task 

Description 

For Instructions 

Gather the necessary information. 

Follow the checklist and complete the worksheet to be sure that you have all of the information you need to install the Solaris software. 

Chapter 6, Gathering Information Before Installation or Upgrade (Planning)

(Upgrade only) Prepare to upgrade the system. 

Back up the system. 

System Administration Guide: Devices and File Systems

(Optional) Preconfigure system configuration information. 

Use the sysidcfg file or the name service to preconfigure installation information for a system, for example locale. Preconfiguring system information prevents the installation program from prompting you to supply the information during the installation.

Chapter 7, Preconfiguring System Configuration Information (Tasks)

(Optional) Set up the system to install from the network. 

To install a system from a remote Solaris Software SPARC Platform Edition CD image, you need to set up the system to boot and install from an install server or boot server.

Chapter 15, Preparing to Install From the Network With CD Media (Tasks)

Install or upgrade. 

Boot the system and follow the prompts to install or upgrade the Solaris software. 

SPARC: To Perform an Installation or Upgrade With the Solaris suninstall Program

(Upgrade only) Perform post-upgrade task. 

Correct any local modifications that were lost during the upgrade. 

Solaris suninstall Program Post-Upgrade Task

SPARC: To Perform an Installation or Upgrade With the Solaris suninstall Program

  1. Decide if you want to install the software by using a CD-ROM drive or by using a net image.

    • If you're using a CD-ROM drive, insert the Solaris Software 1 of 2 SPARC Platform Edition CD

    • If you're using a net installation image, change directories to where the installation media is located, as in the following example. You might need to check with your network administrator for the location. The following command is an example.


      % cd /net/install-svr/export/Solaris_9/sparc

  2. Boot the system.

    • If the system is new, out-of-the-box, turn on the system.

    • If you want to install or upgrade an existing system, shut down the system.

      • To boot from the local CD, type the following command.


        ok boot cdrom

      • To boot from an install server on a network, type the following command.


        ok boot net

    The Solaris suninstall program begins.

  3. If you are prompted, answer the system configuration questions.

    If you preconfigured all of the system configuration information, the Solaris suninstall program does not prompt you to enter any configuration information.

    If you did not preconfigure the system configuration information, use the Worksheet for Installation or the Worksheet for Upgrading to help you answer the system configuration questions.

  4. Follow the instructions on the screen to install the Solaris software on the system.

    • If you are not installing a Solaris Flash archive, complete the installation. If you are upgrading or need to install additional software, proceed to Step 5.

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

      After the installation is finished, installation logs are saved in a file. You can find the installation logs in the following directories.

      • /var/sadm/system/logs

      • /var/sadm/install/logs

    • If you are installing a Solaris Flash archive, continue.

    1. On the Flash Archive Retrieval Method screen, select the location of the Solaris Flash archive.

      The Solaris suninstall program installation prompts you to proceed, depending on the media you selected.

    2. Type the information that you are prompted to enter.

      Media Selected 

      Prompt 

      HTTP 

      Specify the URL and proxy information that is needed to access the Solaris Flash archive. 

      FTP 

      Specify the FTP server and the path to the Solaris Flash archive. Specify the user and password information that allows you access to the FTP server. Specify any proxy information that is needed to access the FTP server. 

      Network File System 

      Specify the path to the network file system where the Solaris Flash archive is located. You can also specify the archive file name. 

      Local file 

      Specify the path to the local file system where the Solaris Flash archive is located. 

      Local tape 

      Specify the local tape device and the position on the tape where the Solaris Flash archive is located. 

      Local device 

      Specify the local device, the path to the Solaris Flash archive, and the type of file system on which the Solaris Flash archive is located.  

    3. On the Flash Archive Selection screen, you can install an additional Solaris Flash archive by selecting New. If you do not want to install additional archives, press Continue to complete the installation.

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

    After the installation is finished, installation logs are saved in a file. You can find the installation logs in the following directories.

    • /var/sadm/system/logs

    • /var/sadm/install/logs

  5. If you are upgrading the Solaris software, you might need to correct some local modifications that were not preserved. For detailed instructions, refer to Solaris suninstall Program Post-Upgrade Task.

  6. (Optional) To install additional software, refer to System Administration Guide: Basic Administration.

x86: Performing an Installation or Upgrade With the Solaris suninstall Program

You can either install or upgrade the Solaris operating environment on your x86 system by using the Solaris suninstall program on the Solaris Software 1 of 2 CD. You cannot install any additional software with the Solaris suninstall program.

Ensure that you have the following CDs:

x86: Performing a suninstall Installation Task Map

Table 18–2 x86: Performing an Interactive Installation Task Map

Task 

Description 

For Instructions 

Gather the necessary information. 

Follow the checklist and complete the worksheet to be sure that you have all of the information you need to install the Solaris software. 

Chapter 6, Gathering Information Before Installation or Upgrade (Planning)

(Upgrade only) Prepare to upgrade the system. 

Back up the system. 

System Administration Guide: Devices and File Systems

(Optional) Preconfigure system configuration information. 

You can use the sysidcfg file or the name service to preconfigure installation information (for example, locale) for a system so the installation program does not prompt you to supply the information during the installation.

Chapter 7, Preconfiguring System Configuration Information (Tasks)

(Optional) Set up the system to install from the network. 

To install a system from a remote Solaris Software x86 Platform Edition CD image, you need to set up the system to boot and install from an install server or boot server.

Chapter 15, Preparing to Install From the Network With CD Media (Tasks)

Install or upgrade. 

Boot the system and follow the prompts to install or upgrade the Solaris software. 

x86: To Perform an Installation or Upgrade With the Solaris suninstall Program

(Upgrade only) Perform post-upgrade task. 

Correct any local modifications that were lost during the upgrade. 

Solaris suninstall Program Post-Upgrade Task

x86: To Perform an Installation or Upgrade With the Solaris suninstall Program

  1. Decide if you want to install the software by using the CD-ROM drive or by using a net image.

    • If you're using a CD-ROM drive, insert the Solaris Software 1 of 2 x86 Platform Edition CD.

    • If you're using a net image, change directories to where the installation media is located. You might need to check with your network administrator for the location. The following command is an example.


      % cd /net/install-svr/export/Solaris_9/x86

  2. Decide how to boot the system.

    • If you boot from the Solaris Installation CD, insert the CD. Your system's BIOS must support booting from a CD.

    • If you boot from the network, use Preboot Execution Environment (PXE) network boot. The system must support PXE. Enable the system to use PXE by using the system's BIOS setup tool or the network adapter's configuration setup tool.

    • If you boot from a diskette, insert the Solaris Device Configuration Assistant x86 Platform Edition diskette into the system's diskette drive.

      x86 only –

      You can copy the Device Configuration Assistant software to a diskette from the Solaris x86 Platform Edition DVD or Solaris Software 2 of 2 x86 Platform Edition CD by using the procedure in Appendix I, x86: Preparing to Boot From the Solaris Device Configuration Assistant or the Network (Tasks).

  3. Boot the system by shutting it down and then turning it off and on.

    A memory test and hardware detection are executed. The screen refreshes.

    • If you are using the Solaris Software 1 of 2 x86 Platform Edition CD and Solaris Software 2 of 2 x86 Platform Edition CDs, the following message appears. 


      SunOS - x86 Platform Edition   Primary Boot Subsystem, vsn 2.0

      Then, information similar to the following test appears.


      SunOS Secondary Boot version 3.00


             Solaris x86 Platform Edition Booting System


Running Configuration Assistant...

    • If you are using PXE network boot to boot from the network, the following message appears. 


      Solaris network boot...

      Then, information similar to the following text appears.


      SunOS Secondary Boot version 3.00


             Solaris x86 Platform Edition Booting System


Running Configuration Assistant...

    • If you are using the Solaris Device Configuration Assistant x86 Platform Edition diskette, the following appears.


      Solaris Boot Sector                          Version 1

      Then, information similar to the following text appears.


      Solaris for x86 - FCS DCB                     Version 1.242






                       loading /solaris/boot.bin

      The screen refreshes and information similar to the following text appears.


      SunOS Secondary Boot version 3.00


             Solaris x86 Platform Edition Booting System


Running Configuration Assistant...

  4. When the Solaris Device Configuration Assistant screen appears, press F2_Continue.

    The Bus Enumeration screen appears with the message:


    Determining bus types and gathering hardware configuration data ...

    The Scanning Devices screen appears. System devices are scanned. When scanning is complete, the Identified Devices screen appears.

  5. Decide if you need to make any changes.

    • Press F2_Continue to make no changes.

    • Select changes and press F4.

    The Loading screen appears and contains messages about drivers that are loaded to boot your system. After a few seconds, the Boot Solaris screen appears.

  6. On the Boot Solaris screen, select CD, Net, or Disk and press F2_Continue.

    The Solaris suninstall program checks the default boot disk for the requirements to install or upgrade the system.

    Note –

    If you want to preserve an existing Service partition on your system, choose the appropriate option from the Create Solaris fdisk Partition screen. For more information on preserving the Service partition, see x86: Change in Default Boot-Disk Partition Layout.

    If you restored the Service partition on your system before you started the installation, you might not be able to upgrade to the Solaris operating environment.

  7. If you are prompted, answer the system configuration questions.

    After a few seconds, the Solaris Installation Program screen appears.

  8. Press F2_Continue.

    The kdmconfig – Introduction screen appears.

  9. Press F2_Continue.

    The kdmconfig - View and Edit Window System Configuration screen appears.

  10. (Optional) Examine the configuration information on the kdmconfig – View and Edit Window System Configuration screen and make any changes you need.

  11. When you are finished, select No changes needed – Test/Save and Exit, and press F2_Continue.

    The kdmconfig Window System Configuration Test screen appears.

  12. Press F2_Continue.

    The screen refreshes and the kdmconfig Window System Configuration Test palette and pattern screen appears.

  13. Move the pointer and examine the colors that are shown on the palette to ensure that they are displayed accurately.

    • If the colors do not display accurately, click No. If possible, press any key on the keyboard, or wait until kdmconfig exits the kdmconfig Window System Configuration Test screen automatically. Repeat Step 10 through Step 13 until the colors are displayed accurately and you can move the pointer as expected.

    • If the colors display accurately, click Yes.

    The Solaris suninstall program begins.

  14. If you are prompted, answer any remaining system configuration questions.

    • If you preconfigured all of the system configuration information, the Solaris suninstall program does not prompt you to enter any configuration information.

    • If you did not preconfigure the system configuration information, use the Worksheet for Installation or the Worksheet for Upgrading to help you answer the system configuration questions.

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

    Note –

    If you are using PXE from a network to boot, select manual reboot. You must ensure that the system does not boot from the network when it reboots. To disable network boot, during the reboot use the system's BIOS setup tool or network adapter's configuration setup tool.

  16. Follow the instructions on the screen to install the Solaris software on the system.

    • If you are not installing a Solaris Flash archive, complete the installation. If you are upgrading or need to install additional software, proceed to Step 17.

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

      After the installation is finished, installation logs are saved in a file. You can find the installation logs in the following directories.

      • /var/sadm/system/logs

      • /var/sadm/install/logs

    • If you are installing a Solaris Flash archive, continue.

    1. On the Flash Archive Retrieval Method screen, select the location of the Solaris Flash archive.

      The Solaris suninstall program installation prompts you to proceed, depending on the media you selected.

    2. Type the information that you are prompted to enter.

      Media Selected 

      Prompt 

      HTTP 

      Specify the URL and proxy information that is needed to access the Solaris Flash archive. 

      FTP 

      Specify the FTP server and the path to the Solaris Flash archive. Specify the user and password information that allows you access to the FTP server. Specify any proxy information that is needed to access the FTP server. 

      Network File System 

      Specify the path to the network file system where the Solaris Flash archive is located. You can also specify the archive file name. 

      Local file 

      Specify the path to the local file system where the Solaris Flash archive is located. 

      Local tape 

      Specify the local tape device and the position on the tape where the Solaris Flash archive is located. 

      Local device 

      Specify the local device, the path to the Solaris Flash archive, and the type of file system on which the Solaris Flash archive is located.  

    3. On the Flash Archive Selection screen, you can install an additional Solaris Flash archive by selecting New. If you do not want to install additional archives, press Continue to complete the installation.

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

    After the installation is finished, installation logs are saved in a file. You can find the installation logs in the following directories:

    • /var/sadm/system/logs

    • /var/sadm/install/logs

  17. If you are upgrading the Solaris software, you might need to correct some local modifications that were not preserved. For detailed instructions, refer to Solaris suninstall Program Post-Upgrade Task.

  18. (Optional) To install additional software, refer to System Administration Guide: Basic Administration.

Solaris suninstall Program Post-Upgrade Task

When you upgrade, the Solaris suninstall program merges local software modifications of the existing system with the new Solaris software. However, in some situations, merging is not possible. After you finish upgrading a system, you might need to correct some local modifications that were not preserved.

Caution – Caution –

Your system might not boot if you do not correct the local modifications that were not preserved.

To Correct Local Modifications After Upgrading

  1. Review the contents of the following file to determine whether you need to correct local modifications that the Solaris suninstall program could not preserve.

    /a/var/sadm/system/data/upgrade_cleanup

  2. Correct any local modifications that were not preserved.

  3. Reboot the system.


    # reboot