Oracle Application Express 5.1.1 on Exadata cluster

Our DBA team really likes using APEX to develop DBA applications. We are a pretty small team and we like to automate and standardize everything we do. We make a habit of using database tables to store our configuration information and we write scripts that read those DBA tables in order to support our business users.

We recently took control of a new Exadata cluster and of course we created a DBA repository database as we were creating the business databases. Since APEX 5.1.1 was just released, we decided to replace our old APEX system. That system was was a single instance running on a virtual machine and controlled by an outsourced administration team. We are a lot more comfortable having control over installation and maintenance of a system we depend on to get our work done.

The new Exadata is a four node RAC and our new DBA repository has an instance running on each node. We did not want to install software on the Exadata so that ruled out using Rest Data Services (aka APEX Listener). It also ruled out using Oracle HTTP Server with mod_plsql.

Since this APEX system is only used by our DBA team and is not exposed to outside networks we felt comfortable using the Embedded PL/SQL Gateway. However, the Oracle documentation contains this ominous note:”Oracle recommends that you do not select the Embedded PL/SQL Gateway option for Oracle RAC installations. Because the Embedded PL/SQL Gateway uses an HTTP Server built into the database instance, it does not take advantage of the Oracle RAC shared architecture.” (

What to do? We decided to move forward with the Embedded PL/SQL Gateway and see how useable it would be. We could always spin up another virtual machine later if we needed to go the Rest Data Services route. I went through the steps in the APEX documentation to set up the Embedded PL/SQL Gateway. I could not get a response when I hit the database machine APEX URL that I had configured. I poked around on the servers and noticed that the XML db listeners were not running. I had forgotten that when I created the DBA database I intentionally did not install any options like Java and XML db. After installing XML db and restarting the database APEX started working. (

But that’s not all – here’s the real reason I wanted to blog about this. This APEX system is reachable using the scan listener! So that scary quote in the documentation should be ignored. We can connect using a URL like this: . No server names are required. So we CAN take advantage of RAC functionality.

This is just what we wanted so we are very satisfied with our new APEX system.

8 thoughts on “Oracle Application Express 5.1.1 on Exadata cluster

  1. Thank you for sharing this information.

    For the record, this “ominous” note in the Installation Guide was authored before the scan listener ever existed. I have annotated the documentation to remove this “ominous” warning. 😉

    Also, for the record, mod_plsql is deprecated and should not really be considered for new installations. I realize you’re not using mod_plsql, but I wished to make this point apparent.


    Liked by 1 person

  2. Hello Steve,
    so I need to run “java -jar ords.war” on each node and than I can connect through the scan listener? Even if one node is offline can I reconnect so to the system?

    Best Regards

    Liked by 1 person

  3. Hi Roman,

    I don’t remember having to run that java command on any of the nodes.

    I just had to have XML db running and registered to the listener.

    I mentioned Java in the post because I never install Java or XML db on a new database.


    Liked by 1 person

  4. If you have a WLS in your environment, you can install ords there and keep it off the database, only install APEX in the db. We are experimenting with this right now but seems to be working.

    Liked by 1 person

    • Hi Karl,

      What you describe is how I have always installed APEX in the past.

      This time I didn’t have a machine to use for WebLogic so I decided to see how well this worked.

      I was pleasantly surprised how well it works without Weblogic.



Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s