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, then copy
key files from the NexJ Studio plugin to the
JBoss 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.
Note: The Arial font is required by predefined
reports. You must install the
Arial.ttf font file for
each JVM on the application server machine and then restart each JVM. For
example, copy the font to the following location:
JAVA_HOME/jre/lib/fonts
Alternatively,
install the font system-wide. Consult your Linux documentation for the
appropriate install location.
To install a JBoss application server as a standalone instance or
as a server cluster:
-
Unzip the JBoss application server zip file to a directory on
your hard drive. For example,
/opt/local/jboss-5.2.0.EAP.
-
Set the system environment variable JBOSS_HOME to the directory
to which you extracted the JBoss application server zip file.
-
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 |
-
Copy the appropriate JDBC driver such as
jtds-1.2.2-7.jar or
ojdbc6.jar to the
JBOSS_HOME/server/projectdir/lib
directory.
-
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.
-
Copy the
NEXJ_PLUGIN/nexj-jboss.jar
file to the
JBOSS_HOME/server/projectdir/lib
directory.
-
Copy the
JBOSS_HOME/docs/examples/jms
directory to the
JBOSS_HOME/server/projectdir
directory.
-
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.
-
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.