Setting up JBoss application servers

Set up a JBoss application server environment on a server where you plan to install NexJ Customer Relationship Management.

There are two types of JBoss application servers that you can use with NexJ CRM: JBoss Application Server (JBoss AS) and JBoss Enterprise Application Platform (JBoss EAP).

JBoss application servers support several configurations:
  • A standalone server instance that runs as an application on Linux or Windows.
  • A standalone server instance that runs as a Windows service.
  • A server cluster that runs as an application on Linux or Windows.
  • A server cluster that runs as a Windows service.
In general, setting up a JBoss application server consists of the following steps:
  1. Download and install your desired JBoss application server, apply the necessary patches, then modify certain files and directories for NexJ-specific configuration. See:
    Note: See the Release Notes document for your version of NexJ CRM to determine the required version of the JBoss application server. You can download JBoss AS or JBoss EAP from the JBoss Community web site at http://www.jboss.org/jbossas/downloads/.
  2. Configure how to execute your JBoss application server deployment: either as an application or as a Windows service. See:
  3. Using NexJ Studio, configure the environment files to point to the correct JBoss application server instance or cluster. See Updating environment information for JBoss application servers.

After you have installed your JBoss application server, you can update the various security settings as required for your deployment. For more information, see https://community.jboss.org/wiki/SecureJBoss.

The instructions in this section refer to the following locations and variables:
NEXJ_PLUGIN
The location where the NexJ Studio plugin is installed. For example, c:\nexj_studio\11.0\plugins\com.nexjsystems.nexjstudio_version.
JBOSS_HOME
The location to which you extracted your JBoss application server.
JAVA_HOME
The location where the Java JDK is installed.
projectdir
The name of the directory where you are installing and configuring the JBoss application server node for your deployment. In a clustered environment, projectdir refers to the directory where you are installing and configuring the first node for your deployment, projectdir2 refers to the directory where you are installing and configuring the second node, and so on.
platform
The name of the directory that contains the files for your version of Windows. For example, win32-x86.
Note: Before deploying your application, you must configure the application server to use standards-compliant TCP stacks. See Configuring TCP on application servers.