This article describes how to add the Smart ID Messaging component Hermod test app to an existing configuration.

Hermod test app is a test GUI that can be used for basic tests of Hermod, without the need for a connected access management system, such as Smart ID Digital Access component. 

Step-by-step instruction

Load docker image

The docker image can be loaded locally to each machine, or to the docker registry, and used remotely from several machines.

1. If you want to load the released docker image locally on the target host:

   Example: Load docker image

   > docker load -i hermod-testapp-2.x.y.RELEASE.tar

2. If you have a docker registry, load the image there.

Add hermod-testapp to existing docker compose configuration

To edit the docker compose configuration:

1. Edit the configuration file docker-compose.yml with the correct values for your environment. Below you can find examples, but the actual values must match the specific deployment scenarios.

   File path: example/compose/hermod/docker-compose.yml

   Example: docker-compose.yml

   version: '2' services: ... ... hermod-testapp: restart: unless-stopped image: ng-docker01.ad.nexusgroup.com:5000/nexus-personal/hermod-testapp:2.x.y.RELEASE ports: - "20488:20488" extra_hosts: - "<my-hermod-server>:94.140.49.248" environment: - TZ=Europe/Stockholm - JAVA_OPTS=-Xms128m -Xmx256m -XX:MaxMetaspaceSize=256m -XX:CompressedClassSpaceSize=64m -Xss256k -Xmn8m -XX:InitialCodeCacheSize=4m -XX:ReservedCodeCacheSize=64m -XX:MaxDirectMemorySize=64m mem_limit: 512m volumes: - ./config:/home/docker/config:z - ./certificates:/home/docker/certificates:z - ./cacerts:/cacerts:z - ./testdb:/tmp/db:z logging: options: max-size: 10m command: "--spring.cloud.config.failFast=false --application.hermod-testapp.hermod.url=https://<my-hermod-server>:20400/hermod/rest --application.hermod-testapp.hermod.api-key=aGVybW9kLXRlc3RhcHA6MjY5NzJkOGZhOTQxNGI4MWJmMzVjYzllNGI3YmY2NWU1MWZiYjEzNGFiMjY0MGFlYWJkM2U3N2U3ZjE0NDAwMg== --spring.datasource.url=jdbc:h2:file:/tmp/db/hermod-testapp-ad.sql --spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect"

2. The default value for context path and uri base is /hermod/rest/ (that is http://localhost:20400/hermod/rest/...). You might need to change this for hermod-testapp too, if your current Hermod configuration has been changed.

Start Hermod Testapp

1. Start Hermod test app with the following command:

   Example: Start hermod-testapp

   > docker-compose up -d hermod-testapp > docker-compose logs -f

2. Try to connect to the GUI from a browser:

   Example: Connect to GUI

Additional information