Monday, 3 August 2015

Changing the session timeout for BIP in EM12c

Someone asked me if it was possible to change the BI Publisher session timeout for Oracle Enterprise Manager 12c.  To which I said of course you can if you want to hack your way through the deployment, you can do what you like, but that doesn't mean the changes you make will be supported or endorsed.

They pointed me at My Oracle Support article "BI Publisher Consolidated Reference (Doc ID 1546377.1)" which contains a section for BIP version 11.X that comes with EM12c.  The instructions contained within that note talk about extracting the xmlparser.ear and the xmlparser.war file and then changing the session-timeout value in the session-config section of the web.xml file and packaging it all back up again, now I know it's been a long time since I was messing around with deployment descriptors but I thought to myself there has to be an easier way.  The JEE spec allows the receiving container to override certain values during deployment of applications, Weblogic Server is no different.  You would normally package up a weblogic.xml file containing it's own session-descriptor but it's too late with EM12c as the application has already been deployed.

There still has to be an easier way I thought to myself and there is, simply use the Weblogic Admin console to change the value after you have installed EM12c.  Follow the instructions below.
  1. Log on to the WLS Admin Console, usually found at https://yourserver.com:7101/console using the weblogic account.
  2. Click on "Deployments" followed by "bipublisher (11.1.1)" as shown below.
  3.  In the next screen click on the Configuration tab, then the "Lock & Edit" button and change the value of "Session Timeout (in seconds):" then click "Save"
  4. Now go back to the "Deployments" page and tick "bipublisher (11.1.1)" and then click "Update".
  5. On the next screen keep the defaults and simply click the "Finish" button.
  6. Finally you need to activate the changes.
  7. You can validate that the changes have taken affect by navigating to "Environment -> Servers -> BIP -> Deployments -> bipublisher (11.1.1) -> Configuration" and you should see your new value for "Session Timeout".