
                 INSTALLATION NOTES FOR THE EPCA DRIVER

The file epca-1.50-1.src.rpm is the Linux EPCA source code rpm package, to
be built on any architecture.  You must have the rpm (RedHat Package Manager)
facility installed on your machine. 

NOTE: If building on an architecture other than Intel x86/Pentium PC, replace
      the occurances of i386 with the appropriate architecture string.  Some
      intel based distributions also use i486/i586/i686.

NOTE: Additional options to the rpm commands such as --replacefiles may
      be appropriate in some cases.  Please read the rpm man page for
      additional information concerning the options available to you.

WARNING: Existing EPCA drivers should be removed (rpm -e epca) before this
         driver is installed.  Additionally, the epca driver that is included
         in the kernel source should not be enabled when this driver is to
         be used.



1) INSTALLATION

  This driver is distributed both as a source RPM and as a compressed tar
  file of the source.
 
  For those not familiar with source RPMs, Digi has created a 'digirpm'
  shell script which can be used to automatically compile the provided
  source RPM.  The digirpm script will then install the resulting binary
  RPM automatically.  The digirpm script is part number 80006862 and is
  available at http://support.digi.com/support/drivers/linux/

  Alternately, you can build and install the package youselfe with the
  following commands (some systems use '/usr/src/packages' or other
  directories instead of /usr/src/redhat):

      rpm -ivv epca-1.50-1.src.rpm
      cd /usr/src/redhat
      rpm -bb SPECS/epca.spec
      rpm -ihv RPMS/i386/epca-1.50-1.i386.rpm

 
  If you install the tar file of the source, it should be untarred as
  /usr/src/dg/epca and "make install" should be run as root from within
  the created directory.
 
  In order to make the driver available for use, you must cause the driver
  to be loaded.  This can be accomplished on RedHat distributions by doing
  a "chkconfig --add epca" to enable the driver rc scripts for start and
  stop at system reboot and shutdown.  On other distributions, you should
  link the epca startup script as appropriate.  The epca installation
  package will automatically detect if your system uses "/etc/rc.d/init.d/"
  or "/etc/init.d/" but other possible locations such as "/sbin/init.d/"
  that might be used by some distributions would need to be configured
  by hand.

  To load the driver, either run run the script as appropriate.  To load
  the driver, either run the script manually (for example, on RedHat,
  "/etc/rc.d/init.d/epca start") or reboot the system.

  However, the driver must be configued with the boards installed before
  it will actually load.  See the Configuration section immediately below.



2) CONFIGURATION

  After installing the driver package, you must configure the driver.  
  This is done by running the command "digiConf".

  This will run through a series of questions about your currently
  installed Digiboards.  If you have ISA Digiboards, it will be useful
  to have all the information about the configuration of your Digi
  products, (I/O addresses, the shared memory address you wish to use,
  etc.) as the digiConf program will ask you about this information.
 
  Once you've completed this step, you may load the driver as described
  above by loading the driver initialization script, using the command:

  /etc/rc.d/init.d/epca start



3) VERIFYING THE INSTALLATION

  You can check if the EPCA package is installed using the verfify (-V)
  command line option:

      rpm -V -vv epca



4) REMOVING THE EPCA DRIVER

  If you have built and installed the rpm binary package as described
  above, then you can use rpm to remove it.  Simply use the erase (-e)
  command line option:

      rpm -e -vv epca

  NOTE: If you currently have your EPCA driver loaded, this will try and
        automatically remove the module from your running kernel with the
        command "rmmod epca". 



5) CUSTOMIZING THE PACKAGE

  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.
  You may want to do this to update the paths used for various files such
  as the firmware or digiConf if you are not satisified with the defaults.
  To access the Makefile, you have to first unpack the tgz file:

      rpm -ivv epca-1.50-1.src.rpm
      cd /usr/src/redhat
      rpm -bp SPECS/epca.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 a 
  /usr/src/redhat/BUILD/epca-1.50-1 directory and unpack the tarfile
  there.  

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

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

  NOTE: 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/epca.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 as well as change the "Release:" and
        "Packager:" tags to identify your new package.

  There are several ways to install the driver package at this point, but
  the following is the easiest, and safest way (this will replace the
  original source code provided by the package and then build the package):

      cd /usr/src/redhat/BUILD 
      tar -cvzf ../SOURCES/epca-1.50-1.tgz epca-1.50-1/*
      cd /usr/src/redhat
      rpm -bb SPECS/epca.spec
      rpm -ihv RPMS/i386/epca-1.50-1.i386.rpm



6) DESCRIPTION OF THE RPM PROCESS

  The rpm process described in section 1 of this document has 3 basic steps:

      1 - Install the source RPM package
      2 - Build the binary RPM package from the source
      3 - Install the binary RPM package

  The first command (rpm -ivv epca-1.50-1.src.rpm) installs the source
  code in the SOURCES directory used by RPM (/usr/src/redhat/SOURCES) and
  the RPM specification file in the SPECS directory.  The actual source code
  is distributed as a gzipped tar file and is also available seperately.  The
  specification file (or spec file for short) is just a text file with some 
  script like commands, package information and file list.  

  The second command (rpm -bb SPECS/epca.spec) builds the binary RPM package 
  from the tarred and gzipped source file in the SOURCES directory and the
  instructions contained in the spec file.  If the build completes without
  error, you will see a message like:

      "Wrote:  /usr/src/redhat/RPMS/i386/epca-1.50-1.i386.rpm"

  The third command (rpm -ivv RPMS/i386/epca-1.50-1.i386.rpm) installs
  the generated binary RPM on the system.  This package is ONLY valid for the
  same kernel version, architecture, and SMP vs Uniprocessor as the machine 
  it was generated on.  However, if all of these factors match, the binary
  RPM can be copied elsewhere and installed without problems.
