HomeDownloadsCadacus WCF Service
 
Document last modified: November 14, 2019

Before installing this download in a LIVE environment:

  1. BACKUP "Live" SYSPRO files, folders, and database.
  2. Install the new release in a TEST environment.
  3. Get user acceptance signoff on testing results.
  4. Test backup/recovery steps to ensure operational continuity.

If assistance is needed to implement sound testing, operational backup, and a recovery process, please contact your appropriate support provider.

Cadacus WCF Service Download and Installation

Overview

Our Cadacus WCF (Windows Communication Foundation) Service is based on a Microsoft framework for communicating messages between our Handheld WMS solution and the SYSPRO application server.

Steps for installation:

Requirement: To use this version of Cadacus WCF Service, the minimum version of Microsoft .NET Framework (4.5.2, or greater) must be installed. Most modern Windows servers manage this requirement without manual intervention; however, if there is a question as to which version is installed, please contact your IT department to verify this minimum version is met.

Click the download button below and save the installation file. Run the installation program "as Administrator" (required) on the SYSPRO application server. Follow the prompts of the installation program.

Cadacus WCF Service
Released : September 24, 2019 

Edit the configuration file as required. If the service is being updated, the current configuration file will be saved. Please compare the new and old configuration file and reset the values as needed. To save the changes to the configuration file, Notepad (or you favorite text editor) must be "run as administrator". The configuration file is called CadacusWCFService.exe.config in the folder where the service was installed (typically "C:\Program Files (x86)\Cadacus\WCFService").

For SYSPRO 8, the configuration parameter "UseSysproWCF" must be set to "Yes".

The configuration parameters are explained in the configuration file.

Go to Windows Services and "Start" the Cadacus WCF Service

Queue Posting Feature

Queued posting provides for the following benefits in the Handheld WMS Solution

  • improved performance:  transaction queues provide load leveling to prevent sending applications (handheld devices) from overwhelming the receiving application (SYSPRO) during peak work loads
  • failure isolation:  sending and receiving applications can fail without affecting each other
  • disconnected operations:  in some limited availability networks where mobile devices might move in- and out-of range in a wireless network, message queuing allows connections to drop and be re-established without interrupting the worker's task at hand

Multiple instance installation

The service allows for multiple instances to be installed.  This allows for multiple ports to be used for either load balancing, isolation or multiple configurations.

Note: It is not recommended in a normal installation to have multiple instances. Testing, configuration desires or remote locations on slower connections could be uses of this feature.

In order for a handheld device to use the additional instance the port number in the handheld device web services configuration needs to be set to the port number of the instance the device should use.

To install an additional instance of the service start a command prompt "as administrator" and issue the following command.

C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil /Instance=2 "C:\Program Files (x86)\Cadacus\WCFService\CadacusWCFService.exe

To install more instances, change the "2" in the /Instance=2 to a different number.

The port number associated with each instance will be 1990 + the instance number.  Port 1991 is the first instance, 1992 will be the port for instance number 2, etc.

To install an additional instance using a different configuration file.

In the C:\Program Files (x86)\Cadacus\WCFService\ folder

  1. Copy CadacusWCFService.exe to CadacusWCFService2.exe (or similiar)
  2. Copy CadacusWCFService.exe.config to CadacusWCFService2.exe.config (match name used in step 1)
  3. Edit new config file as desired
  4. Issue the command C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil /Instance=2 CadacusWCFService2.exe (match name used in step 1)
  5. Remember if this is done and the WCF service is upgraded the exe file must be copied over again and the config file checked for changes.

Cadacus WCF Service testing and troubleshooting

Why CADACUS SOLUTIONS FOR SYSPRO?

Since 1991, as developer of the standard EDI, Shipping, and Freight Calculator Solutions for SYSPRO, our products are fully integrated with SYSPRO and drive efficiencies for hundreds of users worldwide.

Why SYSPRO?

For 35 years, SYSPRO has had a single product focus resulting in an award-winning ERP system with a track record of success for over 14,000 customers worldwide.