COPYRIGHT

Copyright 2007 MontaVista Software, Inc. All Rights Reserved. This product and related documentation are protected by copyright and distributed under licenses controlling its use, copying, and distribution. No part of this product or its related documentation may be reproduced in any form or by any means except under such licenses and this copyright notice. MontaVista Software, Inc. makes no representations or warranties with respect to the contents or use of this manual and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. MontaVista Software, Inc. makes no representations or warranties with respect to MontaVista Linux and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. MontaVista is a registered trademark of MontaVista Software, Inc. The registered trademark Linux is used pursuant to a sublicense from the Linux Mark Institute, the exclusive licensee of Linus Torvalds, owner of the mark on a world-wide basis. All other names mentioned herein trademarks, registered trademarks, and service marks are the property of their respective owners.

REVISION HISTORY
This document was prepared by MontaVista Software, Inc. Edition Version Professional Edition 5.0 Revision Documentation Release Date

1st release

March 2007

Welcome

Welcome

Thank you for purchasing MontaVista Linux Professional Edition 5.0. MontaVista Linux Professional Edition (Pro) 5.0 is an embedded Linux development kit containing the Linux kernel source for its supported target processors. It provides a full complement of development tools to help you design, develop, and deploy an embedded system. This manual guides you through a typical installation of MontaVista Linux. It provides information about installing and updating Pro, its supported target architectures, and MontaVista DevRocket. For further details on MontaVista Linux, please visit the MontaVista Zone (http://support.mvista. com).

Welcome Choosing a Development Environment and Host Requirements Installing Pro for Cross-Development Obtaining and Updating Packages Installing MontaVista DevRocket Maintaining and Removing Software Frequently Asked Questions APPENDIX A Self-Hosted Pro Installation APPENDIX B Supported Reference Targets and DVD Labels

6 12 20 24 30 36 38

44

APPENDIX C 46 Additional Documentation Index 50

AUDIENCE
This manual assumes that you are a systems developer familiar with building embedded kernels using one of the following operating systems: Linux Solaris Microsoft Windows Specifically, you must be proficient in the following skills: Using a Bash shell Using Unix, Linux, or Cygwin file systems Changing file permissions Starting and stopping system services Logging events

MONTAVISTA ZONE
MontaVista Zone (http://support.mvista.com) is the MontaVista Software, Inc. subscriber-only support Web site. It provides focused information about embedded Linux systems and access to MontaVista developed software. It is your source for answers to frequently asked questions about products and services.

contact
MontaVista Software, Inc. wants your input regarding how well we are performing, as well as any suggestions or comments that you have for improvement. Please send email to suggestions@mvista.com. For questions about future availability, what you purchased, supported targets, and so forth, contact your sales manager or send email to sales@mvista.com.

MontaVista Zone

http://support.mvista.com

Choosing a Development Environment and Host Requirements

Chapter 1

Cross and Local Development

Before you can install MontaVista Linux Professional Edition (Pro) 5.0, you must decide on the development environment you want to use. Pro is designed to be used in a crossdevelopment environment, but it can also be installed directly on an X86 target machine for local-development. For local development, the target is self-hosted.

Those of you with experience as Real-Time Operating System (RTOS) developers may already be accustomed to using a crossdevelopment environment.

The Cross-Development Environment

Supports a variety of target architectures. Requires a host machine, though targets can be shared for testing and development. Stores the Pro installation on the host machine, which has a significant amount of local storage and memory. Supports NFS and RAM disk target root file system for initial development. Provides DevRocket, the Graphical User Interface (GUI) based development tool by MontaVista. Cross-development (or cross-compilation) refers to creating code on a machine of one architecture and compiling it for a machine of a different architecture. Although the architectures may not be the same endian, or may not process code the same way, the GCC compiler provided by MontaVista Software builds code that runs on the target. A cross-development environment consists of

A complete list of targets can be found on the MontaVista Web site (www.mvista.com).

a host system and a target system. A host is a system that is a typical workstation, such as a PC system running Red Hat Linux. Pro tools are installed on the host system and are used for compiling, linking, remote debugging, and associated development activities. A target is a reference board that you plan to use as the base for your product. Most embedded targets either do not have an IDE drive or have a drive that is too small to contain a full set of tools for building kernels and applications.

remember
If the host and target architectures are different, then code built for the target will not run on the host.

In the embedded-systems industry, most systems are small. By using a local-development environment, you could potentially increase costs and reduce productivity.

The Local-Development Environment on a Self-Hosted Installation

Requires a target machine with an IA-32/ X86 architecture. Does not require a separate host machine because the target is self-hosted. Requires the target to have at least 2 GB of local storage and 256 MB of memory for Pro. Allows the local root file system used for deployment to be used during development. Local-development (or local-compilation) refers to creating code or developing applications on (and for) the architecture and operating system being used. All of the tools and applications required to rebuild the system are installed directly on the target. A separate compiler is not needed. A network connection or cross-compilation host is not needed for a local-development environment.

Requirements for Cross-Development

To install Pro for cross-development, you must have a host machine running one of the following supported operating systems: Microsoft Windows 2000 with SP4+ or XP Professional with SP2+ Red Hat Enterprise Linux Workstation 3 or 4 (32 and 64 bit) Solaris 8 or 9 SUSE Linux 10.1 or SUSE Linux Enterprise Server 9 SP2

MontaVista does not provide technical support for Pro installations on operating systems not listed in this section.

If you are running Microsoft Windows 2000 and XP, the following components are required: 9 GB of disk space available for a single LSP of a single architecture type DVD-ROM drive Ethernet interface NTFS file system Console access to the target (a serial connection to a physical terminal or a terminal emulator on the host system) Administrator access permissions. Log in using a Windows user name that does not contain spaces.

Local Network

MontaVista Linux Serial Pro 5.0 Red Hat Target

For a typical systeman IA-32/x86 host running Red Hat Linux with a PowerPC targetyour cross development environment resembles this diagram.

Host

If you are running Red Hat Enterprise Linux Workstation 3 and 4, the following components are required:

32-bit compatibility packages must be installed before you install MontaVista Linux Professional Edition 5.0 on a 64-bit Linux host. 3 GB of disk space available for a single LSP of a single architecture type Serial port DVD-ROM drive Ethernet interface Network File System (NFS) mounting enabled Root access

If you are running SUSE Linux 10.1 and SUSE Linux Enterprise Server 9 SP2, the following components are required:

32-bit compatibility packages must be installed before you install MontaVista Linux Professional Edition 5.0 on a 64-bit Linux host. 3 GB of disk space available for a single LSP of a single architecture type Serial port DVD-ROM drive Ethernet interface Network File System (NFS) mounting enabled Root access

The default host OS installation of SUSE Linux may not include all the software you need

tips
If you are using NFS for your root file system during development, the firewall on your host must be configured to allow NFS mounting. For a default installation, the firewall is set to High to prevent NFS mounting. If the Firewall is set to None, NFS mounting is enabled. Due to security issues, please contact your systems administrator before changing firewall settings. Root access allows users to install an NFS bootable target file system. In turn, this allows users to configure and enable NFS, DHCP, TFTP, and other services. However, users can still use DevRocket to create file systems and develop kernel applications without root access.

to install and use Pro. The following packages are required and are available on the SUSE installation CD-ROMs: blt gmp python python-imaging python-tk

If you are running

Solaris 8 and 9, the following components are required:

MontaVista Software only supports Solaris 8 or 9 machines that contain an UltraSparc II (or higher) processor for use with Pro. 3 GB of disk space for a single LSP of a single architecture type Serial port Ethernet interface Console connection to your target (Depending on the target, this can be either a serial connection to the host or a VGA display and keyboard connected to the target.) Root access SUNWcsu installed for TFTP

Browser
The MontaVista Linux Installation Tool supports the following browsers: Firefox 1.x or 2.x Internet Explorer 6.0 (Windows XP Service Pack 2) The following browsers are known to NOT work with the Installation Tool: Netscape 4 Internet Explorer versions earlier than 6.0 Lynx

10

If you do not have a supported browser, one is provided with the Installation Tool. To use the provided browser, open a separate terminal and run the following script: /tmp/mvl-install/bin/links http://127.0.0.1:9999/mvlinstaller.cgi To proceed with a cross-development installation of Pro, see Chapter 2: Installing Pro for Cross-Development on page 12.

Requirements for Local-Development on a Self-Hosted Installation

Before installing a self-hosted version of Pro, make sure that your system meets the following host and target requirements: IA-32/X86 processor Industry standard IA-32/X86 BIOS with DVD-ROM support DVD-ROM drive with boot capability Console connection (a VGA graphic display and PC keyboard or serial console) 256 MB of RAM 2 GB of IDE hard disk or other non-volatile file system storage for the Pro development environment Enough additional storage for your project development (can be a flash device) To proceed with a self-hosted installation of Pro, see Appendix A: Self-Hosted Pro Installation on page 38.

Pro 5.0 (x86 development tools and basic file system)

For an IA-32/ X86 system, your local development environment resembles this diagram.

Target (with keyboard and VGA display)

11

Installing Pro for Cross-Development

Chapter 2

The variable <toolchain> refers to the combined architecture and processor names of the reference target. For example, the IA-32/X86 Generic Industry PC reference target has a 586 processor that belongs to the X86 architecture family. Its toolchain is X86_586. The string xxxxxxx refers to the 7-digit MontaVista build identification number.

Before You Begin

Before you install Pro for a cross-development environment: 1. Make sure that your system meets the host requirements outlined in Chapter 1. 2. Have the following installation media (or DVD images) ready. Version 5.0 Host DVD (pro-host-<toolchain>-xxxxxxx.iso) Version 5.0 Linux Support Packages DVD (lsps-<toolchain>-xxxxxxx.iso) Version 5.0 Documentation DVD [optional] (docs-pro-xxxxxxx.iso) Version 5.0 DevRocket DVD [optional] (devrocket-xxxxxxx.iso) 3. Select a directory for the installation. The default directory is /opt. 4. Complete the steps for the host system you are using: Red Hat, SUSE, or Solaris on page 13 Windows on page 16

32-bit compatibility packages must be installed before you install MontaVista Linux Professional Edition 5.0 on a 64-bit Linux host.

The MontaVista Linux Installation Tool provides the QUIT option several times throughout the installation process. MontaVista Software recommends that if you select the QUIT option, wait for all processes to terminate and then delete the directory where Pro was installed. This prevents inconsistencies from occurring during later installations.

12

Installation on Red Hat, SUSE, or Solaris

Use the MontaVista Linux Installation Tool to install Pro. This tool provides a graphical interface through a web browser, which can be used to install the full Pro software package. This tool also provides an interface for adding and removing software for Pro, as well as tools for removing it from your system.

To use the MontaVista Linux Installation Tool to install Pro on a Red Hat, SUSE, or Solaris host system, complete the following steps:
1. 2. 3. Log in as root. This ensures that the installed /target directory will have permissions set properly for the target to NFS-mount the root file system. Insert and mount the installation media labeled Host. Run the Installation Tool. For example, if you are using a mount point of /mnt/cdrom, enter the command:

/mnt/cdrom/install

The following message displays.

13

4.

Open a supported browser using the URL specified in the startup message. If you do not have a supported browser available, open a terminal and run the following command: /tmp/mvl-install/bin/links http://127.0.0.1:9999/mvlinstaller.cgi The MontaVista Linux Installation Tool launches and the Welcome screen displays. Click Next to view the End User License Agreements (EULA). Read the License Agreements information and click I Agree to continue. The Installation Path screen displays and requests an installation path. The default path is /opt. You can specify a different path. If the path or directory you specify does not exist, it is created for you. After entering a path, click Next to continue. The Installation Options screen displays and requests that you choose an LSP or Architecture. MontaVista Software recommends installing an LSP. At this time, you are also given the option of installing Documentation. When prompted, insert the installation media labeled Linux Support Packages into your DVD-ROM drive and click Next. The Select Software screen displays and lists all the LSPs that you purchased. Check the box next to the LSP that you want to install and click Next. When prompted, insert the installation media labeled Host into your DVD-ROM drive again and click Next. This copies the necessary cross and target files to your machine. If you have previously chosen to install the product documentation, you are

5. 6. 7.

8.

9. 10. 11.

12.

tips
Make sure that you have root access. If your Linux automounter is off, you must mount each DVD one-by-one using the mount command. If you are using the mount point mnt/cdrom, enter the following at the command line: mount -t iso9660 -o ro /dev/cdrom /mnt/cdrom To mount the ISO images, replace /dev/cdrom with the host image location. For example, to mount the host image (pro-host-<toolchain>-xxxxxxx.iso) to a directory called /mnt/host, enter the following at the command line: mount -t iso9660 -o ro,loop <host_image_location> /mnt/host 1

prompted to insert the installation media labeled Documentation. Insert the media into your DVD-ROM drive and click Next. 13. An installation summary is displayed, indicating the installation progress. Click Next to begin installing the software. This part of the process can take an hour or longer depending on your host specifications.

Congratulations! You have successfully installed MontaVista Linux Professional Edition 5.0

1

Installation on Windows
Use the MontaVista Linux Installation Tool to install Pro. This tool provides a graphical interface through a web browser, which can be used to install the full Pro software package. This tool also provides an interface for adding and removing software for Pro, as well as tools for removing it from your system. The following rules apply to any Pro 5.0 installation on a Windows host: You can install Pro 5.0 on the same system as Pro 4.0. The 5.0 version of Cygwin uses different registry keys from 4.0 and uses a different default directory. It is possible to run 4.0 Cygwin and 5.0 Cygwin side-by-side without interference. However, DevRocket chooses the most recent installation of Cygwin. You cannot install two instances of Pro 5.0 on the same system. Only one version of the 5.0 Cygwin can be installed on a Windows machine. If you install Pro 5.0 once, and then install again to a second location, the second location is used. Each edition uses the same Cygwin version. Installing Pro 5.0 to the same directory as Pro 4.0 upgrades the older version to the newer one. Enter the installation location of 4.0 for the 5.0 Cygwin setup program. The program updates the RPM packages accordingly. If you choose to do this, all Cygwin programs must be stopped, including services. Open Cygwin programs are not updated because Windows does not allow a file to be changed or removed if it is open.

tip
The commands throughout this manual use a Bash shell terminal window. To open a Bash shell on a Windows host: Click on the Start menu and choose Programs > MontaVista Linux > Bash Shell.

1

To use the MontaVista Linux Installation Tool to install Pro on a Windows host system, complete the following steps:
1. 2. Insert the Host installation media into your DVD-ROM drive. The MontaVista Linux host-tools setup wizard displays. Click Next to continue. Note: If you have AutoPlay disabled, the setup wizard does not appear. To manually start the setup wizard, complete one of the following steps: In Windows Explorer, right-click on the DVD-ROM drive and select AutoPlay. In Windows Explorer, navigate to <DVD-ROM_drive_letter>:\host-tools\ windows2000 and run setup.exe.

1

3.

The setup wizard requests the installation path for host-tools. The default path is c:\mvcyg5.0. Use the default path or enter another installation path. Click Install to begin installing the host-tools. After the host-tools installation is complete, the MontaVista Linux Installation Tool launches and the Welcome screen displays. Click Next to view the End User License Agreements (EULA). Read the License Agreements information and click I Agree to continue. The Installation Path screen displays and requests an installation path. The default path is /opt. You can specify a different path. If the path or directory you specify does not exist, it is created for you. After entering a path, click Next to continue. The Installation Options screen displays and requests that you choose an LSP or Architecture. MontaVista Software recommends installing an LSP. At this time, you are also given the option of installing Documentation. When prompted, insert the installation media labeled Linux Support Packages into your DVD-ROM drive and click Next. The Select Software screen displays and lists all the LSPs that you purchased. Check the box next to the LSP that you want to install. Click Next. When prompted, insert the installation media labeled Host into your DVD-ROM drive again and click Next. This copies the necessary cross and target files to your machine. If you have previously chosen to install the product documentation, you are prompted to insert the installation media labeled Documentation. Insert the

4.

5. 6.

7.

8. 9. 10.

11.

remember
9 GB of disk space available is needed for an installation of a single architecture. Each additional architecture requires 1500 MB of space. Each additional LSP requires 250 MB of space. All disk space must be located on a single drive.

1

media into your DVD-ROM drive and click Next. 12. An installation summary is displayed, indicating the installation progress. Click Next to begin installing the software. This part of the process can take an hour or longer depending on your host specifications.

Congratulations! You have successfully installed MontaVista Linux Professional Edition 5.0

1

Obtaining and Updating Packages

Chapter 3

Using mvl-apt-rpm
Before running any set of apt operations, it is good practice to run apt-get update first. This updates the local package repository information of mvl-apt-rpm. It does not upgrade packages, but it is recommended that you run this tool every time you need to get information regarding the latest packages available.

After installing MontaVista Linux Professional Edition (Pro) 5.0, update your system with the latest available packages. Updated packages become available at MontaVista Zone (http:// support.mvista.com) as updates occur. Use mvlapt-rpm to download and install the updates. The MontaVista Linux advanced packaging tool mvl-apt-rpm is a package management utility front-end that allows you to easily perform package installation, upgrade, and removal, in addition to automatically handling dependencies. It can be used to manage common, host, cross, and target software components for MontaVista Linux installations. The mvl-apt-rpm utility provides commonly used tools for managing your packages, along with several options available to each tool. However, this guide only covers updating your system after the initial installation. For this task, use the command-line tool apt-get for MontaVista Linux. In general, apt-get installs, upgrades (by installing the latest version of existing packages), and removes software. To use mvl-apt-rpm within the MontaVista Linux environment, you must run a separate instance of apt-get for common, cross, host, and target components.

20

Working with Common Packages

The mvl-apt-rpm command-line tool for working with common packages is: /opt/montavista/common/bin/mvl-common-apt-get To download and install updates for common packages, complete the following steps: 1. After installing Pro, from a Bash shell run apt-get update to get a list of the most current available software. Enter the following: /opt/montavista/common/bin/mvl-common-apt-get update 2. To determine which packages have updates available to download, enter the following: /opt/montavista/common/bin/mvl-common-apt-get list-updates 3. To upgrade packages to the latest available version, enter the following: /opt/montavista/common/bin/mvl-common-apt-get upgrade

tip
Updated packages become available at MontaVista Zone (http://support. mvista.com/content) as updates occur. Use mvl-apt-rpm to download and install the updates.

21

Working with Host and Cross Packages

The mvl-apt-rpm command-line tool for working with host and cross packages is: /opt/montavista/pro/bin/mvl-edition-apt-get To download and install updates for host and cross packages, complete the following steps: 1. From a Bash shell run apt-get update to get a list of the most current available software. Enter the following: /opt/montavista/pro/bin/mvl-edition-apt-get update 2. To determine which packages have updates available to download, enter the following: /opt/montavista/pro/bin/mvl-edition-apt-get list-updates 3. To upgrade packages to the latest available version, enter the following: /opt/montavista/pro/bin/mvl-edition-apt-get upgrade

22

Working with Target Packages

To work with target packages while on the host, you also use the mvl-edition tool used for working with host and cross packages. However, to work with a specific target, you must add the --target=<architecture>_<processor>-linux option when executing the program. For example, to upgrade an x86_586 target, run the following commands:
/opt/montavista/<edition>/bin/mvl-edition-apt-get --target=x86_586-linux update /opt/montavista/<edition>/bin/mvl-edition-apt-get --target=x86_586-linux upgrade

23

Installing MontaVista DevRocket

Chapter 4

MontaVista Devrocket
This section describes installation of MontaVista DevRocket, the set of application developer tools designed to work with the Eclipse integrated development environment.

System Requirements
DevRocket is supported on the following platforms:
To run DevRocket on Solaris 8, see the special instructions in, Setting Up Solaris 8.

Linux (RedHat Enterprise WS 4.0; SUSE Linux Enterprise Server 9) Solaris (Solaris 8; Solaris 9 (version 9/05); Solaris 10) Windows (2000, XP) DevRocket depends on the Eclipse integrated development environment and other plug-ins, some of which require JRE 1.5. A list of JRE sources for each supported platform can be found at: http://download.eclipse.org/eclipse/ downloads/drops/R-3.2-200606291905/ java-runtimes.html

2

Setting up Solaris 8
To run DevRocket on Solaris 8, you must first make the following changes to the Solaris system: 1. Open the SPARC/Solaris 8 page on Sunfreeware.com and download the following files: atk-1.9.0-sol8-sparc-local.gz glib-2.6.2-sol8-sparc-local.gz gtk-2.2.4-sol8-sparc-local.gz libgcc-3.3-sol8-sparc-local.gz libiconv-1.11-sol8-sparc-local.gz libintl-3.4.0-sol8-sparc-local.gz pango-1.8.0-sol8-sparc-local.gz 2. Gunzip each file. 3. For each package, run the following command: pkgadd -d <packagename> 4. Open the Sun Java SE downloads page and download and install: jre-1_5_0_10-solaris-sparc.sh

5. Move the resulting jre1.5.0_10 directory to /usr. 7. Enter the following command: export LD_LIBRARY_PATH=/usr/local/lib

6. Create a symbolic link from the /usr/java directory to the jre1.5.0_10 directory.

2

MontaVista DevRocket Installation Types

When you run the DevRocket installer, you are asked to select from two types of installationsStandard or Custom. Review the information below so that you can make the correct choice based on what is currently installed on your local host.

Standard Installation
Installs the following components: Eclipse 3.2.1 CDT 3.1.1 RSE 1.0 GEF 3.2.1 Derby 10.2.2 DevRocket Plug-ins

Custom Installation
Installs the DevRocket Plug-ins. To complete this type of installation, you must already have Eclipse 3.2.x installed. In addition, the installer checks to see if you have the following required plug-ins installed: CDT 3.1.x RSE 1.0 GEF 3.2.x Derby 10.2.2

2

If you do not, you are presented with the option of installing them because they are required to run the DevRocket plug-ins.

Installing MontaVista DevRocket

To install MontaVista DevRocket on your local host, complete the following steps: 1. 2. 3. Log in to your host system as an administrator. Insert and mount the DevRocket installation media. Navigate to, and select the installation file for, your system type: Linux: devrocket-5.0.0-<time_stamp>-linux-installer.bin Windows: devrocket-5.0.0-<time_stamp>-windows-installer.exe Solaris: devrocket-5.0.0-<time_stamp>-solaris-sparc-installer.bin 4. Start the installer: Linux platforms: Open a command-line window and execute: $ <path_to_mounted_media>/devrocket-5.0.0-<time_stamp>-linuxinstaller.bin

2

Solaris platforms: Open a command-line window and execute: $ <path_to_mounted_media>/devrocket-5.0.0-<time_stamp>-solarissparc-installer.bin Windows platforms: The installer automatically starts if AutoPlay is enabled. If it does not, you can start it by running the installer manually. Using Windows Explorer, navigate to the following path and run the executable: <Installation_media_drive>:\devrocket-5.0.0-<time_stamp>-windowsinstaller.exe 5. 6. 7. 8. 9. Review the Welcome page and click Next. Read the License Agreement, accept the terms, and click Next. Review the types of installation. Select the type of installation (Standard or Custom) and click Next. Navigate to, or enter the location for, the installation. For a Standard installation, any location is acceptable. For a Custom installation, you must select the directory in which Eclipse is installed. Click Next.

2

10.

If you have selected a Standard installation, you are prompted to create aliases on your desktop and menus. Click Yes to do so, or No if you do not want the aliases created, and then click Next. If you have selected a Custom installation and CDT, RSE, or Derby is not detected, you are prompted to install the missing plug-in. Click Yes to have plug-ins included in the installation or No if you want to perform the installation yourself. If no problems are detected, you are ready to begin the installation. Click Next. At one point during the installation an Info dialog opens that includes your host ID. You need your host ID to get your DevRocket license file from the MontaVista Zone, so please make a note of it. When the installation is complete, click Finish to close the installer. Open the Software License page on the MontaVista Zone and follow the instructions for obtaining and installing your license. After the license is installed, you have access to all DevRocket functionality.

11.

12. 13.

14. 15.

tip
If you need to obtain your host ID at any time after the installation process completes, run the program <DevRocket_installation_directory>/lm/bin/ hostid (or hostid.exe for Windows platforms) from a command prompt. This command returns the host ID to use when obtaining your license.

2

Maintaining and Removing Software

Chapter 5

Working with mvl-setup

After you have successfully installed MontaVista Linux Professional Edition (Pro) 5.0, you can use the MontaVista Linux Installation Tool (mvl-setup) to perform the following tasks: Install additional software, such as LSPs and architectures. Remove existing software installation, such as individual LSPs and architectures. Remove the complete edition software.

30

Installing or Removing Software

To install or remove software using mvl-setup, complete the following steps: 1. From the Bash shell window, launch mvl-setup. For example, if you installed Pro in /opt/montavista/pro, enter the command: /opt/montavista/pro/bin/mvl-setup/ The following message displays: Welcome to MontaVista Softwares Product Installer. Starting up, please wait... MontaVista Softwares Product Installer uses a web interface for configuration. See the product documentation for more information. The web server is ready, please connect a web browser to: http://127.0.0.1:9999/ or for systems with a text display or less than 1024x768 resolution: http://127.0.0.1:9999/mvlinstaller.cgi (You may use this machines IP address instead of 127.0.0.1) Note: The Installation Tool is configured for a minimum resolution of 1024768. 2. Launch your browser and enter the appropriate URL for your system (for example, http://127.0.0.1:9999). Your browser displays the Welcome screen.

31

3. Select Install Additional Software or Remove Installation.

If you select Install Additional Software: 4. The End User License Agreements (EULA) screen displays. Review and click Accept to continue. 5. The Select Software screen displays. Select Install Additional LSPs/Architectures and click Next to continue. 6. Follow the remaining installation instructions onscreen. 7. When the installation is complete, the Installer Complete screen displays. If you select Remove Installation: 4. The Removal Options screen displays. Select a removal option and click Next. 5. Follow the remaining installation instructions onscreen. 6. Verify that you want to proceed with the removal operation. Please be patient. The length of time to uninstall varies based on the options you have installed. When the removal is complete, the Installer Complete screen displays.

32

Welcome

Install Additional Software

Remove Installation

License Agreements

One or More Architecture(s)

One or More LSP(s)

Pro Installation

Additional LSP/ Architecture

Select Software

LSP

Architecture

Post-Installation (mvl-setup)

33

Removing the Pro Installation from a Windows Host

To remove Pro from a Windows host, complete the following steps: 1. Click Start > Settings > Control Panel. 2. In the Control Panel window, select Add or Remove Programs. 3. Select MontaVista Linux host-tools for Microsoft Windows and click Remove. 4. After the uninstall completes, use Windows Explorer to navigate to the folder where Pro was installed (for example, C:\mvcyg5.0) and delete it.

Removing the Pro Installation from a Linux or Solaris Host

To remove the Pro installation from a Linux or Solaris host, use the following command: rm -rf /opt/montavista

warning!
Enter the command exactly as shown or you risk removing the contents of your entire disk. If you did not use the default installation directory /opt, replace /opt with the path of your MontaVista Linux installation.

3

3

Frequently Asked Questions

Chapter 6

Why cant I use the browser provided by Solaris? MontaVista supports Netscape 7 or higher. The version of Netscape provided with Solaris is 4.6. Obtain the latest version of Netscape before running the Installation Tool, or use the text-based browser MontaVista provides. To use the text-based browser, run the following command: /tmp/mvl-install/bin/links http://localhost:9999/mvlinstaller.cgi Why cant I run the Installation Tool? All installation operations must run as root. However, with the automounter running, logging into a KDE or Gnome desktop and then using the su command to become root can cause the Installation Tool on the DVD to be inexecutable. To support the automounter during Linux system installation, the DVD entry in /etc/fstab is created with the user option, and the automounter process runs under a non-root userid. Under these conditions, the automounter mounts the distribution DVD using the noexec option (implied by user), rendering the installation tool (and any other executables on the DVD) inexecutable. There are several workarounds. One option is to run the installation tool from a root login desktop session rather than using the command su root from a non-root desktop session. Another option is to disable the automounter. To disable the automounter, you must edit the file /etc/fstab to either add the exec option before the user option or simply remove the user option for the DVD mount. Why was the Installation Tool unable to eject the first DVD? If for any reason the DVD-ROM device is busy, the Installation Tool fails to eject the first DVD and installation does not proceed. Two of the most typical reasons are: For some desktop environments, when the automounter mounts a DVD, a file system browser window appears. You must close this window to allow the DVD to be unmounted by the Installation Tool. Viewing the HTML Installation Guide directly from the Host DVD causes the

3

DVD-ROM device to be busy. You should either refer to the printed Installation Guide or the PDF on the Documentation DVD. Why cant I open the Installation Tool with a supported browser? If you are using a proxy server for your Web browser, you must perform one of the following actions to run the MontaVista Linux Installation Tool: Temporarily disable your proxy server settings. Add 127.0.0.1 to the list of URLs for your system not to proxy (MontaVista recommended method). Why does the Installation Tool report insufficient disk space to install? If you receive an error message similar to the following, you do not have enough disk space available for the software installation. Total installation size: 1488 MiB (51465 files) Available space: 1052 MiB After you have allocated enough free space, you can continue the installation process. When reinstalling Pro in Windows, why do I get a Previous Installer Instance error even after I have already uninstalled the previous installation? Error: Previous installer instance detected. If the installer is not already running, invoke the installer with -clean to remove the temporary files. Make sure that you have deleted the folder where Pro was installed before you invoke the installer with --clean. Launch the Bash shell and enter the following command: /opt/montavista/pro/bin/mvl-setup --clean

3

APPENDIX A Self-Hosted Pro Installation

A
Make sure your system meets the requirements for self-hosted installation. This section describes the steps for installing MontaVista Linux Professional Edition (Pro) 5.0 directly onto the target system. 1. Connect your console. 2. Configure your BIOS. 3. Install Pro using a locally attached DVD-ROM drive.

A target installed with Pro for a local-development environment cannot be used as a host in a cross-development environment. The target can only have one LSP installed and can only be used for application development.

Connecting Your Console

Most IA-32/X86 target systems provide a standard VGA display and a PC-style keyboard attachment.

The default console uses standard VGA graphics and a directly attached keyboard. To attach the default console, complete the following steps: 1. Plug the keyboard into the round keyboard connector located on either the main or I/O expansion boards, as appropriate. 2. Plug the VGA monitor into the VGA connector located on either the main or I/O expansion boards, as appropriate. If you use a serial console, standard communication parameters of 9600 bps, no parity, and 1 stop bit (9600n1) are used Connect the COM1 serial port (Linux device /dev/ ttyS0) to the Linux host running Minicom using a crossover (null-modem) cable with connectivity for at least the transmit (TXD), receive (RXD), and signal ground leads (pins 1, 2, and 3).

3

Now that you have connected your console, you can configure your BIOS.

Configuring your BIOS

In general, your target system BIOS is configured to boot first from floppy disk and then from internal hard disk. Perform a BIOS setup to establish the boot device order using the following guidelines. Details about entering the BIOS setup mode and the particular wording of onscreen menus vary on each target. If your BIOS supports direct-boot from DVD-ROM, complete the following steps: 1. Activate the BIOS setup utility. 2. Select the boot device order submenu or line item. 3. Enable boot from IDE (ATA) DVD-ROM, and place it in the list for selection before hard disk. 4. Save the changes and exit BIOS setup. You are now ready to install Pro.

Install Pro Using a Locally Attached DVD-ROM Drive

The Pro self-hosted installer is intended for use only on Pro target boards. It is not intended for, and should not be booted, on host systems, such as those used in a crossdevelopment environment. This section provides instructions for installing Pro using a DVD-ROM drive that is attached to the local system. The MontaVista Installation Tool uses the Links browser. If you are unfamiliar with using this browser, the following hints help get you started. Press Esc to display the menus, including a help menu. Use the up and down arrows to navigate instead of the right and left arrows. Press the Enter key to select an option instead of the Tab key or the Space Bar. Press Q to quit the browser.

3

To install directly from a locally attached DVD-ROM, complete the following steps: 1. 2. 3. Insert the installation media labeled Host into the DVD-ROM drive. Boot the target system. You should receive booting messages on the console, and a menu appears. You are now at the boot prompt and are asked to provide the device with the installation image and console options to the installer. The installation image is the DVD-ROM device with the installation media. The console is either VGA or serial, depending on which device you are using for the console. For example, if your DVD-ROM is connected as the master device on the secondary IDE channel, and your console is connected to a VGA monitor, enter the following: boot: hdc-vga Note: The option hdc-vga is the default if you do not specify any options at the boot prompt, or if you do not provide any input after a short period of time. 4. 5. 6. The MontaVista Linux Installation Tool starts. The installation tool uses the Links browser. Select Install. Read the license agreement and click Agree to continue. Insert the installation media labeled Linux Support Packages.

warning!
Using the Pro self-hosted installer on a host system has the potential to destroy all host-system hard disk content.

0

7. 8. 9.

The Target Selection screen displays and lists the available LSPs. Check the box next to the LSP that you want to install and select Next. When prompted, insert the installation media labeled Host again and select Next. When prompted, choose either manual or auto-partitioning. Warning! By choosing auto-partitioning, the partition table of the entire disk is overwritten, and all of its contents is lost. A list of disks available on your system displays. In auto-partitioning mode, you are prompted to select one disk. In manual partitioning mode, you can configure one or all of these disks. However, they must be configured one at a time.

10.

If you selected manual partitioning, configure each disk using the following steps: Select the disk to configure. The layout of the partitions on the selected disk appears. Enter the partitions you want to create by selecting Add Partition. If there is no free space left on the disk, you must delete a partition before you can add another. MontaVista Software recommends you create the following partitions: Primary partition of type ext3 that is the boot partition. The size of this partition needs to be set to at least 60 MB for an initial boot of Pro. Because a larger boot partition allows you to store additional kernels, a boot partition size of at least 100 MB is recommended.

1

Root (/) partition with the type set to ext3. For the initial installation of Pro, the root partition size must be least 2 GB. Swap partition with the type set to Linux Swap. Select Apply. The disks are partitioned as specified and you are presented with information verifying your choices. If you have partitioned your disks in such a way that Pro cannot be successfully installed, you receive an error and are prompted to make changes to the partitions. If you are satisfied with how the disks are partitioned, select Next.

You are returned to the list of available disks. Repeat these steps for each disk you want to partition. 11. You are prompted to configure your file systems. For those already familiar with Linux, this sets up your /etc/fstab file. Note: In auto-partitioning mode, the default configuration is already set for you. To configure your file system, complete the following steps: Select which drives you want to format by checking the box in the fmt column. Enter the mount point for each partition (for example, /boot or /) in the file column. Select the file system type in the FSType column.

2

 12. 13.

Select the file system mount options in the mntopt column. Enter a 1 in the freq column if you want to check the file system; otherwise enter 0. Enter the order in which you want file system checks to occur after reboot in the passno column. Select Next to continue.

The Installation Summary screen displays. Review the summary and select Next to begin installation. If installation is successful, you are asked a series of questions about how you want to configure the system. Enter the system configurations you want to use as you are prompted for them. When system configuration is complete, you receive a notice that installation is complete. Select Reboot and remove the installation media from the DVD-ROM drive.

14.

MontaVista Linux Professional Edition 5.0 is now installed for local-development on a self-hosted target.

3

APPENDIX B Supported Reference Targets and DVD Labels

The table contains the following information: Reference Target: This column lists the supported reference targets. Reference targets are listed in alphabetical order by manufacturer name. Only the reference targets supported by MontaVista Linux Professional Edition 5.0 as of March 2007 are included in this list. Information about reference target Linux Support Packages (LSP) released after this date is available on MontaVista Zone. DVD Label: This column lists the DVD label, which consists of the following information: architecture family, DVD name, and toolchain. Note: Reference targets that support uClibc have two LSP DVDsone for glibc and one for uClibc. DVD Image Name: This column lists the DVD image names as pro-host<toolchain>-xxxxxxx.iso and lsps-<toolchain>-xxxxxxx.iso, where <toolchain> refers to the combined architecture and processor names of the reference target. The parameter xxxxxxx refers to the 7-digit MontaVista build identification number. Reference Target
Generic IA-32/X86 Industry Standard PC

DVD Label
X86 Host DVD x86_586 X86 Linux Support Packages x86_586 x86_586_uclibc

DVD Image Name

pro-host-x86_586-xxxxxxx.iso

lsps-x86_586-xxxxxxx.iso lsps-x86_586_uclibc-xxxxxxx.iso

Generic IA-32/X86 Industry Standard PC (Pentium III)

X86 Host DVD x86_pentium3 X86 Linux Support Packages x86_pentium3

pro-host-x86_pentium3-xxxxxxx.iso

lsps-x86_pentium3-xxxxxxx.iso



Reference Target
Generic IA-32/X86 Industry Standard PC (Pentium IV)

DVD Label
X86 Host DVD x86_pentium4 X86 Linux Support Packages x86_pentium4

DVD Image Name

pro-host-x86_pentium4-xxxxxxx.iso

lsps-x86_pentium4-xxxxxxx.iso

ARM, Ltd. RealView Versatile Platform Baseboard for ARM926EJ-S

ARMv5 Host DVD arm_v5t_le ARMv5 Linux Support Packages arm_v5t_le arm_v5t_le_uclibc

pro-host-arm_v5t_le-xxxxxxx.iso

lsps-arm_v5t_le-xxxxxxx.iso lsps-arm_v5t_le_uclibc-xxxxxxx.iso

Broadcom BCM91250A and BCM91250E Evaluation Boards for the BCM1250

MIPS Host DVD mips2_fp_be MIPS Linux Support Packages mips2_fp_be mips2_fp_be_uclibc PowerQUICC II Host DVD ppc_85xx PowerQUICC II Linux Support Packages ppc_85xx XScale Host DVD arm_xscale_be XScale Linux Support Packages arm_xscale_be arm_xscale_be_uclibc

pro-host-mips2_fp_be-xxxxxxx.iso

lsps-mips2_fp_be-xxxxxxx.iso lsps-mips2_fp_be_uclibc-xxxxxxx.iso

Freescale Semiconductor, Inc. MPC8540 Application Development System (ADS)

pro-host-ppc_85xx-xxxxxxx.iso

lsps-ppc_85xx-xxxxxxx.iso

Intel Corporation IXDP425 Development Platform with the IXPIXP420/421/ 422/425 Processor

pro-host-arm_xscale_be-xxxxxxx.iso

lsps-arm_xscale_be-xxxxxxx.iso lsps-arm_xscale_be_uclibc-xxxxxxx.iso



APPENDIX C Additional Documentation

Additional documentation is available in the MontaVista Linux Professional Edition (Pro) 5.0 installation directory. Pro applications provide manual (man) and information (info) pages. In general, info pages are online manuals, while man pages ordinarily provide a description of the application, its options and usage, pointers to related documentation, and a list of known problems. For the most up-to-date information, online documentation is available on MontaVista Zone.

Using man Pages

In addition to the traditional man pages, Pro provides man pages in HTML format. To open the HTML version, use your Web browser to open the following location: /opt/montavista/pro/documentation/ Note: If you did not install Pro in the default directory /opt, replace the /opt directory with the location you used. The Pro application man pages (in traditional format) are installed in the following locations:

Applications Path
Target Host Cross Common /opt/montavista/pro/devkit/<architecture>/<processor>/target/ usr/share/man /opt/montavista/pro/man /opt/montavista/pro/devkit/<architecture>/<processor>/man /opt/montavista/common/man



Setting Your MANPATH To view the Pro man pages, you must update your executable search path to include them. For example, use the following command to include the Pro host man path: export MANPATH=/opt/montavista/pro/man:$MANPATH After you set your path, you can view man pages using the following command at the prompt: man <application> Note: A single application can have more than one man page. To view all application man pages, enter the following command: man -aw <application>

Using info Pages

By default, Pro info pages are installed in the following locations: Applications Path Target Host Cross Common /opt/montavista/pro/devkit/<architecture>/<processor>/target/ usr/share/info /opt/montavista/pro/info /opt/montavista/pro/devkit/<architecture>/<processor>/info /opt/montavista/common/info

Note: If you did not install Pro in the default directory /opt, replace the /opt directory with the location you used.



Setting your INFOPATH To view Pro info pages, update your executable search path to include them. For example, use the following command to include the Pro host info path: export INFOPATH=/opt/montavista/pro/info:$INFOPATH After you set your path, you can view info pages using the following command at the host or target system prompt: info <application>

Linux and HOW-TO Documents

In addition to the info and man pages, you can find Linux and HOW-TO documents in the following Pro directories: /opt/montavista/pro/devkit/<architecture>/<processor>/doc /opt/montavista/pro/doc /opt/montavista/common/doc

Related Documentation
MontaVista Linux Pro also provides the following documentation: Release notesProvide information on supported platforms, as well as fixed and known issues. MontaVista Zone (http://support.mvista.com)Provides focused information about MontaVista products and services.





Index
Index
A
apt-get 20 apt-get list-updates 21 apt-get update 20 apt-get upgrade 21 automounter 1

R
Red Hat  Red Hat Enterprise Linux Workstation 3 and   Reference Target 

S
Self-Hosted Installation  self-Hosted installation 3 Solaris 10 SUSE 13 SUSE Linux 

B
Bash Shell 1 BIOS 3

C
Cross-Development Environment  cygwin 1

T
toolchain 12

D
DevRocket 2 DevRocket Installation Types 2 DVD Image Name  DVD Label 

H
host ID 2

I
Installation on Red Hat 13 Installation on Windows 1

L
Local-Development Environment 

M
Microsoft Windows  Microsoft Windows 2000 and XP  MontaVista Zone  mount 1 mvl-apt-rpm 20 mvl-setup 30

0

1