Troubleshooting Summary
Setup recap:
Create a Workspace β A trusted advisor often creates the workspace first. A workspace is the secure area where OneIQ IT Environment (ITE) data is shared and analyzed with others, with controls for visibility and privacy.
Create an IT Environment (ITE) β The IT professional who owns the environment sets up the ITE. This is where Pulse stores collected data, which can include multiple platforms such as VMware, Nutanix, Hyper-V, AWS, Azure, GCP, Kubernetes, Windows, and Linux.
Connect the ITE to the Workspace β The IT professional links the ITE to the pre-created workspace, allowing the collected data to be securely shared with the trusted advisor and made visible in the OneIQ Portal. (It's also possible to create the ITE first, then share it later via a workspace).
Deploy the Pulse connector β The IT professional downloads and installs OneIQ Pulse (a Windows executable) on a Windows Server 2016 or newer. Using the setup wizard, they connect Pulse to their platforms (e.g. vCenter, Prism Central). Pulse begins collecting configuration, performance, and network data, which is stored in the OneIQ ITE.
NB: It can take up to 30 minutes for data to appear in the OneIQ portal once collection has started.
1. Verify OneIQ Pulse Server Version
Confirm that OneIQ Pulse is deployed correctly on the specified Windows Server 2016 or newer.
2. Test Connectivity from Pulse Connector
Use the Test Connection feature within OneIQ Pulse to verify connectivity. If the test fails, review and update the settings as needed.
3. Firewall and Proxy Settings
Ensure that outbound traffic to the OneIQ Central data warehouse (hosted on Microsoft Azure) is allowed, particularly over HTTPS (port 443).
If using a proxy, configure OneIQ Pulse to route traffic through the correct proxy settings.
4. Review Credential Permissions
Verify that the credentials used for connecting to target systems have sufficient permissions. OneIQ Pulse requires read-only access for data collection and should not need admin privileges.
Check that credentials are up-to-date and correctly entered in the OneIQ Pulse configuration.
5. Update OneIQ Pulse
Make sure that you are using the latest version of OneIQ Pulse. Updates often include security patches and connectivity improvements.
Download the latest version from the OneIQ Portal and redeploy if necessary.
6. Check SSL/TLS Certificates
OneIQ Pulse requires valid SSL/TLS certificates for secure communication. If you encounter errors related to certificates, ensure that they are correctly installed and trusted.
Manually trust certificates if necessary, especially when connecting to private infrastructure.
7. Examine Logs for Errors
Access OneIQ Pulse logs for any error messages or warnings that might indicate connection issues.
Look for specific error codes or messages that can guide further troubleshooting or highlight specific connection failures.
8. Data Privacy and Encryption
Ensure that data being transmitted from OneIQ Pulse is encrypted as per OneIQ's standards (asymmetric encryption and HTTPS) to avoid issues related to data handling policies within your organization.
9. Reboot and Restart Services
Restart the OneIQ Pulse service to refresh the connection.
Reboot the server hosting OneIQ Pulse if persistent connection problems occur.
10. Contact Support
If the above steps do not resolve the issue, contact OneIQ support directly via the OneIQ Portal's support icon. Provide detailed information about your setup and any error messages encountered to expedite the resolution process.