OAC: specifying the Connection string within rpd model

The following is a step-by-step guide to determine the Connection string for Oracle Analytics Cloud and Oracle Database Cloud.

When logging into your Oracle Cloud Service using your identity Domain, a similar page is being displayed:

image

Click on the Action Menu of the Database Cloud Service and select “Open Service Console”.

This Page shows details about your Cloud Services such as OCPUs, Storage or Memory:

image

click on the Database Service Name to get to the Details Page:

image

This reveals the Public IP of the Oracle Cloud Database and the required Service Name.

Within the Oracle BI Administration Tool, the connection string needs to be created in the Data Source Name Field:

image

Using the following format:

image

</code>

(
DESCRIPTION=
(ADDRESS=
(PROTOCOL=tcp)
(HOST=xxx)
(PORT=1521)

)
(CONNECT_DATA=(SERVICE_NAME=PDB1.xxx.oraclecloud.xxx))

)

<code>

After modelling the data and saving the .rpd File, the Model can be uploaded to the OAC Cloud:

image

Advertisements

Link

The following Link shows the Oracle Cloud Public IP Addresses in order to create a Virtual Cloud Network (VCN) between customers data centers and Oracle Cloud Data Centers:

https://docs.cloud.oracle.com/iaas/Content/Network/Concepts/overview.htm#oci-public-ips

Navigate to “Public IP Addresses for Your VCN”

Accessing data in Oracle Fusion Applications Cloud for Analytics

The following diagram shows the high-level options to access data within Oracle Fusion Applications (FA) Cloud for Analytical purposes:

Please note: that this diagram is of April 2018 and may not apply in full in future.

For more details on how to connect to Oracle Fusion Applications (FA) Cloud using Visual Analyzer (VA) and DV Desktop (DVD), please reference the previous article.

The details for connecting to FA using ODI (with BI Applications) or BI Data-sync will be described in future articles.

Connecting to Oracle Fusion Applications (FA) Cloud using Visual Analyzer(VA) and DV Desktop(DVD)

The following Article is written as of April 2018. Since, the Cloud is evolving rapidly, it may not apply in full, in future.

The aim of the Article is to demonstrate the possibilities of connecting to Oracle Fusion Applications (FA) Cloud (via OTBI) without any data extraction (ETL). Thus, only using declarative approaches offered by Visual Analzer (VA) of Oracle Business Intelligence Cloud Service (BICS) /  Oracle Analytics Cloud (OAC) and the downloadable version of VA, the Data Visualization (DV) Desktop (DVD). The following diagram re-iterates the scope of this Article:

image

The following Version and respective features are used as baseline for this Article (as available of April 2018)

 

Product Version
Oracle Fusion Applications Cloud / OTBI R13
BICS 18.1.6.0.0
OAC 18.1.3
DVD 12.2.4.2.0

Oracle Fusion Applications (FA) Cloud comes bundled with OTBI, which provides pre-built BI Subject Areas to access the data stored in FA:

image

However, OTBI does have some limitations when it comes to extensibility (no access to metadata model) and adding of additional data sources (limited to data connection of respective FA instance).

The Oracle Cloud offering for “stand-alone” analytics are BICS (and in the future OAC). Hence, there maybe the need to connect from BICS/OAC to Fusion Applications. This is possible by two general Options:

This Article only focuses on the latter three options (declaring the connection details without any data movement).

Connecting from DV Desktop to Oracle Fusion Applications (FA) via OTBI

DV Desktop represents a offline Version of Visual Analyzer and can be downloaded from OTN. Once  installed, it can be used to create a Connection to Oracle Fusion Applictions from the top right create Menu:

image

One of the Options from the “select connection type” list is “Oracle Application”:

image

This “Oracle Application” is the reference to Oracle Fusion Application’s Cloud via the OTBI URL !

image

It will not work with only the Oracle Fusion Application Cloud URL e.g. https://<IdentityDomain>.fs.em3.oraclecloud.com/homePage/faces/FuseWelcome , but only the respective OTBI URL e.g.: https://<IdentityDomain>.fa.em3.oraclecloud.com/analytics

If the URL is entered incorrectly, e.g. when using a trailing “/” it will not save the connection:

image

Once the correct OTBI URL, Username and Password are entered and saved, the connection is added to the list of available Data Connections:

image

As stated before: These “Oracle Applications” connections will only work with the respective OTBI URL, since the metadata (such as subject areas or Report from Catalog) is retrieved from this URL only. Once the connection is created, the Subject areas are available and the Analysis can be created in DVD:

image

Connecting from Visual Analyzer (VA) of BICS to Oracle Fusion Applications (FA) via OTBI

The equivalent of DVD for the web is Visual Analyzer (VA), which is part of OBIEE 12c as-well as BICS (and OAC). The same connection to Fusion Applications Cloud can also be created within VA of BICS. To do this, the VA Projects needs to be selected from the BICS (Classic) Home Page:

image

Within VA, click on “Add Connection” under the “Add new Data Source”:

image

And choose “Oracle Application” as connection type once again:

image

For the web version, the list of available data connections is also much smaller (only Oracle Applications and Oracle Database) compared to DVD. The connection details need to be entered in a similar way for VA e.g. as shown below:

image

After the Connection was saved successfully, the Connection can be used to create a Visual Analysis. However, VA of BICS will only provide the possibility to access saved Reports, but not the Subject area’s itself (compared to DVD)!

image

Connecting from Visual Analyzer (VA) of OAC to Oracle Fusion Applications (FA) via OTBI

The steps for connecting from VA of OAC to Oracle Fusion Applications (FA) are very similar to VA of BICS. Select VA from the OAC Homepage:

image

