Multiple Syracuse - *Sage X3 General Discussion Forum - Sage Business Cloud Ent...

Page 1 sur 3

How to install multiple node servers

This document explains how to install a second node.js server (for scalability
purposes) on an existing installation. The additional server shares the same
MongoDB repository.

This procedure describes a Windows installation, but the information can be used
for any operating system on which the X3 web server is usable.

Example
• You have a running Syracuse environment on X3ServerA with a MongoDB
and an ElasticSearch installed and set.
• You want to install a secondary Syracuse server on X3ServerB.
• On Server X3ServerB, the Syracuse prerequisites are met (except for the
MongoDB and the elastic search installation).

Operation on X3ServerA
• Open a cmd window.
• Go to the Syracuse installation directory, and type the following commands:

cd syracuse
cd certs_tools
certgen.bat

The last command requires you to enter data and answer some questions:

• Select option (1): Create new certificate and private key.

https://sagecity.na.sage.com/support_communities/sage_erp_x3/f/sage-x3-general-dis... 03/04/2018
Multiple Syracuse - *Sage X3 General Discussion Forum - Sage Business Cloud Ent... Page 2 sur 3

• Enter the server name (in our case X3ServerB).

• Enter the server name for tcp connection (in our case X3ServerB).
• Enter the days of validity (5000 for example).
• Enter the passphrase for the new private key.
• Reenter the passphrase for the new private key.
• Enter the passphrase for the private key of the CA certificate (you need to
know this passphrase).
• Enter the port of the Syracuse server where you want to transfer the
certificate (enter 8124; but you will get an error message because the server
is not installed yet).

The following operation will run:

Generate key pair ...

Generate certificate ...
Write private key output/testserver.key ...
Write certificate output/testserver.crt ...
Write public key output/testserver.pem ...
Transfer data to xxxserver:8124 ...
Cannot connect to xxserver: java.net.UnknownHostException: X3ServerB
Press RETURN to continue
Finished

Now you can return to your cmd window and type:

cd output

First, check that x3serverb.crt, x3serverb.key and x3serverb.pem were generated.

Then:

• Copy the x3serverb.pem in the runtime keys subfolder.

• Copy x3serverb.crt, x3serverb.key AND ca.cacrt on X3ServerB (for
example in c:\sage\cert\x3serverb).

Operation on X3ServerB
• Start the Syracuse server installation.
• On step 4, choose the new installation option.
• On step 5, enter the installation path.
• On Step 7, specify X3ServerA in the Host Name field and the correct port for
MongoDB. An information message will appear : This MongoDB is used and
already has a database with the name ‘syracuse’ ! Do you want to continue?
• Click the 'OK' button to validate.
• On Step 8, specify X3ServerA in the Host Name field and the port for
ElasticSearch.
• On Step 9, specify the path where you copied the certificate files (for example
in c:\sage\cert without x3serverb at the end !).

https://sagecity.na.sage.com/support_communities/sage_erp_x3/f/sage-x3-general-dis... 03/04/2018
Multiple Syracuse - *Sage X3 General Discussion Forum - Sage Business Cloud Ent... Page 3 sur 3

• IMPORTANT : Clear the Simplified certificates installation for a single server.

• Validate all the steps after and check for errors in the log :

Server name X3SERVERB

Error: Nanny already installed Error: Nanny already installed
at start (C:\Sage\Syracuse\syracuse\bin\node_modules\syracuse-load\lib\balancer.js:512:1
at __streamline$run (C:\Sage\Syracuse\syracuse\bin\node_modules\streamline\lib\fibers-fa

Disregard this error.

• Before executing the next command, ensure that X3ServerB is running the
same version as X3ServerA.

• If the X3ServerA is on version 6 + hotfix, we need to install the hotfix

on X3ServerB.

• Open a cmd window. You must be connected with the same account
that runs the node.js server.

• Go to the Syracuse installation directory, and type the following commands

(enter the passphrase for the new private key you entered when generating
the certificate): cd syracuse passphrase.cmd “passphrase”

Your are now able to connect to your additional server.

https://sagecity.na.sage.com/support_communities/sage_erp_x3/f/sage-x3-general-dis... 03/04/2018