Document toolboxDocument toolbox

Nexus Documentation
CURL vulnerability information (CVE-2023-38545) - Nexus awareness advisory on Microsoft's update KB5014754

Upgrade Hermod from 2.x to 3.x

Owned by Karolin Hemmingsson (Unlicensed)
Last updated: Nov 14, 2023 by Ylva AnderssonVersion comment
1 min read



Important

Hermod 3.x is based on Spring Boot 2.x, which means that many configuration properties have been renamed or changed. The deployment and configuration are NOT backward compatible with previous versions. The functionality and API of Hermod have however not been changed and are fully backward compatible.

Manual update of the Hermod configuration file IS REQUIRED. Even though many updates are handled inside Hermod 3.x, you might need to change various parts of your configuration, depending on your setup. For general information, see https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide. 

Prerequisites

The following prerequisites apply: 

  • Hermod is upgraded from 2.x to 3.x. For more information, see Upgrade Hermod.

Step-by-step instruction

  1. Open the Hermod configuration file for editing.
    Default file path: example/compose/hermod/config/cod-hermod.yml.

  2. Update any needed settings according to the following guide: https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide. 
    For example: 

    1. Update servlet specific settings, for example the context path: 
      Change from...: 

      Example: Change from...

      server: contextPath: /

      ...to: 

      Example: Change to...

      server: servlet: context-path: /



    2. If you have configured some settings as start-arguments in docker-compose.yml, make sure to update these, if required. 

    3. If any new spring properties are added, define them in kebab-case.
      Spring 2.x has changed to kebab-case format for all properties. It is however stated that any camelCase properties are backward compatible, but any new properties you configure should be kebab-case to adapt for the future. 

  3. Save the configuration file and restart Hermod. 

  4. Test your new configuration on a non-production server, to make sure it works as expected. 

Contact Nexus

If you need help or have any questions regarding your configuration files, feel free to contact Nexus. 

Copyright 2024 Technology Nexus Secured Business Solutions AB. All rights reserved.
Contact Nexus | https://www.nexusgroup.com | Disclaimer | Terms & Conditions