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:
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.
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 |
This directory is temporary and will be removed after the installation.
$ sh download_dir/part_number/extract.sh |
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.
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.
Follow the instructions displayed on the Solaris Web Start Wizards screens.
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.
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.
Set 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.
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.
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 |
Run the extract.sh script to extract all the packages:
$ sh download_dir/part_number/extract.sh -only |
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.
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 |
Set the 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.
Use the information in the following table to set environment variables on the host workstation:
Environment Variable |
Add |
Description |
---|---|---|
MANPATH |
install_dir/chorus-doc/man |
Contains the path to online manual pages |
PATH |
install_dir/chorus-family/tools/host/bin |
Enables access to the host tool chain |
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] |
The following options are available with extract.sh:
Table 2-1 extract.sh Options