Difference between revisions of "-OpenSUSE"

From Limbas Wiki

Jump to: navigation, search
(Diese Seite wurde zum Übersetzen freigegeben)
Line 1: Line 1:
 
<translate>
 
<translate>
 +
<!--T:1-->
 
<-- zurück zur '''[[Hauptseite|Hauptseite]]'''
 
<-- zurück zur '''[[Hauptseite|Hauptseite]]'''
 
----
 
----
  
 +
<!--T:2-->
 
Voraussetzung dieser Anleitung ist eine aktuelle OpenSUSE-Installation. Die Beschreibung bezieht sich auf ein 32 bit System.
 
Voraussetzung dieser Anleitung ist eine aktuelle OpenSUSE-Installation. Die Beschreibung bezieht sich auf ein 32 bit System.
  
 +
<!--T:3-->
 
{{note| Bezeichnungen in spitzen Klammern <> können mit beliebigen Text ersetzt werden, müssen aber durchgehend konsistent sein, um LIMBAS erfolgreich installieren zu können. Wenn nicht anders angegeben, erfolgen die im folgenden gezeigten Aufrufe von der Kommandozeile durch den Benutzer "root". }}
 
{{note| Bezeichnungen in spitzen Klammern <> können mit beliebigen Text ersetzt werden, müssen aber durchgehend konsistent sein, um LIMBAS erfolgreich installieren zu können. Wenn nicht anders angegeben, erfolgen die im folgenden gezeigten Aufrufe von der Kommandozeile durch den Benutzer "root". }}
  
==Installationstips==
+
==Installationstips== <!--T:4-->
 
Falls LIMBAS auf einer virtuellen Maschine installiert wird, ist es empfehlenswert, einen SSH Zugang einzurichten, um z.B. die Kommandozeilen-Befehle per Copy-And-Paste einfügen zu können. Hierzu müssen folgende Schritte auf der Server-Installation durchgeführt werden: <br/>
 
Falls LIMBAS auf einer virtuellen Maschine installiert wird, ist es empfehlenswert, einen SSH Zugang einzurichten, um z.B. die Kommandozeilen-Befehle per Copy-And-Paste einfügen zu können. Hierzu müssen folgende Schritte auf der Server-Installation durchgeführt werden: <br/>
 
Zuerst sollte in der Datei ''/etc/sysconfig/selinux'' oder ''/etc/selinux/semanage.conf'' der Eintrag ''SELINUX=disabled'' hinzugefügt werden.
 
Zuerst sollte in der Datei ''/etc/sysconfig/selinux'' oder ''/etc/selinux/semanage.conf'' der Eintrag ''SELINUX=disabled'' hinzugefügt werden.
Line 18: Line 21:
 
  $ '''rcSuSEfirewall2 stop'''
 
  $ '''rcSuSEfirewall2 stop'''
  
 +
<!--T:5-->
 
Zuletzt sollte sichergestellt werden, dass der OpenSSH-Server schon installiert und gestartet wurde.
 
Zuletzt sollte sichergestellt werden, dass der OpenSSH-Server schon installiert und gestartet wurde.
 
  $ '''zypper in openssh-server'''
 
  $ '''zypper in openssh-server'''
Line 23: Line 27:
 
  $ '''rcsshd start'''
 
  $ '''rcsshd start'''
  
==Paketauswahl==
+
==Paketauswahl== <!--T:6-->
  
 +
<!--T:7-->
 
Zusätzlich zur Standardinstallation sind für LIMBAS folgende Pakete zu installieren:  
 
Zusätzlich zur Standardinstallation sind für LIMBAS folgende Pakete zu installieren:  
  
 +
<!--T:8-->
 
*apache2
 
*apache2
 
*apache2-mod_php5
 
*apache2-mod_php5
Line 52: Line 58:
 
*exiftool
 
