Installation. EGOTEC GmbH

EGOTEC GmbH

Table of Contents 1. Die Einführung...1/57 1.1. Impressum...1/57 1.2. Über EGOTEC...1/57 1.3. Über das Handbuch...2/57 1.4. Systemvoraussetzungen...2/57 2. Allgemein...3/57 2.1. Systemvoraussetzungen...3/57 2.2. benötigte PHP Module...3/57 2.3. Zusätzliche Software...4/57 EgoPDF...4/57 3. Setup...5/57 4. Windows...7/57 4.1. Apache2...7/57 4.1.1. Apache2 installieren...7/57 4.1.2. PHP5 installieren...8/57 4.2. Internet Information Services IIS...9/57 4.2.1. IIS installieren...9/57 4.2.2. PHP 5...11/57 4.2.3. Commandshell für IIS freischalten...14/57 4.2.4. RewriteEngine ISAPI_Rewrite...14/57 5. Linux...17/57 5.1. Apache2...17/57 5.2. PHP 5...18/57 6. PHP 5...19/57 6.1. Windows...19/57 6.2. Standardwerte einstellen...19/57 6.3. suphp...21/57 7. PERL...23/57 7.1. Windows...23/57 7.2. Linux...23/57 7.3. *BSD und andere Unix Varianten...23/57 8. MySQL...24/57 8.1. Windows...24/57 8.2. Linux...27/57 8.3. *BSD und andere Unix Varianten...27/57 8.4. Konfiguration für Volltextsuche...27/57 9. Oracle...28/57 9.1. Ubuntu 6.06 LTS...28/57 9.1.1. oci8 PHP Modul kompilieren...31/57 9.2. Linux allgemein...32/57 9.3. Zugriff auf eine Oracle Datenbank...39/57 9.3.1. Direktzugriff...39/57 9.3.2. Zugriff mit dem Instant Client...39/57 i

Table of Contents 10. MS Sql Server...41/57 11. Module...42/57 11.1. Office Import / SearchPlus...42/57 11.1.1. OpenOffice als Dienst unter Windows 2003 registrieren...43/57 11.1.2. OpenOffice als Dienst unter Linux und anderen Unix Varianten...46/57 11.2. Statistik...47/57 11.3. PDF...47/57 11.3.1. Windows...47/57 12. SLES 9...49/57 12.1. Installation...49/57 12.2. Einspielen der EGOTEC SLES9 Pakete...50/57 12.3. Apache einrichten...50/57 12.4. Oracle Anbindung...52/57 12.4.1. Fernzugriff...52/57 12.4.2. PHP...53/57 12.4.3. Test...53/57 13. EGOTEC in einen anderen Ordner verschieben...55/57 14. Tipps und Tricks...56/57 15. Solaris 10...57/57 Paketspezifische Pfade...57/57 ii

1. Die Einführung Die Einführung 1.1. Impressum Impressum EGOTEC GmbH 1999 2006. Alle Rechte vorbehalten. Alle Angaben zum Handbuch wurden sorgfältig erarbeitet, erfolgen jedoch ohne Gewähr. Handbuch Auflage August 2006 Kein Teil des Handbuchs oder Programms darf in irgendeiner Form (Druck, Fotokopie, Mikrofilm oder in einem anderen Verfahren) ohne unsere vorherige schriftliche Genehmigung reproduziert oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Wir weisen darauf hin, dass die im Buch verwendeten Bezeichnungen und Markennamen der jeweiligen Firmen im allgemeinen Warenzeichen, Marken oder Patentschutz unterliegen. 1.2. Über EGOTEC Über EGOTEC EGOTEC ist ein Programm mit neuester Softwaretechnik, für dessen Entwicklung wir keinen Aufwand und keine Zeit gescheut haben. Ganz besondere Aufmerksamkeit wurde auf die einfache und komfortable Bedienung gelegt. Umfassende Kenntnisse in der Internettechnologie setzt das Programm nicht voraus. Die Bedienoberfläche ist an gängige Standardsoftware angelehnt, wodurch eine geringe Einarbeitungszeit garantiert ist. Sie werden während der Arbeit durch die kontextsensitive Hilfe unterstützt. Wir wünschen Ihnen nun viel Spaß mit dem Programm. Sollten Sie Fragen, Anregungen oder Wünsche haben, teilen Sie uns diese mit. EGOTEC GmbH 1/57

