Beispiel Konfiguration OracleAS 10g R2. für. Oracle Portal

Transkript

1 Beispiel Konfiguration OracleAS 10g R2 für Autor: Niels de Bruijn Erstelldatum: Version: 1.0 Anzahl der Seiten: 13 Dateiname: Status: Beispiel Konfiguration OracleAS 10g R2 für.doc Final Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 1 von 13

2 Dokumentenhistorie Datum Autor Version Status Änderungen Niels de Bruijn 1.0 Final Initiales Dokument Revisionshistorie Datum Name Bemerkungen Verteiler Name Firma Interessenten DOAG Projektablageort Projektserver Projektverzeichnis Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 2 von 13

3 1 IST- / SOLL-KONFIGURATION ANNAHMEN Haftungshinweise Umgebungsskripte Host Datei Betriebssystem Verzeichnisse Ports DIE ANMELDUNG ÜBER SSL MIT PORT 443 KONFIGURIEREN Oracle HTTP Server für SSL freischalten Den Port von 4443 auf 443 setzen Den HTTP Server erneut beim SSO Server registrieren SSO Server konfigurieren SSL Zertifikat installieren PORTAL AUF PORT 80 KONFIGURIEREN Die Webcache-Konfiguration anpassen Einträge des Middle Tiers im SSO Server erneut registrieren Einen Virtual Host im HTTP Server hinzufügen Webcache-Verbindungsdaten für Portal über OEM anpassen Gespeicherte OID Daten für Portal aktualisieren...13 Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 3 von 13

4 1 Ist- / Soll-Konfiguration Oracle Application Server 10g R2 (OracleAS) wurde auf einem Server mit Red Hat Linux Enterprise Server installiert. ist über Port 7778 zu erreichen und die Anmeldung findet über den Port 7777 unverschlüsselt statt. Für den Produktivbetrieb ist diese Konfiguration des Application Servers oft nicht erwünscht. Meist muss die Datenübertragung bei der Anmeldung verschlüsselt stattfinden und es sollten immer Standard Ports für die Kommunikation mit Oracle Application Server verwendet werden. Dieses Dokument beschreibt zuerst die Konfigurationsschritte in Oracle Application Server, die notwendig sind, um die Anmeldung nur über eine verschlüsselte Verbindung zu gestatten. Anschließend werden alle Schritte aufgelistet, um das Portal auf Port 80 zu konfigurieren. URLs nach einer Installation von OracleAS: Anmeldung: Portal: URLs nach der Konfiguration in OracleAS: Anmeldung: Portal: Abbildung 1: Zielkonfiguration des Servers myportal.mycompany.com Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 4 von 13

5 2 Annahmen 2.1 Haftungshinweise Dieses Dokument beschreibt lediglich eine fiktive Möglichkeit der Konfiguration von OracleAS 10g R2 nachdem es auf einem Server installiert wurde. Der Administrator ist selber dafür verantwortlich, zu entscheiden, ob und wie die einzelnen Befehle eingesetzt werden. In keinem Fall haftet die MT AG für irgendwelche direkten, indirekten, speziellen oder sonstigen Folgeschäden, die sich aus der Nutzung dieses Dokument ergeben. Ausgeschlossen ist auch jegliche Haftung für entgangenen Gewinn, Betriebsunterbrechung, Verlust von Programmen oder sonstigen Daten. Dies gilt auch dann, wenn ausdrücklich auf die Möglichkeit solcher Schäden hingewiesen wird. 2.2 Umgebungsskripte Es wird vorausgesetzt, dass die folgenden Skripte auf dem Server vorhanden sind: infra.env: #.bash_profile # Get the aliases and functions if [ -f ~/.bashrc ]; then. ~/.bashrc fi # User specific environment and startup programs export ORACLE_BASE=/as10gr2 export ORACLE_HOME=$ORACLE_BASE/infra export ORACLE_SID=asdb export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$ORACLE_HOME/ctx/lib:$ORACLE_HOME/jre/1.4.2/lib/i386/server:$ORACLE_HOME/jre/1.4.2/lib/i386/native_threads:$ORACLE_HOME/perl/lib/site_perl/5.6.1/i686- linux:/usr/lib:/usr/x11r6/lib export PATH=$ORACLE_HOME/dcm/bin:$ORACLE_HOME/bin:.:$ORACLE_HOME/ldap/odi/bin:$ORACLE_HOME/perl/bin:.:$PATH:$ORACLE_HOME/opmn/bin:$ORACLE_HOME/jdk/bin export DISPLAY=:13.0 unset USERNAME umask 022 export PS1="\w"'@Infra> ' set -o emacs alias b='cd $ORACLE_BASE' alias o='cd $ORACLE_HOME' alias n='cd $ORACLE_HOME/network/admin' alias a='cd $ORACLE_HOME/Apache/Apache' mid.env: #.bash_profile # Get the aliases and functions if [ -f ~/.bashrc ]; then. ~/.bashrc fi # User specific environment and startup programs Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 5 von 13

