Installing Enterprise Management Page 1 sur 9

Index

Installing Enterprise Management

Pre-requisites
This document describes how to install a Enterprise Management solution on a Windows or
Linux server.
Note: This procedure only applies to the first installation of a EMP technology version
2019R1 product on new servers and workstations. It is important that a prior version of
Enterprise Management has never been installed on the server.
If you want to upgrade an existing Enterprise Management solution in 11 to 2019R1, refer to
Upgrading an Existing Enterprise Management Solution.
Before the installation, you need to:

• Define the architecture of the servers that make up the EMP solution.
• Check the minimum requirements of your system environment.
• Make sure Java Runtime Environment or JDK version 7 or higher is installed. It
can be downloaded from the Oracle website. Make sure you download and
install the correct Java version based on your operating system (Windows x64
for a 64-bit Windows operating system or Windows x86 for a 32-bit Windows
operating system).

You can then follow the installation procedure available on the official support (DVD-ROM or
network location containing the installation files).

Installation overview
The main installation steps are listed below. Additional information is available in the
corresponding paragraphs.

Installing and configuring the EMP solution (Linux or Windows):

• Install the EMP ADXADMIN administration runtime.
• Install the components to configure a Enterprise Management solution.
• Install the EMP management console on a Windows workstation.
• Create a Enterprise Management solution using the EMP management console.

Installing the "Syracuse" Web Server components (Linux or Windows):

• Install MongoDB.
• Install Elastic Search.
• Install the "Syracuse" Web component.

Completing the installation for the "Syracuse" Web server and the
Enterprise Management solution:
• On the Web "Syracuse" server

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 2 sur 9

• Update MongoDB and the Web "Syracuse" server

• You need to update the Web "Syracuse" server and MongoDB with the latest
patch.
• Make sure that you have the latest available version of MongoDB Community
Edition installed with the corresponding prerequisites for the Web "Syracuse"
server.

• On the Enterprise Management solution

• Install the SEED folder
• Apply list of patches
• Update search index
## Installing Production Scheduler: Caution: This feature is only available on-premise. If you
are using the Cloud solution, this step is not relevant.

• Install the Production Scheduler.

## Installing the Print server component (Windows):

• Install a EMP Print server component.
• Configure the print server using the EMP console.
• Publish the EMP folders for the print server using the console.

Installing additional and optional servers:

• Installing a Documentation server component (Linux or Windows).

• Installing an additional Print server component:

• Complete the installation on the "Syracuse" Web server.
• Install an additional Print server component (Windows).
• Configure the Print server using the EMP console.
• Publish the Enterprise Management solution folders on the print server
using the console.

• Installing an additional Process server component:

• Install an additional Process server component (Linux or Windows).
• Configure the process server using the EMP console.

• Installing a EMP Java server component:

• Install a EMP Java server component (Linux or Windows)
• Configure the Java server using the EMP console.
• Publish the Enterprise Management solution on the Java server using the
console.

• Installing a EMP Webservice and ADC server component:

• Install a EMP Webservice and ADC server component (Linux or
Windows).
• Configure the Webservice and ADC server using the EMP console.
• Publish the Enterprise Management solution on the Webservice and ADC
server using the console.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 3 sur 9

Installing and configuring the EMP Business Intelligence:

Install the Business Intelligence.

Installing and configuring the EMP solution (Linux or

Windows)

Installing the EMP ADXADMIN administration runtime

You have to install an administration runtime on each Process, Application, Database, Print,
Java, and Webservice and ADC servers. However, it is not required on the client
workstations or on the workstation that runs the management console.
Double-click SafeX3Adxadmin.jar in the SafeX3Adxadmin folder.
The default AdxAdmin service port is 1818. Make sure this port is not blocked by existing
firewalls or antivirus software as it is used to communicate with the Console.
Caution:

