--------------------------------------------------------------------------------
Diva Server for Linux - Quick Install
--------------------------------------------------------------------------------

First Edition (February 2002)	   227-252-01

Diva ISDN is a registered trademark of Eicon Networks Corporation.
Linux is a registered trademark of Linus Torvalds.
All other brand and product names are trademarks or registered trademarks
of their respective owners.
This distribution contains programs the are licensed under GNU General Public 
License (GPL). Those programs are copyrighted by their respective owners and 
distributed under the terms of the GNU General Public License included in this
package.  If you have not received a copy of such license you may obtain it by 
writing to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, 
Boston, MA  02111-1307  USA.
Changes are periodically made to the information herein; these changes will be
incorporated into new editions of the publication. Eicon Networks may make
improvements and/or changes in the products and/or programs described in this
publication at any time.
For information on contacting Customer Services see the printed guide that came
with your adapter.
Eicon Networks may use or distribute whatever information you supply in any
way it believes appropriate without incurring any obligations to you.
Copyright 2002 Eicon Networks Corporation. All rights reserved, 
including those to reproduce this publication or parts thereof in any form 
without permission in writing from Eicon Networks.

--------------------------------------------------------------------------------
Contents
--------------------------------------------------------------------------------
1. Selecting the right RPM package
2. Installing the RPM package
3. Configuring Diva adapters
4. Uninstalling the drivers
5. Backing up and restoring the Diva adapter configuration
6. Stopping and unloading the Diva drivers manually
7. Loading and starting the Diva drivers manually
8. Preventing Diva drivers from being loaded at system start
9. Troubleshooting

--------------------------------------------------------------------------------
1. Selecting the right RPM package
--------------------------------------------------------------------------------
Diva drivers are provided as RPM package in binary form and can only 
be used with the kernel version for which they are compiled.

To select the right RPM package you need to know the following:
- The name of the distribution that you are using. To obtain the 
  distribution name, execute: 'cat /etc/*-release'. 
  Example: If you use SuSE 7.3 for example, the command will return:
    SuSE Linux 7.3 (i386)
    VERSION = 7.3
- The kernel version that you are using. To obtain the kernel 
  version, execute: 'uname -r'. 
  On SuSE 7.3, for example, you will see: 2.4.10-4GB.
- The type of hardware that you are using. Do you use a 
  multiprocessor or a uniprocessor kernel?

Based on this information, you can select the right RPM package.

Examples:
The RPM package name for a system that is running SuSE 7.3 with the 
uniprocessor kernel 2.4.10-4GB on a uniprocessor machine is
divas4linux_2_4_10_SUSE73_4GB-XXX.YYY-1.i386.rpm
- where XXX.YYY is the Eicon product version

The RPM package name for a system that is running SuSE 7.3 with the
multiprocessor kernel 2.4.10-64GB-SMP on a multiprocessor machine 
is: divas4linux_2_4_10_SUSE73_SMP_64GB-XXX.YYY-1.i386.rpm
- where XXX.YYY is the Eicon product version.

--------------------------------------------------------------------------------
2. Installing the RPM package
--------------------------------------------------------------------------------
In order to install the RPM package, you must have system 
administrator (root) privileges.

To install the RPM package, run the command 'rpm -i rpm_package_name' 
- where rpm_package_name is the RPM file name.

Note that RPM will abort the installation and report an error if:
- another package version is already installed. Remove the installed
  RPM package and re-run the 'rpm -i' command (see paragraph 4 for 
  information on how to remove the RPM package).
- you try to install a multiprocessor RPM package on a uniprocessor 
  system. This is also true if you are using a multiprocessor 
  kernel on a uniprocessor system. (Distributors like RedHat and 
  SuSE do not recommend to run a multiprocessor kernel on a 
  uniprocessor system.)
- you try to install a uniprocessor RPM package on a multiprocessor
  system.

--------------------------------------------------------------------------------
3. Configuring Diva adapters
--------------------------------------------------------------------------------
In order to be able to configure the Diva drivers, you must have 
system administrator (root) privileges.

