Upgrading the combined Content Deployer

The combined Content Deployer is a single microservice that both receives and processes incoming content.

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. Delete all files and subfolders from the microservice location or, if you are upgrading from SDL Web 8.5 and your microservice ran as a web application, from the web application location.
  6. On your SDL Tridion Sites 9.1 installation media, navigate to the folder Content Delivery\roles\.
  7. Depending on the type of Content Deployer upgrade you want to perform, navigate to one of the following:
    • The deployer\deployer-combined\ subfolder
    • The deployer\deployer-sites-combined\ subfolder
    • The deployer\deployer-dx-combined\ subfolder
  8. Navigate to the standalone\ subfolder.
  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 are upgrading from SDL Web 8.5, delete the backed-up configuration file smarttarget_conf.xml, if present.
  12. Restore the rest of your backed-up configuration files (but not the schemas\ subfolder) to the configuration location of the microservice.
  13. Restore any backed-up custom microservice extensions to your microservice.
  14. 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.
  15. 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.
  16. 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.
  17. If your Add-on service is secured, add a number of additional environment variables as needed.
  18. 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.
  19. Press Enter to run the script.