Architecture Guide SafeX3u9 ENG V1a
Architecture Guide SafeX3u9 ENG V1a
Version 1a
Contents
Contents ......................................................................................................... 1
Introduction................................................................................................... 3
Folders ..................................................................................................................... 3
Components ................................................................................................. 5
Search Engine......................................................................................................... 8
Antivirus ................................................................................................................. 13
Virtualization ......................................................................................................... 14
Remote connection.................................................................................. 21
Workstations ......................................................................................................... 26
Introduction
This document provides information on system requirements and Definitions
setup for Sage Architecture for the Enterprise (SAFE X3). SAFE X3
is a common technological platform for developing application BATCH SERVER
software. The application software
offers a standard scheduling
function in a “postponed”
General overview mode (batch) to manage a
large number of parameters
The following application software is developed using the technological for the launch of these
platform SAFE X3: processes.
• Sage X3
BATCH TASK
• Sage HR management
Unlike an interactive session,
the batch task is a process
• Sage WMS Geode (pending) launched in batch mode by
the task scheduler (batch
The technical architecture is organized in layers and designed to: server).
Folders
A folder is a repository base that contains management rules, parameters, and
data for one or more companies. It contains a directory tree on the hard disk
and tables stored in the database.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Components
All the resources described herein are logical components. They can all be
installed on the same computer or distributed across several machines
according to the number of users to be connected, the size of the database,
and the number of transactions to be processed. This model of distributed
architecture offers a high level of scalability.
Application servers
Database server Definition
The database server stores the application data, the description data for this APPLICATION DATA
application (dictionary), and the parameter data.
Tables and indexes that
SAFE X3 products are developed according to the database editor store information
recorded by application
recommendations, which guarantee the integrity and the coherence of the data users such as suppliers,
stored in the database. customers, products,
inventory, sales,
There is no limit to the size of the database and it can vary from 30 to 80 GB, production, accounting,
with some databases reaching hundreds of gigabytes. To reduce the size of etc.
the database, you can purge or archive large tables.
The Sage X3 Batch Service, which launches and executes batch processes,
runs on the Application and Main processing server.
The differences between the main processing server and additional processing
servers are as follows:
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
• Additional processing servers are optional and are used to balance the load
(CPU and memory). You can select additional servers when configuring the
entry point in the Syracuse Portal.
Additional components
Print server
Definition
This server is hosted on a machine running a Windows Server operating
system. There can be multiple print servers per solution depending on volume JSON
requirements for printing. JavaScript object
notation: a textual data
The print server supports all print requests from interactive sessions as well as format for structuring
batch submissions and sends the files to the appropriate print destination information with tags
(printer, file, PDF, FAX, etc.). MONGO DB
A document-oriented
A Windows service is started on the computer that hosts the Print server. This database classified as a
service is on port number 1890 by default, but it can be customized during NoSQL database
installation. The print service manages an output queue of the requests
submitted, and the execution of these reports can be dispatched on several SADFSQ
editing processes or threads. The number of editing processes can be An internal
customized in the Configuration Console and must be adapted to the size of the communication protocol
machine. executable
The Print server communicates with two other servers in your environment: the
Application server that hosts the printing model and the Database server that
hosts the tables via an ODBC connection.
The report files are transferred using the internal communication protocol
SADFSQ. The Print server has a client SADFSQ able to address and
communicate with a server SADFSQ running on the Application and Main
Processes server.
Reports are designed using Crystal Reports 2008, (version 12.x) or Crystal
Reports 2013 (version 14.1).
Web server
The Web (Syracuse) Server is a front-end server that end users access to
open a Sage X3 session through their internet browsers.
Each page has its own URL and sends Java Script feeds (JSON format) that
are SData normalized back to the client.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Based on the OSGi Equinox framework, it can be used to extend the standard
available functions by developing new OSGi plug-ins.
Java Bridge server encapsulates Apache HTTP and Apache Tomcat (web
servlet container).
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Configuration console
The Configuration Console is a tool used to install and administer SAFE X3
components. The Console configures the components and links them to define
a solution or work environment.
The Console uses different XML configuration files that are generated on each
server when installing the various components.
Sage X3 users are not directly in contact with the mail server but use a mail
client application, like Microsoft Outlook, to communicate with the mail
server through the SMTP text-based protocol.
Search Engine
Elasticsearch®, is a free, open source search engine based on the Lucene
engine 100% Java under the Apache License 2.0. There are no additional
database engines to be installed.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Client workstations
Desktop or laptop
Users can access Sage X3 applications on the Application server via a web
browser from their workstations.
• Mac OS X workstation:
• Smartphones
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
• Apple iPad (2,3,4, Air, mini, retina) running IOS 8 or higher (Safari 8+,
Chrome 45+)
Development platform
• Development Workbench: SAFE X3 Framework
• Development language for the application software: Sage X3 4GL
• Development language for the Web Server: JavaScript, HTML5
• Exchange protocol between the Client and the Web Server: pure HTTP
(according to the HTML 5.x specification) and Web application interface is
built on a technology like Ajax.
• Tool for packaging Sage X3 components: IzPack, open source software
built on the Java platform
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
SAFE X3 components communicate through sockets. In the case of a timeout FULLY QUALIFIED DOMAIN
or disconnection due to security components like firewalls, some Sage NAME (FQDN)
components can retrieve the socket connection for other components. The It indicates the absolute
Sage parameters need to be modified to synchronize the timeout of the user’s position of a node in the DNS tree,
connection with the firewall rules. If this occurs, confirm that everything is showing all top-level domains to
working properly, otherwise change the firewall rules so that sockets are not the root.
disconnected or closed. SOCKETS
Interface for communication
It is strongly recommended to implement the same speed and transfer mode between the various Sage
values between network card(s) installed on the servers and the ports for the technological components
switch(es). installed on the network using the
TCP/IP protocol
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Bandwidth
Workstation Front-end Server
without printing and BO requesting
60 KBps per user
Web Client Web Server (Sage) - 50 KBps Web server -> Browser
- 10 KBps Browser -> Web server
Web Client via RDP Terminal Service
24 KBps per session
protocol (Microsoft)
Web Client via ICA
XenApp Server (Citrix) 12 KBps per session
protocol
ADC client Web Server (Sage) 20 KBps per device
Antivirus
If you install antivirus protection, we recommend disabling real-time protection
and instead, review files overnight when there are few or no users logged in for
best performance. Tips
Exclude the following directories from the real-time protection if active: Disable real-time
• The directory that is on the application server "... \folders" and all its
virus protection
Microsoft updates
We recommend taking all necessary precautions when installing Microsoft
updates because there is always a risk that they could alter how the system
environment functions.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Virtualization
The information in this document is intended for physical hardware. However,
you can deploy the solution in a virtual environment like VMware vSphere,
Hyper-V, RedHat KVM, Citrix XenServer or Oracle VM.
Plan to acquire adequate backup tools so that you can save online
virtual machines and consider a redundancy of the bay and
physical blades.
However, if you opt for a virtual infrastructure, Sage cannot predict the
performance of its software applications. Therefore, we suggest a sufficiently
large virtual machine so that it can serve as a potential production server and
use the design phase of the project to determine the performance of the virtual
infrastructure before going live. In this way, you can improve the virtual
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
The results of this program can help you identify and determine how
performance compares to previously measured criteria based on benchmarks
and feedback from other customers’ production infrastructures.
Physical
* Single-tier Windows x64 & SQL Server *
S
Virtual Single-tier Windows x64 & Oracle **
i
Virtual Single-tier Windows x64 & SQL Server **
n
Physical
g Multi-tier Windows x64 & Oracle
lPhysical Multi-tier Windows x64 & SQL Server
e
Virtual
- Multi-tier Windows x64 & Oracle **
t
Virtual Multi-tier Windows x64 & SQL Server **
i
er environments generally have reduced high availability,
scalability, and security compared to multi-tier architecture
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Resource configuration
List of available operating systems
Resources Operating System versions
Windows Server x64 2012 R2
Red Hat Enterprise Linux AS x64 version 6.2 and later 6.x
Database server
Oracle Enterprise Linux x64 version 6.2 and later 6.x
Red Hat Enterprise Linux AS x64 version 7.1 and later 7.x
Oracle Enterprise Linux x64 version 7.1 and later 7.x
IBM Aix 7.1
Windows Server x64 2012 R2
Application and Main Red Hat Enterprise Linux AS x64 version 6.2 and later 6.x
processing server Oracle Enterprise Linux x64 version 6.2 and later 6.x
Red Hat Enterprise Linux AS x64 version 7.1 and later 7.x
Oracle Enterprise Linux x64 version 7.1 and later 7.x
IBM Aix 7.1
Windows Server x64 2012 R2
Red Hat Enterprise Linux AS x64 version 6.2 and later 6.x
Additional processing server
Oracle Enterprise Linux x64 version 6.2 and later 6.x
Red Hat Enterprise Linux AS x64 version 7.1 and later 7.x
Oracle Enterprise Linux x64 version 7.1 and later 7.x
IBM Aix 7.1
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
iexplore.exe, firefox.exe,
Client workstation Internet browser
chrome.exe, safari.exe
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
1 x adxdsrv.exe / solution 2 5 MB
Application main runtime x n x adonix.exe 60 MB
n x sadora.exe or sadoss.exe 25 MB
1 x adxdsrv.exe / solution 2 5 MB
Additional runtime x n x adonix.exe 30 MB
n x sadora.exe ou sadoss.exe 25 MB
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
iexplore.exe, firefox.exe,
Client workstation 100-200 MB
chrome.exe, safari.exe
n = number of concurrent users
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Remote connection
A remote connections requires a VPN connection through an internet
connection. Definition
VPN
The VPN connection can be establish by using any of the standard VPN
applications available like Microsoft VPN Client or Cisco. Virtual private
network, a system
To facilitate the remote connection to your site, provide Sage with all the that creates a direct
instructions regarding installation and configuration (list of port tcp/udp #) of link between remote
your VPN application. computers
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Sizing requirements
General prerequisites for databases and applications
Platform Windows Unix / Linux
Linux X86-64 (Intel Xeon 2.0GHz or
Processor type Quad Core Intel Xeon 2.0GHz or
IBM Power System (POWER7 / POWER8 3.6GHz or
Windows = 60 Unix = 30
Oracle = 6+ Oracle = 6+
Disk space SQL Server = 3
(GB) X3 X3+SEED = 12 X3 X3+SEED = 12
Payroll & HR PAYE+PAYEDEMO = 6 Payroll & HR PAYE+PAYEDEMO =6
Database files > 10 Database Files >10
RAID 1 Mirroring Security >= 2 disks Mirroring
RAID RAID 5 with parity control Security at low cost >= 3 disks Mirroring +
(optional)
RAID 1+0 stripping Security & performance >= 4 disks
2 x 72 GB 15k/tpm RAID 1, for the Operating System and the database engine
Disk 4 x 140 GB 15k/tpm RAID 10, for the application and the data files
Architecture 2 x 140 GB 15k/tpm RAID 1, for Oracle Archive Log Files or the SQL Server Transactions logs
under Windows Operating System the disk must be formatted with NTFS File System
Network Ethernet Card 100 MBps minimum or 1 GBps recommended
User account Group User Accounts Group
Oracle : ORA_DBA Oracle : oinstall, dba
SQLserver: sagex3 : sagex3
User Accounts sagex3 : Administrators
User Rights Assignment
Log on as a service
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
• Only two database instances are stored on the database server for the Architecture model where all
components are installed on
production and the data warehouse.
•
a single machine
Only the Sage database and Sage application resources are installed on
the machine(s).
•
MULTI-TIER
Options for additional machines : ARCHITECTURE
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
Front-end servers
Resources Sizing recommendations (physical) not Sizing recommendations (virtual) not
including OS needs (typically 2 GB) including OS needs (typically 2 GB)
1 CPU Intel i5, i7, Xeon >= 2.0 GHz
1 to 2 vCPU(s) >= 2.0 GHz
2 GB RAM
Print server 2 GB RAM
Web Syracuse For every 65 concurrent web sessions: For every 65 concurrent web sessions:
server o 1 CPU core from Intel Xeon 2.4 GHz o 1 vCPU 2.4 GHz
o 2 GB RAM o 2 GB RAM
o 2 processes node.js o 2 processes node.js
MongoDB server 1 CPU core from Intel Xeon 2.4 GHz 1 vCPU from Intel Xeon 2.4
0.5 GB RAM minimum GHz
Minimum disk space: 10GB 10 k/tpm 0.5 GB RAM minimum
Minimum disk space: 10 GB 10 k/tpm 10
ElasticSearch server 1 CPU core from Intel Xeon 2.4GHz 1 vCPU 2.4GHz
1GB RAM minimum / 1GB RAM minimum / disk minimum
Minimum disk space: 2GB 10 k/tpm 2GB 10 k/tpm
(recommended 10% of the X3 folder size per language) (recommended 10% of the X3 folder size per
language)
Front-end server
Citrix XenApp
Microsoft TS
Intel Xeon Quad Core 2.8 GHz / 8 GB RAM 1 vCPU 2.8GHz / 8 GB RAM
-for 30 memory / disk 2 x 72 GB 15ktpm in RAID-1 / disk 72 GB 15 k/tpm
connections
Intel Xeon Quad Core 2.8 GHz / 16 GB RAM
-for 60 memory / disk 2 x 72 GB 15ktpm in RAID-1 2 vCPU 2.8GHz / 16 GB RAM
connections / disk 72 GB 15 k/tpm
Intel Xeon Quad Core 2.8 GHz / 22 GB RAM
-for 100 memory / disk 2 x 7 GB 15 k/tpm in RAID-1
connections 4 vCPU 2.8GHz / 22 GB RAM
/ disk 72 GB 15 k/tpm
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.
- for 300 users Dual processor Quad Core Intel Xeon 8 vCPU 2.66 GHz / 28 GB RAM
2.66 GHz / 28 GBRAM
Linux
- for 150 users Single processor Quad Core Intel 4 vCPU 2.66 GHz / 16 GB RAM
Xeon 2.66 GHz / 16GB RAM
8 vCPU 2.66 GHz / 32 GB RAM
- for 300 users Dual processor Quad Core Intel Xeon
2.66 GHz / 32GB RAM
- for 600 users IBM POWER 7/8 8 cores IBM POWER 7 8 LCPUs
3.6GHz 64GB RAM 3.6GHz 64GB RAM
Workstations
Resources Sizing recommendations
Intel Core i3, i5, i7 or equivalent in AMD
The information contained herein is confidential and may be changed without notice. Although Sage makes
every effort to provide accurate information, no implicit or explicit warranty is given regarding the content of
this document.