Comtrex INet Order Service
Reference and Installation Instructions

General Info About This Service

Mandatory Installation Prerequisites
  1. This service is intended to be installed only by Comtrex installation and support personnel.
Installation Instructions
Important: Read this section before starting installation.
  1. Stop any existing INetOrderService and uninstall it first.
  2. Installation must be on the PC that is hosting the Odyssey databases.
  3. Insure you have Administrator privileges or use "Run as Administrator".
  4. Click on one of the the installation links below to download the installation program.
  5. Zip download includes .msi and a setup.exe if needed.
  6. Execute the downloaded .exe or .msi file to start the installation.
  7. After installation, delete downloaded (.msi) file if desired.
Installation Followup
  1. Open TCP port 6788 in your internet facing router(s) if allowing http unencrypted requests.
  2. Open TCP port 6789 in your internet facing router(s) if allowing https encrypted requests.
    These ports are for incoming orders from the internet to the INetOrderService (INetOrderService.exe).
  3. Be sure to open these ports in your firewall on this server/terminal. Do not open INetOrderService.exe as a 'Program' through your firewall. Open the 'Port(s)' directly.
  4. If there was a pre-existing INetOrderService installed, remove any possible pre-existing 'Program' firewall rule. This should only be necessary if an older version of INetOrderService.exe with a version number starting with '1' is being replaced.
  5. Be sure to open UDP port 31248 on the terminal that is designated as the processing terminal.
    If no firewall is running on the processing terminal, or POS2100.EXE is passed through the firewall, there is probably nothing to do. This port is used by the dll(s) to notify the processing terminal POS2100.exe that an order has arrived. This notification is especially important for instore kiosk type ordering for throughput.
  6. If using https, you must install a valid certificate provided by a certificate authority (CA). An alternative to a valid certificate is a self-signed certificate. If using a self-signed certificate, the vendors software must be configured to allow a certificate without a valid CA. A self-signed certificate provides encryption but does not verify the server.
  7. The standard installed config file will not have the 3 https related settings. Another config file is included with the installation that has default https settings included. If using https, you can rename the 2 config files to make the https settings visible, or you can copy/paste the https settings into the installed config file. If using the https settings, make sure the config setting 'CertificateThumbprint' matches your certificate. The only setting that may possibly need changing is the 'CertificateThumbprint' setting. If using the included self-signed certificate, the 'CertificateThumbprint' in the included config file is set correctly.
  8. In POS2100 Programming, go to [Printer Configuration][Terminal Print Options] and tab [Output]. Change Print/Video Output Path from G:\POS2100\Remote to C:\Icom\POS2100\Remote. For this terminal only.
  9. After all of these steps are complete, start the service.
Installation Reference
  1. Configuration file settings. Config file(s) location is listed below.
     
    Value NameValue DataDescription
    PlainURL http://+:6788/ This is the setting to allow/use http unencrypted requests. This setting may be used alone or in combination with the next 3 encrypted settings.
    EncryptedURL https://+:6789/ This is the setting to allow/use https encrypted requests. This setting may be used alone or in combination with the above unencrypted setting.
    CertificateBindingIPPORT 0.0.0.0:6789 This setting is the TLS Certificate binding port. It is only used if using https.
    CertificateThumbprint ec7631b577
    32760e0c98
    0e809a0781
    20a6479feb
    This setting is the TLS Certificate thumbprint. It is only used if using https. 40 characters long, no spaces, on one line. Broken up here for display purposes. Must match your certificate.
    HoursToRetainXML 120 This setting is how long to retain the XML and/or JSON request/response files before automatically removing them. The default 5 days is usually long enough to allow reference of old data.
    LastDailyMaintenanceDay 0 This setting is for the service to keep track of last maintenance day so as to only perform any required maintenance only once per day. Do not edit this setting.

  2. Registry changes made to POS2100 environment by this installation.
    These paths are normally substituted drives (G:) and substituted drives may not be available for the service (INetOrderService.exe).
    • (32 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Comtrex Systems\PCS BackOffice] OR
      (64 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Comtrex Systems\PCS BackOffice]
      • LanguageDBPath = c:\icom\database\
      • LanguageProgramFile = c:\icom\database\
    • (32 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Comtrex Systems\POS2100] OR
      (64 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Comtrex Systems\POS2100]
      • CBODatabasePath = c:\icom\database\
  3. Files updated or installed by this installation.
    • C:\windows
      • INetOrder.dll - Provides service in XML format. (deprecated)
      • POS2100AUX.dll - Provides service in JSON format.
    • (32 bit) C:\Program Files\Comtrex Systems\INetOrderService OR
      (64 bit) C:\Program Files (x86)\Comtrex Systems\INetOrderService
      • INetOrderService.exe - TCP/IP Service executable.
      • INetOrderService.exe.config - Config with only http settings. Installed default.
      • INetOrderService.exeHTTPS.config - Config with http and https settings.
      • ComtrexINetOrderService.pfx - Self-Signed certificate. Code is 123key123
      • Misc. install/uninstall support files.
Version History (INetOrderService.exe)
Links and Downloads

Click here to read Online Ordering indepth documentation.

Click here to Download .msi

Click here to Download .zip

 
Page last updated: February 16, 2024