SYSPRO 8 e.NET Communications Load Balancer

Exploring

Based on Windows Communication Foundation, this service exposes the SYSPRO64.DLL library to internal and external applications that need to interact with SYSPRO (e.g. SYSPRO Espresso, Predictive Search, third party developer applications, etc). Data is retrieved from the SYSPRO database using the open e.net architecture, without compromising data integrity.

This service replaces the SYSPRO e.net WCF Service (originally developed to replace SYSPRO Web Services and DCOM) and provides for load balancing functionality as well as being fault-tolerant (e.g. if a channel fails, a new thread is initiated automatically to prevent the whole service from failing).

This service is used by SYSPRO 8 and any external or third party e.net application accessing SYSPRO data.

Although you can continue running the older SYSPRO e.net WCF Service alongside the new SYSPRO 8 Communications Service, you will have to configure a different communication port.

This service is used by:

  • SYSPRO 8
  • SYSPRO Avanti
  • SYSPRO Server-side Reporting
  • SYSPRO Web-based Product Configurator
  • Executive Dashboard
  • SYSPRO Workflow Services
  • SYSPRO e.net Diagnostics
  • SYSPRO Point of Sale
  • SYSPRO Harmony
  • SYSPRO Espresso
  • SYSPRO Machine Learning
  • Any external or third party e.net application accessing SYSPRO data

  • The default location for this service is:

    Program Files > SYSPRO > SYSPRO 8 e.net Communications Load Balancer

Overview topic

SYSPRO Services

PDF and Video Resources

Install Guides

Starting

This service must be installed on the same application server as the SYSPRO 8 Server.

  • Microsoft .NET Framework 4.8

  • SYSPRO 8 Service Upgrade Manager

  • SYSPRO 8 Server

  • This service is installed using the SYSPRO Installer Application.

Solving

You can debug this service by editing the associated config file in elevated mode (i.e. with administrator privileges).

The SYSPRO.8.enet.Communications.exe.config file is located in the folder to which you installed the service.

You can view monitoring and troubleshooting messages about this service using the Event Viewer function in Windows:

(Control Panel > System and Security Administrative Tools > Event Viewer > Applications and Service Logs)

This service outputs an event log to the SYSPROECS file.

You can start, stop, restart and configure this service using the Services function in Windows:

(Control Panel > System and Security Administrative Tools > Services)

Referencing

You should only update this file for temporary debugging purposes (i.e. not as a method to update values for the service).

Any temporary changes made to the configuration files are reset to their original installation values when this application is next updated. Because these temporary changes are not carried forward, forgetting that you made them could hamper troubleshooting efforts if unexpected issues arise.

Key Description

baseaddress

 This is the template base address at which all endpoints are hosted.
portNetTcp This is the port at which the net.tcp binding is hosted.
portBasicHttp This is the port at which the basic binding is hosted.
portWsHttp

This is the port at which the WS binding is hosted.
portRestHttp This is the port at which the REST binding is hosted.
portNetPipe This is the name of the named pipe endpoint.
InstanceContextMode

This value indicates when new service objects are created.

It specifies the number of service instances available for handling calls that are contained in incoming messages.
ConcurrencyMode

This indicates whether a service supports one thread, multiple threads, or re-entrant calls.

It specifies whether a service class supports single-threaded or multi-threaded modes of operation.
AddressFilterMode

This is used by the dispatcher to route incoming messages to the correct endpoint.

It specifies the type of match semantics used by the dispatcher to route incoming messages to the correct endpoint.
backhaulPingTimeout  
workerPingTimeout

This is an integer specifying milliseconds.

This controls locked worker detection. The value specifies how long to wait for a response from the SYSPRO runtime. If a ping response exceeds this time, the worker is considered locked and marked for termination.
workerPingInterval

This is an integer that lets the supervisor test the worker every x calls and determine if the worker is healthy on every pool re-balance.

  • Zero value = detection only on pool re-balance.
  • Greater than Zero value = detection on every x calls.
  • Lower values -> Greater reliability.
  • Higher values -> Higher performance.
minWorkers

This is an integer that specifies the minimum number of worker processes.

Zero workers will cause all calls to execute internally, with no redundancy.
schedulerInterval

This is an integer specifying seconds that specifies how often the scheduler checks the recycling thresholds.

Recycling is a cooperative process, and workers will only be recycled when they fault or have no jobs in progress.

Setting this too low will reduce performance.
schedulingAlgorithm

This determines how the scheduler chooses a worker.

  • RoundRobin - a worker is chosen in round-robin fashion.

    This is better for high workloads with mostly short-lived transactions.

  • BalancedWorkload - a worker is chosen according to the jobs in progress, where the worker with the fewest jobs is considered most favorable.

    This is better for low workloads with mostly long-lived transactions.
recyclingTimes This is a comma separated list (hh:mm) and defines fixed times at which workers are recycled.
recyclingInterval This is a single value (hh:mm) and defines a fixed interval at which workers are recycled.
recyclingRequests

This is an integer that recycles a worker after it has served a certain number of requests.
recyclingPagedMemory, recyclingVirtualMemory, recyclingWorkingSet

This recycles a worker if the memory usage goes over this threshold (n{B|KB|MB|GB})

Although all these settings are available, only the working set value is close to what Windows exposes in the Task Manager. The other values may be useful in certain cases, but are harder to monitor.

recyclingWatchFolders

This is a pipe-delimited list of folders that recycles workers when a folder is modified.