ChorusOS 5.0 System Administrator's Guide

Preface

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

This Guide contains information on using the ChorusOS 5.0 product, as part of the Sun Embedded Workshop software, and includes configuring and tuning information, with instructions on the configuration of the system image. The setting up and sharing of file systems are also explained.

The Guide gives full explanations of network commands and daemons, and advice on setting up the ChorusOS operating system for Ethernet and for PPP.

Information about installing the ChorusOS operating system is given in the ChorusOS 5.0 Installation Guide.

Who Should Use This Book

This book is intended for System Administrators of ChorusOS installations. Information is given in an accessible form and tasks are presented where possible in procedural form to assist the busy System Administrator in the management of ChorusOS installations.

Before You Read This Book

If you are setting up the ChorusOS operating system for the first time, you should read:

How This Book Is Organized

This book is divided into three principal parts:

Part I introduces the ChorusOS System Image. It provides you with essential information on system administration in the ChorusOS operating system environment, including information on configuring and tuning the system.

Part II focuses on file system administration. It provides procedural information on setting up file systems for devices physically attached to the target, and on how to set up NFS servers on the target system. File system commands and utilities are also explained, with examples.

Part III focuses on network administration. It cites the supported network components and gives procedural information on setting up an Ethernet connection and a PPP interface for the ChorusOS operating system. It also gives instructions for configuring ChorusOS as a gateway. Network administration commands and daemons are also explained.

Related Books

Ordering Sun Documents

The Sun Software Shop stocks select manuals from Sun Microsystems, Inc. You can purchase individual printed manuals and AnswerBook2^TM CDs.

For a list of documents and how to order them, visit the Software Shop at http://www.sun.com/software/shop/.

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.

What Typographic Conventions Mean

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. You must be root to do this.

Directory Conventions

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

Table P-2 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 the 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`
`mount_dir`	Directory on the host containing a file system you want to mount on a target. Example: `host`:/`install_dir`/chorus-`family`/os/root
`source_dir`	Directory containing the source files. Example: `install_dir`/chorus-`family`/src/

Note -

family is one of the following:

usparc for UltraSPARC IIi/III
x86 for Intel x86/Pentium
ppc60x for the Motorola PowerPC 60x and 750 processor family and the PowerQUICC II (mpc8260) microcontroller
mpc860 for the Motorola PowerQUICC I (mpc8xx) microcontroller.

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-3 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	`#`

Note -

In the code examples given in this book, the screen display

started pid

along with the corresponding incremented number, is not given. In the example below, this means that the 'started pid' and its incremental number, have been omitted from the text.

host% rsh <target> ls  started pid =pid_number

These incrementals have been removed from code examples for simplicity and consistency.