Endpoints or Results Fail to be Displayed in the Console
Common causes and likely solutions to the failure of endpoints or scan results failing to display in the Spirion console.
Endpoints or Results Fail to be Displayed in the Console
After deploying the enterprise console and one or more clients on Windows or Mac systems, properly configuring those clients to communicate with the console, and completing a search (including exiting the client), the endpoint itself or the results of the search may not be displayed in the console.
- In most cases, this is due to missing or incorrect settings on the client system and viewing the log on the client will reveal the error with sufficient detail to correct the problem.
- Additional issues and resolutions are detailed below.
Common Causes
The following is a list of common causes of endpoints or results failing to display in the Spirion console:
- The Windows client system did not have the registry settings required to connect to the console prior to the installation of the client software.
- The Windows client software was not installed properly and the Identity Finder Endpoint Service is not present on the Windows system.
- The Windows or Mac client software license does not include communication with the console.
- The settings specified on the client system to communicate with the console are entered incorrectly - mistyped - (all settings names are case sensitive) or have incorrect values.
- The IIS server hosting the console is not configured properly.
- There is not adequate network connectivity between the client system and the console server.
Steps for Resolution
Use the following steps to resolve this issue:
- Apply the appropriate client settings file from the console by performing the following steps:
- Use a web browser on the client system to navigate to the following location:
- http://consoleserver/Services
where consoleserver is the name or IP address of the enterprise console. - Download the settings file by clicking the appropriate link and saving the file to the client system.
- For Windows systems, ensure that the 32-bit or 64-bit settings are properly selected.
- Apply the settings by importing them into the Windows Registry or copying them to the directory /Library/Preferences on the Mac.
- On Windows, restart the Identity Finder Endpoint Service by accessing Services via Control Panel/Computer Management or by rebooting the system.
- Ensure the Windows client software was installed with the /endpoint switch by accessing Services via Control Panel/Computer Management and locating the service, "Identity Finder Endpoint Service."
- If the service is not present, then the software was not installed properly and will be unable to communicate with the console.
- Once the client has been installed, the endpoint service can only be added by launching the installer via the command line with the /endpoint switch, selecting Change, ensuring that the feature, "Endpoint Service" is set as, "Will be installed on the local hard drive." and then complete the installation.
- If an interactive installation is not possible or desirable, it will be necessary to uninstall the client and then deploy/install it again with the /endpoint switch.
- This functionality can also be added to a custom MSI installer.
- Restart the Identity Finder Endpoint Service service on Windows client systems by accessing Services via the Control Panel/Computer Management or by rebooting the system. This is necessary after any additions or changes to the registry settings for the endpoint service.
- Verify the IIS configuration on the console by using a web browser on the client system to navigate to the following URL:
- http://consoleserver/Services/ManagementService.svc
where consoleserver is the name or IP address of the enterprise console. - If the name doesn't work, use the IP address directly and then update the client settings accordingly.
- http://consoleserver/Services/ManagementService.svc
- When successful, the page displays a notification that a service has been created.
- If the page is not displayed or the service is not created, then the IIS configuration is incorrect or there is a network access problem.
- The IIS server's hostname bindings are required to be appropriately configured such that the hostname associated with the web site selected during the console installation responds to external requests from the user's web browsers.
- Contact an IIS server administrator or network administrator in your organization to determine the cause of the issue.
- Launch the client software and then view the application log.
- Any errors encountered while attempting to connect to the console will be listed.
- For Windows:
- Select the Configuration tab
- Click the down-arrow under the Logging button
- Select "View Current Log"
- For Mac, navigate to the following folder:
- /Users/USERNAME/Library/Application Support/Identity Finder/Identity Finder Mac Edition/logs
where USERNAME is the name of the currently logged on user - View the most recently created log file
- /Users/USERNAME/Library/Application Support/Identity Finder/Identity Finder Mac Edition/logs