11.6 Support A New Application Server

JeeWiz supports a range of application servers as standard - as of this writing, WebLogic 6/7, Websphere 5, Oracle 9iAS and JBoss 3. If you are interested in supporting a new application server, here are the steps you should take:

• Make contact with NT/e (the publishers of JeeWiz) to see if the app server you are interested in has been supported recently. You can then obtain the implementation direct from NT/e. Failing that, we may be interested in supporting you during the implementation.
• Check the news group - it is quite possible another user has already implemented it.
• The easiest way to create a new app server implementation is to copy another one and change it. We suggest you start with the JBoss implementation (in jeewiz/resource/jboss3) and copy this whole directory to another directory under jeewiz/resources. If we call this app server AS4, then your new app server's directory should be 'jeewiz/resources/AS4'.
  
  The reason we recommend putting your app server implementation here is that it will be automatically picked up as a model that users can use and so will be available on the drop-down list in the 'New Project' dialog in the editor. The down side of placing it here is that it is right in the main JeeWiz code base: just try to take a back up if you install a new version of JeeWiz.
• Change the model.properties file (in your newly-created directory) according to the instructions given in Model Properties. You should change the modelName and description properties.
  
  These instructions assume you will be using the model from J2EE implementation (as JBoss does), so you do not need to specify the 'package', 'topComponents' or 'abstract' properties.
  
  As you will also be using the J2EE package as your parent, you can leave the 'parent' as it is ('parent=${jwhome}/resources/j2ee/control').
• Add a section into jeewiz/bin/build.properties for your application server. This should define the fundamental installation parameters for AS4. Do not put derived properties here - they come next. This will give defaults for the installation that will be used unless the properties are specified in the build properties file for the build or in the user's build (see the section Order of Reading Top-Level Property Files below for the details of search orders.
• Change the system.properties file (in your newly-created directory) to give the various locations required by your application server. See the J2EE system properties file for a list and short description of these parameters.
• Scripts: Remove the JBoss-specific scripts under the jeewiz/resources/AS4/control and replace them with appropriate alternatives of your own.

Copyright (c) 2001-2008 New Technology/enterprise Ltd.