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
- From the WEB-INF/classes/ subdirectory of your Java/JSP Web application, copy all files to a backup location.
- On the SDL Web installation media, access Content Delivery\roles\preview\
- Copy the standalone\ folder in this location, including its files and subfolders, to a location of your choice, and rename it to previewservice.
- 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.
- Restore your remaining backed-up configuration files to the config\ folder
- In the configuration location, open the following files for editing:
- cd_webservice_conf.xml
- cd_storage_conf.xml
- cd_ambient_conf.xml
- From cd_webservice_conf.xml, copy the section called
<OData>, with all of its contents, to your clipboard. - In cd_storage_conf.xml, place your cursor before the
<License>section and paste the copied code. - Save and close cd_storage_conf.xml.
- From cd_webservice_conf.xml, copy the sections called
<AuthenticationServer>and<Accounts>, with all of their contents, to your clipboard. - 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. - Save and close cd_ambient_conf.xml.
- Close cd_webservice_conf.xml. You can now delete this file.
- Proceed to install Preview Service as a standalone microservice.
- Installing the Preview Service as a microservice
Run the appropriate microservice installation PowerShell or Unix script to install and run the standalone microservice.