Professional Documents
Culture Documents
User Guide
Table of Contents
1. Introduction
2. Quick Start Guide
3. System Requirements
Hardware
Network Cards
Internet Connection
Cable Modems
DSL and PPPoE
ISDN and Satellite
Wireless
4. Installing the Software
Installation Type
Network Install
CD-ROM - Bootable CD-ROM
Creating the Installation Floppy
Starting the Install
Install Configuration
Selecting Your Language and Keyboard
Selecting Upgrade or Install
Selecting your Server Type
Selecting your Network Connection Type
Selecting Your Network Card Drivers
Configuring Your Network
Configuring Your Network - PPPoE
Configuring Your LAN IP Address
Selecting Your Hostname - Password - Timezone - Hard Disk Partitioning
Selecting Your Software
Post Install
Network Card Configuration
Apply the Latest Updates!
5. Setting Up Other Machines
Overview
Windows 95/98
Windows 2000
Windows XP
6. Core Software
Overview
Administration Console
Web-based Administration
7. Modules
Overview
Antispam
AppleTalk
Bandwidth Limiter
Banner Ad and Pop-up Blocker
Caching Nameserver
Caller ID
DHCP Server
Mail Server - POP and IMAP
List of Tables
2-1. Quick Start Network Settings
3-1. Hardware System Requirements
4-1. Supported Network Cards on Installation Floppy
5-1. Network Settings
7-1. Antispam from SpamAssassin
7-2. AppleTalk Information
7-3. Bandwidth Limiter
7-4. Banner Ad and Pop-Up Blocker Information
7-5. Caller ID Information
7-6. POP and IMAP Mail Servers Information
7-7. SMTP Mail Server Information
7-8. ProFTPD Information
7-9. Intrusion Detection Information
7-10. System Watcher
7-11. Photo Gallery
7-12. Print Server
7-13. Samba
7-14. Web Mail
7-15. Web Proxy
7-16. Web Server
7-17. Webmin
9-1. Modules and Package Names
A-1. Netmasks and Networks
Chapter 1. Introduction
Welcome
The ClarkConnect software transforms a standard PC into a full-featured Internet server/gateway. In other words, it
connects your local area network (LAN) to a DSL or cable modem Internet connection. The software is based on Red Hat,
so you can install thousands of software packages (RPMs) on your server!
This document describes how to install and configure your ClarkConnect server/gateway. You should have the following
background and experience:
● a small network
Features
What's New
The contents of all your hard disks on the target computer will be completely erased.
For those folks who do not like to read manuals, here are the required steps to get your ClarkConnect server up and
running.
You won't need too much horsepower to run a ClarkConnect device. You will need at least 32MB of RAM (though 64MB is
recommended if you plan on using all the bells and whistles) and a 500MB disk.
Linux does a good job at auto-detecting most hardware. If you plan on purchasing new network cards, make sure they are
supported by Linux. See Red Hat's Hardware Compatibility List.
You need to use one of the ClarkConnect tools to create your floppy. On the CD, you will find the mkbootfloppy script for
Linux, and the ClarkConnect Tools for Windows. If you have a bootable CD drive, you can skip this step.
Network Install
You have to make changes to your computers sitting on your network. Use the following table as a guide:
Feature Description
Default ClarkConnect IP Address 192.168.1.1
Available static IPs 192.168.1.2 - 192.168.1.99
Addresses used by DHCP 192.168.1.100 - 192.168.1.254
DNS Servers 192.168.1.1 and/or your ISP's DNS servers
Hardware
Network Cards
Linux does a good job at auto-detecting most hardware. Most mass-market PCI network cards are supported. Take a look
at the Red Hat Hardware Compatibility List website to see if your network card is compatible. If you plan on buying new
network cards for ClarkConnect and have two spare PCI slots, then save yourself some time and select the network cards
that are designated 100% compatible.
Do you only have ISA slots available or older ISA network cards around? You can still install the ClarkConnect software, but
it will take some extra work to get the network cards working. You may have to edit the driver configuration file - see
Appendix A
You may want to look at some of the Network Starter Kits available on the market.
Internet Connection
ClarkConnect supports most DSL (including PPPoE) and cable modem broadband Internet connections. We do not expect
to add support for ISDN, wireless, or satellite types of broadband any time soon. However, if you have had success with
getting Linux working on such a system, then we want to hear from you! E-mail us at beta@clarkconnect.com.
Cable Modems
Most cable modem Internet service providers will include a standard Ethernet card and external modem to enable your high-
speed Internet connection. Fortunately, the days of proprietary software and logins are mostly behind us, so you should be
able to setup ClarkConnect without too much tinkering.
However, some of the cable modem providers still have some quirks. Fortunately, Vladimir Vuksan has put together a great
resource of Cable Modem Providers! If you are having trouble getting ClarkConnect to work with your cable ISP, check the
following web site for some troubleshooting tips - http://www.tldp.org/HOWTO/Cable-Modem/isps.html.
ClarkConnect includes the software required to connect to Australia's Telstra Big Pond Service. Make sure you select the
BPALogin option in the installation wizard!
During the ClarkConnect install, you will be asked for which type of DSL service you use - PPPoE or "Standard". These are
mutually exclusive implementations, so you will need to select the right type during installation. It is very important to know
how your Internet service provider configures your network. If you are not sure, ask the ISP's tech support staff, or other
users.
We do not support ISDN or satellite broadband service providers. We are not too familiar with these services so they are not
officially supported.
Wireless
The Office Edition supports 802.11 Internet connections. See the website and Howtos for details.
Installation Type
To install the ClarkConnect software, you require an installation floppy disk or a bootable CD drive. The rest of the software
is installed from the CD-ROM or directly over your high-speed Internet connection.
Network Install
For network installs, you will need to create and installation floppy disk (described in the next section). Due to space
limitations on the installation floppy, only a subset of network card drivers are available (see table below).
Driver Description
3c503 3c507 3c509 3c515 3Com cards: 3c503 3c507 3c509 3c515
3c59x 3Com cards: 3c590/3c595/3c90x/3cx98
8139too RTL8139, SMC EZ Card Fast Ethernet
de4x5 DE4x5, DE434, DE450, and DE500 DEC EtherWORKS
eepro EtherExpress Pro/10
eepro100 Intel EtherExpress Pro 100B
eexpress EtherExpress
lance Advanced Micro Devices AMD 79c970 / PCnet LANCE
Compare your network card to the Red Hat Hardware Compatibility List. Keep in mind that each driver supports many types
of network cards. For instance the "tulip" driver can be used for Intel, LNE100TX, Accton and other types of network cards.
If your network driver is not listed in the above table, you will need to use a CD to create your ClarkConnect device.
Warning
You must install by CD-ROM if you have a PPPoE type connection or your ISP uses a non-standard connection
procedure (e.g. Telstra's Big Pond Service)
If your target computer contains a bootable CD-ROM drive, then you do not require an installation floppy disk. However, you
may need to change the settings in your BIOS to start the ClarkConnect install.
A note to users with PPPoE connections: The ClarkConnect software does support PPPoE, but the
software can not be installed over the network.
To create the installation floppy disk, you need to use the ClarkConnect floppy creation tool.
From Windows
Download the floppy disk software from the website. Unzip the package (two files) and run the makefloppy.exe file.
From Linux
Download the floppy disk script and image from the website. Unpack the files and run the mkbootfloppy script.
Warning
The contents of all your hard disks on the target computer will be completely erased if you choose to auto-partition your
system.
Network Install
Install Configuration
Select whether you are upgrading or installing a system. If you are upgrading, make sure your read the release notes and
upgrade notes.
ClarkConnect supports standalone server mode and gateway mode. Standalone mode is used to create a server on a local
area network (behind an existing firewall). Only one network card is required.
Select the type of Internet connection you have (DSL, DSL/PPPoE, Cable).
You will need to manually configure your network card settings if the installer does not automatically detect the driver. Most
ISA-based network cards may also require the I/O and IRQ settings for the driver. See the Linux Ethernet HOWTO and
Appendix A for some tips and tricks.
ClarkConnect supports PPPoE DSL connections. Add the username and password provided by your ISP on this screen.
For brain dead ISPs, you may also need to specify DNS servers.
If you are installing ClarkConnect as a gateway, you must specify the network settings for your local area network. The LAN
hostname can be used instead of the IP address for many network tools. For instance, you will be able to access the web-
based administration tool at https://<LAN-hostname>:81 in your web browser.
The next few screens will ask for your device name, system password, timezone and partition settings. If you would like to
specify your own partition scheme, then you should select "yes" on the "Select Partition Type" screen. The partitioning
configuration will appear in the second stage of the installation process... don't panic!
Warning
Do not forget your system password!
Select the software components to install on your system. Not all the modules (including AppleTalk and Junkbuster) are
shown here - don't panic. With the ClarkConnect web-based configuration, you can add other modules after installation.
Post Install
Linux will auto-detect most PCI-based network cards. Older ISA cards may require setting parameters for the IRQ and IO.
You may also need to disable plug-and-play features on the card. Please check Red Hat's Hardware Compatibility Lists to
see what settings may be required for your brand of network card.
Warning
The two network cables coming from your box may need to be swapped. If you are having a hard time connecting to the
Internet, make sure you try swapping the cables.
If you have old network cards, you can configure the drivers and settings (IRQs and IO).
Warning
Gotcha! You may only need to specify an IO or IRQ ... but not both.
Please register your system and apply the latest software updates.
Overview
All of the computers and devices on your network must have Internet addresses between 192.168.1.2 and 192.168.1.254.
When you are configuring your network, you have two choices:
Make sure you only use an address between 192.168.1.2 - 192.168.1.99 if you configure devices with static IP addresses.
ClarkConnect includes a caching DNS server, but you can use this as your Internet Service Provider's DNS servers if you
wish.
Feature Description
Default ClarkConnect IP Address 192.168.1.1
Available static IPs 192.168.1.2 - 192.168.1.99
Addresses used by DHCP 192.168.1.100 - 192.168.1.254
DNS Servers 192.168.1.1 and/or your ISP's DNS servers
Windows 95/98
● Click on the Start button, then follow the menu to Settings > Control Panel
● Double-click on the Network icon to bring up a window that will look similar to the screenshot
Step 2 - IP Address
On the IP Address tab, you can select Obtain an IP address automatically and ClarkConnect will automatically assign an IP
address for you.
Alternatively, you can choose Specify an IP address (as shown in the screenshot). Make sure you pick an address
between 192.168.1.2 to 192.168.1.99. The subnet mask is always 255.255.255.0.
Click on the Gateway tab. If you decided to let ClarkConnect assign your IP address automatically, then there is no need to
add an Installed Gateway. Your ClarkConnect software will automatically handle this for you. If you decided to specify your
IP address, then you will need to add 192.168.1.1 to the list of installed gateways (as shown).
If you decided to let the ClarkConnect assign your IP address automatically, then you can select Disable DNS.
ClarkConnect will automatically configure these settings.
If you decided to specify your IP address, then you will need to add 192.168.1.1 to the DNS Server Search Order list (as
shown).
You should also add a host name and then add "lan" as the domain. If you prefer to bypass the ClarkConnect DNS cache,
you can add the DNS servers given by your Internet service provider.
Windows 2000
Click on the Start button, then follow the menu to Settings > Network and Dial-up Connections
If the Local Area Connection Properties does have Internet Protocol (TCP/IP) go to Step 2 - Configuring TCP/IP. If the
Local Area Connection Properties does not have Internet Protocol (TCP/IP), you will need to install it using the Install
button.
● Select "Protocol" and click on Add. The enumeration of the protocols will take a minute or so.
● Select "Microsoft" from the left panel and select Internet Protocol (TCP/IP) from the right panel.
You can configure the TCP/IP properties by clicking on the properties button in the Local Area Connection dialog box.
Select "Obtain and IP address automatically" and ClarkConnect will automatically assign an IP address for you.
Alternatively, you can choose "Use the following IP address:" and enter the IP address, subnet mask, default gateway and
DNS server addresses. If you have more than three DNS servers, use the advanced button at the bottom of the dialog box
to specify the addresses and the order in which they are used.
Windows XP
● Click on the Start button, then follow the menu to Settings > Control Panel
Step 3 - IP Address
On the IP Address tab, you can select Obtain an IP address automatically and ClarkConnect will automatically assign an IP
address for you.
Alternatively, you can choose Specify an IP address (as shown in the screenshot). Make sure you pick an address
between 192.168.1.2 to 192.168.1.99. The subnet mask is always 255.255.255.0.
If you decided to let the ClarkConnect assign your IP address automatically, then you can select Disable DNS.
ClarkConnect will automatically configure these settings.
If you decided to specify your IP address, then you will need to add 192.168.1.1 to the DNS Server Search Order list (as
shown).
You should also add a host name and then add "lan" as the domain. If you prefer to bypass the ClarkConnect DNS cache,
you can add the DNS servers given by your Internet service provider.
Overview
There are two ways to configure your ClarkConnect system. The Administration Console is used to configure your network
settings, while the Web-based Administration Tool is used to configure everything else!
Administration Console
The console must be accessed from a monitor and keyboard attached the server/gateway. In most installations, you will not
need to access this configuration tool... ever. However, if you are having trouble getting your network up and running, and
would like to change the IP address of one or more of your network cards, then login to the console. Use the root username
and the password specified during installation.
Web-based Administration
ClarkConnect includes a web-based configuration tool. If you used the default LAN settings, then point your browser to
https://192.168.1.1:81. If you are using the caching DNS server, you can type name of the server instead (e.g. clarkconnect.
lan).
Your browser will issue an "Invalid Certificate" message when you access the site. Your connection is still secure and
encrypted, but your server certificate is not official. A valid certificate (like the one used at https://secure.clarkconnect.com)
costs over $150 a year to maintain and not necessary for a private server. Use the "Install Certificate" option in your web
browser to bypass this warning screen the next time you access the ClarkConnect web-based administration.
Login as username "root" with the password you defined during the installation.
Chapter 7. Modules
Overview
You can install software on your system using two tools: either the web-based interface or the command-line "apt-get" tool.
Installing an add-on module may require several other software packages (or RPMS). Fortunately, both the web-interface
and command-line tool automatically resolve these software dependencies. See apt-get and web-based administration for
more information.
Warning
You can select some of the following packages during the installation wizard. Unfortunately, some software can only be
installed after the installation (e.g. Webmin, RAV Antivirus).
Antispam
Antispam Information
Description SpamAssassin provides a spam filter for you system's mail server.
Package Name cc-spamassassin
Command-line Install "apt-get install cc-spamassassin"
The SpamAssassin software works in conjunction with your mail server. Use the web-based administration tool to enable
the software. You can configure the sensitivity and subject tag -- see screenshot for more information.
AppleTalk
AppleTalk Information
Description The netatalk package enables Linux to talk to Macintosh computers via the AppleTalk
networking protocol. It includes a daemon to allow Linux to act as a file server over
EtherTalk or IP.
Package Name cc-netatalk
Command-line Install "apt-get install cc-netatalk"
Mac Notes
● Under file servers, the server should show up --- first victory
● Click ok will bring a dialog box asking for name and password, or you can choose guest. If you click guest you only
see the shared directory. (The same that Windows uses). If you enter a valid username and password on the
ClarkConnect box, you can access your home directory. You will also have access to the shared directory.
You can put checkmarks next to either share to create links on the desktop then click OK.
Note: when the box mentions cleartext for the password, it means that what you send as a password in not encrypted in
anyway. So any system between the Mac and ClarkConnect can through packet sniffing read your password. You should
now have complete read/write access to the linux box.--- second victory.
Troubleshooting Tips
● Stop and start atalk (Do not restart, it needs a few second pause between the commands and restart will do it too
quick)
● From the command line, run "top" and watch to make sure that atalkd, papd and afpd have started. Hit 'q' to exit.
Bandwidth Limiter
Are you finding that a minority of users are using up the majority of your bandwidth? You can limit the download speed by IP
address.
Privoxy Information
Description Privoxy (Junkbusters) blocks banner ads and most pop-ups when browsing the web.
Package Name cc-privoxy
Command-line Install "apt-get install cc-privoxy"
Privoxy can be integrated with the Squid Web Proxy to provide transparent banner ad and pop-up filtering. In other words,
you can enable filtering on the gateway -- no configuration changes are required for the desktops on your LAN. To enable
transparent mode, make sure the Privoxy software is enabled on the Squid Web Proxy page and make sure Squid is set to
run in transparent mode. See the Squid Web Proxy for more information.
Use the following instructions to use the Privoxy software in non-transparent mode.
● Step 2 - Make sure Privoxy is running - check "Running Services" in the the web-based administration tool.
● Step 3 - You must set your browser to use ClarkConnect as a proxy server. In Internet Explorer, click on Tools on
the menu bar, then Internet Options. Click on the Connections tab, and then the LAN Settings button.
● Step 4 - Add 192.168.1.1 and port 8118 to the proxy server settings. Click on the Advanced button and go to the
next step.
● Step 5 - You will not be able to access websites on your local network unless you specify the exceptions shown.
Caching Nameserver
People are not too adept at remembering numbers, so we we use hostnames instead of IP addresses (e.g. clarkconnect.lan
instead of 192.168.1.1). The default hostname was specified during the installation wizard (see LAN settings). If the
computers on your network use ClarkConnect as their nameserver (see Setting Up Other Machines), the LAN hostname will
automatically appear in the caching nameserver.
Tip: If you add names in the /etc/hosts file, the results will automatically be included in the caching DNS
server! You can configure entries in the /etc/hosts file using the web-based administration tool.
Special thanks to Simon Kelley for creating the dnsmasq caching nameserver
Caller ID
Caller ID Information
Description Log incoming caller information
Package Name cc-callerid
Command-line Install "apt-get install cc-callerid"
Warning
The install will attempt to detect a modem -- this can cause the system to hang!
If you are lucky enough to have a Linux-friendly modem with caller ID capabilities, then you can install the Caller ID package
from ClarkConnect. A call log is displayed on the web-based administration tool.
DHCP Server
The Dynamic Host Configuration Protocol (DHCP) allows hosts on a network to request and be assigned IP addresses. The
default configuration for the DHCP server is given in the Network Settings table. If you changed the default LAN settings
during the installation wizard, then your changes will also be reflected in the DHCP server.
Some tips:
● You should only have 1 DHCP server per network. If you already have one running, then you will cause grief.
● Keep a range of IP addresses available for static addresses. Some devices (printers) and incoming VPN
connections may require a static IP.
● Do not use the broadcast address (e.g. 192.168.1.255) as the last IP in the range.
● If you change your LAN IP address, you will need to make changes to your DHCP server. All changes can be made
through the web-based adminstration (see screenshot).
Configuring POP/IMAP
You can use either IMAP or POP to pickup your mail from the server. The screenshot below shows the configuration for
POP mail. Make sure the Xinetd server is running (this is a "super server" for other things... including email) and that either
the POP3 or IMAP service is enabled.
You can now configure your e-mail client (Outlook, Eudora, etc.) Your POP/SMTP/IMAP servers should point to your
ClarkConnect box.
Warning
Do not forget to open up firewall ports for e-mail. You only need to open the POP or IMAP ports if you plan on picking up
your mail from outside your local network.
Configuring SMTP/Postfix
You can configure your mail server with the web-based administration tool.
Tips
The Hostname does not have to be related to the e-mail domains that you host. It can be ANY valid Internet name for your
machine. In our example, the Primary Domain is the same as the hostname... just a coincidence.
It is important that you do not make an error with the Trusted Networks parameter. Without the parameter, any user on the
Internet could send e-mail via your ClarkConnect box. Not good -- spammers would eventually find your box and abuse it.
The default setting allows any user with a 192.168.x.x address send e-mail through the box. If you use a 10.x.x.x address,
you should add 10.0.0.0/8 to the list of trusted networks.
FTP Server
ProFTPD Information
Description ProFTPD is a full-featured FTP server.
Package Name cc-proftpd
Command-line Install "apt-get install cc-proftpd"
The default configuration for ClarkConnect allows read-only anonymous FTP (directory is /var/ftp) and full access to user
accounts. Advanced configuration for the FTP server is beyond the scope of the web-based administration tool. You can
configure the FTP server by editing the /etc/proftpd.conf configuration file. Take a look at the ProFTPD website to configure
advanced settings such as bandwidth throttling.
Intrusion Detection
Snort Information
Description The Snort software is an advanced intrusion detection system.
Package Name cc-snort
Command-line Install "apt-get install cc-snort"
The Snort package is included with ClarkConnect to make users more aware of some of the daily "hostile" traffic that can
pass by your Internet connection. The SnortSnarf software package creates web pages from the snort log files on a daily
basis.
Shameless Plug
New exploits are discovered everyday. The Nimda and Code Red worms are the rule... not the exception! Snort maintains a
list of over 1000 rules in their database. You can receive automatic snort updates by upgrading your Gateway Services
account.
Warning
Snort does require some horsepower. A Pentium 100 with 32MB was able to keep up, but the machine was getting a good
workout.
System Watcher
The syswatch daemon monitors the status of your broadband Internet, and watches for potential system issues. The
software logs any downtime and attempts to reconnect to the Internet when trouble occurs. The software is also responsible
for submitting a new IP address to the dynamic DNS system.
Photo Gallery
Gallery is a web based photo album that provides users with the ability to create and maintain their own online photo
collection via an intuitive web interface. More information can be found on the Gallery page in the web-based administration
tool.
Print Server
ClarkConnect includes the CUPS - the Common Unix Printing System - in addition to Foomatic - a database of printer
drivers and descriptions. These two systems (with the help of a few other software packages) create the core of the printing
system.
Supported Printers
Not all printers are compatible with Linux. The best resource is the Linux Printing Database. You can find whether or not
your printer is supported. If so, then follow the link from the web-based administration tool to add your printer (or jump
straight to it: http://192.168.1.1:631 on a default LAN setup).
When you configure a new printer with Cups, it will appear as a shared printer in Windows Network Neighborhood (if Samba
is installed). However, you will need to restart the Samba service after adding a new printer - use the Running Services
page from the web-based administration tool.
Samba Information
Description Samba file sharing system.
Package Name cc-samba
Command-line Install "apt-get install cc-samba"
If you are using Windows PCs, you will be able to see your ClarkConnect box through your Network Neighborhood icon.
Use the Samba/File Sharing page in the web-based administration to add or change the name, workgroup or comment
shown in Network Neighborhood.
Gotchas
Warning
Due to a "feature" in Microsoft networking, you may not see ClarkConnect right away; sometimes it takes several minutes
to appear. A quick way around this "feature" is to use the Find Computer tool.
Web Mail
Web Proxy
Web Server
Warning
Gotcha! You must enable the webserver through the ClarkConnect web-based administration tool. You must also open
the firewall port to allow web connections.
Webmin
Webmin Information
Description A web-based administration tool.
Package Name webmin
Command-line Install "apt-get install webmin"
Webmin is a alternative web-based administration tool. Once you have installed Webmin, you can access it from your web
browser -- https://192.168.1.1:10000 on a default installation (make sure you use https when you type the address). Use
the "root" username and password to login.
Chapter 8. Firewall
Overview
Take a look at the Test My Shields and Probe My Ports security tools from Gibson's Research. They will test your
ClarkConnect box for common security problems. Of course, ClarkConnect has been configured to be secure, so you
should be happy with the results. In fact, your ClarkConnect box considers this type of "network scanning" mischievous
behavior and logs the information in the Intrusion Detection log.
The ClarkConnect web-based administration has two tools to help you configure your firewall. The Firewall Tool opens up
ports to allow services (e.g. web server) on ClarkConnect. The Port Forwarding tool allows you to forward ports to
computers behind your firewall.
You can set up basic firewall rules using the web-based administration tool (screenshot below). You can find additional
documentation in the web-based administration pages.
Chapter 9. Services
Services Overview
ClarkConnect comes with free dynamic DNS. You will always be able to find your server/gateway from anywhere on the
Internet - even with a dynamic IP address. You can also subscribe to the mailing list to receive the latest software and
security patches. Just create a new account and then configure your ClarkConnect device.
● Security audit
● Bandwidth metering
The web-based administration includes a tool to update and install software on your system. You can view and install the
latest software on your system with a few clicks on a web browser. You must register your ClarkConnect system to access
this page.
The apt-get tool installs and upgrades software on your system. For those of you familiar with the underlying RPM package
system, you know the frustration of resolving software dependencies. With apt-get, these dependency issues are
automatically resolved.
To use apt-get, login to your ClarkConnect server as root. You can use SSH or the console. The following list of commands
Tip: Do you want to install the latest patches? Run the following two commands: i) apt-get update ii) apt-get
upgrade
apt-get update -- retrieves the latest list of software and updates available through apt-get. You should run this command
before using other apt-get commands (you must run this at least once).
apt-get upgrade -- performs an upgrade for all obsolete software on your system.
apt-get install <package> -- installs software on your system. The package is the name of the RPM (see following table).
Module Package
Antispam cc-spamassassin
AppleTalk/AppleShare cc-netatalk
Bandwidth Limiter cc-bandwidth
Banner Ad and Pop-up Filter cc-privoxy
Caching Nameserver cc-dnsmasq
Caller ID cc-callerid
Console Tool cc-console
Developer Environment cc-devel
DHCP Server cc-dhcp
Firewall cc-firewall
FTP Server cc-proftpd
Intrusion Detection cc-snort
Intrusion Detection Reports cc-snortsnarf
Mail Server - POP/IMAP cc-imap
Mail Server - SMTP cc-postfix
Network Watcher cc-syswatch
Photo Gallery cc-gallery
PHP cc-php
POP before SMTP cc-pop-before-smtp
Print Server cc-printing
System Statistics cc-mrtg
System Status cc-phpsysinfo
Webmail cc-webmail
Webmin webmin
Web Proxy cc-squid
Web Server cc-httpd
Windows File Server cc-samba
... latest additions web page
This FAQ only covers installation questions. Please check the website for more FAQs - http://www.clarkconnect.org/help/
Please read ISA Network Card page (even if you are using PCI cards!).
Old hardware can sometimes cause grief for the Linux installer. These error messages can be caused by memory
problems, hard disk detection and configuration errors, and many other types of errors. Take a look at the extra log screens
after the error occurs - type Alt-F1 through F5 to see all the screens.
This error will occur if your second network card cannot be auto-detected. When certain services start up, they cannot find a
network interface and spit out an error. Once you have configured your network cards, the error messages should
disappear.
On several ClarkConnect configuration screens, you will see a place to configure network settings. What does this mean?
Using special notation, you can specify a network (or range of IP addresses). You must specify the first IP address in the
range, followed by a "netmask". There are two common ways to specify the netmask (see table and example below).
Example -- the 192.168.1.0 - 192.168.1.255 range of IP addresses can specified with the following two methods:
● 192.168.1.0/24
● 192.168.1.0/255.255.255.0
The first and last addresses (192.168.1.0 and 192.168.1.255 in the first example) are reserved and cannot be used.
ISA Network Cards If you decide to use ISA network cards, you may be in for a world of hurtin'. You may end up setting
jumpers, disabling plug-n-play, setting IRQs, or downloading DOS configuration tools from a vendor's website. These cards
may take more effort to configure, but many are just as capable of doing the job!
The following is courtesy of Paul Ramsey's Red Hat Linux 6.X as an Internet Gateway for a Home Network - http://www.tldp.
org/HOWTO/mini/Home-Network-mini-HOWTO.html
OK, so one or both of your cards are not recognized by the kernel. This is not a problem, really. What we're going to have to
do is tell the kernel more explicitly how to find your cards. There are lots of twists and turns here, and I'm not going to cover
all of them. Remember, when the going gets tough, the tough turn to the Ethernet HOWTO. Here's some summary advice:
● You have a PCI network card. You are probably sitting pretty, assuming it is not so new and cutting edge that no
drivers exist. You can often find out a great deal about your network cards (and other things) by reading through /
proc/pci and noting down makes and models.
● You have an ISA network card. It is possible you will have to know the IO base address and the IRQ the card is
operating on. You have manuals, right? Right? If not, this would be a good time to surf to the manufacturer's web
site and see if they have any online references. Or if you have an old DOS configuration diskette, boot to DOS and
see if there is a setup program which will read and set the address and IRQ.
● You have an ISA Plug'n'Play card. You'll have to learn how to configure it first -- read the Plug'n'Play HOWTO.
Fortunately, once you've configured your card you will know exactly what the IO base and IRQ are.
Now, since you know what the make and model of eth0 and eth1 are you can go to the compatibility page of the Ethernet
HOWTO and look up your card. Take note of the recommended driver, and any information about special options your card
may require. Write it down.
It's time to edit a configuration file! The file we will be editing is /etc/conf.modules (or modules.conf). Open this file up in the
text editor of your choice. Because there are so many possibilities and combinations of things which can go in this file, I'm
going to give my own gateway as an example. I have a PCI 10/100Mb card based on the VIA Rhine chip, and a plain-jane
10Mb NE2000 ISA clone. I use the 100Mb card for the internal network and the 10Mb card for the external connection. My /
etc/conf.modules (modules.conf) file looks like this:
● The first line is there to configure my parallel port for printing. You probably have a similar line. Leave it alone.
● The second line (alias eth0 ne) tells the kernel to use the ne driver for the eth0 device.
● The third line (options ne io=0x300 irq=10) tells the ne driver at which io address and irq interrupt it will find the ISA
card at. If you have ISA cards you will probably have to use this kind of directive, just replace the driver, io and irq
directives with the correct information for your card.
● The fourth line (alias eth1 via-rhine) tells the kernel to use the via-rhine driver for eth1. Because my eth1 card is a
PCI card, I do not need to provide io or irq information: the PCI subsystem configures the device automatically.
You will want to ensure that you have alias entries in conf.modules (modules.conf) for both your cards, and correct options
lines for all your ISA cards. You may already have lines in conf.modules (modules.conf) for any ethernet cards you
configured during installation.
When you have finished editing conf.modules (modules.conf), try ifconfig eth0 and ifconfig eth1 again. You may have to
apply some trial and error if you are messing with IO addresses and IRQs without a manufacturers manual.
So, you were really really smart, bought two identical network cards for your Linux gateway, and now you cannot get them
to work together? Do not worry, getting them to coexist is just a matter of using the correct syntax in /etc/conf.modules
(modules.conf). For this example, the addresses and IRQ numbers are made up, and I will assume that you have bought a
matched pair of NE2000 clones (a common choice). Your /etc/conf.modules (modules.conf) file should look like this:
alias eth0 ne
alias eth1 ne
options ne io=0x330,0x360 irq=7,9
The addressing options are all given on the same line, and the first number for each addressing type is for eth0, the second
number for eth1.
This manual may be reproduced in whole or in part, without fee, subject to the following restrictions:
The copyright notice above and this permission notice must be preserved complete on all complete or partial copies. Any
translation or derived work must be approved by the author in writing before distribution. If you distribute this work in part,
instructions for obtaining the complete version of this manual must be included, and a means for obtaining a complete
version provided. Small portions may be reproduced as illustrations for reviews or quotes in other works without this
permission notice if proper citation is given.
Exceptions to these rules may be granted for academic purposes: Write to the author and ask. These restrictions are here
to protect us as authors, not to restrict you as learners and educators.
This does not apply to Suva, Windows software, and some other components.
Copyright (c) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place
- Suite 330, Boston, MA 02111-1307, USA
Preamble
The licenses for most software are designed to take away your freedom to
share and change it. By contrast, the GNU General Public License is
intended to guarantee your freedom to share and change free software--to
make sure the software is free for all its users. This General Public
License applies to most of the Free Software Foundation's software and
to any other program whose authors commit to using it. (Some other Free
Software Foundation software is covered by the GNU Library General
Public License instead.) You can apply it to your programs, too.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
either the Program or any derivative work under copyright law: that is
to say, a work containing the Program or a portion of it, either
verbatim or with modifications and/or translated into another language.
(Hereinafter, translation is included without limitation in the term
"modification".) Each licensee is addressed as "you".
1. You may copy and distribute verbatim copies of the Program's source
code as you receive it, in any medium, provided that you conspicuously
and appropriately publish on each copy an appropriate copyright notice
and disclaimer of warranty; keep intact all the notices that refer to
this License and to the absence of any warranty; and give any other
recipients of the Program a copy of this License along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion of
it, thus forming a work based on the Program, and copy and distribute
such modifications or work under the terms of Section 1 above, provided
that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices stating
that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in whole
or in part contains or is derived from the Program or any part thereof,
to be licensed as a whole at no charge to all third parties under the
terms of this License.
3. You may copy and distribute the Program (or a work based on it, under
Section 2) in object code or executable form under the terms of Sections
1 and 2 above provided that you also do one of the following:
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source code
means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to control
compilation and installation of the executable. However, as a special
exception, the source code distributed need not include anything that is
normally distributed (in either source or binary form) with the major
components (compiler, kernel, and so on) of the operating system on
which the executable runs, unless that component itself accompanies the
executable. If distribution of executable or object code is made by
offering access to copy from a designated place, then offering
equivalent access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and all
its terms and conditions for copying, distributing or modifying the
Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further restrictions
on the recipients' exercise of the rights granted herein. You are not
responsible for enforcing compliance by third parties to this License.
software through any other system and a licensee cannot impose that
choice.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the
author to ask for permission. For software which is copyrighted by the
Free Software Foundation, write to the Free Software Foundation; we
sometimes make exceptions for this. Our decision will be guided by the
two goals of preserving the free status of all derivatives of our free
software and of promoting the sharing and reuse of software generally.
Warranty