Top
PRIMECLUSTER Global Link Services Configuration and AdministrationGuide 4.2Redundant Line Control Function

4.5.2 Replacement/Expansion PHP (PCI Hot Plug)

This section explains a procedure of replacing or adding a PCI card for GLS in a PCI Hot Plug (PHP) environment.

Compatibility of PHP with each mode is shown in the table below.

[PHP Support] A: Supported X: Not supported

PHP(PCI Hot Plug) operation

Fast switching mode

RIP mode

NIC switching mode

GS/SURE linkage mode

Replacement (Redundant system)

A

X

A

A

Extension (Non-redundant system)

A

X

A

A

Extension (Redundant system)

A

X

X

A

Note

Replacement and expansion of PHP (PCI Hot Plug) is allowed only when the system is running in a multiple user mode.

4.5.2.1 Replacement of PCI card on redundant system

In Fast Switching and NIC Switching mode, it is possible to replace the redundant NIC without stopping network communication.

Note

For NIC Switching mode, it is required to stop the transfer path monitoring function and standby patrol function.
For GS/SURE linkage mode, it is required to deactivate the virtual interface.

The following is a procedure of replacing redundant system.

Perform the following procedure when using PRIMEPOWER.

For replacing procedure of deactivated configuration, refer to "PCI Hot Plug User's guide for I/O device".

1) Stop the hardware monitoring of the Machine Administration

The hardware monitoring of the Machine Administration is stopped by using the following command.

# /usr/sbin/FJSVmadm/prephp <Return>

2) Specify the replacing PCI card

An interface on the PCI card to be replaced can be identified from the warning messages output to the console (eg. hme1).

3) Disconnect from redundant system

In order to remove the PCI card from the redundant system for replacement, please execute the following command with the interface name obtained in the procedure "2) Specify the replacing PCI card". On the redundant system of standby mode, when an online communication path is disconnected, a standby communication path will be online communication path automatically.

Fast switching mode

# /opt/FJSVhanet/usr/sbin/hanetnic delete -n sha0 -i hme1 <Return>
# /usr/sbin/ifconfig hme1 unplumb <Return>

NIC switching mode

# /opt/FJSVhanet/usr/sbin/hanetpoll off <Return>
# /opt/FJSVhanet/usr/sbin/stpptl -n sha1 <Return>
# /opt/FJSVhanet/usr/sbin/hanetnic change -n sha0 <Return>

GS/SURE linkage mode

# /opt/FJSVhanet/usr/sbin/stphanet -n sha0 <Return>

4) Disconnect the PCI card

Specify the interface name identified in the procedure "2) Specify the replacing PCI card." to "inst2comp" command to obtain the PCI bus slot "Ap_Id".

# /usr/sbin/FJSVmadm/inst2comp hme1 <Return>
pcipsy21:R0B01-PCI#slot03

Specify the "Ap_Id" obtained above as an argument to "cfgadm"(1M) command, and confirm that the slot status of the PCI card to be disconnected is "connected configured".

# cfgadm pcipsy21:R0B01-PCI#slot03 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy21:R0B01-PCI#slot03      pci-pci/hp  connected     configured    ok

Please disconnect the PCI card by executing the cfgadn (1M) command with "Ap_Id," and confirm that the slot status is "disconnected unconfigured."

# cfgadm -c disconnect pcipsy21:R0B01-PCI#slot03 <Return>
# cfgadm pcipsy21:R0B01-PCI#slot03 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy21:R0B01-PCI#slot03      unknown     disconnected  unconfigured  unknown

To indicate the slot position for replacement, specify the obtained "Ap_Id" to "cfgadm" command and blink the ALARM LED.

# cfgadm -x led=fault,mode=blink pcipsy21:R0B01-PCI#slot03 <Return>

5) Replace the PCI card

The PCI card disconnected in the procedure "4) Disconnect the PCI card" is replaced with a new one. Our customer support staff does this for you.

6) Connect the PCI card

In order to connect a new PCI card, execute "cfgadm" command with "configure" option and the "Ap_Id", or push the push button of the PCI bus slot.

Note