• For Windows servers, run the installer as a user with administrator rights and
rights to log on as a service.
• For Linux servers, run the installer as root to create the AdxAdmin service.
You can then run the AdxAdmin service as root and use the proprietary account
of the SGBD Oracle installation to configure the database component in the
EMP Console. Refer to the console documentation (Component loading -
dialogue box > AdxAdmin process rights) for more information.

Installing the components to configure a Enterprise Management

solution
• On the database server only:
Depending on the database used for EMP, double-click "SafeX3Sqlserver.jar" or
"SafeX3Oracle.jar" in the SafeX3Installs folder.
Make sure the appropriate database engine was installed with the required settings
before attempting this installation.
• On the application server that hosts the EMP Runtime component only:
Double-click "SageX3Application.jar" in the SafeX3Installs folder.
Select New installation.
• On the process server only:
Double-click "SafeX3Runtime.jar" in the SafeX3Installs folder.
Select New installation.

Installing the EMP management console on a Windows workstation

Double-click "SafeX3Console.jar in the SafeX3Installs\SafeX3Console folder to launch the
installation.

Creating a Enterprise Management solution using the EMP

management console
Note: Before configuring a Enterprise Management Solution, make sure that:

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 4 sur 9

• Apache HTTP Server 2.2 or higher is installed on the Application Server. It can
be downloaded from the Apache website. For Windows distribution, select the
no_ssl MSI Installer Package in binaries/win32.
• The user account you use for the steps below has administrative rights and
rights to log on as a service.

• Create a new solution in the console:

• Open the EMP V2 management console and select the Solutions tab.
• Click Add.
• Click New.
• Enter the name of the server where the Application and Runtime components
are installed.
• Enter the port, user, and password for the Sage EMP AdxAdmin service.
The AdxAdmin default port is 1818.
• Select the Keep password checkbox.
• Select the APPLICATION component and click Next.
• Select the RUNTIME component and click Next.
• Select Configuration by the console and click Next.
• Click New and enter the name of the server where the Database component is
installed.
• Enter the port, user, and password for the Sage EMP AdxAdmin service.
The AdxAdmin default port is 1818.
• Select the Keep password checkbox.
• Select the DATABASE component and click Next.
• Enter the identifier (name of the solution) and the label, and enter a comment.
• Configuring the database server:
• In the Data - Application tab, enter the password for "sa", the Sql Server
instance, the database name, and the DBMS installation path.
• Click Data.
• Select Full configuration and click OK.
• Confirm that the Data portion is set to Active.
• Configuring the application and the main process server components:
• Enter the port to be used by the main process server service in EMP service
port number.
Use a different port than 1801 as it is used by Microsoft Message Queuing.
• Enter the user who will start the EMP runtime service.
• Enter the password for the user account.
• Enter the Apache installation path.
• Click Save.
• Click Application.
Once the application and runtime configuration is complete, the Enterprise
Management solution is created on the server.
• Confirm that all three components of the solution are set to Active.

Refer to the EMP management console help page by pressing F1 from the EMP
management console for more information.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 5 sur 9

Installing the "Syracuse" Web Server components (Linux or

Windows)

Installing MongoDB
MongoDB is an open source document database. Follow the detailed procedure to install it.
Note: Make sure you install MongoDB before installing the "Syracuse" Web component.

Installing Elastic Search

Elastic Search is an open source, distributed real-time search and analytics engine for the
cloud.
• Double-click "SafeX3ElasticSearch.jar" in the SafeX3Installs\SafeX3ElasticSearch
folder.
• Select New installation.
Make sure you write down the Elastic Search host name and its corresponding http
service port number. You will need this information when launching the "Syracuse"
Web server installation.

Note: There is a known issue with Elastic Search that causes the following error message:
"Search engine failed due to stack size configuration. Please increase the stack size of
elastic search in order to fix this problem.". Contact support to increase the stack size of
Elastic Search and fix this issue.

Installing the "Syracuse" Web component

