introduction to oracle e-business suite cloud manager · 2019-10-23 · oracle e-business suite...

Introduction to Oracle E-Business Suite Cloud Manager Hands-On Lab

October 2019 v2

Santiago Bastidas Product Management Director

Terri Noyes Sr. Product Management Director

Contents

Disclaimer................................................................................................................................................................ 3 About This Hands-On Lab and Workbook .............................................................................................................. 4 Prepare for Workshop Exercises ............................................................................................................................ 5

Review Prerequisites .......................................................................................................................................... 5 Set Up Lab Workstation ...................................................................................................................................... 5

Using a Windows Workstation .................................................................................................................... 5 Using a Mac Workstation ............................................................................................................................ 6

Review and Open Hands-On Lab Files .............................................................................................................. 6 Terminology............................................................................................................................................................. 7 Workshop Overview ................................................................................................................................................ 8

Accounts for Hands-On Lab Exercises .............................................................................................................. 9 Exercise 1: Sign Up and Log in to Your Trial Tenancy ......................................................................................... 10

1.1 Sign Up for a Trial Account......................................................................................................................... 10 1.2 Record User Details ................................................................................................................................... 10

Exercise 2: Create Oracle Cloud Infrastructure Resources.................................................................................. 11 Exercise 3: Create Oracle E-Business Suite Cloud Manager Compute Instance ................................................ 17

3.1 Sign in to the Oracle Cloud Infrastructure Console .................................................................................... 17 3.2 Create a Compute Instance Using a Marketplace Image .......................................................................... 18

Exercise 4: Configure and Log in to Oracle E-Business Suite Cloud Manager ................................................... 21 4.1 Copy the OCI API Key and Connect to Your Cloud Manager Compute Instance ..................................... 21

4.1.1 For Windows Users ......................................................................................................................... 21 4.1.2 For Mac Users ................................................................................................................................. 28

4.2 Run the Configuration Script ...................................................................................................................... 28 4.3 Create Groups and Users in IDCS ............................................................................................................. 31 4.4 Register Oracle E-Business Suite Cloud Manager as a Confidential Application ..................................... 34 4.5 Finalize the Configuration ........................................................................................................................... 37 4.6 Log in to Oracle E-Business Suite Cloud Manager .................................................................................... 39

Exercise 5: Create the Network for the Oracle E-Business Suite Environments ................................................. 41 5.1 Create Default Network and Network Profiles Using ProvisionOCINetwork.pl ......................................... 41 5.2 Upload Network Profile Definitions Using UploadOCINetworkProfile.pl .................................................... 42

Exercise 6: Provision Your Oracle E-Business Suite Environment ...................................................................... 44 6.1 Log in to Oracle E-Business Suite Cloud Manager .................................................................................... 44 6.2 Provision an Environment Using One-Click Provisioning........................................................................... 44 Demo 1: Lift and Shift Part 1 ............................................................................................................................ 44 6.3 Enable and Set Oracle E-Business Suite Account Passwords .................................................................. 45 6.4 Configure Local Hosts File and Log in to Oracle E-Business Suite ........................................................... 45

Exercise 7: Clone Your Oracle E-Business Suite Environment............................................................................ 48 7.1 Access the Clone Environment Page ......................................................................................................... 48 7.2 Enter Details on the Clone Environment Page ........................................................................................... 48 7.3 Configure Local Hosts File for the Cloned Environment and Log in to Oracle E-Business Suite .............. 49 Demo 2: Lift and Shift Part 2 ............................................................................................................................ 50

Disclaimer

This following is intended to outline our general product direction. It is intended for information purposes only and may

not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should

not be relied upon in making purchasing decisions. The development, release, and timing of any features or

functionality described for Oracle’s products remains at the sole discretion of Oracle.

About This Hands-On Lab and Workbook

Approximately 2.5 hours are required to complete this workshop.

This workshop showcases the use of the Oracle E-Business Suite Cloud Manager graphical user

interface to provision and clone environments on Oracle Cloud Infrastructure. In addition, a

demonstration of the lift and shift of an on-premises Oracle E-Business Suite environment to Oracle

Cloud Infrastructure will be conducted.

Notes:

• The workshop is quite detailed and technical. PLEASE take your time and DO NOT skip any steps.

• IP addresses and URLs in the screenshots in this workbook may differ from what you use in the labs as these are dynamically generated.

• For security purposes, some sensitive text (such as IP addresses) may be redacted in the screenshots in this workbook.

The following describes the formatting used in this workbook:

Text in a blue box such as this includes additional information explaining the exercise or tasks.

UNIX commands (usually executed in an SSH session using PuTTY) are displayed in a monospace font

within a gray box, as follows:

$ sudo yum install wget -y

$ wget -O bitnami-mean-linux-installer.run

https://bitnami.com/stack/mean/download_latest/linux-x64

Prepare for Workshop Exercises

Review Prerequisites

You will need the following in order to complete this workshop:

• A laptop with the following: o A modern browser o A secure remote login (Secure Shell, or SSH) utility

▪ Such as PuTTY - downloaded from https://www.ssh.com/ssh/putty/download o A secure copy program

▪ Such as WinSCP - downloaded from https://winscp.net/eng/index.php • Knowledge of basic UNIX commands

Set Up Lab Workstation

In this section, you will prepare your workstation with the required files for the hands-on lab exercises.

Your instructor will provide you a USB flash drive (or provide a download link) with these files.

Proceed to the appropriate section, depending on your workstation operating system:

