Installation and Setup V3 (2021 versions)

prerequisites

• docker
• docker-compose
• minikube (optional)

release files

Depending on our internal ci/cd process one of the two following cases exists

• (A) delivery-V3.zip
  • unzip it to a directory
• (B) delivery-V3.tar.gz
  • unpack the directory delivery-V3.tar.gz/delivery-V3.tar/delivery-V3

In both cases the unpacked directory is called V3 in the following.

docker

• go to directory V3/docker-build-dir-jetty

• adapt the url used by the angular navigator frontend (ang-navi) to access the backend in file cts2le-navi.env (property <CTS2LE_SERVER>).
  !!! <CTS2LE_SERVER> is exactly the url of the container/service cts2le (see compose file), externally reachable

• run sudo docker-compose -f docker-compose.yml up -d --build (stretch version)
  (use docker-compose-net-host.yml in environments where no docker net is allowed)

• check container with sudo docker logs -f cts2le
  (last line ... INFO:oejs.Server:main: Started ...)

• ang-navi: get the service url U of the frontend (hint: execute docker ps -a ) and check it in a browser with U/CTS2LE

kubernetes

• ensure that all docker images are generated according to above section.

• go to directory V3/docker-build-dir-jetty/kubernetes
  (all kubernetes yaml files are located at directory yaml)

• backend

  • apply modifications for your environment (e.g. targetPorts in service definitions or storage requirements in persistent volume claims)

  • execute ./setup-kube-cts2le.sh
    (all resources for the backend are created in kubernetes. To create single resources comment out the others)

• ang-navi

  • adapt the url used by the angular navigator frontend (ang-navi) to access the backend in file yaml/cts2le-navi-env-configmap.yaml (property <CTS2LE_SERVER>).
    !!! <CTS2LE_SERVER> is exactly the url of the container/service cts2le (hint: in minikube execute minikube service cts2le --url ), externally reachable
  • execute ./setup-kube-cts2le2-navi.sh
  • get the kubernetes service url U of the frontend (hint: in minikube execute minikube service cts2le-navi --url ) and check it in a browser with U/CTS2LE

load standard terminologies

Due to terminology license requirements bulk load via pre-generated quad files are not provided any more.

For details see CTS2-LE Supported Terminologies