1.3. Über das Handbuch 1. Die Einführung Über das Handbuch Tastatureingaben werden wie folgt dargestellt: <Return> = Einfaches Betätigen der Eingabe oder Enter Taste <Strg>+<R> = Drücken und Halten der Taste "Steuerung" (evtl. auch "Control" oder "Ctrl") und gleichzeitiges Drücken der Taste "R" In diesem Handbuch werden folgende Symbole verwendet, um Sie auf wichtige Dinge hinzuweisen: Für den Benutzer wichtige Hinweise sind in einem grauen Kasten geschrieben. Mit einem Dreieck mit Ausrufzeichen gekennzeichnete Hinweise sollten unbedingt beachtet werden. 1.4. Systemvoraussetzungen Systemvoraussetzungen Dieser Abschnitt beschreibt die Hardware, Systemsoftware und den Speicherbedarf für die Verwendung von EGOTEC. Hierbei werden die Minimalanforderungen beschrieben. Selbstverständlich sind nach oben hin keine Grenzen gesetzt. Microsoft Internet Explorer 5.01 oder Netscape 6.1 oder Mozilla Firefox 1.0 Javascript ist im Webbrowser zu aktivieren Cookies sind im Webbrowser zu aktivieren Pop Up Fenster müssen zugelassen sein Bildschirmauflösung 1024 x 768 Pixel Die Systemanforderungen für den Server auf dem EGOTEC betrieben werden soll entnehmen Sie bitte dem Installationshandbuch EGOTEC GmbH 2/57

2. Allgemein Allgemein 2.1. Systemvoraussetzungen Systemvoraussetzungen Windows, Linux, Solaris oder andere Unix Varianten MySQL ab 4.0.15, empfohlen ab 4.1.x Oracle 9.x oder höher MS_SQL Server 2003 PostgreSQL 8.x oder höher IBM DB2 Apache ab 2.0.x, Internet Information Server (IIS) 5+ PHP ab 5.0, empfohlen ab PHP 5.0.4 2.2. benötigte PHP Module benötigte PHP Module EGOTEC GmbH 3/57

GD 2.0 (oder höher) oder installiertes ImageMagick mime_magic session sockets wddx xml zlib soap tidy wird für Bildbearbeitung benötigt Erkennung von Dateitypen Netzwerkverbindungen 2. Allgemein wird für virtuelle Hostverwaltung mit EGOTEC benötigt komprimierte Übertragung der Webseite an den Browser steigert die Geschwindigkeit und verringert das Datenvolumen 2.3. Zusätzliche Software Zusätzliche Software EgoPDF Einige EGOTEC Module greifen auf zusätzliche Software zurück, die auf dem Server installiert sein muss. erforderlich : HTMLDOC SearchPlus Workflow erforderlich : OpenOffice empfohlen : pdftotext Ohne pdftotext können keine PDF Dateien indiziert werden empfohlen : Graphviz ab Version 2.x ermöglicht das grafische Bearbeiten von Workflows Bildbearbeitung empfohlen : ImageMagick ermöglicht das Darstellen von nicht webfähigen Bildformaten EGOTEC GmbH 4/57

3. Setup Setup 1. Entpacken Sie das EGOTEC Setup Archiv in das htdocs Verzeichnis des Apache oder in ein Unterverzeichnis. 2. Starten Sie Apache und die Datenbank. Öffnen Sie mit einem Web Browser (z.b. IE 6.0 oder Firefox 1.x) die URL: http://localhost/egotecsetup.php (falls Sie das Archiv in ein anderes Verzeichnis entpackt haben, ändern Sie die URL bitte entsprechend ab) 3. Konfiguration Prinzipiell können Sie die Vorbelegungen übernehmen. Falls aber die Datenbank auf einem anderen Rechner verwendet werden soll, so müssen Sie diesen jetzt eintragen. Ebenso müssen der Benutzername und das Passwort des Datenbannk Benutzers angegeben werden. EGOTEC GmbH 5/57

Als Benutzer für den Admin Zugang verwenden Sie zunächst den Standard Benutzer: Benutzername : admin Passwort :demo 3. Setup EGOTEC GmbH 6/57

4. Windows Windows 4.1. Apache2 Apache2 4.1.1. Apache2 installieren Apache2 installieren Das MSI Apache2 Paket von http://httpd.apache.org/download.cgi herunterladen und installieren. Öffnen Sie nach der Installation die Datei "conf\httpd.conf" im Apache Installationsverzeichnis. Aktivieren Sie im Abschnitt "Dynamic Shared Object (DSO) Support" die Rewrite-Engine indem Sie das Zeichen "#" vor der Zeile "LoadModule rewrite_module modules/mod_rewrite.so" entfernen. Suchen Sie in der selben Datei nach "" und ersetzten Sie dort "AllowOverride None" mit "AllowOverride All". EGOTEC GmbH 7/57

