Bitte immer die Oracle universal Version verwenden, damit UTF-8 Unterstützung gegeben ist.

Transkript

1 Oracle Beim Setup geben Sie im Eingabefeld "Host" den ORACLE_HOME Pfad ein, so müssen Sie diesen nicht in der Apacheumgebung einbinden. Bei einer Client-Installation könnte dieser so aussehen: /usr/lib/oracle/xe/app/oracle/product/10.2.0/client/ Bei einer Server-Installation auf Windows könnte dieser so aussehen: C:\oraclexe\app\oracle\product\10.2.0\server\ Bei einer XE Installation geben Sie als Datenbank "//localhost/xe" an. Bitte immer die Oracle universal Version verwenden, damit UTF-8 Unterstützung gegeben ist. XE Windows Bitte immer die Oracle universal Version verwenden ( Oracle Database 10g Express Edition (Universal)). Für eine Testinstallation verwenden Sie die XE Edition "OracleXEUniv.exe". Die Installation kann einige Minuten dauern. Bitte lassen Sie die Auswahl "Datenbank Webfrontend starten" zum Ende der Installation aktiv und fügen Sie "localhost" resp. " " den vertrauten Webseiten des Internet Explorers hinzu. Melden Sie sich als Benutzer "SYSTEM" mit dem von Ihnen während der Installation festgelegten Passwort an. Legen Sie über "Administration" => "Datenbankbenutzer" => "Benutzer erstellen" einen neuen Benutzer mitsamt Tablespace an.

2 Geben Sie dem Benutzer die Berechtigung zum anlegen von Tabellen, Ansichten, Prozeduren, Sequenzen und Trigger. Mit diesem Benutzer können Sie nun das EGOTEC Content Management System installieren. Bei Windows Server 2008 muss Oracle als lokaler Administrator installiert werden. Eventuell darf dazu die Rolle Active Directory nicht installiert sein. Oracle XE auf Debian & Ubuntu Am einfachsten lässt sich die Express Edition von Oracle mit apt-get installieren. Tragen Sie hierzu in die Software-Quellen (/etc/apt/sources.list) folgende Zeile ein. deb unstable main non-free Danach führen Sie folgendes in der Kommandozeile aus: # sudo su - # wget -O- apt-key add - # apt-get update # apt-get install oracle-xe-universal Eventuell noch benötigte Bibliotheken wie 'libaio' oder 'bc' werden, falls noch nicht vorhanden, automatisch installiert. Danach muss die Datenbank nich konfiguriert werden. # /etc/init.d/oracle-xe configure Oracle Database 10g Express Edition Configuration

3 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: Do you want Oracle Database 10g Express Edition to be started on boot (y/n) [y]: Starting Oracle Net Listener...Done Configuring Database...Done Starting Oracle Database 10g Express Edition Instance...Done Installation Completed Successfully. To access the Database Home Page go to " Nachdem man bei allen Fragen die Standardeinstellung übernommen hat, legt man mit der Weboberfläche ( noch einen Benutzer an. Bevor man das EGOTEC CMS nun mit Oracle installieren kann, muss auch das oci8 PHP Modul aktiviert sein. Linux (ohne Paketmanager) 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

4 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. 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.

5 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 Der Angeben Pfad sollte mit dem gesetzten $ORACLE_BASE plus "orainventory" übereinstimmen.

6 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.

7 Hierbei ist nur der Path anzupassen. Passend zu dem oben (home/oracle/db/product/version) erstelltem Verzeichnis

8 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. Die SID ist die voreingestellt $ORACLE_SID. Das nun kommende Database File Location kann man so lassen wie es ist.

9 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. 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.

10 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 Um nun die Oracle Datenbank starten und beenden zu können ist folgendes zu tun: oracle$ sqlplus / nolog

