Installing JBoss application servers on Windows

Before you can deploy NexJ CRM, you need to install a JBoss application server (either JBoss AS or JBoss EAP), configure some customized settings for running NexJ applications, and then copy key files from the NexJ Studio plugin to the JBoss AS install directory.

Before you begin installing a JBoss application server, ensure that Java JDK is installed on your machine and that the Java JDK installation directory is set as the system environment variable JAVA_HOME.

You must also acquire the correct JDBC driver for your database. Contact your NexJ representative or see the Release Notes document for your version of NexJ CRM for more information.

To install a JBoss application server as a standalone instance or as a server cluster:
  1. Unzip the JBoss application server zip file to a directory on your hard drive. For example, C:\Program Files\jboss-5.2.0.EAP.
  2. Set the system environment variable JBOSS_HOME to the directory to which you extracted the JBoss application server zip file.
  3. Copy the following file from the NEXJ_PLUGIN directory to the JBOSS_HOME directory.
    File to copy Copy to directory
    NEXJ_PLUGIN\nexj-boot.jar JBOSS_HOME\lib

    If you are installing JBoss AS, also copy the following files from the NEXJ_PLUGIN directory to the JBOSS_HOME directory:

    File to copy Copy to directory
    NEXJ_PLUGIN/core/etc/config/jboss/lib/*.jar JBOSS_HOME/lib
    NEXJ_PLUGIN/core/etc/config/jboss/common/lib/0-nexj-jboss-5.2.0.EAP-fix.jar JBOSS_HOME/common/lib
  4. Copy the following files from the NEXJ_PLUGIN directory to the JAVA_HOME directory.
    File to copy Copy to directory
    NEXJ_PLUGIN\lib\platform\*.dll JAVA_HOME\jre\bin
    Appropriate JDBC driver, such as jtds-1.2.2-7.jar or ojdbc6.jar JBOSS_HOME\server\projectdir\lib
  5. If you are installing a standalone JBoss application server, in the JBOSS_HOME\server directory, create a copy of the default directory. If you are installing the JBoss application server as part of a server cluster, create a copy of the all directory. Rename the copy to a meaningful name, such as CRM_Prod_Node. This directory is the projectdir directory.
  6. Copy the NEXJ_PLUGIN\nexj-jboss.jar file to the JBOSS_HOME\server\projectdir\lib directory.
  7. Copy the JBOSS_HOME\docs\examples\jms directory to the JBOSS_HOME\server\projectdir directory.
  8. Share the projectdir directory with a meaningful name, such as jboss-svr.
    The directory should be readable and writable only to the deployment administrator, as it contains sensitive information, including the deployed code and the authentication information.
  9. If you are installing a JBoss application server cluster, for every node that you plan to include in the cluster, repeat steps 5 to 8.
    For example, you can create additional copies of the all directory and name them CRM_Prod_Node2 and CRM_Prod_Node3. They would be projectdir2 and projectdir3 directories.
After you have installed the JBoss application server and copied the necessary files, you need to do the following:
  • Configure the server to run as an application or a service.
  • Using NexJ Studio, update the location settings in the server or environment file for your deployment.