Red Hat Docs  >  Manuals  >  GNUPro Toolkit Manuals  > 

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2. Installing GNUPro Toolkit

This chapter describes how to install GNUPro Toolkit for GNUPro microarchitecture.

The GNUPro installation provides a complete, supported toolset for use in software development. As an aid to our customers, a contributed package with many useful, albiet unsupported tools is also included.

NOTE
{GNUPro tools are made available in one of two ways, either via Anonymous
FTP, or via CD install media. By default, the GNUPro tools are installed in /opt/redhat/release_name for UNIX operating systems and C:\RedHat\release_name for Windows operating systems. Release_name is a unique identifier which means the same sources were used to build the files contained within. All GNUPro releases employ a uniform directory structure, allowing multiple host architectures to coexist in the same installation prefix.}

For detailed installation information, see either:


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1 Install from CD

This section describes how to install GNUPro Toolkit from CD on both UNIX and Windows systems. Be sure that you are familiar with the naming conventions for the tools as descrbed in Host Configurations, and Embedded Cross-configurations.

IMPORTANT
In the following installation input examples, for /mnt
substitute your directory or /cdrom/gnupro-03r1 (the default directory in which you will mount the tools); host designates what you need to specify as your host type in using the binaries for the particular architecture, vendor, and operating system.

  1. Insert CD into CD-ROM drive.

  2. Mount the CD.

    The procedures for mounting a CD depend on your system type. The following examples of mount commands use default configurations; consult your system administrator if you need assistance.

    MicroSoft Windows 98, NT, 2000, XP
    Once inserted, the CD will be immediately available via the My Computer desktop icon.

    Red Hat Linux (and others)
    Modern Linux desktops will automatically mount newly inserted CDs in /mnt/cdrom. If your Linux system does not do this, perform the following actions:

    As root, enter the following command (the command assumes that the CD-ROM drive is available as `/dev/cdrom'):
     
    mount -t iso9660 /dev/cdrom /mnt/cdrom
    

    Sun Sparc Solaris
    If you are running the volume manager, the CD will automatically mount as `/cdrom/gnupro-03r1' and you will not require root access.

    If you are not running the volume manager, as root mount the CD manually with the following command:
     
    mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /mnt
    

    HP-UX

    HP-UX systems will automatically mount newly inserted CDs as `/cdrom';

  3. Run the installation.

    To install using the GUI installer:

    On Windows Systems

    Upon CD insertion, the Installation program should start up at once. If the autorun feature has been disabled and the Installer does not start up at once, do the following:

     
    Open the My Computer icon on the Windows Desktop.
    
    Double click the CD-ROM Icon.
    
    Double click the install-gui Red Hat Shadowman logo to start the installer
    

    On Unix Systems (Linux, Solaris, etc)

    First, set the DISPLAY environment variable. This variable may already be set if you're using the X11 Windowing System. If you are not certain if or how to set this variable, consult your system administrator.

    Start the installation program (substitute the path prefix according to where the CD media has been mounted):
     
    /mnt/cdrom/install-gui
    

    Once loaded, the Installer will provide the option to Browse available packages, or just Install the release. Select Install.

    The next screen will provide several different installation options. These options may include Typical Installation, Typical+SysRoot, Full Installation, or Customized Installation.

    Typical Installation

    Selecting a Typical Installation will install all the packages required for a fully functional GNUPro development environment. The following packages are installed with a Typical Installation:

    GNUPro Compiler
    GNUPro Debugger
    GNUPro DejaGNU
    GNUPro Misc
    GNUPro Utils
    GNUPro ManPages
    GNUPro Tex Info help files
    GNUPro Contributed (Needed for Cygwin)
    GNUPro Winsup (Cygwin only)
    Windows Mount (Cygwin only)
    Windows PATH (Cygwin only)

    Typical Installation is recommended for first time and new users.

    Typical Installation Plus Sys-Root

    This option is only available on Red Hat Linux systems when installing native tools. In addition to the typical installation, this option will install a Red Hat Linux System Root.

    Red Hat Linux System Roots

    A System Root is a copy of the standard headers and libraries found on a native Operating System. Installing a System Root allows developers to use different version of Linux, than the target environment for their software. This allows developers to use more modern versions of Linux, but create executables that will work on older versions.

    Full Installation

    Selecting Full Installation will install all of the GNUPro packages; these include all the packages listed in the Typical Installation plus the following:

    GNUPro Native Sources (where applicable)
    GNUPro Cross Sources (where applicable)
    GNUPro System Root Sources (where applicable)
    GNUPro Contributed Sources (where applicable)

    Customized Installation

    Selected Customized Installation will enable you to select which packages you would like installed.

    IMPORTANT
    {On Windows Systems, both Typical Installation and Full
    Installation will add the GNUPro and Contributed bin directories to the PATH environment variable, as well as rewrite the Cygwin mount table. If you do not wish the installer to modify your Windows 9x autoexec.bat file or the Windows NT registry, or do not want the Cygwin mount table updated, then select Customized Installation and deselect the Update Windows PATH and Configure Mount Table (respectively) packages before installing.}

  4. After selecting what packages to install, the Installer will ask what directory prefix to use for the installation.

    By default, Windows systems use C:\RedHat and Unix systems use /opt/redhat. Windows systems will also create a Cygwin mount table such that the installation directory maps to /opt/redhat for greater compatibility (unless the Configure Mount Table option was specifically deselected during the previous step).

    Accept the default or enter a different directory name to use. The installer will create new directories for you, if necessary. Please consult with your local System Administrator if you require assistance with where to install.

  5. Once begun, the Installer will unpack each archive and give a continuos update on overall and per-package progress. The installation process can take between 5-30 minutes, depending on the speed of the system.

  6. Upon successful installation, the following message appears:
     
    Installation Complete
    

  7. Once installed, these tools can be made read-and-execute only, to conform to local security policies. No write permissions on the tools are necessary to use the tools.

  8. Once installed, the GNUPro Toolkit will be organized into architecture dependant (such as executables and libraries) and architecture independant (such as manuals and sources) subdirectories.

    To accommodate binaries for multiple hosts in a single directory structure, the binary files for your particular host type are in the H-host/bin subdirectory (see Host Configurations, for specific host triplet names.)

     
    ln -s installdir/gnupro-03r1/H-host/bin \
            installdir/H-host/bin
    


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1.1 Setting the PATH Environment Variable

On Windows systems, the default installation will automatically set the PATH environment variable and the tools will be available at the next login.

On Unix systems, the PATH environment variable needs to be set to point to the executables just installed. PATHs can be updated on a system-wide basis by your System Administrator, or on an individual basis by editing your login shell scripts. Please consult the man page for your login shell for information on how to permenantly update your PATH

The following examples demonstrate how to update your path as a one-time update. If you installed into a different directory, substitute installdir for the actual directory. For host, @xref{Naming hosts with their canonical names}, for naming conventions. The following examples show how to create the final linking to the installdir/H-host/bin directory.

For Bourne-compatible shells (/bin/sh, bash, or Korn shell):

 
PATH=installdir/H-host/bin:$PATH ; export PATH

For C shell:

 
set path=(installdir/H-host/bin $path)

IMPORTANT
{The path should not include any colons for the C shell
environment variable settings. The directory path should be separated only by whitespace.}

Contributed Binaries On Unix Systems:

When the Contributed Binaries package is installed, an additional PATH setting is required to use these tools. Contributed binaries are only created for the baseline of each major OS, but work on subsequent revisions.

Table Paths for Contributed Binaries

For more information on using other environment variables, see How to Use Variables in Using make in GNUPro Development Tools.
[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1.2 Next Steps

Please examine See How to Report Problems, then move on to See Basic Principles of the Tools.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.2 Install from FTP

Make sure when getting files from the FTP server that you download everything to ensure no instructions or important files are missing. Releases made available via FTP are typically available for at least 30 following the availability announcement.

  1. All FTP releases contain a file named README with installation instructions. Please follow these instructions, as they will be customized particularly for the release being downloaded and installed.
  2. If the instructions provided in the README do not mention setting the PATH environment variable, please consult this manual's section on See Setting the PATH Environment Variable.
  3. Some FTP releases come with unbundled manuals, typically in pdf format. Once the release is installed, consult the documentation to decide what to do next.

After completing the installation process, see Set Environment Variables.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.3 Set Environment Variables

After installing the software and before using the tools, you must use a UNIX shell (for example, bash(4)) to set environment variables(5).


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Brendan Conoboy on June, 5 2003 using texi2html