Upgrading the Content Service

The Content Service provides interaction between the website and the Content Porter microservices.

Before you begin

If you are using SDL Digital Experience Accelerator (DXA) to build your website, you need to install support for the DXA data model, which is provided by the DXA Model Extension to the Content Service. When upgrading the Content Service, you must also upgrade the DXA Model Extension to the same version. Refer to the DXA documentation for installation instructions and list of compatible versions.

Procedure

  1. If the server on which this microservice is installed is a Windows machine, uninstall the Windows service by doing the following:
    1. On the server, open a Powershell command prompt.
    2. Access the bin\ subfolder of the microservice root folder.
    3. Run the script called uninstallService.ps1. (If you are running the service on a different default HTTP port than the default, add a server.port parameter and set it to your custom port number.)
  2. On the server on which this microservice is installed, navigate to the configuration location of the microservice.
  3. Back up the contents of this folder to a safe location.
  4. Back up any custom microservice extensions you have created to a safe location.
  5. On your SDL Tridion Docs 14 installation media, navigate to the folder Content Delivery\roles\.
  6. Navigate to the content\ subfolder.
  7. Navigate to the standalone\ subfolder.
  8. Delete all files and subfolders from the microservice location.
  9. Copy the contents of the installation media folder, including subfolders, to your installed microservice location.
  10. If you have previously made changes to the application.properties file that you backed up, compare your backed-up application.properties file to the new one you just copied, and reapply your customizations to the new file.
  11. If you have previously made changes to the cd_ambient_conf.xml file that you backed up, compare your backed-up cd_ambient_conf.xml file to the new one you just copied, and reapply your customizations to the new file.
  12. Restore the rest of your backed-up configuration files (but not the schemas\ subfolder) to the configuration location of the microservice.
  13. If you are upgrading from SDL Tridion Sites 9 and if one of your microservice extensions is the DXA model extension, follow the instructions in the SDL DXA 2.2 documentation to learn how to add the new DXA model extension to the microservice during installation. Do not restore the old DXA model extension in the next step.
  14. Restore any backed-up custom microservice extensions to your microservice.
  15. If the server on which this microservice is installed is a Windows machine, install the Windows service by doing the following:
    1. On the server, open a Powershell command prompt.
    2. Access the bin\ subfolder of the microservice root folder.
    3. Type installService.ps1 but do not press Enter yet.
  16. Alternatively, if this microservice is installed on a non-Windows machine, open a console, go to the bin/ subdirectory and type the name of the start script in the but do not press Enter yet.
  17. If you are using the Add-on service, add the string -Daddonserviceurl=URL, where URL is the URL of the Add-on service. Alternatively, you can define an environment variable called addonservice on this machine, and set it to the URL of the Add-on service.
  18. If your Add-on service is secured, add a number of additional environment variables as needed.
  19. If you are running your service on a different default HTTP port than the default, add server.port=PORT, where PORT is the custom port on which you run the service.
  20. Press Enter to run the script.