Solaris 7 11/99 Release Notes Supplement for Sun Hardware

Software Notes

Enabling Dynamic Reconfiguration

In the /etc/system file, two variables must be set to enable dynamic reconfiguration and an additional variable must be set to enable the removal of CPU/memory boards.

To enable dynamic reconfiguration, edit the /etc/system file and add the following lines to the /etc/system file:
```
set pln:pln_enable_detach_suspend=1
set soc:soc_enable_detach_suspend=1
```

To enable the removal of a CPU/memory board, add this line to the /etc/system file:
```
set kernel_cage_enable=1
```
Setting this variable enables the memory unconfiguration operation.

Reboot the system to put the changes into effect.

Quiesce Test

On a large system, the quiesce-test command (cfgadm -x quiesce-test sysctrl0:slotnumber) may run as long as a minute or so. During this time no messages are displayed if cfgadm does not find incompatible drivers. This is normal behavior.

Disabled Board List

If a board is on the disabled board list, an attempt to connect the board may produce an error message:

# cfgadm -c connect sysctrl0:slotnumber
cfgadm: Hardware specific failure: connect failed: board is disabled: must override with [-f][-o enable-at-boot]

To override the disabled condition, use the force flag (-f) or the enable option (-o enable-at-boot) with the cfgadm command:
```
# cfgadm -f -c connect sysctrl0:slotnumber
```
```
# cfgadm -o enable-at-boot -c connect sysctrl0:slotnumber
```

To remove all boards from the disabled board list, set the disabled-board-list variable to a null set with the system command:
```
# eeprom disabled-board-list=
```

If you are at the OpenBoot^TM prompt, use this OBP command instead to remove all boards from the disabled board list:
```
OK set-default disabled-board-list 
```
For further information about the disabled-board-list setting, refer to the section "Specific NVRAM Variables" in the Platform Notes: Sun Enterprise 3x00, 4x00, 5x00, and 6x00 Systems, part number 805-4454.

Disabled Memory List

For information about the OBP disabled-memory-list setting, refer to the section "Specific NVRAM Variables" in the Platform Notes: Sun Enterprise 3x00, 4x00, 5x00, and 6x00 Systems.

Unloading Detach-Unsafe Drivers

If it is necessary to unload detach-unsafe drivers, use the modinfo(1M) line command to find the module IDs of the drivers. You can then use the module IDs in the modunload(1M) command to unload detach-unsafe drivers.

Interleaved Memory

A memory board or CPU/memory board that contains interleaved memory cannot be dynamically unconfigured.

To determine if memory is interleaved, use the prtdiag command or the cfgadm command.

To permit DR operations on CPU/memory boards, set the NVRAM memory-interleave property to min.

Self-Test Failure During a Connect Sequence

If the error "cfgadm: Hardware specific failure: connect failed: firmware operation error" is displayed during a DR connect sequence, remove the board from the system as soon as possible. The board has failed self-test, and removing the board avoids possible reconfiguration errors that can occur during the next reboot.

If you want to immediately retry the failed operation, you must first remove and reinsert the board, because the board status does not allow further operations.

Dynamic Reconfiguration Feature in Sun Enterprise SyMON Software

As noted in the Dynamic Reconfiguration User's Guide for Sun Enterprise 3x00/4x00/5x00/6x00 Systems, Sun Enterprise SyMON^TM system monitoring and management software supports dynamic reconfiguration. However, the user's guide listed the wrong reference. The correct reference is Sun Enterprise SyMON 2.0.1 Supplement for Sun Enterprise Midrange Servers.