11 SQL> connect / as sysdba SQL> startup oracle$ sqlplus / nolog SQL> connect / as sysdba SQL> shutdown oci8 PHP Modul Jetzt müssen Sie noch Oracle und PHP verbinden. Hierzu ist das PHP Modul oci8 zu installieren. Leider liegt dieses nicht vorkompiliert oder gar als.deb Paket vor. Oracle Instant Client installieren Falls Sie die Oracle Datenbank auf dem Webserver installiert haben, können Sie direkt das oci8 PHP Modul kompilieren. Ubuntu / Debian: Erweitern Sie die Quellen indem Sie deb unstable main non-free der Datei /etc/apt/source.list anhängen. Dann kann der Client wie folgt installiert werden: apt-get update apt-get install oracle-xe-client Andere Linux-Distributionen: Laden sie die Basic und SDK Pakete des Oracle Instant Client von herunter. Um die Verbindung zu testen, kann man auch noch SQL Plus installieren. Erstellen Sie das Verzeichnis /opt/oracle/instantclient, in das Sie die Oracle Instant Client Archive entpacken. # mkdir -p /opt/oracle/instantclient # cd /opt/oracle/instantclient # unzip instantclient-basic-linux zip # unzip instantclient-sdk-linux zip Alle:

12 Nun müsen noch symbolische Links in dem neuen Verzeichnis angelegt werden. # ln -s libclntsh.so.10.1 libclntsh.so # ln -s libocci.so.10.1 libocci.so Außerdem muss noch der Oracle Bibliothekspfad bekannt gegeben werden. # sudo vi /etc/ld.so.conf.d/oracle.conf /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib # sudo ldconfig Modul kompilieren Um das PHP Modul kompilieren zu können, werden die PEAR Pakete und PHP5 Quellen benötigt. # apt-get install php-pear php5-dev # pecl install oci8 Bei der Frage nach dem ORACLE_HOME Verzeichnis geben Sie entweder das Verzeichnis der Datenbankinstallation "/usr/lib/oracle/xe/app/oracle/product/10.2.0/server" oder im Falle des Oracle Instant Client das Verzeichnis "/usr/lib/oracle/xe/app/oracle/product/10.2.0/client" bzw. "instantclient,/opt/oracle/instantclient" an. Geben Sie zuvor "all" ein, um die Einstellung vornehmen zu können. Jetzt müssen Sie nur noch das Modul oci8.so in der php.ini aktivieren, wo sich diese befindet, erfahren Sie am besten aus der phpinfo, und den Apache neu starten. # echo "extension=oci8.so" >> /etc/php5/apache2/php.ini # echo "extension=oci8.so" >> /etc/php5/cli/php.ini # ldconfig /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib # apache2ctl restart Sie können natürlich auch einen Texteditor Ihrer Wahl verwenden. Über die phpinfo Ausgabe können Sie kontrollieren, ob die Konfiguration funktioniert.

13 Mit Hilfe des folgenden PHP Skripts können Sie prüfen, ob die Verbindung mit Oracle funktioniert: <?php putenv('oracle_home=/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/'); $oracle = oci_connect('egotec', 'egotec', '//localhost/xe'); if (!$oracle) { $e = oci_error(); print htmlentities($e['message']); exit; }?> <h1>oracle Verbindung</h1> APACHE konfigurieren damit oci8 immer mit gestartet wird # sudo vi /etc/ld.so.conf.d/oracle.conf dort folgenden Inhalt einfügen: # libc default configuration /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/lib und speichern Direktzugriff 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.:

14 --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. 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 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 oci8 vorkommt. Nun muss noch auf der Clientseite die "tnsnames.ora" editieren: Test = (DESCRIPTION = (ADDRESS LIST= (ADDRESS = (PROTOCOL = TCP)(HOST = IP)(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEICATED) (SERVICE_NAME = $ORACLE_SID) ) ) IP muss mit der IP des Rechners auf dem die Oracle Datenbank server läuft ersetzt werden sowie $ORACLE_SID mit der SID des Datenbankservers. Zend Core for Oracle 2.5 Die folgenden PHP Erweiterungen müssen in der php.ini noch aktiviert werden: extension=php_tidy.dll Bitte kopieren Sie aus dem allgmeinen PHP Binary Archiv die folgenden DLLs in das Verzeichnis Extensionverzeichnis "C:\Program Files\Zend\Core for Oracle\lib\phpext" und aktivieren Sie diese in der php.ini. php_mime_magic.dll

15 Bitte starten Sie den Apache nach den Änderungen neu. Zend Core bis einschließlich Version 2.5 verwendet unter Windows und Apache die CGI Schnittstelle. Über diese Schnittstelle können nicht alle Funktionen des EGOTEC Content Management Systems abgerufen werden. Z.B. ist der Zugriff über WebDAV nicht möglich.