This procedure covers Enterprise Manager agent recovery for Oracle PCA upgrades from version 2.3.1. If your Oracle PCA is not 2.3.1 then refer to My Oracle Support note 2242177.1, which includes steps for Oracle Enterprise Manager.
- For Private Cloud Appliance v2.3.3 and lower, the Enterprise Manager agent must be stopped before initiating the PCA upgrade. To stop the agent run the following command:
/nfs/shared_storage/oemagent/agent_126.96.36.199.0/bin/emctl stop agent.
- It is recommended to upgrade the OMS and PCA management node agent to the latest version of the VT and supporting plugins.
- With the
rootaccount backup the
oraInventoryagent to the NFS-shared location:
cd /u01/app tar -cvf EMagent_oraInventory.tar oraInventory cp EMagent_oraInventory.tar /nfs/shared_storage
- Create the full blackout on Oracle PCA rack.
To create full blackout on Oracle PCA rack, login to the Enterprise Manager 13c UI as the Cloud Administrator and do the following:
From the Targets menu, select Private Cloud Appliance.
From the Private Cloud Appliance home page menu, select Control, and then select Create Blackout option.
- Update the Oracle PCA rack.For more information, refer to Updating Oracle Private Cloud Appliance.
Note:If you are running or upgrading to Oracle Private Cloud Appliance Software v2.4.3 or lower, then Steps 4 to 10 are not required.
- The next step is to recover the Oracle Enterprise Manager agent installed on the NFS shared storage which is presented to both active and passive management nodes. You should restore the
oraInventorybackup taken in the first step as the
rootuser on the active management node:
NODE: 192.168.4.4 MASTER: True"
cp /nfs/shared_storage/EMagent_oraInventory.tar /u01/app
tar -xvf EMagent_oraInventory.tar
- Keep the same password you created in Installing the Management Agent on Oracle PCA for the
oracleuser on both management nodes:
- Run the privileged agent scripts as
rooton the active management node:
- The Oracle Enterprise Manager agent needs to be under control of the Oracle Private Cloud Appliance software and not any local OS based startup scripts. Therefore, as the
rootuser on the active management node, you should remove any OS based
rc.*links to scripts.
for x in `find /etc/rc.*/rc* | grep gcstart`; do rm $x; done
- Copy the following agent installation files to the passive management node as the
ExampleUser1is passive in this example):
scp /etc/init.d/gcstartup root@ExampleUser1:/etc/init.d/ rsync -og /etc/oragchomelist root@ExampleUser1:/etc/oragchomelist
rsync -rog /u01/app/oraInventory/ oracle@ExampleUser1:/u01/app/oraInventory
- Add the Enterprise Manager agent port to the number chosen during agent push (see Installing the Management Agent on Oracle PCA) to the firewall settings on both management nodes (active and passive):
Note:By default, the Enterprise Manager agent port 3872 is pre-populated by PCA software. If you used this default Enterprise Manager agent port 3872 for pushing the agent, then this step is not needed.For PCA 2.4.4 and above using the
firewall-cmd --add-port <agent_port>/tcp --permanent firewall-cmd --reload
For PCA 2.4.3 and below using the
iptables -I INPUT <line_num> -m state --state NEW -m tcp -p tcp --dport <agent_port> -j ACCEPT
line_numis the any line number before the
iptablesrule to block all traffic.
line_numcan be obtained using the following commands as
service iptables status service iptables save service iptables reload
- If you are using Kubernetes, on the active management node run the following command as
/nfs/shared_storage/oemagent/agent_inst/bin/emctl setproperty agent -name preferIPv6Addresses -value false
- Restart the Enterprise Manager agent on the active management node as
oracleuser from the agent's EMCTL command:
/nfs/shared_storage/oemagent/agent_inst/bin/emctl stop agent /nfs/shared_storage/oemagent/agent_inst/bin/emctl start agent
- Remove the blackout on Oracle PCA rack.
On Oracle Private Cloud Appliance X3-2, after the upgrade of Private Cloud Appliance is complete and the agent is restored, you must ensure that Prerequisites to Monitor the Fabric Interconnect in Oracle Private Cloud Appliance are met to enable the new Fabric Interconnect Target features in Oracle PCA.