Steps to Gracefully Shutdown and Power Off a Node in Oracle Private Cloud Appliance Prior to Maintenance

Asset ID:	1-71-2256834.1
Update Date:	2017-09-19
Keywords:

Solution Type Technical Instruction Sure

Solution 2256834.1 : Steps to Gracefully Shutdown and Power Off a Node in Oracle Private Cloud Appliance Prior to Maintenance

Applies to:

Private Cloud Appliance - Version 2.0.1 to 2.2.2 [Release 2.0]
Private Cloud Appliance X5-2 Hardware - Version All Versions and later
Private Cloud Appliance X6-2 Server Upgrade - Version All Versions and later
Oracle Virtual Compute Appliance X4-2 Hardware - Version All Versions and later
Information in this document applies to any platform.

Goal

Steps to Gracefully Shutdown and Power Off a Node in Oracle Private Cloud Appliance Prior to Maintenance.

This note applies to:
Oracle Server X6-2
Oracle Server X5-2
Sun Server X4-2
Sun Server X3-2

Solution

If you need to execute a service procedure that requires a node to be powered down, follow these instructions.

Note:
The management nodes (ovcamn05r1 or ovcamn06r1) are not placed in maintenance node for servicing. If you need to power down the master management node, power it down as described below and wait for the other management node to take over the master role. If you need to power down the secondary management node, no additional steps are required. To determine which Management Node is the master, please see the following note: How to determine the currently active Oracle Private Cloud Appliance (PCA)/Virtual Compute Appliance (VCA) master Management Node (Doc ID 1635661.1)

Placing a compute node into maintenance mode

Before a compute node can be powered down, it must be placed into maintenance mode from within Oracle VM Manager. As a result, all virtual machines running on the compute node are automatically migrated to other servers in the Oracle VM server pool, if they are available. For details, refer to the section “Placing an Oracle VM Server into Maintenance Mode” in the Oracle VM User's Guide.

1. Log in to the Oracle VM Manager Web UI.

For details, refer to the section “Section 4.2, “Logging in to the Oracle VM Manager Web UI”” in the Oracle Private Cloud Appliance Administrator's Guide.

a. Enter the following address in a Web browser: https://manager-vip:7002/ovm/console.

Replace manager-vip with the virtual IP address, or corresponding host name, that you have configured for your management nodes during installation

b. Enter the Oracle VM Manager user name and password in the respective fields and click OK.

2. In the Servers and VMs tab, select the Oracle VM Server in the navigation pane. Click Edit Server in the management pane toolbar.

The Edit Server dialog box is displayed.

3. Select the Maintenance Mode check box to place the Oracle VM Server into maintenance mode. Click OK.

The Oracle VM Server is in maintenance mode and ready for servicing.

Powering down the node

1. Power down the node gracefully whenever possible from OVM UI.

a. In the OVM Manager console, select the Servers and VMs tab. Expand Server Pools, and the rack Server Pool. You should see a list of compute nodes.

b. Right Click the compute node you wish to power down and select Stop Server.

Note:
A method in the PCA CLI to power down compute nodes exists, however is non functional in 2.0.5 and below. It is documented in2.1.1 and above, however there is currently a bug in the CLI for Stop/Start command. Please see the following notes for additional information.

2243157.1 [ PCA ] pca-admin stop compute-node ovcacnXXr1 fails with "Error Message: Error (FEATURE_DISABLED_000): Feature disabled. Command: stop compute-node."
2243158.1 [ PCA ] pca-admin start compute-node ovcacnXXr1 fails with "Error Message: Error (FEATURE_DISABLED_000): Feature disabled. Command: start compute-node."

2. In the Event the node does not respond to graceful shut down, or is in a hung state, execute the following.

a. From the master management node, SSH into the node you wish to power down.

[root@ovcamn05r1 ~]# ssh ilom-ovcacn27r1
Password:
Oracle(R) Integrated Lights Out Manager
Version 3.2.6.24 r107041
Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
Warning: HTTPS certificate is set to factory default.
Hostname: ilom-ovcacn27r1
->

b. Execute the following command.

> stop -force /SYS

c. This should forcibly power down the node

d. Check the power state to validate the node is powered down by executing the following command.

-> show /SYS power_state

e. Power state should show as the following.

-> show /SYS power_state

/SYS
Properties:
power_state = On

Replace the CRU or allow the Field Engineer (FE) to replace the FRU.

Replace the CRU or allow for the FE to complete the FRU replacement task. For details, refer to the section "6.1 Replaceable Components"

Returning the node to operation

1. Power on the node.

a. In the OVM Manager console, select the Servers and VMs tab. Expand Server Pools, and the rack Server Pool. You should see a list of compute nodes.

b. Right Click the compute node you wish to power on and select Start Server.

2. When the compute node is ready to rejoin the Oracle VM server pool, perform steps 1, 2, and 3 above and clear the Maintenance Mode check box.

References

<NOTE:1635661.1> - How to determine the currently active Oracle Private Cloud Appliance (PCA)/Virtual Compute Appliance (VCA) master Management Node

Attachments

This solution has no attachment