Documentation Center

Upgrading the SDL Web 8 Content Deployer microservice

The Content Deployer takes care of receiving incoming content, as well as processing it and deploying it. You can upgrade to a single microservice that combines these two, or you can have a separate endpoint microservice and worker microservice.

Procedure

  1. On the server on which this microservice is installed, do one of the following:
    • If your microservice runs as a standalone microservice, navigate to the configuration location of the microservice.
    • If your microservice runs as a deprecated Java/JSP Web application-based microservice, navigate to the WEB-INF/classes/ subdirectory of the Web application.
  2. Back up the contents of this folder to a safe location.
  3. Back up any custom microservice extensions you have created to a safe location.
  4. On your SDL Web 8.5 installation media, navigate to the folder Content Delivery\roles\.
  5. Do one of the following:
    • If you want to split the Content Deployer microservice into two microservices, navigate to deployer\deployer\ to transform your current microservice into a Content Deployer endpoint and install the worker later.
    • If you want to continue running the Content Deployer microservice as a single microservice, navigate to deployer\deployer-combined\
  6. Do one of the following:
    • If your microservice currently runs as a standalone microservice, or if you intend to migrate from a deprecated Java/JSP Web application-based microservice to a standalone microservice, navigate to the standalone\ subfolder.
    • If your microservice runs as a deprecated Java/JSP Web application-based microservice and you want to continue this setup, contact SDL Customer Support to obtain a WAR file for this microservice.
  7. Delete all files and subfolders from the microservice or Web application location.
  8. Do one of the following:
    • If your microservice runs as a standalone microservice, copy the contents of the installation media folder, including subfolders, to your installed microservice location.
    • If you intend to migrate from a deprecated Java/JSP Web application-based microservice to a standalone microservice, copy the contents of the installation media folder, including subfolders, to a location of your choice.
    • If your microservice runs as a deprecated Java/JSP Web application-based microservice and you want to continue this setup, unpack the WAR file you received into the current location of your Web application, then copy the contents of the config\ subfolder over the WEB-INF\classes\ folder of the Web application.
  9. Do one of the following:
    • If your microservice runs as a standalone microservice, , or if you intend to migrate from a deprecated Java/JSP Web application-based microservice to a standalone microservice, restore your backed-up configuration files to the configuration location of the microservice.
    • If your microservice runs as a deprecated Java/JSP Web application-based microservice and you want to continue this setup, restore your backed-up configuration files to the WEB-INF/classes/ subdirectory of the Web application.
  10. Restore any backed-up custom microservice extensions to your microservice.
  11. Restart your microservice.

What to do next

If you decided to split up the Content Deployer microservice into two microservices, you now only have one of the two microservices set up: the endpoint. To also set up the worker, install it from scratch as a standalone microservice.