Installing the Syracuse Web Server

This document describes how to install the Syracuse web server and how to create the configuration file to work with the MongoDB database and the Elasticsearch services.

Prerequisites

Before running the V12 web server installation, make sure that:

  • All requirements (for Windows or Linux) are met.
  • You have configured the Sage X3 solution with the configuration console.
  • MongoDB and Elasticsearch were installed, and you have access to their server names, as well as their corresponding port numbers.
  • You have the license file for the Versions 7 and above web server installation.

Running the Syracuse web server installation

  1. Double-click the .jar file located in the SafeX3Syracuse directory of the DVD-ROM.
  2. Select the language for the installation procedure.
  3. Select:
    • New installation if the Versions 7 and above web server has not been installed yet.
    • Modify installation if you want to modify an existing installation.
  4. Enter the required information:
    • An identifier for the Syracuse node.
    • The path for the storage of logging information files.
    • An http service port number available on your server (the default port is 8124).
    • The number of Syracuse processes required (two are available by default).
      Note: Setting two Syracuse processes enables the load balancer mode (or nanny mode).
    • The path to the license file.
    • The information for the system account that will be used to run the service.
      This account needs to have an existing profile (not temporary), as well as the rights to log as a service.
      On UNIX, both a user and a group have to be entered.
  5. As you have already set up MongoDB, enter the host name and the port number (including the full qualified domain name if you use an SSL connection).
    Select The server uses and accepts only SSL encrypted connections and enter the corresponding information, if applicable.
    Note: The Client certificate file and the Client private key file should only be entered if you manually installed the certificates.
  6. Enter the Elasticsearch server name, as well as the appropriate port number. The default port is 9200.

Refer to Certificate Installation for the rest of the installation procedure.