Skip to main content

Troubleshooting Guides

important

Work in progress
This document and the contained guides should not be seen as completed, they will be updated in upcoming releases of this page. Feedback on how and on which topics to extend this guide can be given at any time. Please provide direct feedback over the page or contact your project manager.

This section contains comprehensive guides to diagnose and resolve known indexsearch issues. Each guide provides systematic approaches to identify symptoms, understand causes, verify problems, and implement solutions.

Available Guides​

The following troubleshooting guides are currently available to help you resolve specific indexsearch problems:

Setup Checklist​

A comprehensive verification checklist that covers all basic IndexSearch configuration requirements. This guide helps ensure that fundamental settings are correctly configured before investigating specific issues. Start with this guide when experiencing any indexsearch problems to verify that your system meets all basic requirements.

FullIndexer not working​

Addresses issues where the FullIndexer process fails to rebuild the complete index or only processes partial data. This guide covers scenarios where search results are missing, incomplete, or only reflect recent changes rather than the complete dataset. Essential for resolving index synchronization problems and ensuring comprehensive search coverage.

Incremental Indexer not working​

Focuses on problems with real-time index updates where new or modified records are not immediately available in search results. This guide helps diagnose and fix issues with automatic index maintenance that should occur when data changes in the system.

Broken Canary Index​

Specialized guide for resolving indexsearch issues that occur specifically in Canary deployment environments. Covers problems with index synchronization between production and Canary systems, collection compatibility issues, and version-specific conflicts that arise during system updates.

Convergent Collections​

Addresses complex scenarios where multiple ADITO system components incorrectly share or separate index collections. This guide helps resolve collection naming conflicts, background server integration problems, and ensures proper index isolation or sharing based on system architecture requirements.

Guide Structure​

Each troubleshooting guide follows a consistent structure designed for efficient problem resolution:

  • Symptoms: Clear descriptions of observable problems and their manifestations
  • Causes: Technical explanations of underlying issues that create the symptoms
  • How to verify: Step-by-step procedures to confirm the presence and extent of problems
  • Solutions: Detailed implementation instructions for resolving identified issues
  • Problem isn't solved?: References to related guides for addressing persistent or related problems

Using These Guides​

When experiencing indexsearch issues, begin with the Setup Checklist to verify basic configuration requirements. This foundational step eliminates common configuration errors that may cause symptoms similar to more complex problems.

After confirming basic setup requirements, select the guide that most closely matches your observed symptoms. Follow the verification steps to confirm the problem diagnosis before implementing suggested solutions.

For complex environments or persistent issues, multiple guides may be relevant. The cross-references at the end of each guide help identify related troubleshooting resources that may be necessary for complete problem resolution.