Oracle Cloud Applications

Latin America Cloud Local Solution

Standard Infrastructure Installation Guide
for DBCS Customers

Version 5

Feb 2020

DISCLAIMER:
This guide may contain screen shots and output reports to facilitate the user comprehension about the
topic. The content represents a fictitious sample. Any similarity to actual persons, living or dead, or
company names, active or inactive, is purely coincidental and not intended in any manner.
TABLE OF CONTENTS
TABLE OF CONTENTS ..............................................................................................................................................2

ABOUT THIS DOCUMENT .......................................................................................................................................4

INTENDED AUDIENCE ...................................................................................................................................................... 4

PLANNING THE LATIN AMERICA CLOUD LOCAL SOLUTION INFRASTRUCTURE INSTALLATION ................................5

STANDARD INFRASTRUCTURE TOPOLOGY FOR LATIN AMERICA CLOUD LOCAL SOLUTION ................................................... 5
SYSTEM REQUIREMENTS .......................................................................................................................................... 6
ROADMAP TO CONFIGURE A STANDARD INFRASTRUCTURE TOPOLOGY FOR LACLS ..................................................................... 8

CONFIGURING LATIN AMERICA CLOUD LOCAL SOLUTION STANDARD INFRASTRUCTURE ......................................9

CONFIGURING ORACLE DATABASE CLOUD SERVICES (DBCS) ................................................................................................. 9

CONFIGURING LACLS DATABASE SCHEMA WITH APEX AND ORDS ...................................................................................... 16
CONFIGURING ORACLE INTEGRATION CLOUD (OIC) ........................................................................................................... 27

VALIDATE LATIN AMERICA CLOUD LOCAL SOLUTION STANDARD INFRASTRUCTURE INSTALLATION ................... 39

TESTING OIC REST DATA SERVICE CONNECTION ............................................................................................................... 39

TESTING OIC ADAPTER CONNECTION ............................................................................................................................ 42

2
Revision History

This document will continue to evolve as existing sections change and new information is added.

Date What’s Changed Notes

24-Jun-2019 1 Creation
05-Sep-2019 2 Review
04-Oct-2019 3 Review
21-Feb-2020 4 Review process and requirements
27-Feb-2020 5 Review process and requirements

3
ABOUT THIS DOCUMENT

This document approach Provisioning and Setup steps to configure the infrastructure required to
support and run Latin America Cloud Local Solution (LACLS).

The purpose of this document is to define a roadmap to guide you through to set up and configure steps
for the Oracle Cloud Services required to support LACLS solutions. This document does not replace the
specific Oracle Documentation about Oracle Cloud Products covered in this guide.

INTENDED AUDIENCE

This document is intended for technical users, primarily database administrators, database application
developers and cloud infrastructure analysts who are new to LACLS. It assumes you have a working
knowledge of the following:

 The principles, common practices and rules of your business area;

 Computer desktop application usage and terminology;

 Oracle Cloud Infrastructure (OCI) fundamentals concepts and usage;

 Oracle database administration and Linux operating system.

If you are not used to Oracle Cloud Infrastructure concepts and usage, we suggest you attend one or
more of the Oracle Cloud training classes available through Oracle University.
PLANNING THE LATIN AMERICA CLOUD LOCAL SOLUTION INFRASTRUCTURE
INSTALLATION

STANDARD INFRASTRUCTURE TOPOLOGY FOR LATIN AMERICA CLOUD LOCAL SOLUTION

The Standard infrastructure for the Latin America Cloud Local Solution includes:

 Database Cloud Service (DBCS) instance, used for a LACLS repository.

 Oracle Integration Cloud (OIC) instance. Where the Integration Connectors and User Interface
are hosted.

 Oracle Financials Cloud instance. Where LACLS connects to reach transactional data.

Figure 1-1 LACLS Standard Infrastructure Topology

LACLS Standard Infrastructure Topology

ERP Services

HCM Supply
3rd party cloud
Oracle Integration Cloud Marketing Chain
Sales

