topic Re: How to hot reload bundles without Nuxeo IDE? in Nuxeo Forum

How to hot reload bundles without Nuxeo IDE?

Nelson_Silva — Sat, 08 Oct 2011 00:09:00 GMT

I've been using JSF facelets autorefresh and JBoss Seam hot reload to provide some hot reload abilities but I've read that Nuxeo IDE is able to hot reload bundles.

Are there any limitations and how can we do it using Ant or Maven ?

Re: How to hot reload bundles without Nuxeo IDE?

Wojciech_Sulejm — Mon, 10 Oct 2011 22:41:50 GMT

Though you might already be aware of this, hot reload with ant is presented in the following documentation entry: How to do incremental deployment (hot reload) in the JSF-Seam layer.

You also have to make sure that the bundles you want to reload are configured to be hot-reloadable: How to make a bundle able to hot-reload

Re: How to hot reload bundles without Nuxeo IDE?

Nelson_Silva — Tue, 11 Oct 2011 11:53:36 GMT

Thank you. I'm aware of that. I was looking for a way to reload all sorts of bundles, this would really take the pain out of development and constant restarts.

Re: How to hot reload bundles without Nuxeo IDE?

Nelson_Silva — Wed, 12 Oct 2011 11:10:49 GMT

Ok, I've been doing some research into this and I'll be updating this answer according to my findings:

I've been using release-5.4.2 but I found that starting on release-5.4.2-HF07 they backported "org.nuxeo.runtime.tomcat.dev.NuxeoDevWebappClassLoader".

You can read some details in the NXP-7389

Basically to enable hot reload you should modify the conf/Catalina/localhost/nuxeo.xml l context configuration file and replace:

<Loader className="org.nuxeo.runtime.tomcat.NuxeoWebappLoader"
loaderClass="org.nuxeo.runtime.tomcat.NuxeoWebappClassLoader" />

<Loader className="org.nuxeo.runtime.tomcat.NuxeoWebappLoader"
loaderClass="org.nuxeo.runtime.tomcat.dev.NuxeoDevWebappClassLoader" />

Then you will be able to reload jars or bundles that ARE NOT in nxserver/bundles or nxserver/lib by specifyin the list of these bundles in the file nxserver/dev.bundles.

The format of this file is one file path per line (the file corresponding to the bundle JAR or directory). Thus, you can point to project bin directories in your Eclipse IDE, or on JARs outside nuxeo server.

To specify a third party JAR that is not a BUNDLE you must prepend its path with a !. YOu can use blank lines or lines starting with # for comments. Example:

/path/to/may/project1/bin
/path/to/may/project2/bin
!/path/to/may/thirdparty.jar
...

Please notice that if you're using the 5.4 branch according to NXP-7629 the automatic hot-reloading (which checks dev bundles every 2 seconds) was disabled by default. To re-activate, just edit the launcher.properties template file and set the timer property org.nuxeo.app.installReloadTimer to true. A JMX a bean is exposed for controlling the reset instead.

If you ant to use ant to update the dev.bundles file, you can use something like this:

    <target name="hotreload">
        <condition property="file.matches">
            <resourcecontains resource="${nxserver.dir}/dev.bundles" substring="${basedir}/target/classes" />
        </condition>
        <antcall target="update-dev-bundles"/>
        <antcall target="touch-dev-bundles"/>
    </target>

    <target name="update-dev-bundles" unless="file.matches">
        <echo message="Adding ${basedir}/target/classes to dev.bundles"/>
        <echo file="${nxserver.dir}/dev.bundles" append="true"
              message="${basedir}/target/classes"/>
    </target>

    <target name="touch-dev-bundles">
        <touch file="${nxserver.dir}/dev.bundles"/>
    </target>

Re: How to hot reload bundles without Nuxeo IDE?

Olivier_Grisel — Wed, 12 Oct 2011 11:39:28 GMT

Note

Re: How to hot reload bundles without Nuxeo IDE?

Nelson_Silva — Wed, 12 Oct 2011 11:46:48 GMT

I've only seen the sdk profile in 5.4.3-I20111003_1046 will it be backported in a HF?

Re: How to hot reload bundles without Nuxeo IDE?

Olivier_Grisel — Wed, 12 Oct 2011 12:11:08 GMT

No as this is not a bugfix.

Re: How to hot reload bundles without Nuxeo IDE?

Nelson_Silva — Wed, 12 Oct 2011 16:50:59 GMT

Well, I've got the hot reload working... should it run the deployment fragment and do a Seam hot reload as well ? It not a sample build.xml with these tasks would be great!

Re: How to hot reload bundles without Nuxeo IDE?

dario_ — Mon, 21 Nov 2011 22:39:26 GMT

I work with nuxeo-dm-5.4.3-I20111024_2229-tomcat.