Extra configurations

?/!\ Graphics in the document must be inserted and updated

Simple firewall

Debian Edu's architecture suits for both centralized operations, with the placement of services centrally and can be operated locally at each school. A firewall makes it easier to start with Debian Edu's if you want to try out a small installation.

Simple firewall with floppy (Coyote)

User Case: To get started with Debian Edu's we need to make a simple firewall. The purpose is to divide Debian Edu's network from the second network that is set up.

Main author Klaus Ade Johnstad

     IP Address:

Press "n"

his refers to some extra stuff you need if you want to access from the provider Big Pond, but are not sure. Is there anyone who knows?

Press "n"

Warning: Since Skolelinux/Debian-Edu already has a DHCP server running, you must disable the DHCP server on your firewall/router. The same applies to all other machines that may be connected to a Skolelinux/Debian-Edu network. Having two DHCP servers on the same network is usually only trouble

Eksisterer en ny utgave av Coyote Linux når dette leses, kan den erstatte versjon 2.24 med kommandoene over med versjonsnummeret som ble lastet ned.

  1. After Coyote Linux is downloaded, the files must be unpacked. One must be the root user to unpack.

tar zvxf coyote-2.24.tar.gz

cd coyote


  1. When creating Coyote Linux on a Linux machine, one need to answer several questions. Here is a summary of the answers that can be supplied:

a.   Coyote floppy builder script v2.9

    Please choose the desired capacity for the created floppy:
    1) 1.44MB (Safest and most reliable but may lack space needed for
           some options)
    2) 1.68MB (Good reliability with extra space) - recommended
    3) 1.72MB (Most space but may not work on all systems or with all

    Enter selection:2

The choice recommended is «1.68MB»

b.   Please select the type of Internet connection that your system uses.

    1) Standard Ethernet Connection
    2) PPP over Ethernet Connection
    3) PPP Dialup Connection\n\nEnter Selection:

Here it is best to select 1)

c.   Configuring system for Ethernet based Internet connection.
    By default, Coyote uses the following settings for the local network

    IP Address:

    Would you like to change these settings? [Y/N]: y
    Enter local IP Address []:
    Enter local Netmask []:
    Enter local Broadcast []:
    Enter local network number []:

These network settings for local network must be changed. SeeA

   IP Address:

e.   Does your Internet connection get its IP via DHCP? [y/n]:

Answer yes(y) or no(n) in accordance with what is the network configuration.

Getting IP via DHCP, you fill in the following information:

   Please enter the information for your static IP configuration
    Internet IP Address:\nInternet Subnet Mask []:
    Internet Broadcast [Enter = Default]:
    Internet Gateway Address:
    Domain Name:
    DNS Server 1:

    DNS Server 2 (optional):

Usually, this one can be blank

We think this refers to some extra stuff that comes from the provider Big Pond, but is not sure. Is there anyone who knows send us an email.

h.   Do you want to enable the Coyote DHCP server? [y/n]: n

Here must the answer be «n»!

i.   If you don't know what a DMZ is, just answer NO\nDo you want to configure a De-Militarized Zone? [Y/N]: n

Just choose "n"

j. You now need to specify the module name and parameters for your
  network cards.

  If you are using PCI or EISA cards, leave the IO and IRQ lines

  Enter the module name for you local network card:

This is the tricky part. Knowing which module to use for network cards is sometimes difficult. See Section 3.12 to get an overview of the available modules. Remember to not use .o at the end of the module name. Use only "first name" on the module.

Many prefer 3Com. Almost all use this module 3c59x.

k.   The default language of the Coyote Web Administrator is English
    Do you like to configure a different language ? [Y/N]: n

Use English. It is much easier to get help. Search for example using Google to find solution to problems.

l.   Syslog server address:

Here you can use the main server as syslog server. Use

  1. You must insert a floppy disk in the machine. Remember to turn the write protection. It takes a few minutes to write to the disk.
  2. Be sure it does not get any error messages to unknown NIC modules, like this:

    Checking module deps for (wrong,bad)...
    Copying module: drivers/wrong.o

    Unable to copy module (drivers/wrong.o): No such file or directory

Be sure you get something like this instead:

   Checking module deps for (e100,3c59x)...
