How to determine the currently active Oracle Private Cloud Appliance (PCA)/Virtual Compute Appliance (VCA) master Management Node

Asset ID:	1-71-1635661.1
Update Date:	2015-09-24
Keywords:

Solution Type Technical Instruction Sure

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

Applies to:

Private Cloud Appliance - Version 1.0.1 and later
Oracle Virtual Compute Appliance X3-2 Hardware - Version All Versions and later
Linux x86-64

Goal

This article describes how to determine the current Oracle Private Cloud Appliance (PCA) master Management Node.

Solution

Prior to version 2.0.5, Oracle Private Cloud Appliance (PCA) was formerly known as Oracle Virtual Compute Appliance (VCA).
Note the different PCA/VCA executablenaming depending on version in use.

[root@ovcamn05r1 ~]# head /etc/ovca-info
==== Begin build info ====
date: 2015-06-17
release: 2.0.5
build: 94
...

[root@ovcamn05r1 sbin]# ovca* pca*
lrwxrwxrwx. 1 root root     9 Aug 3 00:39 ovca-admin -> pca-admin
lrwxrwxrwx. 1 root root    16 Aug 3 00:39 ovca-check-master -> pca-check-master
-rwxr-xr-x. 1 root root 2911 Jun 9 10:42 ovca-daemon
lrwxrwxrwx. 1 root root     8 Aug 3 00:40 ovca-diag -> pca-diag
lrwxrwxrwx. 1 root root    10 Aug 3 00:39 ovca-helper -> pca-helper
lrwxrwxrwx. 1 root root    11 Aug 3 00:39 ovca-node-db -> pca-node-db
-rwxr-xr-x. 1 root root 3023 Jun 9 10:42 ovca-remote-rpc
-rwxr-xr-x. 1 root root 1209 Jun 9 10:42 ovca-rpc
lrwxrwxrwx. 1 root root    19 Aug 3 00:39 ovca-update-password -> pca-update-password
lrwxrwxrwx. 1 root root    11 Aug 3 00:39 ovca-updater -> pca-updater
-rwxr-xr-x. 1 root root   860 Jun 9 10:42 pca-admin
-rwxr-xr-x. 1 root root 2471 Jun 9 10:42 pca-backup
-rwxr-xr-x. 1 root root   352 Jun 9 10:42 pca-check-master
-rwxr-xr-x. 1 root root   650 Jun 9 10:42 pca-dhcpd
-rwxr-xr-x. 1 root root 27296 Jun 9 10:42 pca-diag
-rwxr-xr-x. 1 root root 14062 Jun 9 10:42 pca-factory-init
-rwxr-xr-x. 1 root root 5835 Jun 9 10:42 pca-helper
-rwxr-xr-x. 1 root root 6095 Jun 9 10:42 pca-node-db
-rwxr-xr-x. 1 root root 4165 Jun 9 10:42 pca-redirect
-rwxr-xr-x. 1 root root 4188 Jun 9 10:42 pca-update-password
-rwxr-xr-x. 1 root root 7135 Jun 9 10:42 pca-updater
-rwxr-xr-x. 1 root root 24119 Jun 9 10:42 pca-vm-tool

The following outlines several methods for users to identify the currently active Oracle PCA master Management Node.
Examples used are taken from PCA 2.0.5, therefore pca-* command output is shown.

1. Connect to Oracle PCA Virtual IP (VIP)

For the purpose of High Availability (HA), an Oracle PCA environment comprises two Management Nodes (MNs) whereby:

the first MN to instantiate assumes the role of master Management Node
the other acts as a standby Management Node awaiting to assume the master role in the event of master MN failure, maintenance, etc.

The floating Virtual IP (VIP) used to access PCA management services (Oracle WebLogic Server, OVCA Dashboard, Oracle VM Manager, etc.) is only ever brought up on the active master Management Node.
Therefore, a connection to the PCA VIP will always ensure one is connecting to the currently active master Management Node.

Note that in the event of maintenance or failure, master Management Node role failover from the active to standby Management Node may take several minutes to complete.

2. Run pca-check-master script

Run the /usr/sbin/pca-check-master script on either PCA Management Node to identify the currently active master Management Node e.g.:

[root@ovcamn06r1 ~]# /usr/sbin/pca-check-master
NODE: 192.168.4.4 MASTER: True
[root@ovcamn06r1 ~]#

[root@ovcamn05r1 ~]# /usr/sbin/pca-check-master
NODE: 192.168.4.3 MASTER: False
[root@ovcamn05r1 ~]#

3. Existence of /dlm/ovca/master file

The currently active master Management Node can also be determined by the existence of the /dlm/ovca/master file e.g.

[root@ovcamn06r1 ~]# ls -l /dlm/ovca/master
-rwx------ 1 root root 64 Mar 11 19:44 /dlm/ovca/master
[root@ovcamn06r1 ~]#

[root@ovcamn05r1 ~]# ls -l /dlm/ovca/master
ls: cannot access /dlm/ovca/master: No such file or directory
[root@ovcamn05r1 ~]#

References

http://docs.oracle.com/cd/E40371_01/E40647/html/admin-intro-ha.html

Attachments

This solution has no attachment