User

Guide
Financial Reporting Logs Reporting Oracle Data Integrator

Authors:

Terry M. Ledet

Version:

1.0

Table of Contents

1

FINANCIAL REPORTING LOG REPORTING ORACLE DATA INTEGRATOR ............................................................................................................................. 3

1.1
1.2
1.3
1.4
1.5

INTENDED AUDIENCE ................................................................................................................................................................................................................... 3

FINANCIAL REPORTING LOG REPORTING ORACLE DATA INTEGRATOR OVERVIEW ..................................................................................................................................... 3
ODI AGENT ................................................................................................................................................................................................................................ 4
ODI TOPOLOGY / DESIGNER ....................................................................................................................................................................................................... 26
ODI MIGRATION ...................................................................................................................................................................................................................... 45

Confidential

Page 2
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

1 Financial Reporting Log Reporting Oracle Data Integrator

1.1 Intended Audience
This document is intended for individuals managing the Oracle Enterprise Performance Management (EPM) environment. This document also
assumes the Source environment and the Target environment are the same.

1.2 Financial Reporting Log Reporting Oracle Data Integrator Overview

An Oracle Data Integrator (ODI) package named FRLogs has been created which processes / parsed Financial Reporting Log files into a SQL Server
table, for reporting purposes.

Confidential

Page 3
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

1.3 ODI agent

Select the Windows Logo
Start
then All Programs -> Accessories -> Remote
Desktop Connection.

Confidential

Page 4
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Key the SQL Server computer name for the

appropriate environment and then connect.

Confidential

Page 5
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Key the credentials of an account which has

local administrator privileges or the privileges
to create a Shared Folder. Once this has
occurred, select OK.

Confidential

Page 6
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OK.

Confidential

Page 7
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

After a successful authentication to the

server, select Start -> All Programs -> Oracle
-> Oracle Data Integrator -> Topology
Manager.

After keying the appropriate username /

password, select OK.

Confidential

Page 8
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

From the menu bar, select Windows -> Show

View -> Physical Architecture if Physical
Architecture is not selected.

Select and expand Agents.

Confidential

Page 9
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

If an agent is not listed, select Agents then

right click. From the context menu, select
Insert Agent.

Confidential

Page 10
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Key the agent information as similar to the

right replacing Name and Host with the ODI
Server Name. Once this has occurred select
OK.

Confidential

Page 11
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

From the menu bar, select Windows -> Show

View -> Logical Architecture.

If an agent is not listed, select Agents then

right click. From the context menu, select
Insert Logical Agent.

Duplicate the image on the right replacing

Name with the ODI Server name and the
Physical Agent with the ODI Server Name.
Note in this example the Context is SND
which represents the SND environment.
Please select the appropriate context for the
Confidential

Page 12
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

environment you are working in. Once this is

done, select Apply and then OK.
Select Start and then type SERVICES.MSC.

Confidential

Page 13
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OracleDI Agent. Note, this process

assumes the agent was created as a service
during installation.

Confidential

Page 14
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Double click the OracleDI Agent and then

select the Log On tab.

Confidential

Page 15
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Update the Log on as: account from Local

System Account to the service account for
this environment. Select This account then
key the appropriate account and password.
Once this has occurred select Apply. Pops
may occur which are the third and fourth
images in this row. Select OK if this dialog
boxes occur and also select OK to close the
OracleDI Agent Properties dialog box.

Confidential

Page 16
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Confidential

Page 17
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Confidential

Page 18
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Confidential

Page 19
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Log On As should show the service

account keyed.

Select the OracleDI Agent and then right click

and choose Restart from the context menu.

After the agent has restarted, select File ->

Exit from the menu bar.

Confidential

Page 20
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Return to Topology Manager and from the

menu bar, select Windows -> Show View ->
Physical Architecture if Physical Architecture
is not selected.

Select and double click the agent previously

created.

Confidential

Page 21
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Test.

Confidential

Page 22
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OK.

Confidential

Page 23
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OK.

Select File -> Exit from the menu bar to close

Topology.

Confidential

Page 24
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Confidential

Page 25
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

1.4 ODI Topology / Designer

Select Start -> All Programs -> Oracle ->
Oracle Data Integrator ->
Designer.

When the Security Repository Connections

dialog box renders, select OK.

Confidential

Page 26
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and expand Technologies -> File and

then select TXT_FRLOGS.

The file technology has two Data Servers:

