Install Oracle Endeca Commerce Tools and Frameworks v11 on Linux

If you are trying to install Tools and Frameworks under the new Oracle Endeca Commerce v11 with Linux, you might have noticed that the installer just got more complicated. We used to be able to install Tools and Frameworks by moving an unzipped directory to the right location and that would be all.

Now we need to run an installer located at:


If you are connecting through the console of a Linux box using SSH, you might have got this error

Preparing to launch Oracle Universal Installer from /tmp/OraInstall2014-03-04_02-06-11PM. Please wait ...<br />DISPLAY not set. Please set the DISPLAY and try again.<br />Depending on the Unix Shell, you can use one of the following commands as examples to set the DISPLAY environment variable:<br />- For csh: % setenv DISPLAY<br />- For sh, ksh and bash: $ DISPLAY=; export DISPLAY<br />Use the following command to see what shell is being used:<br />echo $SHELL<br />Use the following command to view the current DISPLAY environment variable setting:<br />echo $DISPLAY<br />- Make sure that client users are authorized to connect to the X Server.<br />To enable client users to access the X Server, open an xterm, dtterm or xconsole as the user that started the session and type the following command:<br />% xhost +<br />To test that the DISPLAY environment variable is set correctly, run a X11 based program that comes with the native operating system such as 'xclock':<br />% &amp;lt;full path to xclock.. see below&amp;gt;<br />If you are not able to run xclock successfully, please refer to your PC-X Server or OS vendor for further assistance.<br />Typical path for xclock: /usr/X11R6/bin/xclock

The installer is trying to run the program through a visual user interface that is using a X window, which isn’t possible through a text-based terminal.

From there, you can use the silentInstaller (see documentation for more details) but there are less options available and I personally had issues running it. So instead, here are the steps if you want to run the installer with X11 to be able to interact with the user interface.

If you are on Mac, download and install Xquartz, which is an open-source X.Org X Window System (if running OS X before 10.8, it is bundled with the OS).

For other operating systems, you will have to find your own version of X.Org X11 and install it.

Then, all you have to do is connect on the Linux server where Endeca will be installed by using the -X parameter (which enables a X11 forwarding funnel to your own machine)


ssh -X username@hostname

Then, when you will run the installer


The installer will automatically launch XQuartz (or your own version of on your operating system) on your machine and you’ll be able to install Endeca Tools and Frameworks on the Linux box.

Tools and Framework installer for Oracle Endeca Commerce


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 )

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