{"id":6315,"date":"2026-05-04T12:02:01","date_gmt":"2026-05-04T12:02:01","guid":{"rendered":"https:\/\/docs.connexite.co.uk\/index.php\/connexite-documentation\/connexgate-documentation\/connexgate-troubleshooting-and-maintenance\/"},"modified":"2026-05-04T12:02:01","modified_gmt":"2026-05-04T12:02:01","slug":"connexgate-troubleshooting-and-maintenance","status":"publish","type":"page","link":"https:\/\/docs.connexite.co.uk\/index.php\/connexite-documentation\/connexgate-documentation\/connexgate-troubleshooting-and-maintenance\/","title":{"rendered":"Troubleshooting and Maintenance"},"content":{"rendered":"<h2 class=\"connexite-doc-h2\">Common Error Messages<\/h2>\n<p>Log Rotation:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Automatic log rotation: 10MB per file, 3 backups<\/li>\n<li>Manual cleanup: Delete old log files if needed<\/li>\n<li>Location: \/opt\/connexGate\/backend\/logs\/<\/li>\n<\/ul>\n<p>License Validation:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Automatic validation on startup<\/li>\n<li>Periodic validation (hourly)<\/li>\n<li>Manual validation: Reload license page<\/li>\n<\/ul>\n<p>Configuration Backup:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Regular backup of configuration files<\/li>\n<li>Backup before major changes<\/li>\n<li>Document network configuration<\/li>\n<\/ul>\n<p>Certificate Renewal (if using SSL\/TLS):<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>SSL certificates: \/opt\/connexGate\/ssl\/cert.pem and key.pem<\/li>\n<li>MQTT certificates: \/etc\/connexgate\/mqtt\/<\/li>\n<li>Renew certificates before expiration<\/li>\n<li>Restart service after certificate update<\/li>\n<\/ul>\n<p>Service Management:<\/p>\n<p>bash sudo systemctl status connexgate<\/p>\n<p>sudo systemctl start connexgate<\/p>\n<p>sudo systemctl stop connexgate<\/p>\n<p>sudo systemctl restart connexgate<\/p>\n<p>sudo journalctl -u connexgate -f<\/p>\n<p>Network Interface Verification:<\/p>\n<p>bash ip addr show<\/p>\n<p>ip link show<\/p>\n<p>ping &lt;target-ip&gt;<\/p>\n<p>&quot;Proxy engine not available&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: Proxy model not enabled in license or engine not started<\/li>\n<li>Solution: Activate license with proxy model enabled, restart service<\/li>\n<\/ul>\n<p>&quot;NAT engine not available&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: NAT model not enabled in license or engine not started<\/li>\n<li>Solution: Activate license with NAT model enabled, restart service<\/li>\n<\/ul>\n<p>&quot;Maximum number of shadow servers reached&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: Device limit exceeded<\/li>\n<li>Solution: Delete unused devices or upgrade license<\/li>\n<\/ul>\n<p>&quot;Failed to connect to license server&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: License server unreachable or incorrect URL<\/li>\n<li>Solution: Verify license server URL, check network connectivity<\/li>\n<\/ul>\n<p>&quot;Device keys not found&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: Device keys not generated<\/li>\n<li>Solution: Generate device keys using generate_device_keys_by_serial.py<\/li>\n<\/ul>\n<p>&quot;Network interfaces validation failed&quot;:<\/p>\n<ul class=\"connexite-doc-nested-list\">\n<li>Cause: Network interfaces not configured or not up<\/li>\n<li>Solution: Verify interface configuration, ensure interfaces are up<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>OT\/ICS \u203a Security<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":6308,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-6315","page","type-page","status-publish","hentry","no-post-thumbnail"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/pages\/6315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/comments?post=6315"}],"version-history":[{"count":0,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/pages\/6315\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/pages\/6308"}],"wp:attachment":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/media?parent=6315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}