This article provides detailed instructions for debugging individual RightFax services across various supported versions. Debugging allows administrators to generate logs that capture in-depth diagnostic information, helping to identify root causes of fax transmission errors, integration failures, or module crashes.
General Debugging Steps:
Stop the target RightFax service in Enterprise Fax Manager (EFM) or Windows Services.
Run the service in debug mode using either command-line options or the “Debug”/“Debug with Options” menu in EFM.
Reproduce the issue or wait for it to occur.
Save any resulting logs and exit debug mode using CTRL+C.
Restart the service normally.
Submit logs to OpenText Support along with relevant metadata (timestamps, usernames, fax numbers, etc.).
IMPORTANT: While running in debug, services show as "Stopped" in EFM—they are running as user applications with slightly reduced performance.
| Service Name | Debugging Method |
|---|---|
| Board Server Module | Command Line (BoardSrv.exe -D -1) |
| Conversion Engine | EFM Logging Tab → Verbose → Debug |
| Sync Module | Debug with Options (-SyncOnceASAP) |
| Database Module | Debug with Options or FaxDB.exe CLI |
| Server Module | Debug with Options or FaxServ.exe CLI |
| DocTransport Module | Debug with Options or DocTransport.exe CLI |
| eTransport Module | Mimesend.exe CLI |
| Exchange Connector | RFExchConn.exe -D |
| Exchange Email Gateway | ExchGateway.exe -d -1 |
| Integration Module | Run bufdir, buffer, parse sequentially |
| Lotus Notes Email Gateway | NotesGateway.exe -d -1 |
| Paging Server Module | Pagesrv.exe -d -1 |
| Queue Handler | Porthand.exe -d -1 |
| Remoting Service | EFM → Verbose Logging → Debug |
| RPC Server Module | FaxRPC.exe -d -1 |
| SAP Gateway | SAPGate.exe -d -1 |
| SMTP/POP3 Gateway | SMTPGateway.exe -d -1 |
| Worker Host | EFM → Debug |
| WorkServer Module | Worksrv.exe -d -1 -sWorkSrvN |
| Parameter | Description |
|---|---|
-d | Show diagnostic output |
-d=6 | Show all diagnostics |
-1 | Run in console |
-o | Output to log file |
-p | Enable profiling |
-e | Log to Windows Event Viewer |
-t | Show thread/process IDs |
-wait | Wait on stop |
-mA, -mO | Start with aging/orphan cleanup |
-r | Suppress recovery on restart |
-sGATEWAYn | Specify Email Gateway number (n) |
-sWorkSrvn | Specify WorkServer number (n) |
-SyncOnceASAP | Run sync job immediately |
Provide the following (as applicable):
Log file path and name (e.g., C:\FaxDB.log, bufdir.txt)
Time and date of issue occurrence
Fax number(s) involved
Affected user or group
Transmission history or error message details
Any supporting config files (e.g., BTCall.cfg, SAPRFC.ini, Notes.ini)
Refer to KB07222474 for collecting data related to Brooktrout issues.