About

Настройка протоколов аудита работы Essbase

 

Essbase предоставляет простую и мощную систему для контроля своей работы, которую можно масштабировать, в зависимости от предъявляемых требований к системе. Существует несколько уровней логирования от info до critical, определяемых параметрами AGENTLOGMESSAGELEVEL и LOGMESSAGELEVEL в конфигурационном файле essbase.cfg, располагающимся в каталоге %HYPERION_HOME%\AnalyticServices\bin.

 

В системе предусмотрено двухуровневое логирование : на уровне сервера и на уровне приложения.

1 Анализ логов

Происходит посредством «ручного» просмотра файла с логами работы системы. Обычно это требуется при возникновении «внешних» признаков неработоспособности системы

•    неприемлемо долгое время ответа системы на запрос получения данных

•    генерация *.xcp файлов

•    и прочие ошибки

На основе файла логов приложения можно , с помощью инструментария предоставляемого Administration Service Console, анализировать активность пользователей и загрузку сервера.

Подробности о количестве и составе файлов, в которых пишется деятельность сервера, и о протоколируемой информации в Analytic Server смотрите в документе

2 Настройки системы, влияющие на состав и уровень протоколируемой информации

 

2.1. Настройки протоколирование на уровне сервера

AGENTLOGMESSAGELEVEL – настройка файла essbase.cfg, которая определяет, что бы Analytic Server писал все сообщения (INFO), либо сообщения о предупреждениях (WARNING), либо только сообщения об ошибках (ERROR) в файл протоколирования Analytic Server.

PORTUSAGELOGINTERVAL – настройка файла essbase.cfg, которая определяет интервал для записи в лог количество свободных и занятых портов

2.2. Настройки протоколирование на уровне приложения

LOGMESSAGELEVEL (INFO,WORNING,ERROR) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал либо все сообщения, либо предупреждения, либо ошибки в файл логов приложения

TIMINGMESSAGES (TRUE | FALSE) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал длительность выполнения каждого пользовательского запроса на получения данных.

SSLUNKNOWN (TRUE | FALSE) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал сообщения о ошибке включающие в себя запросы на получение значений с несуществующих элементов.

SET MSG настройка в файле скрипта, которая определяет как и что Analytic Server буде писать в лог приложения (Суммарную статистику по этому скрипту, расширенную стистику, настрйку уровней сообщений (без них, ошибки, предупреждения, все сообщения)

2.3. Настройка протоколирования пользовательских запросов

Для включения опции протоколирования пользовательских запросов, создайте файл dbname.cfg в директории базы данных используя следующей синтаксис:

•    Определение направления, обращения к которому будет протоколироваться QUERYLOG [dimension_name]

•    Глубина протоколирования по поколениям или по уровням: QUERYLOG GENERATION generation-range or QUERYLOG LEVEL level-range)

•    Исключение из протокола запросов: QUERYLOG NONE GENERATION generation-range or QUERYLOG NONE LEVEL level-range

•    Включать в протокол запросы к элементам нулевого уровня при HOLAP QUERYLOG LOGHAMBRS ON | OFF

•    Месторасположение файла логов QUERYLOG LOGPATH path-expression

•    Формат логов файлов QUERYLOG LOGFORMAT CLUSTER | TUPLE

•    Размер одного файла логов QUERYLOG LOGFILESIZE n

•    Общий размер всех файлов QUERYLOG TOTALLOGFILESIZE n

•    Включить или выключить логирование при следующем запуске базы QUERYLOG ON | OFF

 

Пример файла
# Log the Product dimension
QUERYLOG [Product]
# Log Hybrid Analysis members of Product, if applicable
QUERYLOG LOGHAMBRS ON
# Log the Market dimension
QUERYLOG [Market]
# Log members of generation 2 of Market by generation number
QUERYLOG GENERATION 2
# Display log output in cluster format
QUERYLOG LOGFORMAT CLUSTER
# Create log file in C:\QUERYLOG\
QUERYLOG LOGPATH C:\QUERYLOG\
# Start a new log file after an individual log file size reaches 2 MB
QUERYLOG LOGFILESIZE 2
# Turn off query logging after the total size of all log files reaches 1024 MB (1 GB)
QUERYLOG TOTALLOGFILESIZE 1024
# Enable query logging
QUERYLOG ON