Oracle DB Cloud Service

5
SYSTEM REQUIREMENTS

This document does not cover the provision of services or the installation of additional components of
DBCS and OIC required for LACLS solutions.

Before proceeding with the configuration steps described in the next sections of this guide, make sure
that all the SYSTEM REQUIREMENTS listed have been fulfilled.

1. Oracle Database Cloud Service (DBCS)

 Provide a DBCS instance

Provide a DBCS instance with the stated minimum recommended. Please refer to the Bare
Metal and Virtual Machine DB Systems Documentation for details about the provisioning of
this service.

Minimum recommended for the DBCS instance:

Edition Version Shape Type Shape DBCS Storage Management Software

Standard 18c or 19c Virtual Machine VM.Standard2.2 Oracle Grid Infrastructure
Enterprise 18c or 19c Virtual Machine VM.Standard2.2 Oracle Grid Infrastructure

Notes:

 A minimum of VM.Standard2.2 shape is recommended, regardless of whether it is a full

installation of LACLS solutions or only a partial installation in a production environment.
 For development and test environments, Shape VM.Standard2.1 is sufficient for most cases.

 Install and configure additional Database components (Mandatory)

Once the DBCS instance is provisioned, install and configure the mandatory APEX and ORDS
Standalone database components. Please refer to Installing Application Express and
Configuring Oracle REST Data Services for more details about this.

Minimum requirements for APEX and ORDS Standalone:

Component Version Download by

Oracle Application Express (APEX) 19.2.0.00.18 or higher https://www.oracle.com/downloads
Oracle REST Data Services (ORDS) 19.4.0.352.1226 or higher https://www.oracle.com/downloads

IMPORTANT:

 For the perfect integration of the database services, it is mandatory to configure a

secure port (https), for the REST/ORDS service.
 The use of a secure port (https) for the REST/ORDS service requires a digital certificate.
Oracle does not recommend the use of self-signed certificate in environments opened

6
 to public networks/Internet. If this is the case, consider obtaining a TLS/SSL server
certificate signed by a Certificate Authority (CA), to use with ORDS. Please refer MOS
note 2350013.1 for more details.

2. Oracle Integration Cloud (OIC)

 Provide a OIC instance

Provide an OIC instance with the stated minimum recommended. Please refer to the
Integration Cloud for details about the provisioning of this service.

Minimum recommended for the OIC instance:

OIC Edition OIC Size

Standard 10K Messages per Hours
Enterprise 10K Messages per Hours

Notes:

 A minimum of 10k messages per hour is recommended for a full installation of LACLS solutions in
a production environment. If you choose to do a partial installation of these solutions, you can
start in 5k messages per hour and escalate the OIC instance later if necessary.
 For development and test environments, 5k of messages per hour is enough for most cases.

 Install and configure additional Integration component (Mandatory)

Once the OIC instance is provisioned, install and configure the mandatory On-Premises
Connectivity Agent. Please refer to Manage the Agent Group and the On-Premises
Connectivity Agent for more details about this.

7
ROADMAP TO CONFIGURE A STANDARD INFRASTRUCTURE TOPOLOGY FOR LACLS

There are a series of steps to configure a standard Infrastructure topology to support LACLS. This
document has all steps you need to configure this.

The following table shows steps required to configure the topology.

Table 1-1 Standard Infrastructure Topology Installation Roadmap

Task Description
Configuring Oracle Database Cloud Services (DBCS) Configure LACLS Database repository

Configuring LACLS Database Schema with APEX and Enable LACLS DB schema to work with APEX and ORDS in DBCS
ORDS

Configuring Oracle Integration Cloud (OIC) Configures OIC trusted certificates; Create and test a Database
Connection using ADAPTER with Connectivity Agent and Create and
test a Database Connection using REST.

Testing OIC REST Data Service connection Use Oracle Integration to create and execute a new Integration
using REST to the new deployed database instance and validate the
installation.

Testing OIC ADAPTER connection Use Oracle Integration to create and execute a new Integration
using ADAPTER to the new deployed database instance and validate
the installation.