*exiftool
  
  '''$ zypper in apache2 apache2-mod_php5 php5 php5-gd php5-iconv php5-imap php5-ldap php5-ctype php5-mbstring\'''
+
  <!--T:9-->
 +
'''$ zypper in apache2 apache2-mod_php5 php5 php5-gd php5-iconv php5-imap php5-ldap php5-ctype php5-mbstring\'''
 
  '''php5-odbc php5-soap php5-zlib postgresql postgresql-server psqlODBC unixODBC\'''
 
  '''php5-odbc php5-soap php5-zlib postgresql postgresql-server psqlODBC unixODBC\'''
 
  '''ImageMagick ghostscript ttf2pt1 wget zip unzip exiftool'''
 
  '''ImageMagick ghostscript ttf2pt1 wget zip unzip exiftool'''
  
 +
<!--T:10-->
 
LIMBAS benötigt "htmldoc" in der Version 1.9.x oder neuer, die Standardversion 1.8.x aus den Paketen ist nicht ausreichend. Daher ist ein Download der Sourcen (http://www.htmldoc.org/software.php) und manuelles Übersetzen/Installieren durchzuführen.
 
LIMBAS benötigt "htmldoc" in der Version 1.9.x oder neuer, die Standardversion 1.8.x aus den Paketen ist nicht ausreichend. Daher ist ein Download der Sourcen (http://www.htmldoc.org/software.php) und manuelles Übersetzen/Installieren durchzuführen.
  
==Datenbank-Einrichtung==
+
==Datenbank-Einrichtung== <!--T:11-->
 
[[Datenbank]]
 
[[Datenbank]]
 
===PostgreSQL===
 
===PostgreSQL===
 
Ab Version 2.0.22 unterstützt LIMBAS UTF8 im Beta Stadium. Falls UTF8 nicht benötigt wird, wird ein ISO Encoding empfohlen. LIMBAS konvertiert die Datums- und Zeitformate selbstständig und benötigt das Datumsformat "DD.MM.YYYY". Da PostgreSQL standardmäßig mit Lokalisierung installiert wird, müssen ein paar zusätzliche Schritte beachtet werden.
 
Ab Version 2.0.22 unterstützt LIMBAS UTF8 im Beta Stadium. Falls UTF8 nicht benötigt wird, wird ein ISO Encoding empfohlen. LIMBAS konvertiert die Datums- und Zeitformate selbstständig und benötigt das Datumsformat "DD.MM.YYYY". Da PostgreSQL standardmäßig mit Lokalisierung installiert wird, müssen ein paar zusätzliche Schritte beachtet werden.
  
 +
<!--T:12-->
 
* Datenbank-Server stoppen:
 
* Datenbank-Server stoppen:
 
  $ '''/etc/init.d/postgresql stop''' (bzw. '''rcpostgresql stop''')
 
  $ '''/etc/init.d/postgresql stop''' (bzw. '''rcpostgresql stop''')
  
 +
<!--T:13-->
 
* Falls bereits ein Datenbank-Cluster existiert, so ist der entsprechende Verzeichnis-Inhalt von "/var/lib/pgsql/data" zu löschen (Achtung: Dabei werden schon vorhandene Datenbanken gelöscht).
 
* Falls bereits ein Datenbank-Cluster existiert, so ist der entsprechende Verzeichnis-Inhalt von "/var/lib/pgsql/data" zu löschen (Achtung: Dabei werden schon vorhandene Datenbanken gelöscht).
  
 +
<!--T:14-->
 
* Datenbank-Cluster ohne Lokalisierung neu anlegen:  
 
* Datenbank-Cluster ohne Lokalisierung neu anlegen:  
  
  $ '''su - postgres'''
+
  <!--T:15-->
 +
$ '''su - postgres'''
 
  # '''initdb --local=C -D /var/lib/pgsql/data'''
 
  # '''initdb --local=C -D /var/lib/pgsql/data'''
 
  Die Dateien, die zu diesem Datenbanksystem gehören, werden dem Benutzer
 
  Die Dateien, die zu diesem Datenbanksystem gehören, werden dem Benutzer
Line 110: Line 122:
 
  # '''exit'''
 
  # '''exit'''
  
 +
<!--T:16-->
 
* Beim Zugriff eines Clients auf den PostgreSQL-Datenbank-Server wird eine Authentifizierung durchgeführt. Diese Client-Authentifizierung wird durch die Datei "pg_hba.conf" kontrolliert. Sofern keine Änderungen an der PostgreSQL-Konfigurationsdatei "postgresql.conf" vorgenommen wurde, wird diese aus dem Verzeichnis "/var/lib/pgsql/data" genommen (genauere Informationen siehe http://www.postgresql.org/docs/8.4/interactive/runtime-config-file-locations.html). Durch entsprechenden Eintrag in der Datei "pg_hba.conf" ist sicherzustellen, daß die Authentifizierung für den LIMBAS-Zugriff erfolgreich ist (siehe ggf. http://www.postgresql.org/docs/8.4/static/client-authentication.html).
 
* Beim Zugriff eines Clients auf den PostgreSQL-Datenbank-Server wird eine Authentifizierung durchgeführt. Diese Client-Authentifizierung wird durch die Datei "pg_hba.conf" kontrolliert. Sofern keine Änderungen an der PostgreSQL-Konfigurationsdatei "postgresql.conf" vorgenommen wurde, wird diese aus dem Verzeichnis "/var/lib/pgsql/data" genommen (genauere Informationen siehe http://www.postgresql.org/docs/8.4/interactive/runtime-config-file-locations.html). Durch entsprechenden Eintrag in der Datei "pg_hba.conf" ist sicherzustellen, daß die Authentifizierung für den LIMBAS-Zugriff erfolgreich ist (siehe ggf. http://www.postgresql.org/docs/8.4/static/client-authentication.html).
  
 +
<!--T:17-->
 
* Datenbank-Server starten und ggf. Status überprüfen:  
 
* Datenbank-Server starten und ggf. Status überprüfen:  
 
  $ '''/etc/init.d/postgresql start''' (bzw. '''rcpostgresql start''')
 
  $ '''/etc/init.d/postgresql start''' (bzw. '''rcpostgresql start''')
  
  postgresql-Dienst starten:                                [  OK  ]
+
  <!--T:18-->
 +
postgresql-Dienst starten:                                [  OK  ]
 
   
 
   
 
  $ '''/etc/init.d/postgresql status''' (bzw. '''rcpostgresql status''')
 
  $ '''/etc/init.d/postgresql status''' (bzw. '''rcpostgresql status''')
  
   (PID  <pid>) wird ausgeführt...
+
   <!--T:19-->
 +
(PID  <pid>) wird ausgeführt...
  
 +
<!--T:20-->
 
* Datenbank anlegen (mögliche Kodierungen wären z.B. LATIN1 oder SQL_ASCII oder UTF8) und ggf. Vorhandensein überprüfen:  
 
* Datenbank anlegen (mögliche Kodierungen wären z.B. LATIN1 oder SQL_ASCII oder UTF8) und ggf. Vorhandensein überprüfen:  
  
  $ '''su - postgres'''
+
  <!--T:21-->
 +
$ '''su - postgres'''
 
  # '''psql'''
 
  # '''psql'''
 
  psql (9.4.6)
 
  psql (9.4.6)
Line 156: Line 174:
 
   plpgsql | yes
 
   plpgsql | yes
  
====UTF-8====
+
====UTF-8==== <!--T:22-->
 
Sollte die Datenbank in UTF-8 Kodierung erstellt werden kann folgende Anweisung genutzt werden:
 
Sollte die Datenbank in UTF-8 Kodierung erstellt werden kann folgende Anweisung genutzt werden:
  
  postgres=# '''create database <limbasDB> WITH ENCODING 'UTF-8' OWNER <limbasuser> template template0;'''
+
  <!--T:23-->
 +
postgres=# '''create database <limbasDB> WITH ENCODING 'UTF-8' OWNER <limbasuser> template template0;'''
 
  CREATE DATABASE
 
  CREATE DATABASE
  
====ODBC konfigurieren====
+
====ODBC konfigurieren==== <!--T:24-->
  
 +
<!--T:25-->
 
Es gibt zwei Varianten LIMBAS mit der Datenbank zu verbinden:
 
Es gibt zwei Varianten LIMBAS mit der Datenbank zu verbinden:
 
* Verbindung mit direktem ODBC-Treiberzugriff
 
* Verbindung mit direktem ODBC-Treiberzugriff
 
* Verbindung mit ODBC-resource
 
* Verbindung mit ODBC-resource
  
 +
<!--T:26-->
 
Die folgenden beiden Punkte sind für beide Varianten durchzuführen:
 
Die folgenden beiden Punkte sind für beide Varianten durchzuführen:
  
 +
<!--T:27-->
 
* Pfade der Konfigurationsdateien von unixODBC ermitteln:
 
* Pfade der Konfigurationsdateien von unixODBC ermitteln:
 
  $ '''odbcinst -j'''
 
  $ '''odbcinst -j'''
Line 177: Line 199:
 
  USER DATA SOURCES..: /<user>/.odbc.ini
 
  USER DATA SOURCES..: /<user>/.odbc.ini
  
 +
<!--T:28-->
 
* In der unter "DRIVERS" ermittelten Datei (hier "/etc/unixODBC/odbcinst.ini") die Treiber mit Dateiname und Pfad hinzufügen:
 
* In der unter "DRIVERS" ermittelten Datei (hier "/etc/unixODBC/odbcinst.ini") die Treiber mit Dateiname und Pfad hinzufügen:
 
  [<postgreSQLDriver>]
 
  [<postgreSQLDriver>]
Line 184: Line 207:
 
  Setup64  = /usr/lib64/libodbcpsqlS.so
 
  Setup64  = /usr/lib64/libodbcpsqlS.so
  
 +
<!--T:29-->
 
:ACHTUNG: bei älteren PostgreSQL Versionen (<= 8.3) wird folgender Treiber verwendet:
 
:ACHTUNG: bei älteren PostgreSQL Versionen (<= 8.3) wird folgender Treiber verwendet:
 
  [<postgreSQLDriver>]
 
  [<postgreSQLDriver>]
Line 190: Line 214:
 
  ...
 
  ...
  
 +
<!--T:30-->
 
Der folgende Punkt ist nur notwendig bei einer Verbindung mittels ODBC-resource
 
Der folgende Punkt ist nur notwendig bei einer Verbindung mittels ODBC-resource
  
 +
<!--T:31-->
 
* In der unter "SYSTEM DATA SOURCES" ermittelten Datei (hier "/etc/unixODBC/odbc.ini") den folgenden Eintrag hinzufügen:
 
* In der unter "SYSTEM DATA SOURCES" ermittelten Datei (hier "/etc/unixODBC/odbc.ini") den folgenden Eintrag hinzufügen:
 
  [<limbasOdbcResourceName>]
 
  [<limbasOdbcResourceName>]
Line 211: Line 237:
 
  ConnSettings            =
 
  ConnSettings            =
  
 +
<!--T:32-->
 
{{note|Es ist wichtig den originalen PostgreSQL ODBC Treiber (psqlodbcw.so) des Packetes "postgresql-odbc" zu benutzen und nicht den beigefügten Treiber von unixODBC!!
 
{{note|Es ist wichtig den originalen PostgreSQL ODBC Treiber (psqlodbcw.so) des Packetes "postgresql-odbc" zu benutzen und nicht den beigefügten Treiber von unixODBC!!
 
}}
 
}}
  
==PHP Konfiguration==
+
==PHP Konfiguration== <!--T:33-->
 
Die PHP-Konfiguration wird in der Datei ''/etc/php5/apache2/php.ini'' gespeichert. Hier  sollten die folgenden allgemeinen Einstellungen gesetzt werden:
 
Die PHP-Konfiguration wird in der Datei ''/etc/php5/apache2/php.ini'' gespeichert. Hier  sollten die folgenden allgemeinen Einstellungen gesetzt werden:
 
* short_open_tag = On
 
* short_open_tag = On
Line 220: Line 247:
 
* error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR
 
* error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR
  
 +
<!--T:34-->
 
Desweiteren sollten folgende Sicherheits-Einstellungen hinzugefügt werden [[Sicherheit]]:
 
Desweiteren sollten folgende Sicherheits-Einstellungen hinzugefügt werden [[Sicherheit]]:
 
* magic_quotes_gpc = off
 
* magic_quotes_gpc = off
Line 228: Line 256:
 
* max_input_vars = 10000
 
* max_input_vars = 10000
  
 +
<!--T:35-->
 
Falls nicht PHP 5.4 oder höher vorhanden ist, sollte folgender Eintrag statt magic_quotes_gpc verwendet werden:
 
Falls nicht PHP 5.4 oder höher vorhanden ist, sollte folgender Eintrag statt magic_quotes_gpc verwendet werden:
 
* magic_quotes = Off
 
* magic_quotes = Off
  
==Apache HTTP Server Einrichtung==
+
==Apache HTTP Server Einrichtung== <!--T:36-->
 
Apache ist nach der Paket-Installation in OpenSUSE noch nicht einsatzbereit. Eine Konfiguration ist am einfachsten über das graphische Werkzeug YAST möglich. Eine Anleitung für die Basis-Installation von Apache unter OpenSUSE findet man über folgenden Link [http://doc.opensuse.org/documentation/html/openSUSE/opensuse-reference/cha.apache2.html#sec.apache2.configuration.yast].
 
Apache ist nach der Paket-Installation in OpenSUSE noch nicht einsatzbereit. Eine Konfiguration ist am einfachsten über das graphische Werkzeug YAST möglich. Eine Anleitung für die Basis-Installation von Apache unter OpenSUSE findet man über folgenden Link [http://doc.opensuse.org/documentation/html/openSUSE/opensuse-reference/cha.apache2.html#sec.apache2.configuration.yast].
  
 +
<!--T:37-->
 
Für die LIMBAS Installation müssen das Root-Verzeichnis des Apache-Servers und der Apache-User sowie dessen Gruppe bekannt sein. Diese sind in der Datei '/etc/apache2/httpd.conf' oder '/etc/apache2/default-server.conf' bzw. 'uid.conf' definiert:
 
Für die LIMBAS Installation müssen das Root-Verzeichnis des Apache-Servers und der Apache-User sowie dessen Gruppe bekannt sein. Diese sind in der Datei '/etc/apache2/httpd.conf' oder '/etc/apache2/default-server.conf' bzw. 'uid.conf' definiert:
 
* Das Root-Verzeichnis des Apache-Servers läßt sich aus dem "DocumentRoot"-Eintrag  ermitteln (standardmäßig "/srv/www/htdocs").
 
* Das Root-Verzeichnis des Apache-Servers läßt sich aus dem "DocumentRoot"-Eintrag  ermitteln (standardmäßig "/srv/www/htdocs").
 
* Der Apache-User und seine Gruppe lassen sich in der Datei aus den "User"- und "Group"-Einträgen ermitteln (standardmäßig Benutzer "wwwrun" und Gruppe "www").
 
* Der Apache-User und seine Gruppe lassen sich in der Datei aus den "User"- und "Group"-Einträgen ermitteln (standardmäßig Benutzer "wwwrun" und Gruppe "www").
  
 +
<!--T:38-->
 
Damit alle Zeichen in LIMBAS korrekt angezeigt werden, ist in der Datei "/etc/apache2/httpd.conf" folgende Zeile zu löschen oder auszukommentieren:
 
Damit alle Zeichen in LIMBAS korrekt angezeigt werden, ist in der Datei "/etc/apache2/httpd.conf" folgende Zeile zu löschen oder auszukommentieren:
 
  # AddDefaultCharset UTF-8          DIESE ZEILE LÖSCHEN ODER AUSKOMMENTIEREN !!
 
  # AddDefaultCharset UTF-8          DIESE ZEILE LÖSCHEN ODER AUSKOMMENTIEREN !!
  
 +
<!--T:39-->
 
Damit die in den LIMBAS-Verzeichnissen verwendeten .htaccess-Dateien vom Apache-Server interpretiert werden, ist folgender Eintrag in "/etc/apache2/httpd.conf" hinzuzufügen:
 
Damit die in den LIMBAS-Verzeichnissen verwendeten .htaccess-Dateien vom Apache-Server interpretiert werden, ist folgender Eintrag in "/etc/apache2/httpd.conf" hinzuzufügen:
 
  <Directory "<DocumentRoot>/openlimbas/dependent">
 
  <Directory "<DocumentRoot>/openlimbas/dependent">
Line 246: Line 278:
 
  </Directory>
 
  </Directory>
  
 +
<!--T:40-->
 
Starten des Apache HTTP Servers:
 
Starten des Apache HTTP Servers:
 
  '''$ /usr/sbin/rcapache2 restart'''
 
  '''$ /usr/sbin/rcapache2 restart'''
  
 +
<!--T:41-->
 
Bei Problemen mit neueren Apache Versionen (ab 2.4) kann die Aktivierung des [https://httpd.apache.org/docs/2.4/mod/mod_access_compat.html access_compat-Modules] in ''/etc/sysconfig/apache2'' (APACHE_MODULES="... access_compat ...") oder über
 
Bei Problemen mit neueren Apache Versionen (ab 2.4) kann die Aktivierung des [https://httpd.apache.org/docs/2.4/mod/mod_access_compat.html access_compat-Modules] in ''/etc/sysconfig/apache2'' (APACHE_MODULES="... access_compat ...") oder über
 
  $ a2enmod access
 
  $ a2enmod access
Line 259: Line 293:
 
geändert werden.
 
geändert werden.
  
==LIMBAS Installation==
+
==LIMBAS Installation== <!--T:42-->
 
* LIMBAS kann unter http://sourceforge.net/projects/limbas/files herunter geladen werden. Mittels Kommandozeile ist beispielsweise folgender Aufruf möglich:
 
* LIMBAS kann unter http://sourceforge.net/projects/limbas/files herunter geladen werden. Mittels Kommandozeile ist beispielsweise folgender Aufruf möglich:
 
  $ '''wget http://sourceforge.net/projects/limbas/files/limbas%20source%20package/2.x/openlimbas_2.9.11.1161.tar.gz/download'''
 
  $ '''wget http://sourceforge.net/projects/limbas/files/limbas%20source%20package/2.x/openlimbas_2.9.11.1161.tar.gz/download'''
  
 +
