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
- This service is intended to be installed only by Comtrex installation and support personnel.
- SalesForceDefinitions is populated with programming.exe.
Installation Instructions
Important: Read this section before starting installation.
- These instructions are assuming you are logged on to, and performing this installation from the actual target machine.
- Installation should be on the PC that is hosting the Odyssey databases.
-
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".
-
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.
- If you downloaded "SalesForceAuthServiceSetupxxx.msi", execute it to start the installation.
Installation Followup
-
There are no registry settings.
-
Configuration file settings. Config. file location is listed below. These settings should never need updating.
Value Name | Value Data | Description |
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.
|
- Go to Administrative Tools --> Services. Find "Comtrex SalesForce Auth Service" and start the service.
-
Wait a few seconds, then check the daily log file to see if any failures. Log file location is listed below.
- That completes the installation.
- Any time changes are made to "POS System Options -> Sales Force Definitions", be sure to restart service
so changes are read by service.
- If SalesForce is no longer needed at store, please set service to disabled, or uninstall service.
Installation Reference
-
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)
-
Version 1.0.0.1 2021-03-24
Version History (SalesForceAuthService.exe)
Version | Date | Description |
1.0.0.1 |
2021-03-24 |
Initial version. |
Downloads
Click here to Run or Download.