-Ubuntu

Aus Limbas Wiki

Wechseln zu: Navigation, Suche

<-- zurück zu Quickinstall <-- zurück zu Installation / <-- zurück zur Hauptseite-Portale

Der im folgenden beschriebene Installation-Vorgang wurde mit Ubuntu 9.10 (GNOME Desktop Version 2.28.1) und PostgreSQL 8.4 durchgeführt und getestet.

Bezeichnungen in spitzen Klammern <> können mit beliebigen Text ersetzt werden, müssen aber durchgehend konsistent sein, um LIMBAS erfolgreich installieren zu können.

Inhaltsverzeichnis

Ubuntu-Pakete nachinstallieren

Zusätzlich zur Standardinstallation sind für LIMBAS folgende Pakete zu installieren (z.B. mit Synaptic Paketverwaltung oder apt):

  • postgresql-8.4
  • apache2
  • php5
  • php5-gd
  • php5-odbc
  • odbc-postgresql
  • php5-imap
  • imagemagick
  • htmldoc
  • antiword
  • pdftk
  • wv
  • ttf2pt1

Unter http://packages.ubuntu.com kann nach Paket-Quellen gesucht werden, falls ein Paket nicht bekannt ist. Die entsprechende Paketqulle muß dann wie unter http://wiki.ubuntuusers.de/sources.list beschrieben, der Datei /etc/apt/sources.list hinzugefügt werden, um das Paket installieren zu können.

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 einrichten

PostgreSQL

Ab Version 2.0.22 unterstützt LIMBAS UTF8 im Beta Stadium. Falls UTF8 nicht benötigt, 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.

  • Benutzer "root": Datenbank-Server stoppen: 
$ /etc/init.d/postgresql-8.4 stop
Stopping PostgreSQL 8.4 database server
  • Benutzer "root": Falls bereits ein Datenbank-Cluster existiert, so ist der entsprechende Verzeichnis-Inhalt zu löschen (Achtung: Dabei werden schon vorhandene Datenbanken gelöscht).
  • Benutzer "root": Verzeichnis "/var/lib/pgsql" anlegen und den Besitzer dieses Verzeichnisses auf "postgres" ändern. 
$ mkdir /var/lib/pgsql
$ chown postgres /var/lib/pgsql
  • Benutzer "root": Falls für den Benutzer "postgres" das Passwort nicht bekannt ist, dieses setzen: 
$ passwd postgres
Geben Sie ein neues UNIX Passwort ein:
Geben Sie das neue UNIX Passwort erneut ein:
  • Benutzer "postgres": Datenbank-Cluster ohne Lokalisierung neu anlegen: 
$ /usr/lib/postgresql/8.4/bin/initdb --local=C --pgdata=/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 ... 28MB
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

   /usr/lib/postgresql/8.4/bin/postgres -D /var/lib/pgsql/data
oder
   /usr/lib/postgresql/8.4/bin/pg_ctl -D /var/lib/pgsql/data -l logdatei start

starten.
  • Benutzer "root": Datenbank-Server starten und ggf. Status überprüfen: 
$ /etc/init.d/postgresql-8.4 start
Starting PostgreSQL 8.4 database server

$ /etc/init.d/postgresql-8.4 status
8.4     main      5432 online postgres /var/lib/postgresql/8.4/main     /var/log/postgresql/postgresql-8.4-main.log
  • Benutzer "postgres": Datenbank anlegen und ggf. Vorhandensein überprüfen: 
$ /usr/lib/postgresql/8.4/bin/psql
psql (8.4.2)
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> TEMPLATE template0;
CREATE DATABASE

postgres=#\q

$ /usr/lib/postgresql/8.4/bin/createlang plpgsql <limbasDB>

$ /usr/lib/postgresql/8.4/bin/psql -l

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

$ /usr/lib/postgresql/8.4/bin/createlang -l <limbasDB>
Prozedurale Sprachen
  Name   | Vertraut?
---------------------
 plpgsql | yes

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.2.11
DRIVERS............: /etc/odbcinst.ini
SYSTEM DATA SOURCES: /etc/odbc.ini
USER DATA SOURCES..: /home/<user>/.odbc.ini
  • Benutzer "root": In der unter "DRIVERS" ermittelten Datei (hier "/etc/odbcinst.ini") die Treiber mit Dateiname und Pfad hinzufügen: 
[<postgreSQLDriver>]
Driver	= /usr/lib/odbc/psqlodbcw.so
Setup	= /usr/lib/odbc/libodbcpsqlS.so

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

  • Benutzer "root": In der unter "SYSTEM DATA SOURCES" ermittelten Datei (hier "/etc/odbc.ini") die 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            =

PHP konfigurieren

  • Benutzer "root": In der Datei "/etc/php5/apache2/php.ini" den folgenden Eintrag entsprechend setzen: 
magic_quotes_gpc = Off
  • Benutzer "root": Damit die Einträge aktiv werden, muß der Apache-Server neu gestartet werden: 
$ /usr/sbin/apache2ctl restart

Apache HTTP Server Einstellungen

Für die LIMBAS Installation müssen das Root-Verzeichnis des Apache-Servers und der Apache-User bekannt sein:

  • Das Root-Verzeichnis des Apache-Servers läßt sich aus dem "DocumentRoot"-Eintrag der Datei "/etc/apache2/sites-available/default" ermitteln.
  • Der Apache-User läßt sich aus dem "export APACHE_RUN_USER"-Eintrag der Datei "/etc/apache2/envvars" ermitteln.

LIMBAS installieren

$ tar –xzf openlimbas-2.0.23RC3.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:
  • Benutzer "root": 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 "www-data") zu ändern. 
$ chown -R www-data openlimbas/dependent
  • Im Browser kann jetzt die LIMBAS Datenbankstruktur angelegt werden. Dazu muß folgende URL eingegeben werden:
http://localhost/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
Von „http://www.limbas.org/Wiki/-Ubuntu“
Persönliche Werkzeuge
Werkzeuge
LANGUAGES