Prerequisites overview
This document provides an overview of the prerequisites to install the different upgrades of Sage X3.
Databases
| Component | Product version | Component version |
|---|---|---|
| Oracle |
Prior to release 2020 R2/V12.0.22 |
12c R1 and R2 SE2, EE |
|
From release 2020 R2/V12.0.22 |
19c SE2, EE | |
| Microsoft SQL Server | Prior to release 2020 R3/V12.0.23 |
2016 SE, EE, BI 2017 SE, EE, BI |
| From release 2020 R3/V12.0.23 to release 2023 R1/V12.0.33 | 2019 SE, EE, BI | |
| From release 2023 R1/V12.0.33 | 2022 SE, EE, BI | |
| MongoDB | From Syracuse 12.5 in release 2019 R5/V12.0.20 to release 2020 R3/V12.0.23 | 3.6 |
| Syracuse 12.8 in release 2020 R3/V12.0.23 | 4.0 | |
| From Syracuse 12.9 in release 2020 R4/V12.0.24 to release 2021 R4/V12.0.29 | 4.2 | |
| From Syracuse 12.14 in release 2022 R1/V12.0.29 | 4.4 |
Notes:
- The MongoDB installer is included in the Sage X3 ISO.
- MongoDB versions under 4.2 are not compatible with Windows Server 2019.
- MongoDB 4.4 is not compatible with Windows Server 2012 R2.
Microsoft PowerShell
PowerShell is a cross-platform task automation solution composed of a command-line shell, a scripting language, and a configuration management framework. PowerShell runs on Windows, Linux, and macOS.
Below, you can find the requirements for the runtime and database server for each release prior to and since release 2022 R4/V12.0.32:
| Product version | Component | Oracle database architectures | SQL Server database architectures |
|---|---|---|---|
| Prior to release 2022 R4/V12.0.32 | Runtime server | - | - |
| Database server | - | - | |
| From release 2022 R4/V12.0.32 to release 2023 R1/V12.0.33 | Runtime server | Microsoft PowerShell 7.2 or later | |
| Database server | - | - | |
| From release 2023 R2/V12.0.34 | Runtime server |
Microsoft PowerShell 7.2 or later Recommended: Latest version |
Microsoft PowerShell 7.2 or later Recommended: Latest version SQL Server module for PowerShell version 22 or later Recommended: Latest version |
| Database server | - |
Microsoft PowerShell 7.2 or later Recommended: Latest version SQL Server module for PowerShell version 22 or later Recommended: Latest version |
For more details, consult the installation documentation.
Server operating system
| Component | Product version | Component version |
|---|---|---|
| Windows Server | Prior to release 2020 R2/V12.0.22 | 2016 Essentials, Standard, and Datacenter |
| From release 2020 R2/V12.0.22 to release 2022 R3/V12.0.32 | 2019 Essentials, Standard, and Datacenter | |
| Since release 2022 R4/V12.0.32 | 2022 Essentials, Standard, and Datacenter | |
| Red Hat Enterprise Linux | Prior to release 2022 R4/V12.0.32 | Linux Server x64 release 7 |
| Since release 2022 R4/V12.0.32 | Linux Server x64 release 8 | |
| Oracle Enterprise Linux | Prior to release 2022 R4/V12.0.32 | Linux x64 release 7 |
| Since release 2022 R4/V12.0.32 | Linux x64 release 8 |
Note: Windows Server 2012 R2 should not be used for new installations, as:
- Its End of Life is planned for October 10, 2023.
- Sage stopped supporting Windows Server 2012 R2 in 2022.
- If you are currently using Windows Server 2012 R2, you need to upgrade to Windows Server 2016, 2019, or 2022.
Note:
-
For Red Hat and Oracle, the libunwind library is mandatory since release 2022 R4/V12.0.32.
-
For Oracle Enterprise Linux x64 release 8, the compat-openssl10-1:1.0.2o-3.el8.x86_64 package is mandatory.
Servers, frameworks, and middleware
| Component | Product version | Component version |
|---|---|---|
| Elasticsearch | From Syracuse 12.3 before release 2020 R1/V12.0.21 | 6.4 |
| From Syracuse 12.6 in release 2020 R1/V12.0.21 to release 2020 R3/V12.0.24 | 6.8 | |
| From Syracuse 12.9 in release 2020 R4/V12.0.24 to release 2023 R1/12.0.33 | 7.16 | |
| From Syracuse 12.19 in release 2023 R2/12.0.34 | Latest ElasticSearch 8 Version | |
| Java Virtual Machine | From release 2020 R2/V12.0.22 | Latest Java 8 Version |
The following components contain a validated version of Node.js to be installed within the setup pack:
-
Syracuse web server
-
X3 Services
-
Automated Test Platform (ATP)
Some components of $$PRODUCT will also install a validated version of the Microsoft .NET Framework.
Browsers
| Component | Version |
|---|---|
| Google Chrome | v87+ |
| Firefox | v79+ |
| Safari (Mac OS only) | v13+ |
| Chromium-based Edge | v87+ |
Note: Desktop browsers are certified on Windows 7, Windows 8.1, Windows 10 (Edge only on Windows 10), Windows 11, and Mac OS X. Other Linux-based systems are "compatible only."
Mobile applications
| Component | Version |
|---|---|
| iOS | 10+ |
| Android | 7+ |
Client components
| Component | Version |
|---|---|
| Microsoft Office (32 and 64-bit editions) | 2010, 2013, 2016, 2019 |
| Microsoft Office as part of Office 365 (32 and 64-bit editions) | Latest Office 365 application |
| Microsoft Outlook (32 and 64-bit editions) | 2010, 2013, 2016, 2019 |
| Microsoft Outlook as part of Office 365 (32 and 64-bit editions) | Latest Outlook Office 365 application |
| Crystal Reports Designer | CR2016 and CR2020 |
Note:
-
Office and Outlook as part of Office 365 do not have support for Office online.
- To use Crystal Reports Designer 2016 and 2020, the Print Server version must be ≥ 2.18.
Virtualization platforms
You can run Sage X3 on a virtualization platform. This is supported if:
- The operating system used in the Sage X3 virtual machines:
- Is certified by the virtualization platform vendor.
- Is supported by Sage X3.
- The virtualized environment is correctly configured and managed according to virtualization platform and hardware vendors’ good practices, particularly:
- Lowest possible latency between the database tier and the application/runtime tier.
- No (or very little) CPU over-provisioning.
- No or moderate memory over-provisioning.
- Plenty of storage IOPs for the database tier. SSD highly recommended.