<!--T:43-->
 
* Die Download-Datei (hier "openlimbas_2.9.11.1161.tar.gz") in <DocumentRoot> speichern und dort entpacken:
 
* Die Download-Datei (hier "openlimbas_2.9.11.1161.tar.gz") in <DocumentRoot> speichern und dort entpacken:
 
  $ '''tar xzfv openlimbas_2.9.11.1161.tar.gz'''
 
  $ '''tar xzfv openlimbas_2.9.11.1161.tar.gz'''
  
 +
<!--T:44-->
 
: Beim Entpacken wird das Verzeichnis "<DocumentRoot>/openlimbas" mit den folgenden Unterverzeichnissen angelegt:
 
: Beim Entpacken wird das Verzeichnis "<DocumentRoot>/openlimbas" mit den folgenden Unterverzeichnissen angelegt:
  
 +
<!--T:45-->
 
:* limbas_src: Hier befinden sich die LIMBAS Source-Dateien, die im Falle eines Updates überschrieben werden können, ohne daß individuelle Einstellungen verloren gehen.
 
:* limbas_src: Hier befinden sich die LIMBAS Source-Dateien, die im Falle eines Updates überschrieben werden können, ohne daß individuelle Einstellungen verloren gehen.
 
:* independent: Hier befinden sich eigenständige externe Anwendungen, die von LIMBAS benutzt werden. Ein von LIMBAS losgelöstes Update dieser Anwendungen ist zwar möglich, ist aber nicht zu empfehlen, da das Zusammenspiel nur mit den in der LIMBAS-Installation enthaltenen Versionen getestet ist.
 
