Copy CD hotfix resources

Copy the resources for installing the DXA microservice to the target machine.

Before you begin

This task assumes you have access to the following installation media:

  • DXA 2.0 for .NET or Java (For details, see Downloading DXA.)
  • SDL Web Content Delivery layout: CD_10.1.0.8270 (The DXA Model Service requires this specific CD hotfix version regardless of whether you are using SDL Web version 8 or 8.5. Request CD hotfixes through the SDL Support portal at https://gateway.sdl.com.)

If you have not already done so, you need to first extract the relevant portions of these packages before proceeding with the steps for copying resources.

Procedure

  1. Access your DXA installation media (in the location where it was downloaded).
  2. Go to the following folder: cis\dxa-model-service\
  3. Copy the standalone\ folder, with all its files and subfolders, to your target machine, and rename it to a unique name of your choosing.
    The new folder contain the following two subfolders:
    • config\
    • services\
  4. Access the installation media for the Content Delivery layout, and go to the following folder:
    CD_10.1.0.8270\release\template\standalone\
  5. Using the following table for reference, copy each of the folders or files from the Content Delivery location to the indicated target location for the Model Service, where MODEL_SERVICE is the folder where you installed the Model Service files in step 3:
    Content Delivery hotfix files and foldersModel Service target location
    bin\MODEL_SERVICE\
    lib\MODEL_SERVICE\
    services\discovery-client\discovery-registration-api-10.1.0-1017.jarMODEL_SERVICE\services\model-service\
    services\discovery-client\oauth-10.1.0-1011.jarMODEL_SERVICE\services\model-service\
    services\discovery-client\adf-engine-10.1.0-1011.jarMODEL_SERVICE\services\model-service\

  6. If you are going to install the Model Service as a Windows Service, you should edit the installation scripts to use meaningful names for the Model Service. From the MODEL_SERVICE\bin\ folder, open the installService.ps1 and uninstallService.ps1 files for editing.

    The following shows the original, default values from Content Delivery:

    $displayName="SDL Delivery Services"
    $description="SDL Delivery Platform Micro Services" 
    $defaultServiceName="SDLDeliveryServices"
    Change the values to something meaningful for the Model Service, such as in the following example:
    $displayName="DXA Model Service"
    $description="Content Delivery microservice for DXA" 
    $defaultServiceName="DXAModelService"

What to do next

Proceed with installing and configuring the Model Service.