Intentionally Left Blank.
TXT_FRLOGS and TST_SQLLOGS. The
TXT_FRLOGS represents the location of the
logs of the FR server and the SQLLOGS
represents the location on the SQL Server
server where new and changed log files are
copied to for the bulk import process.
Select and expand TXT_FRLOGS. Then double
click the Physical Schema. Note each Data
Server has only Physical Schema at this time.

Confidential

Page 27
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Directory (Schema) is

\\SGRHYPWEBSND\FRLogs$ which represents
the shared created based on document,
FinancialReportsLogsReportingSharedFolders.
The directory (Work Schema) is
SGRHYPWEBSND which represents the FR
Server. When migrating from SND to another
environment, the server name should be
updated as appropriate. Please select OK.

Confidential

Page 28
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and expand TXT_SQLLOGS. Then

double click the Physical Schema. Note each
Data Server has only Physical Schema at this
time.

Confidential

Page 29
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Directory (Schema) is

\\SGRHYPSQLSND\FRLogs$ which represents
the shared created based on document,
FinancialReportsLogsReportingSharedFolders.
The directory (Work Schema) is
SGRHYPSQLSND which represents the SQL
Server server. When migrating from SND to
another environment, the server name
should be updated as appropriate. Please
select OK.

Confidential

Page 30
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and expand Microsoft SQL Server ->

SQL_FRLOGS. Then double click the Data
Server.

Confidential

Page 31
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

In this example the server is sgrhypsqlsnd

and the user is FRLOGS. Note the default
database for user, FRLOGS, is FRLOGS. When
migrating please have the DBA set the default
database for the user account to FRLOGS.
The server name would be updated when
migrating from environment to environment.
Once this is done select the JDBC tab.

Confidential

Page 32
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Part of the JDBC Url is the SQL Server name

which in this example is sgrhypsqlsnd. When
migrating from one environment to anther
environment please update the server name
as needed. One this is done, select Test.

Confidential

Page 33
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Test.

After a Successful Connection, select OK. If

the connection is not successful, verify /
update the JDBC Url and Server (Data Server)
on the Definition tab and repeat the Test
until successful.

Confidential

Page 34
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and double click the Physical Schema.

Confidential

Page 35
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Physical Schema should not require an

update assuming the FRLogs database is
backed up and restored from one
environment to another. Select OK to close
the windows.

Confidential

Page 36
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Show View -> Contexts.

The SND Context tabs for Definition, Agents,

and Schemas are included for reference
purposes. Change should not be needed
during a migration.

Confidential

Page 37
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Start -> All Programs -> Oracle ->

Oracle Data Integrator ->
Designer.

Confidential

Page 38
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

After keying the appropriate username /

password, select OK.

Confidential

Page 39
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The image to the right displays the FRLogs

project with all objects visible. To process
the FRLogs can individual can either process
the FRLog package or scenario. Note if any
changes are made to the objects in this
package then the scenario should be
regenerated. Also each object with respect
to Designer has a version which is a backup
version and represents the state of the object
to date.

Each object is commented except the

Confidential

Intentionally Left Blank.

Page 40
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

scenario which is the post it symbol to the

right of the name.
Select and double click FRLogs to open the
package.

Select the Diagram tab to display the

workflow. As the steps are commented this
document does not duplicate this
information.

Confidential

Page 41
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Two Knowledge Modules (KM) are used in

this Project which are LKM File To SQL and
IKM SQL Control Append.

Confidential

Page 42
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The image to the list the SQL SERVER objects

which are listed below the Model, FRLOGS,
and the TXT objects which are listed below
the TST Model. As the objects are
commented this is also not duplicated in this
document.

Confidential

Page 43
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select File -> Exit from the menu bar to close

Designer.

Confidential

Page 44
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

1.5 ODI Migration

Select File -> Export -> Work Repository to
export this repository to a XML file which can
be imported into another environment.

Select Export to zip file and either key / select

a directory and filename. Once this is done
select OK.

Confidential

Page 45
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

From the menu bar, select Windows -> Open

Module -> Topology Manager.

Confidential

Page 46
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

After the Topology Manager displays, select

File -> Export -> Master Repository.

Select Export to zip file and either key / select

a directory and filename. Once this is done
select OK.

Confidential

Page 47
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select File -> Exit from the menu bar to close

Topology.

Confidential

Page 48
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select File -> Exit from the menu bar to close

Designer.

Confidential

Page 49
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Start -> All Programs -> Microsoft SQL

Server 2008 R2 -> SQL Server Management
Studio.

Confidential

Page 50
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Log into server, SGRHYPSQLSND, by keying

the appropriate credentials and selecting
Connect.

Confidential

Page 51
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Expand Databases and then select, FRLogs.

Confidential

Page 52
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Right click FRLogs and then select Tasks ->