:* independent: Hier befinden sich eigenständige externe Anwendungen, die von LIMBAS benutzt werden. Ein von LIMBAS losgelöstes Update dieser Anwendungen ist zwar möglich, ist aber nicht zu empfehlen, da das Zusammenspiel nur mit den in der LIMBAS-Installation enthaltenen Versionen getestet ist.
Line 273: Line 310:
 
:* dependent: Dies ist das eigentliche Arbeitsverzeichnis, in dem auch individuelle Einstellungen abgelegt werden. Die Verzeichnisse und Dateien des limbas_src-Verzeichnisses müssen hier als symbolische Links vorliegen.
 
:* dependent: Dies ist das eigentliche Arbeitsverzeichnis, in dem auch individuelle Einstellungen abgelegt werden. Die Verzeichnisse und Dateien des limbas_src-Verzeichnisses müssen hier als symbolische Links vorliegen.
  
 +
<!--T:46-->
 
* Liegen die Verzeichnisse und Dateien aus "<DocumentRoot>/openlimbas/limbas_src" in "<DocumentRoot>/openlimbas/dependent" fälschlicherweise als Kopie anstatt symbolischer Links vor (bei manchen Systemen gibt es Probleme beim Entpacken der symbolischen Links), so ist wie unter [[Bekannte Problemlösungen|Bekannte Problemlösungen]] beschrieben vorzugehen:
 
