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 Ethernet, Token-ring, FDDI, and ATM Adapters
• Unconfiguring WAN Adapters
• Unconfiguring Other Adapters

Unconfiguring a communications adapter involves the following tasks:

• Closing all applications that are using the adapter you are removing or replacing
• Ensuring that all devices connected to the adapter are identified and stopped
• Listing all slots that are currently in use or a slot that is occupied by a specific adapter
• Identifying the adapter's slot location
• Displaying and removing interface information from the network interface list
• Making the adapter unavailable

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.2 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 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.2 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.2 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 Version 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.2 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.2 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.2 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.2 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:
   • Emulated interface = en1, et1, en2, et2, tr1, tr2 ...
   • Emulated interface = ent1, ent2, tok1, tok2 ...
   • Multiprotocol Over ATM (MPOA) = mpc0
   • ATM adapter = atm0

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:

• TCP/IP
• SNA
• OSI
• IPX/SPX
• Novell NetWare
• Streams
• The generic data link control (GDLC)
  • IEEE Ethernet DLC
  • Token-ring DLC
  • FDDI DLC

Systems Network Architecture (SNA) Applications

Some SNA applications that may be using your adapter include:

• DB2
• TXSeries (CICS & Encina)
• DirectTalk
• MQSeries
• HCON
• ADSM

Streams Applications

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

• IPX/SPX
• Novell NetWare V4 and Novell NetWare Services 4.1
• Connections and NetBios for this operating system

Applications Running on WAN Adapters

Applications that may be using your WAN adapter include:

• SDLC
• Bisync
• X.25
• ISDN
• QLLC for X.25

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.