Back Up.

Confidential

Page 53
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The BackupType should be Full and the

Destination should be Disk. The Destination
in this example is D:\Program Files\Microsoft
SQL Server\MSSQL10_50.MSSQLSERVER
\MSSQL\Backup\FRLogs.bak. Once this is
done select OK.

Confidential

Page 54
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Once the backup is complete, select OK.

Copy the following files:

MasterRepository.zip, WorkRepository.zip,
and FRLogs.bak to the target server.
Log into the target SQL Server. Once this is
done, select Databases and then right click.
From the context menu, select Restore
Database.

Intentionally Left Blank.

Confidential

Page 55
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Update the Specify the source to From

device. Then select the ellipsis

button.

Confidential

Page 56

FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Confidential

Page 57
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Add and navigate to the location of

FRLogs.bak.

Confidential

Page 58
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select the backup file and then OK.

Select OK.

Confidential

Page 59
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select File -> New -> Query with Current

Connection

Copy and Paste the T-SQL to the right into

the query window and then select Execute
.
This step occurs to truncate the tables in the
migrated database.

Confidential

TRUNCATE
TRUNCATE
TRUNCATE
TRUNCATE
TRUNCATE

TABLE
TABLE
TABLE
TABLE
TABLE

FRFilenames
FRFilenamesProcess
FRLogs
FRLogsParsed
FRLogsProcess

Page 60
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Expand Databases -> FRLogs -> Security ->

Users and select FRLogs.

Confidential

Page 61
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Right Click FRLogs and select Delete.

Confidential

Page 62
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OK.

Confidential

Page 63
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Security. Then right click and choose

New -> Login.

Confidential

Page 64
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Duplicate the General tab to the right by

creating a SQL Server account with a Login
name of FRLogs and a Default database of
FRLogs.

Confidential

Page 65
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select the Server Roles page and assign the

bulkadmin role in addition to the public role.
Once this has occurred, select User Mapping.

Confidential

Page 66
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Map the FRLogs user to the FRLogs database.

Also add the db_owner role to the FRLogs
user. Once this is done select OK.

Confidential

Page 67
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Copy file, FRLOG-c.fmt, from the source SQL

Server to the Target SQL Server. This file
represents the definition for the bulk import.

Select Start -> All Programs -> Oracle ->

Oracle Data Integrator -> Topology Manager.

Confidential

Page 68
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

After keying the appropriate username /

password, select OK.

From the menu bar, select File -> Import ->

Master Repository.

Update the Import Mode to Synonym Mode

INSERT_UPDATE, the import method from
From a folder to From a Zip File, and then
select the MasterRepository.zip file
previously created. Once this is done, select
OK.

Confidential

Page 69
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Master Repository will import and

complete without an error message.
Select and expand Technologies -> File ->
TXT_FRLOGS. Then double click the Physical
Schema. Note each Data Server has only
Physical Schema at this time.

Intentionally Left Blank.

Confidential

Page 70
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Directory (Schema) is and the Directory

(Work Schema) should be updated as
appropriate to the FR Reporting Server for
this environment. Once this has occurred,
select OK.

Confidential

Page 71
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and expand Technologies -> File ->

TXT_SQLLOGS. Then double click the Physical
Schema. Note each Data Server has only
Physical Schema at this time.

Confidential

Page 72
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

The Directory (Schema) is and the Directory

(Work Schema) should be updated as
appropriate to the FR Reporting Server for
this environment. Once this has occurred,
select OK.

Confidential

Page 73
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select and expand Technologies -> Microsoft

SQL Server-> SQL_FRLOGS.

Confidential

Page 74
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Double click, SQL_FRLOGS, and update the

Server (Data Server). Once this is done select
JDBC.

Confidential

Page 75
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Update the JDBC Url by changing the server

name from the source environment to the
target environment. Once this is done select
Apply and then Test.

Confidential

Page 76
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select Test.

Select OK.

Confidential

Page 77
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Select OK.

Confidential

Page 78
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

From the menu bar, select Windows -> Open

Module -> Designer.

After keying the appropriate username /

password, select OK.

Select File -> Import -> Work Repository from

the menu bar of Designer.

Confidential

Page 79
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013

Update the Import Mode to Synonym Mode

INSERT_UPDATE, the import method from
From a folder to From a Zip File, and then
select the WorkRepository.zip file previously
created. Once this is done, select OK.

The Work Repository will import and

complete without an error message which
concludes this document.

Confidential

Intentionally Left Blank.

Page 80
FinancialReportsLogsReportingSharedFolders.docx

5/28/2013