[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

System Management Guide: Operating System and Devices

Unconfiguring Communications Adapters

Before you can remove or replace a hot-plug adapter, you must unconfigure that adapter. This section provides the following procedures for unconfiguring communications adapters:

Unconfiguring a communications adapter involves the following tasks:

To perform these tasks, you must log in as root.

For additional information about unconfiguring communications adapters, see PCI Hot-Plug Management in the AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

Unconfiguring Ethernet, Token-ring, FDDI, and ATM Adapters

To unconfigure an Ethernet, Token-ring, FDDI, or ATM Adapter:

  1. Type lsslot -c pci to list all the hot-plug slots in the system unit and display their characteristics.
  2. Type the appropriate SMIT command, shown in the following examples, to list installed adapters and show the current state (see Chapter 18, Devices) of all the devices in the system unit:
    smit lsdenet To list Ethernet adapters
    smit lsdtok To list token-ring adapters
    smit ls_atm To list ATM adapters

    The following naming convention is used for the different type of adapters:

    Name Adapter Type
    atm0, atm1, ... ATM adapter
    ent0, ent1, ... Ethernet adapter
    tok0, tok1, ... Token Ring adapter
  3. Close all applications that are using the adapter you are unconfiguring.
  4. Type netstat -i to display a list of all configured interfaces and determine whether your adapter is configured for TCP/IP. Output similar to the following displays: 

    Name  Mtu    Network   Address        Ipkts  Ierrs  Opkts Oerrs Coll
lo0   16896  link#1                     076      0    118     0    0
lo0   16896  127       127.0.0.1        076      0    118     0    0
lo0   16896  ::1                        076      0    118     0    0
tr0    1492  link#2    8.0.5a.b8.b.ec   151      0    405    11    0
tr0    1492  19.13.97  19.13.97.106     151      0    405    11    0
at0    9180  link#3    0.4.ac.ad.e0.ad    0      0      0     0    0
at0    9180  6.6.6     6.6.6.5            0      0      0     0    0
en0    1500  link#5    0.11.0.66.11.1   212      0      1     0    0
en0    1500  8.8.8     8.8.8.106        212      0      1     0    0

    Token-ring adapters can have only one interface. Ethernet adapters can have two interfaces. ATM adapters can have multiple interfaces. For additional information, see Unconfiguring Communications Adapters in the AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

  5. Type the appropriate ifconfig command, shown in the following examples, to remove the interface from the network interface list.
    ifconfig en0 detach
    ifconfig et0 detach     		To remove the standard Ethernet interface
    To remove the IEEE 802.3 Ethernet interface
    ifconfig tr0 detach To remove a token-ring interface
    ifconfig at0 detach To remove an ATM interface

    For an explanation of the association between these adapters and their interfaces, see Unconfiguring Communications adapters in the AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

  6. Type the appropriate rmdev command, shown in the following examples, to unconfigure the adapter and keep its device definition in the Customized Devices Object Class:
    rmdev -l ent0 To unconfigure an Ethernet adapter
    rmdev -l tok1 To unconfigure a token-ring adapter
    rmdev -l atm1 To unconfigure an ATM adapter

    Note: To unconfigure the adapter and remove the device definition in the Customized Devices object class, you can use the rmdev command with the -d flag. Do not use the -d flag with the rmdev command for a hot-plug operation unless your intent is to remove the adapter and not replace it.

Unconfiguring WAN Adapters

To unconfigure a WAN Adapter:

  1. Type lsslot -c pci to list all the hot-plug slots in the system unit and display their characteristics.
  2. Type the appropriate SMIT command, shown in the following examples, to list installed adapters and show the current state of all the devices in the system unit:
    smit 331121b9_ls To list 2-Port Multiprotocol WAN adapters
    smit riciophx_ls To list ARTIC WAN adapters

    The following naming convention is used for the different type of adapters:

    Name Adapter Type
    dpmpa 2-Port Multiprotocol Adapter
    riciop ARTIC960 Adapter
  3. Type lsdev -C -c port to list X.25 ports on your host. A message similar to the following displays: 

    sx25a0  Available 00-05-01-00     X.25 Port
x25s0   Available 00-05-01-00-00  V.3 X.25 Emulator
  4. Close all applications that are using the adapter you are unconfiguring.
  5. Remove an X.25 driver and port, following the steps in Configuration Commands in AIXLink/X.25 1.1 for AIX: Guide and Reference.
  6. Use the commands in the following table to unconfigure and remove the device drivers and emulator ports for these adapters:
    2-Port Multiprotocol adapter
    smit rmhdlcdpmpdd To unconfigure the device
    smit rmsdlcscied To unconfigure the SDLC COMIO emulator

    For additional information, see 2-Port Multiprotocol Adapter HDLC Network Device Driver Overview in the AIX 5L Version 5.1 System Management Guide: Communications and Networks.

    ARTIC960Hx PCI adapter
    smit rmtsdd To unconfigure the device driver
    smit rmtsdports To remove an MPQP COMIO emulation port

    For additional information, see ARTIC960HX PCI Adapter Overview in the AIX 5L Version 5.1 System Management Guide: Communications and Networks.

Unconfiguring Other Adapters

This section includes procedures for unconfiguring adapters that require special handling.

IBM 4-Port 10/100 Base-TX Ethernet PCI Adapters

The 4-Port 10/100 Base-TX Ethernet PCI adapter has four ethernet ports and each port must be unconfigured before you can remove the adapter.

  1. Type lsslot -c pci to list all the hot-plug slots in the system unit and display their characteristics.
  2. Type smit lsdenet to list all the devices in the PCI subclass. A message similiar to the following displays: 

    ent1  Available 1N-00 IBM 4-Port 10/100 Base-TX Ethernet PCI Adapter (23100020) (Port 1)
ent2  Available 1N-08 IBM 4-Port 10/100 Base-TX Ethernet PCI Adapter (23100020) (Port 2)
ent3  Available 1N-10 IBM 4-Port 10/100 Base-TX Ethernet PCI Adapter (23100020) (Port 3)
ent4  Available 1N-18 IBM 4-Port 10/100 Base-TX Ethernet PCI Adapter (23100020) (Port 4)
  3. Close all applications that are using the adapter you are unconfiguring.
  4. Type netstat -i to display a list of all configured interfaces and determine whether your adapter is configured for TCP/IP. Output similar to the following displays: 

    Name  Mtu    Network   Address        Ipkts  Ierrs  Opkts Oerrs Coll
lo0   16896  link#1                     076      0    118     0    0
lo0   16896  127       127.0.0.1        076      0    118     0    0
lo0   16896  ::1                        076      0    118     0    0
tr0    1492  link#2    8.0.5a.b8.b.ec   151      0    405    11    0
tr0    1492  19.13.97  19.13.97.106     151      0    405    11    0
at0    9180  link#3    0.4.ac.ad.e0.ad    0      0      0     0    0
at0    9180  6.6.6     6.6.6.5            0      0      0     0    0
en0    1500  link#5    0.11.0.66.11.1   212      0      1     0    0
en0    1500  8.8.8     8.8.8.106        212      0      1     0    0

    Ethernet adapters can have two interfaces, for example, et0 and en0. For additional information, see Unconfiguring Communications Adapters in the AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

  5. Use the ifconfig command to remove each interface from the network interface list. For example, type iconfig en0 detach to remove the standard Ethernet interface, and type iconfig et0 to remove the IEEE 802.3 interface. For an explanation of the association between these adapters and their interfaces, see Unconfiguring Communications Adapters in the AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.
  6. Use the rmdev command to unconfigure the adapter amd retain its device definition in the Customized Devices Object Class. For example, rmdev -l ent0.

    Note: To unconfigure the adapter and remove the device definition in the Customized Devices object class, you can use the rmdev command with the -d flag. Do not use the -d flag with the rmdev command for a hot-plug operation unless your intent is to remove the adapter and not replace it.

ATM Adapters

Classic IP and LAN emulation protocols can run over ATM adapters. LAN emulation protocol enables the implementation of emulated LANs over an ATM network. Emulated LANs can be Ethernet/IEEE 802.3, Token-ring/IEEE 802.5, and MPOA (MultiProtocol Over ATM). You must unconfigure each LAN-emulated device before you can remove the adapter.

For instructions for removing a classical interface, see Unconfiguring Ethernet, Token-ring, FDDI, and ATM Adapters. To remove a LAN interface, do the following:

  1. Type lsslot -c pci to list all the hot-plug slots in the system unit and display their characteristics.
  2. Type smit ls_atm to list all the ATM adapters. A message similiar to the following displays: 

    .
.
atm0 Available 04-04 IBM PCI 155 Mbps ATM Adapter (14107c00)
atm1 Available 04-06 IBM PCI 155 Mbps ATM Adapter (14104e00)
  3. Type smit listall_atmle to list all the LAN-emulated clients on the adapters. A message similiar to the following displays: 

    ent1 Available  ATM LAN Emulation Client (Ethernet)
ent2 Available  ATM LAN Emulation Client (Ethernet)
ent3 Available  ATM LAN Emulation Client (Ethernet)
tok1 Available  ATM LAN Emulation Client (Token Ring)
tok2 Available  ATM LAN Emulation Client (Token Ring)

    All ATM adapters can have multiple emulated clients running on them.

  4. Type smit listall_mpoa to list all the LAN-emulated clients on the adapters. A message similar to the following displays: 

    mpc0 Available     ATM LAN Emulation MPOA Client

    atm0 and atm1 are the physical ATM adapters. mpc0 is an MPOA-emulated client. ent1, ent2, ent3, tok1, and tok2 are LAN-emulated clients.

  5. Type entstat to determine on which adapter the client is running. A message similiar to the following displays: 

    -------------------------------------------------------------
ETHERNET STATISTICS (ent1) :
Device Type: ATM LAN EmulationATM Hardware Address: 00:04:ac:ad:e0:ad
.
.
.
ATM LAN Emulation Specific Statistics:
--------------------------------------
Emulated LAN Name: ETHelan3
Local ATM Device Name: atm0
Local LAN MAC Address:
.
.
  6. Close all applications that are using the adapter you are unconfiguring.
  7. Use the rmdev -l device command to unconfigure the interfaces in the following order:

Resolving Adapter-Removal Problems

If the following type of message displays when the rmdev command is to unconfigure an adapter, this indicates that the device is open, possibly because applications are still trying to access the adapter you are trying to remove or replace. 

#rmdev -l ent0
Method error (/usr/lib/methods/ucfgent):
        0514-062
	Cannot perform the requested function because the
	specified device is busy.

To resolve the problem, you must identify any applications that are still using the adapter and close them. These applications can include the following:

Systems Network Architecture (SNA) Applications

Some SNA applications that may be using your adapter include:

Streams Applications

Some of the streams-based applications that may be using your adapter include:

Applications Running on WAN Adapters

Applications that may be using your WAN adapter include:

TCP/IP Applications

All TCP/IP applications using the interface layer can be detached with the ifconfig command. This causes the applications using TCP/IP to time out and warn users that the interface is down. After you add or replace the adapter and run the ifconfig command to attach the interface, the applications resume.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]