Troubleshooting
Important
Many common troubleshooting scenarios arise from misconfigurations in permissions and the Windows defender whitelist. See Installation for more information.
Clear "Busy" System State
Open the collection history page for the system by clicking the
icon.Located the latest import. It should have a status of Busy.
Click the
icon to delete that import.Go back to the system overview screen. You may need to click the Refresh button to see the updated status.
Fix an Invalid Filter
Invalid filters are shown with a red underline and a "No" in their Valid column.
If a filter suddenly becomes invalid or shows an error where it was previously functioning properly, there are a several steps that will generally resolve the issue. We recommend to follow them in this order:
Check the filter
Check systems
Check relations
Check validation
Check the installed license
Note
There will be circumstances where you need to restart the NIM service or use the Reload all button in the Systems Overview during the troubleshooting process. If it seems that a correction isn’t reflected yet, try refreshing the web browser, then reloading the systems
Check the Filter
There are several filter configuration errors you may run into that would cause it to become invalid. Here is a list of the common ones you would likely see:
A relation that was used in the filter has been deleted, causing you to see blank selections. You will also see an error like this one in red when you press the filter button. To correct this error, simply recreate the relation being referenced in the error.
A column was being used in the Ordering & Selection tab that no longer exists. This means either the column was removed from the data or was a script column that has been deleted. You need to either use a different column, add the column back to the data, or recreate the script column.
Another table was added to the filter using the same name as an existing table. You need to rename one of the tables, preferably the newest one to avoid causing errors with existing columns that may have assignments elsewhere inside NIM.
The display name for a column was changed to the name of an existing column. Choose which column you want to have the display name you’re attempting to use. These have no effect on other processes in NIM. However, the display name is what you will see in an export.
Check Systems
If the filter configuration seems to be valid or system related, check your systems next. The specific causes for system-level errors are diverse, and cannot be covered in full here. Some common errors are:
The system, table, or column has been removed
The system has no data, or there was an error in the data refresh
A mismatch in data types between primary and foreign keys
For general troubleshooting, start with these steps:
Go to the Systems Overview page and click Reload all.
Once the data has been reloaded, check the Status column. If you see an error, click the
icon and review the error messages.Go to the specific table inside the system that the error is stemming from. You may see a variety of errors at the top of your screen when the table is beginning to load. These may include things like columns no longer being available in the data set, a CSV that has an inconsistent number of columns for each row or an empty row with no columns at the end, or a script column that has been configured incorrectly at the system level.
Check Relations
Filters may also fail if an intra- or inter-system relation has been removed for one reason or another.
If an intra-system relation has been deleted or is missing due to a column name change, check the table in question and recreate the missing relation.
If an inter-system relation has been deleted or is missing due to a column name change, go to the Relations screen. Search for the relation in question near the bottom of the screen. If it is not present, create it. If it is already present, then there may be an issue with the columns that form the relation. Delete the relation, save, and create the relation again.
Check Validation
If the above steps do not lead you to a resolution, check the Validation screen. Incorrectly configured items in NIM will be shown here. You can click on the item's description to jump directly to the item in question.
Check License
An invalid or expired license key may cause all filters in NIM to become invalid. Inspect your license to check its validity and contact us to resolve any errors.
Restart the NIM Service
Open the Windows services console.
Find and select NIM Service.
Click Restart.