Chapter 3 Installing LynxOS x86 Native Development Systems

LynxOS Installation Guide

only

Installing LynxOS x86 Native Development Systems

Introduction

This chapter provides details about installing LynxOS for native development on x86 systems.

The term native development describes a scenario in which the LynxOS host system hardware configuration is the same as that of the target system.

The LynxOS ODE installation CD-ROM is ISO9660-based and can be mounted on any machine that supports the ISO9660 format.

Note: El Torito bootable CD-ROM is available for LynxOS x86 installations.

LynxOS native installations use the provided installit utility to configure the LynxOS installation to the host system hardware.

Additionally, the ODE CD-ROM contains tar images in /tar_images. From this mounted CDROM, users can extract the compressed images. Each tar file corresponds to an installation component.

Before Installation

Review the system requirements before beginning the installation (see "System Requirements"). Additionally, review the Hardware Support Guide (available from http://www.lynuxworks.com and the LynxOS Documentation CD-ROM) for a complete list of supported hardware.

Any existing data on the installation partition is overwritten during installation. Back up important files before installing LynxOS; see "Backing Up Existing Data" for further information.

Caution! LynxOS does not support upgrade installations.

LynxOS overwrites the contents of the disk (or partition) when installed. Any existing data on the installation space will be permanently lost.

Also see "Planning Hard Disk Partitions" below for more on hard disk partitioning as it pertains to LynxOS.

LynxOS must be configured to the target system hardware. Before installing LynxOS, the user needs to draw up a list of installed hardware; see the table "System Hardware Checklist" for further information.

Since the LynxOS installation process supports both serial terminals and graphical consoles, the installation process is text-based only; see "Installing a LynxOS x86 Native Development System" for additional information.

Planning Hard Disk Partitions

For most installations, there are no requirements for a hard disk to be partitioned. LynxOS allows partitions and file systems to span an entire IDE or SCSI hard disk. However, partitioning does provide a form of disk management and crash recovery by assigning different applications/subsystems to different partitions. In this way, applications and/or subsystems do not compete for space in the same file system.

Although LynxOS does not require partitioning, certain BIOS limitations may limit the maximum size allocatable to a partition. For hard disk sizes greater than this limit, a separate boot partition may need to reside at the start of the hard disk. The remainder of the disk may be partitioned into one or more partitions. Consult the BIOS documentation for additional information.

To allow a partition to be bootable on an IDE drive, the following rules must be followed:

On new disks, if the BIOS permits, set the hard disk translation mode to large or extended before installation.

On disks where another operating system has been installed, and LBA translation mode is enabled; or on new disks where the BIOS does not support hard disk translation mode, use the LynxOS mkpart command to force the LynxOS boot code to use LBA translation mode. LBA translation mode is enabled by entering the l command at the mkpart command prompt; this command toggles LBA translation mode between enabled and disabled.

For additional information on using mkpart, see "mkpart(1) man page".

Backing Up Existing Data

LynxOS does not support upgrade installations; any installation of LynxOS overwrites data in the space in which it is installed. It is recommended that all existing data and files be backed up before performing installation. Refer to the LynxOS User's Guide for information on using tar to back up important data.

Installing a LynxOS x86 Native Development System

Use the following procedure to install LynxOS onto an x86 system for native development:

Insert the LynxOS ODE CD-ROM into the CD-ROM drive, and power-up the machine.

The computer starts the LynxOS preboot utility, used to boot LynxOS from the CD-ROM drive. A boot prompt (Command? <b boot_device /lynx.os>) is displayed on the screen. If, after 10 seconds, no command is entered, preboot starts LynxOS from the CD-ROM.

Once LynxOS starts, run the installation utility by entering installit at the command prompt.

# installit

During the installation process, the installit script allows the user to configure information about the target system. Users can select the components to install and the hardware available on the system.

Quit the installation at any time by selecting Q or by typing Ctrl-C. If the installation is interrupted before successful completion, the user must re-enter the installit command to begin the installation again.

Proceed to "Using installit" for step-by-step instructions on using installit.

After the initial LynxOS installation is complete, additional BSPs and layered products can be installed. BSPs can be installed by untarring the BSP tar file onto the LynxOS system. For example,

# mount /dev/ide.1 /mnt

# cd /

# tar xvfz \ /mnt/tar_images/<med_num>.bsp_<bspname>.tar.gz

Note: The Legacy x86 AT BSP (pc_at) is included for legacy purposes only. It is recommended that customers use the x86 DRM-based BSPs (x86_drm).

Optional Software Installation

Additional components can be installed after the LynxOS ODE installation is complete. Some additional components include:

Additional Components

CD-ROM

Application

Filename

Additional Components

Linux ABI Compatibility

<media_num>.linuxabi.tar.gz

Additional Linux Libraries

<media_num>.linuxabi_advanced.tar.gz

GNU Zebra Routing Package

<media_num>.zebra.tar.gz

OpenSSL Encryption Components

<media_num>.openssl.tar.gz

ODE

Kernel Downloadable Images (KDI)s

<media_num>.kdi.tar.gz

BSP demo Files

<media_num>.demo_<bsp_name>.tar.gz

To install any or all of these additional components on a UNIX-hosted system, use the following instructions:

Log into the system as root.

Mount the Additional Components CD-ROM.

# mount -o ro /dev/<cdrom> /mnt

where cdrom is the device node of the CD-ROM drive (ide.1, for example).

Change to the LynxOS root directory:

# cd /

From this directory, extract the tar file with the following command:

# gnutar -xvzpf /mnt/tar_images/<filename>

where <filename> is the name of the file.

Additional tools, such as LynxInsure++, TotalView, or SpyKer include separate documentation that describes their installation procedure.

Note: El Torito bootable CD-ROM is available for LynxOS x86 installations.

	Caution! LynxOS does not support upgrade installations. LynxOS overwrites the contents of the disk (or partition) when installed. Any existing data on the installation space will be permanently lost. Also see "Planning Hard Disk Partitions" below for more on hard disk partitioning as it pertains to LynxOS.

Note: The Legacy x86 AT BSP (pc_at) is included for legacy purposes only. It is recommended that customers use the x86 DRM-based BSPs (x86_drm).

Additional Components
CD-ROM	Application	Filename
Additional Components	Linux ABI Compatibility	<media_num>.linuxabi.tar.gz
Additional Linux Libraries	<media_num>.linuxabi_advanced.tar.gz
GNU Zebra Routing Package	<media_num>.zebra.tar.gz
OpenSSL Encryption Components	<media_num>.openssl.tar.gz
ODE	Kernel Downloadable Images (KDI)s	<media_num>.kdi.tar.gz
BSP demo Files	<media_num>.demo_<bsp_name>.tar.gz

LynuxWorks, Inc.
855 Branham Lane East
San Jose, CA 95138
http://www.lynuxworks.com
1.800.255.5969