Section Navigation

Solaris Install Routine - Functional Specification

Description

This document describes the installation of the InterBase Server and client files on Solaris only. For a complete installation procedure please refer to Unix Install Functional Spec . Pre 6.0 InterBase had only one package which installed the entire InterBase fileset on a machine. In InterBase V6.0, we'll ship two packages, i.e. an (1.) "InterBase Client Server" and an (2.) "InterBase Client Only" package. The contents of package 1 will remain exactly as in pre InterBase V6.0 versions. Package (2.) is new and its contents are as follows:

interbase/bin/gbak
interbase/bin/gdef
interbase/bin/gfix
interbase/bin/gpre
interbase/bin/iblicense
interbase/bin/isql
interbase/bin/qli
interbase/doc/*
interbase/examples/* (Note: *.gdb files are not included)
interbase/include/*
interbase/interbase.msg
interbase/lib/
interbase/lib/gdsmt.so.0
interbase/license.txt
interbase/install.txt

User Interface/Usability

Unlike HP-UX, InterBase on solaris makes use of the OS specific install utility called pkgadd. pkgadd installs the software from a specified package, runs any mentioned scripts and updates the machine's package infobase. Similarly to uninstall there is a pkgrm utility which reads the package infobase and removes all the installed files.

As mentioned in the Unix Install Functional Spec , pkgadd will be launched from setup.ksh script.

In case of the "Install InterBase Client and Server software" the setup script does following:
Print out following message "Starting InterBase Client and Server Install, please wait..."
set NONABI_SCRIPTS=TRUE
export NONABI_SCRIPTS
pkgadd -d CDROM_DIR/Interbase6.0_ClientServerpkg
Depending on the return status, print out the corresponding message

In case of the "Install InterBase Client Only software" the setup script does following:
Print out following message "Starting InterBase Client Only Install, please wait..."
set NONABI_SCRIPTS=TRUE
export NONABI_SCRIPTS
pkgadd -d CDROM_DIR/Interbase6.0_Clientpkg
Depending on the return status, print out the corresponding message

The following is a sample output from pkgadd utility while installing interbase 6.0 client package:

pkgadd -d /cdrom/Interbase6.0Clientpkg

The following packages are available:
1 IBC6.0 InterBase Client only
(sparc) InterBase Version 6.0

Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1

Processing package instance <IBC> from </usr/gds.falcon2/work/BUGS/SolInstall/Client/clpkg>

InterBase Client only
(sparc) InterBase Version 6.0
Copyright (c)1998,1999, InterBase Software Corporation
All Rights Reserved

Enter the absolute path name of the install directory [?,q] /usr/gds.falcon2/ZZZ
ERROR: Pathname does not exist.

Enter the absolute path name of the install directory [?,q] /usr/gds.falcon2/tmp
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying package dependencies.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.

This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation of <IBC> [y,n,?] y

Installing InterBase Client only as <IBC>

## Installing part 1 of 1.
/usr/gds.falcon2/tmp/interbase/bin/gbak
/usr/gds.falcon2/tmp/interbase/bin/gdef
/usr/gds.falcon2/tmp/interbase/bin/gfix
/usr/gds.falcon2/tmp/interbase/bin/gpre
/usr/gds.falcon2/tmp/interbase/bin/iblicense
/usr/gds.falcon2/tmp/interbase/bin/isql
/usr/gds.falcon2/tmp/interbase/bin/qli
/usr/gds.falcon2/tmp/interbase/doc/APIGUIDE/APIGUIDE.PDF
/usr/gds.falcon2/tmp/interbase/doc/DATADEF/DATADEF.PDF
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX.PDX
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/ASSISTS/00000001.WLD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/ASSISTS/00000002.WLD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/ASSISTS/00000005.ABT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/ASSISTS/00000006.ABT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/ASSISTS/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/MORGUE/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PARTS/00000000.DDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PARTS/00000000.DID
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PARTS/00000001.DDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PARTS/00000001.DID
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PDD/00000001.PDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/PDD/00000002.PDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.DDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.DID
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.PDD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.PLC
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.STP
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/STYLE/STYLE.WLD
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/TEMP/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/TEMP/T91C05F8.ABT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/TOPICIDX/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/TRANS/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/TRANS/DATA.TRN
/usr/gds.falcon2/tmp/interbase/doc/IB5INDEX/WORK/ACROCAT.CAT
/usr/gds.falcon2/tmp/interbase/doc/LANGREF/LANGREF.PDF
/usr/gds.falcon2/tmp/interbase/doc/OPGUIDE/OPGUIDE.PDF
/usr/gds.falcon2/tmp/interbase/doc/PROGGD/PROGGD.PDF
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/DOMAINS.SQL
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/INSERTS.SQL
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/PROCS.SQL
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/TABLES.SQL
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/TRIGGERS.SQL
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/TUTORIAL.PDF
/usr/gds.falcon2/tmp/interbase/doc/TUTORIAL/UPDATES.SQL
/usr/gds.falcon2/tmp/interbase/examples/README
/usr/gds.falcon2/tmp/interbase/examples/align.h
/usr/gds.falcon2/tmp/interbase/examples/api1.c
/usr/gds.falcon2/tmp/interbase/examples/api10.c
/usr/gds.falcon2/tmp/interbase/examples/api11.c
/usr/gds.falcon2/tmp/interbase/examples/api12.c
/usr/gds.falcon2/tmp/interbase/examples/api13.c
/usr/gds.falcon2/tmp/interbase/examples/api14.e
/usr/gds.falcon2/tmp/interbase/examples/api15.c
/usr/gds.falcon2/tmp/interbase/examples/api16.c
/usr/gds.falcon2/tmp/interbase/examples/api16t.c
/usr/gds.falcon2/tmp/interbase/examples/api2.c
/usr/gds.falcon2/tmp/interbase/examples/api3.c
/usr/gds.falcon2/tmp/interbase/examples/api4.c
/usr/gds.falcon2/tmp/interbase/examples/api5.c
/usr/gds.falcon2/tmp/interbase/examples/api6.c
/usr/gds.falcon2/tmp/interbase/examples/api7.c
/usr/gds.falcon2/tmp/interbase/examples/api8.c
/usr/gds.falcon2/tmp/interbase/examples/api9.c
/usr/gds.falcon2/tmp/interbase/examples/api9f.c
/usr/gds.falcon2/tmp/interbase/examples/api9f.sql
/usr/gds.falcon2/tmp/interbase/examples/apifull.c
/usr/gds.falcon2/tmp/interbase/examples/dyn1.e
/usr/gds.falcon2/tmp/interbase/examples/dyn2.e
/usr/gds.falcon2/tmp/interbase/examples/dyn3.e
/usr/gds.falcon2/tmp/interbase/examples/dyn4.e
/usr/gds.falcon2/tmp/interbase/examples/dyn5.e
/usr/gds.falcon2/tmp/interbase/examples/dynfull.e
/usr/gds.falcon2/tmp/interbase/examples/employe2.sql
/usr/gds.falcon2/tmp/interbase/examples/employee.gbk
/usr/gds.falcon2/tmp/interbase/examples/employee.gdb
/usr/gds.falcon2/tmp/interbase/examples/example.h
/usr/gds.falcon2/tmp/interbase/examples/ib_udf.sql
/usr/gds.falcon2/tmp/interbase/examples/intlemp.gbk
/usr/gds.falcon2/tmp/interbase/examples/intlemp.gdb
/usr/gds.falcon2/tmp/interbase/examples/makefile
/usr/gds.falcon2/tmp/interbase/examples/stat1.e
/usr/gds.falcon2/tmp/interbase/examples/stat10.e
/usr/gds.falcon2/tmp/interbase/examples/stat11.e
/usr/gds.falcon2/tmp/interbase/examples/stat12.e
/usr/gds.falcon2/tmp/interbase/examples/stat12t.e
/usr/gds.falcon2/tmp/interbase/examples/stat2.e
/usr/gds.falcon2/tmp/interbase/examples/stat3.e
/usr/gds.falcon2/tmp/interbase/examples/stat4.e
/usr/gds.falcon2/tmp/interbase/examples/stat5.e
/usr/gds.falcon2/tmp/interbase/examples/stat6.e
/usr/gds.falcon2/tmp/interbase/examples/stat7.e
/usr/gds.falcon2/tmp/interbase/examples/stat8.e
/usr/gds.falcon2/tmp/interbase/examples/stat9.e
/usr/gds.falcon2/tmp/interbase/examples/udf.sql
/usr/gds.falcon2/tmp/interbase/examples/udflib.c
/usr/gds.falcon2/tmp/interbase/include/gds.f
/usr/gds.falcon2/tmp/interbase/include/gds.h
/usr/gds.falcon2/tmp/interbase/include/gds.hxx
/usr/gds.falcon2/tmp/interbase/include/ib_util.h
/usr/gds.falcon2/tmp/interbase/include/ibase.h
/usr/gds.falcon2/tmp/interbase/include/iberror.h
/usr/gds.falcon2/tmp/interbase/include/interbase.a
/usr/gds.falcon2/tmp/interbase/include/perf.h
/usr/gds.falcon2/tmp/interbase/install.txt
/usr/gds.falcon2/tmp/interbase/interbase.msg
/usr/gds.falcon2/tmp/interbase/lib/gds.so.0 <symbolic link>
/usr/gds.falcon2/tmp/interbase/lib/gdsmt.so.0
/usr/gds.falcon2/tmp/interbase/license.txt
[ verifying class <none> ]
## Executing postinstall script.
Updating access permissions... Creating symbolic links... Done
Creating /usr/interbase symbolic link... Done

Install completed successfully
Install log can be found at /usr/gds.falcon2/tmp/interbase/ibinstall.log

Installation of <IBC> was successful.

The following packages are available:
1 IBC InterBase Client only
(sparc) InterBase Version 6.0

Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q

Requirements and Constraints

The InterBase V6.0 "setup.ksh" script will support HP-UX and Solaris platforms only and is placed on the top level of the CD-ROM tree. The setup script depends on the CD-ROM structure so it must be updated in case the structure (especially file names) is changed.

The setup script makes the following assumptions:

Naming convention for the software on the CD-ROM:

	HP-UX	Solaris
IB Client and Server software	InterBase*_ClientServer_HUS.tar	InterBase*_ClientServerpkg
IB Client Only software	InterBase*_Client_HUS.tar	InterBase*_Clientpkg
Adobe Acrobat Reader software	Adobe/*	Adobe/*
InterClient software	InterClient*.tar	InterClient*.tar

Migration Issues

The new installation process on UNIX is slightly different from what it used to be before. The Operation's Guide should be updated accordingly.