* Liegen die Verzeichnisse und Dateien aus "<DocumentRoot>/openlimbas/limbas_src" in "<DocumentRoot>/openlimbas/dependent" fälschlicherweise als Kopie anstatt symbolischer Links vor (bei manchen Systemen gibt es Probleme beim Entpacken der symbolischen Links), so ist wie unter [[Bekannte Problemlösungen|Bekannte Problemlösungen]] beschrieben vorzugehen:
  
 +
<!--T:47-->
 
{{note|Um das Speichern individueller Einstellungen in LIMBAS zu ermöglichen, muß LIMBAS schreibend auf "./openlimbas/dependent" und allen Unterverzeichnissen zugreifen können. Um dies zu ermöglichen ist der Besitzer dieses Verzeichnisses und seiner Unterverzeichnisse auf den Apache-User (hier "wwwrun") zu ändern.
 
{{note|Um das Speichern individueller Einstellungen in LIMBAS zu ermöglichen, muß LIMBAS schreibend auf "./openlimbas/dependent" und allen Unterverzeichnissen zugreifen können. Um dies zu ermöglichen ist der Besitzer dieses Verzeichnisses und seiner Unterverzeichnisse auf den Apache-User (hier "wwwrun") zu ändern.
 
  $ '''chown -R wwwrun:www openlimbas/dependent'''
 
  $ '''chown -R wwwrun:www openlimbas/dependent'''
 
}}
 
}}
  
 +
<!--T:48-->
 
* Falls der Browser auf einem anderen Host läuft, ist dafür zu sorgen, daß die Firewall-Konfiguration den Zugriff von diesem Browser auf den LIMBAS Host zuläßt.
 
* Falls der Browser auf einem anderen Host läuft, ist dafür zu sorgen, daß die Firewall-Konfiguration den Zugriff von diesem Browser auf den LIMBAS Host zuläßt.
  
 +
<!--T:49-->
 
* Mit Hilfe eines Browsers kann jetzt die LIMBAS Datenbankstruktur angelegt werden. Dazu muß das LIMBAS-Installationsskript mit folgender URL aufgerufen werden:
 
* Mit Hilfe eines Browsers kann jetzt die LIMBAS Datenbankstruktur angelegt werden. Dazu muß das LIMBAS-Installationsskript mit folgender URL aufgerufen werden:
 
: http://<LIMBAS Host IP-Adresse>/openlimbas/dependent/admin/install/
 
: http://<LIMBAS Host IP-Adresse>/openlimbas/dependent/admin/install/
  
 +
<!--T:50-->
 
* In der Installations-Maske müssen nun die Parameter der erstellten PostgreSQL Datenbank Instanz eingetragen werden. Abhängig von der Variante, wie sich LIMBAS mit der Datenbank verbindet, unterscheiden sich diese:
 
* In der Installations-Maske müssen nun die Parameter der erstellten PostgreSQL Datenbank Instanz eingetragen werden. Abhängig von der Variante, wie sich LIMBAS mit der Datenbank verbindet, unterscheiden sich diese:
 
** Verbindung mit direktem ODBC-Treiberzugriff
 
** Verbindung mit direktem ODBC-Treiberzugriff
Line 302: Line 344:
 
***SQL Driver (unixODBC): (kein Eintrag erforderlich)
 
***SQL Driver (unixODBC): (kein Eintrag erforderlich)
  
 +
<!--T:51-->
 
:Das Webinterface versucht automatisch alle Pfade korrekt einzutragen. Geschieht dies nicht oder bleiben die Felder leer, sollte die php.ini noch mal überprüft werden.
 
:Das Webinterface versucht automatisch alle Pfade korrekt einzutragen. Geschieht dies nicht oder bleiben die Felder leer, sollte die php.ini noch mal überprüft werden.
  
 +
<!--T:52-->
 
* Bei Mausklick auf "check" wird geprüft, ob alle benötigten Funktionen verfügbar sind. Die Installation kann nur dann fortgeführt werden, wenn die Mindestanforderungen erfüllt sind. Dies ist an den grünen und gelben Häkchen zu erkennen. Ist dies der Fall, kann man die gewünschte Installation auswählen:
 
* Bei Mausklick auf "check" wird geprüft, ob alle benötigten Funktionen verfügbar sind. Die Installation kann nur dann fortgeführt werden, wenn die Mindestanforderungen erfüllt sind. Dies ist an den grünen und gelben Häkchen zu erkennen. Ist dies der Fall, kann man die gewünschte Installation auswählen:
 
**demo.tar.gz: Die Datenbank enthält Benutzer-Daten, mit welchen die Eigenschaften von LIMBAS demonstriert werden können
 
**demo.tar.gz: Die Datenbank enthält Benutzer-Daten, mit welchen die Eigenschaften von LIMBAS demonstriert werden können
 
**clean.tar.gz: Die Datenbank enthält keine Benutzer-Daten.
 
**clean.tar.gz: Die Datenbank enthält keine Benutzer-Daten.
  
 +
<!--T:53-->
 
* Bei Mausklick auf "install" startet der Installationsvorgang. Den Fortschritt der Installation erkennt man an den grünen Fortschrittsbalken.
 
* Bei Mausklick auf "install" startet der Installationsvorgang. Den Fortschritt der Installation erkennt man an den grünen Fortschrittsbalken.
 
* Benutzer "root": Das Installations-Skript überträgt die Datenbankeinstellungen in die Datei "<DocumentRoot>/openlimbas/dependent/inc/include_db.lib". Wird diese Datei verändert, ist kein Zugriff auf die Datenbank mehr möglich. Um unerwünschten Manipulationen vorzubeugen, sollten sämtliche Schreibrechte auf diese Datei entfernt werden.
 
