finit solutions troubleshoot fdm like a pro august 2011

Getting the Most out of EPM: FDM T bl h ti TiFDM Troubleshooting Tips

August 26, 2011Greg BarrettGreg [email protected]

www.finitsolutions.com

Th Fi it S l ti S iTh Fi it S l ti S i

Getting the Most out of EPM: FDM Troubleshooting

Finit IntroductionThe Finit Solutions SeriesThe Finit Solutions Series

Finit Solutions specializes in consulting services in the Oracle Hyperion Enterprise Performance Management Solutions suite of products:

Financial Consolidation– Financial Management (HFM)

Hyperion Enterprise

Planning and Business Intelligence– Planning

Essbase– Hyperion Enterprise– Financial Close Management– Disclosure Management

– Essbase– Profitability & Cost Management

(HPCM)

Integration– Financial Data Quality Management

(FDM)

Reporting Tools– Financial Reporting– Smartview( )

– Oracle Data Integrator (ODI)– Enterprise Performance

Management Architect (EPMA)

– OBIEE– Web Analysis– Essbase Excel Add‐in

www.finitsolutions.com‐ 2 ‐

– Other (ERPi, EIS, etc)



Finit’s EPM ExpertiseThe Finit Solutions SeriesThe Finit Solutions Series

• Finit consultants bring deep experience in external SEC reporting, tax reporting, and i t l t l i id f i d t i

p

internal management analysis across a wide range of industries.

• Our backgrounds in accounting and reporting, combined with our product expertise, make us uniquely qualified to assist and advise clients on developing reporting packages that q y q p g p g p gprovide better insight and analysis for management.

• In addition to strong backgrounds in accounting and finance, the Finit consulting team has subject matter expertise related to Oracle EPM technical and infrastructure componentssubject matter expertise related to Oracle EPM technical and infrastructure components. Our ability to know both sides adds value in areas such as environment strategy planning, product selection, deployment planning and overall infrastructure implementation activities.

• Finit is a member of the Oracle HFM, Planning, FDM and Hyperion Enterprise Customer Advisory Boards. In this role, we work directly with product development and quality engineering teams to address future product enhancements.




Finit’s Client ServiceThe Finit Solutions SeriesThe Finit Solutions Series

We take client service very seriously and our results areWe take client service very seriously and our results are unmatched in the industry:

Our client service approach has led to 100% customer satisfaction for every Finit client (142 and counting) forsatisfaction for every Finit client (142 and counting) for

every project (over 250 and counting).




Some Finit ClientsThe Finit Solutions SeriesThe Finit Solutions Series

•




About the PresenterThe Finit Solutions SeriesThe Finit Solutions Series

Greg Barrett 8+ years experience 8+ years experience

with Hyperion 6+ years as a

lt t ith Fi itconsultant with Finit Solutions

Director of Finit Data Integrations Product Line

HFM Certified Recent new dad




How to Ask a QuestionThe Finit Solutions SeriesThe Finit Solutions Series




AgendaThe Finit Solutions SeriesThe Finit Solutions Series

FDM Architecture (Folder and DB Overview) l d k

g

FDM Application Migration and Back‐UpFDM Error LogsFinance And IT Troubleshooting (Server, Script, Environment Errors)) Helping you to distinguish if your error is a process (Finance/Accounting) Issue or Server/Environment (IT) ( g) ( )Issue

Q and A


Q



FDM – Folder StructureThe Finit Solutions SeriesThe Finit Solutions Series

• Every FDM Application has the same Folder Structure that exists on the FDM ApplicationStructure that exists on the FDM Application Server

ld h h f• Every FDM Folder Structure has the same four directories:

• Data, Inbox, Outbox, Reports• Users should not have direct (browse) access to ( )these folders.





