tibhannover/edu-sharing-box

Edu-sharing automatisiert in einer virtuellen Box installieren

edu-sharing-box

Dieses Projekt bietet die Möglichkeit, ein edu-sharing mit minimalem Aufwand in einer virtuellen Maschine aufzusetzen. Voraussetzung ist die Installation von Git, Vagrant und VirtualBox.

Außerdem kann eine Moodle-Instanz an das Repositorium angebunden werden. Siehe hierfür Moodle-Integration

Installation

Die folgenden Schritte im Terminal (Linux/macOS) oder in der GitBash (Windows) ausführen.

git clone https://github.com/TIBHannover/edu-sharing-box.git
cd edu-sharing-box
vagrant up

Wenn die Installation durchgelaufen ist (einige Minuten, abhängig von der Download-Geschwindigkeit) kann edu-sharing im Browser aufgerufen werden mit

http://192.168.98.101/edu-sharing Die Anmeldung am edu-sharing erfolgt in diesem Beispiel noch vereinfacht mit admin/admin

Die Anmeldung an der VM via SSH erfolgt in diesem Beispiel noch vereinfacht und ohne Passwort mit dem Benutzer "vagrant". Der Benutzer hat das sudo-Recht.

vagrant ssh

Update

edu-sharing aktualisieren

• Update Notes prüfen unter https://docs.edu-sharing.com/confluence/edp/en/updating-en/updating-the-repository und ggf. Prozess anpassen
• edu_version und edu_sharing_archive_url anpassen in den edusharing-vars
• playbook ausführen

renderingservice aktualisieren

• Update Notes prüfen unter https://docs.edu-sharing.com/confluence/edp/en/updating-en/updating-the-rendering-service und ggf. Prozess anpassen
• esrender_version anpassen in den renderingservice-vars
• playbook ausführen

Moodle Integration

• zunächst Edu-Sharing-Box wie in Installation geschildert installieren
• nach erfolgreicher Installation die Moodle-Box installieren. Dabei darauf achten, dass in group_vars/all.yml der Eintrag install_edu_sharing_plugin auf true gesetzt ist, damit das Plugin installiert wird
• anschließend in der Datei group_vars/edusharing.yml der Edu-Sharing-Box den Eintrag register_moodle auf true setzen
• im edu-sharing-box-Verzeichnis den Befehl vagrant reload --provisionausführen
• nun sollte in moodle eine Einbindung des edu-sharing Repositoriums erfolgt sein

DFN-AAI / Shibboleth Integration

Siehe SHIBBOLETH.md

edu-sharing-box's Issues

"Trusted clients" konfigurierbar machen

Wird konfiguriert in der „edu-sharing_spring.jar“ in der Datei /org/edu_sharing/spring/authentication-services.xml

<bean id="oauthTokenService"
   class="org.edu_sharing.service.authentication.oauth2.TokenService"
   init-method="init">

   <property name="expiresIn">
      <value>3600</value>
   </property>

   <property name="trustedClients">
      <map>
         <entry key="eduApp" value="secret" />
      </map>
   </property>
</bean>

-> kann dann unter anderem zur Anmeldung via OAuth2 genutzt werden

Falls möglich via lineinfile oä um die Datei nicht immer wieder synchronisieren zu müssen. Ansonsten via Template

allowed_authentication_types not updated properly for install_shibboleth: true

The shihbboleth configuration adjustment to homeApplication.properties.xml (https://github.com/TIBHannover/edu-sharing-box/blob/master/ansible/roles/edu-sharing/tasks/common/shibboleth_after.yml) is not working. The adjustment is overwritten and rolled back.

I needed to process the adjustment manually (via UI -> admin-area) to make it work.

It should work automatically by the ansible-scripts.

We should try to fix the file adjustment. If we cannot find a way, another option would be to use the webservice PUT /edu-sharing/rest/admin/v1/applications/homeApplication.properties.xml (json)

vagrant box not starting for v8

Hi @Edmondi-Kacaj,

With one of your last changes, you implemented to stop the old tomcat before you install edu-sharing v8. It seems that this also tries to do so, if there is no old edu-sharing-version:

TASK [edu-sharing : register oersi - add app-oersi.properties.xml] *************
skipping: [edu-sharing-vm]

TASK [edu-sharing : register oersi - edit applicationfiles in ccapp-registry.properties.xml] ***
skipping: [edu-sharing-vm]

TASK [edu-sharing : Ensure tomcat is stopped.] *********************************
fatal: [edu-sharing-vm]: FAILED! => {"changed": true, "cmd": "/home/vagrant/bin/tomcat.sh stop", "delta": "0:00:00.002538", "end": "2023-05-02 12:27:53.809592", "msg": "non-zero return code", "rc": 127, "start": "2023-05-02 12:27:53.807054", "stderr": "/bin/sh: 1: /home/vagrant/bin/tomcat.sh: not found", "stderr_lines": ["/bin/sh: 1: /home/vagrant/bin/tomcat.sh: not found"], "stdout": "", "stdout_lines": []}

Could you adjust this please and don't stop an old edu-sharing version, if there is no such version?