IBM Power System POWER7 Series, Common Service Procedures, Page: 137 / 198

Install the Linux Service Aids. These service aids enable system serviceability, as well to improve system
management.
If you are using a Linux distribution with Linux kernel version 2.6 or greater, you can install the Service
Aids that gives you access to more capabilities, which can help you diagnose problems on your system.
This software is available at the Service and productivity tools for Linux website. (http://
www14.software.ibm.com/webapp/set2/sas/f/lopdiags)
Verifying that the hot-plug PCI tools are installed on the Linux partition
When you install, remove, or replace a PCI adapter in a Linux partition that is powered on, you might
need to use the hot-plug PCI tools. Use this procedure to verify that you have the hot-plug PCI tools
installed.
1.
Enter the following command to verify that the hot-plug PCI tools are installed:
rpm -aq | grep rpa-pci-hotplug
If the command does not list any rpa-pci-hotplug packages, the PCI Hot Plug tools are not installed.
2. Enter the following command to ensure that the rpaphp driver is loaded:
ls -l /sys/bus/pci/slots/
The directory should contain data. If the directory is empty, the driver is not loaded or the system
does not contain hot-plug PCI slots. The following is an example of the information displayed by this
command:
drwxr-xr-x 15 root root 0 Feb 16 23:31 .
drwxr-xr-x
5 root root 0 Feb 16 23:31 ..
drwxr-xr-x 2 root root 0 Feb 16 23:31 0000:00:02.0
drwxr-xr-x 2 root root 0 Feb 16 23:31 0000:00:02.2
drwxr-xr-x 2 root root 0 Feb 16 23:31 0000:00:02.4
drwxr-xr-x 2 root root 0 Feb 16 23:31 0001:00:02.0
drwxr-xr-x 2 root root 0 Feb 16 23:31 0001:00:02.2
drwxr-xr-x 2 root root 0 Feb 16 23:31 0001:00:02.4
drwxr-xr-x 2 root root 0 Feb 16 23:31 0001:00:02.6
drwxr-xr-x 2 root root 0 Feb 16 23:31 0002:00:02.0
drwxr-xr-x 2 root root 0 Feb 16 23:31 0002:00:02.2
drwxr-xr-x 2 root root 0 Feb 16 23:31 0002:00:02.4
drwxr-xr-x 2 root root 0 Feb 16 23:31 0002:00:02.6
If the directory does not exist, run the following command to mount the filesystem:
mount -t sysfs sysfs /sys
3.
Ensure the following tools are available in the /usr/sbin directory.
v
lsslot
v
drmgr -c pci
4. Return to the procedure that sent you here.
Removing and replacing a PCI adapter contained in a cassette in an
IBM i partition that is powered on
Procedures performed on a PCI adapter in an IBM i partition that is powered on, also known as hot-plug
procedures, require the system administrator to take the PCI adapter offline prior to performing the
operation. Before taking an adapter offline, the devices attached to the adapter must be taken offline as
well. This action prevents a service representative or user from causing an unexpected outage for system
users.
To remove and replace an adapter, do the following steps:
1. Determine the location of the PCI adapter in the system.
2. Record the slot number and location of each adapter being removed. Adapter slots are numbered
either below or along the side of each adapter slot.
Common service procedures
123