Allied Telesis AT-2711FX User manual

613-001255 Rev. B
Network Adapters
AT-2711FX
AT-2712FX
AT-2812FX
AT-2912T
AT-2916SX
AT-2931SX
AT-2972SX
Linux User’s Guide

Copyright 2009 Allied Telesis, Inc.
All rights reserved. No part of this publication may be reproduced without prior written permission from Allied Telesis, Inc.
Microsoft and Internet Explorer are registered trademarks of Microsoft Corporation. Netscape Navigator is a registered
trademark of Netscape Communications Corporation. All other product names, company names, logos or other designations
mentioned herein are trademarks or registered trademarks of their respective owners.
Allied Telesis, Inc. reserves the right to make changes in specifications and other information contained in this document without
prior written notice. The information provided herein is subject to change without notice. In no event shall Allied Telesis, Inc. be
liable for any incidental, special, indirect, or consequential damages whatsoever, including but not limited to lost profits, arising
out of or related to this manual or the information contained herein, even if Allied Telesis, Inc. has been advised of, known, or
should have known, the possibility of such damages.

3
Contents
Preface ..................................................................................................................................................................................5
Safety Symbols Used in this Document..................................................................................................................................6
Where to Find Web-based Guides .........................................................................................................................................7
Contacting Allied Telesis ........................................................................................................................................................8
Online Support ................................................................................................................................................................8
Email and Telephone Support .........................................................................................................................................8
Returning Products..........................................................................................................................................................8
For Sales or Corporate Information.................................................................................................................................8
Warranty..........................................................................................................................................................................8
Management Software Updates ......................................................................................................................................8
Chapter 1: Enabling LINUX .................................................................................................................................................9
Introduction...........................................................................................................................................................................10
Limitations .....................................................................................................................................................................10
Packaging......................................................................................................................................................................10
Installing the LINUX TG3 File ...............................................................................................................................................11
Installing the Source RPM Package..............................................................................................................................11
Building the Driver from the Source TAR File................................................................................................................12
Driver Settings...............................................................................................................................................................13
Driver Default Settings ..................................................................................................................................................14
Unloading and Removing the Driver.....................................................................................................................................16
Driver Messages...................................................................................................................................................................17

Contents
4

5
Preface
This guide contains instructions on how to configure the following Allied
Telesis adapters using the Linux driver software:
AT-2711FX
AT-2712FX
AT-2812FX
AT-2912T
AT-2916SX
AT-2931SX
AT-2972SX
The Preface contains the following sections:
“Safety Symbols Used in this Document” on page 6
“Where to Find Web-based Guides” on page 7
“Contacting Allied Telesis” on page 8
“Management Software Updates” on page 8

Preface
6
Safety Symbols Used in this Document
This document uses the safety symbols defined in Table 1.
Table 1. Safety Symbols
Symbol Meaning Description
Caution Performing or omitting a specific action may
result in equipment damage or loss of data.
Warning Performing or omitting a specific action may
result in electrical shock.

Network Adapters Linux User’s Guide
7
Where to Find Web-based Guides
The installation and user guides for all Allied Telesis products are available
in portable document format (PDF) on our web site at
www.alliedtelesis.com. You can view the documents online or download
them onto a local workstation or server.

Preface
8
Contacting Allied Telesis
This section provides Allied Telesis contact information for technical
support as well as sales or corporate information.
Online Support You can request technical support online by accessing the Allied Telesis
Knowledge Base: www.alliedtelesis.com/support/kb.aspx. You can use
the Knowledge Base to submit questions to our technical support staff and
review answers to previously asked questions.
Email and
Telephone
Support
For Technical Support via email or telephone, refer to the Support section
of the Allied Telesis web site: www.alliedtelesis.com/support.
Returning
Products
Products for return or repair must first be assigned a return materials
authorization (RMA) number. A product sent to Allied Telesis without an
RMA number will be returned to the sender at the sender’s expense. For
instructions on how to obtain an RMA number, go to the Support section
on our web site at www.alliedtelesis.com/support/rma.aspx.
For Sales or
Corporate
Information
You can contact Allied Telesis for sales or corporate information through
our web site at http://www.alliedtelesis.com/purchase.
Warranty Go to www.alliedtelesis.com/warranty for the specific terms and
conditions of the warranty and for warranty registration for the Allied
Telesis adapters discussed in this manual.
Management
Software Updates
New releases of management software for our managed products are
available from either of the following Internet sites:
Allied Telesis web site:www.alliedtelesis.com
Allied Telesis FTP server:ftp://ftp.alliedtelesis.com
If you prefer to download new software from the Allied Telesis FTP server
from your workstation’s command prompt, you will need FTP client
software and you must log in to the server. Enter “anonymous” for the user
name and your email address for the password.

9
Chapter 1
Enabling LINUX
This chapter describes how to enable the LINUX System on the Allied
Telesis adapters. This chapter contains the following sections:
“Introduction” on page 10
“Installing the LINUX TG3 File” on page 11
“Unloading and Removing the Driver” on page 16
“Driver Messages” on page 17

Enabling LINUX
10
Introduction
This chapter describes the tg3 Linux driver for the Broadcom NetXtreme-
based Allied Telesis PCI/PCI-X/PCI Express Ethernet Network
Controllers.
The most recent driver is included in the latest 2.6 Linux kernel. Generally,
you do not need to download the driver if you are using the latest 2.6
upstream kernel from www.kernel.org or one of the latest vendor kernels
from Red Hat, SuSE, or other vendors. However, you can download the
Linux driver as a source package from www.broadcom.com and then
select Downloads & Support, Ethernet NICS, Download Drivers, and
NetXtreme I Desktop/Mobile.
The tg3 driver from the Broadcom package is almost identical to the tg3
driver in the latest 2.6 upstream Linux kernel. It does include some
additional kernel-compatible code to allow it to compile on older 2.6 and
some 2.4 kernels. The version number is similar but generally has a one-
letter suffix, for example 3.55b, to distinguish it from the in-kernel tg3
driver.
Limitations The current version of the driver has been tested on the 2.4x kernels
starting from 2.4.24 and all 2.6.x kernels.
Caution
The driver may not compile on kernels older than version 2.4.24.
Testing is concentrated on i386 and x86_64 CPU architectures. Only
limited testing has been done on some other architectures such as
PowerPC and SPARC64.
On some kernels, you may need to make minor changes to some source
files and the Makefile.
Packaging To replace an older previously installed or in-kernel tg3 driver, follow the
instructions in “Installing the LINUX TG3 File” on page 11.
The driver package from www.broadcom.com is released in two
packaging formats: source RPM and compressed tar formats. The file
names for the two packages are tg3<version>.src.rpm and
tgs<version>.tar.gz respectively. Identical source files to build the driver
are included in both packages.