Transact

⌘K
  1. Home
  2. Transact
  3. Install and Upgrade
  4. Additional Resources
  5. Windows
  6. Multi-Server Deployment

Multi-Server Deployment

Overview

This feature allows user to set up multi server environment for Ephesoft. By using multi server environment, two or more servers can run at the same time having shared database and shared folders.

This feature helps the user to increase the throughput via processing the batches using multiple servers.

Steps to setup Multi-Server environment for Ephesoft

User can install Ephesoft through installer on all the machines by following mentioned steps:

At the time of installing Ephesoft on the first machine

  • User need to enter the information as described in below screenshots:
  • On database configuration screen, user should enter the information in below format:

The same information, entered here, should be used while installing Ephesoft on other machines.

 

400px-3.1_MultiServer_Env_Setup_10001

 

Port number should not already be in use.

 

  • User needs to fill in Registration information as per the below screen shot

 

400px-3.1_MultiServer_Env_Setup_10002

  • Select “No” option on shared folder configuration screen.

400px-3.1_MultiServer_Env_Setup_10003

 

  •  The path of shared folders should be such that it should be shared over the network, so that it can be accessed by the other machines also.

For example: [file://server_name/path_to_shared_folders OR  \server_namepath_to_shared_folders]

Server 1:

Install Shared folder to:

\server_nameEphesoft]   .
This will create folder named “SharedFolders”  folder inside the Ephesoft folder on the server.

400px-3.1_MultiServer_Env_Setup_10004

 

 

  • Now complete the installation by following the standard steps.

Note*: The installation path should not contain white spaces.

At the time of installing Ephesoft on the other machines

  • User needs to enter the information as described in screenshots below:
  • Database information needs to be same as entered for first install. This is very critical step in multi server setup.

400px-3.1_MultiServer_Env_Setup_10005

 

  • Select “Yes” option on shared folder configuration screen.

 

400px-3.1_MultiServer_Env_Setup_10006

 

 

  • On destination folder configuration screen, user should enter the path of shared folder same as entered while installing on first machine.
for example on Server 2:
Shared folder path is : 
\server_nameEphesoft
This will link it with the already existing folder named “SharedFolder” on the network share.

400px-3.1_MultiServer_Env_Setup_10007

 

  • Now complete the installation by following the standard steps.

 

Other Configurations

  • The cron expression will have different values at different machines for following cron jobs at

{Application}WEB-INFclassesMETA-INFdcma-workflowsdcma-workflows.properties

dcma.pickup.cronjob.expression=15 0/1 * ? * *

dcma.resume.cronjob.expression=15 0/1 * ? * *

e.g.

For server 1

dcma.pickup.cronjob.expression=15 0/1 * ? * *

dcma.resume.cronjob.expression=15 0/1 * ? * *

 

For server 2

dcma.pickup.cronjob.expression=45 0/1 * ? * *

dcma.resume.cronjob.expression=45 0/1 * ? * *

 

  • All the machines running in multi-server environment should be verified by a single Ephesoft license, installed on an Ephesoft server. To do so, following steps need to be followed:
  • The license server host configuration should be changed in the machines where the license server is not running i.e. they all should refer to the machine with Ephesoft license installed and license server running. This is done by changing the ephesoft.license.server.host property in license-client.properties file, to the IP address of the machine on which license server is running.

Sample properties file:

Location: META-INF->ephesoft-license-client->license-client.properties

How to Change Ephesoft’s Port Number

Sometimes it is necessary to change the port that Ephesoft operates on. This is to prevent conflicts with other programs that are using port:8080

Shut down Ephesoft if it is currently running.

  • Navigate to the web.xml file found at <Ephesoft Installation Directory >ApplicationWEB-INFweb.xml

User needs to change this value from:

<context-param>

<param-name>port</param-name>

<param-value>8080</param-value>

</context-param>

to this:(or the desired port number)

<context-param>

<param-name>port</param-name>

<param-value>8090</param-value>

</context-param>

  • Navigate to dcma-batch.properties

Found at <Ephesoft Installation Directory >ApplicationWEB-INFclassesMETA-INFdcma-batchdcma-batch.properties

Then proceed to change this from:

batch.base_http_url=http://localhost:8080/dcma-batches

to this:

batch.base_http_url=http://localhost:8090/dcma-batches

  • Navigate to server.xml file

Found at <Ephesoft Installation Directory >EphesoftJavaAppServerconfserver.xml

Change the highlighted value below to match the port number in the previous files (8090 or the desired port number)

<Connector port=”8080″ protocol=”HTTP/1.1″

connectionTimeout=”20000″

redirectPort=”8443″ />

 

Note: The easiest way to do this is to do a find/replace for “8080” and replace all cases of 8080 with 8090 (or the desired port number).

Change this:

<Server port=”8005″ shutdown=”SHUTDOWN”>

To this:

<Server port=”8006″ shutdown=”SHUTDOWN”>

Also change this:

<Connector port=”8009″ protocol=”AJP/1.3″ redirectPort=”8443″ />

 

To this: (or desired port)

<Connector port=”8019″ protocol=”AJP/1.3″ redirectPort=”8443″ />

Finally, restart Ephesoft.