Upgrading the search microservice or microservices

Depending on how you have set up the search feature (as one combined microservice or as two separate microservices), you need to upgrade the resources of one or two microservices.

About this task

The search feature can be set up in two ways:
  • As a single IQ Combined Index and Query Services microservice
  • As two separate microservices, the IQ Index microservice and the IQ Query microservice.

In the first case, perform the steps below once; in the second case, perform the steps below twice, once for each microservice.

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. On your SDL Tridion Docs 14 installation media, navigate to the folder Content Delivery\roles\.
  6. Navigate to one of the following subfolders, depending on the microservice you are upgrading:
    • If you are upgrading an IQ Combined Index and Query Services microservice, navigate to iq\iq-combined\standalone\
    • If you are upgrading an IQ Index microservice, navigate to iq\iq-index\standalone\
    • If you are upgrading an IQ Query microservice, navigate to iq\iq-query\standalone\
  7. Back up any custom files in the microservice location to a safe location.
  8. Delete all files and subfolders from the microservice location.
  9. Copy the contents of the installation media folder, including subfolders, to your installed microservice location.
  10. Restore 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.