Contents|Previous|Next
Installing GNUPro Toolkit 
The following documentation describes how to install your GNUPro Toolkit software on UNIX and Win32 systems.
Installation will provide all the tools that Cygnus supports as well as many tools that have no support (even though unsupported tools may work with high success).

For help with using the tools, see Cygnus and GNUPro Toolkit fundamentals and Using the tools on native and embedded systems.

For information about rebuilding the tools for other target environments, see Rebuilding from source.
 

Installing on UNIX systems from CD
GNUPro Toolkit for UNIX systems uses the following CD installation procedure.

For more details on naming conventions for the tools as they pertain to specific systems, see Naming hosts and targets and, specifically, Naming hosts. See also Links for easy access and updating, install-cli options, Setting the PATH environment variable, and Rebuilding from source.

    Note:
    In the following installation input examples, for /mnt, substitute your directory or /cdrom/gnupro_99r1 (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 (see Table 7: Naming hosts for naming standards)
           
    1. Mount the CD.
      Insert CD into CD-ROM drive. The procedures for mounting the CD depend on your system type. The following discussion details some examples of mount commands for each host (the examples use defaults for some configurations). Consult your system administrator if you need assistance.

Links for easy access and updating

Build symbolic links as the last step in the installation process.
IMPORTANT:
This task simplifies administrative procedures for upgrades to future GNUPro releases, providing the software transparently to other users and permitting users to have multiple installations in the same location.
Directories of machine-independent files (source code and documentation) install directly under the ‘gnupro-99r1’ level. To accommodate binaries for multiple hosts in a single directory structure, the binary files for your particular host type are in the ‘H-hosttype’ subdirectory (hosttype indicates a particular architecture, vendor and operating system; see Naming hosts for more specific input.)
The previous example shows input that provides one more level of symbolic links so that other users can define the same executable path even if they use binaries sometimes for one machine and sometimes for another machine. Establishing these links now can save developers the trouble later of changing all their paths. The idea is to build ‘/usr/gnupro/bin’ so that it points to the appropriate binary subdirectory for your machine. For instance, use the path, /usr/cygnus/gnupro-99r1/H-host, where host designates what you need to specify as your host type in using the binaries for the particular architecture, vendor, and operating system (see Naming hosts for naming standards).

You may then need super-user access again, using the following example’s input to establish the link.

Setting PATH

To run the tools in this distribution, make sure the PATH environment variable can find the tools. Whether you install in the default location, as in the following example for the input, or in an alternate location, you need to alter your PATH environment variable to point toward the tools.

If you create the symbolic links we recommend (see Links for easy access and updating), users who want to run the tools—regardless of whether they need binaries for your particular host, or for some other platform—can use initialization files settings. The following examples show the appropriate input for creating the final linking to the  /usr/gnupro/bin directory. If you installed into a different directory, substitute  ‘/usr/gnupro/bin’ for the actual directory. For the appropriate input for <host>, see Naming hosts for naming standards of your operating system or processor.

install-cli options

By default, the install-cli script prompts you for installation information. There are also command line options to allow you to install by accepting the defaults provided or overriding the default installation directory.  A summary follows of these options.
--target=target
Installs for target type (see Target names for the appropriate input for the target name to use for target).
--installdir=yourinstalldirectory
Provides the location of yourinstalldirectory where you installed the tools. ‘/usr/gnupro/’ is the default directory.
--defaults
Installs default products and packages. Where applicable, the defaults are English, all binary packages, all documentation packages, no source tools, no demonstration packages.
--help
Lists all available options.
Note:
Some of the options that will list for the --help command are what install-cli uses internally; these commands cannot work for use outside of the installation scripts.

Installing on Win NT/95/98 systems from CD

All releases of GNUPro Toolkit for WinNT/95/98 * systems use the following CD installation procedure.
    1. Mount the CD.
      Insert CD into CD-ROM drive. The Cygnus installation will start; if it doesn't, open the CD in the Windows Explorer and open setup.exe.
    2. Install the tools.
* To name the Windows operating systems, Cygnus uses the standards of “NT4.0-sp3” for Windows NT 4.0/service pack 3, and “95-osr2” for Windows 95/operating system revision 2.
The 486, 586 and 686 are the supported versions.
IMPORTANT: There is no support for rebuilding cross-configurations for the Windows 95 and 98 versions; rebuilding is only available for the NT version. 

Rebuilding GNUPro Toolkit

To rebuild, see Rebuilding from source.

Top|Contents|Previous|Next