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

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)

"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

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?