Documentation Center

Upgrading the (Session-enabled) Content Service

The Content Service or Session-enabled Content Service provides interaction between the Web site and the Content Delivery microservices.

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 are upgrading the Session-enabled Content Service, navigate to the session\service\ subfolder.
    • If you are upgrading the regular Content Service, navigate to the content\ subfolder.
  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.