4.1.2. PHP5 installieren 4. Windows PHP5 installieren Laden Sie sich den PHP5 Installer und das PHP5 ZIP Paket von http://www.php.net/downloads.php herunter. Installieren Sie PHP5 nach c:\php. Bei der Mail Konfiguration müssen Sie ihren SMTP Server einstellen. In das zweite Feld tragen Sie die Email ein, die als Absender von Systemnachrichten angezeigt werden soll. Drücken Sie dann auf "Next". Bei dem nächsten Dialog wählen Sie unter den Servern den Apache aus und drücken Sie danach auf "Next". Öffnen Sie nach der PHP Installation die Datei "conf\httpd.conf" im Apache Installationsverzeichnis und fügen Sie folgende Zeilen der Modulkonfiguration hinzu: LoadModule php5_module "c:/php/php5apache2.dll" AddType application/x httpd php.php EGOTEC GmbH 8/57

4. Windows Starten Sie jetzt den Apache2 Server neu. Klicken Sie dazu mit der linken Maustaste auf das Apache Symbol neben der Systemuhr und wählen Sie in dem "Restart" aus. 4.2. Internet Information Services IIS Internet Information Services IIS 4.2.1. IIS installieren IIS installieren Um den IIS unter Windows 2003 zu installieren gehen Sie in die Systemsteuerung und starten Sie die Softwareverwaltung. Klicken Sie hier auf "Add/Remove Windows Components". Im nachfolgenden Dialog doppelklicken Sie auf "Application Server" und wählen dort "Internet Information Services" aus. EGOTEC GmbH 9/57

4. Windows EGOTEC GmbH 10/57

4.2.2. PHP 5 4. Windows PHP 5 1. Laden Sie das PHP5 ZIP Paket von http://www.php.net/downloads.php herunter und entpacken Sie es nach c:\php. 2. Fügen Sie c:\php zum Pfad hinzu. Klicken Sie mit der rechten Maustatse auf das Arbeitsplatzsymbol, dann auf Eigenschaften. Gehen Sie auf den Reiter Erweitert. Der fügen Sie das Verzeichnis c:php am Ende des Pfades an. 3. Aktivieren SIe PHP im IIS. Öffnen Sie den IIS Manager. Gehen Sie zu den Web Service Erweiterungen und fügen Sie dort eine neue Erweiterung hinzu. Der Name sollte php isapi lauten. Setzen Sie den Status der PHP Erweiterung auf erlaubt. 4. Nun muss die Dateiendung.php mit der PHP Erweiterung verbunden werden. EGOTEC GmbH 11/57

4. Windows 5. Klicken Sie mit der rechten Maustaste im IIS Manager auf den Eintrag Web Sites. Wählen Sie in diesem Menü den Eintrag Eigenschaften aus. Gehen Sie im Eigenschaftendialog auf den Reiter Home Directory, dort klicken Sie auf den Knopf Konfiguration und dann auf Hinzufügen. Tragen Sie in den daraufhin erscheinenden Dialog im Feld Executable den Pfad zur php5isapi DLL (c:\php\php5isapi.dll) und im Feld Extension.php ein. Benennen Sie im Verzeichnis c:\php die Datei php.ini recommended in php.ini um. Stellen Sie den Pfad auf die php.ini in der Windows Registry ein, indem Sie die Datei php.ini.reg mit folgendem Inhalt erstellen: Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\PHP] "IniFilePath"="C:\\php" Führen Sie diese Datei durch einen Doppelklick aus. Aktivieren Sie in der php.ini die Folgenden Erweiterungen: extension_dir = "c:\php\ext" extension=php_mbstring.dll extension=php_exif.dll extension=php_gd2.dll ;extension=php_ldap.dll extension=php_mcrypt.dll extension=php_mhash.dll extension=php_mime_magic.dll ;extension=php_mssql.dll extension=php_mysql.dll ;extension=php_oci8.dll extension=php_openssl.dll ;extension=php_oracle.dll ;extension=php_pgsql.dll extension=php_soap.dll extension=php_sockets.dll extension=php_sqlite.dll ;extension=php_sybase_ct.dll extension=php_tidy.dll 6. Starten Sie jetzt den IIS neu. 7. Bevor Sie EGOTEC 4 installieren müssen Sie noch folgende Werte in die Windows Registry mit aufnehmen. EGOTEC GmbH 12/57

