Setup-Anleitung

Diese Anleitung bietet eine Anleitung zur lokalen Einrichtung der JudaicaLink-Umgebung, einschließlich Solr, Redis, Apache Jena Fuseki und Nginx, um die Projekte effizient auszuführen.

Systemanforderungen

Stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt:

Betriebssystem: Ubuntu 20.04+ / macOS / Windows (WSL empfohlen für Windows)
Python: 3.8+
Docker & Docker Compose: Neueste Version
Node.js & npm: Neueste LTS-Version (für Frontend-Projekte)
Git: Neueste Version

Klonen der Repositories

Klonen Sie die Hauptprojekte von JudaicaLink:

git clone https://github.com/judaicalink/judaicalink-labs.git
git clone https://github.com/judaicalink/judaicalink-site.git
git clone https://github.com/lod-pubby/pubby-django.git
git clone https://github.com/judaicalink/djangordf.git
git clone https://github.com/judaicalink/rdf_generator.git

Einrichten der Python-Umgebung

Erstellen und aktivieren Sie eine virtuelle Umgebung:

python -m venv venv
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate  # Windows

Abhängigkeiten installieren:

pip install -r requirements.txt

Einrichten von Solr

Solr wird für die Volltextindizierung in JudaicaLink Labs verwendet.

Solr herunterladen und extrahieren:

wget https://downloads.apache.org/solr/latest/solr-9.0.0.tgz
tar xzf solr-9.0.0.tgz
cd solr-9.0.0

Solr im Standalone-Modus starten:
```
bin/solr start -e cloud -noprompt
```
Erstellen eines Cores für JudaicaLink:
```
bin/solr create -c judaicalink
```

Einrichten von Redis

Redis wird für Caching- und Warteschlangenoperationen verwendet.

Redis installieren:

sudo apt update && sudo apt install redis-server

Redis starten:

sudo systemctl start redis
sudo systemctl enable redis

Einrichten von Apache Jena Fuseki

Apache Jena Fuseki wird als SPARQL-Endpunkt und RDF-Triple-Store verwendet.

Fuseki herunterladen und extrahieren:

wget https://downloads.apache.org/jena/binaries/apache-jena-fuseki-4.5.0.tar.gz
tar -xzf apache-jena-fuseki-4.5.0.tar.gz
cd apache-jena-fuseki-4.5.0

Fuseki-Server starten:
```
./fuseki-server --update --mem /ds
```

RDF-Daten laden:

curl -X POST --data-binary @data.rdf -H "Content-Type: application/rdf+xml" http://localhost:3030/ds/data

Einrichten von Nginx

Nginx wird als Reverse Proxy zum Bereitstellen der Webanwendungen verwendet.

Nginx installieren:

sudo apt update && sudo apt install nginx

Erstellen einer Nginx-Konfigurationsdatei:

sudo nano /etc/nginx/sites-available/judaicalink

Fügen Sie die folgende Konfiguration hinzu:

server {
    listen 80;
    server_name judaicalink.local;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Konfiguration aktivieren und Nginx neu starten:

sudo ln -s /etc/nginx/sites-available/judaicalink /etc/nginx/sites-enabled/
sudo systemctl restart nginx

Ausführen der Projekte

Um die Projekte lokal auszuführen:

Django-basierte Projekte ausführen:

cd judaicalink-labs
python manage.py runserver

Hugo-basierte Website ausführen:
```
cd judaicalink-site
hugo server
```

Pubby ausführen:

cd pubby-django
python manage.py runserver

Überprüfen der Einrichtung

Labs: http://127.0.0.1:8000
Site: http://localhost:1313
SPARQL Endpoint: http://localhost:3030/ds
Solr Admin UI: http://localhost:8983/solr
Redis Status:
redis-cli ping

Fehlersuche & Unterstützung

Solr not starting? Ensure Java is installed.
Fuseki not responding? Verify it is running on port * 3030* .
Redis connection errors? Restart Redis with:
sudo systemctl restart redis
Benötigen Sie Hilfe? Kontaktieren Sie uns unter https://labs.judaicalink.org/contact/.

— Diese Setup-Anleitung stellt eine vollständige lokale Umgebung für die Entwicklung und das Testen von JudaicaLink-Projekten sicher. 🚀