Chapter 2. Exploring Nuxeo RCP

Table of Contents

2.1. Requirements
2.2. Installation from a packaged binary
2.3. (Alternative) Installation from the update site
2.4. First tour of Nuxeo RCP
2.4.1. Prepare and launch your Nuxeo EP server
2.4.2. Connect Nuxeo RCP to Nuxeo EP

Nuxeo RCP is a set of rich client platform plugins that can connect to a Nuxeo EP server and browse its documents using native graphical widgets. It can be used to extend any product based on Eclipse RCP.

Nuxeo RCP can be used for different purposes:

In this chapter, we will install some Nuxeo RCP components in the Eclipse IDE and use them from there.

2.1. Requirements

  • Nuxeo EP 5.2 (m1 or more recent snapshot)

  • Eclipse IDE 3.3.2

  • Java 5

2.2. Installation from a packaged binary

Prebuilt versions of the software are provided by Nuxeo to ease the task of trying out Nuxeo RCP for the first time.

Just download the appropriate Nuxeo RCP package for your platform (only Windows and Linux packages are provided at the moment) from http://download.nuxeo.org/nuxeo-rcp/products/releases/, unzip them, and launch the application.

2.3. (Alternative) Installation from the update site

If you already have an Eclipse 3.3 installation and you want to try out Nuxeo RCP from it, you can alternatively download the Nuxeo RCP plugins using the Eclipse updater:

  • In Eclipse, go to Help > Software Updates > Find and Install ...

  • Select "Search for new features to install"

  • Add a new remote site name "Nuxeo RCP" using the URL http://download.nuxeo.org/nuxeo-rcp/updates/ or http://download.nuxeo.org/nuxeo-rcp/updates/snapshots for snapshots versions

2.4. First tour of Nuxeo RCP

2.4.1. Prepare and launch your Nuxeo EP server

To fully works with Nuxeo RCP, Nuxeo EP may have to be bound to its DNS address or IP address. If you have connection errors while connecting with Nuxeo RCP, try the following instructions:

  1. in $JBOSS_HOME/server/default/deploy/nuxeo.ear/config/nuxeo.properties and $JBOSS_HOME/server/default/deploy/nuxeo.ear/datasources/core-events-ds.xml replace all "localhost" by the IP adress or DNS name of the JBoss server

  2. start JBoss with the -b option: ./run.sh -b IP_adress_or_DNS_of_the_server

2.4.2. Connect Nuxeo RCP to Nuxeo EP

Nuxeo RCP provides a perspective that holds the main Nuxeo RCP views: Window > Open perspective > other ... and Select Nuxeo ECM.

Create a new connection and connect to it with the ECM Applications view.

Once connected, browse the Nuxeo EP content using the ECM Navigator.