Note: Make sure you install MongoDB and Elastic Search before installing the "Syracuse"
Web component.
Double-click "SafeX3Syracuse.jar" in the SafeX3Installsfolder to launch the installation:

• For Windows servers, run the installer as a user with administrator rights.
• For Linux servers, run the installer as root.

For more information on the "Syracuse" Web server installation, refer to the installation
procedure.

Completing the installation for the "Syracuse" Web server and

the Enterprise Management solution

On the "Syracuse" Web server

• Make sure the certificates were generated during the installation.
If not, generate the public key corresponding to the server (server_name.pwd). Refer
to the certificate installation documentation for more information.
• Make sure the following services have been started:

• Agent Sage Syracuse

• ElasticSearch for Syracuse
• MongoDB for Syracuse
• Sage Syracuse

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 6 sur 9

Note: You can set a dependency to ensure services are started in the order they are
needed. First, you must start the "ElasticSearch for Syracuse" and the "MongoDB for
Syracuse" services, and then the "Agent Sage Syracuse" service. The "Sage
Syracuse" service must not be started automatically.

On the Enterprise Management solution

• Make sure the certificates were copied during the installation.
If not, copy the public key corresponding to the server (server_name.pem) in the keys
folder of the solution runtime.
If there are any periods (.) in the server name, replace them with underscores in the
file name.
• Make sure the following services have been started:

• Enterprise Management solution service

• Database services

• From a "Syracuse" Web server connection:

• Open an Internet browser and log on as admin/admin to
"http://ServerName:port".
• Go to Administration > Endpoints > X3 solutions.
When prompted to, click +New X3 solution. Enter a code, a description, an
application, and the exact name of the Enterprise Management solution, the
main server host and the main server port. Click Save.
• Click Create endpoints in this new X3 solution and select the root folder.
• Click Administration > Endpoints > Endpoints and select the endpoint you
created.
Add the "Super administrators" group in the Administration section and click
Save.
• From the root folder endpoint, click Personalizations and Menus intialization
in the right-hand panel.
Wait until the end of the import.
• Log out from the web server and log back in as admin.
• Click the endpoint name in the header and select the endpoint of the Enterprise
Management root folder.
• Click Setup > Users > Users (GESAUS function).
Wait until the Supervisor installation is complete.

Installing the SEED folder

The SEED folder is the demonstration folder supplied with Enterprise Management. Aside
from root folder X3, the SEED folder is the first endpoint you can connect to. After
completing the installation, you can use the SEED folder as a sandbox.
To install it:
• Navigate to the SageSEEDFolder directory in the product DVD-ROM.
• Double-click the SEED.zip file to launch the self-extracting archive.
• Copy the extracted SEED folder to where the Enterprise Management application
folders are installed.
• Copy the extracted X3_PUB\SEED subfolder to where the Enterprise Management
application X3_PUB directory is located.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 7 sur 9

• Open the EMP Management Console, select the X3V7 solution from the Solutions
tab and click the folders icon.
• Click Import, select the SEED folder from the drop-down list and make sure that SVG
is set as the data directory.
Make sure Import of the table structure only is not selected and click OK.
• Define an endpoint for the SEED folder before using it.

Applying the list of patches

If there is a zip file in the SageX3Patch directory of the installation support:
• Go to Administration > Utilities > Update > Updates and click Add an update.
• Upload the zip file located in the SageX3Patch directory.
Refer to Updates Management for more information.

Updating the search index

You have to update the search index in order to use the data search feature for an endpoint.
• Log in to Enterprise Management as admin.
• Go to Administration > Usage > Search Index Management.
• Select the data source endpoint to index.
Leave Entities blank.
• Select the locale for which the index must be updated.
• Select Delete index before update.
• Click Update index.
Refer to Search Indexes Administration for more information.

Installing the Production Scheduler

The Production Scheduler is an option of the Manufacturing module.
Double-click "SafeX3ProductionScheduler.jar" in the SafeX3Installs folder to launch the
installation.
Refer to Installing the Production Scheduler for more information.

