Content Comparison

ARES Kudo can be run inside docker containers. Dedicated Dockerfile for Ubuntu 1820.04 is available.

Instructions:

Extract

1. Edit Dockerfile and set your Graebert customer account username (LICENSING_ACCOUNT) and password (LICENSING_PASSWORD)
   here:

   Code Block
   ENV LICENSING_ACCOUNT REPLACEME ENV LICENSING_PASSWORD REPLACEME

2. Run "docker build -t kudo:latest ."

3. Run "docker run -p 8082:80 -e "NGINX_X_FORWARDED_HOST=localhost:8082" kudo:latest"
   

4. Connect to running container e.g. "docker exec -it *cointainer* /bin/bash"

5. Download license inside the container by running the licensing tool passing username and password. That will get all server licenses and acquire the first one from the list.
   Run "/opt/graebert-gmbh/KudoLicensingToolCLI/KudoLicensingToolCLI --user <username> --pass <password>"
   License should be located at /var/opt/graebert-gmbh/xenon/licence/Xenon/

6. NGINX_X_FORWARDED_HOST specifies the “X-Forwarded-Host” header set in nginx config. It is required to have editor’s websocket working that follows the same-origin policy. “X-Forwarded-Host” needs to be passed to identify the original host requested by the client. The default of NGINX_X_FORWARDED_HOST is localhost.

7. Test the application with a publicly accessible URL:  http://localhost:8082/editor?fileUrl=https://xenon-instance-setup.s3.amazonaws.com/001General.dwg

System requirements

Your docker container needs at least 3GB memory to be able to open a drawing.

For Docker Desktop, it can be set under Setting → Resources → Advanced → memory

...

Checking server logs

Connect to running container e.g. "docker exec -it \*cointainer\* /bin/bash"

You can find logs at
/var/log/wt

access.log - API access logs
editor.log - Kudo server logs