-FreeBSD

Aus Limbas Wiki

Wechseln zu: Navigation, Suche

Hauptseite



Diese Installation wurde erfolgreich auf freeBSD 10.2 32bit getestet.

Note: Bezeichnungen in {geschweiften 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. Dafür sind folgende Schritte notwendig:

In der Datei "/etc/ssh/sshd_config" muss die Zeile PermitRootLogin yes hinzugefügt oder entkommentiert werden.

In der Datei "/etc/rc.conf" muss die Zeile sshd_enable="YES" hinzugefügt oder entkommentiert werden.

 $ /etc/rc.d/sshd restart

FreeBSD Paketauswahl

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

  • apache24
  • php56
  • php56-gd
  • php56-imap
  • php56-odbc
  • php56-soap
  • php56-xml
  • php56-ctype
  • php56-mbstring
  • php56-iconv
  • postgresql93-server
  • postgresql-odbc
  • htmldoc
  • wget
  • ImageMagick
  • unixODBC
  • zip
  • unzip
  • p5-Image-Exiftool
  • mod_php56
 $ pkg install apache24 php56 php56-gd php56-imap php56-odbc php56-soap php56-xml php56-ctype php56-mbstring php56-iconv\
              postgresql93-server postgresql-odbc htmldoc wget ImageMagick unixODBC zip unzip p5-Image-Exiftool mod_php56
$ pkg update

Sollte es im Verlauf der LIMBAS-Installation Probleme mit unixODBC geben, kann eine Neuinstallation über Ports helfen:

$ cd /usr/ports/databases/unixODBC
$ make install

Datenbank-Einrichtung

Limbas unterstützt mehre Datenbanken. Je nach Datenbank müssen unterschiedliche Installationen durchgeführt werden. Standardmäßig wird die PostgreSQL Datenbank genutzt.
siehe Quickinstall

PostgreSQL

Ab Version 2.0.22 unterstützt LIMBAS UTF8. 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. Siehe auch PostgreSQL

  • Datenbank-Server automatisch starten:

In der Datei "/etc/rc.conf" die Zeile postgresql_enable="YES" hinzufügen oder entkommentieren.

  • Datenbank-Server stoppen:
$ /usr/local/etc/rc.d/postgresql stop
  • Falls bereits ein Datenbank-Cluster existiert, kann der folgende Schritt übersprungen werden.
  • Datenbank-Cluster anlegen:
$ /usr/local/etc/rc.d/postgresql initdb
  • 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 "/usr/local/pgsql/data/" genommen (genauere Informationen siehe file-locations). Durch entsprechenden Eintrag in der Datei "pg_hba.conf" ist sicherzustellen, dass die Authentifizierung für den LIMBAS-Zugriff erfolgreich ist (siehe ggf. client-authentication).
  • Datenbank-Server starten und ggf. Status überprüfen:
$ /usr/local/etc/rc.d/postgresql start
  • Status prüfen
$ /usr/local/etc/rc.d/postgresql status
  • Datenbank anlegen (mögliche Kodierungen wären z.B. LATIN1, SQL_ASCII oder UTF-8) und ggf. Vorhandensein überprüfen:
 $ su - pgsql
# createuser -P {limbasuser}
Enter password for new role: {limbasuserPW}
# createdb {limbasdb} -O {limbasuser} --encoding=UTF-8 --locale=C --template=template0
# 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
# exit

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.4
DRIVERS............: /usr/local/etc/odbcinst.ini
SYSTEM DATA SOURCES: /usr/local/etc/odbc.ini
  • In der unter "DRIVERS" ermittelten Datei (hier "/usr/local/etc/odbcinst.ini") die Treiber hinzufügen (z.B. {postgreSQLDriver}= PSQL):
# Setup from the unixODBC package
[{postgreSQLDriver}]
Description     = PostgreSQL
Driver          = /usr/local/lib/psqlodbcw.so
UsageCount      = 1
ACHTUNG: bei älteren PostgreSQL Versionen (<= 8.3) kann folgender Treiber verwendet werden:
Driver = /usr/local/lib/psqlodbc.so

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

  • In der unter "SYSTEM DATA SOURCES" ermittelten Datei (hier "/usr/local/etc/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 muss in "/usr/local/etc/php.ini" angepasst werden. Sollte keine php.ini Datei existieren, muss die php-development.ini kopiert und umbenannt werden. Zuerst, 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 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

Für die LIMBAS Installation müssen das Root-Verzeichnis des Apache-Servers und der Apache-User sowie dessen Gruppe bekannt sein. Diese können aus der Datei "/usr/local/etc/apache24/httpd.conf" entnommen werden:

  • Das Root-Verzeichnis des Apache-Servers läßt sich aus dem "DocumentRoot"-Eintrag ermitteln (standardmäßig "/usr/local/www/apache24/data").
  • Der Apache-User und seine Gruppe lassen sich aus den "User"- und "Group"-Einträgen ermitteln (standardmäßig "www").

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

<Directory "{DocumentRoot}/openlimbas/dependent">
      AllowOverride All
</Directory>

Existiert die Datei "/usr/local/etc/apache24/Includes/php5.conf" nicht, ist diese mit folgendem Inhalt anzulegen:

<IfModule mod_php5.c>
   AddType application/x-httpd-php .php
   AddType application/x-httpd-php-source .phps
   DirectoryIndex index.php
</IfModule>

Starten des Apache HTTP Servers:

$ /usr/local/etc/rc.d/apache24 onestart

Bei Problemen mit neueren Apache Versionen (ab 2.4) kann die Aktivierung des access_compat-Modules 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 openlimbas
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, muss 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 "www") zu ändern.
$ chown -R www: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://{LimbasHostIP}/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