* Benutzer "root": Das Installations-Skript überträgt die Datenbankeinstellungen in die Datei "<DocumentRoot>/openlimbas/dependent/inc/include_db.lib". Wird diese Datei verändert, ist kein Zugriff auf die Datenbank mehr möglich. Um unerwünschten Manipulationen vorzubeugen, sollten sämtliche Schreibrechte auf diese Datei entfernt werden.
 
  chmod 444 <DocumentRoot>/openlimbas/dependent/inc/include_db.lib
 
  chmod 444 <DocumentRoot>/openlimbas/dependent/inc/include_db.lib
  
 +
<!--T:54-->
 
* Nach erfolgreicher Installation kann LIMBAS durch Mausklick auf den Link "test installation" oder durch Eingabe folgender URL gestartet werden:
 
* Nach erfolgreicher Installation kann LIMBAS durch Mausklick auf den Link "test installation" oder durch Eingabe folgender URL gestartet werden:
 
: http://localhost/openlimbas/dependent
 
: http://localhost/openlimbas/dependent

Revision as of 10:50, 24 July 2017

<-- zurück zur Hauptseite


Voraussetzung dieser Anleitung ist eine aktuelle OpenSUSE-Installation. Die Beschreibung bezieht sich auf ein 32 bit System.

Note: Bezeichnungen in spitzen Klammern <> können mit beliebigen Text ersetzt werden, müssen aber durchgehend konsistent sein, um LIMBAS erfolgreich installieren zu können. Wenn nicht anders angegeben, erfolgen die im folgenden gezeigten Aufrufe von der Kommandozeile durch den Benutzer "root".

Installationstips

Falls LIMBAS auf einer virtuellen Maschine installiert wird, ist es empfehlenswert, einen SSH Zugang einzurichten, um z.B. die Kommandozeilen-Befehle per Copy-And-Paste einfügen zu können. Hierzu müssen folgende Schritte auf der Server-Installation durchgeführt werden:
Zuerst sollte in der Datei /etc/sysconfig/selinux oder /etc/selinux/semanage.conf der Eintrag SELINUX=disabled hinzugefügt werden. Danach muss die virtuelle Maschine neu gestartet werden. Die Firewall sollte nun wie folgt deaktiviert werden:

$ /etc/init.d/iptables save
$ service iptables stop
$ chkconfig iptables off

alternativ:

$ chkconfig SuSEfirewall2_init off
$ rcSuSEfirewall2 stop

Zuletzt sollte sichergestellt werden, dass der OpenSSH-Server schon installiert und gestartet wurde.

$ zypper in openssh-server
$ zypper in openssh (alternativ)
$ rcsshd start

Paketauswahl

Zusätzlich zur Standardinstallation sind für LIMBAS folgende Pakete zu installieren:

  • apache2
  • apache2-mod_php5
  • php5
  • php5-gd
  • php5-iconv
  • php5-imap
  • php5-ldap
  • php5-ctype
  • php5-mbstring
  • php5-odbc
  • php5-soap
  • php5-zlib
  • postgresql
  • postgresql-server
  • psqlODBC
  • unixODBC
  • ImageMagick
  • htmldoc
  • ghostscript
  • ttf2pt1
  • wget
  • zip
  • unzip
  • exiftool
$ zypper in apache2 apache2-mod_php5 php5 php5-gd php5-iconv php5-imap php5-ldap php5-ctype php5-mbstring\
php5-odbc php5-soap php5-zlib postgresql postgresql-server psqlODBC unixODBC\
ImageMagick ghostscript ttf2pt1 wget zip unzip exiftool

