Business Analytics Newsletter v6 on Dec 06, 2012

Основные моменты

• The Premier Support for Oracle Business Intelligence Enterprise Edition 10.1.3.x ended in July 2013.
• The Premier Support product life cycle for Oracle Business Intelligence Enterprise Edition (OBIEE) and Oracle Business Intelligence Publisher 11.1.1.5 ends March 2013.
• Oracle's Hyperion Application Builder.NET (HAB.NET) will not be available for distribution with newer releases of Oracle Essbase. Release 11.1.1.1 is the terminal release. Premier Support for Oracle Hyperion Application Builder.NET 11.1.1.1 ends July 2013, after which Sustaining Support will be provided.
• After 1st January, 2013, Oracle Essbase Spreadsheet Add-in will no longer be available for general distribution with new releases of Oracle Essbase.
• Please be advised that release 11.1.2.2 is the terminal release of the XBRL functionality in Oracle Hyperion Financial Reporting. Premier Support for Oracle Hyperion Financial Reporting release 11.1.2.x ends in April 2015, after which Extended Support is available in April 2018, and Sustaining Support will continue to be provided. Oracle recommends Oracle Hyperion Disclosure Management.

NOTE: "Sustaining Support" does NOT include:

• New program updates, fixes, security alerts, and critical patch updates
• New tax, legal and regulatory updates
• New upgrade scripts
• Certification with new third party products/versions
• 24 hour commitment and response guidelines for Severity 1 service requests.

EPM Patch Set Updates - Recent Releases

The following list are all Patch Set Updates (PSU) (as at 1-Dec-12) that have been released since the last Business Analytics newsletter issue:

Изменение датасурса таблицы отчета Financial Reporting

Задача стоит так: изменить датасурс таблицы в одном отдельно взятом отчете FR (а не во всех). Источник – новое (другое, не промышленное) приложение HFM. Продакшн система – EPM 11.1.2.00.

Ограничение: В самом отчете через FR Studio для ранее настроенной таблицы данных (grid) изменить датасурс нельзя

Два пути решения: Вручную заново создать и собрать таблицу (долго и можно ошибиться) или изменить датасурс.

Если нужно изменить датасурс для всех таблиц отчетов, то нужно просто обновить существующий DB Connection на другое приложение: Workspace - Explore - Tools - DB Connection Manager

Решаем поставленную задачу:

1.    Создаем новый датасурс (DB Connection) для нового приложения HFM

a.    Идем в Workspace - Explore - Tools - DB Connection Manager
b.    Создаем новый датасурс на новое приложение, назовем его DS_new

2.    Получаем правильную ссылку на новый датасурс

Для этого нужно:
a.    Накидать новый простейший отчет с таблицей (кинуть по измерению в строки и столбцы, этого достаточно), привязавшись к DS_new. Назовем отчет REP_test
b.    Сохранить таблицу (grid) как отдельный объект в FR Studio (на заголовке Grid через райт-клик вызвать Save Object). Назовем таблицу GRID_test
c.    Экспортировать эту таблицу c помощью LCM на диск: LCM (HSS) - Application Groups – Reporting and Analysis – Repository Objects - <нужный объект>
d.    На диске (в папке import_export) найти файлик вида 00000136f2bdb8b6-0000-b8b3-ac16006a (GRID_test).00000136f2bdb8c8-0000-b8b3-ac16006a_1, где GRID_test - это имя, указанное при выгрузке в LCM
e.    Открыть этот файл в Notepad++ (любимом текстовом редакторе) и из него скопировть ссылку на новый нужный датасурс (вторая строка): поля DATASOURCE_DETAILS и DATASOURCE_ID

Замечание: при выгрузке отчета целиком (REP_test), я не смог найти этих объектов и ссылки на DS_new, поэтому пришлось экспортировать отдельно таблицу (GRID_test). См. шаги 2 b - 2 d

f.    После этого объекты REP_test и GRID_test в FR Studio можно удалить

