Ingeniux DEX Quick Setup


Use the Quick Start Guide to walk through a generic DEX Search setup.

Like other DEX search components, you can build Ingeniux DEX Search without the needing customizations other than the ASP.NET search page view. Ingeniux DEX search components return results against the main DSS search index. Search.config, which acts as a central hub for all InSite Search indexes, defines the location of the DSS search index.

To configure an Ingeniux DEX search (quick-start steps):

  1. Install the latest 1) InSite Search and 2) DEX packages with the NuGet Package Manager. See Updating DEX Packages and Schemas for details.
    1. Open Dynamic_Site_Server_Instance.csproj in Visual Studio.
    2. In NuGet Package Manager, uninstall the current packages before installing the latest ones.
    3. Import the latest schema into Administrator > Schema Designer > Upload. (See the DEX NuGet ReadMe.txt for details.)
  2. Rebuild your DSS project to include the new packages in Visual Studio.
  3. Configure Search.config in [Drive]:\[path to DSS root folder].
    Additional Information
    1. Set the @indexingEnabled attribute value on the Search element to true.
    2. Create an <add> element as a child of <IndexingSources>, then set the @type attribute value to Ingeniux.Runtime.Search.DssContentSearchSource. Use the example <add> element included in the installed Search.config as an example.
    3. Set the @settingsFile attribute value on the add element to the absolute path of SearchSource.config.
  4. Optional: You can review and adjust SearchSource.config through the Ingeniux CMS UI. See SearchSource.config Overview for details.
  5. Create and configure Ingeniux DEX search component in the Site Tree. See Creating DEX Search Components for details.
  6. Generate the main search index files See Indexing for details.
    1. Recycle the DSS application pool in Internet Information Services (IIS).
    2. Delete any main index files in the App_Data\luceneindex folder.
      Note
      This folder structure is present only after the initial generation of the main search index files.
    3. Run a full publish, which includes the new Ingeniux DEX search component.
    4. In your browser, enter an address to your DSS website (e.g., http://website.com/dss/x4.xml).
      Note
      This step triggers the indexing of content and the generation of indexing files in App_Data\LuceneIndex. This process may take a few minutes to complete, so you may receive inaccurate search results in the intervening time.
  7. Test Ingeniux DEX Search. See Testing DEX Search Components for details.
    1. Verify that indexing files have populated the App_Data\LuceneIndex folder on your DSS server. In particular, check the Date modified values of the index files to ensure that they originated at the same time as your last publish.
    2. In your browser, enter the URL to the Ingeniux DEX search component on the DSS, including a search term.
    Sample URL:

    http://website.com/dss/x4.xml?terms=enterprise

    Additional Information
    The identifier is x4 for the Ingeniux DEX search component, terms is the default parameter name set in the Ingeniux DEX search component, and enterprise is the search term value.

    Results return as raw XML for this prototype. For a more complete search rendition, you would need to apply an ASP.NET search view to the page that includes Ingeniux DEX search component.

  8. Verify that your search term returns expected results. If you retained the default @Hiliter attribute values in Search.config, then the matched terms return within strong start and end tags within page excerpts.