Common Genetec Troubleshooting
8 min
before you troubleshoot confirm you're on the right versions known issues are typically found in an outdated plugin or gateway confirm all three of these first component minimum version to be on where to check iris+ genetec embedded plugin 2026 2 18 31 windows apps & features , or the plugin's about screen iris+ vms gateway 2026 4 7 vms gateway installer / service version genetec security center sdk 5 13 (5 13 2 0 b2114 23) genetec config tool → about if any component is older, download the current build from available downloads docid\ m2kgcn l71j33o0fw92mq , uninstall the old one, and reinstall before continuing do not troubleshoot on an old build 1\ verifying that iris+™ events are received in genetec use this when alarms are configured but you are not sure iris+ events are actually reaching security center how to check in the genetec config tool , open your event to action rule and run the automation test — this confirms the rule itself fires correctly open security desk and go to the monitoring task in the bottom left corner of the monitoring pane, enable the event/activity option (the monitoring toggle) send a test alarm — either a genetec test alarm, or a live alarm triggered from iris+ when the event is received, a bar appears in the monitoring pane confirming the event came from the sdk if the bar appears, iris+ events are being delivered into genetec and the problem is on the rule/alarm side, not the integration if nothing appears, continue to section 2 2\ embedded plugin is installed but does not appear or load in security center symptom the iris+ genetec embedded plugin has been installed, but it does not show up / does not load inside security center it often works fine on a machine where the genetec server and security center are on the same computer, but fails on split (server separate) setups cause two known causes the plugin definition xml that the installer places is not being picked up by genetec the iris+ integration settings (userurl, apikey, apitoken) are stored under the genetec area of the windows registry, and genetec can misread that entry as a broken plugin and refuse to load it how to check confirm the plugin is installed (windows apps & features ), then confirm it is not listed among the loaded plugins inside security center fix make sure you are on embedded plugin 2026 2 18 31 or newer (see the first ) as a temporary workaround, the plugin can be registered manually by adding the registry values genetec uses for development time registration this is a temporary measure only — per genetec's own guidance it is meant for development/testing, not production the permanent fix moves the integration settings out of the registry and into a settings file at c \programdata\irisity ab\genetec\settings newer plugin builds do this automatically during installation (existing registry settings are copied to the file) when to escalate if the plugin still won't load after upgrading and confirming settings, raise it with the support team 3\ embedded plugin installation fails during verification symptom the installer fails partway through — specifically at the step where the url, api key and token are verified the failure is intermittent; it may not reproduce on a clean dev/test machine cause a bug in older plugin builds combined with incorrect or unreachable connection settings how to check confirm the userurl is correct and reachable from the machine (open it in a browser on that machine) confirm the apikey and apitoken are valid and copied without stray spaces fix install embedded plugin 2026 2 18 31 , which contains the fix for the verification step failure, then re enter the url / api key / token carefully when to escalate if verification still fails on the current build with confirmed good settings and network access, escalate to support with the installer log 4\ iris+ is consuming more genetec licenses / certificates than expected symptom in genetec, the iris+ integration is using more certificates than it should correct usage is 1 certificate for the plugin ( 2 if the vms gateway is also running) affected builds showed 2 certificates used (3 with the gateway running) how to check in security desk, go to about → licenses → certificates (with the iris+ / alarm monitor tabs closed) and look at the iris+ certificates in use fix upgrade the embedded plugin to 2026 2 18 31 , which restores correct single certificate usage when to escalate if certificate usage is still too high after upgrading, escalate to support about the integration 5\ cannot add cameras in genetec 5 13 3 — no "video unit" button symptom in a genetec 5 13 3 environment you cannot add cameras, and the "video unit" button is missing entirely cause this is a genetec licensing issue, not an iris+ issue the genetec license is missing the required "number of cameras and analog monitors" feature, so genetec itself won't let you add video units how to check in the genetec config tool, review the license and confirm whether the number of cameras and analog monitors entitlement is present fix the customer needs the correct genetec license feature added by genetec there is nothing to change on the iris+ side when to escalate this sits with the customer's genetec licensing / genetec directly 6\ vms gateway keeps re sending the same events (event loop) symptom the vms gateway gets stuck in a loop and repeatedly resends the same events to genetec, flooding security center cause a defect in older gateway builds fix upgrade the iris+ vms gateway to 2026 4 7 or newer, which resolves the resend loop when to escalate if looping continues on the current gateway build, capture gateway logs and escalate to support 7\ large deployments — vms gateway camera capacity symptom instability or failures on very large sites (in the region of several thousand cameras) cause current vms gateway builds have a practical camera ceiling; very large counts (around 7,000 cameras) are not yet fully supported fix / status a gateway build with support for large scale ( 7,000 camera) deployments is in progress for now, confirm the site's camera count against the current supported capacity before committing, and stage large sites accordingly when to escalate for any planned deployment near this scale, involve support early rather than after install 8\ "search for similar" pop up does not appear in the genetec embedded tab symptom in the iris+ investigation view inside the genetec embedded tab, the "search for similar" pop up does not appear cause resolved defect in older portal versions fix ensure the iris+ portal is on 2026 3 (or 2026 r2) or newer, where this is fixed when to escalate if it still does not appear on 2026 3+, escalate to support 10\ when to escalate, and to whom before escalating, always confirm you have (a) the current versions from available downloads, and (b) the relevant logs contact support to inquire about any of the following topics below integration / plugin behaviour architecture / plugin loading / deeper system questions general customer support routing when you escalate, include genetec security center version, iris+ plugin and vms gateway versions, whether server and security center are on the same or separate machines, and the exact error/log lines