Chapter 2 Installing the Sun Embedded Workshop Software

This chapter describes how to install the Sun Embedded Workshop software for ChorusOS on a host workstation running the Solaris operating environment. This chapter assumes that you have either a CD-ROM containing the product or have downloaded the necessary files in a download directory such as /home/user/downloads/ChorusOS_5.0 (called the download_dir).

You can install the Sun Embedded Workshop software using one of the following proceduresS:

• "Installing With the Sun Embedded Workshop Graphical Installer"

• "Installing With the pkgadd Utility"

• "Setting Environment Variables"

• "extract.sh Options"

Installing With the Sun Embedded Workshop Graphical Installer

The Sun Embedded Workshop graphical installer is based on the Solaris Web Start Wizards API. To use the graphical installer, you need the superuser password for your system and JDK (version 1.2 or higher). To add JDK to your path, use the following example command:

$ export PATH=/set/java/jdk1.2/bin:$PATH

If you are installing from the CD-ROM, use the File Manager on your desktop to browse the CD-ROM; double-click the installer executable to launch the graphical installer and go to Step 3 of the following procedure.

If you have downloaded the product, go to Step 1 of the following procedure.

To Install With the Sun Embedded Workshop Graphical Installer

1. Create a directory where you have permission and enough space to extract all the files in the delivery.

   The minimum amount of free space required is specified in the section "Host System Requirements".

   $ mkdir extract_dir $ cd extract_dir

   ---

   Note -

   This directory is temporary and will be removed after the installation.

   ---

2. Run the extract.sh script:

   $ sh download_dir/part_number/extract.sh

   ---

   Note -

   For information on the options available with the extract.sh script, use the following command:

   $ sh download_dir/part_number/extract.sh -help

   See "extract.sh Options" for more information.

   ---

3. Enter the superuser password for the host workstation when prompted.

   Please enter this system's root user password. Password: superuser_password

   The graphical installer in this release uses the Solaris package system, including utilities such as pkgadd(1M), to manage installation and dependencies. Solaris package tools require that you become superuser to install packages.

   After initialization finishes, the graphical installer is displayed.

4. Follow the instructions displayed on the Solaris Web Start Wizards screens.

   ---

   Note -

   In the Installation Directory panel, do not choose an NFS directory.

   ---

   If you choose the "Default Install" for a particular target family, the following components of the ChorusOS 5.0 product are installed:

   • The Microkernel component, required to build the microkernel of the system image.

   • The OS component, required to include POSIX-compatible APIs in a system image.

   • The Tools component, required to use the cross-development tool chain for building target system executables on the host workstation.

   • The BSP source files, source files required for board-specific support.

   • The GDB Debugger component, the reference debugger for ChorusOS systems and the Insight graphical interface to GDB.

   • Documentation in PDF and HTML.

   • Online man pages.

5. Exit the graphical installer after you have finished installing the software.

   Log files from the installation are saved in the directory /var/sadm/install/logs.

6. Set environment variables.

   See "Setting Environment Variables".

You may perform the installation procedure as many times as necessary. This is especially useful if you want to install extra components after the initial installation.

If you install any packages of the core delivery, excluding documentation and third-party software, subsequent installations always place files under the install_dir, which is the directory you select during the first installation.

If you decide to reinstall core software packages in another location, you must first remove all the installed packages. See Chapter 3, Uninstalling on the Host, for information on removing installed packages.

Installing With the pkgadd Utility

The pkgadd(1M) allows you to install the Sun Embedded Workshop software as a series of packages on the host workstation. You must have the superuser password for your system.

If you are installing from the CD-ROM, change to the directory containing the packages. For example: /dev/cdrom/part_number/chorus-family/pkgs. Then go to Step 3.

If you have downloaded the product, go to Step 1 of the following procedure.

To Install With the pkgadd Utility

1. Create a directory (extract_dir) where you have permission and enough space to extract all the files in the delivery.

   The minimum amount of free space required is specified in the readme.html. For example:

   $ mkdir extract_dir $ cd extract_dir

2. Run the extract.sh script to extract all the packages:

   $ sh download_dir/part_number/extract.sh -only

   ---

   Note -

   For information on the options available with the extract.sh script, use the following command:

   $ sh download_dir/part_number/extract.sh -help

   See "extract.sh Options" for more information.

   ---

   The packages are extracted and stored in a directory structure similar to this: extract_dir/part_number/chorus-family/pkgs/SUNWxxxx

   where family can be one of the following: mpc8xx, powerpc, usparc, or x86.

3. Install the packages using one of the following methods:

   • To install all the packages for a particular part number together, use one of the following commands:

     • For the downloaded product:

       $ su Password: superuser_password # pkgadd -d extract_dir/part_number/chorus-family/pkgs all

     • For the CD-ROM:

       $ su Password: superuser_password # pkgadd -d /dev/cdrom/part_number/chorus-family/pkgs all

   • To install one package at a time for a particular part number, use one of the following commands:

     • For the downloaded product:

       $ su Password: superuser_password # pkgadd -d extract_dir/part_number/chorus-family/pkgs SUNWxxxx

     • For the CD-ROM:

       $ su Password: superuser_password # pkgadd -d /dev/cdrom/part_number/chorus-family/pkgs SUNWxxxx

4. Set the environment variables.

   See "Setting Environment Variables".

You can perform the installation procedure as many times as necessary. This is especially useful if you want to install extra components after the initial installation.

Setting Environment Variables

Use the information in the following table to set environment variables on the host workstation:

Verify that the environment variables MANPATH and PATH are set correctly, try the following command:

$ man ChorusOSMkMf
Reformatting page.  Wait... done

Misc. Reference Manual Pages                    ChorusOSMkMf(1CC)

NAME
   ChorusOSMkMf - Create a Makefile from an Imakefile for ChorusOS
...
$ ChorusOSMkMf
usage: ChorusOSMkMf build-config-dir|paths-file [-s source-dir]
[-b build-dir] [-d dist-dir]

extract.sh Options

The following options are available with extract.sh:

$ sh installer