6 export ORACLE_BASE=/as10gr2 export ORACLE_HOME=$ORACLE_BASE/mid export ORACLE_SID=asdb export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$ORACLE_HOME/ctx/lib:$ORACLE_HOME/jre/1.4.2/lib/i386/server:$ORACLE_HOME/jre/1.4.2/lib/i386/native_threads:$ORACLE_HOME/perl/lib/site_perl/5.6.1/i686- linux:/usr/lib:/usr/x11r6/lib export PATH=$ORACLE_HOME/dcm/bin:$ORACLE_HOME/bin:.:$ORACLE_HOME/ldap/odi/bin:$ORACLE_HOME/perl/bin:.:$PATH:$ORACLE_HOME/opmn/bin:$ORACLE_HOME/jdk/bin export DISPLAY=:13.0 unset USERNAME umask 022 export ' set -o emacs alias b='cd $ORACLE_BASE' alias o='cd $ORACLE_HOME' alias n='cd $ORACLE_HOME/network/admin' alias a='cd $ORACLE_HOME/Apache/Apache' 2.3 Host Datei Inhalt der Datei /etc/hosts: localhost.localdomain localhost myportal.mycompany.com myportal Alle Oracle Dienste laufen auf einer internen IP-Adresse. Aufgrund dessen kann der Server problemlos in ein anderes Netzwerk umgezogen werden, ohne dass Konfigurationsschritte in Oracle Application Server notwendig sind. 2.4 Betriebssystem Als Betriebssystem wurde Red Hat Enterprise Linux Server 4 verwendet. Als Alternative kann auch das Betriebssystem Suse Linux Enterprise Server 9 eingesetzt werden. 2.5 Verzeichnisse ORACLE_BASE: ORACLE_HOME_INFRA_TIER: ORACLE_HOME_MIDDLE_TIER: /as10gr2 /as10gr2/infra /as10gr2/mid Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 6 von 13

7 2.6 Ports HTTP Server Infra Tier (Listen/Port): 7777 HTTP Server Middle Tier (Listen): 7779 HTTP Server Middle Tier (Port): 7778 Webcache: 7778 Webcache-Administration: 9400 Application Console Middle Tier: 1810 Nach der Installation kann über die Datei <ORACLE_HOME>/install/portlist.ini herausgefunden werden, welche Ports Oracle Application Server tatsächlich verwendet. 3 Die Anmeldung über SSL mit Port 443 konfigurieren Nach der Ausführung dieses Kapitels erfolgt die Anmeldung beim Single Sign-On Server und die Benutzerverwaltung für das Portal über die Adresse Zuerst als Benutzer oracle anmelden und die Umgebungsvariablen setzen: su oracle. infra.env 3.1 Oracle HTTP Server für SSL freischalten Die Datei $ORACLE_HOME/opmn/conf/opmn.xml wie folgt anpassen: Die Zeile: <data id="start-mode" value="ssl-disabled" /> wie folgt anpassen: <data id="start-mode" value="ssl-enabled" /> Die Infra Tier neu starten: $ORACLE_HOME/opmn/bin/opmnctl reload $ORACLE_HOME/opmn/bin/opmnctl stopall $ORACLE_HOME/opmn/bin/opmnctl startall Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 7 von 13

