C H A P T E R 5 - Hot-Swap Software Commands

C H A P T E R 5

Hot-Swap Software Commands

This chapter provides information about hot-swap and the cfgadm utility. This chapter contains the following topics:

Section 5.1, Understanding Hot-Swap

Section 5.2, Using the cfgadm Utility

5.1 Understanding Hot-Swap

Certain FRUs in the Netra CT server are hot-swappable (see Section 1.3.1, Hot-Swappable FRUs). Hot-swap, a key feature of the PICMG standard, means that a CompactPCI board that meets the PICMG standard can be reliably inserted into or extracted from a powered and operating CompactPCI platform without affecting the other functions of the platform.

The Netra CT system hot-swap modes are listed in TABLE 5-1.

TABLE 5-1 Netra CT System Hot-Swap Modes
Type of Hot-Swap	Description
Basic	The hardware connection/disconnection process is performed automatically by the hardware, while the software connection process requires user assistance through the `cfgadm` `(1M`) command.
Full	Both the hardware and the software connection process are performed automatically.
High Availability	High-availability hot-swap provides the ability to control the hardware connection process. This provides a higher degree of control than just indicating insertion and extraction of a board. The hardware connection process is controlled by software on high-availability systems, such as the Netra CT server.

The Netra CT system is configured for full hot-swap by default. You can change the mode of the slot for the CPU boards and I/O boards to basic or full hot-swap using the cfgadm(1M) command. You might want to change the hot-swap state of a slot to basic, for example, if you need to insert or remove a third-party I/O board that does not have full hot-swap support.

Note that whenever you reboot or power your server on and off, hot-swap reverts back to the default full hot-swap state for all I/O slots.

5.1.1 How High-Availability Hot-Swap Works

By default, a Netra CT server is configured to accept any cPCI FRU unless you specifically set an allowable plug-in for a slot (refer to the Netra CT Server System Administration Guide for more information.)

When a board is inserted into a Netra CT server, the alarm card checks the midplane FRU ID information for allowable FRUs for that slot, then checks the inserted board's FRU ID to make sure the board is allowed in the particular slot. If the board is allowed in the slot, the alarm card powers up the board. If the board is not allowed in the slot, the alarm card sends an SNMP trap to the MOH application.

If a host or satellite board is in use (has applications currently running), the alarm card CLI power commands, such as poweron or poweroff, do not work for that board.

5.1.2 Hot-swap with Boards That Do Not Have Full Hot-swap

You might want to change the hot-swap state of a slot from full to basic if you need to insert or remove a third-party I/O board that does not have full hot-swap support.

To determine the current hot-swap state of a slot, use the prtconf(1M) command. To enable or disable the hot-swap on a slot, use the cfgadm (1M) command. For many cfgadm commands, you must know the attachment-point ID for the I/O slot that you are changing the state.

5.1.3 System Status Panel LED States and Meanings

The LEDs on the system status panel give you information to determine what state a board is in and if it is safe to remove the board from the system. See TABLE 5-1 for more information.

TABLE 5-2 CompactPCI Board LED States and Meanings on the System Status Panel
Green Power LED state	Amber Okay to Remove LED state	Meaning	Action
Off	Off	The slot is empty or the system thinks that the slot is empty because the system didn't detect the board when it was inserted.	If there is a board installed in this slot, then one of the following is faulty: the board installed in the slot the alarm card the system controller board Remove and replace the failed component to clear this state.
Blinking	Off	The board is coming up or going down.	Do not remove the board in this state.
On	Off	The board is up and running.	Do not remove the board in this state.
Off	On	The board is powered off.	You can remove the board in this state.
Blinking	On	The board is powered on, but it is offline for some reason (for example, a fault was detected on the board).	Wait several seconds to see if the green Power LED stops blinking. If it does not stop blinking after several seconds, enter `cfgadm` and verify that the board is in the `unconfigured` state, then perform the necessary action, depending on the board: Alarm card--You can remove the alarm card in this state. All other boards--Power off the slot through the alarm card software, then remove the board.
On	On	The board is powered on and is in use, but a fault has been detected on the board.	Deactivate the board using one of the following methods: Use the `cfgadm` `-f` `-c` `unconfigure` command to deactivate the board. In some cases, this might cause the system to panic, depending on the nature of the board hardware or software. Halt the system and power off the slot through the alarm card software, then remove the board. The green Power LED gives status information: If the green Power LED goes off, remove the board. If the green Power LED remains on, halt the system and power off the slot through the alarm card software.

5.2 Using the `cfgadm` Utility

You can perform the following hot-swap procedures using the cfgadm utility:

Deactivate and activate hot-swappable FRUs

Enable and disable full hot-swap for I/O slots in a server

Enable and disable basic hot-swap for I/O slots in a server

5.2.1 Logging In to the Netra CT Server

To use the cfgadm utility, you must be able to log in to the server either remotely, where you would log in to the Netra CT server as superuser through another server on the network, or directly, where you would connect a terminal console directly to your Netra CT server.

For more information on connecting a terminal console to your system, see Appendix B.

5.2.2 Running the `cfgadm` Utility

For all cfgadm commands, you must know the attachment-point ID for the I/O slot that you are changing state. To list the attachment-point IDs for the slots in a server, log in to the server and, as superuser, enter the following command:

# cfgadm

For a Netra CT 810 server, output similar to the following is displayed:

Ap_Id				Type				Receptacle					Occupant					Condition

AL-8				mcd/fhs				connected					configured					ok

CPU				bridge/fhs				connected					configured					ok

IO-2				stpcipci/fhs				connected					configured					ok

IO-3				unknown				empty					unconfigured					unknown