LIMBAS benötigt "htmldoc" in der Version 1.9.x oder neuer, die Standardversion 1.8.x aus den Paketen ist nicht ausreichend. Daher ist ein Download der Sourcen (http://www.htmldoc.org/software.php) und manuelles Übersetzen/Installieren durchzuführen.

Datenbank-Einrichtung

Datenbank

PostgreSQL

Ab Version 2.0.22 unterstützt LIMBAS UTF8 im Beta Stadium. Falls UTF8 nicht benötigt wird, wird ein ISO Encoding empfohlen. LIMBAS konvertiert die Datums- und Zeitformate selbstständig und benötigt das Datumsformat "DD.MM.YYYY". Da PostgreSQL standardmäßig mit Lokalisierung installiert wird, müssen ein paar zusätzliche Schritte beachtet werden.

  • Datenbank-Server stoppen:
$ /etc/init.d/postgresql stop (bzw. rcpostgresql stop)
  • Falls bereits ein Datenbank-Cluster existiert, so ist der entsprechende Verzeichnis-Inhalt von "/var/lib/pgsql/data" zu löschen (Achtung: Dabei werden schon vorhandene Datenbanken gelöscht).
  • Datenbank-Cluster ohne Lokalisierung neu anlegen:
$ su - postgres
# initdb --local=C -D /var/lib/pgsql/data
Die Dateien, die zu diesem Datenbanksystem gehören, werden dem Benutzer
»postgres« gehören. Diesem Benutzer muss auch der Serverprozess gehören.

Der Datenbankcluster wird mit der Locale C initialisiert werden.
Die Standarddatenbankkodierung wurde entsprechend auf SQL_ASCII gesetzt.
Die Standardtextsuchekonfiguration wird auf »english« gesetzt.

erzeuge Verzeichnis /var/lib/pgsql/data ... ok
erzeuge Unterverzeichnisse ... ok
wähle Vorgabewert für max_connections ... 100
wähle Vorgabewert für shared_buffers ... 32MB
erzeuge Konfigurationsdateien ... ok
erzeuge Datenbank template1 in /var/lib/pgsql/data/base/1 ... ok
initialisiere pg_authid ... ok
initialisiere Abhängigkeiten ... ok
erzeuge Systemsichten ... ok
lade Systemobjektbeschreibungen ... ok
erzeuge Konversionen ... ok
erzeuge Wörterbücher ... ok
setze Privilegien der eingebauten Objekte ... ok
erzeuge Informationsschema ... ok
führe Vacuum in Datenbank template1 durch ...ok
kopiere template1 nach template0 ... ok
kopiere template1 nach postgres ... ok

WARNUNG: Authentifizierung für lokale Verbindungen auf »trust« gesetzt
Sie können dies ändern, indem Sie pg_hba.conf bearbeiten oder beim
nächsten Aufruf von initdb die Option -A verwenden.

Erfolg. Sie können den Datenbankserver jetzt mit

    postgres -D /var/lib/pgsql/data
oder
    pg_ctl -D /var/lib/pgsql/data -l logdatei start

starten.
# exit
  • Datenbank-Server starten und ggf. Status überprüfen:
$ /etc/init.d/postgresql start (bzw. rcpostgresql start)
postgresql-Dienst starten:                                 [  OK  ]

$ /etc/init.d/postgresql status (bzw. rcpostgresql status)
 (PID  <pid>) wird ausgeführt...
  • Datenbank anlegen (mögliche Kodierungen wären z.B. LATIN1 oder SQL_ASCII oder UTF8) und ggf. Vorhandensein überprüfen:
$ su - postgres
# psql
psql (9.4.6)
Geben Sie »help« für Hilfe ein.

postgres=# create user <limbasuser> password '<limbasuserPW>';
CREATE ROLE

postgres=# create database <limbasDB> WITH ENCODING 'SQL_ASCII' OWNER <limbasuser>;
CREATE DATABASE

postgres=#\q

# createlang plpgsql <limbasDB>
# psql -l

                                 Liste der Datenbanken
   Name    | Eigentümer | Kodierung | Sortierfolge | Zeichentyp  | Zugriffsrechte
-----------+------------+-----------+--------------+-------------+-----------------------
<limbasDB> |<limbasuser>| SQL_ASCII | C            | C           |
 postgres  | postgres   | SQL_ASCII | C            | C           |
 template0 | postgres   | SQL_ASCII | C            | C           | =c/postgres
                                                                 : postgres=CTc/postgres
 template1 | postgres   | SQL_ASCII | C            | C           | =c/postgres
                                                                 : postgres=CTc/postgres
(4 Zeilen)

# createlang -l <limbasDB>
Prozedurale Sprachen
  Name   | Vertraut?
---------------------
 plpgsql | yes

UTF-8

Sollte die Datenbank in UTF-8 Kodierung erstellt werden kann folgende Anweisung genutzt werden:

postgres=# create database <limbasDB> WITH ENCODING 'UTF-8' OWNER <limbasuser> template template0;
CREATE DATABASE

ODBC konfigurieren

Es gibt zwei Varianten LIMBAS mit der Datenbank zu verbinden:

  • Verbindung mit direktem ODBC-Treiberzugriff
  • Verbindung mit ODBC-resource

Die folgenden beiden Punkte sind für beide Varianten durchzuführen:

  • Pfade der Konfigurationsdateien von unixODBC ermitteln:
$ odbcinst -j
unixODBC 2.3.1
DRIVERS............: /etc/unixODBC/odbcinst.ini
SYSTEM DATA SOURCES: /etc/unixODBC/odbc.ini
USER DATA SOURCES..: /<user>/.odbc.ini
  • In der unter "DRIVERS" ermittelten Datei (hier "/etc/unixODBC/odbcinst.ini") die Treiber mit Dateiname und Pfad hinzufügen:
[<postgreSQLDriver>]
Driver   = /usr/lib/psqlodbc.so (bei PostgreSQL Version >= 8.4)
Setup    = /usr/lib/libodbcpsqlS.so
Driver64 = /usr/lib64/psqlodbc.so
Setup64  = /usr/lib64/libodbcpsqlS.so
ACHTUNG: bei älteren PostgreSQL Versionen (<= 8.3) wird folgender Treiber verwendet:
[<postgreSQLDriver>]
Driver = /usr/lib/psqlodbcw.so
Setup	= /usr/lib/libodbcpsqlS.so
...

Der folgende Punkt ist nur notwendig bei einer Verbindung mittels ODBC-resource

  • In der unter "SYSTEM DATA SOURCES" ermittelten Datei (hier "/etc/unixODBC/odbc.ini") den folgenden Eintrag hinzufügen:
[<limbasOdbcResourceName>]
Description             = PSQL
Driver                  = <postgreSQLDriver>
Trace                   = No
TraceFile               =
Database                = <limbasDB>
Servername              = localhost
Username                = <limbasuser>
Password                = <limbasuserPW>
Port                    = 5432
Protocol                = 6.4
ReadOnly                = No
RowVersioning           = No
ShowSystemTables        = No
ShowOidColumn           = No
FakeOidIndex            = No
ConnSettings            =
Note: Es ist wichtig den originalen PostgreSQL ODBC Treiber (psqlodbcw.so) des Packetes "postgresql-odbc" zu benutzen und nicht den beigefügten Treiber von unixODBC!!

PHP Konfiguration

Die PHP-Konfiguration wird in der Datei /etc/php5/apache2/php.ini gespeichert. Hier sollten die folgenden allgemeinen Einstellungen gesetzt werden:

  • short_open_tag = On
  • register_globals = Off
  • error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR

Desweiteren sollten folgende Sicherheits-Einstellungen hinzugefügt werden Sicherheit:

  • magic_quotes_gpc = off
  • file_uploads = On
  • upload_max_filesize = 10M
  • post_max_size = 16M
  • memory_limit = 128M
  • max_input_vars = 10000

Falls nicht PHP 5.4 oder höher vorhanden ist, sollte folgender Eintrag statt magic_quotes_gpc verwendet werden:

  • magic_quotes = Off

Apache HTTP Server Einrichtung

Apache ist nach der Paket-Installation in OpenSUSE noch nicht einsatzbereit. Eine Konfiguration ist am einfachsten über das graphische Werkzeug YAST möglich. Eine Anleitung für die Basis-Installation von Apache unter OpenSUSE findet man über folgenden Link [1].

Für die LIMBAS Installation müssen das Root-Verzeichnis des Apache-Servers und der Apache-User sowie dessen Gruppe bekannt sein. Diese sind in der Datei '/etc/apache2/httpd.conf' oder '/etc/apache2/default-server.conf' bzw. 'uid.conf' definiert:

  • Das Root-Verzeichnis des Apache-Servers läßt sich aus dem "DocumentRoot"-Eintrag ermitteln (standardmäßig "/srv/www/htdocs").
  • Der Apache-User und seine Gruppe lassen sich in der Datei aus den "User"- und "Group"-Einträgen ermitteln (standardmäßig Benutzer "wwwrun" und Gruppe "www").

Damit alle Zeichen in LIMBAS korrekt angezeigt werden, ist in der Datei "/etc/apache2/httpd.conf" folgende Zeile zu löschen oder auszukommentieren:

# AddDefaultCharset UTF-8           DIESE ZEILE LÖSCHEN ODER AUSKOMMENTIEREN !!

Damit die in den LIMBAS-Verzeichnissen verwendeten .htaccess-Dateien vom Apache-Server interpretiert werden, ist folgender Eintrag in "/etc/apache2/httpd.conf" hinzuzufügen:

<Directory "<DocumentRoot>/openlimbas/dependent">
     AllowOverride all
</Directory>

Starten des Apache HTTP Servers:

$ /usr/sbin/rcapache2 restart

Bei Problemen mit neueren Apache Versionen (ab 2.4) kann die Aktivierung des access_compat-Modules in /etc/sysconfig/apache2 (APACHE_MODULES="... access_compat ...") oder über

$ a2enmod access

zur Lösung beitragen. Hilft das nicht, muss in jeder .htaccess-Datei

Order allow,deny
Allow from all

zu

Require all granted

geändert werden.

LIMBAS Installation

$ wget http://sourceforge.net/projects/limbas/files/limbas%20source%20package/2.x/openlimbas_2.9.11.1161.tar.gz/download
  • Die Download-Datei (hier "openlimbas_2.9.11.1161.tar.gz") in <DocumentRoot> speichern und dort entpacken:
$ tar xzfv openlimbas_2.9.11.1161.tar.gz
Beim Entpacken wird das Verzeichnis "<DocumentRoot>/openlimbas" mit den folgenden Unterverzeichnissen angelegt:
  • limbas_src: Hier befinden sich die LIMBAS Source-Dateien, die im Falle eines Updates überschrieben werden können, ohne daß individuelle Einstellungen verloren gehen.
  • independent: Hier befinden sich eigenständige externe Anwendungen, die von LIMBAS benutzt werden. Ein von LIMBAS losgelöstes Update dieser Anwendungen ist zwar möglich, ist aber nicht zu empfehlen, da das Zusammenspiel nur mit den in der LIMBAS-Installation enthaltenen Versionen getestet ist.
  • public: Hier befindet sich ein Beispiel für eine SOAP Anwendung. Die Dateien aus diesem Verzeichnis sind für die Funktionalitäten von LIMBAS nicht erforderlich.
  • dependent: Dies ist das eigentliche Arbeitsverzeichnis, in dem auch individuelle Einstellungen abgelegt werden. Die Verzeichnisse und Dateien des limbas_src-Verzeichnisses müssen hier als symbolische Links vorliegen.
  • Liegen die Verzeichnisse und Dateien aus "<DocumentRoot>/openlimbas/limbas_src" in "<DocumentRoot>/openlimbas/dependent" fälschlicherweise als Kopie anstatt symbolischer Links vor (bei manchen Systemen gibt es Probleme beim Entpacken der symbolischen Links), so ist wie unter Bekannte Problemlösungen beschrieben vorzugehen:
Note: Um das Speichern individueller Einstellungen in LIMBAS zu ermöglichen, muß LIMBAS schreibend auf "./openlimbas/dependent" und allen Unterverzeichnissen zugreifen können. Um dies zu ermöglichen ist der Besitzer dieses Verzeichnisses und seiner Unterverzeichnisse auf den Apache-User (hier "wwwrun") zu ändern.
$ chown -R wwwrun:www openlimbas/dependent
  • Falls der Browser auf einem anderen Host läuft, ist dafür zu sorgen, daß die Firewall-Konfiguration den Zugriff von diesem Browser auf den LIMBAS Host zuläßt.
  • Mit Hilfe eines Browsers kann jetzt die LIMBAS Datenbankstruktur angelegt werden. Dazu muß das LIMBAS-Installationsskript mit folgender URL aufgerufen werden:
http://<LIMBAS Host IP-Adresse>/openlimbas/dependent/admin/install/
  • In der Installations-Maske müssen nun die Parameter der erstellten PostgreSQL Datenbank Instanz eingetragen werden. Abhängig von der Variante, wie sich LIMBAS mit der Datenbank verbindet, unterscheiden sich diese:
    • Verbindung mit direktem ODBC-Treiberzugriff
    • Verbindung mit ODBC-resource
      • Database Vendor: PostgreSQL
      • Database Host: localhost
      • Database Name: <limbasOdbcResourceName> (siehe ODBC konfigurieren)
      • Database User: (kein Eintrag erforderlich)
      • Database Password: (kein Eintrag erforderlich)
      • Database Schema: public
      • SQL Driver (unixODBC): (kein Eintrag erforderlich)
Das Webinterface versucht automatisch alle Pfade korrekt einzutragen. Geschieht dies nicht oder bleiben die Felder leer, sollte die php.ini noch mal überprüft werden.
  • Bei Mausklick auf "check" wird geprüft, ob alle benötigten Funktionen verfügbar sind. Die Installation kann nur dann fortgeführt werden, wenn die Mindestanforderungen erfüllt sind. Dies ist an den grünen und gelben Häkchen zu erkennen. Ist dies der Fall, kann man die gewünschte Installation auswählen:
    • demo.tar.gz: Die Datenbank enthält Benutzer-Daten, mit welchen die Eigenschaften von LIMBAS demonstriert werden können
    • clean.tar.gz: Die Datenbank enthält keine Benutzer-Daten.
  • Bei Mausklick auf "install" startet der Installationsvorgang. Den Fortschritt der Installation erkennt man an den grünen Fortschrittsbalken.
  • Benutzer "root": Das Installations-Skript überträgt die Datenbankeinstellungen in die Datei "<DocumentRoot>/openlimbas/dependent/inc/include_db.lib". Wird diese Datei verändert, ist kein Zugriff auf die Datenbank mehr möglich. Um unerwünschten Manipulationen vorzubeugen, sollten sämtliche Schreibrechte auf diese Datei entfernt werden.
chmod 444 <DocumentRoot>/openlimbas/dependent/inc/include_db.lib
  • Nach erfolgreicher Installation kann LIMBAS durch Mausklick auf den Link "test installation" oder durch Eingabe folgender URL gestartet werden:
http://localhost/openlimbas/dependent
Gleich nach dem Aufruf der URL wird man aufgefordert sich zu authentifizieren. Dazu steht folgender Default-Benutzer mit allen Administrator-Rechten zur Verfügung:
  • Benutzername: admin
  • Passwort: limbas