How to identify PCI slot resources on Mx000 systems

Asset ID:	1-71-1676502.1
Update Date:	2018-03-05
Keywords:

Solution Type Technical Instruction Sure

Solution 1676502.1 : How to identify PCI slot resources on Mx000 systems

Applies to:

Sun SPARC Enterprise M3000 Server - Version Not Applicable to Not Applicable [Release N/A]
Sun SPARC Enterprise M8000 Server - Version Not Applicable to Not Applicable [Release N/A]
Sun SPARC Enterprise M4000 Server - Version Not Applicable to Not Applicable [Release N/A]
Sun SPARC Enterprise M5000 Server - Version Not Applicable to Not Applicable [Release N/A]
Sun SPARC Enterprise M9000-32 Server - Version Not Applicable to Not Applicable [Release N/A]
Oracle Solaris on SPARC (64-bit)

Goal

This document will help to identify PCI slot resources in Mx000 domains, on both Solaris instance and XSCF unit.

Solution

Resource identification in Solaris can be done by the use of the commands cfgadm and prtdiag.

The prtdiag command displays system configuration and diagnostic information on sun4u / sun4v systems.
The cfgadm command provides configuration administration operations on dynamically reconfigurable hardware resources. These operations include displaying status

For example, with the cfgadm command you can identify the IOU resources that Solaris instance has available:

solaris> cfgadm -s "select=class(pci),cols=ap_id:r_state:o_state"

The hotplug service must be enabled for libhotplug client applications, like cfgadm, to function properly.
Otherwise you can't identify the IOU resources due to missing the dynamic attachment points and/or getting an error:

Non working example:

bash-3.2# cfgadm -s "select=class(pci),cols=ap_id:r_state:o_state"
Ap_Id                          Receptacle   Occupant
cfgadm: Configuration administration not supported: Error: hotplug service is probably not running, please use 'svcadm enable hotplug' to enable the service. See cfgadm_shp(1M) for more details.

bash-3.2# svcs hotplug
STATE          STIME    FMRI
disabled        7:20:41 svc:/system/hotplug:default

bash-3.2# svcadm enable hotplug

bash-3.2# svcs hotplug
STATE          STIME    FMRI
online          7:21:35 svc:/system/hotplug:default

More information regarding Solaris hotplug Framework can be obtained from :
Sun SPARC[TM] Enterprise M3000, M4000, M5000, M8000, M9000: Solaris Hotplug Framework - S10U9 or 142909-17 (Doc ID 1456060.1)

example for M4000 or M5000 with IOU#0:

bash-3.2# cfgadm -s "select=class(pci),cols=ap_id:r_state:o_state"
Ap_Id                          Receptacle   Occupant
iou#0-pci#0                    empty        unconfigured
iou#0-pci#1                    empty        unconfigured
iou#0-pci#2                    empty        unconfigured
iou#0-pci#3                    disconnected unconfigured
iou#0-pci#4                    empty        unconfigured

example for M8000 or M9000 domain with IOU#0:

bash-3.2# cfgadm -s "select=class(pci),cols=ap_id:r_state:o_state"
Ap_Id                          Receptacle   Occupant
iou#0-pci#0                    connected    configured
iou#0-pci#1                    empty        unconfigured
iou#0-pci#2                    empty        unconfigured
iou#0-pci#3                    empty        unconfigured
iou#0-pci#4                    connected    configured
iou#0-pci#5                    empty        unconfigured
iou#0-pci#6                    empty        unconfigured
iou#0-pci#7                    empty        unconfigured

You can see then the attachment points of IO units and PCI slots in use.

The slots are named iou#-pci# with x = number of the IO unit and y = number of PCI slot ( for M4000/M5000 there is a range 0-4 and for M8000/M9000 there is a range 0-7 )

Not populated, respective free PCI slots can be identified by the "empty" receptacle.

Vice versa, the populated slots are those which showing non "empty" receptacle, but connected or disconnected.

Card types of populated slots can be identified from prtdiag output together with the following document:
Sun SPARC(R) Enterprise M3000/M4000/M5000/M8000/M9000 (OPL) Servers: PCI Card Identification List (Doc ID 1399469.1)

Resource identification with your XSCF ( eXtended System Control Facility ) Unit can be done by determining which IOU(s) is associated to the domain (using "showboards" command), and then verifying the availability of PCI slot in "showhardconf" for this IOU.

You need to know which IOU is configured for your domain.

Example M4000,M5000, M8000 or M9000 with domain 0:

XSCF> showboards -d 0
XSB DID(LSB) Assignment Pwr Conn Conf Test Fault
---- -------- ----------- ---- ---- ---- ------- --------
00-0 00(00) Assigned y y y Passed Normal

You see, there is XSB 00-0 ( in Uni Mode ) configured for this domain, what means IOU#0 is used by the mentioned domain.

Now can refer to showhardconf output, looking for the determined IOU to find out the PCI slot utilization for the same:

XSCF> showhardconf -M
[ snip ]
IOU#0 Status:Normal; Ver:4201h; Serial:xxxxxxxxx ;
        + FRU-Part-Number:CA06620-D103 F3   /7022563              ;
        + Type:B;
        PCI#0 Name_Property:pci; Card_Type:IOUA;
            + Serial:xxxxxxxxx ; Type:1;
            + FRU-Part-Number:CA21129-B79X 003AC/371-2245-03          ;
        PCI#4 Name_Property:pci; Card_Type:IOUA;
            + Serial:xxxxxxxxxx ; Type:1;
            + FRU-Part-Number:CA21129-B79X 003AC/371-2245-03          ;
[ snip ]

References

<NOTE:1399469.1> - Sun SPARC(R) Enterprise M3000/M4000/M5000/M8000/M9000 (OPL) Servers: PCI Card Identification List
<NOTE:1456060.1> - Sun SPARC[TM] Enterprise M3000, M4000, M5000, M8000, M9000: Solaris Hotplug Framework - S10U9 or 142909-17

Attachments

This solution has no attachment