> SYSPRO Harmony Service

SYSPRO Harmony Service

This service is used to query and post transactions to the Harmony Database.

Applications using this service

  • SYSPRO Harmony

Getting Started

Installation

  1. Run the SYSPRO.Harmony.Service.exe executable.

    You can obtain the file from the Ports and Downloads section of the InfoZone. Otherwise, contact your local reseller for more information.

    After any port updates, we recommend you restart the service to release any e.net business objects which may be held by the service.

    Reinstalling a service is typically only required if an updated and/or improved version of the service is released.

  2. During the installation you will be required to configure settings for the service.

    Installation field Description
    Service port This is the communications port that will be used by the service.
    Port numbersDescription
    Below 1023Reserved for system ports.
    From 1024 to 49151Recommended user ports.

    Once a port number is assigned, avoid reusing that number for another service as this will cause a conflict.

    From 49152 to 65535Dynamic ports.

Troubleshooting

Debugging and diagnostics

You can troubleshoot errors or failures when using this service by editing the associated config file in elevated mode (i.e. with administrator privileges).

The SYSPROHarmonyDatabaseServiceHost.exe.config file is located in the folder to which you installed the service and defaults to: C:\Program Files\SYSPRO\SYSPRO Harmony Service.

[Note]

You should only edit this file for debugging purposes.

Don't use this as a method to update values for the service. The reason for this is that a wizard installation updates the system registry, which is what is read when using the service. A fresh installation will overwrite these values, which may cause problems when you next run the service.

Service logging

The SYSPRO Harmony Service outputs an event log to the SYSPROSHS file (Control Panel->Administrative Tools->Event Viewer->Applications and Service Logs) which you can review for diagnosing any problems encountered.