• Using a Windows Workstation

• Using a Mac Workstation

Using a Windows Workstation

1. Create a folder named HOL-EBS on the desktop of your workstation.

2. Perform either step (a) or (b):

a. Plug in the USB flash drive into your workstation. b. If you are using the download link:

i. Download the HOL zip file into a temporary location (such as in \Documents\HOL-

Download).

ii. Unzip the files.

3. Open Windows Explorer and navigate to the mounted USB flash drive or unzipped HOL files.

4. Copy the directory HOL-EBS and all files from the USB flash drive or temporary unzipped file location and

paste to the Desktop\HOL-EBS folder on your workstation.

https://www.ssh.com/ssh/putty/download

https://winscp.net/eng/index.php

Using a Mac Workstation

1. Create a folder named HOL-EBS on the desktop of your workstation.

2. Perform either step (a) or (b):

a. Plug in the USB flash drive into your workstation. b. If you are using the download link:

i. Download the HOL zip file into a temporary location (such as in /Documents/HOL-

Download).

ii. Unzip the files.

3. Open Finder and navigate to the mounted USB flash drive or unzipped HOL files.

4. Copy the directory HOL-EBS and all files from the USB flash drive of temporary unzipped file location and

paste to the Desktop/HOL-EBS folder on your workstation.

Review and Open Hands-On Lab Files

The following table describes the directories and files that were copied to the Desktop\HOL-EBS directory on

your workstation:

Table S-1

Name Description /documents/EBS-HOL-Workbook-

September-2019.pdf A digital copy of this workbook, Introduction to Oracle E-Business Suite Cloud Manager Hands-On Lab.

/documents/Key-Data.txt The document used to capture key data items needed throughout the lab.

/artifacts/oci-api-keys Keys used to authenticate API calls to Oracle Cloud Infrastructure.

/artifacts/ssh-keys Keys used to establish an SSH session with Oracle E-Business Suite Cloud Manager Compute instance.

/artifacts/terraform Set of Terraform scripts which automate the creation of the infrastructure required to deploy Oracle E-Business Suite Cloud Manager.

Terminology

The following terms are commonly employed in Oracle E-Business Suite cloud operations and used

throughout our documentation:

Availability Domain – One or more data centers located within a region.

Bucket – A logical container used by Object Storage for storing your data and files. A bucket can

contain an unlimited number of objects.

Compartments – Allows you to organize and control access to your cloud resources. A

compartment is a collection of related resources (such as instances, virtual cloud networks, block

volumes) that can be accessed only by certain groups.

Oracle E-Business Suite Cloud Backup Module – The Oracle E-Business Suite Cloud Backup

Module is a stand-alone tool that interviews the user to establish settings, and then uses those

settings to back up an Oracle E-Business Suite environment to Oracle Cloud Infrastructure Object

Storage.

Oracle E-Business Suite Cloud Manager - Oracle E-Business Suite Cloud Manager is a graphical

user interface used for creating, managing, and configuring Oracle E-Business Suite environments

on Oracle Cloud Infrastructure. Oracle E-Business Suite Cloud Manager can be used with the

Oracle E-Business Suite Cloud Backup Module to lift and shift or clone environments from on-

premises to Oracle Cloud Infrastructure.

EBS Cloud Manager infrastructure – Virtual network resources, compute resources, and policies

required to run EBS Cloud Manager on Oracle Cloud Infrastructure.

EBS Sandbox Virtual Cloud Network (VCN) – Networking and compute resources required to run

EBS on Oracle Cloud Infrastructure. The EBS Sandbox VCN includes the recommended

networking resources (VCN, subnets routing tables, internet gateway, security lists, and security

rules) to run Oracle E-Business Suite on OCI.

Oracle Cloud Infrastructure Load Balancing Service - The Oracle Cloud Infrastructure Load

Balancing service provides automated traffic distribution from one entry point to multiple servers

reachable from your virtual cloud network (VCN). The service offers a load balancer with your

choice of a public or private IP address, and provisioned bandwidth.

Oracle Cloud Infrastructure (OCI) – Combines the elasticity and utility of public cloud with the

granular control, security, and predictability of on-premises infrastructure to deliver high-

performance, high availability, and cost-effective infrastructure services.

Region – Oracle Cloud Infrastructure are hosted in regions, which are located in different

metropolitan areas. Regions are completely independent of other regions and can be separated by

vast distances – across countries or even continents. Generally, you would deploy an application in

the region where it is most heavily used, since using nearby resources is faster than using distant

resources.

Tenancy – When you sign up for Oracle Cloud Infrastructure, Oracle creates a tenancy for your

company, which is a secure and isolated partition within Oracle Cloud Infrastructure where you can

create, organize, and administer your cloud resources.

Virtual Cloud Network (VCN) – A virtual version of a traditional network – including subnets, route

tables, and gateways – on which your instances run. A cloud network resides within a single region,

but can cross multiple availability domains.

Workshop Overview

The following figure (W-1) outlines the workshop architecture.

Figure W-1: Workshop Architecture

This workshop uses the following components:

• Trial accounts (one per attendee) o Virtual Cloud Network and related resources

▪ User-generated using Resource Manager and provided Terraform script o Oracle E-Business Suite Cloud Manager Compute instance

▪ User-provisioned using Oracle Marketplace image ▪ Oracle E-Business Suite Cloud Manager application ▪ EBS sandbox network deployment script

