8. Remove
public write access restrictions from'/usr/cygnus'.
See your system administrator for
the correct permissions at your site.
You're done! Now, anyone with '/usr/gnupro-98r2/bin'
in their PATH can use this GNUPro Toolkit package.
Using your Cygnus customer ID (see cover letter), report
problems by using the Web; see Reporting problems
for details.
Installation
information for Unix
The following documentation describes
host-specific information and installation standards for Unix systems.
Platform
names
Your package
contains a label that indicates the host (and target, if applicable) with
which to configure the binaries. The specifications used for hosts
and targets in the configure script are based on a three-part
naming scheme, though the scheme is slightly different between hosts and
targets.
architecture-vendor-operating system
Host
names
Naming
hosts shows the usage of canonical names for referring to the corresponding
host platforms that Cygnus supports. For any questions about compatibility,
contact Cygnus (see How
to contact Cygnus).
configure can represent
a very large number of target name combinations of architecture, vendor,
and object formats. Support is not possible for all combinations.
config.guess
is a shell script that attempts to deduce the host type from which it is
called, using system commands like uname if they are available.
config.guess
is remarkably adept at deciphering the proper configuration for your host;
if you are building a tree to run on the same host on which you're building,
we recommend not specifying the hosttype argument.
config.guess
is called by configure; you need
never run it by hand, unless you're curious about the output.
Links
for easy access and updating
Once you extract
the tools from the CD, they are installed into a directory named 'installdir/gnupro-98r2' where 'installdir' refers to the
full directory pathname within which you're locating the 'gnupro-98r2'
files.
For example,
if you've installed in the default location under /usr/cygnus,
use the following input.
ln -s /usr/cygnus/gnupro-98r2 /usr/cygnus/gnupro
The release
number is in the directory name so that you can keep several releases installed
at the same time, if you wish. In order to simplify administrative procedures
(such as upgrades to future Cygnus releases), we recommend that you establish
a symbolic link
of '/usr/cygnus/gnupro' to this directory with the following input.
ln -s installdir /gnupro-98r2 installdir /gnupro
Note:
The input for the last two
examples of input match (installdir means the same location
as the default that you assign for usr/cygnus.
Directories
of machine-independent files (source code and documentation) are
installed directly under 'gnupro-98r2'. However, to accommodate
binaries for multiple hosts in a single directory structure, the binary
files for your particular host type are in a subdirectory 'H-hosttype'.
(hosttype indicates a particular architecture, vendor and
operating system; see Host namesfor more specific details on names for input.)
This means that one more level of symbolic links is helpful,
to allow your users to keep the same execution path defined even if they
sometimes use binaries for one machine and sometimes for another. Even
if this doesn't apply now, you might want it in the future; establishing
these links now can save your users the trouble of changing all their paths
later.
The idea is to build '/usr/gnupro/bin'
on each machine so that it points to the appropriate binary subdirectory
for each machine--for instance, '/usr/cygnus/gnupro-98r2/H-hosttype'
where 'hosttype' corresponds to the host machine.
You may need super-user
access again briefly to establish the following link.
We recommend building these links
as the last step in the installation process.
Setting
PATH
To run the tools in this distribution,
make sure the PATHenvironment
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 newly installed tools.
If you create the symbolic
links we recommend (see Links
for easy access and updating), users who want to run the GNUPro Toolkit--regardless
of whether they need binaries for your particular host, or for some other
platform--can use initialization files
settings. The following shows examples with the final linked installation
directory as /usr/gnupro/bin . If you installed into a different
directory, substitute ` /usr/gnupro/bin'
for the actual directory.
For Bourne-compatible shells
(/bin/sh , bash, or Korn shell):
% PATH=/usr/gnupro/bin:$PATH
% export PATH
For C
shell:
% set path=(/usr/gnupro/bin $path)
Installing
on Win 95/NT systems from CD
All releases
of GNUPro Toolkit for Win95/NT 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. Determine
where to install the tools.
Setup
prompts for an installation directory; the default is 'C:\Program Files\Cygnus
Solutions\gnupro-98r2'. The tools may be installed in any directory
or drive.
Make sure the installation directory is where you want
to install the files. Check the box for installing souce code files, if
that is an option you require.
Click Next.
3. Ensure
adequate disk space for the installation.
Setup
first checks the installation location to make sure it has enough space
before unpacking the tools. Installed GNUPro Toolkit disk usage varies.
4. Proceed
with the automatic installation process.
Setup
reads the CD, builds the directories and expands the files.
5. Run
the programs to use the tools.
Click on the Start
button on the lower left hand corner of your screen, and choose Programs,
where Cygnus programs are found as
a shortcut. Choose Cygnus. A shell
program opens.
6. Test
the installation by building the tools with the 'MAKE'
command.
To test the installation,
change your working directory to the demo subdirectory of the
CYGNUS directory (as in the following example), and type the following
text at the prompt.
\CYGNUS\> cd C:\CYGNUS\gnupr0-98r2\demo
\CYGNUS\gnupro-98r2\demo> MAKE
This input will provide a test, ensuring a correct configuration.
7. Set up the environment
for which you'll use the tools.
For the Win95 environment,
set your working environment to the CYGNUS.BAT
initialization file, or initialize it from the Start
button at the bottom of your screen, and use the Program
menu.
For the NT environment, as
long as you use the Start button in
the lower left hand corner of your screen, you can always start the programs
as in Step 5. If not, choose Settings,
and click Control Panel. Choose System.
Make the appropriate changes according to your requirements.