Contents|Index|Previous|Next

The full UNIX installation from tape

The following steps install GNUPro Toolkit software onto your system from tape. UNIX distribution tapes include sources, binaries and HTML files.

You can install from tape if the following conditions apply.

- You are installing on a standard UNIX platform (see Host names for a list of canonical names for platforms).
- Your UNIX machine has its own device that corresponds to your distribution media (such as a DAT tape drive).
- You’re willing to use the installation directory, /usr/cygnus.
- You have enough disk space in ‘/usr/cygnus’ (see Disk space requirements for UNIX).

Install needs a non-rewinding tape device to read and install your GNUPro Toolkit software, so that the tape drive maintains the tape location at the beginning of the compressed tar file after you extract Install. See Device names for a list of default device names for each host type.

In the following procedure’s examples, the system prompt appears as ‘ #’.

1.
Decide where to install the software.

The default location is ‘/usr/cygnus/progressive-97r1a’. To use the software anywhere, you can reconfigure and re-compile from source; see Running the programs. To install in ‘/usr/cygnus’ with a symbolic link from another location or, if you don’t wish to install into ‘/usr’ at all, see Installing in a nonstandard location.

2.
Create the installation directory.

If it doesn’t already exist, make sure you create a publicly accessible directory so Install can write there. For example, if you use the default installation directory of ‘/usr/cygnus’, use the following procedure.

# su root
(enter root password to write in ‘/usr’)
# mkdir /usr/cygnus
(ignore “File exists” error if any)
# chmod 777 /usr/cygnus
# exit
(root access not needed beyond this)

3.
Check disk space

Make sure you have enough space for the tools in your chosen installation location. For the required disk usage for GNUPro Toolkit, see Disk space requirements for UNIX. Values are for binaries only, sources only, or both types.

4.
Load the GNUPro Toolkit distribution tape into your tape drive.

If your machine doesn’t have its own tape drive, extract the software to a location with a disk drive that both your host and the tape drive machine can see: then install on your host. If there is no shared disk, extract the software to the machine with the tape drive; then transfer it to your host. See Installing with a remote tape drive for details.

5.
Extract the Install script from the tape by using the following input.

tar xvf non-rewinding-tapedev Install

Remember to use a non-rewinding tape drive!

6.
Run Install, using command-line options and arguments to specify the details about your installation.

The default installation places both binaries and source under ‘/usr/cygnus/progressive-97r1a’ using the default non-rewinding tape drive for your system (see Device names).

For native toolchains only, the fixincludes process automatically makes copies of your system header files and alters them to work with GCC (your system’s header files are not changed. See Why convert system header files?).

Install now checks that your distribution is correctly installed.

7.
Make sure the send-pr utility knows your customer ID. Call Cygnus Solutions at +1 408 542 9601 if you do not know your customer ID.

Install your customer ID by using the install-sid program, as follows.

# cd /usr/cygnus/progressive-97r1a/H-hosttype/bin
# install-sid customer-ID

8.
Create symbolic links.

Symbolic links make your newly installed GNUPro Toolkit easily accessible to developers, co-existent with other GNUPro Toolkit installations in a heterogeneous environment, and easy to update when you install a new GNUPro Toolkit. The nature of the links depends on where you install the GNUPro Toolkit release, but they correspond to the following example’s input.

If you install in ‘/usr/cygnus/progressive-97r1a’, use the following links.

ln -s /usr/cygnus/progressive-97r1a /usr/cygnus/progressive
ln -s /usr/cygnus/progressive/H-hosttype /usr/progressive

See Links for easy access and updating for more information.

You’re done!

The installation is now online; anyone with ‘/usr/progressive/bin’ in their path has access to the toolkit.

If you changed permission status on the directory, ‘/usr/cygnus’, see your system administrator for the proper permissions to change at your site.