o Oracle E-Business Suite environment 1 Compute instance ▪ User-provisioned environment ▪ Application and database tiers on this compute instance

o Oracle E-Business Suite environment 2 Compute instance ▪ Cloned from environment 1 ▪ Application and database tiers on this Compute instance

• Attendee-provided laptop

The following figure (W-2) describes the exercises that you will perform in this workshop.

Figure W-2: Storyboard

Accounts for Hands-On Lab Exercises

The following table provides a list of user names, personas, and related roles that will be used

throughout the hands-on lab.

Table W-1: User Names and Personas

User Name Application Description

<trial user

name> Oracle Cloud

Infrastructure (OCI)

service console login

An IT administrator in your organization responsible

for managing the EBS environments

opc Linux OS Privileged Linux user used to connect to Compute

instances

oracle Linux OS Linux user owning the Oracle E-Business Suite

Cloud Manager binaries and configuration

Exercise 1: Sign Up and Log in to Your Trial Tenancy

Purpose: In this exercise, you will sign up for and log in to your private Oracle Cloud Infrastructure trial

account.

1.1 Sign Up for a Trial Account

1. From your laptop, go to oracle.com/cloud/free and click “Start for free”.

2. On the Oracle Cloud Sign Up page, enter the requested information including your desired tenancy name and tenancy password.

3. Review your details and click Submit.

Note: Ensure that you use the same email address used when you registered.

You will be directed to the Oracle Cloud Infrastructure console where you will execute the remainder of the lab.

1.2 Record User Details

1. Record your trial user name and password to Tenancy_Admin_User and Tenancy_Admin_Password

in your Key-Data.txt file.

You have now finished Exercise 1. Please wait for the instructor before proceeding with the next

exercise.

http://oracle.com/cloud/free

Exercise 2: Create Oracle Cloud Infrastructure Resources

Purpose: In this exercise, you will run a Terraform Script which will create the resources required to

deploy the Oracle E-Business Suite Cloud Manager, including:

• A compartment

• Group, policies, and a user

• Network resources – including a VCN, an internet gateway, subnets, route tables, security lists, and security rules

1. In the Oracle Cloud Infrastructure console navigation menu, select Resource Manager and then click Stacks.

2. In the COMPARTMENT drop-down list on the left side of your screen, select your root compartment.

3. Click Create Stack.

4. In the Create Stack dialog box: a. Click the Browse link to upload the Terraform zip file (found at Desktop/HOL-

EBS/artifacts/terraform/deploy-EBS-CM.zip).

b. Enter deploy-ebscm-hol-stack in the NAME field.

c. Enter a description. d. Verify the target compartment (and change if necessary). e. Click Next.

5. On the Configure Variables screen, verify the region and tenancy OCID and then click Next.

6. On the Review screen, verify the information and click Create.

7. This takes you to the Stack Details page for your newly created stack. On this page, click the Terraform Actions drop-down list and select Apply.

8. In the Apply dialog window, leave the default settings as-is and click Apply.

9. On the Job Details page, you will see the job status which will cycle through Accepted, In Progress, and

Succeeded.

After the job succeeds, you will have all the network resources (VCN, load balancer, subnets, and so on) required to deploy the Oracle E-Business Suite Cloud Manager Compute instance.

10. On the Job Details page under Resources, click Logs, and scroll through towards the end of the log to “Outputs”.

11. Copy and paste the keys and key values below Outputs into the Outputs section of your Key-Data.txt.

These variables are needed for the remainder of the procedures in this lab.


exercise.

Exercise 3: Create Oracle E-Business Suite Cloud Manager Compute Instance

Purpose: Create the Oracle E-Business Suite Cloud Manager Compute instance using an Oracle

Cloud Infrastructure Marketplace image.

3.1 Sign in to the Oracle Cloud Infrastructure Console

Use the newly created credentials created by the Terraform script in Exercise 2 to sign in to Oracle

Cloud Infrastructure console.

1. If you were logged in to the Oracle Cloud Infrastructure console, logout by clicking on the icon at the top right of your screen and click Sign Out.

2. Reference your Key-Data.txt file and locate the new Oracle E-Business Suite admin user credentials

created by the Terraform script.

3. Sign in to the Oracle Cloud Infrastructure console using the following:

• User name: Cloud_Manager_Admin_Username (which is ebscm.admin)

• Password: Cloud_Manager_Admin_Temporary_Password

4. Change your password and record your new Cloud_Manager_Admin_Password in the Key-

Data.txt file.

3.2 Create a Compute Instance Using a Marketplace Image

Perform these steps to create a Compute instance using an image in the Oracle Cloud Infrastructure

Marketplace.

1. In the Oracle Cloud Infrastructure console navigation menu, under Core Infrastructure, select Compute > Instances.

2. Under List Scope, choose ebs_hol_compartment from the COMPARTMENT drop-down list.

3. In the console navigation menu, under Solutions and Platform, select Marketplace.

4. Select the Oracle E-Business Suite Cloud Manager image.

5. On the Oracle E-Business Suite Cloud Manager page:

a. Leave the selected default Version as-is (Oracle-EBS-Cloud-Manager-19.2.1.2-2019.10.18). b. In the Compartment drop-down list, select ebs_hol_compartment. c. Select the checkbox to accept the Oracle Standard Terms and Restrictions. d. Click Launch Instance.

6. In the Create Compute Instance dialog box:

a. Under Name your instance, enter your choice of name. Enter the name: ebscm-hol-instance.

