Documentation Center

Replacing the Session Preview Web service Web application with a standalone Preview Service microservice

This is the recommended way to upgrade to the new Preview Service.

Procedure

  1. From the WEB-INF/classes/ subdirectory of your Java/JSP Web application, copy all files to a backup location.
  2. On the SDL Web installation media, access Content Delivery\roles\preview\
  3. Copy the standalone\ folder in this location, including its files and subfolders, to a location of your choice, and rename it to previewservice.
  4. Only if you modified your logback.xml file, merge the contents of your backed-up logback.xml file with the file by the same name in the config\ subfolder of the previewservice\ folder.
  5. Restore your remaining backed-up configuration files to the config\ folder
  6. In the configuration location, open the following files for editing:
    • cd_webservice_conf.xml
    • cd_storage_conf.xml
    • cd_ambient_conf.xml
  7. From cd_webservice_conf.xml, copy the section called <OData>, with all of its contents, to your clipboard.
  8. In cd_storage_conf.xml, place your cursor before the <License> section and paste the copied code.
  9. Save and close cd_storage_conf.xml.
  10. From cd_webservice_conf.xml, copy the sections called <AuthenticationServer> and <Accounts>, with all of their contents, to your clipboard.
  11. In cd_ambient_conf.xml, place your cursor inside the <Security> section, before the <Rules> subsection or, if there is no <Rules> subsection, just before the closing tag </Security>, and then paste the copied code.
  12. Save and close cd_ambient_conf.xml.
  13. Close cd_webservice_conf.xml. You can now delete this file.
  14. Proceed to install Preview Service as a standalone microservice.