Summary

Details of Tachyon Server and Agent log files.

Tachyon Setup logs

Tachyon Setup creates a log file for itself and one for each of the installers in the same folder as itself:

  • BIInstall.log
  • CatalogInstall.log
  • SLAInstall.log
  • Tachyon.Setup.log
  • TachyonInstall.log


On this page:

Tachyon Server logs

The default location for all Tachyon logs is the folder %ALLUSERSPROFILE%\1E

SubsystemComponent

Tachyon Master

Tachyon Portal UI and applications (Tachyon)1E\Tachyon\
Tachyon.Portal.log

Consumer API

1E\Tachyon\
Tachyon.ConsumerAPI.log
Coordinator service1E\Tachyon\
Tachyon.Coordinator.log
Tachyon.Instrumentation.log
CatalogCatalog UI (CatalogWeb - Admin sync)1E\Catalog\Catalog.Integration.UI.log


Catalog API
Catalog Update Service1E\Catalog\Catalog.UpdateService.log
Catalog database1E\DatabaseUpgrade\1E.DatabaseUpgrade.Console.exe.log
SLASLA/Platform APIs (Admin, Core External)

1E\Tachyon\

Tachyon.AdminAPI.log
1E\SLA Platform\
WebExternal.log
SLA Platform UI (Platform)1E\SLA Platform\Web.log
Engine1E\SLA Platform\Engine.log
Integrate Services (Connector Manager)1E\SLA Platform\

1E.SLAPlatformIntegrateAgent.log

1E.SLAPlatformIntegrateManager.log

1E.SLAConnector.<type>_sync.log

Inventoryn/a
Operations Provider1E\Platform Consumer\customAction.log
SLA databases (Data, Integrate, Shared)n/a
BIMDX APISQL database[SLA-BI].[BI].[Event Log]
Tachyon ResponseCore (Core and Core Internal)1E\Tachyon\
Tachyon.CoreAPI.log
Background Channel (Background)1E\Tachyon\

Tachyon.BackgroundAPI.log

Switch(es) (also includes a single Switch Host service)1E\Tachyon\
Tachyon.Switch_A.log
Tachyon.Switch.Host.log

Please refer to Services and NTFS Security if changing the location of log files.

In this version of Tachyon Server, some installers do not support the LOGPATH property and the logs folder is not configurable during installation.

Each component has a configuration file in the Tachyon Server installation folder structure, which contains log configuration details. Defaults are:

  • Filepath %ALLUSERSPROFILE%\1E\<product>\ where product is Tachyon, SLA Platform, and Catalog
  • Filename as shown in the table above.
  • Maximum size 10MB (2MB for Switch logs).
  • 2 rollover files numbered 1 to 2 with the rollover number included as n.log (5 rollover files for Switch logs).
  • Date and timestamps are UTC to help troubleshooters synchronise logs on systems in different timezones.

Switch logs have the following names:

  • The first Switch installed will typically have a log filename Tachyon.Switch_A.log
  • Other Switches on the same server will have different letters appended. The letter is derived from the ID in the SwitchConfiguration table, where the letter is modulo 26 of the ID minus 1, for example ID=2 is A and ID=6 is E.
  • The log filename will be unique on a server, but there may be the same named log on a different server.
  • A Switch will continue to use the same log, unless the SwitchConfiguration table is modified so that a different ID is used.
  • If you see a Tachyon.Switch.log without a letter appended, this is a special case where a Switch cannot find its correct configuration, and has fallen back to using the template * row which has ID=1. In which case you will need to troubleshoot how that happened.
  • Rollover logs have numbers appended, for example Tachyon.Switch_A.1.log, up to a default maximum of 5.

Tachyon server components use the log4net RollingFileAppender class. Details can be found in http://logging.apache.org/log4net.


Summary of server log file locations

For any issue, please provide a zip containing log files from the following locations:

  • %ALLUSERSPROFILE%\1E\Catalog\*.log
  • %ALLUSERSPROFILE%\1E\Platform Consumers\*.log
  • %ALLUSERSPROFILE%\1E\SLA Platform\*.log
  • %ALLUSERSPROFILE%\1E\Tachyon\*.log

If you are having licensing issues, please include:

  • %ALLUSERSPROFILE%\1E\Licensing\*


Logging Levels

The table below describes the logging levels which are configurable for server components.

ValueDescription
Error

Only outputs errors. An error is a serious problem, typically requiring operator intervention of some sort to restore full functionality.

Warn

Outputs errors and warnings. A warning indicates a potential problem, where the system can nonetheless function without intervention.

Info

Outputs general information in addition to the errors and warnings. This is the default.

Debug

Outputs debugging information in addition to all the previous levels.

TraceOutputs the maximum information available. Used only in exceptional circumstances as it will generate huge amounts of logging output.
Logging levels should only be changed from info only if requested by 1E Support and reset to info after investigation is complete.

The method of configuring logging levels for the Tachyon Switch changed in v3.3 to using the above text values, but retains -log=0 as the default to mean the same as -log=info.


Tachyon Agent logs

The logpath can be set using an installation property and changed post-installation using a configuration property, as described in the Tachyon Agent installer and configuration properties (Logpath).

The following are default logpaths:

Windows:
%ALLUSERSPROFILE%\1E\Tachyon\Tachyon.Agent.log

Mac OSX:
/Library/Logs/Tachyon.Agent.log

Other non-Windows platforms:
/var/log/1E/Tachyon/Tachyon.Agent.log

By default, Windows resolves %ALLUSERSPROFILE% as follows.

For Windows 7 and later - C:\ProgramData\

Prior to Windows 7 - C:\Documents and Settings\All Users\Application Data\

The following are not configurable in this version:

  • Maximum size of 5MB
  • 5 rollover files numbered 1 (newest) to 5 (oldest) with the rollover number included as n.log


Configuration Manager Console Extensions log

%ALLUSERSPROFILE%\1E\Tachyon\Tachyon.CmConsole.log

%ALLUSERSPROFILE%\1E\Tachyon\Tachyon.RunInstructionUI.log


Tachyon Instruction Management Studio (TIMS) log

%ALLUSERSPROFILE%\1E\Tachyon\Tachyon.InstructionManagementStudio.log