Nuxeo

From Crashcourse Wiki

Jump to: navigation, search

This is a very quick-and-dirty recipe for installing and running Nuxeo DM (Document Management) on Fedora 11. The installation instructions that come with the downloaded zip file are somewhat confusing in that they imply that the underlying JBoss software has already been installed elsewhere whereas the Nuxeo software comes bundled with the appropriate JBoss functionality so it's a self-contained package and you can safely ignore any other JBoss package that you've installed.

First, make sure you've installed Java. On Fedora 11, that implies installing the java-1.6.0-openjdk packages, which seem to work just fine with Nuxeo.

Next, grab the Nuxeo DM zip file from here and unload it under your home directory wherever's convenient -- in my case, /home/rpjday/nuxeo/dl/nuxeo-dm-5.2.0.

At that point, if you don't want to edit any of the Nuxeo scripts, put the following in your .bash_profile, which you can see will override any previous setting for the environment variable JBOSS_HOME:

export JAVA_HOME=/usr
export JBOSS_HOME=~/nuxeo/dl/nuxeo-dm-5.2.0
PATH=${JBOSS_HOME}/bin:$PATH

There's a reason for resetting JBOSS_HOME for Nuxeo -- the run.sh script clearly needs to find the Nuxeo-specific content under that directory, as you can see in this snippet from that script:

# Fix JRE 1.5/1.6 issue with script-api.jar
IS_JRE_6=`"$JAVA" -version 2>&1|grep "version \"1\.6"`
NUXEO_EAR="$JBOSS_HOME/server/default/deploy/nuxeo.ear"  <-- see?

In other words, the run.sh script expects to find Nuxeo content under the ${JBOSS_HOME} directory so, unless you want to move that content, just go with it and let Nuxeo provide the JBoss functionality.

At that point, once you reset your shell environment, you're good to go:

$ jbossctl start

Once Nuxeo is running, browse to http://localhost:8080/nuxeo/, login with username and password both set to Administrator, and you're off and running.

Personal tools