Implementing the Enterprise Manager Hybrid Cloud Agent for EnterpriseOne Targets


Options



Before You Begin

Purpose

This tutorial describes how to install, configure, manage and monitor JD Edwards targets on Oracle Cloud from on-premise Oracle Enterprise Manager Cloud Control.

Time to Complete

Approximately 1 hour

What Do You Need?

Installing the Hybrid Cloud Gateway Agent

Prerequisites

Configuring External Proxy for My Oracle Support

For security reasons, you can choose to configure external proxies between Hybrid Cloud Agents and the Hybrid Cloud Gateway Agents.

Note: Oracle supports only proxies that support tunneling (for example, SOCK4, SOCK5, HTTP).

To configure an external proxy between a Hybrid Cloud Agent and a Hybrid Cloud Gateway Agent:

  1. Access the Proxy Settings for My Oracle Support form and set up a proxy server.

    Oracle headquarters buildings
    Proxy Settings for My Oracle Support
  2. From the Setup menu, select Manage Cloud Control, and then select Agents.

  3. Search for and click the name of the Hybrid Cloud Gateway Agent for which you want to configure an external proxy.

  4. From the Agent menu, select Properties.

  5. Select Basic Properties. For externalProxyPort, specify the communication port that must be used to connect to Oracle Cloud, and then click Apply.

  6. Select Advanced Properties. Expand the Runtime Settings section. For externalProxyHost, specify the host name of the proxy. For externalProxyType, specify whether the proxy uses HTTP, SOCKS4, or SOCKS5 for communication.

    Note: If the proxy server that you set up requires user name and password authentication, specify values for externalProxyUsername and externalProxyPassword.

  7. Click Apply.

  8. Verify that the external proxy is authenticated as expected by running the following SSH command:

    ssh -l <user> -o "ProxyCommand /usr/bin/nc -X connect -x <proxy host>:<proxy port> %h %p" <host> <command>
Note: If you use the ‘No Proxy’ option, ensure that you have installed the Patch Request for ARU 20106947. For details, refer: Patch Request 20106947

Configuring an Existing 13c Management Agent as a Hybrid Cloud Gateway Agent

  1. Log in to the Enterprise Manager command-line interface (CLI).

    Oracle headquarters buildings
    Enterprise Manager Command Line Interface
  2. Designate the selected management agent to act as a Hybrid Cloud Gateway Agent. Run the following Enterprise Manager CLI verb from the Oracle Management Server home or from a host on which Enterprise Manager CLI is set up.

    Oracle headquarters buildings
    Enterprise Manager CLI Verb

Installing the Hybrid Cloud Agent

Prerequisites

Installing a Hybrid Cloud Agent Using the Add Host Targets Wizard

Note: Because a Hybrid Cloud Agent connects to the on-premise Oracle Management Server through an SSH bridge, manual deployment such as a silent agent installation is not supported for Hybrid Cloud Agents. You can only deploy Hybrid Cloud Agents using the Add Host Targets Wizard or Enterprise Manager CLI. You can deploy a Hybrid Cloud Agent only on an Oracle Linux x86-64 operating system. The Hybrid Cloud Gateway Agent is supported on all operating systems, but the Hybrid Cloud Agent is supported only on an Oracle Linux x86-64 operating system.