8
CONFIGURING LATIN AMERICA CLOUD LOCAL SOLUTION STANDARD
INFRASTRUCTURE

CONFIGURING ORACLE DATABASE CLOUD SERVICES (DBCS)

The following steps guide you through to deploying LACLS database repository by creating a exclusive
Tablespace and User with the required privileges.

Important:

 LACLS repository must be created in the same pluggable database (PDB), used in the installation of
APEX and ORDS. If you have chosen to install APEX and ORDS in the cdb$root, then before
proceeding to the next step you must create a new PDB to receive the LACLS schema.

1. Configure PDB database connection in SQL Developer

a. Download through https://www.oracle.com/downloads and unzip SQL Developer in Local Disk.

b. Execute SQL Developer.exe and create a new database connection as SYSDBA in PDB

 Click to create a new database connection

9
 Complete the form with required fields.

Complete the fields:

o Name = <Connection name>
o Authentication Type: Default
o Username = sys
o Password = <sys password>
o Role = SYSDBA
o Connection Type = Basic
o Hostname = <DBCS Public IP>
o Port = <Listener port>
o Service name = <PDB Service name> (PDB Service name = PDB Name + Host Domain Name)

10
  Click save, then click Test

2. Create LACLS database schema.

Customers installing LACLS must configure the LACLS schema to receive future database objects
from LACLS solutions. The lacls_create_dbcs_schema.sql required to provision the new schema
is available in the LACLS Install Pack. This pack stores all the scripts to create database objects one
by one. The files are available in LACLS Install Pack. Please refer to MOS Note 2588752.1, Section
3, Table 3.1.1, to download the latest available pack.

a. In SQL Developer, connect with SYS as SYSDBA and run the lacls_create_dbcs_schema.sql to
create LACLS database schema.

Note:

 This script will create a new "LACLS" tablespace and the "lacls" user with required privileges.

 Execute SQL Developer.exe and connect with SYS as SYSDBA in PDB

 Click in and enter with full path of
<PACK_PATH>/INST/DB/sql/lacls_create_dbcs_schema.sql file and “Open”.

11
 Execute lacls_create_dbcs_schema.sql script

Note:

 This script will require you to enter a password for the new LACLS user to be created. Please
enter the password for the LACLS user when prompted.

12
3. Configure a database connection to LACLS User in SQL Developer

a. Execute SQL Developer.exe and create a new database connection to LACLS user in PDB

 Click to create a new database connection

13
 Complete the form with required fields.

Complete the fields:

o Name = <Connection name>
o Authentication Type: Default
o Username = lacls
o Password = <lacls password>
o Role = default
o Connection Type = Basic
o Hostname = <DBCS Public IP>
o Port = <Listener Port>
o Service name = <PDB Service Name> (PDB Service Name = PDB Name + Host Domain Name)

14
 Click save, then click Test

15
CONFIGURING LACLS DATABASE SCHEMA WITH APEX AND ORDS

This is the final step to validate if previous configurations are working fine. Please follow the next steps
to validate your installation:

1. Create the LACLS workspace

a. Login Oracle Application Express and create the LACLS workspace

 Login Oracle Application Express with INTERNAL Workspace

Access: https://<DBCS IP address>:<port>/ords/apex

Complete the fields:

Workspace: INTERNAL
User: ADMIN
Password: <ADMIN password>

 Click on Create Workspace to create LACLS workspace

16
 Complete the fields and click on Next

Workspace properties required:

Workspace Name: lacls
Workspace Description: Latin America Cloud Local Solution Workspace

 Complete the fields and click on Next

Workspace properties required:

Re-use existing schema: Yes
Schema Name: LACLS

17
 Complete the fields and click on Next

Workspace properties required:

Administrator Username: admin
Administrator Password: <Admin password>
Email: <admin e-mail address>

 Review information and click In Create Workspace

18
 Click in Done to finish

19
  Logout INTERNAL workspace

