Find App Host and Message Bus logs and versions
Find log files, raise the log level and check installed versions for the App Host, its modules and the Message Bus.
Applies to: Command Centre vEL9.40 and later (Message Bus) · vEL9.50 and later (App Host; compatible with vEL9.40 for out-of-band installation where required)
Use these steps to find App Host, module and Message Bus log files and versions. For what these services are, see App Host and Message Bus.
Log file locations
Message Bus
%ProgramData%\Gallagher\Message Bus\Command Centre\Logging\MessageBus.log
The embedded NATS runtime. Not sent as telemetry to the Diagnostics Service.
App Host
%ProgramData%\Gallagher\AppHost Service\service.log
The App Host's Serilog file sink. The App Host may also send telemetry (traces, metrics and structured log events) to the Diagnostics Service, which collects it with other diagnostic telemetry.
App Host modules
%ProgramData%\Gallagher\<Module Name>\<Log File Name>.log
Each module
The log files are the files with the extension *.log inside these folders.
Open the log folder
Right-click the CCFTServiceManager and select Diagnostic → Open Log Folder.

The Command Centre Service Manager tray menu with Diagnostic expanded and Open Log Folder highlighted. Go up one folder level, to
C:\ProgramData\Gallagher.
File Explorer at This PC > Local Disk (C:) > ProgramData > Gallagher, showing the folders AppHost Service, Cardholder Location Module, Command Centre, Message Bus and Minidump. Open the relevant folder and find the
*.logfile.
Change where the logs are written
App Host: change the "Serilog:WriteTo:Args:Path" setting in the App Host configuration file, then restart the Gallagher Command Centre AppHost Service. By default the configuration file is C:\Program Files\Gallagher\AppHost Service\Bin\appsettings.json.
Message Bus: the log file location and the JetStream data storage location are both set in the Message Bus configuration file, MessageBus.conf. It is typically in one of these locations:
C:\Program Files\Gallagher\Message Bus\Command Centre\MessageBus.confC:\Program Files (x86)\Gallagher\Command Centre\Message Bus\MessageBus.conf
Restart the Gallagher Command Centre Message Bus Windows service after changing them. The entries are near the bottom of the file:
store_dirdefines where JetStream persists Message Bus data. Replace<folder path>with the folder you want to use.logfiledefines where Message Bus log output is written. Replace<log file path>with the full path of the log file. By default it is%ProgramData%\Gallagher\Message Bus\Command Centre\Logging\MessageBus.log.
The Message Bus release note's example writes each backslash in a path as \\.
Raise the Message Bus log level
Open
MessageBus.conf(see the locations above).Add these values for
debugandtrace_verbose:Restart the Message Bus using the Service Manager for the change to take effect.
Check for the additional log messages in the Message Bus log file, by default
%ProgramData%\Gallagher\Message Bus\Command Centre\Logging\MessageBus.log.
Find the installed App Host version
Version detection will be added to the FTSupportTool in a future release. Until then, use the methods on this page for the App Host, the Message Bus and modules.
Locate the App Host assembly:
C:\Program Files\Gallagher\AppHost Service\Bin\Gallagher.Security.AppHost.dllRight-click the
.dllfile and select Properties.Open the Details tab.
Locate the Product version field.
The part of the Product version before the + is the installed App Host version. In this example it is 3.1.2.

Find the installed Message Bus version
Where you can, quote the Gallagher Command Centre Message Bus version. Read it with this PowerShell command:
The Message Bus log also records the version of the underlying NATS server when the Message Bus starts. Open the log, by default %ProgramData%\Gallagher\Message Bus\Command Centre\Logging\MessageBus.log, and look for the startup lines.

Find the installed module version
Modules may log their version at startup or provide another way to find the installed version. Unless the module says otherwise, use the same method as the App Host:
Locate the module's
ModuleManifest.jsonfile in its App Host module folder.Read the value of the
AssemblyNameproperty. It names the assembly (.dll) whose version is the module version.Right-click that
.dllfile and select Properties.Open the Details tab.
Locate the Product version field. The part before the
+is the installed module version.
For example, the Cardholder Location Module is located by default at C:\Program Files\Gallagher\AppHost Service\Modules\Cardholder Location Module. Its ModuleManifest.json is:
So the assembly file is C:\Program Files\Gallagher\AppHost Service\Modules\Cardholder Location Module\Gallagher.Security.AppHost.CardholderLocation.dll. In this example the module version is 2.0.8.

Last updated
Was this helpful?
