LDP/LDP/howto/docbook/Cable-Modem.sgml

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article id="index">
<artheader>

   <title>Cable Modem Providers HOWTO</title>

   <author>
      <firstname>Vladimir</firstname>
      <surname>Vuksan</surname>
      <affiliation>
         <address>
            <email>vuksan@veus.hr</email>
         </address>
      </affiliation>
   </author>

   <revhistory>
      <revision>
         <revnumber>v4.20</revnumber>
         <date>June 29, 2000</date>
         <authorinitials>vv</authorinitials>
          <revremark>
		Addition to 21st Century Cable
         </revremark>
      </revision>
   </revhistory>


   <abstract>
      <para>
      This document attempts to answer basic questions on how to 
      connect your Linux box to cable modem or cable Internet 
      provider.
      </para>
   </abstract>

</artheader>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect1 id="introduction">
<title>Introduction</title>
<para>
The main goal of this document is to get your system running with your
cable modem, and cable internet provider. Unfortunately, many ISPs that
provide cable modem services, give you Windows and Macintosh software
only.
</para>
<para>
This document attempts to explain how to setup some cable modems and
internet providers in Linux, the tricks to get them working correctly, and
the traps not to fall down. It is hoped that this document will assist
you, however we make no claims for the validity of the information
contained within.
</para>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2>
<title>New Versions of this Document</title>
<para>
The newest version of this HOWTO will always first be made
available on 
</para>
<para>
<ulink url="http://www.cs.unm.edu/~vuksan/linux/Cable-Modem.html">http://www.cs.unm.edu/~vuksan/linux/Cable-Modem.html</ulink>
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2>
<title>Feedback</title>
<para>
Feedback is most certaintly welcome for this document. Without your
submissions and input, this document wouldn't exist. So, please send your
additions, comments and criticisms to <email>vuksan-feedback@veus.hr</email>.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2>
<title>Contributors</title>
<para>
The following people have contributed to this mini-HOWTO.
</para> 

<itemizedlist>
<listitem><para>Dan Sullivan <email>dsulli@home.com</email></para></listitem>
<listitem><para>Andrew Novick</para></listitem>
<listitem><para>Michael Strates</para></listitem>
</itemizedlist>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Standard Disclaimer</title>
<para>
No liability for the contents of this documents can be accepted.
Use the concepts, examples and other content at your own risk.
As this is a new edition of this document, there may be errors
and inaccuracies, that may of course be damaging to your system.
Proceed with caution, and although this is highly unlikely,
I don't take any responsibility for that.
</para>
<para>
Also bear in mind that this is <emphasis>NOT</emphasis> official information.
Obtaining official information is usually an impossibility with
many ISPs. Much content in this document are assumptions, which appear to
work for people. Use the information at your own risk.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Copyright Information</title>
<para>
This document is copyrighted (c) 1998 Vladimir Vuksan and
distributed under the terms of the OpenContent License (OPL). Full
text of the license can be found at
<ulink url="http://www.opencontent.org/opl.shtml">http://www.opencontent.org/opl.shtml</ulink>
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
</sect1>

<sect1 id="ethernet">
<title>Setting up your Ethernet Card</title>

<para>
All of the setups below use ethernet cards (network cards) to connect
you somehow to the Internet. That is why first we need to check if
your ethernet card is working and most importantly can be used (read
is supported) in Linux. There is a comprehensive Ethernet HOWTO at
<ulink
url="http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html">http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html</ulink>
if you would like to read it otherwise try this.
</para>

<para>
Boot into Linux, During boot up a message like this should appear...
</para>

<programlisting>
<![CDATA[
eth0: 3c509 at 0x300 tag 1, 10baseT port, address  00 20 af ee 01 23, IRQ 10.
3c509.c:1.07 6/15/95 becker@cesdis.gsfc.nasa.gov
]]>
</programlisting>

<para>
If you missed it type <command>dmesg</command>.
</para>

<para>
If you see a message like that you are set and you can go to the next
section. If you can't see a message like this there are two possible
explanations, your ethernet card is PNP (plug-n-play) and you need to
use tools such as isapnptools to get it recognized (I am not quite
sure on this because I don't have a single PNP card so correct me if I
am wrong). The other explanation is that you need to set up your card.
</para>

<para>
Most cards today come with DOS programs that are used to setup your
card. For example to get my 3COM 3c509 to work all I needed to do is
boot into DOS and use a utility to configure my card. There is usually
a Auto Configure option. If that does not solve your problem try
changing the IRQ for the card using the same utility. I find that
usually IRQs 10,11 and 12 work well. If none of this solves your
problem please read the Ethernet HOWTO referenced above or post to a
newsgroup such as comp.os.linux.setup or comp.os.linux.networking.
</para>
</sect1>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect1 id="isps"> 
<title>Regular Cable Modem ISPs</title>
<para>
   If you think you have the card recognized you have to now look at the
   entry for your ISP. I have sorted the information according to a
   provider because setups are mostly ISP specific.
</para>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="mediaone"> 
<title id="mediaone.title">MediaOne Express</title>

<para>
MediaOne Express is a Internet cable service provided by MediaOne. The
hardware setup consists of a cable modem produced by LanCity or
General Instruments which plugs into an ethernet card using a 10BaseT
(UTP-45) cable. Assignment of IP addresses and other networking
information is done using DHCP which stands for Dynamic Host
Configuration Protocol. The only thing you need to do is read the
DHCP mini-HOWTO and configure your system appropriately. There is no
other necessary configuration. DHCP mini-HOWTO can be found at
<ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink>.
</para>

<para>
Information about MediaOne Service can be found at
<ulink url="http://www.mediaone.com">http://www.mediaone.com</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="home"> 
<title id="home.title">@Home</title>

<para>
@Home uses a similar setup to <link linkend=mediaone
endterm="mediaone.title"></link>.
However, there are a few fundamental differences, outlined by
contributors. Since @Home spans different geographic locations you might
get assigned different kind of equipment and have slightly different kind
of setups. 
</para>   

<para>
Before you try anything, go to control panel, network, and properties
for your network card. Write down all of the information. You will
need it later.
</para>

<para>   
TCI, the company that runs @Home issues a Etherlink III 3c509b NIC for
all of their customers. What TCI does not tell you is that when they
install your ethernet card, it is in PnP mode. Now in Slakware, if you
uncomment the proper line for this card, everything will appear to be
working fine. There will be no system problems, but the 'PC' light on
your CyberSURFR modem will never turn on. If you are using Slakware,
and are having this problem, reboot in DOS and skip the next
paragraph.
</para>

<para>  
In RedHat 5, your system will have some trouble autodetecting the card.
If you try to pass the paramaters manually, the system will hang. This
should be obvious that your card is not setup properly. Before wasting
anymore time, reboot in DOS (This is a must because as of 12/25/97,
there is no utility written for Linux to turn off PnP and turn on
ISA.)
</para>

<para>   
TCI does not give out a utility disk for your ethernet card, so you
must download the utility from one of 3Com's sites. Here is a link to
3COM's page for driver download.
</para>

<para>   
<ulink
url="http://support.3com.com/infodeli/tools/nic/index.htm">http://support.3com.com/infodeli/tools/nic/index.htm</ulink>
</para>

<para>
Once you have downloaded your driver files you will need to run them
and disable the PNP mode of your network card.
</para>

<para>   
What you've now done will make your ethernet card 'broken' in Windows
95. You'll need to go to Control Panel, Network, and remove the
network card and the adapter. Reboot your computer, and again go back
to control panel. Go to add/remove new hardware, and have it
autodetect. It will automatically setup the correct i/o address for
you. You will most likely need to reboot again. Now you should be in
Windows 95, with the 'PC' light on your cable modem on. You will also
notice that none of your internet applications seem to work, you can't
ping, and you can't resolve DNS. You now must go back to control
panels, network, and click on properties for your network card (not
the adapter). Re-enter all the data you wrote down, and reboot.
</para>

<para>   
With a little luck, your ethernet card should be working in Windows
95, and ready to rock in Linux.
</para>

<sect3 id="solomon">
<title id="solomon.title">Notes from Hampton Roads, VA and Phoenix,
AZ by Mark Solomon:
</title>

<para>
With the @home service in Hampton Roads, VA, it is absolutly neccessary
to run dhcpcd-0.70 (or higher) that supports the "-h" option to specify
the hostname of your computer.  Without this switch the @home dhcpcd
server will not assign addresses.
</para>

<para>
@Home user from Hampton Roads Scott Stancil 
<email>sstancil@home.com</email>
has provided an RPM that can be used to easily configure @Home
connection. Check it out at  
<ulink
url="http://www.linuxforum.com/plug/projects.html">http://www.linuxforum.com/plug/projects.html</ulink>
</para>

<para>
More information on setting up dhcpcd-0.70 and @Home service with Intel 
Ether Express cards can be found at  
<ulink
url="http://www.monmouth.com/~jay/Linux/">http://www.monmouth.com/~jay/Linux/</ulink>
</para>
</sect3>

<sect3>
<title>Notes for Baltimore, MD and Colleyville,TX</title>
<para>
In Baltimore subscribers are issued Intel Ether Express Pro 10 nics and a
static IP number.
</para>
</sect3>

<sect3>
<title>Notes for Milpitas, CA, USA</title>
<para>
Information provided by Joe Byrne
</para>
<para>
@Home service assignes 3Com 509b cards. IP addresses assigned statically.
</para>
</sect3>

<sect3>
<title>Notes for Salt Lake City, UT, USA</title>
<para>
Information provided by <email>akaiceman@hotmail.com</email>.
</para>
<para>
@home (at least in the Salt Lake City, Utah areas, i'm not sure if this is
everywhere yet) has started giving out 3com 900B NIC's, unless you ask for a
ISA card in particular. 3COM 900B are PCI based ethernet cards which might
require kernel recompilation.
</para>
</sect3>

