PRO/5 Installation Guide for UNIX

The instructions in this section apply to PRO/5 prior to 2.10.

BASIS designed PRO/5 prior to 2.10 to run on the UNIX operating system supplied by UNIX System Laboratories, the XENIX operating system supplied by SCO, and many similar operating systems supplied by various manufacturers.

Typically, PRO/5 is in a compressed file format. Use the "tar" command for the installation. Backups and restore functions us this (tape archive) format as well. For more information about the use of "tar" along with its options, please consult a UNIX System User's Guide.

To begin installation, create a new user named "bbx" on the system, with a home directory of "/usr/bbx." The /usr portion of the path may differ between some UNIX and XENIX operating systems. It is best to select the filesystem that has the most free space. To determine the filesystem with the most free space, use the "df" command.

Installation Using TAR

Login as a new user and enter the following:

umask 0
chmod a+rw .
tar xvf /dev/devicefile

Where "/dev/devicefile" is the device corresponding to the distribution media type. Repeat this procedure for each piece of media.

On UNIX operating systems and similar environments, the media may be accessed by using the simplified command:

tar xv

There should be a list of files being copied into the PRO/5 directory after the tar xv command has been entered.

If the "tar" command has a problem reading the media, see if a different diskette format (type) can be used. On some XENIX operating systems the media may be accessed using a command such as:

tar xvf /dev/fd048ds9

This selects the "0" disk drive in a 48-track, double-sided, 9 sectors/track mode. In some cases, it is possible to have the system perform the proper disk-type selection automatically by using a generic disk device.

Installing Using GZIP

If the name of the BLM archive file ends in .gz, place the BLM .gz file in your BASIS product directory. Extract the files with gunzip utility ('gunzip [filename].gz'). This creates subdirectories that contain the BLM and other supporting files.

Installation Using the Product CD-ROM

If you are working with the BASIS product CD-ROM, follow these procedures.

1. Obtain the appropriate compressed tar product file (.tar.Z) for the product you want to install.

  • From the product CD-ROM, use the index.txt file from the root directory of the CD-ROM to find the compressed tar file for the specific product you want to install. Because of filename length limitations on UNIX CD-ROM filesystems, the BASIS products on the CD-ROM do not end in .tar.Z. The files are still in a compressed format, but the suffixes have been truncated to .Z to conserve space. These files can be renamed to the .tar.Z convention when copying them from your CD-ROM drive to the UNIX system.

  • From www.basis.com, select the product to download and download the appropriate port from the website.

2. Place the appropriate .tar.Z file in your BASIS product directory.

3. Uncompress the file ('uncompress<filename>).tar.Z').

4. Extract the files with the UNIX tar command ('tar xvf <filename>.tar').

5. Repeat Steps 1 through 4 for each product you want to install.

You have completed the first part of installing the BASIS product(s) and must now configure your product.

Continuing With Configuration After Reading the Media

After the PRO/5 files and utilities have been copied onto the local directory, to start the installation process enter:

./install

During the installation process, the user will be prompted for the activation key and serial number. This information is printed on the activation key and warranty registration card, which is included in the box containing the PRO/5 software. This information must be readily available in order to proceed with the installation.

After the activation key and serial number are entered, PRO/5 will be decoded and activated on the system. The user will then be prompted for information about the system printers, plotters, and terminals. This information will be used to build the config.bbx file. For more information about the config.bbx file, see The config.bbx Configuration File.

The PRO/5 installation is now complete. See Invoking PRO/5, Command Line Options for information about running PRO/5.



______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.