Benutzer-Werkzeuge

Webseiten-Werkzeuge


prog:oracle_apex_install_windows_12c

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
prog:oracle_apex_install_windows_12c [2019/11/06 13:41]
gpipperr [Oracle Apex 5.0.4 ( 19.1) mit der Oracle Datenbank 12c (18c) - Installation]
prog:oracle_apex_install_windows_12c [2019/11/06 13:41] (aktuell)
gpipperr [Oracle Apex 5.0.4 ( 19.1) mit der Oracle Datenbank 12c (18c) - Installation]
Zeile 1: Zeile 1:
 +=====Oracle Apex 5.0.4 ( 19.2) mit der Oracle Datenbank 12c (18c/19c) - Installation=====
  
 +**Seit 12.July.2016 ist die Version 5.0.4 verfügbar, ab April 2019 die 19.1 , seit November 2019 die 19.2**
 +
 +Oracle Apex - Oracle Application Express ermöglicht es in der Datenbank deklarativ und auf Basis von SQL und PL/SQL komplexe Webanwendungen zu erstellen.
 +
 +Der gesamte Apex Code liegt dabei in der Datenbank und ist damit voll in die Oracle Welt integriert.
 +
 +Um die Webseite aufrufen zu können, ist allerdings ein Webserver notwendig. 
 +
 +Folgende Optionen sind hier möglich:
 +
 +  * [[prog:first_steps_oracle_rest_data_service|Oracle REST Data Services]] - früher auch Oracle Application Express Listener - Java  Implementierung, kann in einem J2EE compliant Web Server ausgeführt werden
 +  * Oracle HTTP Server with mod_plsql - Modul für den Apache Webserver für den Aufruf von PL/SQL Packages - gilt inzwischen unter 12c als veraltet 
 +  * Embedded PL/SQL Gateway in der Datenbank, damit kein externe Websever notwendig - der Oracle XML DB Protocol Server wird hier in der Datenbank aktiviert und verwendet - die einfachste Lösung
 +
 +
 +Bei der Installation kann unter der reinen notwendigen Apex Laufzeitumgebung (zum Beispiel für die produktive Umgebung) und der Apex Entwicklungsumgebung gewählt werden.
 +
 +Ist die 12c DBConsole im Einsatz, sind auch schon wichtige Einstellungen für die Verwendung des PL/SQL Gateway [[dba:oracle_12c_database_express|Die Oracle 12c Datenbank mit Oracle Database Express administrieren]] vorbereitet.
 +
 +
 +Vor der Installation darauf achten, ob nicht bereits Apex 4.x installiert ist!
 +
 +Wird das nicht benötigt und soll neu mit Apex 5 angefangen werden, zuvor die Version 4 einfach komplett deinstallieren!
 +
 +
 +----
 +
 +
 +==== Installation der Apex Development Umgebung mit dem Embedded PL/SQL Gateway in der Datenbank====
 +
 +Download Oracle Application Express 5.0.4 von http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
 +  * Oracle Application Express 5.0.4 - All languages - http://download.oracle.com/otn/java/appexpress/apex_5.0.4.zip
 +
 +Ablauf:
 +
 +
 +Software bereitstellen:
 +  * Zip apex_5.0.4.zip auspacken, zum Beispiel nach **d:\oracle\**
 +
 +
 +Version 4 entfernen:
 +
 +  * Prüfen ob die Version 4 oder gar noch 3 in der DB installiert ist!
 + 
 +  * Falls noch ein Apex 3 User wie APEX_030000 / FLOWS_030000 aus einer alten Umgebung existiert diesen mit drop user * cascade; löschen 
 +
 +  * falls ja , d.h. der User APEX_040200 existiert, diesen zuerst entfernen!
 +    * Dazu in das APEX 4 Home unter **$ORACLE_HOME\apex** wechseln
 +    * Datenbank Umgebung setzen und mit SQL*Plus als User mit sysdba Rechten an der Zieldatenbank anmelden<code sql>sqlplus / as sysdba
 +-- remove apex
 +@apxremov
 +
 +-- Flow User löschen falls noch exisiert, ansonsten Fehler ignorieren
 +drop user FLOWS_FILES cascade;
 +
 +-- APEX Public user löschen falls noch exisiert, ansonsten Fehler ignorieren
 +drop user APEX_PUBLIC_USER cascade;
 +
 +-- check if some synonyms are there
 +-- create DDL to drop old synonyms
 +select 'drop ' || decode(s.owner, 'PUBLIC', 'PUBLIC SYNONYM ', 'SYNONYM ' || s.owner || '.') || s.synonym_name || ';' as DELETE_ME
 + from dba_synonyms s
 +where table_owner like ('APEX_%') or table_owner like ('FLOW_%')
 +/
 +
 +</code>
 +Wird eine Container Database Umgebung verwandt, Apex aus der CDB löschen und pro PDP installieren, siehe dazu => https://blogs.oracle.com/UPGRADE/entry/apex_in_pdb_does_not
 +
 +
 +Bei Bedarf eigenen Tablespace für APEX anlegen, daran denken das mehr als 400 Tabellen angelegt werden, bei Uniform Tablespaces auf entsprechendes initial achten, wie z.b. 1MB.
 +
 +
 +Apex 5 neu installieren:
 +
 +  * Powershell Prompt öffnen und nach **d:\oracle\apex** wechseln
 +  * Datenbank Umgebung setzen und mit SQL*Plus als User mit sysdba Rechten an der Zieldatenbank anmelden <code powershell>sqlplus / as sysdba</code>
 +  * Aufruf des SQL Scripts für die Installation "@apexins.sql tablespace_apex tablespace_files tablespace_temp images" wie:<code sql>spool d:\temp\install_apex.log 
 +@apexins.sql SYSAUX SYSAUX TEMP /i/
 +
 +Timing für: Complete Installation
 +Abgelaufen: 00:21:19.59
 +
 +PL/SQL-Prozedur erfolgreich abgeschlossen.
 +
 +
 +Thank you for installing Oracle Application Express 5.0.4.00.12
 +
 +Oracle Application Express is installed in the APEX_050000 schema.
 +
 +The structure of the link to the Application Express administration services is as follows:
 +http://host:port/pls/apex/apex_admin (Oracle HTTP Server with mod_plsql)
 +http://host:port/apex/apex_admin     (Oracle XML DB HTTP listener with the embedded PL/SQL gateway)
 +http://host:port/apex/apex_admin     (Oracle REST Data Services)
 +
 +The structure of the link to the Application Express development interface is as follows:
 +http://host:port/pls/apex (Oracle HTTP Server with mod_plsql)
 +http://host:port/apex     (Oracle XML DB HTTP listener with the embedded PL/SQL gateway)
 +http://host:port/apex     (Oracle REST Data Services)
 +
 +
 +PL/SQL-Prozedur erfolgreich abgeschlossen.
 +
 +spool off</code> Laufzeit in meiner Testumgebung 21min (i7 Cpu SSD, 1,5 GB memory_target)
 +  * Erzeugtes Logfile auf Fehler prüfen
 +  * Bei der Installation werden drei neue Schemas angelegt:
 +    * **APEX_050000** - The account that owns the Oracle Application Express schema and metadata.
 +    * **FLOWS_FILES** - The account that owns the Oracle Application Express uploaded files.
 +    * **APEX_PUBLIC_USER** - The minimally privileged account is used for Oracle Application Express configuration with Oracle REST Data Services or Oracle HTTP Server and mod_plsql.
 +
 +Apex User konfigurieren:
 +
 +  * Den Instance Administrator - Master User für die Apex Verwaltung konfigurieren/Password setzen mit dem Script "apxchpwd.sql", das Password muss komplex sein! <code sql>@apxchpwd.sql</code> Anleitung beachten und Password auch gut merken .-)!
 + 
 +[[prog:first_steps_oracle_rest_data_service|ORDS]] vorbereiten:
 +
 +  * **APEX_LISTENER** und **APEX_PUBLIC_USER** User anlegen mit:<code sql>@apex_rest_config.sql</code>
 +  * **APEX_PUBLIC_USER** User entsperren<code sql>alter user APEX_PUBLIC_USER identified by APEX_PUBLIC_USER account unlock;</code> In der Produktion ein besseres Password wählen!!
 +
 +=> Nach diesem Schritten kann nun der ORDS installiert werden um auf Apex zuzugreifen => [[prog:first_steps_oracle_rest_data_service|Oracle ORDS 3.0 (Oracle REST Data Services) mit APEX 5.0 und als REST Interface verwenden]]
 +
 +Nur falls wirklich das Embedded PL/SQL Gateway verwandt werden soll:
 +
 +  * Embedded PL/SQL Gateway für den Aufruf der Webseiten mit den Script "apex_epg_config.sql " konfigurieren, dazu muss der Pfad in der das Apex Source Verzeichnis liegt angegeben werden:<code sql>@apex_epg_config.sql  d:\oracle</code> Das Script lädt die Bilder von Apex in die Datenbank, das dauert etwas.
 +  * Embedded PL/SQL Gateway  aktivieren <code sql>ALTER USER ANONYMOUS ACCOUNT UNLOCK;
 +-- http
 +SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;
 +exec DBMS_XDB.SETHTTPPORT(8080);
 +--https
 +select dbms_xdb_config.gethttpsport () from dual;
 +exec dbms_xdb_config.sethttpsport (5500);
 +
 + </code> 
 +  * Netzwerk Rechte vergeben :<code sql> 
 +BEGIN
 +    DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
 +        host => '*',
 +        ace => xs$ace_type(privilege_list => xs$name_list('connect'),
 +                           principal_name => 'apex_050000',
 +                           principal_type => xs_acl.ptype_db));
 +END;
 +/
 +</code> Nur in Testumgebungen! In Produktion feiner einstellen!
 +
 +  * An der Admin Oberfläche ( <nowiki>https://host:port/apex/apex_admin </nowiki> ) als Admin mit dem zuvor vergebenen Passwort anmelden.
 +
 +
 +Quellen => Installation : https://docs.oracle.com/cd/E59726_01/install.50/e39144/epg.htm#HTMIG29350
 +
 +===Probleme===
 +
 +<fc #800000>**Login nicht möglich ("The server xxx requires a username and password. The server says: XDB".)**</fc>
 +
 +
 +  * https://community.oracle.com/thread/643846
 +  * https://community.oracle.com/message/13055698
 +  * https://community.oracle.com/message/11155775#11155775
 +
 +In meinen Fall => darauf achten das nicht zuvor doch noch eine alte APEX Version in der DB installiert war!
 +Löschen:
 +<code sql>
 +DROP USER APEX_040200 CASCADE;
 +-- fehler???
 +--EXEC DBMS_NETWORK_ACL_ADMIN.DELETE_PRIVILEGE('power_users.xml', 'FLOWS_030000');
 +--
 +startup force
 +</code>
 +
 +
 +Nächste Problem beim Einsatz mit dem ORDS:
 +
 +<fc #800000>"There are issues with the configuration of the Static Files in your environment. Please consult the "Configuring Static File Support" section in the Application Express Installation Guide."</fc>
 +
 + see => https://community.oracle.com/message/13014173#13014173
 +
 +APEX_LISTENER und APEX_PUBLIC_USER User angelegt mit:<code sql>
 +@apex_rest_config.sql
 +</code>
 +
 +
 +User Passwörter in der ORDS Propertie Datei gepfegt und ORDS neu initialisert mit(im ORDS HOME):
 +<code cmd>
 + java -jar ords.war install
 +</code>
 +Anweisungen befolgen!
 +
 +Danach ist der Fehler verschwunden!
 +
 +
 +----
 +
 +==== Anmerkungen zu Installation auf einer neuen Oracle XE 11g Installation====
 +
 +Leider steht die 12c noch nicht als XE Edition zur Verfügung.
 +
 +Nach der XE Installation wird sofort die bestehende Apex (APEX_040000) Umgebung auf die 5.03 Apex Umgebung gehoben.
 +
 +Da es sich um eine neuen Umgebung handelt wird Apex gelöscht und neu installiert
 +
 +Apex Download apex_5.0.3.zip nach C:\oracle\apex (=APEX_HOME) entpackt.
 +
 +
 +APEX User und alle alten Synonyme zuvor unbedingt löschen:
 +<code sql>
 +
 +-- sauber entfernen:
 +cd C:\oracle\apex
 +
 +sqlplus / as sysdba
 +
 +@apxremov.sql
 +
 +
 +--pürfen und dann bei Bedarf "Reste" löschen
 +--drop the user
 +-- nur bei Bedarf den User DROP USER APEX_040200 CASCADE;
 +
 +--create DDL to drop old synonyms
 +select 'drop ' || decode(s.owner, 'PUBLIC', 'PUBLIC SYNONYM ', 'SYNONYM ' || s.owner || '.') || s.synonym_name || ';' as DELETE_ME
 + from dba_synonyms s
 +where table_owner in ('APEX_040200')
 +/
 +-- execute the DDL
 +
 +</code>
 +Im ersten Versuch nur den alten Apex User gelöscht, allerdings gabe es dann erhebliche Probleme mit der Neuinstallation mit ungültigen Synoymen.
 +
 +
 +Neu installieren:
 +<code sql>
 +cd C:\oracle\apex
 +
 +sqlplus / as sysdba
 +
 +-- Install
 +
 +@apexins.sql SYSAUX SYSAUX TEMP /i/
 +
 +...
 +Thank you for installing Oracle Application Express 5.0.3.00.03
 +
 +Oracle Application Express is installed in the APEX_050000 schema.
 +
 +The structure of the link to the Application Express administration services is as follows:
 +http://host:port/pls/apex/apex_admin (Oracle HTTP Server with mod_plsql)
 +http://host:port/apex/apex_admin     (Oracle XML DB HTTP listener with the embedded PL/SQL gateway)
 +http://host:port/apex/apex_admin     (Oracle REST Data Services)
 +
 +The structure of the link to the Application Express development interface is as follows:
 +http://host:port/pls/apex (Oracle HTTP Server with mod_plsql)
 +http://host:port/apex     (Oracle XML DB HTTP listener with the embedded PL/SQL gateway)
 +http://host:port/apex     (Oracle REST Data Services)
 +....
 +-- Images - 
 +-- nur  C:\oracle vom APEX_HOME angeben !!!, Rest wird ergänzt
 +@apex_epg_config.sql d:\oracle\
 +
 +..
 +. Loading images directory: d:\oracle\apex5/images
 +..
 +
 +-- Password setzen
 +@apxchpwd.sql
 +
 +
 +--Rest Service api vorbereiten
 +@apex_rest_config.sql
 +
 +
 +--Port pürfen
 +
 +SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;
 +
 +-- bei Bedarf setzen
 +EXEC DBMS_XDB.SETHTTPPORT(8080);
 +
 +
 +-- Prüfen ob ein Dispatcher für die XDB zur Verfügung steht und der Local Listener Parameter eingerichtet ist:
 +
 +show parameter dispatchers
 +
 +
 +NAME                                 TYPE        VALUE
 +------------------------------------ ----------- ------------------------------
 +dispatchers                          string
 +
 +
 +-- falls nicht konfiguriert, <sid>XDB einstellen
 +alter system set dispatchers='(PROTOCOL=TCP) (SERVICE=XEXDB)' scope=both sid='*';
 +
 +
 +-- Den Local Listner Parameter einstellen falls nicht gesetzt
 +alter system set local_listener='10.10.10.110:1521' scope=both sid='*';
 +
 +-- neustarten, falls es immer noch nicht funktioniert
 +startup force
 +</code>
 +
 +Nach der Installation ist wieder der Standard HTTP Port 8080 gesetzt, theoretisch sollte dann ein Aufruf über <nowiki>https://host:port/apex/apex_admin </nowiki> möglich sein.
 +
 +Alternativ ORDS [[prog:first_steps_oracle_rest_data_service|Oracle ORDS 3.0 (Oracle REST Data Services) mit APEX 5.0 und als REST Interface verwenden]] einsetzen.
 +
 +
 +Sollte sich nun in der Datenbank ein ungültiges Objekt <fc #800000>sys.htmldb_system</fc> befinden => siehe Metalink Node: HTMLDB_SYSTEM Package is Invalid After Removing APEX (Doc ID 1231863.1), hier wird das Package einfach gelöscht.
 +
 +
 +----
 +
 +
 +==== Quellen ====
 +
 +
 +  * http://www.oracle.com/technetwork/developer-tools/apex/documentation/index.html
 +
 +
 +APEX:
 +
 +  * http://docs.oracle.com/cd/E59726_01/doc.50/e39147/toc.htm
"Autor: Gunther Pipperr"
prog/oracle_apex_install_windows_12c.txt · Zuletzt geändert: 2019/11/06 13:41 von gpipperr