|
|
Gerade wenn man Änderungen, an der MetaGer-Version durchführen möchte, benötigt man auf dem lokalen Rechner eine funktionierende Kopie von MetaGer.
|
|
|
|
|
|
1. Eine Kopie des MetaGer-Quelltexts besorgen.
|
|
|
* Besorge dir [hier](https://gitlab.metager3.de/dominik/MetaGer/) den Link zum GitLab-Repository. Achte dabei darauf, dass links neben dem Link "http" ausgewählt ist und nicht "ssh"
|
|
|
* Mit `git clone <link>` erhältst du nun nach Eingabe deiner Benutzerdaten eine Kopie des Quelltextes.
|
|
|
* Von nun an gehen wir davon aus, dass du dich im heruntergeladenen MetaGer Verzeichnis befindest.
|
|
|
2. Laravel Framework initialisieren:
|
|
|
* Folgende Programme müssen installiert sein: php7, composer
|
|
|
* `composer update` - sorgt dafür, dass alle weiteren Abhängigkeiten erfüllt sind.
|
|
|
* `cp .env-example .env` - Erstellt eine Beispiel-Konfigurationsdatei
|
|
|
* Trage nun in die ".env" mindestens deine Redis-Zugansdaten ein.
|
|
|
* Nun muss noch ein App-Key erzeugt werden: `php artisan key:generate`
|
|
|
* `php artisan serve` - startet nun einen lokalen "Web-Server", welcher unter 127.0.0.1:8000 erreichbar ist.
|
|
|
|
|
|
=> Bedenke: Zum Betrieb der Suche, wird wenigstens die Datei "config/sumas.xml" benötigt, in der alle Suchmaschinen definiert sind, die verwendet werden. |
|
|
\ No newline at end of file |
|
|
MetaGer kann ohne größeren Aufwand auf den meisten Betriebssystemen installiert werden. Diese Anleitung eignet sich besonders, wenn MetaGer weiter entwickelt werden soll.
|
|
|
Hierfür ist es praktisch, wenn man eine lokale Kopie auf dem Rechner hat, die man auch gleichzeitig testen kann.
|
|
|
Möchte man jedoch einen eigenen Server betreiben, so sind die grundlegenen Schritte gleich, allerdings ist in dem Fall der Einsatz eines richtigen Webservers unverzichtbar.
|
|
|
|
|
|
# Schritt für Schritt Anleitung für Ubuntu 16.04.1
|
|
|
Die Installation wird hier im Home Verzeichnis durchgeführt. Um die MetaGer Daten woanders zu speichern müssen alle Pfade entsprechend angepasst werden.
|
|
|
Kommandos, die über das Terminal eingegeben werden, wurden entsprechend markiert und fangen mit einem ">" an.
|
|
|
|
|
|
### Abhängigkeiten installieren
|
|
|
1. Git: `> sudo apt install git`
|
|
|
2. Composer: `> sudo apt install composer`
|
|
|
3. PHP7.0:
|
|
|
* `> sudo apt install php7.0`
|
|
|
* `> sudo apt install php7.0-mbstring`
|
|
|
* `> sudo apt install php7.0-dom`
|
|
|
* `> sudo apt install php7.0-xml`
|
|
|
4. Redis: `> sudo apt install redis-server`
|
|
|
|
|
|
### MetaGer Quelltext kopieren
|
|
|
|
|
|
`> cd ~/`
|
|
|
`> git clone https://gitlab.metager3.de/open-source/MetaGer.git`
|
|
|
|
|
|
### Abhängigkeiten vom Laravel-Framework auflösen
|
|
|
|
|
|
`> cd ~/MetaGer`
|
|
|
`> composer install`
|
|
|
|
|
|
### Einstellungen für die Entwicklungsumgebung zur Verfügung stellen
|
|
|
|
|
|
Einstellungen für das Framework werden über die Datei `~/MetaGer/.env` zur Verfügung gestellt. Eine ausreichende Konfigurationsdatei wurde bereits mitgeliefert und braucht nur umbenannt werden.
|
|
|
|
|
|
`> cp ~/MetaGer/.env.example ~/MetaGer/.env`
|
|
|
Ein Application Key muss trotzdem generiert werden:
|
|
|
`> php ~/MetaGer/artisan key:generate`
|
|
|
|
|
|
### Bereitstellen der sumas.xml
|
|
|
|
|
|
Als Meta-Suchmaschine fragen wir hauptsächlich externe Interfaces von Suchmaschinen wie z.B.: Yahoo, Fastbot, etc. ab.
|
|
|
Selbstverständlich dürfen wir die Zugangsdaten zu diesen APIs nicht veröffentlichen, da wir mit jeder Suchmaschine einen eigenen Kooperationsvertrag haben, der nur uns die Nutzung erlaubt.
|
|
|
|
|
|
Nichtsdestotrotz kann jeder Nutzer seine eigenen Verträge (API-Zugänge) manuell eintragen. Die sumas.xml beinhaltet alle erforderlichen Informationen darüber, wie die GET-Request formatiert sein muss, um die Ergebnisse zu erhalten.
|
|
|
|
|
|
Zunächst kopieren wir uns eine leere XML-Datei (ohne Suchmaschinen)
|
|
|
`> cp ~/MetaGer/config/sumas.xml.example ~/MetaGer/config/sumas.xml` |
|
|
\ No newline at end of file |