[ Bottom of Page | Previous Page | Next Page | 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:
- 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:
- Type lsslot -c pci to
list all the hot-plug slots in the system unit and display their characteristics.
- 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 |
- Close all applications that are using the adapter you are unconfiguring.
To continue with this procedure, network dump locations must be disabled on
the system. To look for and disable network dump locations, do the following:
- Type the following from a command line:
smit dump
- Select Show Current Dump Devices.
- Check whether any configured dump device shows a network location. If
not, exit SMIT and you are ready for step 4.
To change a dump device to a local location, select Cancel or press F3 and continue with the following step.
- If the primary dump device shows a network location, change to a local
location by selecting Change the Primary Dump Device and
then enter the local location in the Primary dump device field.
- If the secondary dump device shows a network location, change to a local
location by selectingChange the Secondary Dump Device and
then enter the local location in the Secondary dump device field.
- When finished, click OK or press Enter.
-
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.
- 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.
- 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 |
| rmdev -p pci1 |
To unconfigure the children of a PCI bus and all other
devices under them while retaining their device definitions in the Customized
Devices object class. |
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:
- Type lsslot -c pci to
list all the hot-plug slots in the system unit and display their characteristics.
- 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 |
- 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
- Close all applications that are using the adapter you are unconfiguring.
To continue with this procedure, network dump locations must be disabled on
the system. To look for and disable network dump locations, do the following:
- Type the following from a command line:
smit dump
- Select Show Current Dump Devices.
- Check whether any configured dump device shows a network location. If
not, exit SMIT and you are ready for step 4.
To change a dump device to a local location, select Cancel or press F3 and continue with the following step.
- If the primary dump device shows a network location, change to a local
location by selecting Change the Primary Dump Device and
then enter the local location in the Primary dump device field.
- If the secondary dump device shows a network location, change to a local
location by selectingChange the Secondary Dump Device and
then enter the local location in the Secondary dump device field.
- When finished, click OK or press Enter.
- 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.
- 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.
- Type lsslot -c pci to
list all the hot-plug slots in the system unit and display their characteristics.
- 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)
- Close all applications that are using the adapter you are unconfiguring.
To continue with this procedure, network dump locations must be disabled on
the system. To look for and disable network dump locations, do the following:
- Type the following from a command line:
smit dump
- Select Show Current Dump Devices.
- Check whether any configured dump device shows a network location. If
not, exit SMIT and you are ready for step 4.
To change a dump device to a local location, select Cancel or press F3 and continue with the following step.
- If the primary dump device shows a network location, change to a local
location by selecting Change the Primary Dump Device and
then enter the local location in the Primary dump device field.
- If the secondary dump device shows a network location, change to a local
location by selectingChange the Secondary Dump Device and
then enter the local location in the Secondary dump device field.
- When finished, click OK or press Enter.
- 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.
- 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.
- 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:
- Type lsslot -c pci to
list all the hot-plug slots in the system unit and display their characteristics.
- 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)
- 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.
- 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.
- 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:
.
.
- Close all applications that are using the adapter you are unconfiguring.
To continue with this procedure, network dump locations must be disabled on
the system. To look for and disable network dump locations, do the following:
- Type the following from a command line:
smit dump
- Select Show Current Dump Devices.
- Check whether any configured dump device shows a network location. If
not, exit SMIT and you are ready for step 4.
To change a dump device to a local location, select Cancel or press F3 and continue with the following step.
- If the primary dump device shows a network location, change to a local
location by selecting Change the Primary Dump Device and
then enter the local location in the Primary dump device field.
- If the secondary dump device shows a network location, change to a local
location by selectingChange the Secondary Dump Device and
then enter the local location in the Secondary dump device field.
- When finished, click OK or press Enter.
- 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
- To unconfigure the SCSI adapter scsi1 and all of its children
while retaining their device definitions in the Customized Devices object
class, type:
rmdev -R scsi1
The system displays a message similar
to the following:
rmt0 Defined
hdisk1 Defined
scsi1 Defined
- To unconfigure just the children of the SCSI adapter scsi1,
but not the adapter itself, while retaining their device definitions in the
Customized Devices object class, type:
rmdev -p scsi1
The system
displays a message similar to the following:
rmt0 Defined
hdisk1 Defined
- To unconfigure the children of PCI bus pci1 and all other devices
under them while retaining their device definitions in the Customized Devices
object class, type:
rmdev -p pci1
The system displays a message
similar to the following:
rmt0 Defined
hdisk1 Defined
scsi1 Defined
ent0 Defined
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.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]