{"id":6394,"date":"2026-05-04T12:10:38","date_gmt":"2026-05-04T12:10:38","guid":{"rendered":"http:\/\/docs.connexite.co.uk\/index.php\/docs\/connexite-documentation\/connexgate-documentation\/connexgate-troubleshooting-and-maintenance\/"},"modified":"2026-05-04T12:19:11","modified_gmt":"2026-05-04T12:19:11","slug":"connexgate-troubleshooting-and-maintenance","status":"publish","type":"docs","link":"https:\/\/docs.connexite.co.uk\/index.php\/docs\/ot-security\/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":1,"featured_media":0,"parent":6387,"menu_order":7,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[118,115,120],"class_list":["post-6394","docs","type-docs","status-publish","hentry","doc_tag-connexgate-documentation","doc_tag-connexite","doc_tag-ot-security","no-post-thumbnail"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6394","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/comments?post=6394"}],"version-history":[{"count":1,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6394\/revisions"}],"predecessor-version":[{"id":6442,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6394\/revisions\/6442"}],"up":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6387"}],"wp:attachment":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/media?parent=6394"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/doc_tag?post=6394"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}