Öffnen Sie einen Texteditor und fügen Sie die nachfolgenden Zeilen in eine leere Textdatei ein und speichern Sie die Datei unter dem Namen "egotec.reg" ab. Ändern Sie die Pfade innerhalb der Datei. Hier wurde der Standardinstallationspfad "c:\inetpub\wwwroot" verwendet. Wenn Sie einen anderen Pfad verwenden müssen Sie diesen eintragen. Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\PHP] [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\Per Directory Values] [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\Per Directory Values\c] [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\Per Directory Values\c\Inetpub] [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\Per Directory Values\c\Inetpub\wwwroot] "zend.ze1_compatibility_mode"="off" "short_open_tag"="off" "asp_tags"="off" "output_buffering"="off" "allow_call_time_pass_reference Off"="" "safe_mode"="off" "max_execution_time"="30" "memory_limit"="128m" "register_globals"="off" "register_long_arrays"="off" "register_argc_argv"="off" "post_max_size"="64m" "magic_quotes_gpc"="off" "magic_quotes_runtime"="off" "default_mimetype"="text/html" "default_charset"="utf 8" "always_populate_raw_post_data"="off" "file_uploads"="on" "upload_max_filesize"="64m" "allow_url_fopen"="on" "default_socket_timeout"="10" "session.save_handler"="files" "session.save_path"="c:/inetpub/wwwroot/var/session" "session.use_cookies"="on" "session.use_only_cookies"="on" "session.name"="egotec" "session.serialize_handler"="php" "session.gc_probability"="1" "session.gc_divisor"="1000" "session.gc_maxlifetime"="1440" "display_errors"="on" "display_startup_errors"="on" "error_reporting"="1015" "include_path"=".;c:/inetpub/wwwroot/lib;c:/inetpub/wwwroot/lib/pear" 4. Windows EGOTEC GmbH 13/57

4.2.3. Commandshell für IIS freischalten 4. Windows Commandshell für IIS freischalten Ab Windows 2003 sind die Rechte für die Commandshell restriktiver eingestellt wie unter Windows 2000. Der anonyme IIS Benutzer darf unter Windows 2003 keine Commandshell mehr öffnen. Bitte fügen Sie den anonymen IIS Benutzer der Commandshell hinzu. Öffnen Sie den System32 Ordner im Windows Installationsverzeichnis. Wählen Sie dort die Datei cmd.exe aus. Öffnen Sie den Eigenschaftendialog. Wechseln Sie auf den Reiter Sicherheit. Wählen Sie hinzufügen und im daraufhin erscheinenden Dialog Erweitert. Dort suchen Sie nach dem anonymen IIS Benutzer (z.b. IUSR_HOST). Durch Klicken auf OK in den drei zuletzt geöffneten Dialogen fügen Sie diesen der Benutzerliste hinzu. Benantworten Sie die Sicherheitsabfrage mit Ja. 4.2.4. RewriteEngine ISAPI_Rewrite RewriteEngine ISAPI_Rewrite Für sprechende URLs muss eine Rewrite Erweiterung installiert werden. Wir empfehlen ISAPI_Rewrite. Diese Erweiterung gibt es sowohl als kostenpflichtige als auch freie Version. Für eine Einmandanteninstallation genügt die freie Version. Diese kann von http://www.isapirewrite.com/ bezogen werden. EGOTEC GmbH 14/57

4. Windows Die Erweiterung wird per Standard installiert. Die Konfiguration erfolgt nach der Installation. EGOTEC GmbH 15/57

4. Windows Nach der Installation müssen Sie die Konfigurationsdatei öffnen. Ändern Sie die Pfade innerhalb der Datei. Hier wurde der Standardinstallationspfad "c:\inetpub\wwwroot" verwendet. Wenn Sie einen anderen Pfad verwenden müssen Sie diesen eintragen. [ISAPI_Rewrite] RewriteRule ^(/skin/.*)$ $1 [L] RewriteRule ^(/site/.*)$ $1 [L] RewriteRule ^(/bin/.*)$ $1 [L] RewriteRule ^(/admin.php.*)$ $1 [L] RewriteRule ^(/index.php.*)$ $1 [L] RewriteRule ^(/robots.txt.*)$ $1 [L] RewriteRule ^(/favicon.ico.*)$ $1 [L] RewriteRule ^(/setup/.*)$ $1 [L] RewriteRule ^/(.*)\?(.*)$ /rewrite.php?_url=$1&$2 [L] RewriteRule ^/(.*)$ /rewrite.php?_url=$1 [L] Jetzt können Sie mit der Installation des EGOTEC Content Management Servers beginnen. EGOTEC GmbH 16/57

5. Linux Linux 5.1. Apache2 Apache2 Der Apache Webserver ist in jeder gängigen Linuxdistribution vorhanden und kann über den Paketmanager installiert werden. Suchen Sie in der Datei "httpd.conf" nach "" und ersetzten Sie dort "AllowOverride None" mit "AllowOverride All". EGOTEC GmbH 17/57

