Mindbreeze logfiles
Summary
This article provides a general overview of various logfiles created by Mindbreeze and a simple guide to gather those. Additionally logfiles created in combination with Fabasoft Folio as well as the correlation of different component objects created by Mindbreeze in Fabasoft Folio are described.
Gathering Mindbreeze Logs
When submitting Mindbreeze Logs it is always best to include as much information as possible, thus supplying the entire Mindbreeze log directory.
In case the delivery of the complete log directory is not possible (e.g. due to it's size) we can further differentiate issues and the related logfiles.
Please keep in mind that the Mindbreeze service log directories for specific services (index, client, filter, ...) are further devided into subdirectories, each representing the timespan between service restarts.
In most cases supplying e.g. the latest three subdirectories (information up to three service restarts in the past) for a specific service is sufficient.
Single Logfiles to include in any case:
- log-mesnode.txt
- log-mesmaster.txt
- log-messdkcsandbox--Index_[Ports]
Log directories to include when facing different issues:
No search result / Authentication issues when using the Mindbreeze Web Client:
- Index (Query) Service Log
- Client Service Log
No search result when searching in Fabasoft Folio:
- Index (Query) Service Log
Insufficient search results / Objects cannot be indexed or filtered
- Index (Query) Service Log
- Filter Service Log
Any Mindbreeze configuration related issues
- Mindbreeze Server configuration - mesconfig.xml
Mindbreeze log files and log directories
The directory Mindbreeze logfiles are created in may be changed in the "Advanced Settings" in the Mindbreeze server configuration. The default directories for Windows and Linux are:
Windows: C:\Users\<mindbreeze service user>\AppData\Local\Temp Linux: /var/opt/mindbreeze/log
In the Mindbreeze log directory the following directories and single logfiles are located:
| File | Description |
|---|---|
| log-mesnode.txt | information about the Mindbreeze node process and the state of various subprocesses |
| log-mesmaster.txt | information about the Mindbreeze master process itself |
| log-messdkcsandbox--Index_[Ports] | information about the communication between Mindbreeze and the Fabasoft Kernel |
| log-messdknetsandbox2.txt | information about .net based filter plugins |
Note: Fileextensions of log files (.log, .txt) may vary based on the operating system and the Mindbreeze version in use.
| Subdirectory | Description |
|---|---|
| Client Service Log | log-mesclientservice-<client-port> |
| Index (Query) Service Log | log-mesindex-<index-path> |
| Filter Service Log | log-mesfilterservice-<port> |
| Crawler Service Log | log-mescrawler-launchedservice-<Category>_<Source Name> |
| Log directories for specific C based filter plugins | log-messdkcsandbox2-Default-Filter@[ort]-[PluginName] ... |
| Log directories for specific Java based filter plugins | log-messdkjavasandbox2-Filter@[Port] ... |
Mindbreeze server configuration file
The Mindbreeze server configuration is saved in the mesconfig.xml file. By default the containing directory is located at:
Windows: C:\Users\<mindbreeze service user>\AppData\Roaming\Mindbreeze\Enterprise Search\Server Linux: /var/opt/mindbreeze
Fabasoft Folio logfiles during Mindbreeze Index Update
%userprofile% represents the user profile of the Fabasoft Folio Service user. For scheduled updates, this is usually the AT Service user.
| Directory | Description | Default location |
|---|---|---|
| error.log | Created when the Indexing Service Object cannot create or update the index and the log location is not set manually | %userprofile%\AppData\Local\Temp\Fabasoft |
| BuildIndex.log RecoverIndex.log |
Contains information about the indexing process Contains information about the recovering index process |
Only created when log location set manually |
Log location may be set in the Mindbreeze Indexing Service object in Fabasoft Folio in the property "Directory for Log Files".
Objects containing Mindbreeze configuration in Fabasoft Folio
| Object | Description | Location in Fabasoft Folio |
|---|---|---|
| Mindbreeze Indexing Service | Contains the indexing service configuration | Domain Administration - Domain Objects - Services |
| Mindbreeze Filter Service | Contains the filter service configuration | Domain Administration - Domain Objects - Services |
| Mindbreeze Configuration Object | Contains the configuration of which files and properties are indexed | Domain Administration - Domain Objects - Current Domain - Components Configuration - Mindbreeze * |
| Administration Configuration Object | The tab "Search" contains several properties to optimize performance of the ACL Check | Domain Administration - Domain Objects - Current Domain - Components Configuration - Administration * |
* If the property is empty move to the parent configuration located in the "Domain Type" property.