IO-4				stpcipci/fhs				connected					configured					ok

IO-5				unknown				disconnected					unconfigured					ok

IO-6				unknown				empty					unconfigured					unknown

IO-7				unknown				empty					unconfigured					unknown

For a Netra CT 410 server, output similar to the following is displayed:

Ap_Id				Type				Receptacle					Occupant					Condition

AL-1				mcd/fhs				connected					configured					ok

CPU				bridge/fhs				connected					configured					ok

IO-2				unknown				disconnected					unconfigured					unknown

IO-4				stpcipci/fhs				connected					configured					ok

IO-5				stpcipci/fhs				connected					configured					ok

The attachment-point ID is shown in the first column of the readout; for example, the attachment-point ID for I/O slot 2 in a Netra CT 810 server is IO-2.

To view the online help for cfgadm, as superuser, enter:

# cfgadm -h pci

Output similar to the following is displayed:

PCI hotplug specific commands:

   -c [connect|disconnect|configure|unconfigure|insert|remove] ap_id [ap_id...]

   -x enable_slot ap_id [ap_id...]

   -x disable_slot ap_id [ap_id...]

   -x enable_autoconfig ap_id [ap_id...]

   -x disable_autoconfig ap_id [ap_id...]

   -x led[=[fault|power|active|attn],mode=[on|off|blink]] ap_id [ap_id...]

To view the man page for the cfgadm utility, enter man cfgadm at the prompt.

5.2.3 Basic and Full Hot-Swap `cfgadm` Commands

The Netra CT servers are set to full hot-swap by default. Full hot-swap on an I/O slot means that you do not need to manually deactivate or activate the I/O board when replacing it in the server; those processes are handled automatically.

To determine the current hot-swap state for all of the I/O slots in your Netra CT server, go to Determining the Current Hot-Swap State.

To change default settings for one or more I/O slots in your Netra CT server to basic hot-swap, go to Enabling Basic Hot-Swap on I/O Slots.

To change settings for one or more I/O slots in your Netra CT server back to full hot-swap, go to Enabling Full Hot-Swap on I/O Slots.

5.2.3.1 Determining the Current Hot-Swap State

To determine the current hot-swap state for the I/O slots, as superuser, enter:

# prtconf -v -P

For a Netra CT 810 server, output similar to the following is displayed:

cphsc, instance #0

            System properties:

                name='instance' type=int items=1

                    value=00000000

                name='default-hotswap-mode' type=string items=1

                    value='full'

            Driver properties:

                name='AL-8-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-7-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-6-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-5-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-4-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-3-autoconfig' type=string items=1 dev=none

                    value='enabled'

                name='IO-2-autoconfig' type=string items=1 dev=none

                    value='enabled'

               name='CPU-autoconfig' type=string items=1 dev=none

                    value='enabled'

               name='hotswap-mode' type=string items=1 dev=none

                    value='full'

If you see value 'basic' underneath the default-hotswap-mode line, then all of the I/O slots in the Netra CT server are set to basic hot-swap. The entry value 'disabled' is shown for every I/O slot in the system in this state.

If you see value 'full' underneath the default-hotswap-mode line, then at least one of the I/O slots in the Netra CT server is set to full hot-swap. You must look at the entries for individual I/O slots to determine if they are set to basic or full hot-swap mode:

If you see value 'enabled' underneath a <slot#-autoconfig> line, then that slot is set to full hot-swap.

If you see value 'disabled' underneath a <slot#-autoconfig> line, then that slot is set to basic hot-swap.

5.2.3.2 Enabling Basic Hot-Swap on I/O Slots

All of the I/O slots in the Netra CT server are set to full hot-swap by default. You can disable full hot-swap on one or more I/O slots, bringing those slots to a basic hot-swap state. That means that if an I/O board becomes faulty and needs replacing, you must manually deactivate the I/O slot using the cfgadm utility before you can remove the board, then you must manually reactivate the I/O slot after replacing the board.

To disable full hot-swap on one or more I/O slots, changing those slots to a basic hot-swap state, as superuser, by enter:

# cfgadm -x disable_autoconfig ap_id

Note - Whenever you reboot or power your server on and off, the hot-swap states revert back to the default full hot-swap state for all I/O slots. If you want one or more I/O slots set to the basic hot-swap setting, you must manually reset the I/O slots after rebooting or powering your server on and off.

Deactivating a Hot-Swappable FRU

To deactivate an I/O board in a basic hot-swap state, as superuser, enter:

# cfgadm -c unconfigure ap_id

where ap_id is the attachment-point ID. For example, to deactivate an I/O board in slot 4, as superuser, enter:

# cfgadm -c unconfigure IO-4

Reactivating a Hot-Swappable FRU

To connect an I/O board, as superuser, enter:

# cfgadm -c connect ap_id

where ap_id is the attachment-point ID.

To activate an I/O board, as superuser, enter:

# cfgadm -c configure ap_id

where ap_id is the attachment-point ID.

5.2.3.3 Enabling Full Hot-Swap on I/O Slots

If you changed the hot-swap states for one or more I/O slots from the default full hot-swap setting to the basic hot-swap setting, use the cfgadm utility to change the I/O slots back to the default full hot-swap setting.

To enable full hot-swap for an I/O slot in a Netra CT server, as superuser, enter:

# cfgadm -x enable_autoconfig ap_id

where ap_id is the attachment-point ID of the slot that you want to have full hot-swap enabled on. For example, to enable full hot-swap for I/O slot 4, as superuser, you could enter the following:

# cfgadm -x enable_autoconfig IO-4

To enable full hot-swap on all slots at once, reboot the server, which automatically reverts settings back to the default full hot-swap for all I/O slots.