You can deploy NexJ Model Server to a locally addressable location (somewhere on the network) or to a remote location. You can either use NexJ Studio or the command line to deploy.

When you deploy Model Server , a file is created for each node in the SERVER_HOME directory. The file specifies the node name . By default, nodes are named node=<node1>, node=<node2>, ..., node=<nodeN> for deployments to multiple locations. You can change a node's value if you want to give the node a meaningful name, for example, report_server. Nodes require a unique name. For more information about NexJ-specific system properties, see Specifying JVM arguments and system properties .

Before you deploy Model Server, you must install any prerequisites as mentioned in Preparing the host machine.

Deploying through NexJ Studio

To deploy Model Server using NexJ Studio:

In NexJ Studio, in the Deployment layer's Environment tab, open the environment file for the current deployment.
In the Overview tab, ensure that Type is set to Generic.

In the Deployment Location field, specify the folder directories or SSH folder directories for all the server nodes. For example, to deploy to two Model Server nodes, specify the directories as follows:

Operating System	Nodes	Servers	Remote/local deployment	Example
Windows	2	2	Remote	`\\hostname1\nexj\modeld,\\hostname2\nexj\modeld`
	2	1	Remote	`\\hostname\nexj\modeld\{node1,node2}` or `\\hostname\nexj\modeld\node1,\\hostname\nexj\modeld\node2`
	2	1	Local	`D:\nexj\modeld\node1,D:\nexj\modeld\node2` or `D:\nexj\modeld\{node1,node2}`
Linux	2	2	Remote	`ssh://hostname1/opt/nexj/modeld,ssh://hostname2/opt/nexj/modeld`
	2	1	Remote	`ssh://hostname/opt/nexj/modeld/{node1,node2}` or `ssh://hostname/opt/nexj/modeld/node1,ssh://hostname/opt/nexj/modeld/node2`
	2	1	Local	`/opt/nexj/modeld/node1,/opt/nexj/model/node2` or `/opt/nexj/modeld/{node1,node2}`

When running two or more nodes on the same server, ensure the port.offset property is specified so ports from different nodes do not conflict with each other. The default offset for the port is relative to the port in the HTTP server URL. For example, if the HTTP server URL is http://host.domain.ext:7080/nexj and the port offset is 100, the JVM will listen to port 7180 for HTTPS traffic.

For more information about specifying system properties, see Specifying JVM arguments and system properties.

If you are deploying a Model Server cluster, on the Clustering/Session tab, select the Distributed (Enable Clustering) checkbox.
Save the updated environment file.
If using SSH, do the following:
1. Click Window > Preferences . The Preferences dialog opens.
2. Click NexJ Studio > Remote Deployment > SSH .
3. In the Known hosts file field, enter the path to the known hosts file. The known hosts file allows NexJ Studio to authenticate the server.
4. In the Personal key field, do one of the following:
  1. If basic authentication is enabled in the environment file, select the Use password from the .server file (basic authentication) .
  2. If basic authentication is not enabled in the environment file, in the Identity file field, enter the path to the private key for the client.
If you want to use environment variables from a properties file, click the Set current server button and select the environment and properties file combination that you want to use.
Copy the appropriate database driver, such as jtds -1.2.2-7.jar or ojdbc6.jar , to your project's lib directory.
Click the Deploy Model button . The server instance or cluster is installed in the directories that you specified.

In case the database driver that you copied in the previous step does not get deployed, be sure to copy the appropriate database driver, such as jtds -1.2.2-7.jar or ojdbc6.jar, to the < SERVER_HOME>\jvm directory for each deploy location that you specified earlier in the Deployment Location field. If you are using Java 8 or lower, you can, alternatively, add the database driver to the $JAVA_HOME/jre/lib/ext folder . If using SSH, tools such as sftp or scp may be required to copy the database driver. For more information about required database drivers, see Required database drivers in the NexJ CRM Release Notes.

The Model Server instance or cluster is deployed, and a BUILD SUCCESSFUL message displays in the Console.

The deploy directory contains the following directories:

Directory	Contains
bin	modeld.bat, modeld-svc.bat, modeld.sh files
conf	jvm.conf, log4j.properties, modeld.conf files
data/<node>	Persistent data in <node>
jvm	Framework JAR files
log	Log outputs
model	Model JAR files
tmp	Temporary working files
win32-x64	64-bit executable file
win32-x86	32-bit executable file