And create the connection in the same way. After successfully creation of the connection, it is listed as Connection in the Data list:

image

VA of OAC is not limited to create Analysis on predefined Reports (compared with VA of BICS). It is also possible to create an Analysis based on the subject area (similar to DVD):

image

The screenshot shows, the data preview from the Subject areas:

image

Important for Reports and Dashboards

(as of April 2018) The possibility of connecting from BICS/OAC to Oracle Fusion Applications (FA) Cloud is only available with VA. This is not (yet) available for Reports and Dashboards:

image

For Reports and Dashboards only a Database Connection can be added, but not a Oracle Applications connection.

Conclusion

  • Oracle Oracle Applications connection Type refers to the OTBI URL of Oracle FA
  • The possibility of connecting from BICS/OAC to Oracle FA is limited to VA
  • VA can be used to connect to OTBI, but cannot be used to connect to the underlying database
  • VA (via DVCS) can be used to connect to OBIEE .

Installing Oracle R on Database VM Image

Download the Oracle Pre-Built Database Developer VMs from OTN.image
Import the extracted VM into Virtual Box and bootup the Virtual Machine. After starting the VM, the following screen is presented witin Virtual Box:
image
check the Linux Version of the Downloaded Virtual Machine with below command:

# uname -r

For this VM it is: 4.1.12-61.1.27.el7uek.x86_64, thus: Oracle Enterprise Linux 7.

Install R (distribution) for Oracle R Enterprise

Afterwards, switch user to root (Password is “oracle”) and navigate to the yum Repository configuration:
image
using the vi (i command for – – inserting- – Mode and Esc for exiting the insert Mode, save with :wq) update the following sections within the repo file:

[ol7_latest]
enabled=1

[ol7_addons]
enabled=1
[ol7_optional_latest]
enabled=1

e.g.:
image
Install R with the following command
image
this automatically downloads and performs the installation:
image
image
image

Installing Oracle R Enterprise Server

Add the Oracle Home Lib to the Library Path environment variable:
image
This can also be added to the ~/.bashrc
image
As next step, download the Oracle R Enterprise software from OTN.
image
And store to a installation directory e.g. /u01/ORE_Inst_Dir
image
and unzip the files:
image
Start the installation by running the installer:
image

Installing Oracle R Client

Unzip the Client zip files:
image
switch to root user and install all unzipped files:
image
Start Oracle R Client with the ORE command and load the Oracle R libaries with library(ORE). When loading the R libaries, the following error is thrown:

Loading required package: OREembed
Error in dyn.load(file, DLLpath = DLLpath, …) :
   unable to load shared object ‘/u01/app/oracle/product/12.1.0.2/db_1/R/library/png/libs/png.so’:
   libpng12.so.0: cannot open shared object file: No such file or directory
Error: package ‘OREembed’ could not be loaded


image

Since, the file libpng12.so.0 is not available it needs to be installed:
image
image
[Thanks to the following article which features the same issue]

After installing the missing file, the ORE Libaries are loaded successfully within R:
image

Further references:

http://rajiv-kuriakose.blogspot.de/2016/03/how-to-install-oracle-r-enterprise-on.html

Official Oracle Documentation:

https://docs.oracle.com/cd/E57012_01/doc.141/e57007/install_oreserver.htm#BGBJIIAG

Link

Link to information about business questions and answers for Oracle Transactional Business Intelligence (OTBI) Embedded Analytics Cloud, HCM Subject areas:  http://www.oracle.com/technetwork/documentation/otbi-hcm-2225528.html

And for OTBI-E subject areas. The advantage of this is, that it is indeed very similar to Oracle BI Applications (OBIA) and can easily be applied for the same:

http://www.oracle.com/technetwork/documentation/otbi-e-2247768.htm

Oracle BI EE 12c: Configuring first Oracle Database connectivity with TNS Names after installation

In case the oracle Database should be used by Oracle BI, the database connectivity must be configured after the installation using the Oracle Database driver and TNS Names configuration.

For the server machine

On the Server (where Oracle BI EE 12 is installed), the Installation routine of Oracle BI automatically ship’s a Instant Client Version of the Oracle Database Client (Database driver).
The files of the driver are located within the following directory:
/u01/apps/obi12c/product/Oracle_Home/instantclient

On Linux/Unix On Windows Description
libclntsh.so.10.1 oci.dll Client code library
libociei.so oraociei10.dll OCI Instant Client data shared library
libnnz10.so orannzsbb10.dll Security library

The TNS Names configuration that should be used by the Oracle BI Server has to be specified by the sqlnet.ora and tnsnames.ora which need to be placed within the following directory:

/opt/biee/user_projects/domains/bi/config/fmwconfig/bienv/core

image
The following shows a example of the sqlnet.ora file:
image

And the following shows a example of the tnsnames.ora fiile:
image

Using above files the Oracle BI server should be able to connect to the database specified within the TNS Names file.

For the developer machine

The Oracle BI 12c Administration Tool (BI Developer Studio) requires the above (example) configuration files for sqlnet.ora and tnsnames.ora to be placed within the following directory of the client developer machine:
C:\Oracle\BIAdmin\domains\bi\config\fmwconfig\bienv\core

The TNS Name specified within the tnsnames.ora may then be used within the Connection Pool definition of the Oracle BI Metadata either by using the defined name or by using the fully qualified TNS Names entry. When refreshing the count of a database object such as a Table, the Oracle BI Server should then be able to retrieve the row count and display the row count within the Oracle BI Administration Tool:

image

In case of bug fixing, the log of the Oracle BI Administration Tool is located within the following path:
C:\Oracle\OracleBIClient\domains\bi\servers\obis1\logs

image