File Locations¶

This document describes where all GateKeeper Conveyor files are located on a production system. Use this as a reference when troubleshooting or verifying an installation.

Application Files¶

The main application is installed at:

C:\gatekeeper\conveyor\

Path	Description	Can Be Changed?
`C:\gatekeeper\conveyor\AbeTech.GateKeeper.Conveyor.WinForm.exe`	Main application executable	No (fixed install location)
`C:\gatekeeper\conveyor\AbeTech.GateKeeper.Core.dll`	Core business logic library	No
`C:\gatekeeper\conveyor\lib\`	Native SDK libraries (CoreScanner, RFID)	No
`C:\gatekeeper\conveyor\runtimes\`	Platform-specific .NET dependencies	No

Configuration Files¶

Path	Description	Can Be Changed?	Backup Priority
`C:\gatekeeper\conveyor\appsettings.json`	Main configuration file -- all hardware, validation, and application settings	Fixed filename, content is site-specific	CRITICAL -- always back up before updates

Site-Specific Config Files (in source repository only)¶

These files exist in the source code repository as templates. They are NOT deployed to production. The actual production config is always named appsettings.json on the deployed machine.

Config File	Site
`appsettings-cargill-hersey.json`	Cargill Hersey
`appsettings-cargill-stclair.json`	Cargill St. Clair
`appsettings-cargill-sidney.json`	Cargill Oil - Sidney
`appsettings-cargill-gainesville.json`	Cargill Oil - Gainesville
`appsettings-cargill-fullerton.json`	Cargill Oil - Fullerton
`appsettings-hormel-austin.json`	Hormel Austin
`appsettings-hormel-beloit.json`	Hormel Beloit
`appsettings-hormel-barron.json`	Hormel Barron
`appsettings-teasdale-carrollton-line7.json`	Teasdale Carrollton Line 7
`appsettings-teasdale-carrollton-line9.json`	Teasdale Carrollton Line 9
`appsettings-zebra-futureslab.json`	Zebra Futures Lab (placeholder)

Data Directory¶

The default data directory is:

C:\gatekeeper\conveyor\data\

This path is configurable via the DataDirectory setting in appsettings.json.

Data Directory Structure¶

C:\gatekeeper\conveyor\data\
  |
  +-- Setting\                          Database setting override files
  |     +-- Reject-Enabled.json         (example) overrides Reject.Enabled
  |     +-- RFID-TagExpirationSeconds.json
  |
  +-- ais\                              AIS export queue
  |     +-- todo\                       Pending exports (waiting to send)
  |     +-- processed\                  Successfully sent exports
  |     +-- failed\                     Exports that failed after max retries
  |
  +-- mojix\                            Mojix export queue
  |     +-- todo\                       Pending exports
  |     +-- processed\{date}\           Successfully sent (organized by date)
  |     +-- error\{date}\               Failed exports (organized by date)
  |
  +-- mwe\                              MWE export queue
  |     +-- todo\                       Pending exports
  |     +-- processed\{date}\           Successfully sent (organized by date)
  |
  +-- teasdale\                         Teasdale import data
  |     +-- processed\                  Processed import files (retained 60 days)
  |
  +-- teasdale_job_state.json           Teasdale pause/resume state file

Data Directory Details¶

Path	Purpose	Grows Over Time?	Safe to Delete?
`data\Setting\`	Stores validation settings that override appsettings.json	No (small files)	Yes -- forces reload from appsettings.json on restart
`data\ais\todo\`	Pending AIS export submissions	Yes, if exports are failing	No -- pending data will be lost
`data\ais\processed\`	Successfully sent AIS exports	Yes	Yes, after confirming exports arrived at destination
`data\mojix\todo\`	Pending Mojix export submissions	Yes, if exports are failing	No -- pending data will be lost
`data\mojix\processed\`	Successfully sent Mojix exports	Yes	Yes, older files can be cleaned up
`data\mojix\error\`	Failed Mojix exports (after max retries)	Yes, if there are persistent failures	Investigate before deleting
`data\mwe\todo\`	Pending MWE export submissions	Yes, if exports are failing	No -- pending data will be lost
`data\teasdale\processed\`	Processed import files	Yes (cleaned automatically after retention period)	Yes, old files only
`data\teasdale_job_state.json`	Current paused job state	No	Yes -- deletes any paused/resumed job state

Log Files¶

Path	Description	Grows Over Time?	Safe to Delete?
`C:\gatekeeper\conveyor\logs\`	Application log directory	Yes	Yes, old log files only
`C:\gatekeeper\conveyor\logs\gatekeeper-YYYYMMDD.log`	Daily log file	One file per day	Yes, after reviewing for troubleshooting

Log retention: By default, the last 14 days of logs are kept. Older logs are automatically deleted. This is configurable via retainedFileCountLimit in the Serilog section.

Log naming pattern: gatekeeper-20260206.log (date in the filename)

Config Audit Files¶

Path	Description	Grows Over Time?
`C:\gatekeeper\conveyor\config-audit\`	Configuration change tracking	Yes (slowly)
`C:\gatekeeper\conveyor\config-audit\config-changes.log`	Log of all appsettings.json changes	Yes

Image Files (Site-Specific)¶

Path	Description	Sites	Grows Over Time?
`C:\GateKeeper\Images\Insight\`	Insight camera captured images	Cargill Hersey	Yes
`C:\GateKeeper\Images\Validation\`	Validation result images	Sites with image storage enabled	Yes

BarTender Files (Teasdale Only)¶

Path	Description	Located On
Label template (.btw) file	BarTender label template	BarTender server (not GateKeeper PC)
`C:\gatekeeper\conveyor\data\bartender\`	Optional JSON dump of print requests	GateKeeper PC (if `EnableJsonDump` is true)

Note: The BarTender template file path in appsettings.json (DocumentFile) refers to a path on the BarTender print server, not on the GateKeeper PC.

Deacom Export Files (Teasdale Only)¶

Path	Description
`C:\GateKeeper\Conveyor\Data\DeacomExport\`	Per-pallet export JSON files sent back to Deacom

Import Paths (Site-Specific)¶

Site	Import Type	Default Path	Notes
Cargill Hersey	Network file (CSV)	`D:\DB`	Local drive on GateKeeper PC
Teasdale Line 7	JSON file polling	`\\tfcoloapp04\Deacom$\Model\RFID\Outbound`	UNC network path (requires auth)
Teasdale Line 9	JSON file polling	Verify in production	UNC network path

Desktop Shortcut¶

Item	Value
Target	`C:\gatekeeper\conveyor\AbeTech.GateKeeper.Conveyor.WinForm.exe`
Start in	`C:\gatekeeper\conveyor\`
Run as	Administrator (recommended)

Auto-Start Location (if configured)¶

C:\Users\<username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

A shortcut placed here will launch GateKeeper automatically when the user logs in.

Backup Checklist¶

When backing up a GateKeeper installation before an update:

What to Back Up	Priority	Command
`appsettings.json`	Critical	Copy to safe location
`data\` folder (if exports are pending)	High	Check `todo\` folders for pending exports
`logs\` folder (recent)	Medium	Copy last few days for troubleshooting reference
Application files (for rollback)	High	`robocopy C:\gatekeeper\conveyor C:\gatekeeper\conveyor-previous /E /XD data logs`