5.2. PHP 5 5. Linux PHP 5 PHP5 ist für jede gängigen Linuxdistribution verfügbar und kann über den Paketmanager installiert werden. Aktivieren Sie PHP mit der zu Ihrer Distribution gehörenden Administrationsoberfläche. EGOTEC GmbH 18/57

6. PHP 5 PHP 5 6.1. Windows Windows Entpacken Sie nach der Installation das PHP5 ZIP Paket in das PHP Installationsverzeichnis. Überschreiben Sie gegebenenfalls schon (durch das Setup) vorhandene Dateien. Kopieren Sie danach alle *.dll Dateien in das "System32" Ihrer Windows Installation. Öffnen Sie die Datei "php.ini" im Windows Verzeichnis. Ändern Sie hier folgende Werte ab: extension_dir = "c:/php/ext" extension=php_gd2.dll extension=php_mime_magic.dll extension=php_mime_magic.dll extension=php_sockets.dll Fügen Sie noch folgendes in die "php.ini" Datei ein: [mime_magic] mime_magic.debug = On mime_magic.magicfile = "c:/php/extras/magic.mime" 6.2. Standardwerte einstellen Standardwerte einstellen Wenn Sie die php.ini Datei noch nicht geöffnet haben, dann öffnen Sie sie jetzt mit einem Texteditor. Ändern Sie hier folgende Werte ab: memory_limit = 128M EGOTEC GmbH 19/57

6. PHP 5 post_max_site = 64M upload_max_filesize = 64M magic_quotes_gpc = Off allow_url_fopen = On EGOTEC GmbH 20/57

6. PHP 5 6.3. suphp suphp Wenn Sie suphp auf Ihrem Webserver verwenden, müssen Sie eine eigene php.ini Datei für EGOTEC erstellen. Kopieren Sie am besten die standard php.ini Datei Ihrer PHP Installation in das DOCUMENT_ROOT Ihrer Webserverinstallation. Erstellen Sie dann eine.htaccess Datei mit folgendem Inhalt: suphp_configpath /pfad/zur/neuen/php/ini/datei Beachten Sie, das hier nur der Pfad stehen darf ohne die php.ini Datei! Stellen Sie in dieser php.ini folgendes ein: zend.ze1_compatibility_mode = Off short_open_tag = Off asp_tags = Off output_buffering = Off allow_call_time_pass_reference = Off safe_mode = Off max_execution_time = 30 memory_limit = 128M register_globals = Off register_long_arrays = Off register_argc_argv = Off post_max_size = 64M magic_quotes_gpc = Off magic_quotes_runtime = Off default_mimetype = text/html default_charset = utf 8 always_populate_raw_post_data = Off file_uploads = On upload_max_filesize = 64M allow_url_fopen = On EGOTEC GmbH 21/57

6. PHP 5 default_socket_timeout = 10 session.save_handler = files session.save_path = /pfad/zum/cms/var/session session.use_cookies = On session.use_only_cookies = On session.name = EGOTEC session.serialize_handler = php session.gc_probability = 1 session.gc_divisor = 1000 session.gc_maxlifetime = 1440 display_errors = On display_startup_errors = On error_reporting = 1015 include_path = "{DAS WAS VORHER DRINSTAND}:/pfad/zum/cms/lib:/pfad/zum/cms/lib/PEAR" # das was vorher im include_path steht muss mit beibehalten werden EGOTEC GmbH 22/57

7. PERL PERL Wenn Sie das Statistikmodul verwenden benötigen Sie eine Perl Installation. 7.1. Windows Windows Für Windows verwenden Sie am besten ActivePerl von ActiveState. Laden Sie sich unter http://www.activestate.com/products/download/download.plex?id=activeperl das Windows MSI Paket runter und installieren Sie es. 7.2. Linux Linux Unter Linux ist Perl standardmäßig installiert. 7.3. *BSD und andere Unix Varianten *BSD und andere Unix Varianten Hier ist Perl auch schon häufig vorinstalliert. EGOTEC GmbH 23/57

8. MySQL MySQL 8.1. Windows Windows Laden Sie sich das MySQL 4.1 Packet ("Windows Essentials (x86)") von http://dev.mysql.com/downloads/mysql/4.1.html herunter. Starten Sie das Setup und befolgen Sie die Anweisungen des Setup Programms. Sie müssen keinen MySQL.com Account erzeugen. Wählen Sie nach der Installation "Configure the MySQL Server now" aus und drücken Sie auf "Finish". EGOTEC GmbH 24/57

