	INSTALLATION NOTES FOR THE RPM SRC PACKAGE

The Digi Port Authority - Remote (DPAR) source rpm is distributed as:

    40002188_G.src.rpm

If you would prefer, you can rename this file on your host to:

    digidpar-3.03.46-0.src.rpm

WARNING:  do not attempt to install this package if there is already a 
Digi Port Authority - Remote (DPAR) running

for the truly impatient
-----------------------
Execute the following commands:
	1> rpm -ivv 40002188_G.src.rpm
		(prepare for installation)
	2> cd /usr/src/redhat/SPECS
	3> rpm -bi digidpar-3.03.46.spec
		(perform make and install)

for the slightly less impatient
-------------------------------
The above commands make and install a working Digi Port Authority - Remote.
However, rpm does not recognize this as an installed package yet.  In 
order to use the full capabilities of the rpm utilities, one needs to 
go a step further and install this package on their machine.
To do this, use instead the following set of commands:

	1> rpm -ivv 40002188_G.src.rpm
		(prepare for installation)
	2> cd /usr/src/redhat/SPECS
	3> rpm -bb digidpar-3.03.46.spec
		(perform make and install and makes the binary rpm)
	4> cd /usr/src/redhat/RPMS/<arch>
	5> rpm -ivv digidpar-3.03.46-0.<arch>.rpm	
		(install the package)

for the rest of us
------------------
Ignore the above and read on...
Most of the rpm commands allow for -v or -vv to turn on verbose and
double verbose output.

about the package
-----------------
The file 40002188_G.src.rpm is the Digi Port Authority -
Remote for Linux source code rpm package.  You must have the rpm (Red
Hat Package Manager) facility installed on your machine. 

first things first
------------------
	1> rpm -ivv 40002188_G.src.rpm
The fist command installs the source code in the SOURCES directory used
by RPM (/usr/src/redhat/SOURCES).  The actual source code is distributed
as a zipped tar file.  This command also copies the spec file to the
SPEC directory.  /usr/src/redhat/SPECS/digidpar-3.03.46.spec
is just a text file with some script like commands, package information
and file list.  

installing using the defaults
-----------------------------
You are now ready to install the DPAR package.  If you want to
just use the default settings, the build is simple and can be performed
by issuing the commands:

	2> cd /usr/src/redhat/SPECS
	3> rpm -bb digidpar-3.03.46.spec
		(perform make and install and makes the binary rpm)

This will attempt to create an rpm binaries package.
If the build completes without error, you will see the message 
"Wrote:  /usr/src/redhat/RPMS/<arch>/digidpar-3.03.46-0.<arch>.rpm"

	4> cd /usr/src/redhat/RPMS/<arch>
	5> rpm -ivv digidpar-3.03.46-0.<arch>.rpm
		(install the package)

You now have your very own copy of the Digi Port Authority - Remote
package compiled for your specific architecture and kernel version!  It
can be found in /usr/src/redhat/RPMS/<arch>/digidpar-3.03.46.<arch>.rpm 
Next time you do an installation on a machine with the same 
configuration you need just do 
	
	> rpm -ivv digidpar-3.03.46-0.<arch>.rpm


custom installation
-------------------
If you need to customize the Makefiles to reflect your own
configuration or modify the source code, this will need to be done prior
the build.  To access the Makefile, you have to first unpack the tgz
file:

	2> cd /usr/src/redhat/SPECS
	3> rpm -bp digidpar-3.03.46.spec

The "-bp" in the options specifies that only the prep section of the
spec file should be executed.  This will, among other things, create the
/usr/src/redhat/BUILD/digidpar-3.03.46 directory and unpack
the tarfile there.  

	4> cd ../BUILD/digidpar-3.03.46

You may then make any necessary changes to the Makefile and source code.

WARNING:  you might want to now save the final version of your changes 
somewhere other than in the /usr/src/redhat tree for backup.

WARNING:  if you change the final location that any of the files in the 
package, you will also want to update the %file list in the spec file
/usr/src/redhat/SPECS/digidpar-3.03.46.spec  Otherwise, RPM
will complain that the installation was incomplete because some files
were not found.  You can also document your changes in the %description
section, if you so desire.

There are several ways to install the driver package at this point, but
the following is the easiest, and safest way:

	5> cd /usr/src/redhat/BUILD 
	6> tar -cvzf ../SOURCES/digidpar-3.03.46.tgz digidpar-3.03.46/*
	(this will replace the original source code provided by the package)

You can now execute commands 2 through 6 from the section "installing
using the defaults" to install your customized rpm.

verifying the package
---------------------
You can check if the Digi Port Authority - Remote package is installed 
using the verfify (-V) command line option:
	> rpm -V -vv digidpar-3.03.46

removing the Digi Port Authority - Remote package
-----------------------
If you have built the rpm binaries package as indicated, then you can
use rpm to remove it.  Simply use the erase (-e) command line option:
	> rpm -e -vv digidpar-3.03.46


