Comtrex SalesForce Auth Service Reference and Installation Instructions

General Info About This Service

This service is responsible for acquiring and maintaining authorization tokens. An authorization token is required by the POS2100.EXE to initiate a guest info request to SalesForce. The database table "SalesForceDefinitions" has fields that are encrypted along with other data and sent via TCP/IP to the SalesForce OAuth2 server to acquire an authorization token. The acquired token is encrypted and stored in "SalesForceDefinitions". The token is currently valid for 4 hours and if not refreshed prior to 4 hours, will expire. SalesForce (actually Birley) sets the token's expiration time. Thirty minutes prior to the tokens expiring, this service will refresh the token for a subsequent 4 hours. This process continues as long as this service is running.
Mandatory Installation Prerequisites
  1. This service is intended to be installed only by Comtrex installation and support personnel.
  2. SalesForceDefinitions is populated with programming.exe.
Installation Instructions
Important: Read this section before starting installation.
  1. These instructions are assuming you are logged on to, and performing this installation from the actual target machine.
  2. Installation should be on the PC that is hosting the Odyssey databases.
  3. If "Comtrex SalesForce Auth Service" is already installed, perform the following steps.
    • Administrative Tools > Services > Stop "Comtrex SalesForce Auth Service".
    • Control Panel > Add Remove Programs > Remove "Comtrex SalesForce Auth Service".
  4. Click on the installation link below to run or download (ftp) the installation program.
    • If downloading, download it to any temporary directory on your C: drive.
    • If running directly, ignore the security warning.
  5. If you downloaded "SalesForceAuthServiceSetupxxx.msi", execute it to start the installation.
Installation Followup
  1. There are no registry settings.
  2. Configuration file settings. Config. file location is listed below. These settings should never need updating.
     
    Value NameValue DataDescription
    PreExpirationRefreshMinutes 30 This should not be changed without direction from engineering. This is the time prior to the authorization token expiring that the service will attempt to update the authorization token.
  3. Go to Administrative Tools --> Services. Find "Comtrex SalesForce Auth Service" and start the service.
  4. Wait a few seconds, then check the daily log file to see if any failures. Log file location is listed below.
  5. That completes the installation.
  6. Any time changes are made to "POS System Options -> Sales Force Definitions", be sure to restart service so changes are read by service.
  7. If SalesForce is no longer needed at store, please set service to disabled, or uninstall service.
Installation Reference
  1. Files and Folders created, installed or updated by this installation.
    • (32 bit) C:\Program Files\Comtrex Systems\SalesForceAuthService
      (64 bit) C:\Program Files (x86)\Comtrex Systems\SalesForceAuthService
      • SalesForceAuthService.exe - Windows Service.
      • SalesForceAuthService.exe.config - Configuration file.
    • C:\ProgramData\Comtrex Systems\SalesForceAuthService
      • LogFiles - Folder with daily log files.
Version History (SalesForceAuthService.exe)
Downloads

Click here to Run or Download.

 
Last updated: June 20, 2023