Medusa Linux installation manual

1.Unpack your kernel to  /usr/src/linux.

2.Unpack distribution (for your kernel version).

3.Run: ./install.sh from drivers package (it will embed driver into Linux kernel)

4.Configure your kernel:
make xconfig or make menuconfig or make config

Enable GENERIC HDLC driver, and protocols:
Choose Y or M for driver "Generic HDLC Driver" in
/Network Device Support/Wan interfaces/Generic HDLC Driver

Choose for any other protocols you want to use:
Raw HDLC - IP over HDLC encapsulation
Raw HDLC Ethernet - Also called tinybridge, 
		    Ethernet over HDLC with crc16 encapsulation
Cisco HDLC
Synchronous PPP (without authorization)
Frame Relay HDLC
CCITT X.25 over HDLC

Enable Medusa driver:
Choose Y or M for for driver "MEDUSA support"
  
5.Compile your kernel:
make clean
make dep
make bzImage
make modules
make modules_install

6.Compile and install configuration utilities: 
make utils; make install

7.Reboot kernel 

8.Load modules and install protocol (If you choosed M while configuring kernel for GENERIC HDLC and MEDUSA support):
  modprobe hdlc
  modprobe medusa

9.Configure interface with medusacfg utility (Medusa adapters)
    or med3cfg utility (Medusa3 adapters):
Try "medusacfg" or 'med3cfg -h' for details.

10.Configure HDLC link level protocol for medusa interface with sethdlc:
sethdlc <Interface name> <mode>
  Interface name - hdlc0, hdlc1, ...
  mode - hdlc, cisco, ppp, fr-ansi, fr-ccitt.
Start: "sethdlc ?help" for details.
type "sethdlc hdlc0 cisco ether" to be able to add hdlc0 to 802.1d 
  compatible Ethernet Bridge group (see man brctl).

Warning: sethdlc is used for configurint HDLC stack, not hardware !
It will not crush your system, but it's useless for hardware configuration.

11.Configure interface with ifconfig
ifconfig < interface > <ip1> pointopoint <ip2>

12.Try ping <ip2>

There is sample scripts called up.sh, up2.sh, down.sh provided.
Kernel versions tested - 2.4.22 and 2.4.28.
The most robust source - from kernel.org

Website: http://eng.parabel.inc.ru/
support: support@parabel.inc.ru
