2 Solaris OpenStep^TM Installation

This chapter describes how to install operating system packages and patches needed to run Solaris OpenStep, and how to install the Solaris OpenStep software.

• Installation Summary
• Mounting Files From a CD-ROM
• Determining the Solaris Version
• Installing the Solaris 2.4 Packages and Patches
• Installing the Solaris 2.5 Patches
• Installing the Solaris OpenStep Software

Installation Summary

Installing the Solaris OpenStep Software and configuring the OpenStep environment involves the following steps. Detailed information on each step is covered in the following pages.

1. Installation preparation:

Ensure that each computer meets the minimum hardware and software requirements as summarized in Chapter 1, "Before You Begin."

2. Mount the Solaris OpenStep CD-ROM:

If the computer you are installing OpenStep on has a CD-ROM drive attached, mount the Solaris OpenStep CD-ROM locally as described in "Mount the CD-ROM Locally."

If the computer you are installing OpenStep on does not have a CD-ROM drive attached, but another computer on your network does, mount the OpenStep CD-ROM remotely as described in "Mount the CD-ROM Remotely."

3. Review the Release Notes:

After you have mounted the CD-ROM, please read the release notes contained in ReleaseNotes file.

4. Install Solaris and OpenWindows Packages and Patches

5. Install the Solaris OpenStep Software

6. Configure the OpenStep environment for each user:

This subject is discussed in Chapter 3, "Configuring and Starting the OpenStep Environment.

Mounting Files From a CD-ROM

• If the CD-ROM drive is attached to the computer selected for Solaris OpenStep installation, follow the procedures in "Mount the CD-ROM Locally."

• If the CD-ROM drive is attached to a remote computer, that is, a computer other than the one on which you are installing Solaris OpenStep, follow the procedures in "Mount the CD-ROM Remotely."

After you have mounted the CD-ROM, please read the files contained in the file /cdrom/solaris_openstep/ReleaseNotes. These files contain information and procedures that may affect your Solaris OpenStep installation.

Mount the CD-ROM Locally

1. Log in as root.

2. Mount the CD-ROM into the CD-ROM drive.

Depending on the type of CD-ROM drive, you will either place the CD-ROM in a caddy and insert the caddy into the drive, or the drive will accept the CD-ROM without a caddy. The CD-ROM is automatically mounted if the Volume Manager daemon (vold) is running.

3. Check for the presence of the vold daemon as follows:

# ps -ef | grep vold
root 168 1 80 16:01:59 ? 0:01 /usr/sbin/vold

If vold is not running, start it by entering:

# /usr/sbin/vold &

Mount the CD-ROM Remotely

1. Mount the CD-ROM, as described in the previous section, in the remote computer's CD-ROM drive.

2. Log in as root (su root) on the remote computer.

a. Edit the /etc/dfs/dfstab file and add the following line:

# share -F nfs -o ro /cdrom/cdrom0

Note - Because the cdrom0 subdirectory is a symbolic link to the name of the directory on the CD-ROM drive, these instructions work for any CD-ROM.

b. Check that the mountd daemon is running by typing the command:

# ps -ef | grep mountd

root 125 1 80 16:01:46 ? 0:19 /usr/lib/nfs/mountd

c. If the mountd daemon is running, finish exporting the files by typing the command:

# shareall

If the mountd daemon is not running, notify any users of the system that NFS services will be momentarily interrupted, and then type the following commands to stop the NFS services and restart them.

# /etc/rc3.d/S15nfs.server stop

# /etc/rc3.d/S15nfs.server start

The NFS services are stopped and restarted and the CD-ROM files are exported.

3. On the local computer type the command:

# ls /cdrom

If no message is displayed other than the system prompt, go to the next step.

If the message /cdrom: No such file or directory is displayed, create a mount point directory by typing the following command on the local computer:

# mkdir /cdrom

4. Access the files on the remotely mounted CD-ROM by typing the following command on the local computer:

# mount <remote-system-name>:/cdrom/cdrom0 /cdrom

The files from the remote system directory, /cdrom/cdrom0, are mounted on /cdrom. The cdrom0 subdirectory is symbolically linked to the actual CD-ROM.