To start the Diva Configuration Wizard, execute: 
'/usr/lib/eicon/divas/Config'

Select the wizard that suits your requirements. If your kernel or 
terminal do not support dialog-based wizards, select the console-
based wizard.

The Diva Configuration Wizard guides you through a series of 
menus that allow you to select the appropriate system profile 
and adapter configuration. 
Make sure that you select the appropriate national or local ISDN protocol 
and switch type for your configuration. Your local switch provider can 
provide this information.
When you confirm the menus with the ENTER key, the default values are used. 
They are appropriate for most application scenarios so that you need to 
modify them only in special environments.

For further information on configuration options, see 
the Diva Server for Linux Reference Guide. To locate the reference
guide, type: 'rpm -q -a -d|grep divas4linux'. 

After exiting the Diva Configuration Wizard, you can immediately 
start the drivers without a system restart. To do so, run the 
command '/usr/lib/eicon/divas/Start'.


--------------------------------------------------------------------------------
4. Uninstalling the drivers
--------------------------------------------------------------------------------
In order to be able to remove the Diva RPM package, you must have 
system administrator (root) privileges.

To uninstall the Diva drivers, execute 
'rpm -e $(rpm -q -a | grep divas4linux)'.
This command automatically detects the installed RPM package
version, stops the Diva adapters, unloads the Diva drivers and 
removes all installed Diva drivers and supplementary files.

If Diva drivers are still used by an application or device driver 
when the uninstall process is started, RPM aborts the uninstall
operation and informs you which Diva driver caused the abort.

Stop all applications that access this driver and repeat the package
uninstall procedure. 

If you cannot locate or stop the applications, change to the 
'/usr/lib/eicon/divas' directory. Execute 'sh cfg_util.sh 2' and 
restart your system.
The drivers will not be loaded at system startup and you can repeat 
the RPM uninstall procedure.

--------------------------------------------------------------------------------
5. Backing up and restoring a Diva adapter configuration
--------------------------------------------------------------------------------
To back up a configuration of Diva adapters, save the file
'/usr/lib/eicon/divas/divas_cfg.rc'. You can do so by renaming it to
'divas_cfg.rc.bak' for example.

To restore the saved configuration, rename the back-up file to 
'divas_cfg.rc'. Make sure the file is located in the 
'/usr/lib/eicon/divas' directory and execute
  'chown 0   /usr/lib/eicon/divas/divas_cfg.rc'
  'chgrp 0   /usr/lib/eicon/divas/divas_cfg.rc'
  'chmod 744 /usr/lib/eicon/divas/divas_cfg.rc'
in order to restore file permissions.

--------------------------------------------------------------------------------
6. Stopping and unloading the Diva drivers manually
--------------------------------------------------------------------------------
To stop the drivers manually, execute '/usr/lib/eicon/divas/Stop'.

--------------------------------------------------------------------------------
7. Starting the Diva drivers manually
--------------------------------------------------------------------------------
To start the drivers manually, execute '/usr/lib/eicon/divas/Start'.

--------------------------------------------------------------------------------
8. Preventing Diva drivers from being loaded at system start
--------------------------------------------------------------------------------
By default, Diva drivers are loaded and started at system load time 
(run levels 2, 3, and 5). This is managed by the 'S03DIVAS4LINUX' 
symbolic links located in the appropriate system directories.
To remove these symbolic links, change to the '/usr/lib/eicon/divas'
directory and execute 'sh cfg_util.sh 2'.
To restore these symbolic links, execute 'sh cfg_util.sh 1'.

--------------------------------------------------------------------------------
9. Troubleshooting
--------------------------------------------------------------------------------
If you should have any problems to install or use your Diva Server adapter, 
refer to the Diva Server for Linux Troubleshooting FAQ and Reference Guide.
To locate these guides, type 'rpm -q -a -d|grep troubleshooting' or
'rpm -q -a -d|grep divas4linux'.