2. Configure ORDS to LACLS workspace

a. Login Oracle Application Express with LACLS Workspace and enable ORDS to schema.

 Login Oracle Application Express with LACLS Workspace

Access: https://<DBCS IP address>:<port>/ords/apex

Complete the fields:

Workspace: LACLS
User: ADMIN
Password: <ADMIN password>

20
 Change user password (required in first login)

21
 Go to SQL Workshop

 Click in RESTful Services

22
 To finish, click in Register Schema with ORDS to enable LACLS schema

 Complete ORDS Schema Attributes and Save

23
  Check ORDS Status for LACLS Schema

b. Create ORDS_ACCESS user to use by LACLS integrations

 Login Oracle Application Express with LACLS Workspace

Access: https://<DBCS IP address>:<port>/ords/apex

Complete the fields:

Workspace: LACLS
User: ADMIN
Password: <ADMIN password>

24
 Select the “administration Icon” > Manage User and Groups

 Click on Create User

 Complete the fields and click on Create User

Complete the fields:

Username: ORDS_ACCESS
Email Address: <e-mail>
First Name: <Admin first name>
Last Name: <Admin last name>
Default Schema: LACLS
User is a workspace administrator: NO
User is a developer: YES
App Builder Access: YES
SQL Workshop Access: YES
Team Development Access: YES
Set Account Availability: Unlocked
Password: <YOUR_ORDS_ACCESS_PASSWORD>
Confirm Password: <CONFIRM_YOUR_ORDS_ACCESS_PASSWORD>
Require change of Password on First Use: NO
GROUP ASSIGNMENTS: RESTful Services

25
26
CONFIGURING ORACLE INTEGRATION CLOUD (OIC)

In this session we will configure the OIC instance with the trusted certificates and create and test a
Database Connection using ADAPTER with Connectivity Agent and also create and test a Database
Connection using REST. These components will be used by the integrations to access the LACLS database
schema. Please refer to the Create Connection documentation and Install the Connectivity Agent
documentation for more details about these steps.

1. Create and validate an Integration Database Connection using ADAPTER with Connectivity
Agent.

 Login to your Oracle Cloud account

 Navigate to Services  Integration
 Click the instance menu and choose Open Oracle Integration Home Page
 Go to Connections and click in Create.
 Choose the Oracle DBaaS type and click in Select

 Complete the fields as in the figure and click in Create

27
 Now, click in Configure Connectivity and provide the connection properties.

Connection properties required:

Host=<DBCS Server IP address>
Port=<Database Listener Port>
Service Name=<PDB Service name >

Note:
 This information can be found in the DBCS Instance details panel, through the Oracle Cloud
services console

 Click in OK to save the Connection properties and click in Configure Security to provide
the LACLS database user credentials.

Security properties required:

Security Policy=Username Password Token
Username=lacls
Password=<lacls user password>
Confirm Password=<lacls user password>

28
  Click in OK to save the Security properties and go to Configure Agents to provide the
Agent Group. Choose the <DB AGENT GROUP> and click in Use to confirm.

 Click Save to commit Oracle Database Connection properties

 To finish click Test to validate the Database Connection

2. Create and validate an Integration Database Connection using REST

 Login to your Oracle Cloud account

 Navigate to Services  Integration
 Click the instance menu and choose Open Oracle Integration Home Page
 Go to Connections and click in Create.
 Choose the REST type and click in Select

29
 Complete the fields as in the figure and click in Create.

Complete the required field:

Name => LACLS_DATABASE_ORDS_CONN

 On the right side, click on Configure Connectivity, complete the fields and click on OK

Connection properties required:

Connection Type: <REST API BASE URL>
TLS Version: TLSv1.2
Connection URL: <YOUR_ORDS_HOST>
Enable two way SSL: YES

30
 On the right side, click in Configure Security Button

Security properties required:

Security Policy: Basic Authentication
Username: ORDS_ACCESS
Password: <ORDS ACCESS USER PASSWORD>
Confirm Password: <ORDS ACCESS USER PASSWORD>

 On the top page, click Test Button

 Click Save button and Close to finish

