Troubleshooting Documentation¶

Home → Documentation → Troubleshooting

This section contains troubleshooting guides for diagnosing and resolving issues with Cesivi Server across different deployment scenarios and use cases.

Troubleshooting Guides¶

General Issues¶

General Troubleshooting - Server startup, authentication, API connectivity, data storage, performance, and PnP PowerShell integration issues

Deployment-Specific¶

Docker Troubleshooting - Container build failures, startup issues, networking, volumes, and health checks
Migration Tool Troubleshooting - Data export/import issues, authentication errors, network timeouts, and permission problems

Common Issues by Category¶

Server Issues¶

Port conflicts and binding errors → General
.NET SDK not found → General
Permission denied on Linux → General

Authentication & Access¶

401 Unauthorized → General
403 Forbidden → General
NTLM authentication failures → General

API & Connectivity¶

REST API errors → General
SOAP service failures → General
CSOM property initialization errors → See Known Limitations

Docker Deployment¶

Image build failures → Docker
Container startup failures → Docker
Network connectivity → Docker
Volume persistence → Docker

Migration Tool¶

Access denied / 401 errors → Migration Tool
Request timeout → Migration Tool
Data export failures → Migration Tool

Quick Diagnosis¶

Before troubleshooting: 1. Check server health endpoint: GET http://localhost:5000/_vti_bin/diagnostics 2. Review server logs in MockData/Logs/Server/ 3. Verify .NET 10.0+ is installed: dotnet --version 4. Ensure ports are not in use: netstat -ano | findstr :5000

Common fixes: - Restart the server - Clear MockData and reinitialize - Check configuration in appsettings.json - Verify network connectivity - Review error messages in logs

Reference Documentation¶

For detailed technical information, see: - Error Codes - Standard SharePoint error codes - Error Catalog - Common errors and workarounds - Known Limitations - Architectural constraints - Operations - Monitoring and maintenance procedures

See Also: - Reference Documentation - Technical specifications and architecture - Project Documentation - Getting started and general guides