3.    Обновляем датасурс таблицы данных (grid)

Для этого нужно:
a.    Сделать копию оригинального отчета. Назовем копию REP_new
b.    Сохранить таблицу (grid) из REP_new как отдельный объект в FR Studio. Назовем таблицу GRID_new
c.    Экспортировать эту таблицу c помощью LCM на диск
d.    На диске (в папке import_export) найти файлик вида 00000136f2bdb8b6-0000-b8b3-ac16006a (GRID_new).00000136f2bdb8c8-0000-b8b3-ac16006a_1, где GRID_new - это имя, указанное при выгрузке в LCM
e.    Открыть этот файл в Notepad++ и заменить в нем ссылку на новый нужный датасурс (вторая строка): поля DATASOURCE_DETAILS и DATASOURCE_ID, полученные на шаге 2 e.
f.    Удалить в FR Studio объект GRID_new
g.    Импортировать с помощью LCM обратно в R&A обновленный на шаге 3e GRID_new
h.    Открыть отчет REP_new, удалить в нем имеющуюся таблицу (grid)
i.    Импортировать в отчет REP_new обновленный GRID_new: Insert – Saved Objects
j.    Задать таблице нужные размеры и сохранить отчет, убедившись, что датасурс таблицы обновлен

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

Копирование созданных в CalcMngr правил без LCM

      В продолжение поста о копировании приложения Planning, использующего EPMA 11.1.2.0 и Calculation Manager (далее – CalcMngr), опишу как можно скопировать созданные в CalcMngr правила из одного приложения Planning в другое, поскольку LCM в релизе 11.1.2.0 эту задачу не выполняет: 

1. Выгрузить правила (а если используются Rulesets, то работать далее с ними; но не забыть повторить процедуру для тех правил, которые не попали в Rulesets) существующего приложения в CalcMngr. Для этого выделить все Rules (Rulesets) в исходном приложении, затем File – Export.
2. Исправить в полученном XML-файле с помощью Notepad++ все значения с именем старого приложения на имя нового приложения Planning по маскам:
   
   
   property name="application">староеИмя
   на property name="application">новоеИмя
   property name="scope">староеИмя.имяКуба
   на property name="scope">новоеИмя.имяКуба
   
   для Rulesets добавится еще одна маска замены
   property name="launch_application">староеИмя
   на property name="launch_application">новоеИмя
   
   
3. (опционально) С именами кубов поступить аналогично. Маски просты и доступны в XML.
4. Импортировать обновленные по пп. 2-3 правила. Для этого в CalcMngr перейти File – Import. В опциях операции лучше установить параметры: Skip Exisitng Objects и Update Location Details (выбрать целевое приложение Planning и его куб).
5. Деплоить эти правила (наборы правил). Переменные (и правила в случае Rulesets) уже будут импортированы.
6. Проверить наличие всех необходимых переменных для правил, сравнив с исходным приложением Planning.В случае необходимости скопировать используемые в правилах переменные по инструкции вендора. Чтобы ускорить этот процесс, можно выделить все необходимые переменные Ctrl+Left Click, Right Click - Copy, а затем вставить их в целевое приложение и сохранить.

Деплой приложения Planning в EPMA 11.1.2.0

В EPMA 11.1.2.0 есть такой баг в отношении приложений Planning: Невозможно задеплоить/передеплоить приложение Planning после добавления атрибутивного измерения.
Причины проблемы описаны в Deploy Aborts When Deploying Planning Attribute Dimension (1118393.1).

В моем случае было необходимо сделать копию приложения Planning на EPMA, в котором есть такие измерения, на том же инстансе. Порядок решения проблемы:

