Referencing External Synonyms


Prerequisites: InSite Search 2.11+ must be installed.

You can choose to move synonyms.xml outside its default location. If you choose this option, then you must reference the absolute path to synonyms.xml in Search.config. For example, you could manage Synonyms.xml as an asset in the CMS Assets manager. In this scenario, synonyms.xml would be published to the replication target on the DSS. An advantage of maintaining synonyms.xml in Assets is that the file is modified under a check-in/check-out action, which prevents multi-user access and tracks changes.

Version Notes: CMS 10.6
In CMS 10.6, users can modify synonyms directly from the CMS UI if synonyms.xml resides in the Settings folder of the DSS published content directory. See CMS 10.6 Search.config Synonyms for details.
To reference external synonyms:
  1. Save Synonyms.xml to your DSS server, outside of its default location (i.e., Config folder).
  2. Open the Search.config file at [Drive]:\[path to DSS root folder] in a text editor.
  3. Locate the <Search> element, then add the following attribute if it does not exist:
    • @synonymsLocation: The value of this attribute is the absolute path to the external Synonyms.xml file on your DSS server.
    For example, your <Search > element and attributes should look similar to the following code:
    <Search indexLocation="App_Data\LuceneIndex"
    synonymslocation="[Drive]:\[path to DSS root directory]\published\iss-config\Synonyms.xml"
    indexingEnabled="true" queryMaxClauses="1024">
  4. Save and close Search.config.
    Note
    When you publish the updated Synonyms.xml file, the @Last Modified date triggers a reload action on InSite Search, so there is no need to re-index content, explicitly.