ABOUT US

|

SUPPORT

|

BLOGS

 

 

DEVELOPER BLOG

 

 

 

 

 

 

 

Deploying WebRenderer Server Edition in Tomcat

 

Anthony Scotney

 

 

 

 

 

Deploying WebRenderer Server Edition in a Tomcat container is fairly straight forward when one understands the basic deployment principles. If you deploy WebRenderer Server Edition into your WEB-INF/lib or any other local project directory you will run into issues when trying to redeploy. When you try to redeploy your application Tomcat tries to reload the WebRenderer libraries (which are already loaded in memory) and is refused. You will then be confronted with a message about an UnsatisifiedLinkError in setMozPath. Even though at this point it may look like the end, Tomcat  comes to our rescue with some specific instructions (found in the Tomcat docs) on exactly how to deploy components like WebRenderer.  The following are the basic steps that will get you up and running with Tomcat and allow as many WebRenderer Server Edition redeploys as your heart desires.

Steps to deploy WebRenderer Server Edition in Tomcat

1) Place all the WebRenderer libraries (webrendererse.jar, webrendererse-xxx.jar, corecomponents-xxx.jar) in your CATALINA_HOME/lib directory. Whatever you do, avoid deploying any WebRenderer libraries to your WEB-INF/lib or WEB-INF/classes directory.

The next two steps are Optional

2) You can control where WebRenderer extracts its components to using the BrowserFactory.setXXX methods. This is particularly helpful if you want to control the extraction and data storage of WebRenderer. If you do not set these methods WebRenderer will extract out to <USER_HOME>/.webrendererse directory. The following methods allow you to specify the home directories and library locations for WebRenderer:

BrowserFactory.setHomeDirectory(path_to_webrenderer)
BrowserFactory.setLibraryPath(path_to_webrenderer)
BrowserFactory.setMozillaPath(path_to_webrenderer)

3) Make note that when you are finished with the browser that you destroy it by calling browser.destroy(). This ensures that you do not have any memory issues caused by browsers hanging around when not in use.

That is really all there is to it. It is fairly straight forward and hassle free.

NOTE: If you are using Netbeans you need to ensure that you right click on “Libraries” in your “Projects” view and uncheck the “Package” checkbox next to the WebRenderer Server Edition JAR. If you do not uncheck this, Netbeans will automatically deploy the WebRenderer JAR file out to your <PROJECT>/build/web/WEB-INF/lib directory, and then you will have issues when you try to redeploy your application even after a trivial change.

 

 

These icons link to social bookmarking sites where readers can share and discover new web pages.
  • Digg
  • del.icio.us
  • StumbleUpon
  • Reddit
  • DZone
  • Google Bookmarks
  • LinkedIn
  • TwitThis

 

 


 

 

 

 

About this blog..

 

This is an informal place for the team at JadeLiquid to discuss software, the rotation of the earth and other things usually discussed in the JadeLiquid corridors.

 

 

 

Subscribe: By Feed  By Email

 

 

 

 

 

Categories

 

 

Desktop Edition

 

Java™

 

Server Edition

 

Swing Edition

 

Uncategorized

 

WebRenderer

 

 

 

 

Recent Posts

 

 

Flash in Java browser - Enabling Flash within WebRenderer
Browser Zoom Effect using WebRenderer
WebRenderer Swing now supporting HTML5 video
Enabling HTML 5 WebSockets in WebRenderer
Applet deployment techniques for platform deterministic libraries

 

 

 

 

 

Popular Posts

 

 

WebRenderer Swing Edition 6 Released!
Deploying WebRenderer with Java Web Start on 64bit systems
Flash in Java browser - Enabling Flash within WebRenderer
Rich Test Browser - WebRenderer features on display
Enabling HTML 5 WebSockets in WebRenderer
Browser Zoom Effect using WebRenderer
WebRenderer Swing now supporting HTML5 video
Applet deployment techniques for platform deterministic libraries
Deploying WebRenderer Server Edition in Tomcat
Mouse gestures with WebRenderer

 

 

 

 

 

Archives

 

 

September 2013 (1) May 2013 (1) January 2013 (1) November 2012 (2) October 2012 (1) September 2012 (1) May 2012 (1) November 2011 (1) October 2011 (2) September 2011 (1) August 2011 (1)

 

 

 

 

Millions of deployments and counting.. Users of JadeLiquid's tools can be found in every corner of the Earth

 

   News

 

 > Enabling Flash in WebRenderer - Article
 > Browser Zoom Effect using WebRenderer - Article
 > Applet deployment techniques - Article
 > WebRenderer core features on display! - Article
 
 
   Additional News  
 
 > Enabling HTML 5 WebSockets in WebRenderer - Blog
 > 64bit WebRenderer deployment with Web Start - Blog
 > Deploying WebRenderer Server Edition in Tomcat - Blog
 > WebRenderer 6 adds performance text search - Blog
 

 

  Copyright JadeLiquid Software - 2017    Java and the Java Logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries  Privacy Policy  |  Disclaimer