<sect3>
<title>Notes from Connecticut, USA</title>
<para>
Information provided by <email>dan@sidhe.org</email>.
</para>
<para>
The @Home folks are using Motorola cable modems (I know, I got one) in
addition to any other brand folks have reported. If it's getting hooked
into a hub it needs to either get plugged in with a twisted-pair
cross-over cable or go into the 'to other hubs' port if your hub has one.
(Which is standard, I expect, for these things, but useful to keep in mid
if, like me, you're hooking the thing on to an existing local network) I
have a plain Compaq 10/100 ethernet card (I think it's the NC3131, but I'm
not 100% sure) in my linux box and it worked without a hitch.
</para>
<para>
Also, they are handing out fixed IP addresses, at least in Connecticut,
and you can get up to three. (They charge $4.95/mo for each extra IP
address they allocate) They make no requirements on the OSes on these
extra machines--I've a Vax running VMS and they didn't bat an eye when I
signed it up. They did want the initial machine to be something they
recognized (I booted over to Win98 for the duration) but they would've
handled a linux-only install if really, *really* pressed
</para>
</sect3>

<sect3>
<title>Notes from Dallas, TX or anyone using Motorola CyberSurfr</title>
<para>
If you have a Motorola CyberSurfr cable modem you will need 
to press the reset key on the back of the modem if you switch 
network cards. The ethernet card hardware address is read by the modem 
and once it is setup if the card is switched it must be reset.Just press
the reset key for 10+ seconds and it will reread.
</para>
<para>
If you are still not able to get your cable connection going check out
mini-HOWTO for cable modems and Cox@Home at 
<ulink
url="http://www.kernel-panic.com/user_files/cox.at.home.html">http://www.kernel-panic.com/user_files/cox.at.home.html</ulink>
</para>

<para>
Update from James Stormes <email>jstormes@gtfcu.com</email>
</para>

<para>
@Home has been upgrading the cable modem system in Bedford Texas (the area
around Dallas Texas).  I have found that with the new system your NIC's MAC
address must match what the cable system has.  That is the Linux system you
plug into the cable modem must use the same MAC that is programmed into the
board you got from @Home.  I use two diffrent computers on the cable modem
(Linux and Windows) so this was a problem.
</para>

<para>
For some NIC drivers you can specify the MAC. For example in
n REDHAT 6.1 in the /etc/sysconfig/network-scripts/ifcfg-eth0 you can add
the line MACADDR="0F4F3E54A659".  Where eth0 is the NIC card attached to the
cable modem and the 0F4F3E54A659 is the MAC that the cable modem system is
expecting.
</para>

</sect3>

<sect3>
<title>Notes from Louisville, KY by Devin Bundrent <email>mrscoobdoo@home.com</email></title>
<para>
  As of now, @Home/Insight issues Realtek RTL8029(AS) PCI Ethernet
NICs, and Static IP addresses.  In addition, the customers of the
service are given(by default, others can be bought, and used) the RCA
DCM105 Digital Cable Modem, without utilities disk.
</para>
</sect3>

<sect3>
<title>Notes from Madison, WI and Lakeridge, VA</title>
<para>
I have a cable modem from Bresnan in madison wi, they use the @home network for
internet trafic and supply there users with the RCA cable modems.
In the howto it states that the -h flag should be used for the host name with
dhcpcd.  That didn't work for me.  They provided me with a machine name of
cb46597-a.mdsn1.wi.home.com, the cd46597-a obviously being my hosts name....
anyway.. the flag I had to use to get dhcpcd working was the -I flag for
ClientID. ClientID is actually the MAC (Ethernet) address of your NIC e.g. 
00:00:21:61:7C:F0.
</para>

</sect3>

<sect3>
<title>Notes from Baton Rouge, LA by Van Goodwin <email>positron@redstroke.com</email></title>
<para>
Here, @Home doesn't seem to have a standard ethernet card.
They gave me a "SMC EtherEZ" ISA card, but I've seen them
install totally different cards in other systems.  The installer told me
they gave static IP addresses to people who use Windows NT and
dynamic to everyone else.  Don't ask me why.
</para>
</sect3>

<sect3>
<title>Notes from Richmond, VA and its surroundings by Robert Marshall <email>no_robmars_spam@yahoo.com</email>
</title>
<para>
In Chesterfield County, Virginia (a suburb of Richmond), @Home offers cable
modem service through the local cable provider, Comcast. The service runs very
well with Linux. As with many @Home locations, IP addresses are assigned via
dhcp, and they require that all dhcp request packets contain the user's
@Home-assigned hostname. The dhcpcd package works well for this, using the -h
parameter. Personal best download - 16Mbytes in 54 seconds.
</para>

<para>
In Henrico County, Hanover County, and the city of Richmond, Virginia, MediaOne
is offerring their Road Runner service. IP addresses are assigned using dhcp,
but are exclusively reserved by MAC address. This requires that the user call
MediaOne support if the MAC address attached to the cable modem ever changes.
The MediaOne people refused to re-register my friend's new MAC address when he
told them that he had purchased a personal firewall from NetGear. They even
tried to insist that he purchase commercial service, even though he was only
going to have one PC connected to the service. Thus, I strongly agree with your
wording in the HOWTO that MediaOne customers carefully avoid mentioning the
words "router", "firewall", or "Linux".
</para>

</sect3>

<sect3>
<title>Notes from Mobile, Alabama R. Jason Valentine <email>miracle@procyon.com</email>:
</title>

<para>
In Mobile, Comcast cable provides cable modem service through the @home
network.  An RCA cable modem (model DCM205) is issued along with a SMC
EZ-Card (10/100) if you don't already have a cable modem.
</para>

<para>
Static IPs are not given, but rather assigned through DHCP.  You need to
make your ethernet card (eth*) use DHCP - linuxconf is the easiest way to
set that up.  Next, you'll need to find the following line in /sbin/ifup
</para>

<programlisting>
-----------------------------------------------------------------
if [ -n "$PUMP" ]; then
     echo -n "Determining IP information for $DEVICE..."
     if /sbin/pump -i $DEVICE; then
         echo " done."
     else
         echo " failed."
         exit 1
     fi
 else ...
-----------------------------------------------------------------
</programlisting>

<para>
and change it to
</para>

<programlisting>
-----------------------------------------------------------------
if [ -n "$PUMP" ]; then
     echo -n "Determining IP information for $DEVICE..."
     if /sbin/pump -i $DEVICE -h hostname; then
         echo " done."
     else
         echo " failed."
         exit 1
     fi
 else ...
-----------------------------------------------------------------
</programlisting>

<para>
Where hostname is the computer name (cc123456-a - or whatever yours may
be.)
</para>


</sect3>

<sect3>
<title>Notes from Auburn, Alabama by  Andrew W. Jones
<email>andywjones@home.com</email>
</title>

<para>
I would like to note that Auburn's @home service supports DHCP.  If you
simply issue `dhcpcd -h hostname` all your network settings are taken
care of...
</para>
</sect3>


<sect3>
<title>Notes from Santa Barbara, California by Tim Newsome
<email>nuisance@cmu.edu</email>
</title>
<para>
My provider (Cox@Home, in Santa Barbara, CA) does the same thing as 
 <link linkend=solomon endterm="solomon.title"></link>. I'm using Debian,
with dhclient version 2.0. I added the following line to my
/etc/dhclient.conf: send host-name "cx803168-a"; Where cx803168-a is the
hostname I've been assigned. It is listed on the purchase order.
</para>
</sect3>


<para>
Information about @Home Service can be found at
<ulink url="http://www.home.com/">http://www.home.com/</ulink>.
</para>

</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>RoadRunner</title>
<para>
RoadRunner is an Internet cable service provided by Excalibur Group
(Time Warner). The hardware setup consists of a cable modem produced
by Motorola and Toshiba which plugs into an ethernet card using a
10BaseT (UTP-45) cable. From what I can gather RR uses DHCP for IP
assignment. In order to set up Linux to use DHCP you need to read the
DHCP mini-HOWTO <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink>.
</para>

<para>
If this doesn't work out for you you should check out
<ulink
url="http://www.math.uakron.edu/RoadRunner/">http://www.math.uakron.edu/RoadRunner/</ulink>
for Akron, Ohio and
<ulink
url="http://people.qualcomm.com/karn/rr/index.html">http://people.qualcomm.com/karn/rr/index.html</ulink>
for San Diego, California. It might help solve your problem.
</para>

<para>
Another good site is <ulink
url="http://www.vortech.net/rrlinux/">http://www.vortech.net/rrlinux/</ulink>.
</para>

<para>
One more thing that might be worth mentioning:  you will need a Windows NT,
95, or 98 or Macintosh PC for the RoadRunner installers to configure the
modem.  It's not technically necessary, but they will insist, and will not
install on a Linux system.  It's also best not to mention the IPFW system
while they're around.
</para>

<para>
Additional notes by Phil Baird <email>pjb@rocsoft.com</email> from Rochester, NY:
</para>

<para>
About getting hooked up initially.  It is true the RR techs don't want
to talk about Linux.  However, they now offer us a "self-install" that is
half the price ($50).  Basically, they come out, run the cable, and make
sure the signal gets to the modem.  You must supply your own nic card and
do the rest of the setup on your own.
</para>

<para>
Information about RoadRunner Service can be found at
<ulink url="http://www.rr.com/">http://www.rr.com/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>Rogers@Home</title>

<para>
The hardware setup consists of a cable modem produced by LanCity which
plugs into an ethernet card using a 10BaseT (UTP-45) cable.
</para>

<para>   
When the cable modem is installed by Rogers@Home technicians you are 
assigned a static IP address. They should also provide you with
information on your subnet mask, router (gateway) numbers and DNS numbers.
</para>

<para>
If above doesn't help you can check out
Randal Leavitt's <email>randal.leavitt@home.com</email> "Connection Notes"
for Rogers@Home at
<ulink url="http://members.home.net/randal.leavitt/CableModemConnectionNotes.html">
http://members.home.net/randal.leavitt/CableModemConnectionNotes.html</ulink>.
</para>

<para>Notes from Greg Jacobs <email>gregjacobs@home.com</email></para>

<para>
They now only give out dynamic IP's. The techs says its pretty much fixed
after first issue, they just want to use DHCP so any network changes on
their end can just be 'pushed out' so to speak.
</para>

<para>
Also Make sure any cablemodem uses ensure they don't use a DHCP server on their
cablemodem interface. The cable company gets very angry and often pull the plug
then tell you ;).
</para>

<para>  
Other information about Rogers@Home Service can be found at
<ulink
url="http://www.rogers.home.com/">http://www.rogers.home.com/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Sunflower Cablevision</title>
<para>
This information is provided by Andrew Novick:
</para>

<para>
"I recently saw your cable modem howto and I have an addition.
Sunflower Cable is a company stricly in Lawrence KS, however we have a
rather large Linux community because of the University of Kansas. On
our local LUG mailing list, we are starting to get more and more
questions on how to configure their linux machine for the cable modem.
It is just regular static addressing, and the modem is made by
Zenith."
</para>

<para>
To configure your Linux box make sure you get all the pertinent
information from the Cablevision tech support or use these.
</para>

<itemizedlist>
<listitem><para>IP address: Assigned by SunFlower
Cablevision</para></listitem>
<listitem><para>Subnet mask: 255.255.255.0</para></listitem>
<listitem><para>Gateway (router) address:
24.124.11.254</para></listitem>
<listitem><para>Hostname: Assigned by SunFlower
Cablevision</para></listitem>
<listitem><para>Domain name: lawrence.ks.us</para></listitem>
<listitem><para>Primary DNS server (nameserver):
24.124.0.1</para></listitem>
<listitem><para>Secondary DNS server (nameserver):
24.124.0.6</para></listitem>
</itemizedlist>

<para>
Have all those numbers written down before you proceed. 
To register, visit <ulink
url="http://www.sunflower.com/">http://www.sunflower.com/</ulink>.
</para>

<para>
To register in the lawrence.ks.us domain contact Stephen Spencer at
<email>gladiatr@artorius.sunflower.com</email>.
</para>

<para>
Under RedHat use Control Panel and Network Configuration to put in
these numbers. Just say Add Interface, Device type=Ethernet, Device    
name=eth0 (this is zero not O in eth0) then fill out all the fields.   
Then click activate.
</para>

<para>
In Slackware type netconfig. When you are finished reboot and you should
be up and running.
</para>

<para>
If this doesn't work make sure you do network card troubleshooting
from the beginning of this document.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="jones"> 
<title id="jones.title">Jones Intercable</title>

<para>
This information is provided by Bob Kimble:
</para>

<para>
Jones Internet Cable supplies a Hybrid cable modem that connects to your
machine / network via 10BaseT ethernet. They provide you with a static IP
address for your machine, and another static IP address for the modem. The
modem acts as a gateway to their network. Your IP address and the modem IP
address are on the same network and have the same network mask (in my case
255.255.255.0 -- 24 bits). They also provide two DNS IP addresses which
you enter into your configuration. I just entered the numbers when I
installed Red Hat Linux 5 and it worked like a champ from the beginning.
Since then I have configured my Linux machine to enable IP masquerading
and domain name services, and it now acts as a router for my entire
private network. My other machines are connected via a private network
using the addresses 192.168.0.x. They are running Windows 95, Windows NT
(Intel and Alpha) and OS/2. My Linux machine has two IP addresses -- the
one from the cable company and one from
the 192.168.0.x private network. Everything works like a champ. All six
machines can browse the web simultaneously. My kids are even able to
connect to their favorite game site, "The Realm" from Sierra.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>GTE Worldwind</title>
<para>
This information is provided by Blake R. Swopes (bhodi@bigfoot.com):
</para>

<para>
GTE WorldWind service is available in only a few areas (parts of California
and Florida), its home page is located at 
<ulink url="http://www.gtecablemodem.com/">http://www.gtecablemodem.com/</ulink>.
</para>

<para>
GTE will send a technician out to hook up the cable modem to the wall, but
does not do any configuration of your computer. The cable you hook up to
your computer is the ethernet standard 10baseT (and you'll probably need to
buy your own, since the one they left with me was only about two feet long).
</para>

<para>
The technician should leave you some information about configuring your
system (IP address, gateway address, netmask, DNS addresses) and the number
for GTE's support line (1-800-GTE-VIDEO, since WorldWind is attached to
GTE's Americast cable service). If you have read the Ethernet-HOWTO and the
DHCP mini-HOWTO, you should have no trouble configuring your system to work
with WorldWind.
</para>

<para>
GTE provides one e-mail address, which they assign to you, but you can
create aliases to that account and web mail accounts through gte.net.
</para>