In addition, a push button is valid only in multiple user mode.

Please confirm that the slot status is "connected configured" by using the cfgadm (1M) command after the above-mentioned procedure.

# cfgadm -c configure pcipsy21:R0B01-PCI#slot03 <Return>
# cfgadm pcipsy21:R0B01-PCI#slot03 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy21:R0B01-PCI#slot03      pci-pci/hp  connected     configured    ok

7) Connect to redundant system

In order to connect the new PCI card to a redundant system, please execute the following commands with the interface name identified in the procedure "2) Specify the replacing PCI card".

Fast switching mode

# /opt/FJSVhanet/usr/sbin/hanetnic add -n sha0 -i hme1 <Return>

NIC switching mode

# /opt/FJSVhanet/usr/sbin/hanetnic change -n sha0 <Return>
# /opt/FJSVhanet/usr/sbin/strptl -n sha1 <Return>
# /opt/FJSVhanet/usr/sbin/hanetpoll on <Return>

GS/SURE linkage mode

# /opt/FJSVhanet/usr/sbin/strhanet -n sha0 <Return>

8) Switch back the redundant path

Please switch back an online communication path if needed.

9) Start the hardware monitoring of the Machine Administration

Please execute the following commands in order to update configuration information, and restart the hardware monitoring of the Machine Administration.

# /usr/sbin/FJSVmadm/postphp <Return>

4.5.2.2 Extension of PCI cards with new redundant system

By adding a new PCI card to a non-redundant system, it is possible to create a redundant system.

The following is the procedure of adding a new PCI card to a non-redundant system.

Perform the following procedure when using PRIMEPOWER.

1) Stop the hardware monitoring of the Machine Administration

The hardware monitoring of the Machine Administration is stopped by using the following command.

# /usr/sbin/FJSVmadm/prephp <Return>

2) Add PCI cards

a.
Before adding a PCI card, please save the output of "prtpicl"(1M) command.

# prtpicl -v > /tmp/prtpicl.pre <Return>

b.
Check the status of the slot.
An example of adding a PCI card to a slot "R0B01-PCI#slot02" is shown in this section. "R0" in "R0B01-PCI#slot02" indicates the I/O cabinet number: 0, "B01" the PCI/Disk Box number: 1, and "slot02" the physical slot number: 02.
If you are adding more PCI cards, please repeat the procedures 2) b and 3).
The relationship of the position of a PCI card and format of "Ap_Id" is shown below. (N: an integral number)

Location of PCI slot

Element

Format of "Ap_Id"

Cabinet of PRIMEPOWER 900/1500/2500

Cabinet Number: X
System Board Number: Y
Physical Slot Number: ZZ

pcipsyN:CXM0Y-PCI#slotZZ

PCI / Disk BOX

I/O Cabinet Number: X
PCI/Disk BOX Number: Y
Physical Slot Number: ZZ

pcipsyN:RXB0Y-PCI#slotZZ

other than those above

Physical Slot Number: ZZ

pcipsyN:PCI#slotZZ

Please confirm that the status of the PCI slot where a PCI card is added is "empty unconfigured" by using "cfgadm" (1M) command.

# cfgadm R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      unknown     empty         unconfigured  unknown

c.
To indicate the slot position for expansion, specify the "Ap_Id" identified in the procedure 2)b to "cfgadm" command and blink the ALARM LED.

# cfgadm -x led=fault,mode=blink pcipsy18:R0B01-PCI#slot02 <Return>

d.
Add a PCI card after the READY LED of the target PCI bus slot has turned off.
This operation is performed by our customer support.

e.
Please confirm that the PCI slot status which extended PCI cards is "disconnected unconfigured" by using cfgadm (1M) command.

# cfgadm pcipsy18:R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      unknown     disconnected  unconfigured  unknown

3) Connect PCI cards

An added PCI card is connected to the system by executing "cfgadm" command with "configure" option and "Ap_Id", or by pushing the push button of the PCI bus slot.

Note

In addition, a push button is valid only in multiple user mode.

Please confirm that the slot status is "connected configured" by using the cfgadm (1M) command after the above-mentioned procedure.

