Chapter 3:

Installing UnixWare 7

This chapter explains how to install the UnixWare 7 operating system on your computer. Specifically, it covers:

"Responding to prompts"
 "The installation procedure"
 "Performing an upgrade installation"

Responding to prompts

Use these keys when responding to prompts for information during the first section of the installation (before software loading begins):

To:
Press:
Get help
F1
Toggle or display choices
F2
Read/write to media
F3
Configure advanced parameters
F6
Defer configuration
F8
Move back one window
F9
Move forward one window
F10
Move down
down arrow
Move up
up arrow
Move through selections
Tab
Select items in a list
Space
Accept an item
Enter
Enter an item
Enter
Erase the last character typed in response to prompts
Backspace or Ctrl-h

The installation procedure

Read "Before You Begin" and complete the installation checklists before installing UnixWare 7. Also see "Licensing Software" for information on license-based default package selections for each type of license.

Follow the procedure shown here to install UnixWare 7 Release 7.1.3 on your system:


Step 1. Before beginning any installation, make sure you have up-to-date backups of all the data currently on your system. Some of the options available during installation overwrite all the data on the hard disk, including user data and other partitions.
Step 2. The way you begin a fresh installation varies depending on whether you are installing from CD-ROMs or the network, and whether your system supports a bootable CD-ROM:
   a. To begin installation using a bootable CD-ROM and no diskettes: turn your computer on and insert the Base Operating System CD 1 (CD #1) into your system's bootable CD-ROM drive. If your system is already on, put CD #1 into the bootable CD-ROM drive and reboot the system.
   b. To begin installation using the installation diskettes and CD-ROMs: with the power off, insert the diskette labelled ``Installation Diskette 1 of 2'' into the diskette drive, and turn your system on. After the first Installation diskette is loaded, you will be prompted for the second diskette; remove the first diskette, insert the second diskette, and press Enter.
   c. To begin installation from a previously configured network server: with the power off, insert the diskette labelled ``Network Installation Diskette 1 of 2'' into the diskette drive, and turn your system on. After the first Network Installation diskette is loaded, you will be prompted for the second diskette; remove the first diskette, insert the second diskette, and press Enter.
 Regardless of the method you choose, once your system displays hardware information and the system logo, you'll be asked to set the installation language. Choose the desired language and press Enter. After a moment, the Welcome window appears.
Step 3. From the Welcome window:
   a. If you have an installation response diskette you saved from a prior UnixWare 7 installation, insert it and press F3. Press F10 to continue after the disk loads.
   b. If you do not have a response diskette, press F10 to continue.
Step 4. Using the answers that you recorded in the"Installation checklists", to enter zone, locale, and keyboard information in the next several windows.
Step 5. Enter licensing information and press F10, or press F8 to defer licensing and install the system with a 60-day evaluation license. See "Licensing Software" for more information. If you enter License information, you are then prompted for Registration information; see "Registration". Do one of the following:
Step 6. The system prompts you to load hardware configuration information. If you have no vendor-supplied HBA diskettes and are installing from CD-ROM or a network Install Server, select Proceed with Installation and press F10. Otherwise, select Install HBA diskette and press F10. You must insert HBA diskettes in the following order.
 1. Any vendor-supplied HBA diskette containing the host bus adapter driver for your system. You may or may not have such as diskette.
 2. Other vendor-supplied diskettes containing other drivers. These diskettes are also optional.
 3. The UnixWare 7 HBA diskettes 1 and 2. These diskettes are required for installations begun with boot floppies.

Follow the prompts untill all HBA diskettes are loaded. The first version of an HBA to be loaded takes precedence over any versions encountered on subsequent HBA diskettes. If you do not have any vendor supplied HBA diskettes, just load the UnixWare 7 diskettes.

After you have installed all your HBA diskettes, select Proceed with installation and press F10.
Step 7. At the Device Configuration Utility (DCU) window, you may choose to enter the DCU to configure hardware drivers.
 After you choose one of the above, the system displays the detected or selected drivers as it installs them.
 It is recommended that you only configure those devices needed to install UnixWare 7 during the installation process. You can run the DCU after the system is installed to configure additional peripherals.
 Enter the node name of the system and press F10. Do not enter a fully-qualified node name (including the domain); the domain name is entered later during network configuration.
Step 8. At the Installation Method window, select one of the following:

 Install from CD-ROM. Insert the CD-ROM into the drive and press F10.
 Install from TCP network server. Press F10 to continue.
Step 9. Configure up to two detected hard disks. Use the Tab key to select the disk to configure, then press F2. Select one of:

 Use the whole disk for UNIX to use the entire disk for UnixWare 7 and remove any pre-existing data on other partitions.
Customize disk partitions to edit the partitions table or preserve pre-existing partitions. Enter the information from the "Partitions checklist and notes" and press F10 when done.
Do not modify, to skip modification of the second disk. This option does not appear for the first disk.

You can also select Re-load partition information from disk to restore the configuration on your hard disk to what it was when you started the installation. After you make your selections for both hard disks, press F10.
Step 10. Choose whether or not to customize filesystems and slices. (For a description of filesystem defaults, see the "Filesystems notes".) Select one of the following and press F10:


Step 11. Choose whether or not to customize special disk operations.

Resetting the disk geometry will remove all data on your disk, including data in non-UNIX partitions. This option is not enabled by default and should be used with extreme caution. Select one of the following and press F10:

 Use default disk options

Customize disk options
Step 12. Choose a system profile:
Step 13. If you did not perform a networked installation, but did select networking packages, the system attempts to detect a network adapter.
Step 14. Choose one of the following to select an adapter or defer configuration:

 Use the detected adapter shown above
 Select from the detected adapters shown above
 Select from the full list of supported adapters
 Defer network configuration
 Enter the network card configuration parameters from the "Network adapter checklist" and press F10 when done. In the next several windows, enter network configuration information from the "TCP/IP checklist" and the "Network Information Server checklist", as appropriate.

It is recommended that you do not defer network configuration. If you defer TCP/IP configuration, NIS configuration is automatically deferred.


Step 15. In the windows that follow, enter date and time, security level, system owner, and root (superuser) data, taking the information from the "General installation checklist".
 Do not forget the root password. To restore a forgotten root password, you must reinstall your system.
Step 16. View the license terms, select Accept, and press F10 to continue.
Step 17. You are prompted to continue the installation, deleting any data in the active partition and (depending on which special disk options you chose) possibly other partitions as well. At this point, you can:
Step 18. After you confirm that you want to install the software on your system, the software load begins after any disk setup or badtracking. Software load is the longest stage of the installation. You can track the progress of the installation by viewing the progress indicator.
 After the software is loaded, the kernel (/stand/unix) is rebuilt. This takes several minutes.
Step 19. After you see a message indicating that the kernel was rebuilt successfully, remove all diskettes, tapes, and CD-ROMs from the various drives on your system and press any key to reboot.
Step 20. After the system reboots, enter mouse configuration information.
 After you choose the mouse type and number of buttons, you proceed to the mouse test. Verify the mouse is functional by moving the mouse and pressing a mouse key.
 If the mouse is configured successfully, the installation continues. If it is not, you move back to the Mouse Configuration window.
Step 21. You are prompted to insert the Updates CD #2. Default selections matching your license are automatically highlighted for installation. You can override these defaults by selecting or de-selecting products. You can also defer installing this CD until a later time.
Step 22. After installing (or deferring) CD #2, you are prompted to insert the Optional Services CD #3. Select the products you want to install from the menu. You can also defer installing this CD until a later time.
Step 23. If you selected the Linux Kernel Personality for installation from CD #2, you are now prompted to insert the OpenLinux 3.1.1 Distribution CD #4, Once you insert it and press Enter, you are asked to choose an installation profile for OpenLinux 3.1.1. See "Installing the Linux Kernel Personality" for a desription of the OpenLinux installation profiles. Once you choose a profile and press Enter, the OpenLinux software is copied from the CD. Once the sofware is installed, configuration scripts for various utilities and packages are run. When a message is displayed indicating that Linux Kernel Personality installation is complete, press F10.
Step 24. The system automatically boots into multi-user mode (if you installed software from CD #2 or CD #3, the kernel is first rebuilt). The graphical login screen should appear on the system console.
Step 25. You can now log in to the system and add additional packages from the other CDs (such as the UnixWare 7 Development Kit CD-ROM, Skunkware, and the Supplementary Linux Software CD). See "CD-ROM Contents" for a list of the packages included on each of the UnixWare 7 CDs. For information on first-time setup tasks, including installing software from CD #2 and CD #3, see "After you install".

Installing the Linux Kernel Personality

By default, the Linux Kernel Personality (LKP) is installed as part of the UnixWare 7 installation process. Alternatively, you can de-select the LKP so that the LKP is excluded from the UnixWare 7 installation, and manually install the LKP at a later time.

The Installation CD #1 contains the base operating system and includes files that are necessary to support the LKP. These files are installed automatically as part of the installation process.

The Updates CD #2 contains the lxcompat package set that contains the LKP software as well as lkpdoc, the online LKP documentation.

If you do not install LKP as part of installation or upgrade, do the following to add it to your running system:


Step 1. Place the Updates CD #2 into the CD-ROM drive and enter:
 
/usr/bin/lkpinstall
A package selection screen is presented and you can select the package(s) you want to install. The LKP package(s) are then installed.
Step 2. When the LKP packages have finished installing, you are prompted to remove the second CD, and place the OpenLinux CD #4 in the CD-ROM drive. The CD is mounted automatically. You are prompted to select an installation profile. The installation profiles are:
 (Recommended) Installs all of the non-commercial software available on the OpenLinux CD.
 Installs packages best suited for creating a web server.
 Installs a set of packages best suited for creating a dedicated file and print server.
 Installs a generic set of services, such as DHCP, NNTP, Sendmail, and FTP, for creating a basic network server.
 Installs a basic OpenLinux system. It is intended to be used as the base for a highly customized server.
Step 3. When all packages from the OpenLinux CD have been installed and configured, you can review the results in:
 
/linux/var/tmp/lxrpms.log
 
/linux/var/tmp/lxrpms.err

You will need at least 128 MB RAM to use the LKP effectively. Installing all packages (recommended) from the OpenLinux distribution (available on a separate CD-ROM) requires approximately 1.5 GB of disk space in the root filesystem.

Auditing cannot provide audit records for Linux mode activities on your system. See "Switching auditing on" for more information.

Configuring a TCP network installation

Follow this procedure when you choose Install from TCP server in Step 8 on page 57 to install Release 7.1.3 from a previously configured Install Server:


Step 1. From the Configure Network Installation Server window, choose Configure Networking Hardware.
Step 2. The system attempts to detect a network adapter on your system.
 From the Adapter Selection window, select a network adapter. Choose one of the following:
 Use the detected adapter shown above
 Select from the detected adapters shown above
 Select from the full list of supported adapters
Step 3. Insert the appropriate network utilities diskette and press Enter.
Step 4. Enter the required configuration parameters for the selected adapter from the"Network adapter checklist". Pressing F2 presents a list of valid choices for each parameter. When you finish entering all parameters, press F10.
Step 5. Choose Configure Networking Protocol. The TCP/IP configuration window appears.
Step 6. Enter the configuration parameters from the"TCP/IP checklist". Press F10 when done.
Step 7. If the network adapter you chose is configured correctly and the Install Server responds to your request, return to the main installation procedure at Step 9 on page 58.
 If the Install Server is unreachable, you may need to reconfigure the protocol parameters to, for example, specify a different server address.

Manually selecting sets, services, and packages

Follow this procedure if you chose Customize Installation of Packages in Step 12 on page 59.


Step 1. Select a set to configure from the list and press F10.
 Each set is made of several services, which in turn consist of individual packages. Each service is set to be partially installed (PART), fully installed (FULL), or not installed (OFF) according to the terms of the operating system edition license you entered previously.
Step 2. Highlight the service you want to customize and press F2. Choose to:
 Select individual packages
Select all packages (FULL)
Select no packages (OFF)

Step 3. For each package, press the space bar to toggle the selection on or off. Press PgUp and PgDn to move through the complete list of packages.
 When done making selections, press Enter.
Step 4. Repeat the previous step for each service you want to configure. When done configuring all services, press F10.
Step 5. Highlight another set to configure, and repeat steps 1 to 4.
 When you finish configuring sets, select Accept current selections and continue and press F10.
Step 6. If a package you select has dependencies on a package you de-selected, you are prompted to choose one of the following:
 Resolve Dependencies Automatically
 View List of Needed Packages
 Return to Service/Package Selection
Step 7. After you resolve any dependency issues, rejoin the main installation procedure at Step 13 on page 59.

Performing an upgrade installation

Use the Upgrade Wizard to upgrade your UnixWare 7 Release 7.1.1 or Open UNIX 8 Release 8.0.0 system to UnixWare 7 Release 7.1.3.

How the Upgrade Wizard works

When you upgrade your system, the Upgrade Wizard intelligently maps default software selections to your base license and the software you previously installed. If you accept the default selections throughout the upgrade procedure, your system will contain all of the available software upgrades that apply to your particular installation.

You can also modify these default selections, by de-selecting unwanted software or adding software you had not previously installed, during the software selection phase of the Upgrade Wizard.

To ensure the correct functioning and supportability of your upgraded system, the Upgrade Wizard always upgrades components from the Updates CD-ROM if they already exist on your system. For example, the X11 packages will be upgraded automatically (without the option to de-select the upgrade) when you run the Upgrade Wizard to install Release 7.1.3.

In addition, the UpdateSet package is automatically installed when you run the Upgrade Wizard, including on subsequent invocations if the Wizard detects that the package needs to be re-applied.

Finally, any Host Bus Adapters (HBAs) present on your system are also upgraded if newer versions appear on the Updates CD-ROM.

If the Upgrade Wizard has already been used to update the system, you may add additional software (or reinstall software already added) from the Updates CD #2 to your Release 7.1.3 system, by placing CD #2 in the primary CD drive and entering: 

pkgadd -d cdrom1

The above command will display a list of all the installable packages on the CD. You can also use the scoadmin application installer to install packages from the Updates CD.

The upgrade procedure

To upgrade your system from the Updates CD #2:


Step 1. Enter pkginfo -l uli to determine if the latest version of the Upgrade Wizard is already installed. The latest version will have update713 in the PSTAMP variable of the pkginfo output. If the latest version is not installed, install it from the Release 7.1.3 Updates CD #2 or a previously configured Network Install Server.
   a. To install from the CD, insert the CD into the drive and enter: pkgadd -d cdrom1 uli.
   b. To install from a previously configured network Install Server, enter: pkginstall -s server uli, where server is the node name or IP address of the Install Server.
Step 2. Start the Upgrade Wizard:
Step 3. The Welcome window appears. Use the following buttons to navigate the Upgrade Wizard and get help:

 Previous
Next
Cancel
Help
Select Next to proceed.
Step 4. Read the software license agreement and select Accept if you agree with its terms.
Step 5. The Upgrade Wizard attempts to detect the type of Edition License that is currently installed on your system. If it cannot find your current license information, you will need to enter the License Number, License Code, and License Data from your original Edition License (the license with which you originally installed Release 7.1.1 or Release 8.0.0). Select Next after you enter the required data. Run the License Manager if you are prompted for this information (see "Starting The License Manager") and use the License-View command to see the current Edition License information.
Step 6. If you are upgrading an Open UNIX 8 Release 8.0.0 system, skip to Step 7. If you are upgrading a Release 7.1.1 system, enter your upgrade License Number, License Code, and License Data; then, select Next.
Step 7. If there is more than one CD-ROM drive on your system, choose the drive from which to install; select Next.
Step 8. When prompted, insert the Updates CD #2 in the CD-ROM drive you specified and select Next.
 The CD-ROM is verified and read, and the UpdateSet is installed at this time. Following the installation of the UpdateSet, you will be directed to reboot your system.
Step 9. The software selection window for this CD-ROM appears.
 Default selections are already selected for upgrade based on the following:
 You can:
 Select Next when done selecting software.
Step 10. The selected software is displayed. Select Next to install this software, or Previous to go back and alter your selections.

After you select Next, you cannot return to the software selection window for this CD-ROM. Please be certain that the software you selected is the software you want to install.


Step 11. Each package is installed onto your system. If the package requires user input, follow the prompts and enter the required data. When the Upgrade Wizard finishes loading all packages, proceed to the next step.
 If you chose to add non-default packages that are not enabled by your License Edition, the software is installed with a 60-day evaluation license. Contact your vendor to purchase a full license if you decide to continue to use this software; then use the License Manager to apply the new license. See "License Editions" and "Using the License Manager".
Step 12. When prompted, insert the Optional Services CD #3 in your CD-ROM drive; then select Next. The CD-ROM is verified and read.
Step 13. Select software as you did in step 10 on "The software selection window for this CD-ROM appears.", then select Next when finished.
Step 14. Select Previous to alter your software selections. Select Next to install the selected software from the Optional Services CD; you will be prompted for information appropriate to each application (such as licenses and configuration information) as they are installed.
Step 15. If you selected the Linux Kernel Personality for installation, you will be prompted to insert the OpenLinux CD #4. See "Installing the Linux Kernel Personality" for information on choosing a Linux installation profile. After this CD is installed, the upgrade continues with the next step.
Step 16. Select Finish to exit the Upgrade Wizard.
 The Wizard informs you if it is necessary to re-boot your system so that the changes you made can take effect.

After you upgrade your system, you should immediately re-create your emergency recovery media. See Installation and Licensing in the online help on http://localhost:8458 for instructions.

© Copyright 2003 Caldera International, Inc. All Rights Reserved.