<para>
According to GTE, they block inbound traffic on several ports for security
purposes and to keep people from running servers that will eat into other
users' bandwidth (e.g., telnet, DNS, News, and Netbios (Good news for
Windows users)). In actual practice, I have found that I was able to telnet
into my system from remote hosts.
</para>

<para>
GTE does not provide technical support for Linux users, so you will pretty
much be on your own. My experience was that as soon as I mentioned Linux,
they tried to get me off the phone, but that might have been the particular
tech I was speaking to at the time.
</para>

<para>
GTE also advised me that they do not support users who have IBM Aptivas,
however I was able to briefly connect an IBM Aptia 2176-C77 with a SOHOWare
PCI 10/100 Ethernet Card to the service with no trouble at all.   
</para>

<para>
I regularly test my connection speed through the bandwidth test at MSN
(
<ulink url="http://computingcentral.msn.com/topics/bandwidth/speedtest.asp">
http://computingcentral.msn.com/topics/bandwidth/speedtest.asp</ulink>
and regularly find my connection speed to be between 320-390Kbps. Depending on
the site, I have seen transfers at up to 135K, though the average is
probably 35-45.

</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>SpeedChoice, Phoenix, Arizona</title>
<para>
According to Micah 
<email>peenchee@asu.edu</email>: 
</para>

<para>
Just thought I'd let you know that in my area (Phoenix, AZ, usa) there is
a company called speedchoice that provides cable modem service.  The
service uses a hybrid cable modem and the set up is almost identical to
that of Jones intercable described in the howto. 
See <link linkend=jones endterm="jones.title"></link>. For any other issues mail Micah.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Cedar Falls Utilities Cybernet,  Cedar Falls, Iowa</title>
<para>
This information is provided thanks to 
Joe Breu <email>breu@cfu.net</email>
</para>

<para>
We are an ISP in Cedar Falls, Iowa that uses a mix of Zenith, Lancity,
  and DOCSIS Cable Modems over our own Hybrid Fiber/Coax system.  Our
  system uses no proprietary connection software and is straight TCP/IP
  connections. We do use DHCP, but will offer static IP addresses to
  customers with older Macintosh machines or computers unable to use DHCP.
  We will answer basic questions if you want to hook up a Linux box to our
  network but it should be drop and surf.       
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title id="bigpond">Telstra Big Pond Advance, Australia</title>


<para>
This information is provided by Mike Battersby <email>mib@post.com</email>
</para>

<para>
Linux is not an officially supported platform for Telstra
Big Pond Advance cable internet. Do not report faults regarding Big
Pond Advance and Linux to them, as they will not help you.
</para>

<para>
In order to use Big Pond Advance under Linux, you will need:
</para>

<itemizedlist>
<listitem><para>a working NIC</para></listitem>
<listitem><para>a DHCP client, to obtain an IP address</para></listitem>
<listitem><para>a BIDS v2 (Broadband Internet Delivery System)
                login client</para></listitem>
</itemizedlist>

<para>
For more information on getting a DHCP client working, see the DHCP mini-HOWTO:
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink>.
</para>

<para>
Big Pond Advance user Shane Hyde wrote and maintains an excellent open
source BIDS v2 login client, BPALogin. The BPALogin web site is:
<ulink
url="http://www.users.bigpond.net.au/bpalogin/">http://www.users.bigpond.net.au/bpalogin/</ulink>.
Available at the same site is a page of instructions on getting BPALogin
to work with Linux:
<ulink
url="http://www.users.bigpond.net.au/bpalogin/tutorial.html">http://www.users.bigpond.net.au/bpalogin/tutorial.html</ulink>.
</para>

<para>
Basic steps for connecting to Big Pond Advance under Linux are:
<itemizedlist>
<listitem><para>get your Network Interface Card working.</para></listitem>
<listitem><para>get a DHCP client to request an IP address.</para></listitem>
<listitem><para>authenticate with BPALogin</para></listitem>
</itemizedlist>

See the tutorial on the BPALogin site
(<ulink
url="http://www.users.bigpond.net.au/bpalogin/tutorial.html">http://www.users.bigpond.net.au/bpalogin/tutorial.html</ulink>)
for more details.
</para>

</sect2>



<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2> 
<title>Fibertel, Buenos Aires, Argentina</title>
<para>
This information is provided by Pablo Godel.
</para>

<para>
My name is Pablo Godel and want report that I'm using the cable service
of Fibertel in Buenos Aires, Argentina and it works perfectly with
Linux.
</para>

<para>
They gave me a static IP. The brand of the cablemodem is COM21 and the
model is ComPort.
</para>

<para>
I connect it to the nic properly, configured in Linux and it worked
perfectly.
</para>

<para>
More information about Fibertel can be found at
<ulink
url="http://www.fibertel.com.ar">http://www.fibertel.com.ar</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Videotron (Videon), Canada</title>
<para>
I don't have much information about Videotron except the fact that they
use DHCP for the assignment of IP addresses and other networking
information. Just read the <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP
mini-HOWTO</ulink> and configure your system appropriately. There is no
other necessary configuration. Also important thing to note is that the
Ethernet card that Videotron distributes is a NE2000 compatible PCI card
for which you need to use.
</para>

<para>
ne2k-pci driver
</para>

<para>
Additional information from Philip Gwyn
<email>gwynp@artware.qc.ca</email>:
</para>

<para>
They use Motorola CyberSURFR (sic) modems.  This will give you an
ethernet NIC when you sign up.  They gave me a TMC NE2000 PCI clone,
which Linux recognises as a "RealTek RTL-8029".  It couldn't configure
it propperly however, until I downloaded the manufacturer's driver disk
and changed the media type to "auto-config".  
</para>

<para>
While they can't guarantee to get it working with Linux, they will do a
bit of hand holding so it works.  Many of the tech-support have
Linux-clues, as it were, even asking questions like "what kernel are you
running?"  "do you have the latest version of dhcpcd?".  When their DHCP
server broke, they even suggested I delete the cache files in
/etc/dhcpcd to start over from zero, as it were.  This worked.  
</para>

<para>
Additional information from Mihai Petre
<email>mihaip@videotron.ca</email>:
</para>

<para>
Yes they are using DHCP for the tcp settings. They have also included
dhcpcd on their ftp server at <ulink
url="ftp://ftp.videotron.ca/pub/linux/">ftp://ftp.videotron.ca/pub/linux/</ulink>.
You can also try posting your problems on news.powersurfr.com newsgroup
videon.linux.
</para>

<para>
As far as running servers using your cable connection according to Alex
Nuta says that "contract explicitly states that *no* servers of any kind
are permitted; HTTP, FTP or otherwise".
</para>

<para>
Additional information from Stasnilav Kogan
<email>s_kogan@alcor.concordia.ca</email>:
</para>

<para>
    The modem they provide is now Samsung InfoRanger (SCM-100R). The ISA
card they provide is an SMC NE2000 compatible (FCC ID: HED1661EN2). It
is necessary to configure the card from DOS to NE2000 mode before
attempting to get it to work under Linux. (Generally, this card is
horrible. I replaced with a 3Com card as soon as possible).
</para>

<para>
The technical support in Videotron is absolutely HORRIBLE. (Not to
mention Linux support). So, whoever signs up with them, should expect to
work alone. However, aside from the NIC problems, the setup was a
breeze. They use DHCP, so all the standard procedures apply.
</para>

<para>
Information about Videotron can be found at
<ulink url="http://www.videotron.ca">http://www.videotron.ca</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Telekabel (Teleweb), Austria</title>
<para>
There are two approaches to setting up your Telekabel
connection. First one is the approach used by Andreas Kostyrka: </para>

<itemizedlist> 
<listitem><para>
You may want to mention, that the Austrian Telekabel (Teleweb) ISP works
with Linux. It seems quite similiar like MediaOne Express (3c509+dhcp,
etc.)
</para></listitem>

<listitem><para> 
Second there are 3COM configuration utilities for Linux (But don't fool
around with them on a busy system, 3c509 may lock the bus if touched the
wrong way :( ):
</para>

<itemizedlist>
<listitem><para>
<ulink
url="ftp://ftp.redhat.com/pub/contrib/hurricane/SRPMS/3c5x9utils-1.0-3.src.rpm">ftp://ftp.redhat.com/pub/contrib/hurricane/SRPMS/3c5x9utils-1.0-3.src.rpm</ulink>
</para></listitem>

<listitem><para>
<ulink
url="ftp://ftp.redhat.com/pub/contrib/readmes/3c5x9utils-1.0-1.README">ftp://ftp.redhat.com/pub/contrib/readmes/3c5x9utils-1.0-1.README</ulink>
</para></listitem>
</itemizedlist>

</listitem>
</itemizedlist>
 
<para>
Second approach is provided by Marcel Ebmer
<email>marcel.ebmer@chello.at</email>
</para>

<itemizedlist>
<listitem><para>
Do NOT bother using dhcpcd or pump!
</para></listitem>

<listitem><para>
In case you don't know, ask the provider for your IP-address, which
is static, for the DNSs, the Gateway and use linuxconf to configure the
network. For Vienna: 960 60 333 is the helpdesk's telephone number They
officially do not support linux, but you need not mention you
are running linux.
</para></listitem>
    
<listitem><para>
Choose  a unique name for your PC....not "localhost"
</para></listitem>

</itemizedlist>

<para>
Information about Telekabel can be found at <ulink
url="http://www.telekabel.at/">http://www.telekabel.at/</ulink>.
</para>

</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Tebecai, Netherlands</title>

<para>
According to Frodo Looijaard:
</para>

<para>
Tebecai is yet another provider which uses a LANcity cable modem
connected to a 10BaseT ethernet card. DHCP is used for configuration
(see the <ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">
DHCP mini-HOWTO</ulink>).  A step-by-step guide to install the cable
modem under Linux can be found at <ulink
url="http://huizen.dds.nl/~frodol/">http://huizen.dds.nl/~frodol/</ulink>
(in dutch), but it is really very straightforward. You must only
remember that your IP-address is not visible from the Internet (it is on
the private 10.x.y.z subnet), so you can not setup a publicly available
server.
</para>

<para>
Information about Tebecai can be found at
<ulink url="http://www.tebenet.nl">http://www.tebenet.nl</ulink>
(in dutch only).
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="a2000"> 
<title id="a2000.title">A2000, Netherlands</title>
<para>
This information is provided by Johan List
<email>J.A.List@speed.A2000.nl</email>:
</para>

<para>
Basically the way to go is the same as with Tebecai.  A2000 provides
cable internet access by means of a LANCity cable modem, connected to an
10BaseT ethernet card. This also works well for the "Vortex/Boomerang"
cards by 3COM (I've got a 3COM Boomerang Fast Etherlink XL 10/100Mb TX
Ethernet Adapter), providing you compile the Vortex/Boomerang drivers.
(See the Linux Ethernet-HOWTO)
</para>

<para>
Setting up access can be done with DHCP (See the DHCP-Mini-HOWTO).  A
Dutch guide to setting up Internet access for A2000 is available at
<ulink
url="http://agvk.a2000.nl/antwoorden/linux/">
http://agvk.a2000.nl/antwoorden/linux/</ulink>.
</para>

<para>
Contrary to Tebecai, your IP-number *is* visible from the Internet, so
take your precautions regarding security and safety when setting up a
Linux machine using A2000 Internet access!!
</para>

<para>
Update on January 23rd
</para>

<para>
Since 1 january 2000, A2000 has become a part of Chello Internet
(http://www.chello.nl).
At least until october 2000 the current settings can be used, but a
couple of URL's have changed.
</para>

<para>
Since the old situation is probably going to change permanently this
year (new domain names for news server, email/POP3 server, FTP server
and so on) it's probably a wise idea to keep the new settings in mind,
which can be found at: 
<ulink url="http://noordholland.coax.nl/instellingen.html">
http://noordholland.coax.nl/instellingen.html</ulink>.
</para>

</sect2>



<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Shaw Cable, Canada</title>
<para>
According to Peng F. Mok
<email>pmok@shaw.wave.ca</email>:
</para>

<para>
I recently signed up for a cable modem service from Shaw Cable here in
Canada, which runs under Shaw@Home brand. Shaw has been upgrading their
cable network for about a year and a half now, and now offer cable-modem
service to a number of locations across Canada.  Information about the
`Shaw@Home' service can
be found at 
<ulink url="http://shaw.home.com">http://shaw.home.com</ulink> General
information about Shaw Cable can be found at 
<ulink url="http://www.shaw.ca">http://www.shaw.ca</ulink>.
</para>

<para>
I thought I'd just drop you a line to inform you that your 
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP
mini-HOWTO</ulink>, was very useful in helping me set up Linux to work with my
cable-modem service, and that you might want to add `Shaw@Home'
to your Cable-Modem mini-HOWTO as another entry. I don't have specific
information on the `Shaw@Home' service yet, but from conversations I've
had with Shaw technical support it seems that `Shaw@Home' is a
partnership with <link linkend=home endterm="home.title"></link> and
involves the same features and setup procedure as that already described
for <link linkend=home endterm="home.title"></link> in the Cable-Modem
mini-HOWTO document.  
</para>

<para>
In both services Shaw Cable techs will come over and bring you two
pieces of hardware -- a Motorola CyberSURFR cable-modem and either a
3Com EtherLink III 16-Bit ISA 3C509B-TPO NIC or an EtherLink XL PCI
3C900-TPO NIC.  You have your choice of either an ISA or a PCI card
depending on your needs, and these models only have the RJ-45 (UTP)
connectors.  The ISA cards come with PnP-mode enabled by default, so it
may be necessary to boot into DOS, disable PnP operation, and configure
the card to some base I/O address and IRQ setting which are available.
Once this is done Linux should have no problems detecting the NIC at
boot-time.  I'm not sure about what needs to be done in the case of a
PCI card since I don't currently have a PC which supports either PCI or
PnP.
</para>

<para>
Note from another user:
</para>

<para>
Shaw now also issues SMC PCI ethernet cards.  They give these out
without boxes or manuals.  I found out that these are the SMC EtherPower
PCI RJ45 card (model 8432T).  They use the DEC 21041 chip so the tulip
ethernet driver is needed for it.
</para>

<para>
If you need to set up your POP3 mailboxes you can do that at following
URL: <ulink
url="https://profile.home.net/Users/menu.htm">https://profile.home.net/Users/menu.htm</ulink>
and you can login and setup the POP3 mailboxes that way.
</para>

<para>
Oh, and for the record, Shaw's technical support is horrendous.  The
best place to go for information is the athome.users-unix newsgroup
(which is not even mentioned by any of the documentation) or please
consult <ulink
url="http://www.ee.ualberta.ca/~pmok/linux/">http://www.ee.ualberta.ca/~pmok/linux/</ulink>.
</para>
</sect2>



<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Cogeco Cable, Canada</title>
<para>
This information is provided thanks to
Sean O'Grady
<email>sean@incisive.dhs.org</email>:
</para>

<para>
I have a Cable Modem through a company called Cogeco Cable located in
various parts of Canada. They are part of the "Wave" system which includes
Rogers Cable and Shaw Cable. The technical setup is different for each
provider though. They supplied me with a D-Link ethernet card (the version
of that has changed since then but I believe are still using D-Link) and a
Zenith modem. The Ip setup is easy since they use DHCP so all I did was
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">install the
DHCP daemon</ulink> and that was that. If you like you can list my
e-mail address <email>togrady@cgocable.net</email> for anyone with questions.
</para>

<para>
 I contacted you awhile ago with information regarding setting up a
cable modem under Cogeco (the mail came from togrady@cgocable.net). Well I
have some updates to give you. Cogeco has now joined the @HOME network
although I haven't seen anything good come out of yet. The modems have
changed as well, instead of the old Zenith modems we now are using a
Samsung InfoRanger SCM-100R modem. The modem changed has not affected the
ease of setting up Linux with the cable modem. All that is still required
is a functioning network card and 
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">working DHCP
client </ulink> and you will be able
to get the network functioning quickly. Many people send questions to me
regarding various cable modem/dhcp/networking issues and as a result I
have started to put together some help pages. The are  located at
<ulink url="http://incisive.dhs.org/">http://incisive.dhs.org</ulink>.
</para>


<para>
Additional info has been provided Craig Kossowski:
</para>

<para>
Cogeco seems to be slowly getting themselves sorted out wrt cable modems
and is now part of the set of Canadian cable companies that have
cooperated on the @Home network.  A network card is provided as part of
their large (but currently waived) hookup fee; the D-Link 528CT for PCI
capable systems, and, I believe, D-Link 220T for ISA systems (and possibly
PCI capable computers that will accept the ISA card, they tried it in my
roommate's system first, only when that didn't work did they put in the
PCI 528CT).  I'd recommend asking for the PCI if you have the choice, as I
know that setup can work with Linux from my experience.
</para>

<para>
Both of these are NE2000 boards to the best of my knowledge.  I got the
PCI D-Link 528CT which uses the RealTek 8029 chipset, and Linux can deal
with easily.  I just recompiled the kernel, and after a little hiccup due
to RedHat 5.2's lilo default not looking for the kernel at /vmlinuz, I was
up and running.  DHCP (with a 24 hour lease lifetime) is used for IP
resolution and everything worked automaticaly (I had selected a DHCP config
when I installed Linux, others may need to do slightly more configuration,
but it doesn't require anything non-standard). The 528 is supposedly
plug & play, but I had no problems using it in my Linux box (2.0.34).  Note
that you need to compile in (either built in or module, I used built in)
the PCI NE2k code, and unlike what is implied in the Ethernet HOWTO, you
don't need to also include the ISA NE2000 code to use this chipset.  I
don't have experience with the ISA D-Link 220T, but I would assume it's
just as easy to set up, it's listed as a supported card in the Ethernet
HOWTO.
</para>

<para>
The Cable modem I got was a great heavy thing that looks like a heatsink
for a small nuclear reactor.  Nearly a square foot in desk space, made by
LANcity, and I believe rated for 10Mbps shared bandwidth on the cable
subset side of things, it has a reasonably good set of LEDs to show you
what it's doing once you figure out what each one is. While throughput
will obviously vary, I see transfer rates around 10kB/s (80kbit/s) and up
during the day, to 50-60kB/s at night, when presumably thinks are quieter
on the backbone. Subjectively, it's very fast, and beats even fast modems
hands down.  I haven't had it long enough to determine uptime yet, so I
can't comment there.
</para>

<para>
At the time of this writing (Jan 99), Cogeco's service runs $150 for
installation, including the card, and $39.99 a month for the service.
They're currently waiving the modem rental fee "until they are available
for purchase" but the information there is mixed from 15.04/month as of
early 1999 (from the web page) to "not for some time" from their phone
staff. Included with this is up to five email addresses, and 5MB of Web
space. They also say there is a 1GB/month limit, though I'm told (by their
tech support people) that this isn't strictly enforced, and is more to
discourage ftp sites with high traffic bogging down the subnets, and to
provide them with an avenue to prevent such.  Although their literature
doesn't say so, additional computers are an extra 10.70 a month, though
unsupported, and you have to provide the hub, wiring and additional
ethercards if you do this, they're basicly charging the extra for the
lease of an additional IP as far as I can tell from their information.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Optimum Online, New York and Connecticut</title>
<para>
This information is provided by Seth Greenfield
<email>islesfan@nassau.cv.net</email>:
</para>

<para>
Optimum Online uses DHCP, and rrclientd in Linux, by John Clark.  Check
out  <ulink
url="http://www.netaxis.com/~wharris/optimum/index.html">http://www.netaxis.com/~wharris/optimum/index.html</ulink>
for instructions on how to set up your service with Linux.
</para>

<para>
Tell people who had private ips who have public ips now to change their
<filename>/etc/resolv.conf</filename> to look like this...
</para>

<programlisting>
domain nassau.cv.net (or optonline.net depenind on the users mood)
nameserver 167.206.112.3
nameserver 167.206.112.4
</programlisting>

<para>
Other Than that its the same setup procedure
note: the rrclientd software will work if you tell it dce-server and you specify
the domain as optonline.net
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Singapore Cable Vision, Singapore</title>
<para>
This information is provided by Jieyao
<email>jieyao@letterbox.com</email>:
</para>

<para>
SCV provides Motorola Cybersurfer modem connected to the network card via
UTP cable. The IP setup is easy since they use DHCP so all you need to do is
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">install the
dhcp daemon</ulink>. If you can't make access the first time, turn the
modem off then on again.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Cable Wanadoo, France and Netherlands (formerly Casema)</title>
<para>
This information is provided by Jerome Sautret
<email>Jerome.Sautret@wanadoo.fr</email> and it applies to Wanadoo's
French customers:
</para>

<para>
I just read your  Cable Modem HOWTO. I live in France, and I use Cable
Wanadoo, the cable service of France Telecom, which is the main telecom
operator in France. It is available in a few cities in France at the
moment, like Angers and Metz. This service provides a dynamic IP address
via DHCP. It uses a COM 21 modem plugged in a 10BaseT Ethernet card.
The IP setup is easy just read the
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP mini
HOWTO</ulink>.
</para>

<para>
Information about Netherlands is provided by Costyn van Dongen 
<email>cvd@casema.net</email>:  
</para>

<para>
The current Casema cable modems operate via the serial port, acting like
normal modems, answering AT commands like phone modems. The setup is
really very easy, because all the chat script needs to do is dial ATDT4.
(this is in ppp-on-dialer). Hence it uses PPP, which is unusual for
most cable modems.
</para>

<para>
Relevant files are included <filename>/etc/ppp/ppp-on</filename>
</para>
<programlisting>
DIALER_SCRIPT=/etc/ppp/ppp-on-dialer
exec /usr/sbin/pppd -detach /dev/ttyS0 115200 connect $DIALER_SCRIPT &  
</programlisting>

<para>
<filename>/etc/ppp/ppp-on-dialer</filename>
</para>
<programlisting>
exec /usr/sbin/chat -e '' AT '' ATDT4 
</programlisting>

<para>
<filename>/etc/ppp/ppp-off</filename>
</para>
<programlisting>
#!/bin/sh
######################################################################
#
# Determine the device to be terminated.
#

sleep 5

if [ "$1" = "" ]; then
        DEVICE=ppp0
else
        DEVICE=$1
fi
#
######################################################################
#
# If the ppp0 pid file is present then the program is running. Stop it.
if [ -r /var/run/$DEVICE.pid ]; then
        kill -INT `cat /var/run/$DEVICE.pid`
#
# If the kill did not work then there is no process running for this
# pid. It may also mean that the lock file will be left. You may wish
# to delete the lock file at the same time.
        if [ ! "$?" = "0" ]; then
                rm -f /var/run/$DEVICE.pid
                echo "ERROR: Removed stale pid file"
                exit 1
        fi
#
# Success. Let pppd clean up its own junk.
        echo "PPP link to $DEVICE terminated."
        exit 0
fi
#
# The ppp process is not running for ppp0
echo "ERROR: PPP link is not active on $DEVICE"
exit 1                    
</programlisting>

<para>
<filename>/etc/ppp/keepalive.sh</filename>
</para>
<programlisting>
#!/bin/sh

# keepalive.sh

# This is a keepalive script for the Casema cable modems. This script was
# lifted from the /usr/doc/HOWTO/unmaintained/mini/Dynamic-IP-Hacks
# document. There should be an entry in your crontab looking like:
# */2 * * * * /etc/ppp/keepalive.sh
# to run this script every 2 minutes to see if your connection is still
# up, if not, gracefully kill the pppd process and remake it.
# Modify paths as necessary.


if [ -f /var/run/ppp0.pid ]; then
 ping -c4 -l3 195.96.96.97 2>&1 | grep "0 packets" > /dev/null && \
 { /etc/ppp/ppp-off > /dev/null 2>&1 ; sleep 2 ; /etc/ppp/ppp-on }
else
 /etc/ppp/ppp-on
fi       
</programlisting>

<para>
<filename>/etc/resolv.conf</filename>
</para>
<programlisting>
search dynip.com
nameserver 195.96.96.97
nameserver 195.96.96.33   
</programlisting>

<para>
<filename>/etc/sysconfig/network</filename> (this file applies only to
RedHat and Mandrake distributions, adapt accordingly for other
distributions) 
</para>
<programlisting>
GATEWAYDEV=ppp0
GATEWAY=195.96.96.97  
</programlisting>

<para>
I've documented some things in the files themselves. The ppp-on script
is called during boot time from
<filename>/etc/rc.d/init.d/ppp</filename> and the
<filename>ppp-off</filename> script during shutdown. The
<filename>ppp-on-dialer</filename> is called from the
<filename>ppp-on</filename> script. The keepalive script for keeping the
connection alive as long as the computer is on (might as well, right?)
is called from <filename>crontab</filename> (see the keepalive file for
details). The <filename>/etc/sysconfig/network</filename> file specifies
the default gateway for routing. The <filename>resolv.conf</filename>
tells the computer which IP of casema.net to send DNS queries to (this
is pretty standard across all unixes, I believe).
</para>

<para>
I've forgotten to include the <filename>/etc/ppp/pap-secrets</filename>
which should be the same as the <link linkend=expressnet
endterm="expressnet.title"></link>, Maryland.  There's also the question of the
<filename>ip-up</filename>, <filename>ip-down</filename>. These however,
didn't need to be changed. I've also included the
<filename>options.ttyS0</filename> file, which should be in
<filename>/etc/ppp/ppp-on</filename>. It is read by the pppd daemon as
it logs on. There are a couple options like defaultrouteadd that should
be on. ttyS0 is the port where you install your modem mine is on COM1 ==
ttyS0. Change accordingly.
</para>

<para>
<filename>/etc/ppp/options.ttyS0</filename>
</para>
<programlisting>
asyncmap 0
crtscts
defaultroute
lock
modem
name cvd     
</programlisting>

<para>
I received notice from Casema a couple days ago that they will be
changing their name to <ulink
url="http://www.wanadoo.nl/">wanadoo.nl</ulink>.  So you might, in your
document, refer to both: "wanadoo.nl (formerly casema.net)" This will be
happening as of Sept.
20th.
</para>

<para>
I will be happy to provide you with information and answer any more
questions. I my explanations aren't Red Hat only. I haven't used other
systems, so I can't judge. I hope this is useful to you.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Prime Cable Expressnet, Las Vegas, NV</title>
<para>
This information is provided by jedi
<email>jedi@penguin.lcvm.com</email>:
</para>

<para>
They use the Com21 which can either be connected directly to your
10baseT input or inserted into the downlink input on your router. Static
IPs are available for $10 per month and the usual address assignment is
through DHCP ( <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink> )
</para>

<para>
More information can be obtained from
<ulink url="http://penguin.lvcm.com">http://penguin.lvcm.com</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>TVD, Belgium</title>
<para>
This information is provided by  Pierre-Yves Keldermans
<email>pykeldermans@usa.net</email>:
</para>

<para>
At home, my cable-TV company is "TVD", it is the first company to offer
internet on the cable in Belgium.
</para>

<itemizedlist>
<listitem><para>
Hardware : LanCity cable modem & 10-Base-T NIC ( DLink ISA if you buy it
from TVD )
</para></listitem>

<listitem><para>
Config : DHCP ( <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink> )
</para></listitem>

<listitem><para>
Prices :

<itemizedlist>

<listitem><para>
Cheap : for home use, real IP address but dynamic, DHCP expires every
10 min, 1 user only (theorically ... ), no problem with firewall, the
web server on my computer is even reachable from outside..., full speed
FROM internet, small speed TO internet.
</para></listitem>

<listitem><para>
No so cheap : for small office use, same as 1) but not limited to 1
user and more speed TO internet.
</para></listitem>

<listitem><para>
Expensive : for WWW servers & ... , Static IP addresses and reserved
bandwidth TO internet following price.
</para></listitem>

</itemizedlist>
</para></listitem>

<listitem><para>
Speed :
<itemizedlist>
<listitem><para>
From TVD's mirror site : up to 250Kbytes/sec, very nice ( and YES, they
have some Linux mirrors like redhat ... :-) )
</para></listitem>
<listitem><para>
From internet : variable but rather good if the remote server isn't
overloaded.
</para></listitem>
</itemizedlist>
</para></listitem>

<listitem><para>
For more info : <ulink url="http://www.tvd.be">http://www.tvd.be</ulink> and
<ulink url="http://www.tvd.net">http://www.tvd.net</ulink>.
</para></listitem>
</itemizedlist>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Telenet Vlaanderen, Belgium</title>
<para>
This information provided by Karel Goderis
<email>karel.goderis@pandora.be</email>:
</para>

<itemizedlist>
<listitem><para>
Operator: Telenet Vlaanderen - Operatial in flemish speaking
(northern) part of Belgium
</para></listitem>

<listitem><para>
Hardware: Motorola CyberSURFR Wave Cable Modem using an RJ-45 Ethernet
straight cable to a PC
</para></listitem>

<listitem><para>
Software: Standard config is Windoze + Modified Netscape for newbie
installations, although Linux i386 support is there under the form of
mirrored redhat.com software on the internal ftp servers. A dedicated linux
newsgroup is available for support. Most users depend on ipchains/ipfwadm in
2.2.x, or have a "Linux Router"-project implementation.
</para></listitem>

<listitem><para>
IP Setup:
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP address
assignment</ulink>, single address only. Outgoing : all
ports accepted, except mandatory use of Netscape Proxy on port 8080, and
thus port 80 blocked. Incoming : ports 0-1024 blocked, but re-allocation of
ports on Linux works fine.
</para></listitem>

<listitem><para>
Pricing: one-off installation : BF 10000 (+-$ 250) + BF 3000 ($75)
deposit for the cable modem (+$25 for Ethernet NIC if not present in pc)
monthly rental : BF 1500 ($40)
</para></listitem>

<listitem><para>
Services: redhat.com netscape.com mirrors, quake I and II servers,
proxy, mail relay and pop account (4 aliases) and the other usual stuff
you need to survive on the net.
</para></listitem>

<listitem><para>
Caveats: Telenet states that you can download 300Mbytes/month,
but this rule is not enforced unless there is a obvious abuse
(i.e. you download 300Mbytes/*day* ;-) ). This limit is applied on their
network boundary, not on what you transmit on the internal network,
so it does not take into account what you download of the mirrors.
</para></listitem>
</itemizedlist>

<para>
More info at
<ulink url="http://www.pandora.be/">http://www.pandora.be/</ulink> or
<ulink url="http://www.telenet.be/">http://www.telenet.be/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Total-Web, United States</title>
<para>
This information is provided by iota
<email>iota@inaxx.net</email>:
</para>

<para>
I work for Convergence.com, a cable internet company who provides the
network monitoring, technical support, and advice to cable providers (who,
in turn, provide the internet service to their customers). Most of our
markets are through Cablevision, one of the more popular cable providers
in the eastern US. The service name that they operate their cable internet
service under is "Total-Web". Customers are provided with a static IP;
simply set this up like you would any other ethernet device under Linux.
The modems we use are LanCity LCP's and COM21 ComPort's, but these devices
should be transparent to your computer.
</para>

<para>
Total-Web is available in limited areas, including: Miami Beach, FL;
Gwinnett County and Roswell, GA; Cookeville, Lebanon, and Columbia, TN;
and many other test markets.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>CyberCable, Paris, France</title>
<para>
This information is provided by David Monniaux:
</para>

<para>
CyberCable gives you an ethernet card if you need one. It is a cheap
NE2000 clone, ISA-Pnp or PCI I think. They only know how to set up the
stuff for Windows, but reports from other people say that they let you
use their access with other systems, provided you do the software setup
yourself.
</para>

<para>
They use <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink> DHCPcd
in RedHat worked immediately. In RedHat's <command>netcfg</command>,
this means selecting "DHCP configuration".  There are still some
problems sometimes: DHCP outputs some error messages, but things still
work afterwards generally (?). This seems related to rebooting; it looks
like the cable system doesn't reallocate the line for one minute after
reboot.
</para>

<para>
CyberCable's web site is at
<ulink url="http://www.cybercable.fr">http://www.cybercable.fr</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Stj<74>rnTV, Stockholm Sweden</title>
<para>
This information is provided by  Fredrik Staxaeng
<email>fstx@algorithmica.se</email>:
</para>

<para>
Stj<EFBFBD>rnTV sells a Bay Networks Versalar Cable Modem 100, and they
include a NetGear ethernet card in the initial fee. Just set your
interface to <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>. Info
about their service is available at <ulink
url="http://www.starport.se">http://www.starport.se</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>GCI.Net, Alaska</title>
<para>
This information is provided by GCI Tech Support
<email>support@gci.net</email>:
</para>

<para>
GCI provides CableModem services in Alaska, currently in Anchorage,
Juneau, and Fairbanks.  GCI uses Com21 which can either be connected
directly to your 10baseT input or inserted into the downlink input on
your router.  Static IPs are available for $10 per month and the usual
address assignment is through <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>.  More
information can be obtained from <ulink
url="http://www.gci.net">http://www.gci.net</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Saturn Communication NZ Ltd, New Zealand</title>
<para>
This information is provided by Nigel Win
<email>nigelwin@the.net.nz</email>:
</para>

<para>
The installation of Saturn Cable Modem connection is simple as
installation of a NIC. They will only install and support the
Windows Machines but Linux user will have no problem. They provide
a static ip address for each connection along with class B Net mask
255.255.0.0 , DNS Servers and Gateway address to use. If you are
on a Redhat box, open the control-panel and open network
configuration and simply enter the detail information provided
by Saturn. For other linux distributions user should read NET-3-HOWTO.
</para>

<para>
They use Com21 Cable Modem <ulink
url="http://www.com21.com">http://www.com21.com</ulink> and
provide free D-Link PCI or ISA network card if you require.
The monthly fee already includes Cable Modem rental and they
offer 2 connection speed plans ( 512k/128k and 2Mbps/256K ).
But they charge you on how much traffic you transfer :).
The speed is not bad since I am getting around 90K for download speed
at peak time.
</para>

<para>
More info about Saturn is available at <ulink
url="http://www.saturn.co.nz">http://www.saturn.co.nz</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Chello, Netherlands</title>
<para>
This information is provided by Jaco de Groot
<email>jaco@dynasol.com</email>:
</para>

<para>
I'm from The Netherlands and use a Terayon cable modem under Red Hat
6.0. My provider is Chello. I have installation instructions in Dutch
on my homepage
<ulink url="http://www.dynasol.nl/~jaco/redhat6.0/install.html">
http://www.dynasol.nl/~jaco/redhat6.0/install.html</ulink>.
Chello has replaced all LAN-City modem in my city with Terayon modems
(configuration remains the same because it uses the same network
card).
</para>

<para>
If you are not using RedHat check out the
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP mini-HOWTO</ulink>
on instructions how you can get your computer to connect to Chello network.
</para>

<para>
Info about Chello can be found at <ulink
url="http://www.chello.nl/">http://www.chello.nl/</ulink>
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Adelphia Powerlink, USA</title>
<para>
This information is provided by Kevin Pfohl
<email>kspfohl@adelphia.net</email>:
</para>

<para>
If you have a Adelphia service with a two way modem connection (e.g.
you don't need a regular phone modem to dial in) all you have to do
is install Linux and use
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>
to get your network connection going. If you have a one-way modem please
read info on <link linkend=adelphiahybrid
endterm="adelphiahybrid.title"></link>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>21st Century Telecom, Chicago, IL, USA </title>
<para>
This information is provided by Jens B. Jorgensen
<email>jjorgens@bdsinc.com</email>:  
</para>

<para>
21st Century uses a "Regular" cable modem, that is up-stream and
down-stream are both over the cable connection. The equipment is made by
Zenith. The installer will bring along a NIC with them, (mine was an OEM
Intel EtherExpress Pro 10/100) which is connected via a 10-base-T cable
(crossover?) directly to the cable modem. All 21st Century customers are
assigned a static IP address. Just make sure your kernel is configured
to support this card or insmod the module for it a configure the IP.
You'll also be provided with a gateway address which you'll need to set
the default route to. Be mindful of the netmask (255.255.0.0 for me) on
the ether interface. Also note that the cable modem seems to 'learn' the
ethernet address of the adapter you're provided with and will only work
wit that adapter. I don't know if reseting the cable modem would cause
it to relearn the address or not. I didn't feel the need to try the
cable modem with another adapter.
</para>

<para>
Additional notes by Mark Howard <email>mark@xanderbelly.com</email>
</para>

<para>
Please note that this service has been changed; they now only use Nortel
cable modems and everyone is assigned a dynamic IP address now.  Also, my
Nortel cable modem does not seem to care which machine or MAC address is
connected to it; I have set up multiple machines on it and they all
worked fine.  In fact, if you hang a hub directly off the cable modem,
you can get multiple valid IP adresses assigned through DHCP!   I
wouldn't recommend this, however, as a long term solution.  I have a RH
box set up as a firewall doing NAT for me on the one address, and it
works just great.  This service is particularly good - I consistently get
95-100KBps, or just about a 1Mbps rate.  I also live in a coach house
rental here in Chicago, and although they wanted to run new cable in the
apartment, I told them to use the old cable because it was not my place. 
They said they could not guarantee that the service would work, but of
course it does work just fine!  So don't let them talk you into running
new cable if you can avoid it.
</para>

<para>
Also, if you want to set up your own web server from home, I used a great
service called <ulink url="http://www.easydns.com/">EasyDNS.com</ulink>
where you pay them $25 per year per domain and you can control your 
DNS settings (even SOA, TTL, etc...) 24/7/265 through a web based 
(PHP no less) interface.  So if I ever need to reboot
my Linux box (which I never do really) I can go in and update the IP
address that my web server www.xanderbelly.com and mail server
</para>

<para>
Additional notes:
</para>

<para>
The terms and conditions of 21st Century cable modem contains the
following statement:
</para>

<para>
Distributing unsolicited information in any manner is prohibited on 21st
Century's network and will result in termination of 21st Century
service. (I.e. junk email, etc...)  Any use of a server type application
or service on a computer system connected to 21st Century Cable Modem
Service is prohibited and may result in termination of 21st Century
Cable Modem Service (i.e. web, ftp, or game servers, etc...). 21st
Century Cable Modem Service is for client type applications ONLY.
</para>

<para>
Also, technically, each additional dynamic IP address beyond the first
one carries a $4.95 monthly charge.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>HTVi, Helsinki, Finland</title>
<para>
This information is provided by Markku Immonen
<email>wired.poet@sci.fi</email>:  
</para>

<para>
HTV is the local cable TV company. Their Internet product is called
HTVi. They issue a Motorola CYBERSURFR Wave cable modem for all
customers. It plugs into an ethernet card using a 10BaseT (RJ-45) cable.
Customers have two options: 
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink> 
or a static IP address. The <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>
(dynamic IP address) option is 50 Finnish marks cheaper; in October 1999
the prices were 245 FIM per month for a dynamic address and 295 FIM for
a static one.
</para>

<para>
I opted for a static IP. Configuration was incredibly easy. They give
you a couple of info brochures which contain the necessary IP and
networking information.
</para>

<para>
About speed: it varies but is generally acceptable, from 30 kbytes/sec
to 200 kbytes/sec. Your best bet is the early morning hours. The fastest
download speed so far was 470 kbytes/sec from a Finnish Linuxberg
mirror.
</para>

<para>
More information about HTVi can be found at 
<ulink url="http://www.htvi.net/">http://www.htvi.net/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Garden State Cable, New Jersey</title>
<para>
This information is provided by Denis Voitenko
<email>denis@o3m.com</email>:  
</para>

<para>
In New Jersey Garden State Cable offers @Home. They give you a 3Com CMX
series cable modem and a SMC PCI NIC with the DIGITAL chip. It works just
perfect with the Tulip driver. They assign static IP addresses.
</para>

<para>
One more interesting thing. Unlike in most places, upstream speed is not
limited to 128kbs. 
</para>

<para>
Garden State cable web pages are located at 
<ulink
url="http://www.gardenstatecable.com/">http://www.gardenstatecable.com/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Zoom Internet, Butler County, PA</title>
<para>
This information is provided by Jim Garrison
<email>garrison@olga.net</email>:  
</para>

<para>
Zoom internet <ulink
url="http://www.zoominternet.net/">http://www.zoominternet.net/</ulink>
is a cable ISP.  They provide a Bay Networks cable modem, which connects
to a 10-Base-T ethernet card.  The only thing required to set it up is
to enable <ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>.  
</para>

<para>
Note:  They provide the cable modem, but you must have your ethernet
card working properly with 
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>
before the installation guys come.
</para>
</sect2>



<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Charter Pipeline, St. Louis Metro Area</title>
<para>
This information is provided by Chris Weiss 
<email>chris@free-source.com</email>:
</para>

<para>
Charter gave me a 3Com cable modem that uses DHCP.  I 
simply followed the 
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP
mini-HOWTO</ulink> and my 256Kbps connection was running at over 350Kbps!
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Netcabo, TV Cabo,  Portugal</title>

<para>
This information is provided by Marco Soeima
<email>msoeima@netcabo.pt</email>:
</para>

<para>
It's a Portuguese ISP and it's available through TV Cabo. 
The hardware consists of a RealTek ethernet card (just use the rtl8139.o module)
and a 3Com U.S. Robotics CMX cable modem. The only thing required to get one's
cable access up and running is configure the ethernet card and install
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP</ulink>. 
After that it works like a charm!
</para>

<para>
More information about Netcabo can be found at

<ulink url="http://www.netcabo.pt/">http://www.netcabo.pt</ulink>.
</para>

</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Supercable, Spain</title>

<para>
This information is provided by Mario Galan 
<email>galan@arquired.es</email>:
</para>

<para>
The setup isn't so much different than other Cable providers. They offer a
SMC (I think) network card but you can use yours if you want. They then
install a cable modem made by com21 (http://www.com21.com). IP setup is
easy since it uses DHCP so I don't think you should have any problems
under a modern linux distribution.
</para>

<para>
Last thing worth to be said is that Supercable doesn't provide support
for Linux but you can always ask your questions in news.supercable.es in
the Linux area. Their web page is located at <ulink
url="http://www.supercable.es/">http://www.supercable.es/</ulink>
(WARNING: get
ready to download an almost 1MB of useless Macromedia's Flash garbage).
</para>

</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>NTL, United Kingdom</title>

<para>
This information is provided by cogNiTioN <email>cog-cablemodem@cognite.net</email>:
</para>

<para>
This assumes that you've spoken to NTL, you have the cable modem, the
cable line installed and your network card installed and recognised. You
should also have you MAC address registered with NTL.
(NTL contact: <ulink url="http://www.ntl.com/cablemodems/">http://www.ntl.com/cablemodems/</ulink>)
</para>

<para>
Now all you have to do is connect your cable modem to your network card
and run the DHCP client. I've found that you have to specify the username
you supplied during the registration process, on the command line: e.g.
root # dhcpcd -h cognition
(substitute cognition for your user name.). For any other problems with
DHCP please check out the
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP mini-HOWTO</ulink>.
</para>

<para>
I've also found that occasionally the 3COM CMX modem used needs to be
rebooted (power off, press the reset button on the back, power on) if left
connected 24/7.
</para>

<para>
Nameservers used by NTL are: 194.168.4.100 and 194.168.8.100, so those
should be added to your /etc/resolv.conf.
</para>

<para>
I've found NTL's tech support to be close to useless, most the time and
they don't officially support Linux, so you're probably better off
contacting your local LUG (<ulink url="http://www.lug.org.uk/">http://www.lug.org.uk/</ulink> ),
or you could even try
mailing me direct (but I don't promise to be able to respond).
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>Virtua, S<>o Paulo, Brazil</title>

<para>
This information is provided by Thiago Macieira <email>thiagom@mail.com</email>:
</para>

<para>
IP is assigned dynamically via DHCP. Just run dhcpcd or pump to get
the IP and you're done. For more detailed instructions on how to get DHCP running
read the
<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP mini-HOWTO</ulink>.
</para>

<para>
Notes: operator blocks incoming connections to ports below 1024
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>Hathway, Bombay, India</title>

<para>
This information is provided by Rishi Gangoly <email>rishi@w-o-i.com</email>:
</para>

<para>
The tech support guys at Hathway were not Linux Savvy at all, but I must say
were quite helpful. They even referred me to another customer who got Linux to
work with it. However, that person was only able to get it to work on Linux as a
stand-alone workstation and not as a gateway (as a router) for his entire
network.
</para>

<para>
Since I was not even able to get it to work as a stand-alone workstation I knew
I had a long way to go. The Windows 98 Workstation configuration was a Celeron
Workstation and it had a
10/100 D-Link Lan Card   Chipset RTL 8139 . The IP address was manually entered,
so I knew that there was no DHCP Client required etc.
</para>

<para>
Even the DNS and Gateway address was manually entered.
</para>

<para>
I was able to do a ping without any problem in Windows to any site and things
were just happening. However, I had no luck with it in Linux. I installed Linux
on the same machine (Dual Boot) to make sure there was any Hardware
compatibility problems.
</para>

<para>
I even got the workstation to hook up on the LAN successfully in Linux. So I
knew that the Lan Card was working.
</para>

<para>
I noticed that when I connected the Cable Modem to the LAN card I was not able
to see any of the Link LED light up on the LAN Card. So I figured that could be
part of the problem. I booted the PC in DOS and ran the DIAG DOS based utility
to check the configuration of the Card. I just decided to take a chance and
re-configured the LAN Card. I configured it to operate in 10 MBPS Half Duplex
Mode instead of Auto Sense.
</para>

<para>
.......... Guess what..... The problem got solved   ;-)
</para>

<para>
Even the lights (LED Link indicators) started to work, so all was good. ;-)
At the end of everything it all worked out. I plugged that lan card into the
linux server (since I knew it worked) and got it to work as a router / gateway
too. I still wonder why the other customer was not able to get the Linux Box to work
as a gateway for the rest of his network. That was no big deal at all. It just
worked. The Cable Modem that was used (provided by Hathway) was a SurfBoard 3100
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>Siti Cable, Bangalore, India</title>

<para>
This information is provided by Vinay Avasthi <email>vinay@avasthi.com</email>:
</para>

<para>
Zee Telefilms has partnered with Siti Cable in Bangalore, India to
provide cable modem service. I subscribed to this service and it kind of
worked out of the box from linux.
</para>

<para>
I am using Redhat 6.1 on a IBM Thinkpad 600 with Xircom Realport
Ethernet card. On autodetect links mentions that the card will be used
in 10MB/s only.
</para>

<para>
Only problem that I faced was on shutdown, the system will hang while
shutting down pump. To temporarily fix the problem I just put that
particular like in rc-scripts to background.
</para>

<para>
The steps that one needs to perform are as follows.
</para>

<itemizedlist>
<listitem><para>
    - Need to have an ethernet card that works with Linux.
</para></listitem>
<listitem><para>
- Enable DHCP by using pump. For some reason dhcpd does not seem to
work.
</para></listitem>
</itemizedlist>

<para>
Only thing that I would suggest is to be careful regarding support since
the tech support do not seem to know much about software.
</para>
</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect2>
<title>Com Hem, Sweden</title>

<para>
This information is provided by Zoltan Arpadffy <email>arpadffy@polarfox.com</email>:
</para>

<para>
com hem <ulink url="http://www.comhem.se/">http://www.comhem.se/</ulink>
is a Swedish cable TV/Internet provider, a sub-company
of Telia <ulink url="http://www.telia.com/">http://www.telia.com/</ulink>
the biggest Scandinavian carrier.
com hem does not support any other OS but Windows and Mac-OS (as com hem support
claims ), but it is not so complicate to set up on Linux as well.
</para>

<para>
com hem sells NetGame's cable modem (NeMo). Initial speed is 512 kb/s and it can be
set up to 10Mb/s. You can order it with or without Ethernet card.
com hem internet service is available in the bigger cities all over Sweden.
</para>

<sect3>
<title>1. Setting up a single node</title>

<itemizedlist>
<listitem>
<para>
set up your network card to work properly
(<ulink url="http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html">Ethernet HOWTO</ulink>)
</para>
</listitem>

<listitem>
<para>
configure DHCP to that card (DHCP mini-HOWTO)
</para>
</listitem>

<listitem>
<para>
you need some browser what supports Java-script (as Netscape) and go to the login
site <ulink url="http://login1.telia.com/">http://login1.telia.com/</ulink>
</para>
</listitem>

<listitem>
<para>
- fill in your user-name and password (provided by com hem) ... and you're there.
</para>
</listitem>

</itemizedlist>

<programlisting>
Network what you'd become a member is:
        IP address: Assigned by com hem
        Subnet mask: 255.255.255.0
        Default GW: Assigned by com hem
        Hostname: Assigned by com hem
        Domain name: telia.com
        Primary DNS server (nameserver): 10.0.0.1
        Secondary DNS server (nameserver): 10.0.0.2
</programlisting>
</sect3>

<sect3><title>
2. Connecting your home LAN (if you have more than one machine)
</title>

<para>
We have to turn one computer to gateway (I did it with an old Pentium 66MHz/16M)
<itemizedlist>
<listitem><para>
install two network cards in your gateway
<ulink url="http://www.linuxdoc.org/HOWTO/NET3-4-HOWTO.html">NET3-4 HOWTO</ulink>
</para></listitem>

<listitem><para>
first set up (and connect) to your LAN
</para></listitem>

<listitem><para>
second network card have to use DHCP
(<ulink url="http://www.oswg.org/oswg-nightly/DHCP.html">DHCP mini-HOWTO</ulink>)
</para></listitem>

<listitem><para>
enable ip forwarding

<programlisting>
net.ipv4.ip_forward = 1 in /etc/sysctl.conf or by
echo "1" > /proc/sys/net/ipv4/ip_forwarding
</programlisting>
</para></listitem>

<listitem><para>
set up IP masquerade
(<ulink url="http://www.linuxdoc.org/HOWTO/IP-Masquerade-HOWTO.html">IP Masquerade mini-HOWTO</ulink>)
<programlisting>
ipchains -P forward DENY
ipchains -A forward -s your_network_here/24 -j MASQ
</programlisting>

(for me it was ipchains -A forward -s 192.168.10.0/24 -j MASQ)
check your routing table with route command... it should be something like below:

<programlisting>
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
gate.polarfox.h *               255.255.255.255 UH    0      0        0 eth0
telia-net       *               255.255.255.0   U     0      0        0 eth1
polarfox-net    *               255.255.255.0   U     0      0        0 eth0
127.0.0.0       *               255.0.0.0       U     0      0        0 lo
default         h2n5fdt22o429.t 0.0.0.0         UG    0      0        0 eth1
</programlisting>

Useful literature for security issues is
<ulink url="http://www.linuxdoc.org/HOWTO/IPCHAINS-HOWTO.html">Linux IPCHAINS HOWTO</ulink>

</para></listitem>

<listitem><para>
configure default gateway for all other hosts in your LAN.
On unix nodes it should look something like:

<programlisting>
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
sea.polarfox.ho *               255.255.255.255 UH    0      0        0 eth0
polarfox-net    *               255.255.255.0   U     0      0        0 eth0
127.0.0.0       *               255.0.0.0       U     0      0        0 lo
default         gate.polarfox.h 0.0.0.0         UG    0      0        0 eth0
</programlisting>

Default gateway setup for other OSs you can find a very nice description in IP
Masquerade mini-HOWTO
</para></listitem>

<listitem><para>
configure name server on your gateway DNS HOWTO or just set up your hosts to use
Telia's name server (10.0.0.1)
</para></listitem>

<listitem><para>
log in from any host <ulink url="http://login1.telia.com/">http://login1.telia.com/</ulink>
and you're on the road with all your LAN.
</para></listitem>

</itemizedlist>

</para>
</sect3>

<sect3>
<title>
Problems:
</title>

<itemizedlist>
<listitem>
<para>
If you don't use browser with Java-script support, you can not log in.
Solution: there is no elegant solution. Without it you can not log in and open the
connection.
</para>
</listitem>
<listitem>
<para>
After some network inactivity period (10-15 minutes) your connection will be
terminated and you have to log in again... meanwhile your gateway and all your inner
services will be unreachable from outside as well (if you're running some web server
at home etc).
Solution: start one ping process or even more elegant solution is to submit one cron
job for every 5-10 minutes on the gateway, to "do something" though the network.
</para>
</listitem>
</itemizedlist>

<para>
I did it with /etc/cron.d/keep-alive file when contains:
</para>

<programlisting>
# fake connection in order to keep line alive
# every 5 minutes send some packages
MAILTO=""
*/5 * * * * ping -f -c 5 www.polarfox.com
</programlisting>

</sect3>
</sect2>
</sect1>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->
<sect1 id="hybrid">
<title>Hybrid Cable modem ISPs</title>
<para>
   If you think you have the card recognized you have to now look at the
   entry for your ISP. I have sorted the information according to a
   provider because setups are mostly ISP specific.
</para>

<para>
This section is for people who are using so-called "hybrid" cable
modems. Hybrid modems are modems that need two hookups (connections),
one to the (TV) cable and one to the phone line. TV cable is used for
downloading while phone line is used for uploading.
</para>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="adelphiahybrid"> 
<title id="adelphiahybrid.title">Adelphia Powerlink, USA</title>
<para>
Instructions on how to get your Adelphia Powerlink hybrid modem 
running under Linux can be found at <ulink
url="http://linuxpower.cx/~cable/">http://linuxpower.cx/~cable/</ulink>
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>LinkExpress, Brasil</title>
<para>
This information is provided by Rodrigo Severo
<email>rodrigo@who.net</email>:
</para>

<para>
First of all, let me tell you that here we have the MMD Cable Modem
from General Instrument. We use SurfBoard 1000 ISA board for download
and a regular telephone modem for upload. I would prefer to use an
external board like the SurfBoard 1200 which is available only to
corporate users, i.e., willing to pay US$ 200,00 instead of the regular
US$ 30,00 so I found out this driver for the internal ISA board.
For home users, Linkexpress (my ISP) just installs and supports
the internal ISA board - Surfboard 1000. If you want to use it, you
have to install Windows 95/98 on your computer and let the guy
from Linkexpress install the equipment. After that, make your
Linux installation as you like.
</para>

<para>
I started from the files I downloaded from 
<ulink
url="http://linuxpower.cx/~cable/">http://linuxpower.cx/~cable/</ulink>.
</para>

<para>
Here is the relevant data:
</para>

<itemizedlist>
<listitem><para>
ISP: LinkExpress <ulink
url="http://www.linkexpress.com.br">http://www.linkexpress.com.br</ulink>
</para></listitem>
<listitem><para>
DNS: 200.252.88.20
</para></listitem>
<listitem><para>
Frequency: 351 MHz
</para></listitem>
<listitem><para>
Phone number: 321 3300
</para></listitem>
<listitem><para>
City: Brasilia
</para></listitem>
<listitem><para>
Province: Distrito Federal
</para></listitem>
<listitem><para>
Upload speed: regular 33.6K (just the download goes through the
cable modem)
</para></listitem>
</itemizedlist>

<para>
During a download from a local tucows mirror I got 70KB~300KB per
second. From distant sites I managed to get 30KB/s a few times.
</para>

<para>
More information about LinkExpress can be found at
<ulink
url="http://www.linkexpress.com.br/">http://www.linkexpress.com.br/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2 id="expressnet"> 
<title id="expressnet.title">ExpressNet, Maryland</title>
<para>
I recently accuired an expressnet cable modem for the maryland area.
it is a  com21 one way modem and I had a hell a time making it work so id like
to share my knowledge in your faq maybe? well heres what I learned
inorder for the PPP connection to authenticate the user must be running PAP
which consists of editing the <filename>/etc/ppp/pap-secrets</filename>
file accordingly:
</para>

<programlisting>
#/etc/ppp/pap-secrets
#this is the PAP secrets file for PPP
#the quotes are required on both
"username"      *       "password"
</programlisting>

<para>
after that they must create a <filename>PPP-on</filename> script what ever name
it must execute this command:
</para>

<programlisting>
exec /usr/sbin/pppd debug persist /dev/ttyS1 38400 0.0.0.0:0.0.0.0 connect "chat -v TIMEOUT 3 ABORT 'BUSY' ABORT 'NOANSWER' '' ATH TIMEOUT 30 'OK' ATDTTELEPHONE CONNECT ''"
</programlisting>

<para>
this must be done with no carrage returns either    
</para>

<para>
next step is to modify the <filename>/etc/ppp/ip-up.local</filename>
file if it does not exist it should be created it should read the
following:
</para>

<programlisting>
#!/bin/bash
#/etc/ppp/ip-up.local
#this will set up the route to the ppp device as default everytime the modem
#authenticates dont include it if you do not want this option
route add default ppp0
</programlisting>

<para>
then the user must configure their ethernet card on box I have a 3c905.
</para>

<para>
I configured it the following way:
</para>

<programlisting>
ifconfig eth0 up
ifconfig eth0 10.0.0.1 broadcast 10.0.0.15 netmask 255.255.255.240
</programlisting>

<para>
then I added some more routes to the kernel routing table as follows:
</para>

<programlisting>
route add -host 10.0.0.1 eth0
route add -net 10.0.0.0 eth0
</programlisting>

<para>
all of these commands can be added into a script file as follows
</para>

<programlisting>
#!/bin/bash    
#This is a script file for establishing the cable modem IF device properties as
#well as the route properties
ifconfig eth0 up
ifconfig eth0 10.0.0.1 broadcast 10.0.0.15 netmask 255.255.255.240
route add -host 10.0.0.1 eth0
route add -net 10.0.0.0 eth0
</programlisting>

<para>
thats all and the cable modem connection is setup fast as hell I might add. 
</para>

<para>
Contributors:
Chris <email>chris@wrm.grdn.net</email> and Mike Milbert
<email>mike@milbert.com</email>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Charter Pipeline, Riverside, CA</title>
<para> 
This information is provided by Gabriel Peters
<email>gpx1@earthlink.net</email>:
</para>

<para>
(I have Charter Pipeline, Powered by Earthlink, Riverside, CA)
The modem is a Com21 ComPORT 2000.. connected to the computer via 
10 BaseT ethernet cable to a Linksys 10/100 ethernet card 
(Cable modem, ethernet cabling, and ethernet card supplied)
The ethernet card driver that I had to compile into the kernel 
was for the DEC Tulip. auto-detected the card and set it up nicely.
</para>

<para>
This is the information I needed:
</para>

<programlisting>
eth0 IP address - 10.0.0.1
DNS Servers - 207.217.126.81, 207.217.120.83
Subnet Mask - 255.255.255.240
Gateway: None
Your hostname should be CBL-(your username).hs.earthlink.net
</programlisting>

<para>
Then you need to configure PPP to dial up your access number as normal..
What I had to do to get it to work was this: I typed <command>ifconfig
eth0 down</command> to shutdown the ethernet, <command>ppp-go</command>
to dial in, once it reported my IP addresses, i typed <command>ifconfig
eth0 up</command> and voila, it worked perfectly.
</para>

<para>
Editor's comment:
</para>

<para>
Each time PPP link is brought up or down pppd executes scripts 
<filename>/etc/ppp/ip-up</filename> (link up) and
<filename>/etc/ppp/ip-down</filename> (link down) so in order to
have Ethernet network go up and down with PPP link simply add:
</para>

<programlisting>
ifconfig eth0 up
</programlisting>

<para>
before <literal>exit 0</literal> statement in
<filename>/etc/ppp/ip-up</filename> and <literal>ifconfig eth0
down</literal> in <filename>ip-down</filename>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Chambers Cable, Chico, CA / Fundy Cable, New Brunswick</title>
<para>
This information is provided by Brian Moore <email>bem@cmc.net</email>:
</para>

<para>
For those using Chambers Cable in Chico, CA, the product is the
Scientific Atlanta data Xcellerator(tm) modem.  Mike Cumings of Cal
State University wrote a nifty driver for it, available at
<ulink
url="http://www.ecst.csuchico.edu/~mcumings/cablemodem/">http://www.ecst.csuchico.edu/~mcumings/cablemodem/</ulink>.
This should also work for others using the same modem, such as Fundy
Cable of New Brunswick.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Smyrna Cable, Atlanta, GA</title>
<para>
This information is provided by Blake Sorensen
<email>librarian@unseen.net</email>:
</para>

<para>
I have Smyrna Connect, supported by Smyrna Cable in Atlanta, GA.  They
are currently (June, 1999) using half-duplex but are scheduled to have
full-duplex within six months.  The Cable Modem is a ComPort Com21.  
Here is the configuration stuff I needed to get my linux box running as 
my dialup.
</para>

<para>
My eth0 device is a 3com ISA card set to IP 10.0.0.1, Bcast 10.0.0.255,
Mask 255.255.255.0. 
</para>

<para> 
The machine is set to the hostname Smyrna418.smyrnacable.net where
Smyrna418 is my username.  I don't think this is that important, but I
haven't fiddled with it to see if it will still work once I change the
hostname.
</para>

<para>
My modem is an external 56K X2 US Robotics on <filename
class="directory">/dev/ttyS0</filename>.
</para>

<para>
I also have eth1 (a DEC tulip based pci card) set
up as 192.168.0.1 as the gateway for the rest of my network to
masquerade behind.  
</para>

<para>
Smyrna Connect does not give you DNS info for the cablemodem
since you are supposed to use the Windows PPP feature of using the
default DNS for the server you dial in to.  However, they do have one
that works at 209.116.152.252. 
</para>

<para>
I use a ppp connection script to dial in, but the guts of it is this:
</para>

<programlisting>
/usr/sbin/pppd modem /dev/ttyS0 persist mru 1000 asyncmap 0 \
-detach crtscts user Smyrna??? defaultroute connect '/usr/sbin/chat \
ABORT BUSY ABORT ERROR "" ATZ OK ATDT7704365664 CONNECT' \
57600 0.0.0.0:0.0.0.0 &
</programlisting>

<para>
I keep the persist in there since Smyrna Connect has a habit of dropping
the connection every once in awhile, and this way it automatically dials
back in. You will need to replace the Smyrna??? in the above command 
with your own username and put the line:
</para>

<programlisting>
Smyrna???       Smyrna???       password
</programlisting>

<para>
in the file <filename>/etc/ppp/pap-secrets</filename>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Amnet de Costa Rica, Costa Rica</title>
<para>
This information is provided by 
Roberto Salvatierra <email>chuby@internettico.com</email>:
</para>

<para>
Ok to set up a Hybrid cable modem conection using Costa Rica's Amnet
Provider is not all that hard ( once you get the hang of it ) is like 
the other providers that use com21 modems, but with some minor diferences.
</para>

<para>
My Hardware is: 
</para>

<programlisting>
CableModem: Com21 ComPort 1000
Modem     : Rockwell 56k
Ethernet  : Ne2k PCI clone
Machine   : i386
Os        : Debian 2.1
Kernel    : either a 2.2.x or a 2.3.x*
</programlisting>

<para>
The first thing I did was disable my whole networking system, mainly because
i had a real mess on my routing tables, hosts, and resolv.conf files 
( I was using several ISP's and an intranet ) so I opted for this 
but that was just me, I even stopped lo so I started with a clean config.
</para>

<para>
okey first of all if you have a dual system ( win/linux ) make sure the
system is working under windows, that way we can make sure everything is up
and running, after that, reboot to linux**. 
</para>

<para>
If you don't have a dual system I found something interesting that MIGHT
help you state if the cablemodem and the eth card are functional, first, type
this on your system:
</para>

<programlisting>
ifconfig eth0 up
ifconfig eth0 10.0.0.1 netmask 255.255.255.240
route add -host 10.0.0.1 eth0
</programlisting>

<para>
after that look in your system log files for pings from
10.0.0.4 ( I have no idea why but this machine keeps "pinging" my box ,I
asked amnet's help desk what was this all about, and they didn't give me an
answer I guess they do It to check the network integrity) well anyhow, if you
get this pings means that amnet connection is working okey.
</para>

<para>
well after we have stated that the cable modem is up and running the rest is
quite easy.
</para>

<para>
if you did the above step now lets bring eth0 down ( <command>ifconfig
eth0 down</command> )
</para>

<para>
first lets place amnet's DNS where it sould be in
<filename>/etc/resolv.conf</filename> so we need to add this:
</para>

<programlisting>
search amnet.co.cr
nameserver 196.40.3.10
</programlisting>

<para>
okey now we need a ppp script for the modem
</para>

<para>
this one works: ( we all use the same username "amnet" and password
"conexion" so for this to work just cut and paste)
</para>

<programlisting>
exec /usr/sbin/pppd /dev/ttyS1 57600 0.0.0.0:0.0.0.0 debug user amnet
defaultroute connect "chat -v TIMEOUT 60 ABORT 'BUSY' ABORT 'NOANSWER' ''
ATH TIMEOUT 60 'OK' ATDT2969130 CONNECT ''"
</programlisting>

<para>
amnet uses PAP (password authentication protocol) to authenticate users
so we need to add a line to <filename>/etc/ppp/pap-secrets</filename>:
</para>

<programlisting>
"amnet" * "conexion"
</programlisting>

<para>
okey now you need to bring ppp up so just run that script to check that it
works type: <command>ifconfig</command>, now you should have something like this:
</para>

<programlisting>
ppp0      Link encap:Point-to-Point Protocol
          inet addr:196.40.3.177  P-t-P:196.40.30.114  Mask:255.255.255.255
          UP POINTOPOINT RUNNING NOARP MULTICAST  MTU:1500  Metric:1
          RX packets:7 errors:1 dropped:0 overruns:0 frame:1
          TX packets:9 errors:0 dropped:0 overruns:0 carrier:0
          Collisions:0
</programlisting>

<important>
<para>
make sure at this point that you do not have eth0 up or it WILL NOT WORK
</para>
</important>

<para>
okey after you have this working type this:
</para>

<programlisting>
ifconfig eth0 up
ifconfig eth0 10.0.0.1 netmask 255.255.255.240
route add -host 10.0.0.1 eth0
</programlisting>

<para>
now type <command>ifconfig</command> you should have something like this:
</para>

<programlisting>
eth0      Link encap:Ethernet  HWaddr 00:00:21:61:7C:F0
          inet addr:10.0.0.1  Bcast:10.255.255.255  Mask:255.255.255.240
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:5594 errors:0 dropped:0 overruns:0 frame:0
          TX packets:241 errors:0 dropped:0 overruns:0 carrier:0
          Collisions:0
          Interrupt:11 Base address:0xde00

ppp0      Link encap:Point-to-Point Protocol
          inet addr:196.40.3.142  P-t-P:196.40.30.114  Mask:255.255.255.255
          UP POINTOPOINT RUNNING NOARP MULTICAST  MTU:1500  Metric:1
          RX packets:7 errors:2 dropped:0 overruns:0 frame:0
          TX packets:65 errors:0 dropped:0 overruns:0 carrier:0
          Collisions:0
</programlisting>

<para>
and voila , your conection is up and running !!
</para>

<para>
some tips:
</para>

<para>
when you are not connected your eth should be DOWN
activate eth only AFTER ppp is running OR IT WILL NOT WORK.
</para>

<para>
To make this you can add the eth up and down scripts to 
<filename>/etc/ppp/ip-up</filename> and
<filename>/etc/ppp/ip-down</filename> scripts ( on debian just place them
on <filename>/etc/ppp/ip-up.d</filename> and
<filename>/etc/ppp/ip-down.d</filename> )
</para>

<para>
<filename>ip-up</filename> should contain this:
</para>

<programlisting>
ifconfig eth0 up
ifconfig eth0 10.0.0.1 netmask 255.255.255.240
route add -host 10.0.0.1 eth0
</programlisting>

<para>
and <filename>ip-down</filename> this:
</para>

<programlisting>
ifconfig eth0 down
</programlisting>

<para>
now here is a WORKING route table that might help you troubleshooting the
system: ( my HOSTN = hostname )
</para>

<programlisting>
Destination     Gateway         Genmask         Flags Metric Ref    Use
Iface
HOSTN.amnet.co. *               255.255.255.255 UH    0      0        0 eth0
196.40.30.114   *               255.255.255.255 UH    0      0        0 ppp0
HOSTN.amnet.co. *               255.255.255.240 U     0      0        0 eth0
default         196.40.30.114   0.0.0.0         UG    0      0        0 ppp0
</programlisting>

<para>
Relevant Information:
</para>

<programlisting>
DNS      : 196.40.3.10
----- eth0 -----
IP       : 10.0.0.1 
NetMask  : 255.255.255.240
Bcast    : 10.255.255.255
Gateway  : NONE
----- ppp ------
IP       : 196.40.X.X (Dhcp Pool)
NetMask  : 255.255.255.255
Bcast    : Unknown
Gateway  : Self Default
</programlisting>

<para>
that's all folks !!
</para>

<para>
if you need this in spanish look for it in: <ulink
url="http://www.internetTICO.com/cablemodem.html">http://www.internetTICO.com/cablemodem.html</ulink>
</para>

<para>
Questions/comments: <email>chuby@internettico.com</email>.  Please use the subject CABLEMODEM or I will not answer.
</para>

<para>
Biography: Linux Cable Modem mini-how-to Chapter: Hybrid cable modems
sections, 4.2 and 4.4
</para>

<para>
* about using 2.3.x kernels, this are unstable as anyone knows but I found
that the performace with this kernel and amnet is LOUSY ( like a 14K modem )
I DO NOT RECOMEND USING IT, but anyhow if you do use it and you get that
your machine does not have ppp do not panic just upgrade your pppd program,
2.3.x kernels use a split async sync interface so pppd < 2.3.10 will NOT
work.
</para>

<para>
** sometimes when I'm using the cable modem on windows and I reboot to 
linux the modem gets "stupid" so I need to turn off the modem, the machine, 
then turn on the modem and restart the machine after that it always work. I
have no Idea why this happens but I'm guessing that the ethernet card has
a different hardware address on windows and linux (wierd) and that the modem 
keeps this config on an memory, and that it needs to be cleand up for it to
work, so if it was working on windows and you are not getting even a ping
on linux try this.
</para>

<para>
More info about Amnet can be obtained at <ulink
url="http://www.amnet.co.cr/">http://www.amnet.co.cr/</ulink>.
</para>
</sect2>


<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Prime Cable, Chicago, IL</title>
<para>
This information is provided by Eric Agnew 
<email>agnew@goku.dyndns.org</email>:
</para>

<para>
I just got a hybrid com21 setup w/ Prime Cable in Chicago, and I have a
very important addition that will save other users (particularly debian
users w/ newer kernels) a LOT of grief:
</para>

<para>
When I initially set everything up, I was able to establish the ppp
connection just fine, but the only things coming back over eth1 were
broadcast packets from an internal (10.0.0.x) network.  After 3 weeks of
extreme frustration, I finally found the solution in the kernel docs under
Documentation/networking/README.sb1000:
</para>

<para>
  Solution -- As root type:
</para>

<programlisting>
echo 0 > /proc/sys/net/ipv4/conf/cm0/rp_filter'
</programlisting>

<para>
so it can share the same IP address as the ppp0 interface.
</para>

<para>
The boot-time script that sets this normally on debian systems is in
/etc/init.d/networking, in the 'spoofprotect_rp_filter' function.  I simply
added 'echo 0 > /proc/sys/net/ipv4/conf/eth1/rp_filter' after it had done
everything else.  To be sure, I also added it to a script I added to
/etc/ppp/ip-up.d that brought eth1 up if I was using the cable connection
(as opposed to my other straight-ppp connection).
</para>

</sect2>

<!-- S e c t i o n - - - - - - - - - - - - - - - B r e a k e r -->   
<sect2> 
<title>Millennium Digital Media, Maryland</title>

<para>
This information is provided by Mike Miller
<email>CableModem@mikemiller.net</email>:
</para>

<para>
I live in Maryland (Anne Arundel County) where my cable
company is Millennium Digital Media (
 <ulink url="http://millenniumdigitalmd.com/">http://millenniumdigitalmd.com/</ulink>
),
which offers Cable Modem service from Cablespeed (
 <ulink url="http://cablespeed.com/">http://cablespeed.com/</ulink>
).  
Since most areas aren't currently upgraded to 2-way digital service, 
for now they're giving us a General Instruments SURFboard SB2100D 
external (hybrid) cable modem (which includes a 33.6 modem), so you plug 
the cable and phone line right into the cable modem -- no need to use
your own modem or set up ppp or anything.  The modem uses DHCP to 
determine all the settings and connect to the network, so all I have
to do it switch on the modem and it automatically dials up and connects
to the network.  To get Linux working, all I had to do was load and configure
dhcpd (or dhcp-client). Since I'm using Debian, all I ran was:
</para>

<programlisting>
   apt-get install dhcp-client
</programlisting>

<para>
and voila!  I was on the net.
</para>

<para>
If you're running something other than Debian, please read
DHCP mini-HOWTO at 
<ulink
url="http://www.oswg.org/oswg-nightly/DHCP.html">http://www.oswg.org/oswg-nightly/DHCP.html</ulink>.

</para>

</sect2>

</sect1>

</article>