Handle server setup

Generating config & running

Handle server runs within backend container (dspace). During installation, the config must be manually created by calling /dspace/bin/make-handle-config, see https://github.com/dataquest-dev/dspace-angular/blob/dtq-dev/.github/workflows/deploy.yml#L93-L101 for all the steps necessary. docker-compose-rest.yml is prepared, so that the handle folder is in volume and entrypoint is set, so that on restart, handle server starts.

It seems that in some cases, IPs in /dspace/handle/config.dct must be replace by IP from sudo docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' dspace0 (executed on host, not in container, obviously).

Exposing with Nginx

Ports according to official documentation https://www.handle.net/hnr_support.html (paragraph 5).

Add to /etc/nginx/nginx.conf:

stream {
    server {
    # for handle server
        listen 2641;
        proxy_pass localhost:2640;
    }
}

to /etc/nginx/nginx.conf:

Add to some site in /etc/nginx/sites-enabled.

# handle server HTTP
server {
    listen 8000;
    location / {
        proxy_pass http://localhost:8008;
    }
}