Data Folder h d d f l ( ) h bContains archived data files (###.ua#) that can be retrieved from the display of the Import and Export screensAlso contains the FDM Scripts (Custom, Event, Import)These scripts are best viewed in the web (Tools / p ( /Script Editor) or the FDM Workbench





Inbox f l d f ll f lDefault directory for all IMPORTED source filesOutboxCentral directory for all files to be EXPORTED to your Target System (HFM, Enterprise, etc.)y g y ( , p , )Also contains all the FDM User LogsReportsReportsContains all the files for your FDM Reports




FDM – DatabaseThe Finit Solutions SeriesThe Finit Solutions Series

FDM stores all data and maps in its database tablestables Therefore, FDM must always have a proper

h l ( f hconnection to the SQL or Oracle DB (often the DB resides on a separate server; connection is set up

h d ll)with a service account during install). If the connection to the DB is severed (DB ID rights are changed, password is changed, etc.) it will produce a “data access” error.




FDM – Database ErrorsThe Finit Solutions SeriesThe Finit Solutions Series

“Data Access Error” equals DB issue

“File Not Found” may mean that DB Service ID d h hdoes not have BULK Insert rights




FDM – Database AccessThe Finit Solutions SeriesThe Finit Solutions Series

Only the DB Admin can access the FDM DB on the DB server, but (depending on the version of FDM) the ‘Admin’ can view most of(depending on the version of FDM) the Admin can view most of the DB tables in the table editor (Tools / Table Editor – make sure you have secured this menu item so only ‘Admins’ can access it)




FDM – Back‐Up and MigrationThe Finit Solutions SeriesThe Finit Solutions Series

p g

Because the back‐end of FDM consists of the Folder structure and the DBof the Folder structure and the DB both these items must be copied in order to do a full “back‐up” or i timigration.

If you wish to do a back‐up or migration that does NOT include the gdata you can do an XML back‐up directly from the Workbench. Simply click File / Export Then give the XMLclick File / Export. Then give the XML file a name and then choose the items you want to include:




FDM – Error LogsThe Finit Solutions SeriesThe Finit Solutions Series

g

There are 4 main ways to access the FDM Error Logs:1 In the web click Tools / View Error Log This will open up a1. In the web click Tools / View Error Log. This will open up a

separate window with the user’s error log:





g

2. In the FDM Folder Structure you can view ALL user Logs:





g

3. In the web click on Analysis / Log:





g

4. In the web click on Analysis / Reports to run the FDM Reports:Audit Reports + System ReportsAudit Reports + System Reports





g




FDM – Report SecurityThe Finit Solutions SeriesThe Finit Solutions Series

p y




FDM – Error at ImportThe Finit Solutions SeriesThe Finit Solutions Series

Usually there are three possible causes:

p

1. No Import Format is assigned to this location2 A file that is not consistent with the assigned2. A file that is not consistent with the assigned

import format was loaded (aka the file changed in formatting compared to last month or ain formatting compared to last month or a ‘journal’ file was accidentally loaded)

3 I t S i t (i id th I t F t f th t3. Import Scripts (inside the Import Format for that Location) or the Import Action Event Script





Sample Import Format:

p

Sample GL File:





p




FDM – Error at ValidateThe Finit Solutions SeriesThe Finit Solutions Series

The most common error is, obviously, the unmapped item:unmapped item:





The second most common error is the Intersection Validation Error (HFM only)Intersection Validation Error (HFM only)





Orange = Invalid Member ‐ The Account, Entity, ICP, or the any of the Custom dimensions do not exist in HFM. Find out from your HFM Admin the correct mapping and make the corrections before proceedingand make the corrections before proceeding.

Red = Invalid Intersection – something is wrong with the Account/Custom Dimension and/or ICP combo. Verify what members are valid for that intersection and make the necessary correction.y

Purple = Cannot Write – the current user does not have access to load data to the target HFM entity. Verify that you have the correct access to the entity/entities that your location in FDM is/are trying to load data to. Most often an HFM security issue.

Green = Locked Intersection – the Entity/Scenario/Period you are trying to load to in HFM is already locked or has been promoted. FDM is unable to export data to intersections in HFM that have already been locked or promoted.

No Color (Plain Text) make sure target account/s has been flagged as “no input” orNo Color (Plain Text) ‐make sure target account/s has been flagged as no input or Custom dimension(s) do not have any member assigned to it. Dimensions must be assigned the value of [None] if there are no members assigned to it.




FDM – Error at ExportThe Finit Solutions SeriesThe Finit Solutions Series

p

Export Failed – User could not be authenticated. Screen shot is from FDM App connecting t HFM.

User ID, either does not have security rights to target system or user entered info in the domain when logging into FDM and that info is being passed to HFM (more likely). When using MSAD / LDAP as authenticator, domain


should be left blank at log in (only use domain for NTLM).




p

Export Failed – User could not be authenticated. Screen shot is from FDM App connecting t Hyperion Enterprise.

User ID, either does not have security rights to target system or user entered info in the domain when logging into FDM and that info is being passed to Hyperion (more likely). When using MSAD LDAP as authenticator, domain


should be left blank at log in (only use domain for NTLM).




p





p

Hyperion Enterprise: user does not have security rights, Accounts/Entities are invalid, Period/Category is Locked

d/ l k d d h dHFM: Period/Scenario is locked or metadata changed after validate occurred (Smart Merge)




FDM – Journal ErrorsThe Finit Solutions SeriesThe Finit Solutions Series

FDM cannot read a file with any #NA, #VALUE, or #REF cells FDM cannot read a file with any #NA, #VALUE, or #REF cells resulting from formulas. This also means that if you are loading a file with Retrieve / Smart View values they must all be properly pulling back data into the Excel Sheet


pulling back data into the Excel Sheet



FDM – Map and Database CorruptionThe Finit Solutions SeriesThe Finit Solutions Series

p p

GL Import

Map Import





p p





p p

There are two possible ways to fix database corruption p y pin the maps:

1. Go into the tDataMap table and manually find and delete the corrupted items (can be very time consuming)

2. Use some custom scripting to Export the corrupt map(s) into Excel and delete the map from FDM. You can then find the bad entries in the Excel File and load it back inExcel File and load it back in





p p

To Prevent corruption from happening it is a good idea to put some preventative code in place:


The Finit Solutions Series

Future Webinars & Contacts

www.finitsolutions.com



Upcoming WebinarsThe Finit Solutions SeriesThe Finit Solutions Series

Dates to be Announced• Troubleshooting Tips for HFM• Troubleshooting Tips for Essbase and Planning• Introduction to Financial Close Management• Introduction to Financial Close Management• HFM for the Tax Department

To register, or to view past sessions, go to: www.finitsolutions.com/Insights_Webcast.html




Finit ContactsThe Finit Solutions SeriesThe Finit Solutions Series

[email protected]

Questions? ‐> Greg [email protected]

Email us for a‐> Ed [email protected]

copy of the slides or

link to the recording‐>Joe [email protected] to the recording. j @f919.349.5029


finit solutions troubleshoot fdm like a pro august 2011

Technology

ti s ith fi

ti s i gettingthemostoutofepm

finit client

client service

oracle epm technical

yearsexperience withhyperion

years experience

customer satisfaction