Deploying using command line

You may also use the command line to deploy Model Server without the help of NexJ Studio. The command line is necessary if you cannot use NexJ Studio in the deployment environment, or if you require the deployment process to be automated with a script.

You need the following to use this method:

Apache Ant
Java Development Kit
Studio plugin folder (nexjstudio_version)
Published model file

Specify the location for these items in the command line. For the Studio plugin folder, either NexJ Studio should be installed or the plugin should be extracted on the hard drive. If NexJ Studio is installed, the plugin folder is located in the NEXJ_PLUGIN/version/plugins directory.

To deploy Model Server using the command line:

Open your command line console.

Enter the deployment command at the prompt. You can run Ant directly by specifying its location or you can change your directory to the bin folder and run the program from there. If you are deploying through SSH and the remote host is not already trusted, add the remote host to your known hosts file or include the following line as part of the deployment command.

-Dinstaller.cmd.jsch.knownHostsFile=\<trust-all\>

The deployment process executes. Ongoing results are displayed in the console window until the deployment finishes or an error occurs. If there is an error, the console displays the problem before halting execution.

Following is a sample command for SSH deployment.

$ANT_HOME/bin/ant \ 
      -f $NEXJ_PLUGIN/build/build.xml \ 
      -Dplugin.dir=$NEXJ_PLUGIN \ 
      -Dpublish.dir=$MIXINS \ 
      -Dbase.jar=$JAR_FILE \ 
      -Dproject=".tmp" \ 
      -Dout.dir=$OUT_DIR \ 
      -Dserver.properties=$PROP_FILE \ 
      -Dbuild.jnlp=false \ 
      -Dcipher.master.url=$MASTER_PWD \ 
      -Declipse.dir=$ECLIPSE_DIR \ 
      -Dinstaller.cmd.jsch.knownHostsFile=\<trust-all\> \ 
server.config server.deploy | tee $SCRIPT_DIR/../log/deploy.log

The following table provides example values for the parameters in the example deployment command.

Property	Description	Example value
NEXJ_PLUGIN	The location where the NexJ Studio plugin is installed.	/releases/modeld/framework/extracted/plugins/com.nexjsystems.nexjstudio_133.41.0
MIXINS	The directory containing the NexJ mixins.	/releases/modeld/mixins
JAR_FILE	The location of the JAR file containing the base metadata.	/releases/modeld/model/nexj-meta-project-0.0.2.0-27.885.1307.160.52-36f840ea.jar
OUT_DIR	The location of temporary files used during the deployment process.	/releases/modeld/tmp
PROP_FILE	The file containing environment properties.	/data/nexj/releases/modeld/env/.properties
MASTER_PWD	The location of the master file if using password encryption. For more information, see Setting up password encryption.	/security/master.pwd
ECLIPSE_DIR	The location of your Eclipse installation.	/releases/modeld/eclipse

If you are using an SSH key instead of an SSH username and password, you must also include the location of the SSH key (which could be a pem file) in the deployment command. The JVM argument for this would be:
-Dinstaller.cmd.jsch.identityFile="<ssh_key_file_location>"
To deploy using a properties file as well as an environment file, use the following command: -Dserver.properties=$<PROP_FILE> \ where PROP_FILE is the name of the properties file you want to use for the environment, for example, staging.properties.
The command should look like this:
```
c:\apache-ant\bin\ant 
   -propertyfile "c:/work/staging.properties" 
   -f "c:/work/plugins/com.nexjsystems.nexjstudio/build/build.xml"
server.config server.deploy
```
Copy the appropriate database driver, such as jtds-1.2.2-7.jar or ojdbc6.jar, to the < SERVER_HOME>/jvm directory for each deploy location that you specified earlier in the Deployment Location field. Alternatively, you can add the database driver to your Java classpath, for example, $JAVA_HOME/jre/lib/ext . For more information about required database drivers, see Required database drivers in the NexJ CRM Release Notes.

The Model Server instance or cluster is deployed, and a BUILD SUCCESSFUL message displays in the Console.

If you want to compile the code using JDK 11, before starting the server, you will need to set the java code executable in the build.properties file to Java 11, as shown in the following example:

javac.executable=C:/Java/jdk-11.0.2/bin/javac.exe