Configuring Essbase Server
Copyright © 2009, Oracle. All rights reserved.
Objectives
After completing this lesson, you should be able to:
• Set up runtime and connection options for Essbase
• Configure block storage and aggregate storage disk
allocation
• Identify the primary information logs available to
Essbase system administrators
• Create an essbase.cfg server configuration file
• Configure Smart View for Office
Copyright © 2009, Oracle. All rights reserved.
About Configuring Essbase
•
•
•
•
•
•
Runtime configuration
Running Essbase Servers as background processes
and Windows services
Connection options
Disk allocation
Transaction and lock settings
Information logs
Copyright © 2009, Oracle. All rights reserved.
Running Essbase Servers
as Background Processes
•
Windows service*
essbase.exe –service install
essbase.exe –service remove
•
UNIX
#!/bin/sh
PASS=$1
Essbase -b -secure << EOF &
${PASS}
EOF
essbase.secure <password>
* Prior to Release 9.3
Copyright © 2009, Oracle. All rights reserved.
Windows Service Considerations
•
Advantages:
– Cannot accidentally close windows (no visible agent window)
– Can shutdown client processes without affecting server
– Can give priority to foreground services
•
Disadvantages:
–
–
–
–
Cannot use agent commands
Cannot observe server activity directly
Cannot monitor running applications
Cannot shut down Essbase Server from the server console
window—must use command-line interface or stop Windows
service
Copyright © 2009, Oracle. All rights reserved.
Running Multiple Essbase Servers
as Windows Services (Release 9)
Effective with release 9.3, you can run multiple Essbase
Servers as Windows services using the following method:
Primary instance
All other instances
Run window command
BAT files
Copyright © 2009, Oracle. All rights reserved.
Running Multiple Essbase Servers
as Windows Services (Release 11)
Effective with release 11.1, you can run multiple Essbase
Servers as Windows services using the following method:
Install primary instance
Configure primary instance
EPM System Installer
EPM System Configurator
Install other instances
Configure other instances
Copyright © 2009, Oracle. All rights reserved.
Connection Options
Use these to eliminate network timeouts:
• NETDELAY
– Network request delay time in milliseconds
– Default value: 200 milliseconds
•
NETRETRYCOUNT
– Number of times Essbase tries to make a network
connection before reporting an error
– Default value: 600 retries
Copyright © 2009, Oracle. All rights reserved.
Disk Allocation
•
•
Block storage
Aggregate storage
Copyright © 2009, Oracle. All rights reserved.
Block Storage Disk Allocation
•
•
•
Default directory is ARBORPATH/apps directory
Maximum file size is 2GB (ess00001.ind, ess00001.pag,…)
Can span volumes, for example:
12 GB allocated
for Essbase files
16 GB allocated
for Essbase files
16 GB allocated
for Essbase files
Copyright © 2009, Oracle. All rights reserved.
Aggregate Storage Disk Allocation
Four tablespaces
Tablespace
Contains
Change
location/size?
default
Database structure
and data
Yes, if empty
temp
Temporary work
space
Yes, if empty
log
Transaction log
No
metadata
File locations
No
Copyright © 2009, Oracle. All rights reserved.
Aggregate Storage Load Buffers
Essbase Server
Administration
Services Console
MaxL DDL
scripts
Load buffer(s)
ASO MDB
MaxL shell
Copyright © 2009, Oracle. All rights reserved.
Data sources
Rules files
Data Slices
Incremental commits of the data load buffer to aggregate
storage databases
• Create in Administration Services Console…
•
…or MaxL
import database HyptekAS.HyptekAS
data from load_buffer with buffer_id 1
override values create slice;
Copyright © 2009, Oracle. All rights reserved.
Information Logs
•
•
•
Server log
Application log
Outline Change log
Starting Log Viewer for an application
Copyright © 2009, Oracle. All rights reserved.
Outline Change Log File
• Outline modification information
– Date/Time/User
– Type of modification
– Details
• Outline Change Log file size limits
– Minimum/Maximum/Default
– Maintain settings in essbase.cfg file
Copyright © 2009, Oracle. All rights reserved.
Log Analyzer
•
•
Provides a graphical analysis tool for log information
Is accessed from Administration Services Console
Copyright © 2009, Oracle. All rights reserved.
Essbase Configuration File
•
Is an ASCII file located in ARBORPATH\bin
•
•
Specifies server-wide application and database settings
Requires Essbase server restart after changing essbase.cfg
Copyright © 2009, Oracle. All rights reserved.
Smart View
Smart View Client
Client
Tier
Data Source
Connection
Data Model
XML
HTTP(s)
Analytic
Provider
Java API
Infrastructure
Planning
Provider
Financial Management
Provider
Web
Tier
Planning Application
Server
Financial Management
Application Server
Application
Tier
TCPIP / DCOM
Data
Tier
Essbase
RDBMS
Copyright © 2009, Oracle. All rights reserved.
Quiz
In Release 11.1, you can run more than one instance of the
Essbase agent as a Windows service.
1. True
2. False
Copyright © 2009, Oracle. All rights reserved.
Quiz
Select the advantages of running Essbase as a Windows
Service.
1. You cannot accidentally close the agent window.
2. When Essbase Server is started from a client process, the
agent does not automatically shut down when the client
process is shut down.
3. You cannot use the agent commands.
4. You can give priority to foreground services.
Copyright © 2009, Oracle. All rights reserved.
Quiz
Select the Essbase log files.
1.
2.
3.
4.
Server log
Application log
Outline change log
Captain's log
Copyright © 2009, Oracle. All rights reserved.
Quiz
The Essbase configuration file (essbase.cfg) specifies serverwide application and database settings.
1. True
2. False
Copyright © 2009, Oracle. All rights reserved.
Summary
In this lesson, you should have learned to:
• Set up runtime and connection options for Essbase
• Configure block storage and aggregate storage disk
allocation
• Identify the primary information logs available to
Essbase system administrators
• Create an essbase.cfg server configuration file
• Configure Smart View for Office
Copyright © 2009, Oracle. All rights reserved.