1. Скопировать приложение Planning в Application Library (Duplicate – As New Appliction).
2. Создать новый датасорс в Application Library (Tools – Manage Planning Data Source).
3. С помощью EPM Architect File Generator выгрузить метаданные из существующего (оригинального) приложения.
4. Удалить привязанные к элементам направлений UDA ссылки на HSP_UDF.  Для этого сделать копию файла из п.3 и с помощью Notepad++ заменой удалить все упоминания HSP_UDF, сохранив файл в UTF-8.
5. Загрузить в новое приложение метаданные (File – Import Dimensions) из файла по п.4. В профайле импорта смело устанавливаем Merge (тип обновления) и опцию Remove Target Value for Missing Source Properties для НЕатрубутивных измерений.
6. Удалить в новом приложении проблемное атрибутивное измерение. Ассоциации с другими измерениями удаляться автоматически.
7. Сделать деплой приложения и рефреш Application Library.
8. Накатить метаданные оригинального приложения Planning аналогично п.5, используя оригинальный файл метаданных из п.3.
9. Сделать деплой приложения и рефреш Application Library.
10. С помощью LCM накатить остальные артефакты приложения. Про перенос правил расчетов CalcMngr написал отдельно. Формы данных переносить после переноса правил. Какие данные накатывать в Essbase – решать по задаче.

Трудозатраты: 1,5 часа.

Отличная вводная презентация про новый EPM 11.1.2.1 и как на него перейти (англ.): http://vimeo.com/21658460

Как верно провести первичную настройку EPM System 11.1.2

Наконец-то появились задачи по работе со свежайшей (на сегодня) версии Oracle EPM System 11.1.2. Сразу скажу, что у этой версии от предшественницы (11.1.1.3) появилось сразу несколько негативных отличий:
- Субъективное: дизайн. Понятно, что подогнали под 11-ую линейку Fusion MiddleWare. Но цветовая гамма предшественницы радовала гораздо больше! Может быть, Oracle выложит файлики с предыдущими темами оформления?!
- Миграционное: LCM без проблем не может импортировать выгрузки даже из предыдущей версии. Хотя в 11.1.2.1 (он же SP1) обещают исправить.
- Стартовое: изменился порядок первичной настройки (конфигурирования) системы сразу после установки.

О последнем и напишу подробнее в этой статье.
Сразу скажу, что задачи крутятся вокруг Planning. Я устанавливаю всё на MS Win2003 Server R2 (64bit; Standard Edition) с MS SQL Server 2005 SP4.
Компоненты, которые я распаковал для установки:
- Foundation: Foundation Services, Performance Management Architect, CalcManager;
- Essbase;
- Planning;
- Reports & Analysis: Financial Reporting, Web Analysis.
При первой установке решил пройтись по накатанной (как в 11.1.1.3). Ан-нет! Не случилось. В первый раз подвел Oracle HTTP Server. Во второй – не смог настроиться Essbase. Как оказалось из-за неверного/неполного удаления предыдущее инсталляции. Как все почистить целиком, и установить заново, читайте здесь.

Сразу отмечу, что стоит создавать для каждого компонента СВОЮ отдельную базу. И устанавливайте каждой базе свойство AutoShrink = True.

Поковырявшись в гугле и оракл-форумах, пошел дед закидывать невод решился на третью попытку. В этот раз все прошло так и даже работает:
Итак, вот порядок удачных действий:
1. После установки идем через Пуск в EPM System Configurator. Делаем uncheck всех компонентов и выбираем в Hyperion Foundation только: Common Settings, Configure Database, Configure Oracle Configuration Manager. Соглашаемся на все. Я выбрал в качестве веб-сервера Oracle HTTP-Server. Насчет поддержки Oracle Support: если у вас промышленный сервер и он смотрит в интернет (пусть через проксю), то можете соглашаться и настраивать. Там все просто. В ином случае – плюньте на этот момент. В ходе установки задайте дефолтовый админский пароль.
2. Если все хорошо, то идем опять в EPM System Configurator (или Task Panel, если вы не закрыли сам конфигуратор) и деплоим (применяем) Shared Services, выбрав только Configure Web Server и Deploy to App Server. Тут все просто. Нужно только придумать и записать пароль для домена Oracle WebLogic.
3. После этого этапа можно сразу зайти через web в консоль Shared Services и подключить MSAD. При использовании IIS: если не стартует веб-приложение, через консоль IIS запустите веб-узлы и приложения, не забыв назначить для узлов использовать ASP.NET 2.x.
4. Теперь через EPM System Configurator настраиваем сам компонент Essbase, остальные пока можно оставить в сторонке.
5. Затем также настраиваем все остальные компоненты вкладки Essbase, но по порядку и по одному! Для проверки этих компонент нужно иметь запущенными сервисы: Foundation Servoces, Oracle Proccess Manager (EPM_epmsystem1), Administration Services.
6. Конфигурируем EPMA. Здесь все просто, НО: при создании БД под EPMA нужно проверить свойства READ_COMMITTED_SNAPSHOT и ALLOW_SNAPSHOT_ISOLATION. Они должны иметь значения ON. Если лень искать, то просто запустите следующий скрипт:

ALTER DATABASE HP11_EPMA SET READ_COMMITTED_SNAPSHOT ON;
ALTER DATABASE HP11_EPMA SET ALLOW_SNAPSHOT_ISOLATION ON;

где HP11_EPMA – база под EPMA.
7. Конфигурируем CalcManager. Все просто.
8. Конфигурируем Planning. Сначала все доступные компоненты, а затем кластер.
9. Конфигурируем Reporting & Analysis.
10. А теперь, чтобы все было доступно в Workspace, выполняем задачи:
- Configure Web Server
- и Configure Logical Address for Application Server под Hyperion Foundation.

Вот и все! Если все разворачиваете на Oracle HTTP-Server, то стучитесь к компонентам через 19000 порт после запуска всех нужных сервисов! Например, http://localhost:19000/workspace/

Enjoy!

UPD: В реестре HKLM\SOFTWARE\Hyperion Solutions установите значения -Xms512m / -Xmx1024m везде, где найдете, и перезапустите сервисы для лучшей их производительности.

Бэкап компонент EPM 11.1.2

Следуя рекомендациям Oracle, настроим бэкап следующего:
- Директории с конфигурациями продуктов EPM
%Hyperion_Home%\user_projects\epmsystem1\config
- Директорию WebLogic Domain
%Hyperion_Home%\user_projects\domains\EPMSystem
- Директорию контента LCM
%Hyperion_Home%\user_projects\epmsystem1\import_export
- Веток реестра с параметрами EPM
- Директории с настройками и данными приложений

Последний пункт обычно автоматизируют отдельно, о чем написано:
- Здесь про данные из баз приложений Essbase.
- Здесь про формы Planning.
- Некоторые дополнения напишу позже.
Поэтому в скрипте ниже эти моменты пропустим.

Итак, с целью максимальной автоматизации делаем следующее:
- Создаем папочку под бэкапы EPM. У меня это d:\BACKUP\EPM. Структура такова:

- Ложим туда такой bat-файл:

rem Batch 7zipped backup script by Antun Kulkov, 2011
@echo off
set year=%date:~6%
set month=%date:~3,2%
set day=%date:~0,2%
set hour=%time:~0,2%
if "%hour:~0,1%"==" " set hour=0%time:~1,1%
set minute=%time:~3,2%
set tdate=%year%-%month%-%day%-%hour%%minute%
set DOMAIN_HOME=C:\Hyperion\user_projects
set BACKUP_HOME=d:\BACKUP\EPM
set ZIP_HOME="c:\Program Files\7-Zip"
@echo on
rem Config Backup
%ZIP_HOME%\7za.exe a -t7z %BACKUP_HOME%\config\config-%tdate%.7z %DOMAIN_HOME%\epmsystem1\config -m0=BCJ -m1=LZMA:d=21 -mx=9 -ms -mmt > %BACKUP_HOME%\config\config-%tdate%.log

