Installing the Management Agent on Oracle PCA

Before discovering the Oracle Private Cloud Appliance (PCA) in Enterprise Manager, you must first prepare the appliance and install a Management Agent. Follow the steps below to properly configure your Oracle PCA:

  1. Using the root account change the oracle user password to a known password on both management nodes of the Oracle PCA Rack:
    passwd oracle
  2. Verify the VIP and public Enterprise Manager IP are in the /etc/hosts file on both management nodes and on the Enterprise Manager host:
    YOUR.VIP vca1-vip-vip
    YOUR.EMIP em01
  3. On an the active management node, using the oracle user create an agent directory on the shared NFS directory. The shared nfs directory is required for both availability and failover purposes.
    mkdir /nfs/shared_storage/oemagent
    chown oracle:dba /nfs/shared_storage/oemagent


    • By default, the Enterprise Manager agent port 3872 is pre-populated by Oracle PCA software. If you use this default Enterprise Manager agent port 3872 for pushing the agent, then this step is not needed. If a non-default port is used for the Enterprise Manager agent, the steps do need to be executed on standby management node.
    • If the agent port is different from the default port (3872), you must configure the firewall for that particular port, as 3872 is set by default in the Oracle PCA management node setup.
  4. Open an Enterprise Manager agent port in the firewall using the root user by running the following command. Make sure you choose the same port while pushing the agent in step 5:
    For PCA 2.4.4 and above:
    firewall-cmd --add-port <agent_port>/tcp --permanent
    firewall-cmd --reload
    For PCA 2.4.3 and below:
    iptables -I INPUT <line_num> -m state --state NEW -m tcp -p tcp --dport <agent_port> -j ACCEPT
    Where line_num is any line number before the rule to block all traffic. To obtain the line_num value tun the following commands using the root user:
    service iptables save
    service iptables reload
  5. Push the Management Agent from the Oracle Management Server (OMS). From Enterprise Manager Cloud Control:
    1. From the Setup menu, select Add Target, then select Add Targets Manually.
    2. In the Add Host Targets area of the Add Targets Manually page, click Install Agent on Host. The Add Host wizard will begin.
    3. Add a Host and Platform. On this page, click Add and select Manually. Enter a host name (fully qualified) in the Host field. This name should be the fully qualified virtual IP host name of the Oracle PCA rack for deploying the agent. Select Linux x86-64 from the Platform menu.
      Click Next.
    4. On the Installation Details page, enter the following information:
      • Installation Base Directory: /nfs/shared_storage/oemagent
      • Instance Directory: /nfs/shared_storage/oemagent/agent_inst (This value is automatically completed based on the Installation Base Directory input.)
      • Named Credential: <agent_username>


        If this is the first time you are adding a credential, an add icon (add named credential icon) appears. Click this icon for a dialogue box that prompts for the credentials of the agent user (oracle/password for example).

        Create a Named Credential for the oracle user with the password you set in step 1 above.

        Once created, that credential and any other credentials that have already been added to Enterprise Manager will be available for selection. For an existing installation of an Enterprise Manager, a user may already have the necessary credentials available for selection for Oracle PCA discovery.

        This root privileges field is located in between Name credential and Privileged Delegation Setting in Enterprise Manager 13.3.

      • Privileged Delegation Setting: Leave the default. By default, this field is populated with /usr/bin/sudo -u %RUNAS% %COMMAND%
      • Port: By default, this field is populated with 3872. If you've not used the default port 3872, then ensure to specify the port number.
      • Preinstallation Script: Leave this field blank.
      • Postinstallation Script: Leave this field blank.
      • Additional Parameters: Leave this field blank.

      Once the fields are complete, click Next.

    5. On the Review page, review the details of the host information. Click Deploy Agent.


      During the agent install as a non privileged user, the user interface will display a warning and state that privilege scripts need to be run manually as the root user. Select Continue All Hosts and once the agent install has completed, run the following privileged scripts as the root user on the Oracle PCA active management node:



      For more information, see Meeting the Generic Prerequisites for Installing Standalone Management Agents Using Add Host Targets Wizard or EM CLI

  6. On the active management node, set the emd property AgentListenOnAllNICs to false by running following command with the oracle user:
    /nfs/shared_storage/oemagent/agent_inst/bin/emctl setproperty agent -name "AgentListenOnAllNICs" -value "false"
  7. On the active management node, run the following command with the oracle user:
    /nfs/shared_storage/oemagent/agent_inst/bin/emctl setproperty agent -allow_new -name _disableLoadDPFromCache -value true
  8. On the active management node, run the following command with the oracle user if you are going to use Kubernetes service:
    /nfs/shared_storage/oemagent/agent_inst/bin/emctl setproperty agent -name preferIPv6Addresses -value false 
  9. Using the root account copy the following agent installation files to the passive management node (ovcamn06r1 is passive in this example):
    scp /etc/init.d/gcstartup root@ovcamn06r1:/etc/init.d/
    rsync -og /etc/oragchomelist root@ovcamn06r1:/etc/oragchomelist
    rsync -rog /u01/app/oraInventory/ oracle@ovcamn06r1:/u01/app/oraInventory/
  10. On the active management node using the root account remove all gc rc.d links (no startup of agent on startup):
    for x in `find /etc/rc.*/rc* | grep gcstart`; do rm $x; done
  11. Restart the Enterprise Manager agent on the active management node as oracle 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