To install a Hybrid Cloud Agent using the Add Host Targets Wizard, after logging into EM:

  1. Log in to Enterprise Manager.

  2. In Cloud Control, from the Setup menu, select Add Target, and then click Add Targets Manually.

    The system displays the Add Targets Manually form.

  3. On the Add Host Targets tab, click Install Agent on Host.

  4. On the Host and Platform page, Click Add to enter the IP address and select the platform of the Oracle Cloud virtual host on which you want to install the Hybrid Cloud Agent. Then, click Next.

  5. On the Installation Details page, select Fresh Agent Install in the Deployment Type section.

  6. In the Deployment Type section, select Fresh Agent Install.

  7. From the table, select the first row that indicates the virtual hosts grouped by their common platform name.

  8. For Installation Base Directory, enter the absolute path to the base directory on the Oracle Cloud virtual host on which you want to copy the software binaries, security files, and inventory files of the Hybrid Cloud Agent.

  9. For Instance Directory, accept the default instance directory location or enter the absolute path to a directory of your choice where all the Hybrid Cloud Agent related configuration files can be stored.

  10. For Named Credential, select the named credential to set up SSH connectivity between the on-premise OMS and the destination Oracle Cloud virtual hosts, and to install a Hybrid Cloud Agent on each of the Oracle Cloud virtual hosts.

  11. For Privileged Delegation Setting, use the default value. Privilege delegation providers and locked accounts are not supported for a Hybrid Cloud Agent deployment.

  12. For Port, accept the default port (3872) that is assigned for the Hybrid Cloud Agent to communicate, enter any available port, or leave as blank. Cloud Control automatically assigns the first available free port within the range of 1830 through 1849.

  13. To run certain scripts before or after deploying the Hybrid Cloud Agents, in the Optional Details section, enter the absolute path to the locations where the scripts that you want to run are available.

  14. In the Optional Details section, enter additional parameters.

    For example: INVENTORY_LOCATION="/u02/hybridem/oraInventory-den00gxw"

  15. Select Configure Hybrid Cloud Agent to specify the details for the Hybrid Cloud Gateway Agent that the Hybrid Cloud Agent must communicate with.

  16. Click Next.

  17. On the Review page, review the details that you have provided for the installation. Click Deploy Agent to install the Hybrid Cloud Agent.

    Oracle headquarters buildings
    Add Target Page
  18. To verify that the Hybrid Cloud Agent was deployed on Oracle Cloud, from the Setup menu, select Manage Cloud Control, then select Agents. Search for and then click the name of the Hybrid Cloud Agent to access its home page.

    Oracle headquarters buildings
    Description of this image

Deploying the AMS4JDE AppPack Plug-in to the Hybrid Cloud Agent

To deploy the JDE AppPack into the Management Agent, complete the following steps:

  1. In Oracle Enterprise Manager Cloud Control, navigate to Setup, Extensibility, and then click Plugins.

  2. Right-click the undeployed plugin, select Deploy On, and then click Management Agent.

  3. On the Deploy Plug-in on Management Agent form, select the desired target, and then click Continue.

  4. On the Deploy Plug-in on Management Agent - Select Management Agent form, select the desired management agent, and then click Continue

  5. On the Deploy Plug-in on Management Agent, General form, verify that the JD Edwards EnterpriseOne target machine is added, and then click the Next button.

    On the Deploy Plug-in on Management Agent, Review form, a warning is displayed indicating that the deployment of the plug-in on a managed host will restart the agent.

  6. Click the Deploy button.

  7. The system displays the Deploy Plug-in on Management Servers, Confirmation form which indicates that the deployment is started on selected hosts.

    Click the Show Status button.

For details, see Deploy the JDE AppPack into the Management Agent

Adding the JD Edwards EnterpriseOne Domain to Cloud Control

  1. Navigate to the Systems page from the Targets menu. On the Systems page, use the Search drop-down menu to select the JDE EnterpriseOne domain.

  2. On the Systems page, with the JDE EnterpriseOne Domain selected, click JDE EnterpriseOne Domain from the Add drop-down menu.

  3. On the Add JDE EnterpriseOne Domain page, complete the following fields:

    • EnterpriseOne Domain Target Name

      Enter the name of the domain for JD Edwards EnterpriseOne. The name of the Server Manager host will be appended to this name if you do not specify it. For example, your target name can be Eone_Test.

    • Enterprise Manager Agent Host Machine

      Enter the machine name on which the Enterprise Manager agent is installed. For example, your machine name can be: oc-129-144-52-58.compute.oraclecloud.com.

    • Server Manager Host

      Enter the fully qualified machine name of your Server Manager host. For example, your machine name can be: oc-129-144-52-58.compute.oraclecloud.com.

    • Server Manager HTTP Port

      Enter the HTTP port that will be used to connect to Server Manager. The default value is 9120.

    • Server Manager JMX Port

      Enter the JMX port that will be used to connect to Server Manager. The default value is 16521.

    • Server Manager Admin User

      The default value, which should not be changed, is jde_admin.

    • Server Manager Admin Password

      Enter the password of your Server Manager administrator.

  4. Click the OK button to add the domain.

  5. As it adds the JD Edwards Domain and associated targets, Cloud Control performs these functions:

    • Discovering: JD Edwards EnterpriseOne Domain

    • Creating: JD Edwards EnterpriseOne Domain target

    • Saving: JD Edwards EnterpriseOne Domain targets discovered

    After the processing is complete, the system displays the home page for the JD Edwards EnterpriseOne Domain.

    See Using Cloud Control with JD Edwards EnterpriseOne

Want to Learn More?