b. Under Choose an operating system or image source, you will see the name of the OCI

Console Marketplace image: Oracle E-Business Suite Cloud Manager.

c. Under Availability Domain, select AD 1.

d. Under Instance Type, select Virtual Machine.

e. Under Instance Shape, select VM.Standard2.2.

f. Under Configure networking: i. From the Virtual cloud network compartment drop-down list, select the compartment

ebs_hol_compartment that was created by the Terraform script. ii. From the Virtual cloud network drop-down list, choose the VCN (EBS Cloud Manager

HOL VCN) that was created by the Terraform script. iii. Under Subnet compartment, specify ebs_hol_compartment again. iv. Under Subnet, specify EBS Cloud Manager Subnet (Regional). v. Select the Assign public IP address radio button.

g. Under Boot volume, accept the default volume size (46.6 GB).

h. Under Add SSH key:

i. Select the Choose SSH key file radio button and click Choose Files. ii. Locate and select the provided SSH public key file in your ssh-keys folder (under

Desktop\HOL-EBS\artifacts\ssh-keys\ebs_hol_key.pub).

i. Click Create at the bottom of the screen.

7. After the instance has been created (provisioned), it will appear in the instance list. To view the full details

of the instance, click the instance name in the list.

8. Copy the public IP address of the newly created instance (as seen in the previous image) and paste it in

your Key-Data.txt file.


exercise.

Exercise 4: Configure and Log in to Oracle E-Business Suite Cloud Manager

Purpose: Configure Oracle E-Business Suite Cloud Manager and generate log in URL.

4.1 Copy the OCI API Key and Connect to Your Cloud Manager Compute Instance

4.1.1 For Windows Users

1. Launch WinSCP.

2. In the Session section: a. In the File protocol drop-down list, select SCP. b. In the Host name field, enter the public IP address of the Oracle E-Business Suite Cloud

Manager Compute instance. c. In the Port field, enter 22.

d. In the User name field, enter opc.

3. Click Advanced to display the Advanced Site Settings window.

4. In the navigation pane on the left, select SSH > Authentication.

5. Under Authentication parameters, click the ellipses (…) to browse for the private key file (Desktop\HOL-EBS\artifacts\ssh-keys\ebs_hol_key.ppk).

6. Click OK. This returns you to the Login-WinSCP window.

7. Click Login.

8. In the Warning message which displays, click Yes.

9. On the left side of the WinSCP screen, navigate to Desktop\HOL-EBS\artifacts\oci-api-keys.

10. Drag and drop the oci_api_key.pem file from the left pane to the right (in the white space underneath

the .. directory). Confirm the location in the pop-up window.

11. Launch PuTTY.

12. In the Category pane click Session to view “Basic options for your PuTTY session.” a. Under “Specify the destination you want to connect to,” enter the following:

i. In the Host Name (or IP address) field, enter IP address of the Oracle E-Business Suite Cloud Manager Compute instance captured in the previous exercise (found in your Key-

Data.txt file).

ii. In the Port field, enter 22. iii. Ensure under Connection type, the SSH radio button is selected.

13. In the Category pane, click Connection > Data and specify opc in the field “Auto-login username”.

14. In the Category pane, click Connection > SSH > Auth to view “Options controlling SSH authentication.” a. Under “Authentication parameters” click Browse. b. Navigate to the key files found under Desktop\HOL-EBS\artifacts\ssh-

keys\ebs_hol_key.ppk.

15. Return to the Category pane and click Session.

16. Under “Load, save or delete a stored session” in the Saved Sessions field, enter ebscm-instance.

17. Click Save to save the session details for future use.

18. Click Open.

19. In the PuTTY Security Alert pop-up window, click Yes.

20. From the PuTTY session window, execute the following commands:

$ sudo mkdir /u01/install/APPS/.oci

$ sudo cp oci_api_key.pem /u01/install/APPS/.oci

$ sudo chown -R oracle:oinstall /u01/install/APPS/.oci

4.1.2 For Mac Users

1. On your Mac, open the Terminal application.

2. Using your Terminal session, go to the directory where the artifact files were extracted.

$ cd ~/Desktop/HOL-EBS/artifacts/ssh-keys

3. Change the permissions to the ebs_hol_key file as follows:

$ chmod 400 ebs_hol_key

4. Enter the following command to copy the oci-api-key, which will produce the following output.

$ scp -i ebs_hol_key ../oci-api-keys/oci_api_key.pem

opc@<public_ip_EBS_CM>:~/.

oci_api_key.pem 100% 1679 24.2KB/s 00:00

5. Enter the following command to connect to the server:

$ ssh -i ebs_hol_key opc@<public_ip_address_of_your_CM_Compute_instance>

For example:

$ ssh -i ebs_hol_key [email protected]

6. Now, execute the following commands:

$ sudo mkdir /u01/install/APPS/.oci

$ sudo cp oci_api_key.pem /u01/install/APPS/.oci

$ sudo chown -R oracle:oinstall /u01/install/APPS/.oci

4.2 Run the Configuration Script

While still connected through your SSH client to your Oracle E-Business Suite Cloud Manager

Compute instance, perform the following steps:

1. As the oracle user, run the configure.pl script:

$ sudo su - oracle

$ cd /u01/install/APPS/apps-unlimited-ebs/bin

$ perl configure.pl

2. Note the creation of the session-specific log file and enter the Cloud_Manager_Admin_Password from

your Key-Data.txt file:

Log File : /u01/install/APPS/apps-unlimited-ebs/out/configure_2019-09-

17_16_30_29.log

=============================================================

Configuring Oracle E-Business Suite Cloud Manager VM 19.2.1.1

=============================================================

This is a fresh install.

Creating SSH key pair.

Specify New Oracle E-Business Suite Cloud Manager Admin Password :

< Cloud_Manager_Admin_Password>

Re-enter New Oracle E-Business Suite Cloud Manager Admin Password :

< Cloud_Manager_Admin_Password >

3. Enter account and user details required for authentication, substituting values from your Key-Data.txt

file:

Enter Oracle E-Business Suite Cloud Manager Admin User OCID (Non

Federated) : <Cloud_Manager_Admin_User_OCID>

Enter Absolute Path to API Private Signing Key :

<OCI_API_Key_Path>

Enter Tenancy OCID :

<Tenancy_OCID>

4. Select the option corresponding to the ebs_cm_administrators_group.

Available Groups from OCI for provided User:

Group Name Description

---------- -----------

1: ebs_hol_dbas_group EBS HOL DBAs Group

2: ebs_cm_administrators_group EBS Cloud Manager Administrators Group

3: network_administrators_group Network Administrators Group

Choose E-Business Suite Cloud Administrator Group from above list: 2

5. You will now be asked if you wish to use an existing load balancer. Select option 2: No.

Do you wish to use an existing Load Balancer?

1: Yes

2: No

Enter your choice: 2

6. Select option 1: Public for the the load balancer visibility type.

Choose Load Balancer Visibility Type:

1: Public

2: Private


7. Select option 2: 100Mbps for the load balancer shape.

1: 10Mbps-Micro

2: 100Mbps

3: 400Mbps

4: 8000Mbps

Choose Load Balancer Shape from above list: 2

8. Now, choose your subnet. Enter 1.

Available List of Subnets:

Regional ( recommended ):

------------------------------

1: EBS Cloud Manager LB Regional Subnet

Choose subnet from above list: 1

9. Then, enter your Load Balancer Listener Port and CIDR Block.

Enter Load Balancer Listener Port : 443

Enter CIDR Block (Range) from which Client can Access Load Balancer Listener

Port: 0.0.0.0/0

10. You will see a review screen displaying the values you have chosen and be asked if you wish to continue. Choose 1 for Yes.

Do you wish to continue?

1: Yes

2: No


11. As the Terraform script only created one security list, it is automatically selected. You will then see a screen containing a success message and the load balancer URL. You will need the load balancer URL later in this lab, so record this in the Key-Data.txt file under Cloud_Manager_URL.

========================================================================

Load Balancer ebscm-hol-instance-prov-vm-lbaas configuration completed.

========================================================================

=============================================================================

Register application in IDCS with the URL: https://129.213.14.2:443 and then

re-run this script to update your IDCS configuration.

=============================================================================

4.3 Create Groups and Users in IDCS

Create a new group and user for use with the Oracle E-Business Suite Cloud Manager.

1. As the Tenancy Administrator, log in to the Oracle Cloud Infrastructure console.

2. In the Oracle Cloud Infrastructure console menu, under Governance and Administration, navigate to Identify > Federation.

3. Click on the link next to Oracle Identity Cloud Service Console.

4. From the IDCS console, create your Oracle E-Business Suite Cloud Manager group: a. Click the navigation menu and select Groups. b. Click the Add button. c. In the Add Group dialog box (Step 1: Group Details), supply the following information:

i. Name: Enter the name idcs-ebscm-grp

ii. Description: Enter a description of your choice. d. Click Finish.

5. While still in the IDCS console, create your Oracle E-Business Suite Cloud Manager Administrator user:

a. Click the navigation menu and select Users. b. Click Add. c. In the Add User dialog box (Step 1: Add User Details), supply the following information:

i. First Name: Enter EBS Cloud Manager

ii. Last Name: Enter Administrator

iii. User Name: Enter ebscm.admin

iv. Email: Use the same email addressed you used when registering. v. Deselect the check box Use email address as the user name.

d. Click Next.

e. On the Step 2: Assign User to Groups dialog window, select the check box for the group you just created (idcs-ebscm-grp).

f. Click Finish.

6. From the IDCS console navigation menu, click Security to expand the menu. Then click Administrators.

7. On the Administrators page:

a. Expand the Application Administrators section. b. Click Add.

8. In the Add Users to the Administrator Role dialog box, select the check box for the EBS Cloud Manager Administrator (ebscm.admin).

9. Click OK.

Note: The Cloud Manager administrator will register the app as a confidential application in the next section.

10. Log out of the IDCS console by clicking on your user avatar icon at the top right of your screen. Then, click Sign Out.

4.4 Register Oracle E-Business Suite Cloud Manager as a Confidential Application

Note: The ebscm.admin performs the tasks in this section.

In this section, you will register the Oracle E-Business Suite Cloud Manager as a Confidential Application.

1. Open the Welcome email that was received in the previous section.

2. Click the yellow Activate Your Account button in the email.

3. Enter a new password, confirm, and click Submit. We suggest you reuse the password from Key-Data.txt, field Cloud_Manager_Admin_Password.

4. Click OK to continue, which will take you to the IDCS Login screen.

5. Enter the EBS Cloud Manager user name (ebscm.admin) and password you just entered in the

previous screen to log in.

6. Click on your user avatar menu in the top right corner. This will display a drop-down menu.