Determining the Solaris Version

Before installing Solaris OpenStep, you need to install packages and patches to upgrade your operating system software. Which packages and patches you install depends on which version of Solaris is being used. To determine which Solaris version a machine is running, type the uname -a command. The output should look like:

SunOS janedoe 5.4 Generic_101945-10 sun4m sparc

SunOs 5.4 equates to Solaris 2.4.

If the machine on which you are installing Solaris OpenStep is running Solaris 2.4, then go to "Installing the Solaris 2.4 Packages and Patches".

If the machine on which you are installing Solaris OpenStep is running Solaris 2.5, then go to "Installing the Solaris 2.5 Patches".

Installing the Solaris 2.4 Packages and Patches

Install the following packages and patches on machines running Solaris 2.4. If you are installing Solaris OpenStep on a machine running Solaris 2.5, then skip to "Installing the Solaris 2.5 Patches".

Installing the Solaris OS Patch

1. Log in as root (su root).

2. Change directory to
/cdrom/solaris_openstep/solaris_patches/101242-10

Or for a remotely installed CD:
/cdrom/solaris_patches/101242-10

There will be one or more patch subdirectories, each containing a specific patch and a README file. The README file describes what the patch is, how to install it, and also provides installation error messages, and recovery procedures in case of errors.

3. Check if the package is already on the system:
# pkginfo | grep libC

If it already on the system, type the command:
# pkgrm SUNWlibC

This removes the existing patch.

4. Type the command:
# pkgadd -d .

This will add the new package.

5. When you have completed installing the patch, reboot the computer.

Installing the OpenWindows Packages

1. If OpenWindows is running, quit OpenWindows.

2. Log in as root.

3. If you are installing from a remote CD-ROM and if the remote CD-ROM is not yet mounted on your machine, type the command:
# mount <remote-system-name>:/cdrom/cdrom0 /cdrom

4. Remove the old OpenWindows packages by typing the command
# pkgrm SUNWxwinc SUNWxwmod SUNWxwplt SUNWxwslb

Ignore any error messages. When the package removal has completed you can add the new package versions.

5. Change directory to
/cdrom/solaris_openstep/openwin-3.4_packages

Or for a remotely installed CD:
/cdrom/openwin-3.4_packages

6. Type the command
# pkgadd -d .

A list of the packages is displayed, and you are asked to select the packages you want to install.

7. Type all or press Return to install the OpenWindows packages.

Copyright information will be displayed, followed by a list of the files being installed. At various time he installation process will then ask permission to proceed. Answer y to all questions. Once the packages have been installed, a successful installation message is displayed.

8. Type q to quit pkgadd.

Installing the Solaris 2.4 OpenWindows Patch (Sparc 5s only)

Install the following patch only if you are using Solaris 2.4 on a Sparc 5:

1. Log in as root.

2. Change directory to
/cdrom/solaris_openstep/openwin_patches/101923-08

Or for a remotely installed CD:
/cdrom/openwin_patches/101923-08

3. Install the patch by typing
# ./installpatch .

You are now ready to install the Solaris OpenStep software. Skip to "Installing the Solaris OpenStep Software" to do this.

Installing the Solaris 2.5 Patches

If you are installing Solaris OpenStep on a machine running Solaris 2.5, then you will need to install the patches described in the following sections before you install Solaris OpenStep.

Note - If you are running Solaris 2.5.1 or later, you do not need to install the following patches.

Installing the Solaris 2.5 OpenWindows Patch

1. Log in as root.

2. Change directory to
/cdrom/solaris_openstep/openwin_patches/103246-03

Or for a remotely installed CD:
/cdrom/openwin_patches/103246-03

3. Install the patch by typing the command
#./installpatch .

Installing the Solaris 2.5/Sparc 5 Patch

Install the following patch only if you are using Solaris 2.5 on a Sparc 5.

1. Log in as root

2. Change directory to
/cdrom/solaris_openstep/openwin_patches/103073-01

Or for a remotely installed CD:
/cdrom/openwin_patches/103073-01

3. Install the patch by typing the command

# ./installpatch .

You can now install the Solaris OpenStep software. See the next section for installation instructions.

