Austrian Competence Center for Oracle APEX

Wer mit einer Oracle XE Datenbank arbeitet, wird meistens APEX mit dem Embedded PL/SQL Gateway verwenden. Dazu gab es vor einiger Zeit schon eine Installationsanleitung auf unserem Blog. Es gibt aber durchaus Anwendungsfälle, wo die Vorteile eines HTTP Servers gefragt sind.

Für diese Konstellation findet sich keine Anleitung zur Installation, also braucht es etwas Geschick und noch mehr Geduld bis APEX auf einer Oracle XE Datenbank mit einem Oracle HTTP Server läuft.

Um anderen diesen Schritt zu erleichtern gibt es hier nun eine komplette Installationsanleitung. Als Hinweis sei noch zu erwähnen, dass die Anleitung für ein Microsoft Windows (32-bit) Betriebssystem erstellt wurde.

1. Oracle XE hier downloaden

Wir empfehlen die Oracle Database 10g Express Edition (Universal): OracleXEUniv.exe

2. Oracle XE Installation laut Oracle Installationsanleitung durchführen.

Überprüfen Sie zuerst die Requirements zur Oracle XE Installation

Zur Installation von Server und Client Komponenten am selben Rechner, führen Sie die Installation wie in Kapitel “4.1 Performing a Graphical User Interface Installation of the Server” beschrieben durch.

3. APEX Download

Downloaden von Oracle Application Express

4. Orache HTTP Server Download

Oracle HTTP Server Oracle HTTP Server (Apache 2.0) (10.1.3.3.0) for Microsoft Windows (32-bit)

5. APEX Download Zip entpacken

im Oracle XE Ordner als Unterordner apex.

6. OHS Download Zip entpacken

Dieser Ordner kann nachher wieder gelöscht werden.

7. APEX Installations Requirements

Vor der Installation sind  die APEX Installations Requirements zu beachten. Auf jeden Fall ist das PL/SQL Web Toolkit upzudaten. In den Requirements wird auf die Datei README.txt im Ordner …/apex/owa verwiesen.

Anleitung zum Upgrade des Web Toolkits

In den Ordner …/apex/owa wechseln und als SYS User Sqlplus starten:

sqlplus /nolog
connect sys as sysdba
[sys passwort eingeben]
select owa_util.get_version from dual;

Ist die Version kleiner als 10.1.2.0.6, was nach der Oracle XE Installation der Fall ist, wird upgegraded:
@owainst.sql

Wenn der Upgrade fertig ist, noch einmal die Version überprüfen, soll jetzt 10.1.2.0.6 sein:

select owa_util.get_version from dual;

8. APEX Installation laut Oracle Application Express Installation Guide Release 3.2

Weiter mit der APEX Installation laut Anleitung. Die relevanten Punkte aus der Anleitung sind hier noch einmal aufgelistet.

Installation Oracle Application Express:

sqlplus /nolog
connect sys as sysdba
[sys passwort eingeben]
@apexins SYSAUX SYSAUX TEMP /i/

Die Installation dauert eine Weile, währenddessen wenden wir uns der OHS Installation zu.

9. OHS Installation

Im entpackten Ordner Disk1 befindet sich die Datei setup.exe. Diese ist mit Doppelklick zu starten, danach folgen Sie dem Installationsdialog.
Wichtig: Bei Angabe des Pfades bitte ein neues Oracle Home Verzeichnis angeben, auf keinen Fall das Oracle Home Verzeichnis der Datenbankinstallation verwenden.
Am Ende der Installation zeigt der Installer folgende Informationen an, diese bitte kopieren/merken.

The following information is available in: C:\OraAsHome_1\install\setupinfo.txt —————————————– Use the following URL to access the Oracle HTTP Server and the Welcome Page: http://172.16.10.100:7777 —————————————– Use the following URL to access the Oracle Enterprise Manager Application Server Control: http://172.16.10.100:1810

Rufen Sie versuchsweise den Link für die „Oracle HTTP Server and the Welcome Page“ auf.

10. Weiter gehts mit der APEX Installation

ADMIN Account Passwort setzen:
sqlplus /nolog
connect sys as sysdba
[sys passwort eingeben]
@apxchpwd

Unlock APEX_PUBLIC_USER Account:
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

APEX_PUBLIC_USER Account Passwort setzen:
ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;

Images Ordner kopieren:
Den kompletten Ordner …/oraclexe/apex/images ins OHS Home Verzeichnis …/[ORACLE_HTTPSERVER_HOME]/ohs/images kopieren.

Datei dads.conf editieren:

# ============================================================================ # Note: This file should typically be included in your plsql.conf file with # the “include” directive. # Hint: You can look at some sample DADs in the dads.README file # ============================================================================ Alias /i/ “C:/OraAsHome_1/ohs/images/” AddType text/xml xbl AddType text/x-component htc <Location /pls/test> SetHandler pls_handler Order deny,allow Allow from all AllowOverride None PlsqlDatabaseUsername APEX_PUBLIC_USER PlsqlDatabasePassword PASSWORT PlsqlDatabaseConnectString 127.0.0.1:1521:XE SIDFormat PlsqlDefaultPage apex PlsqlDocumentTablename wwv_flow_file_objects$ PlsqlDocumentPath docs PlsqlDocumentProcedure wwv_flow_file_mgr.process_download PlsqlAuthenticationMode Basic PlsqlRequestValidationFunction www_flow_epg_include_modules.authorize PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8 PlsqlErrorStyle DebugStyle </Location>

11. Stop und Restart Oracle HTTP Server

Nachdem die Datei dads.conf gespeichert wurde, ist der Oracle HTTP Server zu stoppen und zu restarten. Das passiert auf der Commandline in einer DOS Box.
Wechseln Sie in das Verzeichnis [ORACLE_HTTPSERVER_HOME]\opmn\bin\

Stoppen des OHS mit dem Befehl
opmnctl stopproc ias-component=HTTP_Server

Starten des OHS mit dem Befehl
opmnctl startproc ias-component=HTTP_Server

Mit dem Befehl opmnctl status sehen Sie die laufenden Prozesse – in dem Fall soll es genau einer sein.

12. Anlegen eines APEX Workspace

Jetzt sehen wir zum ersten Mal wie APEX mit dem OHS läuft. Geben Sie im Browser die Adresse ein
http://hostname:port/pls/test

hostname und port sind der host und port die bei der OHS Installation ausgegeben wurden, /pls/test ist die Location die in der Datei dads.conf definiert ist.

In diesem Beispiel ist das http://172.16.10.100:7777/pls/test

Legen Sie den Workspace und User laut Oracle APEX Anleitung an

Damit ist die Installation abgeschlossen und Sie können mit APEX und OHS wie gewohnt arbeiten!