Quick start with Nuxeo

You have just downloaded Nuxeo DM, now, what to do ?

Nuxeo DM installation

Nuxeo DM is fully based on Java. This is great as it can be deployed on any platform, although it requires Sun JVM (compatibility not certified on other JVM vendors) to be set up on your machine.

You can check it by opening a terminal ("windows" + r then "cmd", Terminal.app, terminal) and type:

java -version

This will give you the name and version of you Java virtual machine. It is required to use either 1.5.X or 1.6.X. The Java Runtime Environment (JRE) is enough to run the product, but you will need a Java Software Development Kit (SDK) if you plan to do some development.

You can download the JRE or JDK on Sun website. You need to choose what the targeted platform will be : Download JRE 1.6

Depending on versions and platforms, Nuxeo can be packaged in several ways :

• simple zip: just decompress it
• jar: run the installer via java -jar installer.jar
• MS Windows setup: run the setup

Launch and connect to the application you've just set up

If you used the zip JBoss distribution, you have to run "chmod u+x *.sh jbossctl" then "$NUXEO_HOME/bin/jbossctl start"

If you used the zip Jetty distribution, you have to run "chmod u+x *.sh" then "$NUXEO_HOME/nxserverctl.sh start"

If you used the zip Tomcat distribution, you have to run "chmod u+x *.sh" then "$NUXEO_HOME/bin/startup.sh" (or "$NUXEO_HOME/bin/startup.bat" under Windows OS)

If you used the windows.exe installer, you have to start Nuxeo from the Applications menu or start the Nuxeo service from the administration panel.

Then you can connect to the application using the username and password combination Administrator and Administrator. You can start creating users and organize your folders. You can read the Nuxeo user guide.

Requirements

If you want to benefit of all the Nuxeo features, don't forget to set these external components.

The following installation steps are not mandatory as you can already enjoy Nuxeo with the previous setup instructions. Yet, the following instructions will provide you additional features.

Quick requirements summary

The drag'n drop plugins :

• Internet Explorer Extension:to allow drag'n drop from file system to Internet Explorer (6 and 7)
• Firefox Extension: to allow drag'n drop from Firefox 3

Set up open office for pdf generation and annotations on Office documents

OpenOffice is used to handle PDF generation and HTML preview for some documents. This means you need to install OpenOffice on the server to have PDF, preview and annotation features enabled.

If OpenOffice is already installed on your server, Nuxeo comes with a daemon that should automatically start it. You can find more information about managing the daemon here (section 45.2 of the Nuxeo-Book).

Configuration file for the daemon is config/ooo-contrib.xml ($NUXEO_HOME/server/default/deploy/nuxeo.ear/config/ooo-contrib.xml under JBoss).

If you need informations about installing OpenOffice or want to manage OpenOffice server without the daemon, you can see section 45.1 of the Nuxeo-Book

Set up pdftohtml for pdf transformation to html for preview and annotations

pdftohtml is used to transform pdf to html. These html preview of pdf documents are needed for preview of Files containing pdf and bring the annotation feature for these type of documents. You can download pdftohtml from here.

After you need to configure Nuxeo DM as explained here.

Set up Image Magick on server side for picture tiling features

Please see Nuxeo-Book chapter about Tiling.

Requirements (ie : ImageMagick 6.3.7 or later) are defined in the installation section.

Do a nice production setup

If you want to do more than testing Nuxeo and want to setup a production server, you need to do some additional configuration.

You can find informations here.

You can also read the administration guide where you will find all the informations you need.

Benefit from professional Nuxeo support through the Connect program

Connect membership will give you access to a wide range of services to boost up and secure your project with any of Nuxeo products.

Start customizing your Nuxeo :

You will find related links in the Developer Starter page.

You can also use the Nuxeo Book as a reference.

Join Nuxeo community !

• You can subscribe to the Nuxeo ECM list.
• You can join Nuxeo discussion
• You can subscribe also to our Linked In and Facebook communities, enjoy !