8. MySQL Wählen Sie bei der Instanzkonfiguration "Server Machine" aus. Sie müssen das TCP/IP Netzwerk aktivieren. Wählen Sie bei "Character Set" "utf8" aus. Aktivieren Sie "Include Bin Directory in Windows PATH". EGOTEC GmbH 25/57

8. MySQL Geben Sie ein Passwort für den Benutzer "root" ein. Das Passwort benötigen Sie um den MySQL Server verwalten zu können. Wenn alles erfolgreich abgeschlossen worden ist sehen Sie diesen Dialog. EGOTEC GmbH 26/57

8.2. Linux 8. MySQL Linux Bei jeder gängigen Linux Distribution ist MySQL als Paket vorhanden und lässt sich über den Paketmanager installieren. 8.3. *BSD und andere Unix Varianten *BSD und andere Unix Varianten Bei *BSD ist MySQL als Port vorhanden. Bei anderen Unix Varianten müssen Sie das entsprechende MySQL Binary von der MySQL Webseite (http://www.mysql.com/) herunterladen und installieren. 8.4. Konfiguration für Volltextsuche Konfiguration für Volltextsuche Die Volltextsuche von MySQL sucht Standard mäßig nur nach Wörter, die mindestens eine Länge von vier Zeichen haben, d.h. Abkürzungen wie CD oder DVD usw. werden nicht gefunden. EGOTEC benutzt für Sucheingaben, die weniger als vier Zeichen haben, eine andere Suche, bei verknüpften Suchen nach CD oder DVD "CD DVD" wird aber nichts gefunden. Um auch bei solchen Suchanfragen Treffer zu erhalten, müssen Sie die Konfiguration von MySQL anpassen. Fügen Sie in der Konfigurationsdatei my.conf folgende Zeilen ein: [mysqld] ft_min_word_len = 2 EGOTEC GmbH 27/57

9. Oracle Oracle 9.1. Ubuntu 6.06 LTS Ubuntu 6.06 LTS Installation der Oracle Database 10g Express Edition Die Oracle Database 10g Express Edition liegt als Debian Paket vor. Es kann mit Hilfe von dpkg als root eingespielt werden. Auf keinen Fall dürfen Sie bei der Installation von Oracle sudo verwenden. Wenn Sie mit su zu root wechseln, dann mit einem Minuszeichen: su! dpkg i oracle xe universal_10.2.0.1 1.0_i386.deb Eventuelle Abhängigkeiten lösen Sie durch das Einspielen der jeweiligen Pakete mit Hilfe von apt get. apt get install libaio Sie können auch das Oracle Repositorie in Ihr System eintragen. gedit /etc/apt/sources.list deb http://oss.oracle.com/debian unstable main non free Danach konfigurieren Sie die Datenbank. /etc/init.d/oracle xe configure Oracle Database 10g Express Edition Configuration This will configure on boot properties of Oracle Database 10g Express Edition. The following questions will determine whether the database should be starting upon system boot, the ports it will use, and the passwords that will be used for database accounts. Press <Enter> to accept the defaults. Ctrl C will abort. Specify the HTTP port that will be used for Oracle Application Express [8080]: Specify a port that will be used for the database listener [1521]: Specify a password to be used for database accounts. Note that the same password will be used for SYS and SYSTEM. Oracle recommends the use of different passwords for each database account. This can be done after initial configuration: Confirm the password: Übernehmen Sie am besten die vorgegebene Einstellungen und setzen Sie das Administratorenpasswort. EGOTEC GmbH 28/57

Alle Benutzer, die die Datenbank starten können sollen, müssen in der Gruppe dba eingetragen sein. Das Installationsprogramm vergisst allerdings, ein paar Umgebungsvariablen zu setzen. Wenn Sie z.b. sqlplus starten werden Sie folgenden Fehler zu sehen bekommen. "ORA 12162 net service name is incorrectly specified" Setzen Sie in Ihrer Umgebung daher folgende Variablen: gedit /etc/environment ORACLE_HOME="/usr/lib/oracle/xe/app/oracle/product/10.2.0/server" ORACLE_SID="XE" ORATAB="/etc/oratab" ORACLE_HOME_LISTENER="/usr/lib/oracle/xe/app/oracle/product/10.2.0/server" ORACLE_BASE="/usr/lib/oracle/xe/app/oracle/product/10.2.0/server" Fügen Sie außerdem der PATH Variablen folgenden Pfad hinzu. /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin Starten Sie Ihr System neu. Zum Anlegen der EGOTEC Systemdatenbank können Sie nun die APEX Weboberfläche von Oracle benutzen http://127.0.0.1:8080/apex/. 9. Oracle EGOTEC GmbH 29/57

9. Oracle EGOTEC GmbH 30/57

9.1.1. oci8 PHP Modul kompilieren 9. Oracle oci8 PHP Modul kompilieren Falls Ihr PHP noch keine Oracle Unterstützung enthält, müssen Sie diese selbst kompilieren. Das EGOTEC Content Management benötigt das oci8 Modul. Das ältere ora Modul wird nicht unterstützt. su cd apt cache search php grep dev apt get php5 dev apt get source php5 Die komplette PHP5 Quellen befinden sich nun in einem Unterverzeichnis des aktuellen Verzeichnis. Wechseln Sie in dieses Verzeichnis und dort nach ext/oci8. cd ext/oci8 Führen Sie die folgenden Befehle nacheinander aus. phpize./configure make make install Das oci8 Modul befindet sich nun im PHP ext Verzeichnis. Editieren Sie die php.ini Datei und fügen Sie dort die Zeile zum einbinden der oci8 Treiber ein. extension=oci8.so Starten Sie den Apache Webserver neu und kontrollieren Sie, ob in der phpinfo() Ausgabe der oci8 Treiber erscheint. Die Zugangsdaten lauten: Benutzer: hr Passwort: hr Datenbank: XE Eventuell müssen Sie diesen Benutzer noch freischalten. Verwenden Sie hierfür die APEX Oberfläche: http://127.0.0.1:8080/apex/. EGOTEC GmbH 31/57

9.2. Linux allgemein 9. Oracle Linux allgemein Für die Installation eines Oracle Datenbankservers unter Linux sind folgende Voraussetzungen zu schaffen. GLIBC Paket Version 2.1 oder besser GCC Paket Version 3.2 oder besser Kernel Version 2.2 oder besser Einen WindowManager (KDE/Gnome) CD ROM Laufwerk Für den Oracle Datenbankserver muss ein separater Benutzer und Gruppen angelegt werden: groupadd dba groupadd oinstall useradd g oinstall G oinstall,dba m oracle Dies erstellt die erforderlichen Gruppen und den Benutzer Oracle. Vergeben sie nun dem Benutzer oracle ein Passwort: passwd oracle Nun wird noch das erforderliche Verzeichnis erstellt in den der Datenbankserver installiert wird und später mit $ORACLE_BASE zugegriffen werden kann. mkdir /home/oracle/db In diesem Fall ist der Installationsordner in dem home Verzeichnis des Oracle Benutzers. Nun kommt noch ein Ordner hinzu in dem die Datenbankdateien Installiert werden sollen. mkdir /home/oracle/db/product/version Hierbei ist "version" mit der Version von Oracle zu ersetzen. EGOTEC GmbH 32/57

9. Oracle Enviroment Variablen Nun müssen noch zwei Enviroment Variablen gesetzt werde. Diese in die.bash_profile des oracle Benutzers eintragen, damit diese immer nach der Anmeldung vorhanden sind. export ORACLE_BASE=/home/oracle/db export ORACLE_SID=test Das ORACLE_SID ist die Kennung mit der die Serverinstanz während der Installation gekennzeichnet wird. Um nun die Installation zu starten muss man sich nun als oracle Benutzer anmelden. Danach ist sicherzustellen, dass die oben gesetzten Enviroment Variablen auch bekannt sind. Dies kann man mit folgendem Befehl auslesen: set Nach dem dies getan ist kann man die Installation beginnen. Beachte: Die Installation kann nur unter einem WindowManager ausgeführt werden und nur mit dem oben angelegten Benutzer (oracle) der die Enviroment Variablen kennt. Um nun die Installation zu starten in das Hauptverzeichnis der CD 1 wechseln und das runinstaller Script ausführen oracle $./runinstaller Nach dem Welcome Screen wird das Verzeichnis für die Installationsdatien abgefragt EGOTEC GmbH 33/57

9. Oracle Der Angeben Pfad sollte mit dem gesetzten $ORACLE_BASE plus "orainventory" übereinstimmen. Die Gruppe ist die "oinstall" Gruppe die oben angelegt wurde. Nun kommt ein Popup dies besagt, dass ein Script als root ausgeführt werden soll. Merken Sie sich den Pfad zu diesem Script und führen Sie es ein einer Konsole in der sie als root angemeldet sind aus root # /tmp/orainstroot.sh Nach dem dieses ohne Fehlermeldung Durchgelaufen ist kann man im dem Popup auf "continue" klicken. Nun werden die File Locations abgefragt. EGOTEC GmbH 34/57

9. Oracle Hierbei ist nur der Path anzupassen. Passend zu dem oben (home/oracle/db/product/version) erstelltem Verzeichnis Der Datenbankserver soll installiert werden. Nach einem klick auf "Next" wir der Installations Typ abgefragt. Hier wird die "Enterprise Edition" ausgewählt. Danach kommt die "Database Configuration". Dort wählt man am Besten "General Purpose" aus. Außer man ist sich sicher es wird ein anderer Typ gebraucht. Nun kommt die Datenbankidentifikation. Unter diesem Namen ist die Datenbank zu erreichen bzw. wird die angesprochen. Hier wurde als Beispiel "test" gewählt. EGOTEC GmbH 35/57

9. Oracle Die SID ist die voreingestellt $ORACLE_SID. Das nun kommende Database File Location kann man so lassen wie es ist. Als "Database Character Set" im nächsten Screen wird "Use Unicode" ausgewählt. Damit ist man auf der sicheren Seite. Nach einem klick auf Next bekommt man nochmals ein Übersicht was alles installiert werden soll. Wenn alles Ok ist einfach auf "Install" klicken um die Installation der Dateien zu starten. Dieser Schritt kann eine weile dauern. Während der Installation kommt ein Popup. Das angegebene Script wieder als root ausführen. EGOTEC GmbH 36/57

Dieses Script fragt den Pfad zum lokalen "bin" Verzeichnis ab. Dies sollte richtig erkannt werden und man kann einfach Return drücken. Wenn dies nicht der Fall ist, dann geben Sie bitte den richtigen Pfad an. Wenn das Script erfolgreich ausgeführt worden ist, geht es mit einem klick auf "ok" in dem Popup weiter. Am Ende der Installation werden noch die "Configuration Tools" ausgeführt. Diese sollten alle ohne Fehlermeldung durchlaufen. Der "Database Configuration Assistent" wird nach Beendigung der Konfiguration nach den Passwörtern für den SYS und den SYSTEM Benutzer fragen. 9. Oracle Tragen Sie diese ein und beenden Sie dieses Fenster mit einem klick auf "ok" Mit einem klick auf "next" kommen sie zum Ende der Installation. Klicken Sie auf "exit" um die Installation zu beend Nun müssen noch ein Paar zusätzliche Enviroment Variablen gesetzt werden. Diese kommen wieder in die.bash_profile Datei des oracle Benutzers. export ORACLE_HOME=$ORACLE_BASE/product/version export ORACLE_TERM=xterm export LD_LIBARY_PATH=$LD_LIBARY_PATH:/$ORACLE_HOME export PATH=$PATH:$ORACLE_HOME/bin EGOTEC GmbH 37/57

Um nun die Oracle Datenbank starten und beenden zu können ist folgendes zu tun: 9. Oracle oracle$ sqlplus / nolog SQL> connect / as sysdba SQL> startup oracle$ sqlplus / nolog SQL> connect / as sysdba SQL> shutdown EGOTEC GmbH 38/57

9.3. Zugriff auf eine Oracle Datenbank 9. Oracle Zugriff auf eine Oracle Datenbank Um nun auf die Oracle Datenbank zuzugreifen muss PHP angepasst werden Es gibt zwei Möglichkeiten das PHP zu konfigurieren. Einmal wenn der Webserver direkt auf dem selben PC installiert ist > Direktzugriff oder der Oracleserver ist ein extra Rechner. 9.3.1. Direktzugriff Direktzugriff Das PHP muss mit der folgenden Option neu kompiliert werden../configure 'alle andernen Bestehende optionen' with oci8=$oracle_home Wobei $ORACLE_HOME durch dem Pfad zum oracle Installationsverzeichnis zu ersetzen ist. z.b.: with oci8=/home/oracle/db/product/9.2 Danach sollte in einer Datei die die Werte der PHPINFO(); Funktion ausgibt nach schauen ob dort oic8 vorkommt und dort der richtige ORACLE_HOME Pfad gesetzt ist. 9.3.2. Zugriff mit dem Instant Client Zugriff mit dem Instant Client Hierzu muss PHP auch neu kompiliert werden. Bevor dies aber gemacht wird muss der Instantclient installiert werden. Dieser kann unter www.oracle.com herunter geladen werden. PHP muss dann mit folgender Option kompiliert werden../configure *alle anderen bestehenden Optionen* with oci8=/pfad/zu/oracleinstantclient Danach sollte in einer Datei, die die Werte der PHPINFO(); Funktion ausgibt prüfen ob dort oic8 vorkommt. Nun muss noch auf der Clientseite die "tnsnames.ora" editieren: Test = (DESCRIPTION = (ADDRESS LIST= EGOTEC GmbH 39/57