EPM 11.2: OHS Changes

Yet another blog post on EPM 11.2! This time we are looking at the changes for EPM 11.2 related specifically to OHS.

The first thing you may be wondering is: how do you start the OHS server? Well it's a change from the previous few versions as OHS no longer uses OPMN for this task. Instead it uses Node Manager. If you followed the official installation and configuration guide you should have a service like the below:

With that service running we have some helper scripts to get OHS online. Browse to MIDDLEWARE_HOME\user_projects\FND1\httpConfig\ohs\bin\. Then run the following command to start OHS and store the epm_admin credentials so you aren't prompted later:

startComponent.cmd ohs1 storeUserConfig

To stop OHS simply run the command:

stopComponent.cmd ohs1

From now on you can start OHS with:

startComponent.cmd ohs1

It is a bit annoying to not have a nice Windows service to start that will bring OHS online but I might work on that soon.
If you completed the above, your OHS server is starting however it isn't listening on port 19000 but rather port 7777 then you need to copy all the files and folders from MIDDLEWARE_HOME\user_projects\epmsystem1\httpConfig\ohs\config\fmwconfig\components\OHS\ohs_component\ to MIDDLEWARE_HOME\user_projects\epmsystem1\httpConfig\ohs\config\fmwconfig\components\OHS\instances\ohs1.

The OHS configuration files are read from httpConfig\ohs\config\fmwconfig\components\OHS\instances\ohs1 - but the configtool only updates the files in httpConfig\ohs\config\fmwconfig\components\OHS\ohs_component. Don't ask me why they have duplicate folders! I picked up this tip from a comment by Dan C on the epmonprem.pro blog, so I can't take credit for that discovery.

Next if you want to know specifically which version of OHS (and the underlying version of Apache) is being used you can run the commands below. Change paths to suit your environment:

cd /d E:\Oracle\Middleware\ohs\ohs\bin
SET PATH=E:\Oracle\Middleware\ohs\ohs\bin;E:\Oracle\Middleware\ohs\bin;E:\Oracle\Middleware\ohs\oracle_common\bin;%PATH%
httpd.exe -version

You should see output like the below:

Server version: Oracle-HTTP-Server-12.2.1.3.0/2.4.25 (Win64)
Server built:   Aug 17 2017 20:40:27

If you need to change any configuration in OHS just be sure that the previous version of Hyperion used OHS 11.1.1.7, Apache 2.2, and some syntax is no longer valid. A common bit of customisation that I do, that thankfully still works in OHS 12.2.1.3, is changing the EPM logo in the logon page.

First browse to E:\Oracle\Middleware\EPMSystem11R1\common\epmstatic\bpmui\ and then create the path below:
E:\Oracle\Middleware\EPMSystem11R1\common\epmstatic\bpmui\themes\theme_skyros\images_global\

Next take a copy of the logon_panel.gif file, edit it and place it in this location. We will use an OHS configuration setting to ensure that our edited image is used, rather than the version in the Workspace WAR file.

Browse to E:\Oracle\Middleware\user_projects\FND1\httpConfig\ohs\config\fmwconfig\components\OHS\instances\ohs1\ and edit the file "epm_rewrite_rules.conf". Add the following line:

RewriteRule ^/workspace/bpmstatic/themes/theme_skyros/images_global/logon_panel.gif /epmstatic/bpmui/themes/theme_skyros/images_global/logon_panel.gif [PT]

Restart OHS. You will now see your updated logo!