Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


  vim stripes.config.js
    Adjust Tenant and Okapi-URL :
      okapi: { 'url':'http://folio-hbz2.hbz-nrw.de/okapi', 'tenant':'diku' },
      Die URL muss von außen erreichbar sein, als vom Browser. Der Endpoint The URL must be reachable from the outside, thus from a browser. The endpoint "/okapi" wird will be redirected in der nginx.conf auf den internen Port 9130 umgeleitetto the internal port 9130.
    Diese Zeile entfernen (die search-App nicht installierenRemove this line (don't install the search app) :
          '@folio/search' : {},
In Adjust the logo and the favicon icon in stripes.config.js auch Logo und Favoriten-Bildchen anpassen, falls gewünscht

...

as you like.

  Build the docker container

  sudo su
  docker build -f docker/Dockerfile --build-arg OKAPI_URL=http://10.9.2.85:9130 --build-arg TENANT_ID=diku -t stripes .
Sending build context to Docker daemon  1.138GB
Step 1/19 : FROM node:15-alpine as stripes_build
...
Step 19/19 : ENTRYPOINT ["/usr/bin/entrypoint.sh"]
 ---> Running in a47dce4e3b3e
Removing intermediate container a47dce4e3b3e
 ---> 48a532266f21
Successfully built 48a532266f21
Successfully tagged stripes:latest

# Läuft caThis will run approx. 15 Minuten langminutes.

Den Docker-Container starten.

...

Start the docker container

Redirect Port 80 from the outer world to Port 80 of the container. For SSL, also port 443 needs to be redirected (which is not part of this documentation):
  nohup docker run -d -p 80:80 stripes
  nginx auf dem Server anhaltenStop nginx on the server:

  sudo service nginx stop

 # Mal einloggen in den Docker ContainerLog in to the docker container
  docker exec -it <id> sh
  überprufen, ob die Konfig-Datei richtig angekommen istcheck whether the config file has been copied correctly:
  vi /etc/nginx/conf.d/default.conf
  # das Webserver-Log in dem Container verfolgenfollow the log of the web server inside the container:
  tail -f /var/log/nginx/host.access.log

...


Clean up.

Diese Schritt ist wichtig, das sonst leicht die Perfomance des Servers in die Knie gehen kann. Besonders beim nächsten Upgrade !!

Nicht mehr benutzte Container zurückziehen (undeploy)This step is important, because otherwise the server might easily go down in performance. Especially during your next upgrade this will be of critical importance !!

Undeploy unused containers:
  cd ~/upgrade
  # Welche Container sind jetzt aktiviert Which containers are enabled ?
  curl -w '\n' -XGET http://localhost:9130/_/proxy/tenants/supertenant/modules
  curl -w '\n' -XGET http://localhost:9130/_/proxy/tenants/diku/modules

  # Welche Container sind im Discovery und laufen Which containers are in FOLIO discovery and are running ?
  curl -w '\n' -XGET http://localhost:9130/_/discovery/modules | jq '.[] | .srvcId + "/" + .instId' > dockerps.sh
  # Das sollte noch die Modulversionen des alten Releases enthaltenThis should contain the module versions of the old release
  # => Backend-Module Modules (mod-*) des alten Releases + Backend-Module des neuen Releases (das sollten ca. 120 Module seinof the old release + backend modules of the new release (This should be approx. 120 modules).

  # Nicht mehr benutzte, also nicht aktivierte, Versionen so löschenDelete unused, i.e. not enabled, containers:
  z.B.: curl -w '\n' -D - -XDELETE http://localhost:9130/_/discovery/modules/mod-orders-12.0.1
  wird jeweils mit you will receive an "HTTP/1.1 204 No Content" quittiertfor each post.

# Jetzt noch einmal die bereitgestellten Module auflisten lassenList the modules which are being deployed now:
  curl -w '\n' -D - http://localhost:9130/_/discovery/modules | grep srvcId | wc
  60
  # Das sollte nur die Modulversionen des neuen Releases enthalten  # Vergleich mit der Anzahl laufenden Docker-ContainernThis should only contain the module versions of the new release

  # Compare with the number of running docker containers:
  docker ps --all | wc
     63     788   15088
  # ziehe subtract Kafka, Zookeeper und die Überschriftszeile ab and the header line=> 60 Container mit Backend-Modulen (Die Summen stimmen übereincontainers with backend modules (The Sums are matching).

FERTIG

...

DONE

Log in as "diku_admin:admin" (oder mit Ihrem Systemadministrator-Login) auf or with your sys admin login) on http://folio-hbz2.hbz-nrw.de (durch Ihren Server-Namen ersetzen) an.Prüfen Sie, ob die alten Daten noch da sind ! Z.B im Katalog, unter Benutzerverwaltung etcreplace with your server name).

Check if the old data are still there ! E.g, look in Catalogue or User Managament, if your inventory is still there and if your users are still there.