rem WebLogic Domain Dir Backup
rem call "%DOMAIN_HOME%\domains\EPMSystem\bin\stopWebLogic.cmd" %*
%ZIP_HOME%\7za.exe a -t7z %BACKUP_HOME%\weblogic_domain\wldomain-%tdate%.7z %DOMAIN_HOME%\domains\EPMSystem -m0=BCJ -m1=LZMA:d=21 -mx=9 -ms -mmt > %BACKUP_HOME%\weblogic_domain\wldomain-%tdate%.log
rem call "%DOMAIN_HOME%\domains\EPMSystem\bin\startWebLogic.cmd" %*

rem Lifecycle Management content Backup
%ZIP_HOME%\7za.exe a -t7z %BACKUP_HOME%\LCM_impexp\lcm-%tdate%.7z %DOMAIN_HOME%\epmsystem1\import_export -m0=BCJ -m1=LZMA:d=21 -mx=9 -ms -mmt > %BACKUP_HOME%\LCM_impexp\lcm-%tdate%.log

rem Registry Backup
set rkey_hklm="HKEY_LOCAL_MACHINE"
set rkey_osenv="HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment"
DEL %BACKUP_HOME%\registry\*.reg
REG EXPORT %rkey_hklm% %BACKUP_HOME%\registry\HKLMreg-%tdate%.reg
REG EXPORT %rkey_osenv% %BACKUP_HOME%\registry\OSEnv-%tdate%.reg
%ZIP_HOME%\7za.exe a -t7z %BACKUP_HOME%\registry\reg-%tdate%.7z %BACKUP_HOME%\registry\*.reg -m0=BCJ -m1=LZMA:d=21 -mx=9 -ms -mmt > %BACKUP_HOME%\registry\reg-%tdate%.log
DEL %BACKUP_HOME%\registry\*.reg

rem Finished!

Все достаточно прозрачно:
- Сначала задаем нужные переменные для дат/времени и директорий DOMAIN_HOME (она = %Hyperion_Home%\user_projects\), BACKUP_HOME (собственно куда класть бэкапы) и ZIP_HOME (папка с архиватором; у меня 7-zip).
- Затем бэкапим то, что я описал в самом начале статьи.
- Отдельно про WebLogic Domain. Рекомендуют останавливать, но можно и так)) Поэтому я закомментил его остановку и старт. Вообще рекомендуют полную остановку EPM, но у меня разброс филиалов в 7 часовых поясов, что не позволяет выводить систему из рабочего состояния.
- Отдельно про реестр. Переменная rkey_hklm – это ветка реестра HKLM, где, в том числе, лежат параметры EPM. Здесь можно выбрать и конкретную ветку Hyperion Solutions, но я решил бэкапить все. А rkey_osenv – ветка с переменными окружения Windows. Порядок работы такой: выгружаем из реестра в два файла, бэкапим в архив и прибираемся, удаляя файлы выгрузок.

Ну, и добавляем наш волшебный файлик в Task Scheduler по расписанию. Enjoy!

Как удалить EPM System 11.1.2

Иногда случается так, что компоненты Oracle EPM System 11.1.2 запороты кривыми руками =) и необдуманными действиями, или понятно, что переустановить будет быстрее, чем разобраться в проблемах.
Переустановка некоторых компонентов также может не дать результатов, а при полном удалении этих компонентов и новой их инсталляции EPM System Configurator сходит с ума, неверно отражая иерархию и не позволяя управлять большинством Foundation компонентов. У меня такое наблюдалось при проблемах конфигурации Essbase, которые были вызваны ошибками при установке Essbase.
Мое окружение: MS Win2003 Server R2 (64bit; Standard Edition) и MS SQL Server 2005 SP4.