# cfgadm -c configure pcipsy18:R0B01-PCI#slot02 <Return>
# cfgadm pcipsy18:R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      pci-pci/hp  connected     configured    ok

4) Start the hardware monitoring of the Machine Administration

Please execute the following command in order to update configuration information, and restart the hardware monitoring of the Machine Administration.

# /usr/sbin/FJSVmadm/postphp <Return>

5) Connect equipment to PCI cards

The extended PCI card is connected with network equipment by the cable.

6) Setup driver

The driver configuration is added by following operations.

a.
The interface name is investigated in order to configure drivers and high layer products.
Please save the result of the prtcicl (1M) command, and obtain the difference information between current result and the result taken at "2.a." Then, the driver instance number for the extended PCI card is obtained.
In the following example, since the instance number is 1, it can be determined that the interface name of the extended PCI card is "hme1."

# prtpicl -v > /tmp/prtpicl.post <Return>
# diff /tmp/prtpicl.pre /tmp/prtpicl.post | more <Return>
            :
>    :status    okay
>    :devfs-path    /pci@8d,2000/network@1
>    :driver-name   hme
>    :binding-name  SUNW,hme
>    :bus-addr  1
>    :instance  1
>    :_class    obp-device
>    :name  network
            :

b.
Confirm that the interface name that is obtained from the above operation matches the one that has been added to the PCI bus slot.

# /usr/sbin/FJSVmadm/inst2comp hme1 <Return>
pcipsy18:R0B01-PCI#slot02

c.
The configuration of each driver is added.
Please refer to each driver manual for details.

7) Setup redundant system

Activate the virtual interface after configuring Fast Switching, NIC Switching, or GS/SURE linkage mode. System reboot is not required after configuring each mode.

When configuring Fast Switching mode, the added interface "hme1" must be activated preliminary by the following command.

For IPv4 address

# /usr/sbin/ifconfig hme1 plumb <Return>
# /usr/sbin/ifconfig hme1 IP address netmask + broadcast + -trailers up <Return>

For IPv6 address

# /usr/sbin/ifconfig lo0 inet6 plumb up <Return>
# /usr/sbin/ifconfig hme1 inet6 plumb up <Return>

Note

For Fast switching mode (IPv4), the IP address specified in this section must also be defined in /etc/inet/hosts and /etc/hostname.hme1.
For Fast switching mode (IPv6), create /etc/hostname6.hme1 as an empty file.
Unless these are configured, when the system reboots, the virtual interface for Fast Switching mode cannot be activated.

4.5.2.3 Extension of PCI cards to redundant system

It is possible to extend a PCI card to the redundant system.

Note

In NIC Switching mode, it is not possible to add a new interface to a redundant system.
Also, when adding a new interface in GS/SURE linkage mode, it is first required to deactivate the virtual interface for GS/SURE linkage mode and then add a new interface.

The following is the procedure of extending PCI card to the redundant system.

Perform the following procedure when using PRIMEPOWER.

1) Stop the hardware monitoring of the Machine Administration

The hardware monitoring of the Machine Administration is stopped by using the following command.

# /usr/sbin/FJSVmadm/prephp <Return>

2) Add PCI cards

a.
Before extending the PCI card, please save the result (current configuration information) of the prtpicl (1M) command.

# prtpicl -v > /tmp/prtpicl.pre <Return>

b.
Check the status of the slot.
An example of adding a PCI card to a slot "R0B01-PCI#slot02" is shown in this section. "R0" in "R0B01-PCI#slot02" indicates the I/O cabinet number: 0, "B01" the PCI/Disk Box number: 1, and "slot02" the physical slot number: 02.
If you are adding more PCI cards, please repeat the procedures 2) b and 3).
The relationship of the position of a PCI card and format of "Ap_Id" is shown below. (N: an integral number)

Location of PCI slot

Element

Format of "Ap_Id"

Cabinet of PRIMEPOWER 900/1500/2500

Cabinet Number: X
System Board Number: Y
Physical Slot Number: ZZ

pcipsyN:CXM0Y-PCI#slotZZ

PCI / Disk BOX

