--- title: Troubleshooting Guide slug: iris-plus-cm-documentation/troubleshooting-guide docTags: createdAt: 2025-03-11T14:45:49.013Z --- If you're running into issues while using IRIS+ or the edge device, the troubleshooting is built to help identify the problem and provide a recommended action for a resolution. This guide offers customers a self-guided experience to swiftly action and solve their concerns without requiring support or assistance. Troubleshooting IRIS+ typically involves checking the following places To start, select the content that best describes your situation: :::ExpandableHeading ## I can't seem to add any new users to my account First, check that you have the appropriate permissions to add users. A user with the role Admin is the *only *user type that can add additional users to the account. This includes adding other admins, operators, and other user types. This is also specified in the Settings module of IRIS+. Additionally, tooltips are put in place to help provide further information about any account type limitations. ::Image[]{src="https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/f9nJiAmY6LoBG2QvpLmQA_image.png" size="70" width="634" height="295" position="center" caption="This view can only be accessible under Settings in IRIS+" showCaption="true"} If you are *not* an admin, it is recommended to ask another admin to promote your account type to Admin or request an admin user to add the new user to the account. ::: ::::ExpandableHeading ## My camera won't calibrate properly Issues found in camera calibration are typically caused by the auto-calibration improperly calibrating a person's expected height. To confirm if this is the case, access the calibration tab of a camera from the physical tree. Review the calibration height in the stream and determine if the height is correct. If it is *not *correct, try performing a manual calibration. To learn how calibration is best done, review the steps from [Manual calibration best practices](https://docs.irisity.com/iris-plus-cm-documentation/manual-calibration-best-practices). ::Image[]{src="https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/SsclCMxQRDLeDX9WhbQla_image.png" size="68" width="900" height="768" position="center" caption="Where a user can manually calibrate a camera" showCaption="true"} :::hint{type="info"} If you are using **Perimeter Security **in IRIS+™, calibration will no longer be needed. Please review the **Perimeter Security** documentation to learn how it works. ::: :::: ::::ExpandableHeading ## I am unable to see any images or videos in my Monitor Tab When disturbances are found between the connectivity of cameras and/or edge devices, issues can appear on the monitor tab, resulting in the loss of images or clips. This is typically caused by **network issues **between hardware. Check that the network connectivity of the edge device is normal. This information can be accessed by clicking on the edge device from the physical tree, which shows you the edge's dashboard. The typical ranges of bandwidth that are acceptable for normal operations are roughly per edge device, 750 Kpbs for upstream, and 950 Kpbs for downstream. ::Image[]{src="https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/lZDkVUmcQeruZFD4Vqy-S_image.png" size="70" width="1915" height="850" position="center" showCaption="false"} :::hint{type="info"} Please check your camera's recommended resolution and frame rate to determine the required connection bandwidth as well. ::: If this issue occurs between the edge device and the cloud, the images or clips will typically load at a later time. If images or clips do not load at all after the connectivity issues are fixed, try restarting the edge device and check to see if that fixes the issue. :::: :::ExpandableHeading ## My monitoring calendar or schedule doesn't work properly If IRIS+ is not generating any events from a calendar or schedule, there may be issues with the scheduling of the monitoring duration. Both the Calendar and Schedule tabs operate in a similar fashion, where both are dictated by the time the monitoring is "on". Below are settings to consider and check to see if they are the source of the issue: - Wrong time: Be sure to use the edge device's local time when setting up schedules or calendars. You may have configured the wrong time period if you're using a different local time. - For calendar events or schedules set for 24+ hours: When setting calendar events or schedules for a 24-hour monitoring period or more, be sure that the durations of the 24 hours are set between 12:00 AM - 11:59 PM. ::: ::::ExpandableHeading ## A missed detection occurred when a camera was active :::hint{type="warning"} If you experience a missed detection and require support assistance, please refrain from editing the rules, removing the edge device, or camera from the account for further investigation. ::: A missed detection can typically occur when a rule is not set up properly or the camera is not installed properly. If a missed detection has occurred, please review the steps below: 1. Check that the rule was set to active during the monitoring time. 2. Check that the person stayed in the alarm zone long enough within the dwell time. 3. Check the video stream settings: 1. The camera stream is active and is using the correct RTSP stream and credentials. 2. The camera stream is set to the recommended framerate with the recommended resolution. 4. Check the alarm zone overlay 1. Make sure that the alarm zone covers areas where the person walked. 2. Make sure that the alarm zone does not include non-visible areas. For example, a person can be missed during monitoring if the alarm zone is drawn on top of a large pillar that hides the area behind it. ::Image[]{src="https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/b0ijnpjIkxGIQeLWT0dYL_image.png" size="36" width="699" height="398" position="center" caption="An example of where a missed detection can occur if the alarm zone is drawn on top of large objects." showCaption="true" indent="3"} :::Paragraph{listStyleType="decimal" listStart="3" indent="2"} In the example shown here, the alarm zone never extends beyond the bushes because there is no visibility behind the bushes at this camera angle. ::: 5. Check the site's surroundings, ensure that there is decent lighting at the site, which means that it should be well-lit without too much brightness that may blind the camera. To learn more details on how to best prevent missed detections, we recommend reviewing the [Camera Placement Principles](https://docs.irisity.com/iris-plus-cm-documentation/camera-placement-principles) guidelines for rules and camera setup. :::: :::ExpandableHeading ## My rules do not seem to generate any events properly There are several places to check when no events are generated at all: - Your edge device should be able to handle around 10 active cameras at a time. If no events are generating at all, check these settings of the camera or device: - Ensure that the rules on the camera are properly set up. - Try setting the dwell time down to 1 second to see if any alarms generate at all. - Try offloading some of the cameras to another edge device. - Connectivity issues - There may be a loss of connectivity from the edge device if no events are being generated. Ensure that the network connectivity is stable on the edge device. ::: :::ExpandableHeading ## My integration does not seem to receive events Integration issues typically stem from an improper integration setup. To learn more, visit the [integration guide ](https://docs.irisity.com/iris-plus-cm-integrations)and find the instructions for the integration of your choice. ::: :::ExpandableHeading ## My edge device or camera is consistently red, orange, or yellow. What should I do? This means that there is a health alert that might be occurring at the hardware level. You can check what the problem is by going to the Health alerts tab from the physical view, then clicking on the tooltip of the reported error to get instructions on how to resolve the issue. ![](https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/VrCQ8jc1idnA9pPVpRtdk_image.png "The tooltip that shows up when you hover over the information icon under the Issue column.") If the recommendation does not resolve the issue, please contact [support@irisity.com](mailto\:support@irisity.com) to get further assistance and instructions. ::: :::ExpandableHeading ## My report does not generate correctly during scheduled times There are several situations where a scheduled report will not be generated correctly - No cameras were selected to generate reports from - No email target is set to receive reports - The report generation time was not set correctly To prevent these sorts of issues - Check that the correct cameras have been selected and saved - Check that the timestamps of the scheduled reporting time are correct time Occasionally, there may be issues where the scheduled report is interrupted, causing no reports to be generated. You can check if these reports are generated by checking the download list on the page ![](https://api.archbee.com/api/optimize/JzHznijrWxPLJLDUaV5A1/5cBAFV4tbsWibaasNKBje_image.png) :::