Preface

The Chorus0S 5.0 Installation Guide describes the procedures necessary for installing the Sun Embedded Workshop^TM development environment and helps you get started with building and booting a ChorusOS^TM system on a reference target board in one of the following supported target families:

• UltraSPARC^TM IIi/IIe

• Intel x86/Pentium

• Motorola PowerPC 750/74x0 processor family and PowerQUICC II (SBC8260) microcontrollers

• Motorola PowerQUICC I (MPC8xx)

Who Should Use This Book

This guide is intended for anyone who needs to install and manage ChorusOS hosts and targets.

Before You Read This Book

Read the relevant target information. See the following guides for more information:

• ChorusOS 5.0 Target Family Guide (SPARC Platform Edition)

• ChorusOS 5.0 Target Family Guide (Intel Platform Edition)

• ChorusOS 5.0 Target Family Guide (PowerPC Platform Edition)

• ChorusOS 5.0 Target Family Guide (MPC8xx Platform Edition)

How This Book Is Organized

This book is organized into two main parts as follows:

• Part I, Installing on the Host, describes how to install, uninstall, and patch the installation on the host.

  Chapter 1, Planning the Installation, provides an overview of the installation process and a list of host system requirements.

  
  

  Chapter 2, Installing the Sun Embedded Workshop Development Environment, describes how to install the Sun Embedded Workshop development environment for ChorusOS on a UltraSPARC host workstation.

  
  

  Chapter 3, Uninstalling on the Host, describes how to uninstall the ChorusOS product.

  
  

  Chapter 4, Patching the Installation, details necessary patches.

  
  

• Part II, Building and Booting a ChorusOS System, describes how to build and boot a ChorusOS system on supported targets.

  Chapter 5, Setting Up a Boot Server, describes how to configure a boot server with RARP and TFTP services.

  
  

  Chapter 6, How to Build and Boot a ChorusOS System for an UltraSPARC Target.

  
  

  Chapter 7, How to Build and Boot a ChorusOS System for an x86/Pentium Target.

  
  

  Chapter 8, How to Build and Boot a ChorusOS System for a PowerPC Target.

  
  

  Chapter 9, How to Build and Boot a ChorusOS System for an MPC8xx Target.

  
  

• Appendix A, Default File Locations and Directory Contents, lists the paths to specific directories that are created during the installation and gives a brief description of the purpose of each of these directories.

Related Reading

The About ChorusOS 5.0 Documentation guide introduces and describes all the books contained in the ChorusOS 5.0 documentation set.

The ChorusOS 5.0 Features and Architecture Overview provides an in-depth introduction to ChorusOS 5.0.

ChorusOS 5.0 System Administrator's Guide provides a single source of information for managing an installed ChorusOS system.

ChorusOS 5.0 Source Delivery Guide provides information about installing and deploying the source delivery of ChorusOS.

TCP/IP and Data Communications Administration Guide

SBC8260 Hardware Reference Manual

Ordering Sun Documents

Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.

For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at http://www1.fatbrain.com/documentation/sun.

Accessing Sun Documentation Online

The docs.sun.com^SM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://www.oracle.com/technetwork/indexes/documentation/index.html.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words, or terms, or words to be emphasized.	Read Chapter 6 in User's Guide. These are called class options.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#

Directory Conventions

The following table describes the directory conventions used in this book.

Table P-3 Directory Conventions

Directory	Description
download_dir	Directory containing the ChorusOS 5.0 download files.  Example: /home/user/downloads/ChorusOS_5.0/
extract_dir	Directory containing sufficient space to extract the delivery. This directory can be a local or an NFS mounted disk that has "write" permission.  Example: /home/user/extract/
install_dir	Directory where you install the ChorusOS product.  Example (also default): /opt/SUNWconn/SEW/5.0-processor_family where processor_family is one of the following: UltraSPARC, x86, PowerPC, MPC8xx Note that during installation you can choose an installation directory other than /opt/SUNWconn/SEW/. However, the 5.0-processor_family directory containing the ChorusOS directories and files is automatically created in the directory you specify.
build_dir	Directory where you configure and build the system image. This directory can be a local or an NFS mounted disk, but you must have "write" permission.  Example: /home/user/chorusos/build/
root_dir	Directory containing the ChorusOS file system.   Example: /install_dir/chorus-family/os/root where family can be one of the following, depending on the target family structure: usparc, x86, powerpc, mpc8xx