Итак! Всё, что смогли – забэкапили через LCM или дедовскими методами и в путь:
1. Останавливаем все сервисы EPM и Oracle Proccess Manager (можно через Пуск).
2. Идем через Пуск в Uninstall EPM System и следуем инструкциям, удаляя ВСЁ!
3. Перезагружаемся!
4. Удаляем все то, что не подчистил Uninstaller:
a. Установочную директорию (EPMSystem_Home). У меня это C:\Hyperion;
b. В реестре ветку HKEY_LOCAL_MACHINE\SOFTWARE\Hyperion Solutions;
c. В реестре ветку HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\opmn_EPM_epmsystem1;
d. В реестре ветку HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\Oraclec_hyperion_epmsys~1c_hyperion_user_projects_epmsystem1ConfigurationManager (в моем случае Oraclec_hyperion_epmsys~1c_hyperion – это производное от пути к основным компонентам c:\hyperion\epmsys~1 и установочной директории c:\hyperion)
5. Перезагружаемся!
6. Удаляем с помощью ccleaner все баги в реестре, в том числе HKEY_LOCAL_MACHINE\SYSTEM\ControlSet002\Enum\Root\LEGACY_ORACLEC_HYPERION_EPMSYS~1C_HYPERION_USER_PROJECTS_EPMSYSTEM1CONFIGURATIONMANAGER
7. Перезагружаемся!
8. Проверяем в сервисах отсутствие любых Hyperion и Oracle сервисов из тех, что были к EPM System.
9. Можно подчистить в папке c:\Documents and Settings\[Твой_User] все файлы и папки от EPM.
10. Можно дропнуть БД под SharedServices, если хочется)) Все равно мы чистим все на корню, и при новой установке лучше создать эту БД заново.
Всё! Система чиста и готова к новой установке EPM. О том, как правильно провести первичную настройку EPM System 11.1.2 я расскажу в следующий раз.

Использовать это!

Получил срочное ночное сообщение от Oracle Support.
Эти патчи:
- 9013376 - Oracle's Hyperion Shared Services 11.1.1.2.03 Service Fix
- 9235068 - Oracle's Hyperion Shared Services 11.1.1.2.06 Service Fix
- 9592841 - Oracle's Hyperion Shared Services 11.1.1.2.07 Service Fix
заменены на:
- 9754381 - Oracle's Hyperion Shared Services 11.1.1.2.09 Service Fix

If you are an Oracle Hyperion Planning customer using Life Cycle Management and have experienced “Unable to connect to Planning Application” message while accessing Lifecycle Management, you are advised to replace the obsolete patch(es) with patch 9754381- Oracle's Hyperion Shared Services 11.1.1.2.09 Service Fix. Replacement instructions are provided in the Readme.

Наименования форм в EPM - Planning под LCM

В ходе реализации проектов на базе EPM 11.1.1.2 - Planning часто сталкиваюсь со следующими проблемами при работе с формами, в частности, с их наименованиями (для выгрузки с помощью LCM - Lifecycle Management):
1. Не следует называть и размещать форму так, чтобы путь к ней был очень велик (большая глубина вложенности в папках). Оказалось, что LCM некорректно выгружает формы, общий путь которых превышает ограничения ОС, на которой установлена EPM System. Например, форма лежит в следующей иерархии: Data Forms - Бюджеты доходов и расходов - Расходы по основной деятельности - Материалы - Материалы - расчеты - ГСМ - Бензин, ДТ - Бензин, ДТ - переменные - Нормативы для VC.
В Windows результат выгрузки LCM будет выглядеть так: \[папка_выгрузки_LCM]\resource\Plan Type\[куб_приложения]\Data Forms\Бюджеты доходов и расходов\Расходы по основной деятельности\Материалы\Материалы - расчеты\ГСМ\Бензин, ДТ\Бензин, ДТ - переменные\Нормативы для VC.xml
Таким образом, в Windows длинна такого пути не должна превышать 256 символов. Рекомендую называть формы и папки форм кратко.
2. Не следует использовать в именах форм специфические символы. Это опять же связано с ограничением файловой системы той ОС, на которой установлена EPM System. Лучше использовать, русские и латинские буквы, цифры, пробелы, тире, точки. На мой взгляд, этих символов вполне достаточно для именования форм. LCM 11.1.1.3 не смог загрузить формочки со скобками((