Microsoft Windows Heap Memory allocation (SharedSection) configuration guidelines for Sage X3 Environments

These values are based on the environmental testing of a single tier environment utilizing Windows Server 2019, Windows SQL Server 2019, and Sage X3 Runtime R94.1.X versions. All values above are estimates and solely used to better understand the sizing of the registry value as it pertains to the session usability. All environments are unique (treated as such), and adjustments of these values will need to be vetted in a test environment.

There has been noted improvements to the environments by also adjusting the maxmem and sadmem folder values for the impacted folder endpoints (in addition to above recommendations). These values can be found by navigating to Setup, General parameters, Folders (GESADS), selecting the impacted folder from left list, then loading the Miscellaneous tab

CAUTION: This solution needs advanced Operating System knowledge. Consult your system administrator for help. Sage isn't liable for issues caused by improper changes to the Windows Registry. Always back up your data before applying advanced solutions.

CAUTION: 

Microsoft Windows Heap Memory allocation (SharedSection) configuration guidelines for Sage X3 Environments.

The chart below shows estimated values for configuring the non-interactive desktop Heap Memory allocation (SharedSection) as it pertains to Sage X3 active Convergence Sessions (AKA Classic Sessions) generated by the Runtime Server component. These changes are made to the Microsoft Windows Registry. See further down the article on how to change these Windows Registry values.

Changing the Registry Value:

Before you begin:

WARNING: This is a Windows registry change. The proper precautions should be followed (i.e. backup or restore points) before attempting to change Windows Registry configurations.

1. Load Windows Regedit (registry editor),
   1. This can be done by right clicking Start, select Run, then typing regedit (in the box) and hitting Enter.
2. In the Registry Editor, Navigate to the following directory:
   1. HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems
3. Locate the registry string named Windows.
4. Right click on the Windows string and select Modify.
5. Locate in the string value and change the "SharedSection" part of the string
   1. Example of the SharedSection value is: SharedSection=1024,20480,768 Windows=…" change it to "Windows SharedSection=1024,20480,4096 Windows=…" (i.e., you are just changing the 768 value to 4096).
   2. Tip: it is easier to copy / paste the string into a notepad doc for more easy editing and reading.
6. Click the OK button to save the change.
7. Once the change is made, exit the Registry Editor.
8. Repeat steps on all Windows Servers associated to the Sage X3 Environment.
9. Restart all servers where above changes were made.
   1. Note: SharedSection changes require a machine restart for the changes to take effect.

DocLink: Batch Server Tasks increasingly failing with ECONNRESET errors
DocLink: ERROR: ECONNRESET errors
DocLink: Batch Server Tasks fail with ECONNRESET errors