Module 3c59x dep =
Module e100 dep =
Copying module: drivers/e100.o
Copying module: drivers/3c59x.o

Solution 2 Create a Coyote Linux Floppy on a Windows machine

To create a floppy on a Windows machine is done almost the same way as on Linux.

Download the source files for Windows. They can be obtained from [http://www.coyotelinux.com/downloads/channel.php?ChannelID=5 Disk Creation Wizard v2.24.0]

Figur 3-2. Coyote Linux Windows Creator Welcome Image

Here you can just press "Next"

Figure 3-3. Local LAN network setup

Fill in necessary network information here: See A

Fill in the correct IP address and subnet mask (Netmask) and Coyote Linux will give the correct calculation of broadcast address (Broadcast) and URL (Network)

Figure 3-4. Insert a password on the Coyote Linux Floppy

Without this password you can't log into the Coyote Linux on a later occasion. See Section 3.6

Figur 3-5. Syslog-server

Leave the field blank, or look at 2.l

Figure 3-6. Type of Internet connection (WAN)

Choose what suits you. Do you have access to DHCP server, which is very likely, then you do not need more information.

Figure 3-7. Firm IP configuration

Do you have a fixed address, fill in the appropriate values here.

Figure 3-8. Do not enable the Coyote Linux DHCP server!

Do not turn on the Coyote Linux DHCP server. There is already one running on main server

Figure 3-9. Select a driver module for the network card (NIC)

Drag and drop to choose the correct network card at the Coyote Linux machine.

This particular screen uses the module for 3Com on the LAN side of the grid (Debian Edu's) and Intel pro 100 card for WAN (Internet) connection.

Figure 3-10. Select language

If you want to get good support from the Internet, choose English.

Figure 3-11. Make the disc

Place a floppy disk in the disc station and press 'Next'.

Exception handling

Our clear advice is to make at least two copies of the floppy disk. It is nice to a couple copies ready if anything should happen.



Update configuration database

Simple firewall with CD

User Case: To get started with Debian Edu's we need to make a simple firewall. The purpose is to divide Debian Edu's network from the second network that is set up.

Main author Klaus Ade Johnstad


Coyote Linux is a product in constant development and maintenance. Just like Skolelinux / Debian-edu. Meaning that new versions are released constantly, with new features and security fixes. Especially due to security fixes, you should always use the latest stable version of Coyote Linux

Since Coyote Linux runs solely from floppy, there is no system to upgrade. You must create a new floppy as described in Section 3.3. To make this process as simple as possible, there are some things to remember.

  1. Find out what kind of network you have. If this is unknown, one can use the command lsmod to list all loaded modules (drivers) in use. Maybe this will give an idea of what kind of network cards in use.

coyote# lsmod
Module                  Size  Used by
3c509                   7732   2
ip_nat_quake3           1768   0 (unused)
ip_nat_mms              2608   0 (unused)
ip_nat_h323             2060   0 (unused)
ip_nat_amanda            876   0 (unused)
ip_nat_irc              1904   0 (unused)
ip_nat_ftp              2384   0 (unused)
ip_conntrack_quake3     1848   1
ip_conntrack_mms        2704   1
ip_conntrack_h323       2065   1
ip_conntrack_egg        2280   0 (unused)
ip_conntrack_amanda     1488   1
ip_conntrack_irc        2672   1
ip_conntrack_ftp        3440   1

In this list of modules loaded for the network card 3com509 in place twice. For a list of available modules, look at

It will be best to write down at the machine itself what kind of network card is are in it.

  1. What kind of "port forwarding" is it?

Information about the "port forwarding" rules, if you have made any, is in the file/etc/coyote/portforwards

   coyote# more /etc/coyote/portforwards\nport Y tcp 2333 22 # Example - Secondary SSH

Exception handling


Update configuration database

Starting the Coyote firewall

User case: After a simple firewall is installed, it shall be installed in the network and be effective.

Author: Klaus Ade Johnstad.


There are two network cards in Coyote Linux, one (LAN) is connected to the Skolelinux/Debian-edu server, the other is connected with a crossed cable, or via a switch to another network (WAN). Sometimes it can be a bit difficult to decide which network card is which, especially if they are both connected to the same address. The method we use to determine which card is which, is to use a crossed cable and connect it to the network card in the Skolelinux/Debian-edu main server.

  1. First you start Coyote Linux without any cable network card
  2. Then use the crossed cable to connect Coyote Linux with the Skolelinux / Debian-edu main server (make sure it goes to the NIC labeled eth0 if the main server is a combined server).
  3. Login to the main server. Try to use pingel the Coyote Linux machine. Use the command ping -c10, or alternatively, try to ping the main server from Coyote Linux command ping -c10

  4. Then you get a response like this if it works:

ping -c10
PING ( 56 data bytes
64 bytes from icmp_seq=0 ttl=63 time=0.6 ms
64 bytes from icmp_seq=1 ttl=63 time=0.3 ms
64 bytes from icmp_seq=2 ttl=63 time=0.3 ms

Then you have found the network card on the Coyote Linux that must be labeled LAN. Then we know that the other network card is WAN. This procedure will only work as long as the network cards on LAN is set up properly. As shown during startup on the line

LAN network: UP

What is shown is normally

WAN network: 

Since you have started without any cables in the network card.

When the role of each of the network cards is decided, it is time to reboot the firewall with all the cables in place.

Different names on the network cards

The two network cards got two different names in Coyote Linux. This is a bit confusing and not very consistent. Here is a summary:

The various names used for network cards in Coyote Linux

This is connected to the existing network




This go to the Debian Edu network

LAN network



Reboot the Coyote Linux machine and make sure the Coyote Linux floppy disk is present in the floppy station. Enssure that the machine is configured to boot from floppy drive.

Figure 3-12. Coyote Linux Login

You can login. Use the username "root" and the password you set when you created the floppy (if this was done from Windows). or pressEnter (blank password) for logging on floppy disk created by Linux

Note: It is normal that it does not follow with any feedback when you taste a password in a Linux system. This is to reveal as little as possible for the password.

Exception handling

meny, menu, status of the network, down

Once you have entered, press 'c' to get the status of the network. In case there is a problem:

Figure 3-14. menu, status of network, up

If everything went well, both will be "up"

Q: It looks like the network card (LAN) going to to the Skolelinux/Debian-edu network is not working: DOWN

Q: It looks like the network card (WAN) connected to the Internet, is not working: DOWN

Q: We have set up firewalls with many different driver modules for many network cards. We have yet to find something not working properly.

Q:It looks like the network card (LAN) going to to the Skolelinux/Debian-edu network is not working: DOWN

A:Did you set up your network card according to the A, but still do not work. You may have chosen the wrong driver for your network card

Q:It looks like the network card (WAN) connected to the Internet, is not working: DOWN

A:There are usually two reasons why the WAN network card is not up (UP):

  1. You use a connection with the wrong Internet connection. So you have to look anew at 2.b

If you have a connection with a DHCP-assigned address, which is not static. Then it must be a physical connection with a network between Coyote Linux and the net contact

  1. You have chosen the wrong driver module for this network card.

You should attempt to login to Coyote Linux and choose q) quit to go out of Coyote Linux menu. So you should run the command


so use mellomrom to scroll. Look for references to eth0 and eth1. Look at Different names to the network cards for a reminder of what eth0 and eth1 means. Usually it is an indicator of what the problem is.

Q:We have sat up firewalls with many different driver modules for many network cards. We have yet to find any not working properly.

A:Do you have you looked at this site for more information about network card and corresponding driver modules for Coyote Linux? [http://www.dalantech.com/ http://www.dalantech.com]


The firewall works if you enter the Internet browser via the main server or a connected client.

Update configuration database

Administration of firewall in browser (Coyote)

User Case: We need to change the settings in the firewall. The firewall is locked in the computer room. May I make the change over the network.

Author: Klaus Ade Johnstad.

Co-author: Knut Yrvin

Coyote Linux has a pretty and a functioning administration tool via a website. Here you can do it all. Write [] in the address field of your browser. The address will provide web administration for Coyote Linux. Click on the link and enter your user name root and password you created for the firewall.

Coyote Linux web administration

All options and settings can be done in Main Menu on the left side.

Coyote Linux Main Menu

Choosing this, gives the status of your network cards, IP addresses in place, uptime for Coyote Linux, Ist and the like.

Here you have the possibility to reconfigure the LAN network card. It goes to the Skolelinux/Debian-edu network. Leave the values as they are. Refering to A.

Warning: Do not make changes here! Doing so may reduce the performance of Skolelinux/Debian-edu network

< FIXME: Should describe the contents of change_ip_setup her, senere>

Here you have the possibility of changing the values in WAN network card connecting to the Internet. If you have got a new ISP, or change a dynamically assigned by DHCP to a fixed IP address, this is the place to change the information without the need of creating a new Coyote Linux floppy from scratch. See 2.b

This provides the posibility to configure DHCP server as part of Coyote Linux

Her kan man skru på og av tjenester som navnetjener (DNS), ssh og vev-admin.

Here you may change and enable port forwarding in Coyote Linux. This is a neat feature in a Skolelinux/Debian-edu network. Since Coyote Linux stops and blocks most connections for example ssh, it's nice to use port forwarding. This is a way to let ssh connections through Coyote Linux to a Skolelinux/Debian-edu- network.

Use this rule for port forwarding

   Yes         TCP         Any         22         22         No           SSH straight into Mainserver

all ssh-connections coming to Coyote Linux will be forwarded to the Skolelinux/Debian-edu main server. You need to decide if this is desired.

Here you can set up and configure the firewall rules in Coyote Linux. There are many rules ready to use and can be used as an example.

Here you can set up restrictions on network capacity

Here you may change the root password i Coyote Linux, also known as system password. This is the same as using the command line Section 3.6.

These are files that contain all settings.

Here you will find useful tools like ping, testing ports (gateway), testing nameserver (DNS), and the status of the network.

Are there any changes Coyote Linux must these be saved on the diskette. By selecting Main Menu in Coyote Linux users can choose to save the setup. The alternative is that all changes are lost when you reboot Coyote Linux

When you need to start the Coyote Linux again this can be done from the "Main Menu". When choosing restart this must be confirmed.

Restart or turn off Coyote Linux?

Exception handling


Update configuration database

Firewall as a DHCP server (Coyote)

User case: Want to set up a good DHCP server with high stability regardless of operating the network. Notification: normal DHCP server in a non-Skolelinux/Debian-edu network

Author: Klaus Ade Johnstad.

Coyote Linux is a good solution if you just need a DHCP server on the network regardless of what type of machines, be it Linux, Windows or Mac.

The only thing needing to be configured differently, is to enable the DHCP server. < FIXME: create link to screenshot>

A brief summary of changing a Coyote Linux to a DHCP-server:

Coyote Linux as the default DHCP server

Configuring system for Ethernet based Internet connection

By default, Coyote uses the following settings for the local network

IP Address:

Would you like to change these settings? [Y/N]: n

then you should use the address instead of when logging into the Coyote Linux web administration. See Section 3.7 and

In this case the new address is:


Update configuration database

Coyote firewall and Internet operators

User Case: We have a firewall with Coyote Linux. Allows itself to connect to our ISP?

Author: Klaus Ade Johnstad.

Note: It has not yet been a situation where Coyote does not work against ISPs in Norway. Tell us if you've experienced problems with one.

This is a list of Internet providers that works well with Coyote Linux

Due different network policies in The Department of Education in Oslomust you make the following changes in the main server:

Change the following in the file/etc/bind/named.conf [5]

       // forwarders {
        // By special request from the good people inside the Dept of Education in
        // Oslo:
        // Dept. of Education in Oslo  end of block
        // };

change this to

          forwarders {
// By special request from the good people inside the Dept of Education in
// Oslo:;;
// Dept. of Education in Oslo end of block

This mean to remove the comment marker (#) in front of "forwarders".

If you don't do this, you one will not be able to connect to the Internet due to problems with the name server (DNS) in The Department of Education in Oslo. Operating staff will also engage more people to get this changed to such as this service want it.

After the change is inserted in /etc/bind/named.conf one need to restart bind with service bind9 restart

You must make the same bind-changes as the Department of Education in Oslo.

Exception handling


Update configuration database

Support for network cards in the firewall

Use case: Are the two network cards in the machine supported by Coyote?

Author: Klaus Ade Johnstad.

This is a list of modules included in Coyote Linux. All driver modules for network cards are listed.

tjener:~/coyote# ls  data/kernel/drivers/
3c501.o     eth16i.o               ne.o
3c503.o     ewrk3.o                ni5010.o
3c505.o     fealnx.o               ni52.o
3c507.o     forcedeth.o            ni65.o
3c509.o     hp100.o                pcnet32.o
3c515.o     hp.o                   ppp_async.o
3c59x.o     hp-plus.o              ppp_deflate.o
8139cp.o    ip_conntrack_amanda.o  ppp_generic.o
8139too.o   ip_conntrack_egg.o     pppoe.o
82596.o     ip_conntrack_ftp.o     pppox.o
8390.o      ip_conntrack_h323.o    ppp_synctty.o
ac3200.o    ip_conntrack_irc.o     sch_htb.o
amd8111e.o  ip_conntrack_mms.o     sch_ingress.o
at1700.o    ip_conntrack_quake3.o  sch_sfq.o
b44.o       ip_conntrack_rtsp.o    sis900.o
bridge.o    ip_conntrack_tftp.o    slhc.o
bsd_comp.o  ip_nat_amanda.o        smc9194.o
cls_fw.o    ip_nat_cuseeme.o       smc-ultra.o
cls_u32.o   ip_nat_ftp.o           softdog.o
cs89x0.o    ip_nat_h323.o          starfire.o
de4x5.o     ip_nat_irc.o           sundance.o
depca.o     ip_nat_mms.o           tlan.o
dgrs.o      ip_nat_quake3.o        tulip.o
dmfe.o      ip_nat_rtsp.o          typhoon.o
e100.o      ip_nat_tftp.o          via-rhine.o
e2100.o     lance.o                wd.o
eepro100.o  lp486e.o               winbond-840.o
eepro.o     mii.o                  zlib_deflate.o
eexpress.o  natsemi.o              zlib_inflate.o
epic100.o   ne2k-pci.o

Exception handling


Update configuration database

Particularly old network cards in the firewall (ISA)

Use case: We want to try to use some network cards in the firewall that is almost 20 years old. They are using the so called ISA bus. Is this possible?

Author: Klaus Ade Johnstad.

Co-author: Knut Yrvin

Network cards with the type designation 3c509 from 3Com, has been a very popular series. Several have Coyote Linux with such network produced for example in 1989, almost 20 years ago. We've run these cards in three years with Coyote firewall without any problems. Once you have managed to get them running, they will probably run for a long time. But it is sometimes difficult to get the cards to work. This is because they have an ISA bus. This means that important addresses (IO) and termination messages (IRQ) must be handled manually. This is done automatically with PCI cards. But using one ISA card requires extra effort. IO and IRQ on these cards can be handled by an old DOS program. This can be somewhat difficult to obtain, since this is almost 20 years old software.

The DOS configuration program is called 3c5x9cfg.exe, and it is used in the following way:

  1. Start the machine with DOS. One can use FreeDOS or a boot floppy created with Windows 95 or 98.
  2. As soon as the machine is booted using DOS, insert a diskett with the program 3c5x9cfg.exe. Run the program 3c5x9cfg.exe from the command line in DOS.

  3. When 3c5x9cfg.exe is started, each of the 3c509 network cards can be configured with the "auto" option

3c5x9cfg.exe can be found at Ruprecht-Karls-Universität Heidelberg: [http://www.urz.uni-heidelberg.de/Netzdienste/nm/misc/3comnic/ ]

FreeDOS can be found on: [http://www.freedos.org/ ]

Exception handling

Alert: Many reports show problems with using two 3c509 card on the same machine if one of the cards is a combo type. This is a card type with different types of networking contacts.

Do not use combo type ISA bus cards!


Update configuration database

User case: I have not got enough help on using the firewall on these pages. Where can I get more help?

Author: Klaus Ade Johnstad.

Co-author: Knut Yrvin

Exception handling


Update configuration database


User case: What's shoud be configured


Exception handling


Update configuration database