This chapter covers the following topics:
You can use the Discovery feature in Oracle E-Business Suite Cloud Manager to register Oracle E-Business Suite environments that follow our documented standards. The types of environments you can discover include the following:
Environments manually migrated from on-premises to Oracle Cloud Infrastructure, including those where the source environment was non-Linux.
Environments initially deployed by Oracle E-Business Suite Cloud Manager, after performing a major modification such as:
An Oracle E-Business Suite, Oracle Database, or Oracle Linux upgrade.
A configuration change, such as the addition of a load balancer or addition or deletion of a node.
Environments must be unregistered prior to rediscovery; refer to Rediscover an Updated Environment for complete instructions.
The process for discovering your Oracle E-Business Suite instance is as follows:
Ensure all prerequisites are met.
Perform steps to prepare for discovering your environment.
Submit the Discovery request.
Review the resulting report and make any necessary changes to bring the environment into compliance.
Register the environment once it passes all compliance checks.
Once your environment is registered, you can use Oracle E-Business Suite Cloud Manager to perform lifecycle management activities, such as backing up or restoring your instance. For a full list of Oracle E-Business Suite Cloud Manager features, see Features.
Note the following Discovery implementation details:
Environments with a single application tier node will be registered as having a shared file system.
The zone names for environments with multiple zones will be set to InternalZone<seqno> and ExternalZone<seqno> upon registration. For example, the zones would be InternalZone1, InternalZone2, and ExternalZone3 for an environment with two internal zones and one external zone.
If your environment has any of the following characteristics, you cannot use the Discovery feature at this time:
The application tier and database tier are on a single virtual machine (VM), such as an instance provisioned by the One-Click Provisioning feature.
Your Compute instance is deployed on a dedicated virtual machine host.
Your environment contains bare metal shapes.
For details on performing the discovery process, see the following sections:
You must have the following prerequisites in place in order to discover an Oracle E-Business Suite environment in Oracle Cloud Infrastructure:
An Oracle E-Business Suite Cloud Manager instance set up as described in Deploy Oracle E-Business Suite Cloud Manager on Oracle Cloud Infrastructure.
A candidate Oracle E-Business Suite environment on Oracle Cloud Infrastructure with optional database services that meets the following requirements:
The environment must be certified according to the information contained in My Oracle Support Knowledge Document 2517025.1, Getting Started with Oracle E-Business Suite on Oracle Cloud Infrastructure.
The environment must meet the standards described in My Oracle Support Knowledge Document 2656874.1, Standards Used by the Oracle E-Business Suite Cloud Manager for Provisioning Oracle E-Business Suite on Oracle Cloud Infrastructure.
To review the discovery requests that have been submitted in Oracle E-Business Suite Cloud Manager, click the Navigator icon, select Administration, and then select Discovery.
The Discovery Requests page displays the discovery requests that have been submitted in your Oracle E-Business Suite Cloud Manager instance, within the compartment that is selected in the EBS Compartment field in the Oracle E-Business Suite Cloud Manager header. You can optionally enter a full or partial value in the search field to display only requests whose properties contain that value. You can search by the following properties shown in this page:
Request name
Environment name
The page also displays the status of the discovery job and the date and time the request was submitted.
To submit a discovery request, first perform the tasks required to prepare your environment for discovery, and then click Submit Discovery Request. See Prepare for Discovery and Submit a Discovery Request.
To review the job details for a discovery job, click the job status link for that request. See Review Job Status.
To review the Discovery Report for a discovery request, click the View Discovery Report icon in the Compliance column. See Review the Discovery Report.
To register an environment that meets all the standards for discovery, click the Actions icon next to that request and then select Register Environment. See Register a Compliant Environment.
To remove a discovery request for an environment that has not yet been registered, click the Actions icon next to that request and then select Remove Discovery Request. For example, you can remove a request if you no longer want to register that environment.
Note: If you submit multiple discovery requests for an environment as you prepare it for discovery, any superseded requests are automatically removed when the environment is successfully registered. However, the final successful discovery request for the environment remains displayed in the Discovery Requests page after the environment is registered, as a record of the environment's history. You cannot remove that request unless you later unregister the environment.
To review the environment details for a successfully registered environment, click the environment name link. See Review Environment Details (Standard).
Perform the following tasks to prepare to discover an environment.
Enable SSH Connectivity
SSH connectivity must be enabled from the Oracle E-Business Suite Cloud Manager instance to all application tier and database tier nodes. To enable this connectivity, log in to the Oracle E-Business Suite Cloud Manager VM as the oracle user and copy the contents of ~/.ssh/id_rsa.pub into ~/.ssh/authorized_keys for the opc user on all nodes that are part of the environment to be discovered.
Create a Network Profile
As an Oracle E-Business Suite Cloud Manager administrator, use Oracle E-Business Suite Cloud Manager to create a network profile describing the network on which the candidate Oracle E-Business Suite instance is deployed. This network profile includes key network characteristics such as compartment, region, VCN, availability domain and subnets. For detailed instructions, see Create a Network Profile.
Create a Stage Directory
Create a directory on the database server to use as the database node stage directory. The stage directory is a temporary storage directory used by the discovery process, and must be writable by the oracle user. For example, /u01/install/APPS/stage.
You can now submit a discovery request in Oracle E-Business Suite Cloud Manager. The discovery request process identifies the candidate environment to Oracle E-Business Suite Cloud Manager. The Prevalidation phase ensures that prerequisites are met, then the discovery check itself runs and generates a report which will validate whether the environment meets predefined standards.
In Oracle E-Business Suite Cloud Manager, click the Navigator icon, select Administration, and then select Discovery.
In the Discovery Requests page, click Submit Discovery Request.
In the Submit Discovery Request window, enter the following details:
Name - Enter a unique name for your discovery request. The name must meet the following requirements:
The name must contain no more than 50 characters.
The first character cannot be a numeral.
Special characters and spaces are not allowed.
EBS Compartment - Select the Oracle E-Business Suite compartment associated with the Oracle Cloud Infrastructure resources for the environment.
Network Profile - Select the network profile that contains the network resources for the environment.
DB Node IP Address - Enter the private IP address of the database node for the environment being discovered.
Note: For an Oracle RAC database, you can enter the private IP address of any of the database nodes in this field.
DB Context File - Enter the full path for the database context file.
Note: For an Oracle RAC database, enter the context file corresponding to the database node IP specified in DB Node IP Address.
DB Node Stage Directory - Provide the stage directory location previously created to store metadata gathered during the discovery job.
Note: For an Oracle RAC database, the stage directory should be located on the database node IP specified in DB Node IP Address.
Environment Name - Enter the environment name.
APPS Password - Enter the APPS user password for the Oracle E-Business Suite source environment.
Optionally, if the candidate Oracle E-Business Suite environment for discovery is already configured with an Oracle Cloud Infrastructure load balancer, click the Discover OCI Load Balancers toggle switch. Then, click Add to specify the details of the load balancer and listener. An environment can have multiple load balancers and zones associated with it.
If the candidate Oracle E-Business Suite Environment has an Oracle Cloud Infrastructure load balancer associated with it but you do not specify the load balancer details when you submit the discovery request, or if the specified load balancer and listener mappings do not match the environment's configuration, then the web entry point identified by the discovery process is registered with a default web entry type as follows:
If the environment includes only one application tier node, then its web entry type is set to Application Tier Node.
If the environment includes multiple application tier nodes, then its web entry type is set to Manually Configured Load Balancer.
You can unregister the environment and submit a new discovery request to supply the corrected load balancer information.
Click Submit when you are ready to submit the request. Ensure that the EBS Compartment field in the Oracle E-Business Suite Cloud Manager header is set to the compartment associated with the request. Oracle E-Business Suite Cloud Manager then displays the request in the Discovery Requests page.
In the Discovery Requests page, your newly submitted request with an automatically populated environment name appears. The request then goes through the Prevalidation phase, which ensures that Oracle E-Business Suite Cloud Manager can locate the environment and prerequisites are met. Refresh the page to view an updated job status.
You can click the status link to view the Job Details page. The Job Details page provides an option to auto-refresh every 20 seconds as the various compliance checks are performed and completed. Click the Auto Refresh toggle switch to enable and disable this feature. See Review Job Status.
Once Prevalidation succeeds, the request status will change to Waiting for User to Register Environment. At this point, you can review the Discovery Report and ensure that all artifacts identified by this process are consistent with your environment.
To review the Discovery Report, navigate to the Discovery Requests page. Click the View Discovery Report icon in the Compliance column associated with your environment.
In the report, each row corresponds to a standard listed in My Oracle Support Knowledge Document 2656874.1, Standards Used by the Oracle E-Business Suite Cloud Manager for Provisioning Oracle E-Business Suite on Oracle Cloud Infrastructure. Each row containing a standard includes the following information:
Expected Result
Actual Result
Status - Either a green check mark to indicate compliance or a red 'X' to indicate non-compliance.
Explanation - For cases of non-compliance, a description of the standard that the environment must meet.
If the Discovery Report indicates that your environment does not meet the standards for discovery, you can make the necessary changes and resubmit the discovery request. To do so, click Submit Discovery Request in the Discovery Requests page. See Submit a Discovery Request.
After you submit another request for the same environment, your initial request appears in the Discovery Requests page with a status of Superseded by discover request <environment name>.
If the Discovery Report indicates that your environment meets the standards for discovery, you can proceed to register your environment. An environment that is compliant and ready to be registered appears with the status Waiting for User to Register Environment.
Click the Actions icon and select Register Environment. In the Register Environment window, enter the APPS user password and click Register.
The message Successfully submitted registration request appears on the Discovery Requests page. The status then changes to Discovery Input Validation in Progress.
After the registration completes, the status of the request changes to Discovery Successful.
Prior to making a major change to your environment, you must unregister it. After the change is complete, you can rediscover the environment in order to record the updates within Oracle E-Business Suite Cloud Manager.
When you unregister an environment, the metadata for the environment is removed from Oracle E-Business Suite Cloud Manager. This process does not delete the environment itself.
Note: Single VM instances, such as instances provisioned by the One-Click Provisioning feature, cannot be registered or unregistered.
To Unregister an Environment
Click the Navigator icon and select Environments.
Navigate to the Environment Details page for the environment that you want to unregister by clicking the environment name link.
Click Unregister.
The Confirm Unregister window appears. Enter the environment name to confirm your choice. Then click Yes.
Note: After you complete the unregister action, you can no longer view or manage the environment in Oracle E-Business Suite Cloud Manager. If you would like to continue using Cloud Manager, review Rediscover an Updated Environment for guidance prior to making your desired change.
If your environment is managed by the Oracle E-Business Suite Cloud Manager, you must unregister the environment prior to making a major change, then rediscover it after the change is complete in order to record the updates within Oracle E-Business Suite Cloud Manager. Here are common scenarios where this applies:
When performing an Oracle E-Business Suite, Oracle Database, or Oracle Linux upgrade.
When changing the environment configuration. Examples include adding a load balancer, increasing the size of the block volume attached to an application or database tier node, or adding or deleting a node.
Complete the following steps to update your environment:
Unregister your environment (see Unregister an Environment).
Perform the update.
Submit a new discovery request (see Submit a Discovery Request).
Register the updated environment (see Register a Compliant Environment).
Important Notes
Check the Oracle E-Business Suite Cloud Manager registration settings.
Before you proceed with rediscovering an updated environment, ensure that the Resource Owner option is selected under the Allowed Grant Types in the registration of Oracle E-Business Suite Cloud Manager as an application in Oracle Identity Cloud Service (IDCS). See Register Oracle E-Business Suite Cloud Manager as a Confidential Application.
Configure the load balancer (conditional).
If you plan to upgrade your Oracle E-Business Suite environment from Release 12.1.3 to Release 12.2 using a new VM separate from the VM where the Release 12.1.3 environment is located, then you must perform the corresponding load balancer configuration after the upgrade and prior to submitting the discovery request. See "Upgrading to Oracle E-Business Suite Release 12.2" in My Oracle Support Knowledge Document 2517025.1, Getting Started with Oracle E-Business Suite on Oracle Cloud Infrastructure.
If you plan to perform the Oracle E-Business Suite upgrade on the same VM as the Release 12.1.3 environment, then you do not need to change the load balancer configuration.
Make note of the database node IP address and context file location (conditional).
If you plan to perform an in-place Oracle E-Business Suite or Oracle Database upgrade where your application tier or database tier will not change, make note of the database node IP address and context file location prior to proceeding with the unregister process. You will use these settings when you submit a new discovery request prior to registering your updated environment.