Documentation Center

Configuring where the API (in-process) Server Role looks for Publication mappings

Mappings from Publications to URLs used to be configured in cd_link_conf.xml and cd_dynamic_conf.xml. The new Content Delivery architecture lets you store such mappings in Topology Manager, from which the Discovery Service can retrieve them. You can configure which of these places is used in your upgraded setup.

About this task

By default, SDL Tridion Sites determines where to find its mappings based on what is installed. You can override this default behavior. Here is how SDL Tridion Sites determines where to look:
(Session-enabled) Content Service not installed(Session-enabled) Content Service installed
Discovery Service installed

Scenario A: This is a typical upgrade scenario.

Default: Mappings taken from configuration files

To override: Copy ConfigRepository element from Content Service configuration to API (in-process) configuration.

Scenario B: This is a hybrid upgrade-migration scenario.

Default: Mappings taken from Topology Manager

To override: Set OverrideDiscoveryService in cd_link_conf.xml.

Discovery Service not installed

Scenario C: This is not a recommended setup.

Default: Mappings taken from configuration files

To override: Install the Discovery Service and the (Session-enabled) Content Service.

Scenario D: This is not a recommended setup.

Default: Mappings taken from configuration files

To override: Install the Discovery Service.

Procedure

  1. In scenario A, to get mappings from the Discovery Service, even though the (Session-enabled) Content Service is not installed, do the following:
    1. On the installation media, open Content Delivery\roles\content\standalone\config\cd_storage_conf.xml.
    2. In your API (in-process) Server Role's configuration location, open cd_storage_conf.xml for editing.
    3. Copy the ConfigRepository section from the installation media file to you server-side file.
    4. Save and close cd_storage_conf.xml.
    5. Restart your Web application.
  2. In scenario B, to get mappings from the configuration files, even though the (Session-enabled) Content Service and Discovery Service are installed, do the following:
    1. In your API (in-process) Server Role's configuration location, open cd_link_conf.xml for editing.
    2. Find the Publications element and give it an attribute called DiscoveryServiceOverride, giving it the value true.
    3. Save and close cd_link_conf.xml.
    4. Restart your Web application.