Log files and log collection
Before diving into specific issues, know where the logs live. Most Application Server issues can be diagnosed by examining the log files, and the first-line diagnostic step is often “check the logs.”EkranServer_LogsCollector tool can bundle all logs into an archive. Download it from the Syteca log collector download page and run it on the Application Server machine as an administrator.
SMBv1 error when installing or updating to 7.23 or higher
The following popup error appears during install or update to Syteca 7.23 (or higher) when using a shared folder for binary data:Cause
Syteca 7.23 dropped SMBv1 support. If the shared folder used for binary data still uses SMBv1 for connections, the installer refuses to proceed. This is a security hardening in Syteca, aligned with Microsoft’s own deprecation of SMBv1.Resolution
Remove the SMBv1 config key
C:\Program Files\Ekran System\Ekran System\Server\EkranServer.Settings.config in a text editor. Delete the line:Disable SMBv1 and enable SMBv2 on Windows Server
Restart the Application Server computer
Restart the installer
EkranServer service will not start with an SMB error
The EkranServer Windows service fails to start when the binary data location is an SMB file share. Error messages include:Cause
The SMB file share is configured to require SMBv1 for compatibility with legacy systems, but current Windows Server defaults disable SMBv1. The Application Server needs SMBv1 enabled explicitly through its config file.Resolution
Add the SMBv1 override to the Application Server config:-
Open
C:\Program Files\Ekran System\Ekran System\Server\EkranServer.Settings.configon the Application Server computer. -
Add the following key inside the config file:
- Restart the EkranServer service.
SMB.UseV1=1 workaround is intended for transitional periods, not permanent operation.Archiving fails due to SMB timeout
Archiving Client sessions to an SMB file storage location fails with this error:Cause
The default SMB response timeout of 5000 ms is not enough for the network path between the Application Server and the file share. Common cause: SMB share on a network with meaningful latency, or a file share that pauses briefly under load.Resolution
Increase the SMB response timeout by adding a config key. Higher values are more forgiving of network hiccups.-
Open
C:\Program Files\Ekran System\Ekran System\Server\EkranServer.Settings.config. -
Add the following key, with a value larger than the default 5000 (values are in milliseconds; try 10000 or 15000 as a first step):
- Restart the EkranServer service.
- Retry archiving. If the timeout still triggers, raise the value further; if it triggers even at 30000+, the underlying network or SMB share problem needs investigation.
Insufficient permissions when restarting the EkranServer service
When restarting the Syteca Application Server service, this message appears:Cause
The service management command is being invoked from a non-administrator context. The EkranServer service requires administrator permissions to restart.Resolution
Restart the EkranServer service under an administrator account. The simplest way: right-click the shortcut for whichever tool is being used (Services MMC, Task Manager, PowerShell) and select Run as administrator.Database connection lost
The Syteca Server tray application shows this message:Resolution
Verify network connectivity to the database
Check database service status
Check the port between Application Server and database
Send logs to Syteca support
ServerLogs subfolder from C:\Program Files\Ekran System\Ekran System to Syteca support for diagnosis.Cannot start the Application Server from the Syteca Server tray application
The Syteca Server tray application will not start the Application Server.Cause
The tray application is running in a non-administrator context. Starting the Application Server requires administrator permissions.Resolution
Close the tray application and relaunch it under an administrator account. Right-click the Syteca Server shortcut and select Run as administrator, then use the tray application to start the Application Server.Reinstalling a new version of the Application Server while preserving the old database
When reinstalling a new Application Server version, the intent is to preserve the existing database and pick up where the previous version left off, not to start fresh.Resolution
During reinstall, the installer prompts whether to use the existing database. Select the option to use the old database when prompted. The existing database remains in place with all historical data intact.Anti-virus software blocks uninstallation or update of the Application Server
Anti-virus scanning interferes with the Application Server uninstaller or update, causing the operation to fail or hang.Cause
The uninstaller performs operations (file removal, service deregistration) that some anti-virus engines flag as suspicious. False positives are common with Application Server uninstall operations.Resolution
Disable the anti-virus software temporarily during uninstall or update. Re-enable it once the operation completes and the new version is installed.”Server is unavailable” when opening the Management Tool
Opening the Management Tool in a browser returns:Resolution checklist
Run through the checks in order until the underlying cause is identified.Check the Application Server log
C:\Program Files\Ekran System\Ekran System\ServerLogs\server.txt. Recent error entries usually point directly at the cause.Confirm the EkranServer service is running
services.msc, verify the EkranServer service is in the Running state. If not, start it (under an administrator account).Verify database connectivity
Verify database has free space
Check the port from Application Server to database
Check binary storage folder permissions
MS SQL error: disallowed results from triggers
When installing, updating, or starting the Application Server against an MS SQL database, this error appears:Cause
The MS SQL Server configuration optiondisallow results from triggers is set to 1 (disallow). Syteca’s schema requires the ability to return result sets from triggers, so this MS SQL option must be 0 (allow) for the Application Server to start.