I/O Cabinet Number: X
PCI/Disk BOX Number: Y
Physical Slot Number: ZZ

pcipsyN:RXB0Y-PCI#slotZZ

other than those above

Physical Slot Number: ZZ

pcipsyN:PCI#slotZZ

Please confirm that the status of the PCI slot where a PCI card is added is "empty unconfigured" by using "cfgadm" (1M) command.

# cfgadm R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      unknown     empty         unconfigured  unknown

c.
To indicate the slot position for expansion, specify the "Ap_Id" identified in the procedure 2)b to "cfgadm" command and blink the ALARM LED.

# cfgadm -x led=fault,mode=blink pcipsy18:R0B01-PCI#slot02 <Return>

d.
Add a PCI card after the READY LED of the target PCI bus slot has turned off. This operation is performed by our customer support.

e.
Please confirm that the PCI slot status which extended PCI cards is "disconnected unconfigured" by using cfgadm (1M) command.

# cfgadm pcipsy18:R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      unknown     disconnected  unconfigured  unknown

3) Connect PCI cards

An added PCI card is connected to the system by executing "cfgadm" command with "configure" option and "Ap_Id", or by pushing the push button of the PCI bus slot.

Note

In addition, a push button is valid only in multiple user mode.

Please confirm that the slot status is "connected configured" by using the cfgadm (1M) command after the above-mentioned procedure.

# cfgadm -c configure pcipsy18:R0B01-PCI#slot02 <Return>
# cfgadm pcipsy18:R0B01-PCI#slot02 <Return>
Ap_Id                          Type        Receptacle    Occupant      Condition
pcipsy18:R0B01-PCI#slot02      pci-pci/hp  connected     configured    ok

4) Connect equipment to PCI cards

The extended PCI card is connected with network equipment by the cable.

5) Setup driver

The driver configuration is added by following operations.

a.
The interface name is investigated in order to configure drivers and high layer products.
Please save the result of the prtcicl (1M) command, and obtain the difference information between current result and the result taken at "2.a." Then, the driver instance number for the extended PCI card is obtained.
In the following example, since the instance number is 1, it can be determined that the interface name of the extended PCI card is "hme2."

# prtpicl -v > /tmp/prtpicl.post <Return>
# diff /tmp/prtpicl.pre /tmp/prtpicl.post | more <Return>
            :
>    :status    okay
>    :devfs-path    /pci@8d,2000/network@2
>    :driver-name   hme
>    :binding-name  SUNW,hme
>    :bus-addr  2
>    :instance  2
>    :_class    obp-device
>    :name  network
            :

b.
Confirm that the interface name that is obtained from the above operation matches the one that has been added to the PCI bus slot.

# /usr/sbin/FJSVmadm/inst2comp hme2 <Return>
pcipsy18:R0B01-PCI#slot02

c.
The configuration of each driver is added.
Please refer to each driver manual for details.

6) Connect to redundant system

Please execute following commands in order to connect the extended PCI card to the existing redundant configuration system.

Fast switching mode

# /usr/sbin/ifconfig hme2 plumb <Return>
# /usr/sbin/ifconfig hme2 IP_address netmask + broadcast + -trailers up <Return>
# /usr/bin/echo IP_address > /etc/hostname.hme2
# /opt/FJSVhanet/usr/sbin/hanetnic add -n sha0 -i hme2 -f <Return>

GS/SURE linkage mode

# /opt/FJSVhanet/usr/sbin/stphanet -n sha0 <Return>
# /opt/FJSVhanet/usr/sbin/hanetconfig create -n sha2 -m n -i IP_address -t hme2 <Return>
# /opt/FJSVhanet/usr/sbin/hanetconfig modify -n sha0 -t sha2,sha3,sha4 <Return>
# /opt/FJSVhanet/usr/sbin/strhanet -n sha0 <Return>

7) Switch the redundant path

Please switch an online communication path for extended communication path if needed.

8) Start the hardware monitoring of the Machine Administration

Please execute the following command in order to update configuration information, and restart the hardware monitoring of the Machine Administration.

# /usr/sbin/FJSVmadm/postphp <Return>