Install the Hermod test app

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.

Prerequisites

An existing installation of Hermod, see Install Hermod.

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.

If you want to load the released docker image locally on the target host:
Example: Load docker image
TEXT
```
> docker load -i hermod-testapp-2.x.y.RELEASE.tar
```
If you have a docker registry, load the image there.

Add hermod-testapp to existing docker compose configuration

To edit the docker compose configuration:

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

CODE

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"

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

Start Hermod test app with the following command:
Example: Start hermod-testapp
TEXT
```
> docker-compose up -d hermod-testapp
> docker-compose logs -f
```
Try to connect to the GUI from a browser:
Example: Connect to GUI
TEXT
```
https://<my-hermod-server>:20488/hermod-testapp
```

Additional information

Useful links