Adding and Removing PCI Adapter Cards

Language:

If you are adding adapter cards, make sure that slots are available.
If you are removing adapter cards, ensure the following:
- The adapter card is hosting only nonvital system resources.
- Critical resources are accessible through an alternate pathway.
  
  For example, if a system has only one Ethernet card installed on it, you cannot remove the Ethernet card or the network connection will be lost. You would need additional layered software support to keep the network connection active.

How to Add a PCI or PCIe Adapter Card

List the hot-pluggable slot and open latches.
```
# cfgadm pci
```
Insert the adapter card into the slot.
Follow the appropriate instructions in your platform guide.
Determine the slot that the inserted adapter card occupies.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Connect the power to the slot.
- For either PCI or PCIe adapter cards: Issue the cfgadm command.
```
# cfgadm -c connect PCI-device
```
- For a PCIe adapter card: Use the autoconfiguration method defined by your platform guide. For many PCIe devices, this process involves pressing the slot's Attention button.
Confirm that the attachment point is connected.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
For PCI adapter cards, use the cfgadm command to configure the card.
For PCIe adapter cards, if you are using the autoconfiguration method, this step might not be necessary. Refer to your platform guide for more information.
```
# cfgadm -c configure pci-device
```
Verify the configuration of the adapter card in the slot.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Configure any supporting software if this device is a new device.
For example, if this device is an Ethernet card, use the ipadm command to set up the interface.
```
# ipadm create-addr IP-interface
```
Note - On some platforms, the autoconfiguration method for installing software can be enabled or disabled at boot. Set the autoconfiguration method as appropriate for your environment.

Example 15 Adding a PCIe Adapter Card

In this example, the pcie3 card is added to the system.

# cfgadm pci
Ap_Id   Type         Receptacle   Occupant     Condition
pcie1   unknown      empty        unconfigured unknown
pcie2   unknown      empty        unconfigured unknown
pcie3   unknown      disconnected unconfigured unknown
pcie4   unknown      empty        unconfigured unknown
pcie5   pci-pci/hp   connected    configured   ok
pcie6   unknown      disconnected unconfigured unknown

# cfgadm -c connect pcie3

# cfgadm pci
Ap_Id   Type         Receptacle   Occupant     Condition
pcie1   unknown      empty        unconfigured unknown
pcie2   unknown      empty        unconfigured unknown
pcie3   unknown      connected    unconfigured unknownDevice is added.
pcie4   unknown      empty        unconfigured unknown
pcie5   pci-pci/hp   connected    configured   ok
pcie6   unknown      disconnected unconfigured unknown

# cfgadm -c configure pcie3

# cfgadm pci
Ap_Id   Type         Receptacle   Occupant     Condition
pcie1   unknown      empty        unconfigured unknown
pcie2   unknown      empty        unconfigured unknown
pcie3   ethernet/hp  connected    configured   unknownDevice is configured.
pcie5   pci-pci/hp   connected    configured   ok
pcie6   unknown      disconnected unconfigured unknown

# ipadm create-addr -a 192.168.1.10 net1

How to Remove a PCI Adapter Card

Determine the slot that the adapter card is in.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Stop any application that has the device open.
For example, if the device is an Ethernet card with a configured IP interface, remove the IP interface.
```
# ipadm delete-ip IP-interface
```
Unconfigure the device manually.
- For either PCI or PCIe adapter cards: Issue the following command:
```
# cfgadm -c unconfigure PCI-device
```
- For a PCIe adapter card, use the autoconfiguration method for your platform.
  For example, for many platforms, you would press the slot's Attention button.
Confirm that the device has been unconfigured.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Disconnect the power to the slot manually.
For PCIe adapter cards, if you are using the autoconfiguration method, this step might not be necessary. Refer to your platform guide for more information.
```
# cfgadm -c disconnect PCI-device
```
Confirm that the device has been disconnected.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Remove the PCI adapter card by following the instructions in your platform guide.
Verify that the Receptacle state is empty.
- For PCI adapter cards:
```
# cfgadm
```
- For PCIe adapter cards:
```
# cfgadm pci
```
Note - On some platforms, the autoconfiguration method can be enabled or disabled at boot. Set the autoconfiguration method as appropriate for your environment.

Example 16 Removing a PCIe Adapter Card

In this example, the pcie4 card is removed.

# cfgadm pci
Ap_Id         Type         Receptacle   Occupant     Condition
pcie1         unknown      empty        unconfigured unknown
pcie2         unknown      empty        unconfigured unknown
pcie3         unknown      empty        unconfigured unknown
pcie4         etherne/hp   connected    configured   ok
pcie5         pci-pci/hp   connected    configured   ok
pcie6         unknown      disconnected unconfigured unknown

# ipadm delete-ip net1

# cfgadm -c unconfigure pcie4

# cfgadm pci
Ap_Id         Type         Receptacle   Occupant     Condition
pcie1         unknown      empty        unconfigured unknown
pcie2         unknown      empty        unconfigured unknown
pcie3         unknown      empty        unconfigured unknown
pcie4         unknown      connected    unconfigured unknown The device is unconfigured.
pcie5         pci-pci/hp   connected    configured   ok
pcie6         unknown      disconnected unconfigured unknown

# cfgadm -c disconnect pcie4

# cfgadm pci
Ap_Id         Type         Receptacle   Occupant     Condition
pcie1         unknown      empty        unconfigured unknown
pcie2         unknown      empty        unconfigured unknown
pcie3         unknown      empty        unconfigured unknown
pcie4         unknown      disconnected unconfigured unknown Power is disconnected.
pcie5         pci-pci/hp   connected    configured   ok
pcie6         unknown      disconnected unconfigured unknown

After the device is removed, verify that the receptacle is empty.

# cfgadm pci
Ap_Id         Type         Receptacle   Occupant     Condition
pcie1         unknown      empty        unconfigured unknown
pcie2         unknown      empty        unconfigured unknown
pcie3         unknown      empty        unconfigured unknown
pcie4         unknown      empty        unconfigured unknown The receptacle is empty.
pcie5         pci-pci/hp   connected    configured   ok
pcie6         unknown      disconnected unconfigured unknown