Troubleshooting Guide

Problem: Device Shows Offline

Possible Causes:

• No network connectivity
• Power loss or failure
• Firewall blocking communication
• DNS resolution failure

Solutions:

1. Check physical network cable connection
2. Verify power supply is connected and LED is on
3. Test network connectivity: ping [device-ip]
4. Check firewall rules allow ports 443 and 8883
5. Verify DNS can resolve *.lexoh.com domains
6. Reboot device (power cycle 30 seconds)
7. Factory reset if persistent (hold reset button 10 seconds)

Problem: Device Connects Then Disconnects

Possible Causes:

• Unstable network connection
• IP address conflict
• Firmware compatibility issue

Solutions:

1. Assign static IP address to avoid DHCP changes
2. Check for IP conflicts with other devices on network
3. Update device firmware to latest version
4. Increase DHCP lease time on router
5. Check for network loops or broadcast storms

Problem: Card Not Working

Solutions:

1. Verify card is registered in the system (Cards page)
2. Check card status is Active, not Inactive or Suspended
3. Confirm card has access to the specific zone/door
4. Check card schedule allows access at current time
5. Test with a different card to rule out reader issues
6. Clean the card and reader with isopropyl alcohol
7. Re-register the card if damaged or demagnetized

Problem: Door Won't Unlock

Solutions:

1. Check door lock has power (LED indicator)
2. Test manual unlock from Access Control page
3. Verify strike/maglock relay is working (listen for click)
4. Check wiring connections to lock mechanism
5. Adjust unlock duration (may need more time)
6. Verify access controller output is activated
7. Replace strike/maglock if mechanical failure

Problem: Door Stays Unlocked

Solutions:

1. Check if door is set to \"Always Unlocked\" mode
2. Review access events for repeated unlock commands
3. Verify relay is not stuck in closed position
4. Check for door sensor malfunction (door status unknown)
5. Disable and re-enable the access controller

Problem: No Video Feed

Solutions:

1. Verify camera has power and status LED is on
2. Check network cable connection (both ends)
3. Test camera access from web browser: http://[camera-ip]
4. Verify RTSP stream URL is correct
5. Check camera credentials (username/password)
6. Ensure camera firmware is up to date
7. Reboot camera (power cycle or via web interface)

Problem: Poor Video Quality

Solutions:

1. Clean camera lens with microfiber cloth
2. Adjust camera focus and zoom settings
3. Increase bitrate in camera stream settings
4. Change resolution to higher setting (720p → 1080p)
5. Verify adequate lighting in camera field of view
6. Check network bandwidth is sufficient for stream
7. Disable WDR/HDR if causing artifacts

Problem: Recording Not Working

Solutions:

1. Verify recording is enabled in camera configuration
2. Check storage location has available space
3. Verify recording schedule is configured correctly
4. Test recording trigger (motion detection, continuous)
5. Check NVR/storage server is online
6. Review camera logs for recording errors

Problem: Barrier Won't Open

Solutions:

1. Check barrier has power (LED indicator lit)
2. Test manual open button on barrier controller
3. Verify safety sensors are not obstructed
4. Check for obstacle detection preventing opening
5. Inspect barrier arm for physical obstruction or damage
6. Review barrier event logs for error codes
7. Reset barrier controller (power cycle)

Problem: Payment Not Processing

Solutions:

1. Verify payment terminal is online in dashboard
2. Check terminal has network connectivity
3. Test card reader with different payment cards
4. Verify payment processor configuration is correct
5. Check for payment gateway API key expiration
6. Review transaction logs for specific error codes

Problem: API Returns 401 Unauthorized

Solutions:

1. Verify API key is correct and not expired
2. Check API key is included in Authorization header
3. Ensure API key has required permissions
4. Regenerate API key if compromised
5. Verify API endpoint URL is correct

Problem: API Returns 429 Rate Limit

Solutions:

1. Reduce API call frequency
2. Implement exponential backoff in retry logic
3. Cache API responses when possible
4. Batch multiple requests into single calls
5. Contact support to increase rate limit

Problem: Webhooks Not Received

Solutions:

1. Verify webhook URL is publicly accessible
2. Check firewall allows incoming connections
3. Ensure webhook endpoint returns 200 status
4. Review webhook configuration in LEXOH dashboard
5. Check webhook logs for delivery failures
6. Test endpoint with webhook testing tool

Problem: Slow Dashboard Loading

Solutions:

• Clear browser cache and cookies
• Reduce date range filter to show less data
• Disable unused dashboard widgets
• Use modern browser (Chrome, Firefox, Edge)
• Check internet connection speed

Problem: High Bandwidth Usage

Solutions:

• Reduce camera stream bitrate and resolution
• Limit number of simultaneous video streams
• Enable H.265 compression on cameras
• Use local recording instead of cloud
• Schedule large data transfers during off-hours

Warning:  Undefined array key "diagnostic_network_test_connectivity" in /var/www/html/views/documentation/troubleshooting.php on line 283

ping [device-ip]



Warning:  Undefined array key "diagnostic_network_trace_route" in /var/www/html/views/documentation/troubleshooting.php on line 286

tracert [device-ip]



Warning:  Undefined array key "diagnostic_network_check_ports" in /var/www/html/views/documentation/troubleshooting.php on line 289

telnet [device-ip] 443



Warning:  Undefined array key "diagnostic_network_test_dns" in /var/www/html/views/documentation/troubleshooting.php on line 292

nslookup api.lexoh.com