2.4. Настройка протоколирование изменений структуры метаданных

OUTLINECHANGELOG (TRUE | FALSE) настройка файла essbase.cfg, которая имеет значение TRUE, для создания файла протоколов изменений

OUTLINECHANGELOGFILESIZE n настройка файла essbase.cfg, которая определяет максимальный размер файла протокола.

2.5. Настройка протоколирования создания направлений

DATAERRORLIMIN n настройка файла essbase.cfg, которая определяет максимальное количество записей в файле dataload.err

2.6. Очистка файла протоколов работы сервера

CLEARLOGFILE (TRUE | FALSE) настройка файла essbase.cfg, в значении TRUE очищает лог сервера или приложений в случае их перезапуска

Алгебра #Missing

Результат алгебраического выражения с участием #MISSING

Calculation/Operation

Result

X + #MISSING X
X – #MISSING X
#MISSING X -X
X * #MISSING #MISSING
X / #MISSING #MISSING
#MISSING / X #MISSING
X / 0 #MISSING
X % #MISSING #MISSING
#MISSING % X #MISSING
X % 0 #MISSING
X == #MISSING False, unless X is #MISSING
X != #MISSING True, unless X is #MISSING
X <> #MISSING True, unless X is #MISSING
(X <= #MISSING) (X <=0)
(X >= #MISSING) (X >=0) or (X == #MISSING)
(X > #MISSING) (X > 0)
(X < #MISSING) (X < 0)
IF (#MISSING) IF (0)
f (#MISSING) #MISSING for any Essbase function of one variable
f (X) #MISSING for any X not in the domain of f, and any Essbase function of more than one variable (except where specifically noted)

Hyperion – использование портов TCP

Shared Services Web Application Ports

Port Type

Default Port Number

Where Configurable

Listen port

28080

EPM System Configurator

SSL listen port

28443

EPM System Configurator

Shutdown Port for embedded Java container

28081

HYPERION_HOME/deployments/AppServNameAndVersion/SharedServices9/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

28082

HYPERION_HOME/deployments/AppServNameAndVersion/SharedServices9/conf/server.xml

For parameters, see the application server documentation.

Shared Services Default Service Ports

Service

Default Port Number

Where Configurable

Remote Authentication Module

28000

Remote Authentication Module installation program

Oracle’s Hyperion® Remote Authentication Module

Additional dynamic port (1)

Not configurable

OpenLDAP

28089

  • UNIX:HYPERION_HOME/products/Foundation/openLDAP/startOpenLDAP.sh
  • Windows: Edit the Windows Registry —HKEY_LOCAL_MACHINE/SOFTWARE/OpenLDAP/Parameters/Urls

Oracle Internet Directory (if used as Shared Services Native Directory)

389

636 (SSL)

See the Oracle Internet Directory documentation.

EPM Workspace Default Service Ports

Service

Default Port Number

Where Configurable

Foundation ports:

  • Global Services Manager (GSM)
  • Core Service
  • Service Broker
  • Job Service
  • Event Service
  • Repository Service

6800 – 6810


 

  • EPM System Configurator
  • Configuration and Monitoring Console

Annotation Service

8199

Configuration and Monitoring Console

EPM Workspace Web Server Port

Server

Default Server Port

Where Configurable

Apache and IBM HTTP Server

19000

WEB_SERVER_HOME/conf/httpd.conf

IIS and Oracle HTTP Server

80

443 (SSL)

Microsoft Internet Information Services (IIS) Manager Console. Change the TCP port value setting.

EPM Workspace Web Application Ports

Port Type

Default Port Number

Where Configurable

Listen port

45000

EPM System Configurator

Additional listen port (1)

Dynamic

Not configurable

SSL listen port

45043

EPM System Configurator

Shutdown port for embedded Java container

45001

HYPERION_HOME/deployments/AppServNameAndVersion/Workspace/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

45002

HYPERION_HOME/deployments/AppServNameAndVersion/Workspace/conf/server.xml

For parameters, see the application server documentation.

Performance Management Architect Web Application Ports

Port Type

Default Port Number

Where Configurable

Performance Management Architect UI

  

  

Listen port

19091 (can be configured for SSL)

EPM System Configurator

SSL listen port

19047

EPM System Configurator

Shutdown port for embedded Java container

19092

HYPERION_HOME/deployments/AppServNameAndVersion/EPMAWebServer/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

19093

HYPERION_HOME/deployments/AppServNameAndVersion/EPMAWebServer/conf/server.xml

For parameters, see the application server documentation.

Data Synchronizer Web Service (Performance Management Architect)

  

  

Listen port

19101 (can be configured for SSL)

EPM System Configurator

SSL listen port

19145

EPM System Configurator

Shutdown port for embedded Java container

19102

HYPERION_HOME/deployments/AppServNameAndVersion/EPMADataSynchronizer/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

19103

HYPERION_HOME/deployments/AppServNameAndVersion/EPMADataSynchronizer/conf/server.xml

For parameters, see the application server documentation.

Performance Management Architect Dimension Server Default Service Ports

Services

Default Port Number

Where Configurable

Server Manager

5250

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<ServerManagerPort>portNumber</ServerManagerPort>

Process Manager

5251

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<Port>portNumber</Port>

web.config file under the webservices directory

<appSettings> parameter

<add key=”ProcessManagerPort” value=”portNumber“/>

Event Subscription

5252

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<EventSubscriptionPort>portNumber</EventSubscriptionPort>

Event Manager

5253

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<EventManagerPort>portNumber</EventManagerPort>

Job Manager

5254

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<JobManagerPort>portNumber</JobManagerPort>

Engine instances

5100–5140

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<MinEnginePort>portNumber</MinEnginePort>

<MaxEnginePort>portNumber</MaxEnginePort>

Net JNI Bridge

5255

HYPERION_HOME/products/Foundation/BPMA/AppServer/DimensionServer/ServerEngine/bin/BPMA_Server_Config.xml

<NetJNIBridgePort>portNumber</NetJNIBridgePort>

Performance Management Architect Web Server Port

Default Web Server Port

Where Configurable

80

Microsoft Internet Information Services (IIS) Manager Console. Change the TCP port value setting.

Essbase Default Service Ports

Service

Default Port Number

Where Configurable

Essbase Agent

1423

EPM System Configurator

Essbase server applications (ESSSVR)

32768–33768 (two ports per process)

EPM System Configurator

Oracle Essbase Integration Services Server

3388

HYPERION_HOME/products/Essbase/eis/bin/ais.cfg

Add -Pportnumber

Administration Services Web Application Ports

Port Type

Default Port Number

Where Configurable

Listen port

10080

EPM System Configurator

SSL listen port

10083

EPM System Configurator

Shutdown port for embedded Java container

10081

HYPERION_HOME/deployments/AppServNameAndVersion/eas/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

10082

HYPERION_HOME/deployments/AppServNameAndVersion/eas/conf/server.xml

For parameters, see the application server documentation.

Provider Services Web Application Ports

Port Type

Default Port Number

Where Configurable

Listen port

13080

EPM System Configurator

SSL listen port

13083

EPM System Configurator

Shutdown port for embedded Java container

13081

HYPERION_HOME/deployments/AppServNameAndVersion/aps/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

13082

HYPERION_HOME/deployments/AppServNameAndVersion/aps/conf/server.xml

For parameters, see the application server documentation.

Essbase Studio Ports

Port Type

Default Port Number

Where Configurable

Listen port

5300

HYPERION_HOME/products/Essbase/EssbaseStudio/Server/server.properties

Parameters: transport.port=new port number

HTTP listen port

9080

HYPERION_HOME/products/Essbase/EssbaseStudio/Server/server.properties

Parameters: Server.httpPort=new port number

Financial Reporting Web Application Ports

Port Type

Default Port Number

Where Configurable

Listen port

8200

EPM System Configurator

SSL listen port

8243

EPM System Configurator

Shutdown port for embedded Java container

8201

HYPERION_HOME/deployments/AppServNameAndVersion/FinancialReporting/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

8202

HYPERION_HOME/deployments/AppServNameAndVersion/FinancialReporting/conf/server.xml

For parameters, see the application server documentation.

Financial Reporting Default Service Ports

Service

Default Port Number

Where Configurable

Financial Reporting Report Service

Dynamic (2)

HYPERION_HOME/products/biplus/lib/fr_repserver.properties

Parameters: HRRepSvrPort1HRRepSvrPort2

Financial Reporting Scheduler Service

Dynamic

HYPERION_HOME/products/biplus/lib/fr_scheduler.properties

Parameter: HRSchdSvrPort

Financial Reporting Print Service

Dynamic

HYPERION_HOME/products/biplus/lib/fr_printserver.properties

Parameter: HRPrintSvrPort

Oracle Hyperion Financial Reporting, Fusion Edition Communication Service

8299

HYPERION_HOME/products/biplus/lib/fr_global.properties

Parameter: RMIPort

Remote ADM Server port for Planning data source access

Dynamic

HYPERION_HOME/common/ADM/VERSION/lib/ADM.properties file on the Report Server machine

Parameter: ADM_RMI_SERVER_PORT

Planning Web Application Ports

 

Port Type

Default Port Number

Where Configurable

Listen port

8300

EPM System Configurator

Additional listen port (1)

Dynamic

Not configurable

SSL listen port

8343

EPM System Configurator

Shutdown port for embedded Java container

8301

HYPERION_HOME/deployments/AppServNameAndVersion/HyperionPlanning/conf/server.xml

For parameters, see the application server documentation.

AJP connector port for embedded Java container

8302

HYPERION_HOME/deployments/AppServNameAndVersion/HyperionPlanning/conf/server.xml

For parameters, see the application server documentation.

Planning Default Service Port

Service

Default Port Number

Where Configurable

Planning RMI Server

11333

HYPERION_HOME/common/RMI/VersionNumber/HyperionRMI_Port.properties

Parameter: registryPort

Note:

For information about additional requirements when changing Oracle Hyperion Planning, Fusion Edition ports, see “Reconfiguring EPM System Products” in Oracle Hyperion Enterprise Performance Management System Installation and Configuration Guide.

 

 

 

 

 

Transparent partition

Transparent partition

 

Позволяют пользователям манипулировать данными, хранящимися в отдаленных местах, как если бы они были частью локальной базы данных. В этом смысле они очень похожи на механизм VIEW в реалиционных БД. Удаленные данные берутся из источника всякий раз, когда пользователь, находящиеся в получателе, делает соответствующий запрос. Пользователям не требуется знать, где хранится информация, так как они видят ее как часть своей локальной базы данных.

 

 

Так как данные берутся прямо из источника, пользователь получает их последнюю версию. При обновлении данных пользователем, сделанные изменения переносятся обратно в источник. Это означает, что как у пользователей, находящихся у источника, так и у тех, кто находится у получателя данных, имеется непосредственный доступ к этим изменениям.

 

Прозрачные области, разделяемые схемами источника и получателя, не обязательно должны быть абсолютно одинаковыми. Главное требование – установить их соответствие друг другу. Это значит,что необходимо указать, каким образом каждое аналитическое направление и элемент источника будут отображены в соответствующих аналитических направлениях и элементах получателя.

Отображение соответствия схем данных источника и получателя не обязательно для схем неразделяемых областей.

Прозрачный раздел можно создать поверх реплицированного. Иными словами, можно создать получатель прозрачного раздела, используя источник реплицированного раздела.

Прозрачный раздел нельзя создавать поверх более чем одного раздела иного рода. Другими словами, нельзя создать получатель прозрачного раздела на основании нескольких источников.

Причина в том, что каждая ячейка базы данных берется только из одного места – локального или удаленного диска.

 

Преимущества :

Требуется меньше пространства на диске, так как информация хранится в одной базе данных.

Данные, запрашиваемые из получателя, всегда последние по времени.

Когда пользователь обновляет данные в источнике, сделанные изменения переносятся и в получатель.

Размер отдельных баз данных меньше, поэтому расчеты производятся быстрее.

Распределение данных невидимо для конечного пользователя и его инструментов.

Данные можно загружать и из источника, и из получателя.

 

Недостатки :

Прозрачные разделы повышают нагрузку на сеть, так как данные переносятся по сети от источника к получателю. Повышенная нагрузка на сеть приводит к замедлению получения данных пользователями.

Время извлечения данных замедляется и от того, что большему числу пользователей приходится обращаться к источнику данных.

Если происходит сбой источника данных, от этого страдают пользователи, находящиеся и у источника, и у получателя. Это означает, что сеть и источник данных должны быть доступны всякий раз, когда в них возникает потребность у пользователей, находящихся у источника или у получателя данных.

Некоторые административные операции можно выполнять только на локальных данных. Например, если архивируется получатель, то при этом не архивируется источник данных. Следующие административные операции выполняются только на локальных данных:

•    CLEARDATA;

•    DATACOPY;

•    EXPORT;

•    VALIDATE;

•    BEGINARCHIVE и ENDARCHIVE;

•    прочие операции по преобразованию в Диспетчере приложения;

 

Настройки производительности для Transparent Partitions

 

  • Разделение плотных аналитических направлений в прозрачном разделе может значительно замедлить скорость работы. Причина в том, что плотные аналитические направления используются для определения структуры и содержания блоков данных. Если база данных разделена только по плотному аналитическому направлению у получателя, системе потребуется составление блоков данных путем выполнения сетевых запросов удаленных данных в прозрачном разделе, помимо ввода-вывода данных для локальной части блока.
  • Загрузка данных в источник из получателя значительно снижает скорость работы. Данные по возможности следует загружать в источник локально.
  • Время извлечения информации замедляется, так как пользователи запрашивают данные через сеть
  • Для контроля работы можно использовать параметр ENABLE_DIAG_TRANSPARENT_PARTITION в файле essbase.cfg

 

Использование в расчетах Transparent Partitions

Когда выполняется расчет на transparent partition, Essbase выполняет расчет с использованием существующих значений локальных данных и зависимых от партиции. Когда расчет доходит до данных из партиции, то он работает в режиме bottom-up, если выполняется условие по оптимальному использованию кеша калькулятора. Увеличение его размера значительно повышает производительность расчетов, за счет уменьшения итераций по выборке данных из источника – это можно наблюдать, просматривая лог расчета, в сообщениях об использовании кеша калькулятора в целевой БД. Так же расчет сильно зависит от top-down формул на элементах.

Если вы абсолютно уверены в том, что ваш расчет не зависит от данных, лежащих на удаленной БД , можете смело использовать команду SET REMOTECALC OFF

 

 

 

 

 

Hyperion Essbase Optimization: Настройки кеша калькулятора

What is the Calc Cache?

Calc Cache – занимает ключевое место в связке между ядром Essbase и другими промежуточными облостями памяти Essbase BSO. Он используется калькулятором не для хранения данных, но содействует агрегации, когда требуется рассчитать и создать блок верхнего уровня. Continue reading “Hyperion Essbase Optimization: Настройки кеша калькулятора”