ChorusOS 5.0 Installation Guide

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

Note -

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".


Note -

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.