31
3. Import ORDS certificate as trusted in Oracle Integration.

 Access ORDS url by Chrome

 Click on the button advanced and then click button Proceed to XXX.XX.XX.XX (unsafe)

 In the URL, click in *Not secure* word and Certificate

 Click on Details tab and click button Copy to file…

32
 Click next > Select DER option > click Next > Choose the file location and save under
name ORDS.der

33
 Go to Oracle Integration Cloud (OIC)

 Click on Integrations > Settings > Certificates

 Click on right button UPLOAD

 Complete the fields and click in Upload to finish.

Complete required fields:

Certificate Type: Trust Certificate
Certificate Alias Name: <ORDS Certificate alias name>
Select Certificate File: ORDS.der

34
4. Import ERP certificate as trusted in Oracle Integration.

 Access Oracle ERP Cloud url by Chrome

 In the URL, click in lock icon and Certificate

 Click on Details tab and click button Copy to file…

35
 Click Next > Select DER option > click Next > Choose the file location and save under
name ERP_CLOUD.der

36
 Go to Oracle Integration Cloud

 Click on Integrations > Settings > Certificates

37
 Click on right button Upload

 Complete the fields and click in Upload to finish.

Complete required fields:

Certificate Type: Trust Certificate
Certificate Alias Name: <ERP Certificate alias name>
Select Certificate File: ERP_CERT.der

38
VALIDATE LATIN AMERICA CLOUD LOCAL SOLUTION STANDARD
INFRASTRUCTURE INSTALLATION

TESTING OIC REST DATA SERVICE CONNECTION

This is the final step to validate if previous configurations for REST are working fine

A Test Integration must be created to check the integrity of REST endpoints by performing a simple SQL
query to the Sample table. If the integration succeeds on its execution it means all configurations and
components are working fine.

Please follow the next steps to validate your installation:

1. Login to your Oracle Cloud account

2. Navigate to Open Oracle Integration Home Page  Packages
3. Click the Import button
4. Choose the package “LACLS_DATABASE_ORDS_TEST.par” in folder
<PACK_PATH>/INST/OIC/integration and press Import button

The file is available in LACLS Install Pack. Please refer to MOS Note 2588752.1, Section 3, Table
3.1.1, to download the latest available pack. As reference use the Section 2, Image 2.1.1 to identify
the directories where the .par file can be found.

39
5. Activate the integration by clicking the Switch button

The following screen appears. Activate the traces as per your desire and click in the Activate
button

6. In the Integration’s Option Menu click on Submit Now Action

7. Navigate to Monitoring  Tracking and follow how integration is executed. If it succeeds means
your configuration is fine, otherwise, check the Integration Logs to diagnose the problems

40
41
TESTING OIC ADAPTER CONNECTION

This is the final step to validate if previous configurations for OIC Agent and connections are working fine.

A Test Integration must be created to check the integrity of agents by performing a simple SQL query to
the DUAL table. If the integration succeeds on its execution it means all configurations and components
are working fine.

Please follow the next steps to validate your installation:

8. Login to your Oracle Cloud account

9. Navigate to Open Oracle Integration Home Page  Packages
10. Click the Import button
11. Choose the package “LACLS_DATABASE_TEST.par” in folder
<PACK_PATH>/INST/OIC/integration and press Import button

The file is available in LACLS Install Pack. Please refer to MOS Note 2588752.1, Section 3, Table
3.1.1, to download the latest available pack. As reference use the Section 2, Image 2.1.1 to identify
the directories where the .par file can be found.

12. Activate the integration by clicking the Switch button

42
 The following screen appears. Activate the traces as per your desire and click in the Activate
button

13. In the Integration’s Option Menu click on Submit Now Action

14. Navigate to Monitoring  Tracking and follow how integration is executed. If it succeeds means
your configuration is fine, otherwise, check the Integration Logs to diagnose the problems

43
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, including implied 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.

44