Upgrading the combined Content Deployer
The combined Content Deployer is a single microservice that both receives and processes incoming content.
Procedure
- If the server on which this microservice is installed is a Windows machine, uninstall the Windows service by doing the following:
- On the server, open a Powershell command prompt.
- Access the bin\ subfolder of the microservice root folder.
- Run the script called uninstallService.ps1. (If you are running the service on a different default HTTP port than the default, add a
server.portparameter and set it to your custom port number.)
- On the server on which this microservice is installed, navigate to the configuration location of the microservice.
- Back up the contents of this folder to a safe location.
- Back up any custom microservice extensions you have created to a safe location.
- 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.
- On your SDL Tridion Sites 9.1 installation media, navigate to the folder Content Delivery\roles\.
- 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
- Navigate to the standalone\ subfolder.
- Copy the contents of the installation media folder, including subfolders, to your installed microservice location.
- 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.
- If you are upgrading from SDL Web 8.5, delete the backed-up configuration file smarttarget_conf.xml, if present.
- Restore the rest of your backed-up configuration files (but not the schemas\ subfolder) to the configuration location of the microservice.
- Restore any backed-up custom microservice extensions to your microservice.
- If the server on which this microservice is installed is a Windows machine, install the Windows service by doing the following:
- On the server, open a Powershell command prompt.
- Access the bin\ subfolder of the microservice root folder.
- Type installService.ps1 but do not press Enter yet.
- 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.
- 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 calledaddonserviceon this machine, and set it to the URL of the Add-on service. - If your Add-on service is secured, add a number of additional environment variables as needed.
- 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. - Press Enter to run the script.