Troubleshooting connections

Structured knowledge base issues

The following table covers issues related to database connections in structured data knowledge bases.

Problem	Resolution
Connection refused	Check that the host and port are correct and reachable. Verify firewall rules allow inbound connections from the IdeaBoxAI platform.
Authentication failed	Confirm the username and password are correct. Use a read-only service account. For SSL issues, confirm whether the database requires SSL and toggle the SSL Mode setting accordingly.
Schema import hangs	The database may have too many tables. Filter to relevant schemas before connecting if possible. Contact the platform team if the issue persists.
Cube query returns no data	Check that the selected measures and dimensions are valid for the cube. Inspect the Generated SQL tab for errors and ensure the underlying tables are not empty.

Unstructured knowledge base issues

The following table covers issues related to document uploads and external source imports.

Problem	Resolution
File stuck in Processing	Remove the file and re-upload. Ensure the PDF is machine-readable (not a scanned image). For large files, split into smaller batches.
Confluence import fails	Regenerate the Atlassian API token. Confirm the user has read access to the selected spaces. Try importing a smaller space first.
Google Drive import fails	Re-authenticate with Google (OAuth token may have expired). Check that the user has access to the selected folders.

Review setup steps for database and document connections.

Structured knowledge base issues