Nuxeo on OpenShift

I'm trying to run nuxeo on OpenShift. As OpenShift restricts ports / bindable IPs I modified nuxeo.conf to fits those. Still it looks like a particular check performed by ConfigurationGenerator fails on OpenShift: see the call here.

I reproduced using a dumb

and indeed this particular calls fails with a “ Permission denied” on OpenShift.

What would be the simplest/cleanest way (in this order :)) to work around this? Right now I cannot make nuxeo start on OpenShift.


0 votes

2 answers



I tried OpenShift a few months ago and didn't have this problem. What full stack trace do you get? What's the IP used?

However I encountered another more serious problem: OpenShift limited the memory allocated to the JVM to 512 MB and this is not enough for a Nuxeo to run.


Full stack I get is:

>09:25:56,186 ERROR [org.nuxeo.launcher.NuxeoLauncher.doStart(] Could not run configuration: Unreachable bind address / 09:25:56,187 DEBUG [org.nuxeo.launcher.NuxeoLauncher.doStart(] org.nuxeo.launcher.config.ConfigurationException: Unreachable bind address / org.nuxeo.launcher.config.ConfigurationException: Unreachable bind address /

at org.nuxeo.launcher.config.ConfigurationGenerator.checkAddressReachable(
at org.nuxeo.launcher.config.ConfigurationGenerator.checkAddressesAndPorts(
at org.nuxeo.launcher.config.ConfigurationGenerator.verifyInstallation(
at org.nuxeo.launcher.NuxeoLauncher.doStart(
at org.nuxeo.launcher.NuxeoLauncher.doStartAndWait(
at org.nuxeo.launcher.NuxeoLauncher.doStartAndWait(
at org.nuxeo.launcher.NuxeoLauncher.launch(
at org.nuxeo.launcher.NuxeoLauncher.main(

Which is the same I can reproduce with my simple example.

Is there a simple way to override ConfigurationGenerator with my own extension?

You are right about the 512MB limitation (only for the free gears though).

Are you aware of some other hosted environment where nuxeo is known to work? Ideally there would be some free mode/trial period to test.



Is the / at the start of the address normal? I'm surprised it's there.

I've had success running a Nuxeo on CloudFoundry, you'll find documentation about that here:


>Is the / at the start of the address normal? I'm surprised it's there.

Yes it looks like that's part of InetAddress#toString implementation.

Thanks for the cloudfoundry link. I'll consider it.


Simplest would be to add a configuration option (for nuxeo.conf or any nuxeo.defaults) to bypass the address check. However, are you sure Tomcat will be able to bind that address if it's not reachable?

What about the org.nuxeo.launcher.config.ConfigurationGenerator.checkPortAvailable(InetAddress, int) next check? Will it fail too and must also be bypassed?

Those checks were initially added to early detect the situations leading to the “Address already in use” error at server (Tomcat/JBoss) startup.

1 votes

I did a quick test and the next check (from checkPortAvailable(InetAddress, int)) works fine on OpenShift. Actually it looks like this test alone could be sufficient?

As the reason why isReachable fails, not sure but it's probably related to some strange network configuration cloud prodivers enjoy!


Agreed, in my opinion the checkAddressReachable on a bind address is wrong, we'll probably remove it.

Thanks for the ticket!

I validated that with aforementioned fix nuxeo starts fine on OpenShift.

It can even run fine on a free gear (but is somewhat slow).


Quick answer: not possible due to the OpenShift memory limitation to 512 MB in the free gears.

1 votes