Documentation Center

Upgrading the Context Expression Extension Cartridge

Upgrade the Content Expression Extension Cartidge extension by updating in the (Session-enabled) Content Service.

Procedure

  1. On your target system, navigate to the library location of your Content Service or Session-enabled Content Service.
  2. If you are upgrading from SDL Web 8.5, remove the following files:
    • asm-3.2.jar
    • cd_datalayer_extension-8.5.0-1014.jar
    • cglib-2.2.jar
    • commons-beanutils-1.9.0.jar
    • commons-codec-1.10.jar
    • commons-collections-3.2.2.jar
    • commons-configuration-1.10.jar
    • commons-jexl-2.1.1.jar
    • commons-lang-2.6.jar
    • context-api-8.5.0-1013.jar
    • context-cartridge-8.5.0-1013.jar
    • context-common-8.5.0-1013.jar
    • context-engine-8.5.0-1013.jar
    • context-expression-api-8.5.0-1013.jar
    • cx_ambient-8.5.0-1013.jar
    • gson-2.7.jar
    • hibernate-jcache-5.2.3.Final.jar
    • hsqldb-2.3.4.jar
    • httpclient-4.5.2.jar
    • httpcore-4.4.5.jar
    • patricia-trie-0.6.jar
    • spring-context-support-4.3.3.RELEASE.jar
    • ua-parser-1.2.2.jar
  3. If you are upgrading from SDL Tridion Sites 9, remove the following files:
    • cglib-3.2.7.jar
    • commons-beanutils-1.9.3.jar
    • commons-codec-1.11.jar
    • commons-collections-3.2.2.jar
    • commons-configuration-1.10.jar
    • commons-jexl3-3.0.jar
    • commons-lang-2.6.jar
    • gson-2.8.5.jar
    • hibernate-jcache-5.2.16.Final.jar
    • httpclient-4.5.6.jar
    • httpcore-4.4.10.jar
    • patricia-trie-0.6.jar
    • spring-context-support-4.3.19.RELEASE.jar
    • ua-parser-1.2.2.jar
    • udp-context-api-11.0.0-1023.jar
    • udp-context-cartridge-11.0.0-1023.jar
    • udp-context-common-11.0.0-1023.jar
    • udp-context-engine-11.0.0-1023.jar
    • udp-context-expression-api-11.0.0-1023.jar
    • udp-cx-cartridge-11.0.0-1024.jar
    • udp-datalayer-extension-11.0.0-1024.jar
  4. In the services\ subfolder of the Content Service root location or of the Session-enabled Content Service root location, create a new folder with a name of your choosing, for example, CEE\.
  5. From the installation media, copy all files from Content Delivery\roles\context\extension-cartridge\lib\ to the new folder you created.
  6. Merge the contents of the installation media file Content Delivery\roles\context\extension-cartridge\config\cd_ambient_conf.xml with the file cd_ambient_conf.xml found in the config\ subdirectory of your (Session-enabled) Content Service root location.
  7. Copy over the following installation media files to the config\ subdirectory of your (Session-enabled) Content Service root location, overwriting the files by the same name in that location:
    • cwd_engine_cartridge_conf.xml
    • cwd_engine_conf.xml
    • cwd_engine_vocabulary_conf.xml
  8. From the installation media, also copy the file from Content Delivery\roles\expression\extension-cartridge\lib\ to the new folder you created.
  9. Merge the contents of the installation media file Content Delivery\roles\context\extension-cartridge\config\cd_ambient_conf.xml with the file cd_ambient_conf.xml found in the config\ subdirectory of your (Session-enabled) Content Service root location.
  10. Uninstall or stop the Content Service or Session-enabled Content Service. Depending on your setup, this involves running one of the following scripts:
    • If you have installed the microservice as a Windows service, run uninstallService.ps1.
    • If you run the microservice as a Windows process, run stop.ps1.
    • If you run the microservice as a Linux process, run stop.sh.
  11. Reinstall or restart the Content Service or Session-enabled Content Service by running installService.ps1 or start.ps1 (on a Windows machine) or start.sh (on a Linux machine).