7. Select Admin Console. This will display the IDCS Administration Console.

8. In the top right of the Applications tile, click the icon to Add an Application.

9. Select Confidential Application. This takes you to the Add Confidential Application page.

10. On the Details screen, enter the following: a. Name: Enter Oracle E-Business Suite Cloud Manager

b. Description: Enter a description. c. Click Next.

11. On the Client screen: a. Select Configure this application as a client now. b. Under Allowed Grant Types, select the following check boxes:

i. Client Credentials ii. Refresh Token iii. Authorization Code

c. Redirect URL: <Cloud_Manager_URL>/cm/auth/callback

d. Logout URL: Leave this field empty. e. Post-Logout Redirect URL: <Cloud_Manager_URL>/cm/ui/index.html?root=login

f. Select the Introspect option for Allowed Operations. g. Under Grant the client access to Identity Cloud Service Admin APIs:

i. Click Add. ii. Select Identity Domain Administrator and Me in the pop-up window. iii. Click Add again.

h. Click Next.

12. On the Resources screen, click Next.

13. On the Web Tier Policy screen, click Next.

14. On the Authorization screen, click Finish.

15. Make a note of the following values in your Key-Data.txt file (under Client_ID and

Client_Secret, respectively) when they are displayed in a pop-up window:

o Client ID o Client Secret

16. Click Close.

17. Click Activate to activate the Confidential Application.

18. Identify your IDCS Client Tenant by selecting the first element of the URL in your browser. Record this URL as Client_Tenant in the Key-Data.txt.

Your IDCS Client Tenant begins with the characters idcs- and then is followed by a string of

numbers and letters, for example, idcs-6572bfeb183b4becad9e649bfa14a488.

4.5 Finalize the Configuration

While still connected through your SSH client to your Oracle E-Business Suite Cloud Manager

Compute instance, perform the following steps:

1. As the oracle user, run the configure.pl script again:


$ perl configure.pl

2. Enter the Oracle E-Business Suite Cloud Manager Admin Password:

Log File : /u01/install/APPS/apps-unlimited-ebs/out/ConfigureOrcVM_2019-04-

03_22_50_45.log

====================================================

Configuring Oracle E-Business Suite Cloud Manager VM

====================================================

This is a fresh install.

Enter Oracle E-Business Suite Cloud Manager Admin Password :

<Cloud_Manager_Admin_Password>

Re-enter Oracle E-Business Suite Cloud Manager Admin Password :

<Cloud_Manager_Admin_Password>

3. Enter the details of your application in IDCS. The values you will need to enter for Client ID and Client Secret were established when you registered the Oracle E-Business Suite Cloud Manager as a confidential application in the previous exercise (refer to your Key-Data.txt file).

Enter IDCS Client ID : <Client_ID>

Enter IDCS Client Secret : <Client_Secret>

Enter IDCS Client Tenant : <Client_Tenant>

4. You will see the summary screen containing the information you specified earlier:

-----------------------------------------------------------------------------

Summary of Inputs

-----------------------------------------------------------------------------

Enter IDCS Client ID : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Enter IDCS Client Secret : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Enter IDCS Client Tenant : client tenant

IDCS Host : https://idcs-

xxxxxxxxxxxxxxxxxxxxxx.identity.oraclecloud.com

-----------------------------------------------------------------------------

Do you wish to continue?

1: Yes

2: No


5. A Login URL is then displayed on the screen. This is the URL by which users will access the Oracle E-

Business Suite Cloud Manager UI. Save this Login URL (which you will use in section 4.7) in your Key-

Data.txt file.

=============================================================================

Finished Configuring Oracle E-Business Suite Cloud Manager VM.

Login URL : https://129.213.14.2:443

Ensure the trusted application is correctly configured in IDCS as per the

documentation.

=============================================================================

4.6 Log in to Oracle E-Business Suite Cloud Manager

1. Using the Login URL generated previously, log into the Oracle E-Business Suite Cloud Manager using your IDCS credentials as found in your Key-Data.txt file.

2. Once logged in, you are on the Environments page.


exercise.

Exercise 5: Create the Network for the Oracle E-Business Suite Environments

Purpose: Create a network and network profile, and upload the profile to use in provisioning your

Oracle E-Business Suite environments.

5.1 Create Default Network and Network Profiles Using ProvisionOCINetwork.pl

1. While still connected as the oracle user, run ProvisionOCINetwork.pl:


$ perl ProvisionOCINetwork.pl

2. The screen will display the name of the log file for this session in the format ProvisionOCINetwork_<Date_and_Time_Stamp>.log:

Log File : /u01/install/APPS/apps-unlimited-

ebs/out/ProvisionOCINetwork_Wed_Mar_27_14_42_07_2019.log

3. After a list of the subnets to be created is displayed, you will be prompted to select Y to proceed or N to exit. Enter Y:

Enter Y to proceed or N to exit: Y

4. You will now enter your details, substituting your own values with the ones found in your Key-

Data.txt:

Enter user ocid : <Cloud_Manager_Admin_User_OCID>

Enter absolute path of private key of API signing key : <OCI_API_Key_Path>

Enter tenancy ocid : <Tenancy_OCID>

Validating user and fetching OCI metadata…

Enter unique identifier for the EBS network : ebsenvnet

Enter EBS subnet 1 CIDR (E.g. 10.0.1.0/24) : <EBS_apps_CIDR_subnet>

Enter EBS subnet 2 CIDR (E.g. 10.0.2.0/24) : <EBS_db_CIDR_subnet>