8 Überprüfe jetzt folgende URLs: Den Port von 4443 auf 443 setzen Die Datei $ORACLE_HOME/Apache/Apache/conf/ssl.conf anpassen und folgende Zeilen für den Virtual Host hinzufügen: RewriteEngine On RewriteOptions Inherit In dieser Datei überall die Portangabe von 4443 auf 443 setzen. Ehe Prozesse durch den Benutzer oracle auf einem Port unter 1024 gestartet werden können, muss der Benutzer root die Ausführung explizit erlauben: cd $ORACLE_HOME/Apache/Apache/bin su root chown root.apachectl chmod 6750.apachectl exit Das Repository aktualisieren und den HTTP Server neu starten: $ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs -d v $ORACLE_HOME/opmn/bin/opmnctl stopproc process-type=http_server $ORACLE_HOME/opmn/bin/opmnctl startproc process-type=http_server Folgende URLs können jetzt überprüft werden: (Eine Anmeldung mit dieser Adresse ist an dieser Stelle noch nicht möglich) 3.3 Den HTTP Server erneut beim SSO Server registrieren Die bestehende Registrierung sollte zuerst gelöscht werden. Dafür meldet man sich beim SSO Server an ( und löscht den Eintrag für die Infrastructure Tier. Den HTTP Server mit der neuen Adresse erneut beim SSO Server registrieren: $ORACLE_HOME/sso/bin/ssoreg.sh -oracle_home_path $ORACLE_HOME -site_name myportal.mycompany.com:443 -config_mod_osso TRUE -mod_osso_url Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 8 von 13

9 -virtualhost Die Konfigurationsänderungen mit dem Repository abgleichen und den HTTP Server neu starten: $ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs -d v $ORACLE_HOME/opmn/bin/opmnctl stopproc process-type=http_server $ORACLE_HOME/opmn/bin/opmnctl startproc process-type=http_server Der Aufruf von folgender URL, inklusive die Anmeldung, kann jetzt getestet werden: Im Oracle Internet Directory (OID) muss die alte URL durch die neue URL ersetzt werden: $ORACLE_HOME/bin/oidadmin starten, anmelden mit orcladmin und die URL unter folgende Knoten anpassen in dn:cn=operationurls,cn=das,cn=products,cn=oraclecontext 3.4 SSO Server konfigurieren Der Single Sign-On (SSO) Server muss auf Port 443 umkonfiguriert werden: $ORACLE_HOME/sso/bin/ssocfg.sh https myportal.mycompany.com 443 Als Test kann man den SSO Server über die folgende URL aufrufen: SSL Zertifikat installieren Als letzter Schritt muss das SSL Zertifikat installiert werden. Wie man ein Zertifikat anfordert und im Oracle Wallet Manager importiert, ist bereits im Metalink Note ausführlich beschrieben. Das Ergebnis dieses Vorgangs ist die Datei ewallet.p12, welche in das folgende Verzeichnis kopiert wird: $ORACLE_HOME/owm/wallets/myportal.mycompany.com Jetzt Oracle Wallet Manager starten: owm Die Datei ewallet.p12 öffnen und unter Wallet > Automatische Anmeldung ein Häkchen setzen. Danach das Wallet speichern und das Programm verlassen. Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 9 von 13

10 Der HTTP Server muss noch informiert werden, wo das Wallet abgelegt ist. Dafür wird die Datei $ORACLE_HOME/Apache/Apache/conf/ssl.conf geöffnet und wird die Zeile mit SSLWallet geändert in: SSLWallet file:/as10gr2/infra/owm/wallets/myportal.mycompany.com Das Repository aktualisieren und den HTTP Server neu starten: $ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs -d v $ORACLE_HOME/opmn/bin/opmnctl restartproc process-type=http_server Der Aufruf von folgender URL, inklusive die Anmeldung, kann jetzt getestet werden: Eine Warnung wegen eines ungültigen Zertifikats wird jetzt nicht mehr angezeigt. Hinweis Direkt nach der Anmeldung kann es vorkommen, dass der Browser einen Sicherheitshinweis wegen der Umschaltung von HTTPS auf HTTP abgibt. Dieses Verhalten ist jedoch normal. Möchte man diesen Hinweis umgehen, dann muss auch auf SSL konfiguriert werden. 4 Portal auf Port 80 konfigurieren Nach der Ausführung dieses Kapitels kann mit über die Adresse gearbeitet werden. Zuerst als Benutzer oracle anmelden und die Umgebungsvariablen setzen: su oracle. mid.env Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 10 von 13

11 4.1 Die Webcache-Konfiguration anpassen Zuerst muss der Benutzer oracle noch erlaubt werden, um Webcache auf Port 80 zu starten: opmnctl stopproc ias-component=webcache su root export ORACLE_HOME=/as10gr2/mid $ORACLE_HOME/webcache/bin/webcache_setuser.sh setroot oracle exit opmnctl startproc ias-component=webcache Im Browser Oracle Webcache-Administrator aufrufen: - Den Port unter 'Listen port' auf 80 umstellen. - Unter 'Site Definitions' den Port in 80 und den Hostname in myportal.mycompany.com ändern. - Unter 'Site-to-Server Mapping' in der ersten Zeile den Hostnamen in myportal.mycompany.com mit Port 80 ändern und in der zweiten Zeile den Port auf 80 umstellen. - Um überflüssige Fehlermeldungen in der Logdatei von Webcache zu vermeiden, sollte unter 'Origin Server Wallet' das Verzeichnis auf /as10gr2/mid/webcache/wallets/default gesetzt werden. Neu starten: opmnctl stopproc ias-component=webcache opmnctl startproc ias-component=webcache 4.2 Einträge des Middle Tiers im SSO Server erneut registrieren Beim SSO Server anmelden ( und die Einträge für die Middle Tier, Portal und Wireless entfernen. Oracle HTTP Server mit der neuen Adresse erneut beim SSO Server registrieren: cd $ORACLE_HOME/Apache/Apache/conf/osso mkdir myportal.mycompany.com $ORACLE_HOME/sso/bin/ssoreg.sh -oracle_home_path $ORACLE_HOME -site_name myportal.mycompany.com:80 -config_mod_osso TRUE -mod_osso_url -virtualhost -config_file $ORACLE_HOME/Apache/Apache/conf/osso/myportal.mycompany.com/osso.conf Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 11 von 13

12 mit der neuen Adresse erneut beim SSO Server registrieren: $ORACLE_HOME/portal/conf/ptlconfig -dad portal -sso -host myportal.mycompany.com -port 80 Oracle Wireless mit der neuen Adresse erneut beim SSO Server registrieren: $ORACLE_HOME/wireless/bin/reRegisterSSO.sh $ORACLE_HOME "cn=orcladmin" 4.3 Einen Virtual Host im HTTP Server hinzufügen Die Datei $ORACLE_HOME/Apache/Apache/conf/httpd.conf um folgende Zeilen ergänzen: NameVirtualHost *:7779 <VirtualHost *:7779> ServerName myportal.mycompany.com Port 80 RewriteEngine On RewriteOptions inherit OssoConfigFile "/as10gr2/mid/apache/apache/conf/osso/myportal.mycompany.com/osso.conf" OssoIpCheck off </VirtualHost> Weiter oben in der Datei bei der 'Port'-Angabe den Eintrag ändern von 7778 auf 80:... Port Ehe Prozesse unter dem Benutzer 'oracle' auf einem Port unter 1024 gestartet werden können, muss der Benutzer 'root' die Ausführung erlauben: cd $ORACLE_HOME/Apache/Apache/bin su root chown root.apachectl chmod 6750.apachectl exit Das Repository aktualisieren und der HTTP Server neu starten: $ORACLE_HOME/dcm/bin/dcmctl updateconfig -ct ohs -d v $ORACLE_HOME/opmn/bin/opmnctl stopproc process-type=http_server $ORACLE_HOME/opmn/bin/opmnctl startproc process-type=http_server Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 12 von 13

13 4.4 Webcache-Verbindungsdaten für Portal über OEM anpassen Im Browser Oracle Enterprise Manager aufrufen ( - Die Middle Tier aus der Liste selektieren - Auf Portal:portal klicken - Auf Portal Webcache-Einstellungen klicken - Den Veröffentlicher Host in myportal.mycompany.com ändern - Den Listening-Port auf 80 setzen - Den Invalidierungs-Host in myportal.mycompany.com ändern - Auf anwenden klicken Der Aufruf von folgender URL sollte jetzt, inklusive die Anmeldung, erfolgen: Gespeicherte OID Daten für Portal aktualisieren Im Browser aufrufen und mit dem Benutzernamen orcladmin anmelden ( Unter: Seite Portal Builder > Register Verwalten > Unterregister Portal > Link Globale Einstellungen > Register SSO/OID bei 'Cache für OID-Parameter aktualisieren' ein Häkchen setzen und auf Anwenden klicken. Beispiel Konfiguration OracleAS 10g R2 für.doc Seite 13 von 13