Upgrading the Contextual Image Delivery microservice

To upgrade the Contextual Image Delivery microservice, update its JAR files.

Procedure

  1. If the server on which this microservice is installed is a Windows machine, uninstall the Windows service by doing the following:
    1. On the server, open a Powershell command prompt.
    2. Access the bin\ subfolder of the microservice root folder.
    3. Run the script called uninstallService.ps1. (If you are running the service on a different default HTTP port than the default, add a server.port parameter and set it to your custom port number.)
  2. On the server on which this microservice is installed, navigate to the configuration location of the microservice.
  3. Back up the contents of this folder to a safe location.
  4. Back up any custom microservice extensions you have created to a safe location.
  5. Delete all files and subfolders from the microservice location.
  6. On your SDL Tridion Docs 14 installation media, navigate to the folder Content Delivery\roles\.
  7. Navigate to the cid\standalone\ subfolder.
  8. Copy the contents of the installation media folder, including subfolders, to your installed microservice location.
  9. 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.
  10. Restore the rest of your backed-up configuration files (but not the schemas\ subfolder) to the configuration location of the microservice.
  11. Restore any backed-up custom microservice extensions to your microservice.
  12. If the server on which this microservice is installed is a Windows machine, install the Windows service by doing the following:
    1. On the server, open a Powershell command prompt.
    2. Access the bin\ subfolder of the microservice root folder.
    3. Run the script called installService.ps1.
    On a non-Windows machine, simply run the start script in the bin/ subdirectory.