Enter LBaaS subnet 1 CIDR (E.g. 10.0.3.0/24) : <EBS_lbaas_CIDR_subnet1>

Enter LBaaS subnet 2 CIDR (E.g. 10.0.4.0/24) : <EBS_lbaas_CIDR_subnet1>

Enter DB Backup subnet CIDR (E.g. 10.0.5.0/24) : <EBS_dbbackup_subnet>

5. You will now be prompted to select Y to proceed or N to exit. Enter Y:

Are you sure you want to proceed with the above inputs? [Y/N]: Y

6. When processing is complete, you will see a success screen with content similar to the following:

Oracle EBS Cloud related network created successfully.

List of resources created:

ebsenvnet_lbaas_subnet_ad2

ebsenvnet_lbaas_subnet_ad1

ebsenvnet_lbaas_seclist

ebsenvnet_lbaas_routetable

ebsenvnet_db_subnet_ad1

ebsenvnet_db_seclist

ebsenvnet_db_routetable

ebsenvnet_dbbackup_subnet_ad1

ebsenvnet_apps_subnet_ad1

ebsenvnet_apps_seclist

ebsenvnet_apps_routetable

Program: ProvisionOCINetwork.pl completed at Wed Mar 27 14:46:52 2019

Advanced Network Profile JSON Path: /u01/install/APPS/apps-unlimited-

ebs/build/ebsenvnet/ebsenvnet_DEFAULT_PROFILE_ADVANCED.json

OneClick Network Profile JSON Path: /u01/install/APPS/apps-unlimited-

ebs/build/ebsenvnet/ebsenvnet_DEFAULT_PROFILE_ONECLICK.json

Execute /u01/install/APPS/apps-unlimited-ebs/bin/UploadOCINetworkProfile.pl

to Upload JSON into DB.

5.2 Upload Network Profile Definitions Using UploadOCINetworkProfile.pl

Now you will run the upload script for the One-Click Provisioning default network profile.

1. While still connected as the oracle user, run the UploadOCINetworkProfile.pl script:

$ perl UploadOCINetworkProfile.pl

2. The screen will display the name of the log file for this session in the format ProvisionOCINetwork_<Date_and_Time_Stamp>.log, as illustrated by this example:

Log File : /u01/install/APPS/apps-unlimited-

ebs/out/UploadOCINetworkProfile_Thu_Jul_11_13_55_49_2019.log

3. You will now enter your details, substituting your own values for the example values shown:

Enter Network Profile JSON File Absolute Path : <Copy from

OneClick Network Profile JSON Path output by the previous command>

Enter User OCID :

<Cloud_Manager_Admin_User_OCID>

Enter Absolute path of private key of API signing key :

<OCI_API_Key_Path>

Enter Tenancy OCID : <Tenancy_OCID>

Enter Oracle E-Business Suite Cloud Manager Admin Password : < Cloud_Manager_Admin_Password>

4. When a profile has been updated, you will see a success message.

Executing: ebscm_add_default_network_profile API for DEFAULT_PROFILE_ONECLICK

Executing Stored Procedure: ebscm_add_default_network_profile

RetCode: 0

Row count: 0

ONECLICK Network Profile uploaded successfully.


exercise.

Exercise 6: Provision Your Oracle E-Business Suite Environment

Purpose: Use the One-Click Provisioning feature of Oracle E-Business Suite Cloud Manager to

provision an Oracle E-Business Suite environment.

6.1 Log in to Oracle E-Business Suite Cloud Manager

1. Navigate to your Oracle E-Business Suite Cloud Manager application using the Login URL recorded in your Key-Data.txt file.

2. Log in with your Oracle Identity Cloud Service credentials.

6.2 Provision an Environment Using One-Click Provisioning

1. On the Oracle E-Business Suite Cloud Manager Environments page, click Provision Environment and select One-Click.

2. Enter and select the following details for your new environment. o Environment Name: ebsholenv1

o Purpose: Vision Demo Install o EBS Version: 12.2.8 o DB Version: 12.1.0.2

3. Click Submit.

You can check the status of the activity to provision the environment in the Activities page. The

provisioning process will take approximately 20-25 minutes.

Demo 1: Lift and Shift Part 1

As you wait for the provisioning process to complete, your instructor will demo the first part of the lift

and shift process.

After the demonstration and provisioning on your machine is successful, you will proceed to section 6.3.

6.3 Enable and Set Oracle E-Business Suite Account Passwords

Perform the following steps:

1. SSH to the newly created environment by following the instructions under “Administrator Access” in section “Access Your Oracle E-Business Suite Environment” in the Oracle by Example tutorial: Performing Post-Provisioning and Post-Cloning Tasks for Oracle E-Business Suite on Oracle Cloud Infrastructure.

2. As the oracle user, set the environment using the following command:

$ . /u01/install/APPS/EBSapps.env run

3. To log in through the web interface, you must initially set a password of your choice for the SYSADMIN

user. After the SYSADMIN user is active with the new password, you can create new users or activate

existing locked users. To enable the SYSADMIN user, run the following commands:

$ mkdir -p ~/logs

$ cd ~/logs

$ sh /u01/install/APPS/scripts/enableSYSADMIN.sh

When prompted, enter a new password for the SYSADMIN user.

The SYSADMIN user can now connect to Oracle E-Business Suite through the web interface and

create new users or activate existing locked users.

