Tuesday Apr 16, 2013

Installing OUAF in Oracle WebLogic native mode

As in a previous post it is possible to install an Oracle Utilities Application Framework based product in native mode as an alternative to the embedded mode offered by the default installation routine.

The basic process for this is as follows:

  • Install Oracle WebLogic as per the Oracle WebLogic documentation. If you are running Oracle ExaLogic then this may be already done as part of the Oracle ExaLogic deployment.
  • Using the Configuration Wizard shipped with Oracle WebLogic (or via Oracle Enterprise Manager) create a domain, create an administration server with the console deployed to it and create servers/clusters you want to deploy the product within.
  • You may need to alter the server startup definitions within the server definition to add additional java options and java memory settings for the product. The defaults shipped with Oracle WebLogic reflect the defaults of tha java version used and typically are set too small for the product.
  • Install the Oracle Utilities Application Framework based product as per the Installation Guide with a few additional settings specifically when specifying the host and port numbers (they should match the values you specified in the Configuration Wizard). You can optionally setup the product to use data sources, if you want to use them. If you do this then you need to deploy the data sources to the server allocated to the product BEFORE you deploy the product. 
  • Set the base location of the software in the startup for the servers you want to deploy the product. This tells the runtime to refer to the additional runtime components and product configuration files at runtime. This is simply making sure the environment variable (SPLEBASE) is set appropriately prior to server startup.
  • Create an XML Registry setting in the domain so that the correct parsers for the platform are used for the product.
  • Define your security realm settings for your domain including creating the product authentication group, JNDI user for JNDI lookups and initial product users.
  • Configure the domain to use advanced settings for each component of the product. This is simply setting a configuration flag on the domain realm.
  • Deploy the product Business Application Server (SPLService) into the servers using the deployment facilities of Oracle WebLogic or Oracle Enterprise Manager.
  • Deploy the product Web Application Server (SPLWeb) into the servers using the deployment facilities of Oracle WebLogic or Oracle Enterprise Manager. You will need to set the deployment order so that this component starts AFTER the startup of the Business Application Server.

The diagram below illustrates the process in detail:

Native Install Process

The product is now installed ready to be configured, managed and operated from the facilities in Oracle WebLogic Administration console or via Oracle Enterprise Manager.

This may look like a bit of effort but most of the work is wizard driven asking questions and simply settings the correct values. For a full detailed description of the process refer to Native Installation Oracle Utilities Application Framework (Doc Id: 1544969.1) whitepaper available from My Oracle Support.


Anthony Shorten
Hi, I am Anthony Shorten, I am the Principal Product Manager for the Oracle Utilities Application Framework. I have been working for over 20+ years in the IT Business and am the author of many a technical whitepaper, manual and training material. I am one of the product managers working on strategy and designs for the next generation of the technology used for the Utilities and Tax markets. This blog is provided to announce new features, document tips and techniques and also outline features of the Oracle Utilities Application Framework based products. These products include Oracle Utilities Customer Care and Billing, Oracle Utilities Meter Data Management, Oracle Utilities Mobile Workforce Management and Oracle Public Service Revenue Management. I am the product manager for the Management Pack for these products.


« April 2013 »