hfm error tackling

Hyperion Financial Management

System Messages: Revealed!Revealed!

Chris Barbieri

Consolidation Practice Director

Oracle Ace

Ranzal & Associates

The Black Art of Reading HFM Event Logs

• Where does HFM store its event information?

• Maintaining the logs

• How can I view this?• How can I view this?

• OK, what does it actually tell me?

• And what can I do about it?

Understanding HFM Logs

Messages

• Messages are informational –start/stop consol, log in, log out etc.

• Some messages are purposely out of time order (consol starts get

printed at completion of consol

Warnings

• Often due to subcube size issues• Often due to subcube size issues

• HFM Subcube Troubleshooting Guide / Memory Management in

HFM documents

Errors

• Access rights

• Syntax Issues

Where are the HFM events stored?

• Text file containing XML, named HsvEventLog.log

– On each server that has the HFM client, including app servers and web servers

• Pre-HFM 9.2.0.2 or 9.3.0– ..\Hyperion Solutions\Hyperion Financial Management\Server Working Folder\

• Starting with 9.3.1 Oracle moved all product logs to a • Starting with 9.3.1 Oracle moved all product logs to a common parent folder

– HYPERION_HOME\Logs\FinancialManagement

– or

– HYPERION_HOME\Logs\HFM

• Starting with 11.1.2 moved again– HYPERION_HOME\Logs\FinancialManagement

– or

– HYPERION_HOME\Logs\HFM

Also written to the Windows Event Log

Also written to the database

Best way to see events

from all servers

How can I view this?

• Administration Module

– Web: Administrators only

• HFM Error Log Viewer utility

– Free standing executable– Free standing executable

– Bundled with HFM under \Consultant Utilities

Web System Messages

• Available to administrators

• Reads from the HFM_ErrorLog table in the database

Navigation on the web

Viewing the Messages

Reading the HsvEventLog.log

Load file from disk (customer’s file etc) by clicking on Diskette Icon

Focus on Text of Messages

Launch the Utility

• Launch HFMErrorLogViewer.exe

• System Message panel

• Details panel

Details

• Web suppresses • Web suppresses

richer details

shown in utility

Find “Registry”

• Each server’s registry settings are written during an application start-up.

• Most but not all registry entries are written

• We’ll cover the actual entries in another presentation

• We’ll cover the actual entries in another presentation

HFM Version

• New in 9.3.1.2 utility, shows version info from the

log

Walk through the settings

• Discuss

primary

settings

Database settings

9203 and 931 new settings

System Memory at Inception

System memory ongoing

• Written to provide basic “perfmon”

information without having to turn on

capture

• Virtual versus private bytes• Virtual versus private bytes

Invalid records

• 9.2.0.3 and 9.3.1 have greatly improved algorithm

for determining whether records are valid

Page File Size

• Increased in 9.2.0.3, 9.3.1 to 130 and 260 MB

Berkely DB File Location

• *.db*

• Can be deleted at start-up or start-up or after shut-down

NoInput Cache

• Added in 4.1.x to improve algorithm for m for determining no input cells

Consolidation Type

Consolidation start and finish

• Summary

indicates

start time

• Details have • Details have

finish time

• Is written

when it

completes

Paging

• Watch pagednodes> 0

Common but meaningless

Search for Purging…

• Find “freelru”

• Least Recently Used

FreeLRU

Chart FreeLRU Activity

• New graph feature in 9.3.1.2 utility

Find all FreeLRU

• System 9 added a “Filter” option

Cube size

• FreeLRUmessages can be paresed in Excel to determine cub size

HSVEventlog vs HFM_ErrorLog

• Note the application and server server fields

• Content can differ too

Database log

• Can be opened only if you have access to a UDL file –

typically only on the HFM application server(s)

Extracting this

• You can extract the database entries to a text

file, which is preferable to the event logs

• Can also truncate the entries using this

• And split large files (anything > 30 MB is too

large)

Chris BarbieriChris Barbiericbarbieri@ranzal.comcbarbieri@ranzal.com

Needham, Needham, MAMANeedham, Needham, MAMA

USAUSA

+1.617.480.6173+1.617.480.6173

www.ranzal.comwww.ranzal.com