4. For this Vision demo environment, you can run another script to unlock a set of 36 application users that are typically used when demonstrating Oracle E-Business Suite using the Vision database.

$ cd ~/logs

$ sh /u01/install/APPS/scripts/enableDEMOusers.sh

When prompted, enter a new password.

Do not run this script on a fresh or production environment.

For details about the default passwords set during installation, see Oracle E-Business Suite

Release 12.2: Standard Installation, Oracle E-Business Suite Installation Guide: Using Rapid

Install Release 12.2 (12.2.0).

6.4 Configure Local Hosts File and Log in to Oracle E-Business Suite

1. In the Oracle Cloud Infrastructure console, find the IP address for the Oracle E-Business Suite web entry point by navigating to Networking > Load Balancers.

https://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/compute-iaas/post_provisioning_tasks_for_ebs_on_oci/110_post_prov_cm_oci.html



https://docs.oracle.com/cd/E26401_01/doc.122/e22950/T422699g54568.htm#ig_default_pwds

2. On the Load Balancers page, you will find a load balancer named ebsholenv1-lbaas. Obtain the public IP address of this load balancer and record this in your Key-Data.txt file.

3. Edit the local hosts file on your laptop and add an entry.

a. For Windows users i. Navigate to Notepad in your start menu.

ii. Hover over Notepad, right-click, and select the option “Run as Administrator.”

iii. In Notepad, navigate to File > Open.

iv. Browse to C:\\Windows\System32\drivers\etc

v. Find the file hosts

vi. In the hosts file, scroll down to the end of the content.

vii. Add the following entry to the very end of the file:

<ip_address> <fully_qualified_domain_name>

viii. Save the file.

b. For Mac users i. Open a Terminal Window.

ii. Enter the following command:

$ sudo vi /etc/hosts

iii. Go to the last line and add the following entry:


iv. Save the file.

4. Log in to Oracle E-Business Suite: a. In your browser, navigate to the following URL:

https://ebsholenv1.example.com:8000/OA_HTML/AppsLocalLogin.jsp

b. When prompted, accept the warning concerning the certificate coming from an unauthorized

certificate authority as we are using a self-signed certificate. (You will change the certificate with your own when executing this procedure outside of this hands-on lab.)

c. On this page, you will log in to Oracle E-Business Suite.


exercise.

Exercise 7: Clone Your Oracle E-Business Suite Environment

Purpose: Use the Cloning feature of Oracle E-Business Suite Cloud Manager to clone your Oracle E-

Business Suite environment.

7.1 Access the Clone Environment Page

1. Navigate to the Cloud Manager Environments page.

2. For ebsholenv1, click Action and select Clone.

7.2 Enter Details on the Clone Environment Page

1. Enter the following values for the clone details: o Environment Name: ebsholenv2

o Source Apps Password: apps

o Source WebLogic Server password: welcome1

2. Choose Load Balancer as a Service (LBaaS) by selecting the Deploy New Load Balancer

check box.

3. Then, you must also select a shape in the Load Balancer Shape field.

4. Select 100Mbps.

5. Enter these values for the following Web Entry properties. o Protocol: https

o Hostname: ebsholenv2

o Domain: example.com

o Port: 443

o Web Access IP/CIDR: 0.0.0.0/0

6. Click Submit.

7. You can check the status of the activity to clone the environment in the Activities page. The new

environment is listed on the Environments page.

7.3 Configure Local Hosts File for the Cloned Environment and Log in to Oracle E-Business Suite

1. In the Oracle Cloud Infrastructure console, find the IP address for the Oracle E-Business Suite web entry point by navigating to Networking > Load Balancers.

2. On the Load Balancers page, you will find a load balancer named ebsholenv2-lbaas. Obtain the public IP address of this load balancer and record in your Key-Data.txt file.

3. Edit the local hosts file on your laptop and add an entry.

a. For Windows users i. Navigate to Notepad in your start menu. ii. Hover over Notepad, right-click, and select the option “Run as Administrator.” iii. In Notepad, navigate to File > Open. iv. And browse to C:\\Windows\System32\drivers\etc.

v. Find the file hosts.

vi. In the hosts file, scroll down to the end of the content.

vii. Add the following entry to the very end of the file:


viii. Save the file.

b. For Mac users i. Open a Terminal Window.

ii. Enter the following command:

$ sudo vi /etc/hosts

iii. Go to the last line and add the following entry:


c. Save the file.

4. Log in to Oracle E-Business Suite: a. In your browser, navigate to the following URL:

https://ebsholenv2.example.com:8000/OA_HTML/AppsLocalLogin.jsp.

b. When prompted, accept the warning concerning the certificate coming from an unauthorized

certificate authority as we are using a self-signed certificate. (You will change the certificate with your own when executing this procedure outside of this hands-on lab.)

c. On this page, you will log in to Oracle E-Business Suite.

This concludes the tasks for Exercise 7.

Demo 2: Lift and Shift Part 2

Now, your instructor will demo the second part of the lift and shift process.

Oracle Corporation, World Headquarters Worldwide Inquiries

500 Oracle Parkway Phone: +1.650.506.7000

Redwood Shores, CA 94065, USA Fax: +1.650.506.7200

Copyright © 2019, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, did including imply warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0116 Authors: EBS Development – Santiago Bastidas, Tiffany Morales, Terri Noyes Date last revised: October 21, 2019

C O N N E C T W I T H U S

blogs.oracle.com/oracle

facebook.com/oracle

twitter.com/oracle

oracle.com