Installing a EMP Print server component

• Double-click SafeX3PrintServer.jar in the SafeX3Installs folder.
• Configure this component with the management console.

Installing additional and optional servers

Installing a Enterprise Management Documentation server component

By default, Enterprise Management tries to access the online documentation server through
the internet, but an optional local server can be installed. This allows customers to manage
custom help pages or to access the help when the internet is unavailable.
• Double-click "SageX3Documentation.jar" in the SafeX3Installs folder.
• Enter a name for the local documentation server, as well as an available port number.
This port will be used for the help base URL.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 8 sur 9

• When prompted to select the installation packages, select Enterprise Management

2019R1 documentation files if you want to copy the standard help pages locally.
If you only want to manage custom pages on the local documentation server, do not
check this option.
• Finish the installation process.
• For each endpoint from where you want to access the local documentation server,
enter the help base URL (http://server_name:documentation_server_port/).

Installing an additional EMP Process server component

Double-click "SafeX3Runtime.jar" in the SafeX3Installs folder to launch the installation.
Caution:

• For Windows servers, run the installer as a user with administrator rights and
rights to log on as a service.
• For Linux servers, run the installer as root to create the adxadmin service. You
can then run the adxadmin service as root and use the proprietary account of
the SGBD Oracle installation to configure the database component in the EMP
Console. Refer to the console documentation (Component loading - dialogue
box > AdxAdmin process rights) for more information.

You can then configure the component with the management console.

Installing a EMP Java server component

• Double-click SafeX3BridgeJava.jar in the SafeX3Installs folder.
• Configure this component with the management console.

Installing a EMP Webservice and ADC server component

Installing a EMP Webservice and ADC server component
This component provides a web-service SOAP server (for the Sage X3 People portal) and
VT connection.
• Make sure all system requirements (on Windows or on Linux) are met.
• Double-click SafeX3WebServices.jar in the SafeX3Installs folder.
• Select New installation.
• Enter the installation path.
• Enter the server name, the path for all temporary files and logs, and the passphrase to
use to encrypt the private key that will be generated at the end of the installation.
Make sure you write down the passphrase, and keep it at hand when launching the
configuration of the component.
• For Linux installations, set the user and group who will own the folder where the
component will be located.
• Configure the component with the management console.
Note that it is called "Web server" in the management console.

Configuring the Webservice and ADC server using the EMP console
From the EMP console:
• Define the port to use and enter the passphrase you have set during the installation.
Enter specific parameters, if required.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019
Installing Enterprise Management Page 9 sur 9

• Link the folders that will be used for web-service or VT connection to the component,
and complete the required setup.
The webservice component public key that was generated during the installation is
automatically copied in the appropriate folder of the runtime server. This is done in
order to establish an operational connection between the two components.
• Define web-service pools to enable SOAP clients call X3 Objects and sub-programs
using the SOAP protocol.
Configure a pool per folder.
Note: The web-server uses the passphrase you configured to encrypt the private key.
This allows a secure connection between the runtime and the webservice server. The
passphrase is also encrypted.
• If you connect to the management console from another user account, re-enter the
passphrase.
• If you update a webservice ADC server 231 to a newer product update, and if you
have already published the solution, make sure that the public key of the webservice
ADC server is in the keys sub-directory of each runtime directory of the linked
solutions.

Caution: If you have installed a "Syracuse" web server before installing the webservice ADC
server component, make sure you copy the public key of the "Syracuse" web server to
\data\KEYSTORE\WEBSERVER\ for a secure connection between "Syracuse" and the
webservice ADC server for the HRM portal.

Installing the Business Intelligence

Double-click "SafeX3BO.jar" in the SafeX3Installs folder to launch the installation.
Index
Refer to the Business Intelligence installation procedure for more information.

http://online-help.sageerpx3.com/erp/12/public/getting-started_sage-erp-x3-installatio... 12/02/2019