Installing the Solaris OpenStep Software

Note - The OpenStep software will be installed in /opt/SUNWdoe, and a link to this directory, named openstep, will be placed in /usr.

Installing the OpenStep Packages

1. Log in as root.

2. Change directory to
/cdrom/solaris_openstep

Or for a remotely installed CD:
/cdrom

3. Type the command:

# ./install

This command installs the following packages: SUNWOosUc, SUNWOosUs, SUNWOosUt, SUNWOosUd, SUNWOosUe, SUNWOosUh, SUNWOosUw, SUNWOosUx, SUNWOosUv.

You will be prompted for permission to continue for various reasons as the packages are installed. Answer y to continue at these prompts.

See "Setting OpenStep Environment Variables" to learn how to configure and run OpenStep under OpenWindows.

Installing the AnswerBook Packages (Optional)

1. Change directory to
/cdrom/solaris_openstep

Or for a remotely installed CD:
/cdrom

2. Type in the command:
# pkgadd -d . SUNWOabos

During AnswerBook installation, be prepared to provide the following information:

• The type of Installation. There are two types:

• Heavy - Hard disk installation. This takes up hard disk memory, but provides fast AnswerBook access. This type of installation is recommended.

• Light - CD-ROM disk access installation. This takes up minimal hard disk space (approximately 1 MByte), but provides slower AnswerBook access, and requires that the CD-ROM be mounted when AnswerBook is mounted.

If you have allocated space in /opt for the AnswerBooks, then we recommend that you do a heavy installation.

• The AnswerBook parent directory. Specify /opt as the AnswerBook parent directory.

Install the Print package (Optional)

Perform the following procedure for every computer that has a printer physically attached. While this package install is not mandatory, it ensures you will be able to access special options such as double-sided printing and variable print densities from the OpenStep desktop.

1. Log in as root.

2. Change directory to
/cdrom/solaris_openstep

Or for a remotely installed CD-ROM:
/cdrom

3. Type in the command:
# pkgadd -d . SUNWOosUp

The installation process will prompt you at various times for information, and permission to proceed. If you previously have not configured your printers, then you should use admintool (man(1M)) to configure them.

Installing the CDE Package

Install the OpenStep CDE package on each machine running the CDE environment.

1. Log in as root.

2. Change directory to
/cdrom/solaris_openstep

Or for a remotely installed CD:
/cdrom

3. Type in the command:
# pkgadd -d . SUNWOosUy

4. Review Xservers file.

This package will install an Xserver file in /etc/dt/config. If you had an existing Xservers file, it will be backed up. To reinstate options, such as multiple screens, you will need incorporate the changes from the old Xserver into the new one.

See "Configuring for CDE" to learn how to configure and run OpenStep under CDE.

Remote Server Installation

The following steps describe how OpenStep can be installed on a server. This installation may be remotely accessed by client machines, thus saving disk space on the client machines.

Server:

1. OpenStep must be installed on a server that has an OpenWindows installation. If the server is running Solaris 2.4 then the 3.4 OpenWindows packages must be applied - see "Installing the Solaris 2.4 Packages and Patches".

2. Install the Solaris OpenStep packages, as described in "Installing the OpenStep Packages". Please note that the volume management package (SUNWOosUv) does not need to be installed on the server.

3. Make sure the following server directories are shareable by each client:

• /opt/SUNWabos - contains the Solaris OpenStep AnswerBooks

• /opt/SUNWdoe - contains Openstep. Note that this directory needs the ability to run setuid programs if you want the user to be able to use the Preferences application to set date, time, and user password.

• /opt/SUNWPro - SPARCompiler Language System. This should be shareable only if WorkShop OpenStep is installed.

Each client should be able to mount these directories as read-only at boot time.

Client:

4. Set up the link /usr/openstep on each client machine to point to /opt/SUNWdoe/openstep, and install all the required patches.

5. Install the Solaris OpenStep volume management package (SUNWOosUv) on each client that needs to use removable media.

6. Once the clients have been configured to have access to OpenStep proceed with the user configuration described in Chapter 3.

Please note that OpenStep will not currently support multiple users running OpenStep simultaneously on the same machine.