Oracle Fusion Middleware Deutsch

Oracle Enterprise Linux und VirtualBox: den richtigen Kernel wählen

2011-11-30T00:27:00.001-08:00

Wer in letzter Zeit regelmässig sein Oracle Enterprise Linux Image und seine VirtualBox aktualisiert hat, z.B. das Image aus dem 'BPMN und SOA Governance Handson Workshop', hat möglicherweise eine böse Überraschung erlebt.
Zum Installieren der Gasterweiterungen wird im Menü der VirtualBox unter 'Geräte' der Punkt 'Gasterweiterungen Installieren' ausgewählt.

Beim Installieren der VBox-Extensions nach Kernel- oder VBox-Update z.B. per

sh /media/VBOXADDITIONS_4.1.6_74713/VBoxLinuxAdditions.run

bricht das Skript mit folgender Fehlermeldung ab

[root@oel5r5 ~]# sh /media/VBOXADDITIONS_4.1.6_74713/VBoxLinuxAdditions.run
Verifying archive integrity... All good.
Uncompressing VirtualBox 4.1.6 Guest Additions for Linux.........
VirtualBox Guest Additions installer
Removing installed version 4.1.6 of VirtualBox Guest Additions...
Removing existing VirtualBox DKMS kernel modules        [ OK ]
Removing existing VirtualBox non-DKMS kernel modules    [ OK ]
Building the VirtualBox Guest Additions kernel modules
The headers for the current running kernel were not found. If the following
module compilation fails then this could be the reason.
The missing package can be probably installed with
yum install kernel-devel-2.6.32-200.23.1.el5uek

Building the main Guest Additions module                [FAILED]
(Look at /var/log/vboxadd-install.log to find out what went wrong)
Doing non-kernel setup of the Guest Additions           [ OK ]
Installing the Window System drivers
Installing X.Org 7.1 modules                            [ OK ]
Setting up the Window System to use the Guest Additions [ OK ]
You may need to restart the hal service and the Window System (or just restart
the guest system) to enable the Guest Additions.

Installing graphics libraries and desktop services componen[ OK ]

Das zum Übersetzen der VBox-Extensions benötigte Packet kernel-devel-2.6.32-200.23.1.el5uek fehlt also. Leider führt die vorgeschlagene Lösung, das Packet einfach per yum nachzuinstallieren auch nicht zum Erfolg:

[root@oel5r5 ~]# yum install kernel-devel-2.6.32-200.23.1.el5uek
Loaded plugins: security
file:///media/Enterprise%20Linux%20dvd%2020100405/Server/repodata/repomd.xml: [Errno 5] OSError: [Errno 2] No such file or directory: '/media/Enterprise Linux dvd 20100405/Server/repodata/repomd.xml'
Trying other mirror.
Setting up Install Process
No package kernel-devel-2.6.32-200.23.1.el5uek available.
Nothing to do

Im Repository Repository von Oracle liegt also kein Developer-Package für den Kernel, der mit el5uek bezeichnet ist. Hintergrund ist, dass Oracle für Enterprise Linux 5.7 als Alternative zum relativ alten Kernel 2.6.18, der auch von RedHat Linux benutzt wird, auch einen aktuelleren Kernel 2.6.32 anbietet. Einzelheiten dazu finden sich auf Oracle.com. Dieser Kernel wurde nun im Rahmen der Updates installiert, aber es gibt zumindest in Oracle's Repository kein dazu passendes devel-package, so dass sich die VBox-Extensions nicht mehr übersetzen lassen. Andererseits sind die Optimierungen des UEK für ein Entwicklungs-/Testsystem in einer VBox ohnehin nicht relevant, so hier einfach weiter der Kernel 2.6.18 genutzt werden kann.
Hierzu muss einfach in der Datei /boot/grub/grub.conf der zu verwendende Kernel ausgewählt werden. Ich habe den (ggf. sind auch mehrere Einträge vorhanden) 2.6.32 Kernel einfach an das Ende der Liste wie folgt verschoben.

default=0
timeout=5
splashimage=(hd0,0)/grub/splash.xpm.gz
hiddenmenu
title Oracle Linux Server (2.6.18-274.7.1.0.1.el5)
    root (hd0,0)
    kernel /vmlinuz-2.6.18-274.7.1.0.1.el5 ro root=/dev/VolGroup00/LogVol00 rhgb quiet
    initrd /initrd-2.6.18-274.7.1.0.1.el5.img
title Oracle Linux Server (2.6.18-274.0.0.0.1.el5)
    root (hd0,0)
    kernel /vmlinuz-2.6.18-274.0.0.0.1.el5 ro root=/dev/VolGroup00/LogVol00 rhgb quiet
    initrd /initrd-2.6.18-274.0.0.0.1.el5.img
title Oracle Linux Server (2.6.18-238.19.1.0.1.el5)
    root (hd0,0)
    kernel /vmlinuz-2.6.18-238.19.1.0.1.el5 ro root=/dev/VolGroup00/LogVol00 rhgb quiet
    initrd /initrd-2.6.18-238.19.1.0.1.el5.img
title Oracle Linux Server (2.6.32-200.23.1.el5uek)
   root (hd0,0)
   kernel /vmlinuz-2.6.32-200.23.1.el5uek ro root=/dev/VolGroup00/LogVol00 rhgb quiet
   initrd /initrd-2.6.32-200.23.1.el5uek.img

Der Eintrag default=0 sorgt dafür, dass der erste Eintrag der Liste, in diesem Fall der Kernel 2.6.18-274.7.1.0.1.el5 automatisch gestartet wird. Kommentiert man die Zeile hiddenmenu aus, kann man auch beim Startvorgang auswählen, welcher Kernel verwendet werden soll.

Mit dem 2.6.18er Kernel und dem dafür vorhandenen devel-package lassen sich dann (nach Reboot) auch die VBox-Extensions wieder übersetzen.

Servlet für Clustering erstellen

2011-11-04T09:29:00.000-07:00

Nachdem der vorige Betrag gezeigt hat, wie der WebLogic Cluster aufgesetzt wird, soll jetzt ein einfaches Servlet erstellt werden, um das Clustering zu demonstrieren. Das Servlet wurde bewusst simpel gestaltet um es nachvollziehbar zu machen. Für dieses Beispiel habe ich den JDeveloper 11.1.2.0.0 benutzt.

Eine neue Anwendung wird erstellt via 'New Application...'.

Hier wird die 'Custom Application' ausgewählt.

Die Anwendung benötigt einen Namen ...

... ebenso wie das Projekt. Bei den Technologien ist 'JSP and Servlets' auszuwählen, 'Java' wird dann automatisch mit ausgewählt.

Defaults belassen und 'Finish'.

Auf dem neu erzeugten Projekt per Rechtsklick 'New...' auswählen.

Dann Auswahl von 'Web Tier' -> 'Servlets' -> 'HTTP Servlet' und OK.

Hier können noch die Namen für das Servlet und das URL Pattern geändert werden, z.B. in 'simple' und '/cluster'

Das Servlet benötigt keine Parameter, beenden mit 'Finish'.

Als Ergebnis liefert der JDeveloper ein fertiges Servlet wie oben abgebildet.

public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType(CONTENT_TYPE);
PrintWriter out = response.getWriter();

HttpSession sess = request.getSession();
Integer cnt = (Integer)sess.getAttribute("cnt");
if(cnt==null)
cnt=0;

out.println("<html>");
out.println("<head><title>Servlet1</title></head>");
out.println("<body>");
out.println("<p>The servlet has received a GET. This is the reply.</p>");
out.println( new Date() );
out.println( "<p>Bisherige Aufrufe: " + cnt + "</p>" );
out.println("</body></html>");
out.close();

System.out.println( new Date()+ ": doGet - bisherige Aufrufe: " + cnt );

sess.setAttribute("cnt", ++cnt);
}

Der Quellcode wird nun wie oben geändert. Hierdurch wird ein Zähler hinzugefügt und dieser vor jedem Aufruf aus der HttpSession gelesen, erhöht und zum Schluss wieder in die HttpSession geschrieben.

Die Klasse Date muss noch importiert werden. Der JDeveloper bietet freundlicherweise an, das zu erledigen. Einfach den Cursor auf der Klasse positionieren und Alt-Enter drücken.

In der daraufhin auftauchenden Auswahl bitte Date (java.util) auswählen, damit die richtige Klasse importiert wird.

Über den Run-Button kann das Servlet im internen WebLogic Server getestet werden.

Das Ergebnis sollte dann wie oben abgebildet aussehen.

Damit ist das Servlet selbst soweit fertig, im nächsten Schritt wird der Ablauf im Cluster gezeigt.

Servlet Clustering Beispiel: WebLogic Cluster Setup

2011-10-21T05:01:00.000-07:00

In diesem Beispiel soll ein einfaches Servlet über den WebLogic Server geclustert werden. Im ersten Schritt wird hierzu eine neue Domain benötigt, alternativ kann natürlich auch eine bestehende Domain geändert werden.

Unter Windows findet man den Domain Konfigurationsassistenten auch im Startmenü, ansonsten wird er gestartet über config.exe bzw. config.sh.

Hier auswählen, ob eine bestehende Domain geändert, oder eine neue erzeugt werden soll.

In jedem Fall müssen beide Einträge für Oracle JRF ausgewählt sein, sonst gibt es später Probleme beim Deployment des Beispiels.

Domain-Name auswählen und weiter ...

Password festlegen...

und JDK auswählen,

Hier die 'Managed Server, Cluster und Rechner' als Optionale Konfiguration wählen.

Hier zwei managed Server über den Button 'Hinzufügen' eintragen, ggf. den Namen noch ändern.

Hier wird jetzt der Cluster über den Button 'Hinzufügen'angelegt.

Im linken Bereich unter 'Server' werden die beiden Managed Server ausgewählt und mit dem Pfeil nach rechts auf die rechte Seite unter Cluster bewegt.

Jetzt kann noch ein Rechner konfiguriert werden, falls man den Nodemanager benutzen möchte. Für dieses Beispiel ist das aber nicht notwendig.

Ggf. noch die Server dem Rechner hinzufügen

Zusammenfassung und ...

Fertig.

Der Admin-Server wird aus dem Hauptverzeichnis der Domain gestartet mit startWebLogic.cmd bzw. .sh.

Hier werden die Managed Server angezeigt unter base_domain/Environment/Servers.

Die beiden Managed Server werden jeweils aus dem bin-Verzeichnis der Domain gestartet mit startManagedWeblogic.cmd JEEServer_1 bzw. _2.

Die beiden hochgefahrenen Server werden dann auch entsprechend in der Admin-Console angezeigt. Ggf. hierzu auf den kleinen Kreis aus Pfeilen klicken zum Aktualisieren.

Damit läuft der Cluster und die Anwendung kann deployed werden.

FMW-Deutsch live: Anwendungen professionell Modernisieren

2011-10-12T08:56:00.000-07:00

Die Planung für den nächsten Kundenworkshop sind in vollem Gange. Dieses Mal handelt es sich nicht um einen Hands-On Workshop, sondern um drei zusammenhängende Vorträge über die wir gerne mit Ihnen diskutieren wollen. Den Workshop lassen wir dann in einem gemeinsamen Mittagessen in unseren Räumen ausklingen. Am 2.12.2011 geht es um Aspekte der Anwedungsmodernisierung, die Anmeldeseite ist ab sofort geöffnet.

Hier der vollständige Einladungstext:

- Von Visio zu ausführbaren Prozessen
- Forms-Modernisierung durch Anbindung der BPMN Human Task
- SOA-Governance bei der Anbindung von Prozessen

Unternehmen stehen ständig vor der Problematik, dass Altanwendungen auf eine moderne Architektur migriert werden müssen. Sei es weil die Fachabteilungen neue Anforderungen haben, welche mit der alten Architektur nicht mehr umsetzbar sind - zumindest nicht in einem vertretbaren Wirtschaftlichen Rahmen, oder einfach, weil eine Plattform einer Altanwendung den technischen Support verliert. Oftmals ist eine komplette Modernisierung mit einem einzigen Schritt nicht machbar, oder zumindest nicht wünschenswert. Viel mehr wird ein schrittweises Vorgehen benötigt. Die drei Vorträge sollen hierfür mögliche Lösungsszenarien aufzeigen.

Von Visio zu ausführbahren Prozessen
Das Szenario: die neuen Soll-Prozesse wurden bereits mit einem grafischen Tool, in diesem Falle Visio, festgehalten. Die Anwendungslandschaft besteht aber noch überwiegend aus monolithischen Altanwendungen. Dieser Vortrag zeigt, wie aus der Visio-Grafik ein lauffähiger BPMN-Prozess wird, der über entsprechende Adapter mit den bestehenden Anwendungen interagiert.

Forms-Modernisierung durch Anbindung der BPMN Human Task
Für die Integration in eine Service-orientierte Prozesslandschaft sind klassische Forms-Anwendungen häufig nur bedingt entwickelt worden. Für eine sinnvolle Integration muss die Anwendung aber nicht unbedingt komplett neu entwickelt werden. Am Beispiel einer unternehmensweiten Aufgaben-Verwaltung wird gezeigt wie sich eine Forms-Anwendung mit der Human-Workflow Engine der BPM-Suite integrieren.

SOA-Governance bei der Anbindung von Prozessen
Service-orientierte Architekturen sind heute ein akzeptiertes Modell zur Anwendungsintegration, auch zur Integration von Altanwendungen in moderne, Prozess-orientierte Landschaften. Hierbei ist es aber sinnvoll, von Anfang an parallel zur SOA-Entwicklung auch eine SOA-Governance aufzubauen. Dieser Vortrag zeigt auf, wie eine SOA-Governance Lösung werkzeugunterstützt die Integration von Altanwendungen in Prozesse verbessern kann

Seien Sie unser Gast und Diskutieren Sie mit uns. Neben unseren Vorträgen ist IHRE Meinung ausdrücklich gefragt. Und zum Abschluss würden wir uns freuen, wenn wir Sie in unseren Räumen noch auf ein gemeinsames Mittagessen einladen dürfen.

Anmeldung ===> Anmeldelink <===

BPMN-SOA-Governance Workshop: Password expired beim Start der SOA-Suite

2011-09-06T02:12:00.000-07:00

Der Workshop ist jetzt schon ein paar Monate her. Startet man jetzt die SOA-Suite erneut (Desktop-Link 'Start SOA' oder 'Start WLS') bekommt man eine Fehlermeldung 'password expired'.

Abhilfe schaffen die folgenden Schritte:

Auf dem Desktop mit rechtem Mausklick ein Terminal öffnen
Im Terminalfenster:

. oraenv [RETURN]
[RETURN]
sqlplus / as sysdba
In SQLPLUS dann folgendes eingeben:

ALTER PROFILE DEFAULT LIMIT
FAILED_LOGIN_ATTEMPTS UNLIMITED
PASSWORD_LIFE_TIME UNLIMITED;

alter user dev_mds identified by Oracle123;
alter user dev_soainfra identified by Oracle123;
alter user dev_ORABAM identified by Oracle123;
alter user dev_ORASDPM identified by Oracle123;

Im Anschluss bitte das Fenster mit der SOA-Suite, welche auf den 'password expired'-Fehler gelaufen ist schliessen und neu starten, dann funktioniert alles wieder.

Java Magazine jetzt als elektronische Publikation

2011-08-12T06:29:00.000-07:00

Technologisch an der Front zu sein, und die Informationen dazu per Post auf bedruckten toten Bäumen zu bekommen - das passt einfach nicht zusammen. So dachte wohl auch Oracle, denn jetzt erscheint das Java Magazine als kostenlose digitale Publikation, wahlweise interaktiv im Web oder zum Download als PDF.

Weitere Informationen und die erste Ausgabe finden sich auf OTN.

BI-Publisher für OER im WLS installieren

2011-08-08T09:15:00.000-07:00

Der Oracle BI-Publisher 10.1.3.4.1 kommt standardmässig noch mit einem eigenen oc4j. Nutzt man bereits das Oracle Enterprise Repository (OER) 11.1.1.x, möchte man den BI-Publisher aber mit auf dem Weblogic-Server des OER betreiben, um nicht zwei unterschiedliche JEE-Container für ein Produkt betreiben zu müssen.

Der BI-Publisher kann wie folgt manuell im WLS installiert werden:

1. Download BI-Publisher
Der BI-Publisher 10.1.3.4.1 ist auf OTN. erhältlich. Das zip-File wird in ein beliebiges temporäres Verzeichnis entpackt, unter Linux/Unix wird auch gleich noch das tar-File entpackt.

2. BI-Publisher installieren

Ein Verzeichnis xmlpserver wird erstellt im applications-Verzeichnis der OER-Domain, wie z.B.

/home/oracle/Oracle/Middleware/user_projects/applications/oer_domain/applications/xmlpserver
Aus dem entpackten zip-File im Temp-Verzeichnis wird die Datei

bipublisher.10.1.3.4.1/manual/generic/xmlpserver.war

entpackt (nicht kopiert!) in das neu erzeugte Verzeichnis xmlpserver
Ein Verzeichnis XMP wird auf der gleichen Ebene erstellt wie xmlpserver, also z.B.
/home/oracle/Oracle/Middleware/user_projects/applications/oer_domain/applications/xmlpserver
Im OER Homeverzeichnis befindet sich die Datei BIP-Oracle.zip unter

<OER_HOME>/core/tools/solutions/reports

In diesem Archiv befindet sich der Ordner XMLP. Der Inhalt dieses Ordners wird in das im letzten Schritt neu erzeugte Verzeichnis XMP entpackt.
Die Datei xmlpserver/WEB-INF/xmlp-server-config.xml wird angepasst, so dass diese auf den Ordner XMP verweist, z.B.

<?xml version="1.0" encoding="UTF-8"?>
<xmlpConfig xmlns="http://xmlns.oracle.com/oxp/xmlp">
<resource>
<file path="/home/oracle/Oracle/Middleware/user_projects/applications/oer_domain/applications/XMP"/>
</resource>
</xmlpConfig>
Die Fonts aus dem temporären Verzeichnis unter manual/fonts müssen in das fonts-Verzeichnis der benutzten JRE kopiert werden, z.B. nach

/home/oracle/Oracle/Middleware/jdk160_24/jre/lib/fonts
Die xmlpserver-Anwendung wird über die WLS-Console deployed und gestartet.

Auf der Deployments-Seite klickt man ggf. auf 'Lock & Edit' und dann rechts auf einen 'Install'-Button

Hier wird zum Verzeichnis xmlpserver navigiert -> Next

'Install this deployment as an application' wird hier ausgewählt -> Next

Auswahl 'I will make the deployment accessible from the following location' -> Finish
Ggf. 'Activate Changes', danach links wieder auf 'Deployments klicken.

Die Anwendung wird gestartet durch Setzen des Hakens und Start/Servicing all requests. Danach mit 'Yes' bestätigen und der Status wechselt auf 'Active'.

Getestet werden kann die Installation über die entsprechende URL, z.B.

http://oel5r5:7101/xmlpserver/servlet/report

Benutzername und Password sind beide 'Administrator'

3. Oracle Enterprise Repository für BI-Publisher konfigurieren

Im BI-Publisher Web-Frontend wird im Bereich Admin die JDBC-Connection ausgewählt

Hier die Data Source 'OER' auswählen

Dann die Verbindungsinformationen anpassen und per 'Test Connection' überprüfen. Beenden mit 'Apply'

Jetzt noch im Bereich Admin unter 'Users' das Password von oer setzen

Diese Konfiguration muss jetzt noch dem OER bekannt gemacht werden. Hierzu werden im OER auf dem Admin-Reiter unter 'System Settings' die folgenden Parameter entsprechend gesetzt:
- Enable Reports = True
- Report Server URL = http://oel5r5:7101/xmlpserver/OER
- Report Server Endpoint URL = http://oel5r5:7101/xmlpserver/services/PublicReportService
- Report Server Username = oer
- Report Server Password = wie oben gesetzt

Im Reports-Bereich des OER kann die Integration mit dem BI-Publisher überprüft werden. Tauchen hier im oberen Bereich rote Fehlermeldungen auf, ist bei den letzten Schritten etwas falsch gelaufen und diese sollten überprüft werden.

Sofern alles richtig gelaufen ist, können die Reports ausprobiert werden, wie hier z.B. der 'Policy Status Report'.

Enterprise Repository: Arbeiten mit Policies

2011-08-05T05:15:00.000-07:00

Mit Policies lässt sich das Modell im Repository weiter verfeinern. Policies können Assets angehängt werden und beschreiben weitere Aspekte dazu. Um Policies zu nutzen, muss diese Funktionalität zunächst im Repository aktividert werden.

Hierzu wird auf der Admin-Seite unter Sytem Settings der Parameter 'Enable Policies' auf True gesetzt. Im nächsten Schritt wird das Policy Management Solution Pack installiert. Dazu wird ebenfalls auf der Admin Seite unter 'Import Export' der Import / Export Client gestartet. Wichtig: der Browser muss Zugriff auf das Verzeichnis haben, in dem das OER installiert wurde.

Das Pack befindet sich im OER Installationsverzeichnis unter

/repository111/core/tools/solutions/11.1.1.5.0-Policy-Management-Solution-Pack.zip

Sucht man unter Assets jetzt nach Type 'POL - Policy' bekommt man jetzt die Policies angezeigt.

Jetzt lassen sich eigene Policies anlegen. Hierzu wird auf der Seite 'Assets' via 'Edit / Manage Assets' der Asset Editor aufgerufen. Unter File / New lässt sich dort eine neue Policy wie jedes andere Asset auch anlegen.

Als Typ muss hier 'POL - Policy' ausgewählt werden. Nach dem Bestätigen mit 'OK' kann die Policy editiert werden. Auf dem Reiter 'Overview' lassen sich jetzt über den Button 'Add' neben 'Policy Assertions' die Anforderungen für diese Policy definieren.

Die Policy kann hier entsprechend beschrieben werden, beenden mit 'OK'. Danach müssen noch im Asset-Editor die Änderungen mit File / Save gespeichert werden.

Damit einem Asset-Type diese Policy auch zugewiesen werden kann, muss dieser Typ dafür zunächst konfiguriert werden. Dieses erfolgt wieder aus dem Asset-Editor, der Type Manager wird über Actions / Manage Type aufgerufen.

Zum Beispiel gibt es für die die Application hier noch keine Assigned Policies. Diese lassen sich hinzufügen über den 'Add-Button' rechts neben 'Elements'.

Hier wähl man die 'Applied Asset Policies' und beendet mit 'OK', daraufhin wird noch ein Namen vergeben wie z.B. 'Applied Policies'. Die Asset Policies sind jetzt im Editor noch versteckt (Hidden). Um dies zu ändern, wechselt man vom 'Editor'- auf den 'Viewer'-Tab.

Dort wählt man unter 'Hidden Elements' die 'Applied Policies' und klickt rechts auf den Button 'Display In Group' und wählt dort z.B. 'Overview'.
Nach dem Speichern im Type-Manager stehen die Policies jetzt allen Assets vom Typ Application zur Verfügung. Hierzu wird ein Asset vom Typ Application im OER Web-Client gesucht und ausgewählt. Falls keines vorhanden ist, kann kurz eines angelegt werden. Eine Anleitung hierzu findet sich u.a. im BPM&SOA-Governance Workshop.

Hier ist jetzt ein neuer Button 'Apply Policies' aufgetaucht, der vor dem Setzen der entsprechenden System-Einstellung noch nicht vorhanden war. Hierüber lassen sich jetzt die gewünschten Policies zuweisen.

Über 'Search' kann man hier alle verfügbaren Policies anzeigen lassen, über die Pfeil-Buttons (>>) können die Policies zugewiesen werden. Abgeschlossen wird mit 'Save', es kommt noch ein Fenster mit einer Zusammenfassung welches mit 'Close' geschlossen wird.

Zurück auf der Hauptseite werden die zugewiesenen Policies jetzt beim Asset angezeigt, ein Symbol mit Ausrufezeichen weist auf die Policies hin.

Für die weitere Darstellung stellt man am besten auf die Tabbed-Ansicht um (dritter runder Button von links).

Im Tab 'Taxonomy' werden die zugewiesenen Policies Dargestellt. Ein Klick auf eine der Policies stellt die Details dazu dar.

Das Icon mit dem gelben Ausrufezeichen zeigt an, dass die Policies zwar zugewiesen, aber nicht überprüft wurden. Grundsätzlich kann dies natürlich auch über ein externes Tool geschehen, welches bestimmte Policies überprüft und entsprechend den Status setzt. Sie lassen sich aber auch manuell setzen, wozu wieder der Asset Editor genutzt wird.

Hier wird dann das entsprechende Asset und die gewünschte Policy ausgewählt. Über den Klick auf 'Details' lässt sich die Policy dann bearbeiten.

Hier wird die betreffende Assertion ausgewählt und mit 'Edit' bearbeitet. Im daraufhin auftauchenden Dialog kann dann das Ergebnis der Prüfung eingegeben werden. Wenn der Dialog mit OK verlassen wird, ist das Ergebnis noch nicht sichtbar, erst wenn im Asset Editor mit File/Save gespeichert wird, ist die Änderung aktiv.

Nach einen Neuladen in der Suchseite ist die Änderung dann auch dort sichtbar. Die Policy zur Barrierefreiheit wird als erfüllt angezeigt, die anderen Polices sind weiterhin auf gelb. Deshalb ist das Icon oben in der Trefferliste auch noch gelb.

Über die Einhaltung der Policies lassen sich jetzt z.B. auch Reports erstellen, ich werde in einem späteren Posting das Setup dafür beschreiben.

Oracle Enterprise Linux 5.5 in VirtualBox 4.1: root-Partition vergrössern

2011-08-02T09:29:00.000-07:00

Will man die SOA-Suite in einer virtuellen Umgebung patchen, wie z.B. das VBox-Image aus dem BPM & SOA-Governance Training, kann man in das Problem laufen, dass einem der virtuelle Platz auf dem root-Volume ausgeht, da während das Patchens der Platz für die SOA-Suite doppelt benötigt wird. Um das Volume zu vergrössern sind die folgenden Schritte nötig:

Zunächst muss die Grösse für das Virtual Disk Image (vdi) erhöht werden.

e:\VBox\Machines\SOA-11114-Klein>dir

...

02.08.2011  16:11    

02.08.2011  16:11    26.469.335.040 SOA-11114-Klein-disk1.vdi

02.08.2011  16:11            10.243 SOA-11114-Klein.vbox

2 File(s) 26.469.345.283 bytes 

2 Dir(s)  20.660.883.456 bytes free 

Die Größe für das VDI lässt sich mit VBoxManage erhöhen via

e:\VBox\Machines\SOA-11114-Klein>VBoxManage modifyhd SOA-11114-Klein-disk1.vdi -
-resize 40000
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% 

Hierbei wird die Datei nicht wirklich vergrößert, sondern nur die maximale Größe neu gesetzt, wie ein Blick auf die Datei zeigt.

e:\VBox\Machines\SOA-11114-Klein>dir
Volume in drive E is DriveBay
Volume Serial Number is ACDD-ABAA

Directory of e:\VBox\Machines\SOA-11114-Klein

02.08.2011  16:11             .

02.08.2011  16:11             ..

02.08.2011  16:16    26.470.383.616 SOA-11114-Klein-disk1.vdi

02.08.2011  16:11            10.243 SOA-11114-Klein.vbox

2 File(s) 26.470.393.859 bytes 

2 Dir(s)  20.659.834.880 bytes free 

Das Betriebssystem in der VBox hat davon natürlich nichts mitbekommen. Als nächstes muss daher die zu ändernde VM hochgefahren werden. Dann kann man als root per fdisk die Partitionierung anzeigen lassen:

[root@oel5r5 ~]# fdisk -l
Disk /dev/sda: 41.9 GB, 41943040000 bytes
255 heads, 63 sectors/track, 5099 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

Device Boot      Start         End      Blocks   Id System
/dev/sda1   *           1          13      104391   83 Linux
/dev/sda2              14        4000    32025577+ 8e Linux LVM

Disk /dev/dm-0: 29.6 GB, 29662117888 bytes
255 heads, 63 sectors/track, 3606 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

Hier kann man sehen, dass die Platte /dev/sda über 5099 Zylinder verfügt, die Partition /dev/sda2 aber bereits 4000 endet. Per fdisk kann das Ende von /dev/sda2 auf 5099 erhöht werden. Wichtig ist, die Hierzu wird fdisk mit der zu partitionierenden Platte aufgerufen:

fdisk /dev/sda

Über das Kommando p (print the partition table) kann man sich die Partitionierung noch einmal ansehen. Dann muss die zweite Partition /dev/sda2 gelöscht werden mit dem Kommando d:

Command (m for help): d
Partition number (1-4): 2

Als nächstes muss die Partition wieder neu angelegt werden mit dem Kommando n und den Parametern p (primary partition) und 2 (zweite Partition):

Command (m for help): n
Command action
e   extended
p   primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (14-5099, default 14):
Using default value 14
Last cylinder or +size or +sizeM or +sizeK (14-5099, default 5099):
Using default value 5099

Für die Werte für first und last cylinder sind die defaults richtig gesetzt und können so übernommen werden. Schaut man sich mit p die Partitionierung an, sieht man dass die Partition-Id noch nicht richtig gesetzt ist.

Command (m for help): p

Disk /dev/sda: 41.9 GB, 41943040000 bytes
255 heads, 63 sectors/track, 5099 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

Device Boot      Start         End      Blocks   Id System
/dev/sda1   *           1          13      104391   83 Linux
/dev/sda2              14        5099    40853295   83 Linux

Diese kann mit dem Kommando t wieder auf den ursprünglichen Wert (hier: 8e) gesetzt werden

Command (m for help): t

Partition number (1-4): 2
Hex code (type L to list codes): 8e
Changed system type of partition 2 to 8e (Linux LVM)
Command (m for help): p

Disk /dev/sda: 41.9 GB, 41943040000 bytes
255 heads, 63 sectors/track, 5099 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

Device Boot      Start         End      Blocks   Id System
/dev/sda1   *           1          13      104391   83 Linux
/dev/sda2              14        5099    40853295   8e Linux LVM

Ein Blick in die Partitionierungstabelle zeigt, dass jetzt alles korrekt ist. Um die Werte zu speichern wird fdisk mit dem Kommando w verlassen.

Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.

WARNING: Re-reading the partition table failed with error 16: Device or resource busy.
The kernel still uses the old table.
The new table will be used at the next reboot.
Syncing disks.

Wie von fdisk vorgeschlagen wird die VM jetzt rebootet. Danach muss dem Logical Volume Manager (lvm) die Grössenänderung des physical volumes mitgeteilt werden. Dies geht über

[root@oel5r5 ~]# pvresize /dev/sda2

/dev/cdrom: open failed: No medium found
Physical volume "/dev/sda2" changed
1 physical volume(s) resized / 0 physical volume(s) not resized

Die Fehlermeldung zu /dev/cdrom kann ignoriert werden, wichtig ist '1 physical volume(s) resized'. Der Rest kann dann auch über das grafische Frontend erledigt werden, bei Oracle Enterprise Linux über System/Administration/Logical Volume Management.

Betrachtet man dort die Physical View /dev/sda, Partition 2 sieht man rechts jetzt Unused Space. Um diesen zu nutzen, wählt man unter Logical View LogVol00 und klickt dort den Button 'Edit Properties'.

Hier reicht es einfach, den Schieber für die Größe ganz nach rechts zu ziehen oder alternativ den Button 'Use remaining' zu benutzen und mit OK den Dialog zu beenden. Kommt an dieser Stelle die Fehlermeldung "Logical volume is not mounted but is in use. Please close all applications using this device (eg iscsi)", dann fehlen dem OEL Patches. Hier muss einfach das System mit einem Update-Server verbunden werden und alles installiert werden was vorgeschlagen wird, stand heute funktioniert dann alles.
Danach kann der lvm geschlossen werden und der zusätzliche Speicherplatz steht dem OEL in der VM zur Verfügung.

An dieser Stelle vielen Dank an meinen Kollegen Dirk Wriedt für die Unterstützung.

Upgrade SOA/BPM-Suite 11.1.1.4 nach 11.1.1.5

2011-07-27T03:07:00.000-07:00

1. Upgrade WLS 10.3.4 -> 10.3.5

Für das Upgrade muss zunächst der WebLogic Server von 10.3.4 auf 10.3.5 upgraded werden. Hierzu benötigt man den Patch von support.oracle.com. Die Patch-Nummern sind

12395517 für Linux 32-Bit
12395560 für Windows 32-Bit

Für alle anderen Plattformen einfach suchen nach Produkt='Oracle WebLogic Server', Release=10.3.5 und die gewünschte Plattform eingeben. Der WLS Patch Installer wird einfach mit den default-Einstellungen durchgeklickt.

2. SOA-Suite 11.1.1.5 Upgrade installieren

Als nächstes wird die SOA-Suite 11.1.1.5 benötigt, erhältlich unter http://www.oracle.com/technetwork/middleware/soasuite/downloads/index.html.

Den Installer für die SOA-Suite startet man dann nach dem Entpacken wie bei einer neuen Installation via .../Disk1/runInstaller. Die Dokumentation dazu findet man unter http://download.oracle.com/docs/cd/E17904_01/doc.1111/e16793/patch_set_installer.htm#insertedID0.

Der Installer erkennt die vorhandene Installation und bietet das Upgrade an, hier mit 'Yes' bestätigen.

3. Repository upgraden

Der nächste Schritt ist das Upgrade des Repositories mit dem Patch Set Assistant, der sich im Oracle_Home der SOA befindet unter z.B. Oracle_SOA1/bin/psa (s. Dokumentation: http://download.oracle.com/docs/cd/E17904_01/doc.1111/e16793/patch_set_assistant.htm#BABEBGEJ). Dieser muss für die Schemata DEV_MDS und DEV_SOAINFRA (Namen ggf. anpassen) analog dem folgenden Beispiel ausgeführt werden.

[oracle@oel5r5 bin]$ ./psa -dbConnectString //localhost:1521/orcl -dbaUserName sys -schemaUserName DEV_SOAINFRA
Oracle Fusion Middleware Patch Set Assistant 11.1.1.5.0

Enter the database administrator password for "sys":
Enter the schema password for schema user "DEV_SOAINFRA":
Log file is located at: /home/oracle/Oracle/Middleware/Oracle_SOA1/upgrade/logs/psa2011-08-03-14-10-17PM.log
Updating the Oracle Fusion Middleware Metadata Schema to release 11.1.1.5.0.
Updating schema for component Oracle SOA.
The command completed successfully

Das Ergebnis kann wie in der Doku beschrieben überprüft werden, oder einfach mit dem folgenden Statement:

SQL> SELECT version, status, owner FROM schema_version_registry;

VERSION STATUS OWNER
------------------------------ ----------- ------------------------------
11.1.1.4.0 VALID DEV_ORABAM
11.1.1.5.0 VALID DEV_MDS
11.1.1.2.0 VALID DEV_ORASDPM
11.1.1.5.0 VALID DEV_SOAINFRA

Zum Schluss noch gemäß Dokumentation die Packages neu compilieren und auf invalid objects prüfen.

SQL> conn / as sysdba

Connected.

SQL> @?/rdbms/admin/utlrp.sql

- - - Haufenweise Zeilen gelöscht - - -

ERRORS DURING RECOMPILATION

---------------------------

PL/SQL procedure successfully completed.

SQL> SELECT owner, object_name FROM all_objects WHERE status='INVALID';

no rows selected

4. Post Patching Tasks

Weiter streng nach Dokumentation müssen alle betreffenden Domains aktualisiert werden wie im folgenden Beispiel:

cd oracle_common/common/bin
./wlst.sh

wls:/offline>upgradeJRF('/home/oracle/Oracle/Middleware/user_projects/domains/bpm_domain')
upgradeJRF: skip, JRF is up-to-date.

Der nächste Schritt ist soa-upgrade.py, der Aufruf führte bei mir allerdings zu folgendem Ergebnis:

cd /home/oracle/Oracle/Middleware/Oracle_SOA1/bin

../common/bin/wlst.sh soa-upgrade.py --username weblogic --password Oracle123 --wlsHost oel5r5 --adminServerListenPort 7001 --targetList AdminServer

... seitenweise gelöscht ...

Current Status of your Deployment:

Deployment command type: deploy

Deployment State : failed

Deployment Message : weblogic.deploy.event.DeploymentVetoException: Cannot undeploy library Extension-Name: oracle.soa.worklist.webapp, Specification-Version: 11.1.1, Implementation-Version: 11.1.1 from server AdminServer, because the following deployed applications reference it: HT-01-simple-Form.war, UrlaubsAntragGenehmigen_UI.war, HT-04-Rules-Form.war, HT-02-Simple-Form.war, UrlaubsAntragErstellen_UI.war, HT-03-List-Form.war

No stack trace available.

... noch mehr gelöscht ...

WLSTException: Error occured while performing deploy : Target exception thrown while deploying application: Error occured while performing deploy : Deployment Failed. : Error occured while performing deploy : Deployment Failed.

Use dumpStack() to view the full stacktrace

Die Worklist-Application konnte nicht neu deployed werden, weil noch HumanTask-Anwendungen deployed waren die davon abhängen. Diese liessen sich auch nicht mehr über das Enterprise Manager Fusion Middleware Control undeployen.

In meinem Fall hatte sich während der Script-Ausführung die Datenbank-Verbindung zur Repository-DB irgendwie verknotet, so dass das Undeploy fehlschlug. Die schnelle Lösung war hier ein Neustart mit anschließendem manuellen Undeploy der Anwendungen.

Beim zweiten Versuch lief das Script dann auch fehlerfrei durch:

.Completed the deployment of Application with status completed

Current Status of your Deployment:

Deployment command type: deploy

Deployment State : completed

Deployment Message : no message

Fertig!

JDeveloper 11.1.2.0 ist da

2011-06-08T04:15:00.000-07:00

Kurz nach dem Release 11.1.1.5 wurde jetzt die 11.1.2.0 freigegeben. Eine Liste der neuen Features findet sich unter

http://www.oracle.com/technetwork/developer-tools/jdev/jdev-11gr2-nf-404365.html

Besonders auffällig ist gleich beim Start die Umstellung auf das neue JDeveloper Extension Framework, basierend auf OSGi. Die Startzeit hat sich dadurch massiv verbessert. Zum Vergleich: auf meinem System benötigt der JDeveloper 11.1.1.5 zum Start 1:24 min., der 11.1.2.0 nur noch 11 sek.

Einziger Wehrmutstropfen: Es ist ein reines Java-Release, das Tooling für SOA, BPMN und Webcenter fehlt hier noch, aber diese Veröffentlichungsstrategie ist ja bereits von vorherigen Releases bekannt. Das neue Release ist auf jeden Fall ein grosser Schritt nach vorne.

Oracle - Business Transaction Management - BTM - Meine Bestellung hängt:...

2011-05-20T06:23:00.000-07:00

Die Kollegen vom DTCC Potsdam haben auf YouTube einen eigenen Video-Channel mit deutschsprachigen Informationen zu Oracle Fusion Middleware gestartet

Viel Spaß beim Anschauen.

SOA Suite 11g Performance Tuning Tips

2011-05-19T08:30:00.000-07:00

Auf dem IPN Web Blog finden sich einige sehr gute Performance Tuning Tips für die SOA Suite 11g unter

http://blog.ipnweb.com/2011/04/performance-tuning-oracle-soa-suite-11g.html

BPM-Suite und Oracle Enterprise Repository im Zusammenspiel

2011-03-16T04:21:00.000-07:00

Um einen Service aus dem Oracle Enterprise Repository im BPMN-Prozess zu nutzen, muss dieser zunächst auf Ebene des SCA Composites bekannt gemacht werden.

Hierzu wird von rechts aus der Component Palette ein Webservice in den rechten Bereich 'External References' des Composites gezogen.

Dies ist zunächst ein Platzhalter für einen Service, das Feld WSDL URL ist noch leer. Über einen Klick auf den Butten neben dem Feld kommt man in den Auswahldialog für einen bestehenden Service.

Die obere Auswahlbox wird umgeschaltet von 'File System' auf 'Resource Palette'. Unter 'IDE Connections' -> 'Oracle Enterprise Repository' -> 'OERConnection1' -> 'Asset Types' -> 'Service' findet sich der zuvor eingetragene HrInfoService2. Dieser wird per Doppelklick übernommen.

Die Werte werden automatisch aus dem Repository übernommen. Da unser Service nur über einen Port Type verfügt, ist dieser bereits korrekt voreingestellt und der Dialog kann mit 'OK' verlassen werden.

Der Service wird daraufhin im Composite unter 'External References' dargestellt.

Weiter geht es in der BPMN-Ansicht des UrlaubsProcess. Zunächst wird per Rechter Maustaste -> 'Add Role' eine neue Swimlane eingefügt. Als Name wird hierfür der 'Automatic Handler' ausgewählt, eine Farbe kann wahlweise vergeben werden. Die neue Swimlane wird zwischen die beiden bestehenden gezogen.
Nun wird per Drag&Drop von rechts aus der 'Component Palette' eine 'Serivce Task' genau auf die Verbindung zwischen 'Antrag' und 'Genehmigung' in der neuen Swimlane gezogen. Wenn die Verbindung richtig getroffen wurde, färbt sie sich blau.

In dem sich öffnenden Dialog wird auf im Reiter 'Basic' der Name 'Resturlaub abfragen' vergeben. Im Reiter 'Implementation' wird dann die Implementation auf 'Service Call' gestellt. Über die Lupe kann dann der HRinfoService ausgewählt werden. Die einzige Operation gethrinfo2 ist dadurch voreingestellt.
Dann ist noch der Haken zu setzen bei 'Use Associations', welche über den gelben Stift rechts davon noch definiert werden müssen.

Hier wird die personalnr aus dem UrlaubsDataObject auf die Eingabevariable empid gemappt, der Rückgabewert holidaysOut kommt in den resturlaub. Dann beide Dialoge mit 'OK' schliessen.
Jetzt muss die Anwendung neu deployed werden, damit die Änderungen auf den Server gelangen.

Jetzt kann wieder ein Urlaubsantrag erstellt werden. Wichtig ist jetzt, eine vorhandene Personalnummer zu nehmen (z.B. 100), da über diese jetzt ja über den Webservice die verbleibenden Urlaubstage ermittelt werden.
Nachdem der Antragsprozess gestartet werden kann, lässt sich im Enterprise Manager der korrekte Aufruf des Webservice überprüfen. Dort kann man Audit Trail des UrlaubsProcess' die Aktivität 'Resturlaub abfragen' über das Plus [+] aufblättern und bekommt über 'Instance left the activity' die XML-Payload angezeigt. Beispielsweise werden für die Personalnummer 100 noch 240 (!) Tage Resturlaub ausgewiesen.

Über ein Login mit dem Manager-Account jcooper/Oracle123 steht der Urlaubsantrag jetzt zur Genehmigung zur Verfügung. Hier werden auch die Verbleibenden Tage Resturlaub, die der Webservice geliefert hat, angezeigt.

Herzlichen Glückwunsch! Wenn Sie bis hier gekommen sind, haben Sie unseren BPMN und SOA-Governance Handson-Workshop erfolgreich abgeschlossen. Zusammenfassend haben wir folgendes erstellt:

Einen Prozess zur Anlegen und Genehmigen von Urlaubsanträgen
Die Ergebnisse werden über einen Adapter an ein beliebiges System weitergeleitet
Es wurde ein Antrag auf einen Webservice in das Repository gestellt
Ein bestehender Webservice wird erweitert und zur Wiederverwendung bereitgestellt
Der Prozess wurde um den Service erweitert, der hiermit wiederverwendet wurde.

Bei Fragen hierzu sprechen Sie uns wieder an:

Bernhard Fischer-Wasels & Arne Brüning

BPMN: Prozess-Simulation

2011-03-02T00:50:00.000-08:00

Die Definition einer Prozess-Simulation erfolgt im 'BPM Project Navigator'.

Auswahl von Simulations -> Simulation Definitions -> rechte Maustaste: 'New Simulation'

Der Default-Name kann übernommen werden, weiter mit 'OK'.

Wieder im BPM Project Navigator: Simulations -> Simulation Models -> 'New Simulation Model'

Der Prozess 'UrlaubsProzess' wurde bereits voreingestellt. Die Simulation sollte einen aussagekräftigeren 'Simulation Model name' bekommen wie z.B. 'UrlaubsSimulation'. Weiter mit 'OK'.

Das Simulation Model öffnet sich automatisch. Haken setzen bei 'Specify number of process instances to be created' und Vorsteinstellung 100 übernehmen.

Unter SimulationDefinition bei 'Process' die Checkbox "Include in Simulation" für UrlaubsProcess ankreuzen.

Gestartet wird die Simulation dann aus der BPMN-Ansicht des UrlaubsProcess. Hierzu im unteren Pane den Tabreiter 'Simulation' auswählen und den Start-Button (gründer Pfeil) klicken.

Im Prozess wird durch eine Animation der Lauf der Simulation angezeigt. Hier kann bei den Human Tasks die Anzal der Mitarbeiter mit + und - herauf- bzw. herabgesetzt werden, um zu überprüfen welche Auswirkungen dies auf die Simulation hat.

Im unteren Bereich wird dazu die aktuelle Statistik gezeigt.

Unter 'Simulation Models' -> 'UrlaubsProcess' -> 'UrlaubsSimulation' können die Simulationsparameter angepasst werden. Unter Flow Nodes (Prozess Schritte) können die jeweiligen Vorgaben wie Duration, Resources, Cost usw. eingestellt werden.

Damit ist der Basis-Prozess für diesen Workshop zunächst fertig.

Nächster Schritt ---> PL/SQL-Webservice erstellen, Datenbank vorbereiten

BPMN: Prozess im Weblogic Server testen

2011-03-01T06:18:00.000-08:00

Zum Testen kann der BPM Workspace genutzt werden unter http://oel5r5:7001/bpm/workspace/

Login als User achrist, das Password ist im Workshop normalerweise 'Oracle123' (oder was auch immer im Kapitel 'Setup' eingegeben wurde).

Oben bei 'Applications' gibt es einen Link '[Urlaub] UrlaubsProcess v1.0' (die 'Initiator Task'), dort anklicken um den Prozess zu starten.

In dem erscheinenden Popup-Fenster kann der Urlaubsantrag mit halbwegs sinnvollen Daten gefüllt werden. Per 'Submit'-Button wird der Prozess dann mit diesen Daten gestartet.

Logout oder anderen Browser öffnen und Einloggen mit Manageraccount jcooper (pwd. s.o.). Dort ist jetzt die Task 'Urlaubsantrag genehmigen' zu sehen. Per klick auf die Zeile (und etwas warten) erscheinen im unteren Detail-Pane die Detail-Daten. Mit klick auf den 'Genehmigen'-Button verschwindet die Task.

Der den Prozess initiierende Benutzer (achrist) kann sich den Verlauf seines Urlaubsantrags direkt aus seinem Workspache anschauen. Dazu geht er auf den Reiter 'Initiated Tasks' und wählt dort z.B. State=completed und wählt dort seinen Urlaubsantrag aus. Unten in der Detail-Ansicht kann er sich dann über das Aufklappen von 'History' den Verlauf seines Prozesses ansehen.

Im Enterprise Manger (http://oel5r5:7001/em) lässt sich der gesamte Ablauf im Detail nachvollziehen. Hierzu wird der Baum unter der Farm_bpm_domain wie abgebildet geöffnet bis zum UrlaubsProject, welches ausgewählt wird. Auf der rechten Seite kann dann die aktuelle Instanz ausgewählt werden.

Daraufhin öffnet sich ein Fenster mit dem 'Flow Trace'. Hier ist zu erkennen, dass der gesamte Ablauf durch ein Event (der manuelle Start des Prozesses) ausgelöst wurde, dann den Urlaubsprozess durchlief, welcher wiederum die Human Workflows und den File-Adapter aufrief.

Im Reiter 'Audit Trail' kann auch die Aktivität 'Bescheid genehmigt' über das [+] erweitert werden. Über den dann verfügbaren Link 'Instance left the activity' kann man die Rückgabewerte des Fileadapters sehen, welcher den geschriebenen Dateinamen und das Verzeichnis zurückliefert.

Auf dem Serversystem bzw. in der VM lässt sich der Rückgabewert überprüfen. In dem resultierenden XML-Dokument ist der korrekt durchgelaufene Urlaubsantrag inclusive des Approvals enthalten und könnte so z.B. an ein HR-System übertragen werden.

Nächster Schritt ---> BPMN: Prozess-Simulation

Tip: BPM Human Task und java.io.FileNotFoundException

2011-03-01T02:09:00.000-08:00

Leider hat sich in die Oracle BPM Suite 11.1.14 (PS3) ein kleines Problem eingeschlichen, s. auch OTN-Forum.

Startet man einen Prozess über eine Initiator Task und füllt dann die Task-Form aus, bekommt man zum Abschluß ein Fenster mit der Fehlermeldung

OracleJSP error: java.io.FileNotFoundException:

Set the init-param debug_mode to "true" to see the complete exception message

Das Problem taucht auf, weil der JDeveloper 11.1.1.4 vergisst, die Empty1.jspx anzulegen. Folglich muss zur Behebung auch nur diese Datei erzeugt werden. Also Rechtsklick auf dem entsprechenden UI-Projekt und 'New' auswählen.

Dann JSF|JSF Page auswählen und 'OK'

'Create as XML Document (*.jspx)' ankreuzen, damit es eine .jspx-Datei wird, den Namen ändern auf Empty1.jspx und mit OK abschließen.

Diese jspx braucht weiter nichts zu enthalten, einfach neu deployen und das Problem ist behoben.

BPMN: Deployment auf Weblogic Server

2011-02-28T03:55:00.000-08:00

Das Deployment erfolgt im JDeveloper aus dem Application Navigator (falls nicht sichtbar: --> View --> Application Navigator).

Hier sollte es 3 Projekte geben: 'Urlaub' (das BPM Projekt), 'UrlaubsAntragErstellen_UI' und 'Genehmigung_UI' (die Projekte der Web-UI). Bitte alle 3 Projekte minimieren, das Projekt 'Urlaub' auswählen und rechte Maustaste -> deploy _> Urlaub.

'Deploy to Application Server' auswählen.

'Overwrite any existing composites with the same revision ID' ankreuzen, Next.

'Overwrite Existing Application' ankreuzen. Ebenso links neben 'Projects' den Haken setzen bei 'Click here to select all WAR profiles to deploy'. Dadurch werden die beiden UI-Projekte mit ausgewählt, ohne welche die Anwendung nicht lauffähig wäre.

Hier den SOABPM Server auswählen.

Der AdminServer ist genau richtig, Next.

In der Übersicht wird dann per 'Finish' das Deployment gestartet.

Wenn alles geklappt hat, steht unten im Log am Ende ---- Deployment finished. ----.

Nächster Schritt ---> BPMN: Prozess im Weblogic Server testen

BPMN: Benutzeroberflächen generieren

2011-02-24T09:10:00.000-08:00

Weiter geht es im SCA-Composite. Dieses sollte noch in einem Tabreite offen sein, ansonsten im Application Navigator das Projekt 'Urlaubsantrag' expandieren, SOA Content expandieren und Doppelklick auf composite.xml.

Im Composite sind jetzt auch die beiden Human Tasks zu sehen, die im Prozess definiert wurden. Diese müssen jetzt mit einer Benutzeroberfläche versehen werden. Start mit Doppelklick auf 'AntragErstellen.task'.

Weiter geht es oben links mit Create Form|Launch Task Form Wizard. Jede Taskform wird ein eigenes Projekt im JDeveloper. Als Name bitte 'UrlaubsAntragErstellen_UI' eingeben (UI = User Interface - ist wichtig, damit man im Application Navigator den Überblick behält beim Deployment) und 'OK'.

Die ersten beiden Seiten im Task Form Wizard können mit 'Next' übersprungen werden. Auf der Seite für den Body den Title eingeben 'Bitte Urlaubsdaten erfassen'. Setup des Seitenlayouts nach belieben und weiter mit 'Next'.

Auf der folgenden Seite für die erste Spalte die gewünschten Attribute (Vorschlag: Name, Datum_von, Datum_bis, Anzahl_Tage, Resturlaub) auswählen oder einfach alle übernehmen (bei nur einer Spalte). Weiter mit 'Next', ggf. wiederholen mit zweiter Spalte (Vorschlag: Vertreter, Kommentar, Status, Personalnr).
Auf der letzten Seite für den Footer als Title 'Weitere Informationen' eintragen sowie 'Comments' und 'History' selektieren. Bei 'Display in … columns' den Zähler auf 2 hochsetzen. Abschließen mit 'Next' und 'Finish'.

Als Ergebnis erhält man die generierte ADF Eingabeform.
Entsprechend soll jetzt noch die zweite Human Task für die Genehmigung erstellt werden, beginnend mit dem Doppelklick auf AntragGenehmigen im composite.xml. Als Projektname sollte 'Genehmigung_UI' vergeben werden.

Auch hier erhält man wieder eine Task-Form wie oben abgebildet. An dieser Stelle speichern und alle Fenster ausgenommen composite.xml schliessen.

ACHTUNG: da sich im JDeveloper 11.1.1.4 ein kleiner Fehler eingeschlichen hat, bitte noch die verlinkten Anweisungen befolgen. Da der Fehler aber mit 11.1.1.5 wieder behoben wurde, ist dieser Workaround dort nicht mehr notwendig.

Nächster Schritt ---> BPMN: Deployment auf Weblogic Server

BPMN: Objekte mit dem Prozess verknüpfen

2011-02-23T08:13:00.000-08:00

Weiter geht es wieder im Prozess, den man erreicht über den entsprechenden Tabreiter bzw. das durch Doppelklick im 'BPM Project Navigator' auf den 'UrlaubsProcess'.

Auf dem Prozessschritt Antrag (erstellen) rechter Mausklick, Properties. Wechseln auf Tabreiter 'Implementation' und neben dem leeren Feld 'Human Task' das grüne Plus-Symbol (+) anklicken.
Im 'Create Human Task' Dialog den Namen setzen auf 'AntragErstellen' und das Pattern auf 'Initiator' umstellen. Der Title wird 'Bitte Urlaubsdaten erfassen'.
Neben Parameters das grüne Plus-Symbol (+) klicken und aus dem Dialog 'BrowseDataObjects' das 'UrlaubDataObjekt' mit der linken Maustaste von rechts aus dem Fenster in die leere Parameterliste ziehen, loslassen und 'editable' auswählen.
Jetzt das Fenster 'Browse Data Objects' schließen, ebenso 'Create Human Task' via 'OK' - eine Human Task definition wird angelegt (noch nicht das UI). STOP! An dieser Stelle noch nicht mit 'OK' den Properties-Dialog verlassen! Statt dessen bei 'Data Associations' den Haken setzen bei 'Use Associations' und klick auf den gelben Bleistift daneben ('Edit Data Associations').

Es öffnet sich der 'Data Associations' Editor. Hier per Drag&Drop von rechts das UrlaubDataObject in das Input-Feld links vom 'urlaubsantrag'-Prozessobjekt bewegen. Im Output-Feld ist das UrlaubDataObject bereits vorbelegt.
Jetzt die beiden Fenster jeweils mit 'OK' schließen. Das Aussehen der User Task hat sich geändert: es ist der kleine Pfeil dazugekommen, weil es eine 'Initiator Task' ist.

Die gleichen Schritte werden jetzt noch einmal wiederholt für die Aktivität 'Genehmigung' mit folgenden Parametern: Name: 'AntragGenehmigen' (Pattern: Simple), Title: 'Bitte Antrag prüfen', Parameters: UrlaubDataObjekt: editable: angehakt. Dieses Mal kann auch gleich das 'Outcome Target' unten entsprechend auf 'Outcome' gesetzt werden. Über das 'Outcome'-Object wird die Genehmigung [APPROVE] oder Ablehnung [REJECT] vom Manager weitergegeben im Prozess.

Dann ist bei Data Associations wieder der Haken zu setzen bei 'Use Associations'. Mit dem Klick auf das Edit-Icon (gelber Bleistift) gelangt gelangt man wieder zu den 'Edit Data Associations'. Dieses Mal müssen auf der linken Seite alle Felder einzeln zugewiesen werden, ausgenommen das Feld Resturlaub. Dieses wird anschließend mit einer Funktion gefüllt über den fx-Button.

Hier wird zunächst der 'Mode' oben links umgestellt auf 'XPath Exp.', bei Functions werden die 'Conversion Functions' voreingestellt. Dann wird die Funktion 'string' ausgewählt und nach oben in die 'Expression' übernommen per Doppelklick oder den Button 'Insert Into Expression'.

Oben in der 'Expression' setzt man den Cursor zwischen die beiden Klammern von 'string()'. Nun wird links unten bei 'Variables' ResturlaubReturn ausgewählt und wiederum oben in den Ausdruck eingefügt, so dass dieser jetzt aussieht wie auf dem Bild oben.

Die drei Fenster werden jeweils geschlossen mit 'OK'.

In der Prozess-Grafik verschwindet auch sogleich die Warning, da diese Task nun vollständig implementiert ist. Es ist allerdings noch kein User Interface generiert worden, das folgt später. An dieser Stelle bitte wieder speichern.

Jetzt wird die Verbindung 'abgelehnt' (von Bescheid zu BescheidAbgelehnt) bearbeitet. Hierzu den Pfeil anklicken und rechte Maustaste, Properties, wechseln auf den Tab Properties, Type setzen auf 'Condition'. Über das Icon: [fx] gelangt man in den Expression Builder.

Unter 'Variables' die Variable Outcome auswählen und per Drag&Drop oder über den Button 'Insert into Expression' in das Feld 'Expression' bewegen. Hier muss es nun heissen: Outcome == "REJECT" (Wichtig!!! => vor REJECT ist ein doppeltes Gleichheitszeichen und REJECT ist von Anführungszeichen umschlossen) !). Verlassen mit zwei Mal 'OK'.
Der Manager erhält den Urlaubsantrag und gemäß des "Simple" Patterns (nur APPROVE oder REJECT wählen zu können) wählt er bei Nicht-Genehmigung REJECT und somit läuft der Prozess jetzt diesen Pfad entlang. APPROVE wird nicht modelliert, denn das entspricht dem Default/Standard Pfad.

Nun wird der Prozessschritt BescheidGenehmigt implementiert. Hierzu Rechtsklick auf die Aktivität BescheidGenehmigt und 'Properties' auswählen. Dann auf Reiter 'Implementation', Implementation Type setzen auf 'Service task' und Implementation 'Service Call' auswählen. Weiter über Lupensymbol neben dem Feld 'Name'. Hier 'AntwortSchreiben' auswählen und die Operation 'write' wird automatisch übernommen. Noch nicht OK klicken.

Jetzt wieder 'use Associations' ankreuzen und den Button (Stift) für 'edit Data Associations' anklicken. In der Mitte das Data Objekt 'Urlaubsdaten' expandieren durch [+], ebenso rechts das "Urlaubsantrag" Dataobject.
Von rechts mit gedrückter rechter Maustaste die UrlaubsAntragObjekt Attribute nach links in die korrespondierenden Felder unter 'Input' ziehen. Ausnahmen: die Attribute 'status' und 'resturlaub'. Hierhin kommen statt dessen die Data Objekts 'Outcome' und 'ResturlaubReturn', für letzteres bitte wieder die Funktion anwenden wie oben beschrieben. Beenden mit zwei Mal 'OK'.

Die Warnung im Prozessschritt verschwindet, da jetzt die Implementierung auf den Service Call zum File-Adapter gesetzt wurde. Hierdurch werden die UrlaubsDataObjekt-Inhalte und der Status (REJECT oder APPROVE) in ein Textfile geschrieben.
Die gleichen Schritte sind noch ein mal entsprechend für die Aktivität 'BescheidAbgelehnt' durchzuführen, dann alles sichern. Unser Prozess sollte jetzt keine Warndreiecke mehr verzeichnen.

Nächster Schritt ---> BPMN: Benutzeroberflächen generieren

BPMN: File-Adapter einbinden

2011-02-23T04:50:00.000-08:00

Nach dem Lauf des Urlaubsantrags-Prozesses soll nun irgend etwas mit dem Ergebnis passieren. In einem realen Projekt, würde das Resultat z.B. über den entsprechenden Adapter an ein HR-System gemeldet werden. Um das Beispiel für den Workshop einfach zu gestalten, wird das Ergebnis einfach via File-Adapter ins Dateisystem rausgeschrieben. Wichtig an dieser Stelle: für den Prozess ist es völlig unerheblich, ob die Resultate nun an ein HR-System weitergeben oder nur in eine Datei geschrieben werden. Durch das Adapter-Framework ist das Einbinden der Adapter identisch, nur benötigt das Dateisystem weniger und andere Parameter.

Der Adapter wird auf Ebene des SCA-Composites (Fenster composite.xml) eingebunden. Hierzu wird der File Adapter rechts aus der Component Palette in den rechten Bereich des Composites, unter 'External References' gezogen.

Daraufhin öffnet sich der Wizard zur Konfiguration des Files Adapters. Die erste Seite kann gleich mit 'Next' übersprungen werden. Auf der zweiten Seite wird der Serivce Name gesetzt auf 'AntwortSchreiben', dann 'Next'.

Die Auswahl 'Define from operation and schema', kann so bleiben, 'Next'.

Operation Type 'Write File' setzt automatisch Operation Name 'Write'. Add Output Header kann aktiviert werden, um etwas ausführlichere Ergebnisse zu erhalten.

Als Directory for Outgoing Files kann z.B. gewählt werden /tmp oder /home/oracle (Linux) oder wenn vorhanden c:\temp (Windows). Die FileNameConvention setzt man am besten mit einer Sequenz (%SEQ%) auf z.B. 'ua_%SEQ%.txt'. Weiter mit 'Next'.

Die URL für das Schema auswählen über die Lupe. Im Type Chooser 'Project Schema Files' expandieren, Urlaubsantrag.xsd expandieren und root-element <> Urlaubsantrag auswählen. Weiter mit OK, Next und Finish, dann alles sichern.

Der Zwischenstand sollte dann wie oben aussehen.

Nächster Schritt ---> BPMN: Objekte mit dem Prozess verknüpfen

BPMN: Datenmodell erstellen

2011-02-23T03:51:00.000-08:00

Im weiteren wird für die Implementierung das Objekt 'Urlaubsantrag' benötigt, welches die Urlaubsdaten beinhaltet. Im Hintergrund wird dafür eine XML-Schema Datei (xsd) erzeugt.

Dieses wird aus dem BPM Projekt Navigator erstellt via rechte Maustaste auf 'Business Catalog' -> New -> 'Business Objekt'.

Der Name wird gesetzt auf 'Urlaubsantrag' und beim 'Destination Module' geht es weiter über die Lupe zum 'Browse Module' Dialog. Hier kann ein neues erzeugt werden für den 'Module'-Knopf (weisses Blatt mit gelbem Stern). Diese bekommt den Namen 'Daten'. Alle Dialoge wieder mit 'OK' schliessen.

Die Oberfläche zum Definieren des Geschäftsobjekts öffnet sich automatisch. Über das grüne Plus-Symbol (+) können die folgenden Attribute vergeben werden:

beschreibung	Type
name	string
datum_von	string
datum_bis	string
anzahl_Tage	string
vertreter	string
kommentar	string
status	string
personalnr	decimal
resturlaub	string

An dieser Stelle sollte zur Sicherheit gespeichert werden (File|Save all), danach kann das Fenster mit dem Objekt 'Urlaubsantrag' geschlossen werden.

Um jetzt im Prozess mit einem DatenObjekt aus dem BusinessCatalog arbeiten zu können, muß ein ProcessDataObject Urlaubsantragsobjekt auf Basis des Business Objekts aus dem Business Catalog angelegt werden.

Dazu im BPM Project Navigator das Projekt 'Urlaub', Processes = 'Urlaubsprozess' auswählen. Dann darunter im StructurePane auf 'ProcessDataObject' via rechter Maustaste 'New' auswählen.

Der Name wird gesetzt auf 'UrlaubDataObject', als Type dann [Component] auswählen. Im darunter erscheinenden Eingabefeld die Lupe anklicken. Dann in dem sich öffnenden Dialog den Urlaubsantrag auswählen und jeweils mit 'OK' beide Dialoge schliessen.

Um das Ergebnis (Genehmigung des Managers) im Prozess weitergeben zu können, wird noch ein weiteres ProzessDataObject benötigt. Dieses wird den Status APPROVED oder REJECT halten, solange der Urlaubsantrag im Prozess weitergereicht wird. Daher wird analog zu oben ein weiteres ProcessDataObject erzeugt vom Typ String mit Namen 'Outcome'.
Auf dem gleichen Weg wird noch ein weiteres ProcessDataObject 'ResturlaubReturn' vom typ Decimal erzeugt.

Zur Sicherheit bitte an dieser Stelle noch einmal speichern (danach ist der Titel des Tabs nicht mehr kursiv).

Nächster Schritt ---> BPMN: File-Adapter einbinden

BPMN fachliches Modell erstellen

2011-02-22T09:09:00.000-08:00

Nachdem nun die Vorbereitungen abgeschlossen sind, soll im nächsten Schritt das fachliche Modell erstellt werden.

Hierzu im JDeveloper links im 'Process Navigator' den Process 'Urlaubsprocess' per Doppelklick auswählen.

Swimlane 'Role' ändern in 'Mitarbeiter' per Rechtsklick auf Role -> Properties –> Mitarbeiter.

Darunter neue Swimlane 'Manager' anlegen via Rechtsklick -> add Role -> Name: Manager auswählen -> OK.

Der UserTask wird umbenannt über Doppelklick auf den Namen 'User Task' und ersetzt durch 'Antrag'.
Aus der Component Palette (rechts, falls die Component Palette nicht angezeigt wird, kann diese via View|Component Palette aktiviert werden) im Bereich 'Activities|Interactive' die Aktivität User auf Swimlane 'Manager' ziehen.

Als Name 'Genehmigung' eingeben und beenden mit 'OK'. Hiermit wird eine 'Human Task' erstellt, damit der Manager den Antrag genehmigen kann. Das rote 'x' (Error) ist OK - es fehlen noch die Verbindungen und die Implementierung. Das Ein-/Ausschalten von Errors/Warnings ist möglich über Schieberegler unter "Show Warnings").
Das Resultat sieht jetzt wie folgt aus:

Jetzt die Pfeilspitze der Verbindung -Antrag' -> 'End' mit der Maus aufnehmen und nach 'Genehmigung' verschieben, denn so soll der Prozess später laufen.
Wir brauchen etwas mehr Platz: den 'End' Bubble mit linker Maustaste nach rechts ziehen und dort wieder loslassen.

Nun aus der Component Palette 'Gateways' den 'Exclusive Gateway' in die Swimlane 'Mitarbeiter' ziehen (s. auch Grafik unten) und den Namen auf 'Bescheid' setzen.
Aus der Component Palette 'Activities' die Activity 'Service' (Name: 'BescheidGenehmigt') links neben "End" ziehen (Bitte an der Grafik orientieren). Darunter eine weitere Service-Activity mit dem Namen 'BescheidAbgelehnt' platzieren.

Nun wird der Default bzw. Standard Pfad erstellt: mit rechter Maustaste auf 'Genehmigung' klicken, 'add Default Sequence Flow' und mit der Maus auf 'Bescheid' ziehen und loslassen (dort, wohin man verbinden kann, ändert sich das Cursor-Aussehen).
Das gleiche ist für die Verbindungen Bescheid -> BescheidGenehmigt und BescheidGenehmigt -> End durchzuführen, jeweils 'add default Sequence Flow'.
Wir haben nun den Standard Pfad (default flow) modelliert; d.h. wenn der Manager genehmigt, geht der Prozess diesen Weg.
Nun folgt die 'Ablehnung': Bescheid mit rechter Maustaste anklicken, 'add conditional Sequence Flow' und auf 'BescheidAbgelehnt' loslassen. Jetzt noch von 'BescheidAbgelehnt' nach End via 'add default Sequence Flow' verbinden.
Die Pfeile ausgehend von 'Bescheid' beschriften mit 'genehmigt' (nach 'BescheidGenehmigt') und 'abgelehnt' (nach 'BescheidAbgelehnt') via rechtem Mausklick|Properties|Name'.

Es sind jetzt noch Warnings und Errors auf den Aktivitäten bzw. Flows. Das ist korrekt so, sobald die Objekte (Daten des Urlaubsantrags) angelegt und im Prozess implementiert wurden, verschwinden die Warnings und Errors.

Nächster Schritt: BPMN: Datenmodell erstellen

BPMN Rollen & User anlegen

2011-02-22T05:51:00.000-08:00

Die (fachlichen) Rollen müssen angelegt und den (Demo-)Usern zugewiesen werden. Diese User müssen zunächst im Weblogic Server angelegt werden. Hierzu wird die WLS Console geöffnet unter http://localhost:7001/console.

Links die Security Realms auswählen, dann rechts myrealm auswählen.

'Users and Groups' auswählen, hier müssen die beiden User achrist und jcooper über 'New' angelegt werden.

'OK' und das ganze noch einmal für den jeweils anderen User.

Das Ergebnis sollte dann wie oben gezeigt aussehen.

Zurück im JDeveloper, den BPM Project Navigator (Tab rechts neben Applications Navigator) öffnen, Baum 'Urlaub' öffnen (+), dann rechte Maus auf Organization -> Open.

Über das grüne Plus oben rechts (+) wird die Rolle Mitarbeiter hinzugefügt.

'Mitarbeiter' auswählen (Zeile ist dann blau), darunter bei 'Members' nach den WLS Usern 'achrist' und 'jcooper' suchen mittels der Lupe.

Es erscheint 'Identity Lookup', bei Application Server 'SOAbpm' auswählen (nicht 'integratedWeblogic'). Dann mit SearchPattern='*' neben 'User Name' auf das Zahnrad (Lookup) klicken. Aus der Trefferliste 'achrist' auswählen, Button 'Select' und mit 'OK' abschließen.

Diese Schritte bitte wiederholen mit Role 'Manager' und User 'jcooper'.

Ausserdem wird der bestehenden Rolle 'Process Owner' auch der User 'achrist' hinzugefügt, sonst wird im Workspace der StartForm-Link nicht angezeigt.

Dann alles speichern mit File|Save all.

Später kann man sich als Administrator 'weblogic' einloggen in den Business Process Workspace (http://oel5r5:7001/bpm/workspace), oben rechts im Header den Link 'Administration' wählen und Zuordnungen einsehen/ändern. Die Zuordnungen aus dem JDeveloper sind hier aber erst sichtbar nachdem die Anwendung erstmalig deployed wurde. Auch kann ein LDAP oder Active Directory hinter dem WLS eingebunden werden.

---> Nächster Schritt: BPMN fachliches Modell erstellen

BPMN Application und Project anlegen

2011-02-22T04:26:00.000-08:00

Weiter geht es mit dem BPMN-Teils des Workshops. An dieser Stelle vielen Dank an Bernhard Fischer-Wasels vom SOA und Logistik Blog, von dem der BPM-Teil stammt.
Im JDeveloper wird eine Application angelegt über 'New Application' oder File|New|General|Applications.

Application Name auf 'Urlaubsantrag' setzen, Application Template: aus der Liste "BPM Application" auswählen, Next.

Project Name 'Urlaub' eingeben, Technologies SOA und BPM sind bereite ausgewählt, dann Next.

Composite With BPMN Process auswählen -> Finish.
Etwas (ein paar Sekunden) warten... dann erscheint der "Create BPM Process Wizard"

Name 'UrlaubsProcess' eingeben, bei 'Type' bitte auswählen: 'Manual Process'.

Default übernehmen, Finish.

Das Ergebnis sieht dann wie folgt aus.

Anmerkung: Falls der 'Create BPM Process'-Wizard nicht erscheint, links im BPM Project Navigator (separater Reiter) Projekt 'Urlaub' expandieren [+] und rechte Maustaste auf 'Processes' -> New -> Process -> Create BPMN Process. Links auswählen: 'From Pattern: Manual Process' weiter -> 'UrlaubsProcess' -> Finish.

--> Nächster Schritt: BPMN Rollen & User anlegen

Oracle Enterprise Repository "User is locked out"

2011-02-09T07:51:00.000-08:00

Es kann passieren, dass der User im OER gelockt wird. Beim Login bekommt er dann nur die Meldung "User is locked out" und kommt nicht über das Anmeldefenster hinaus. Wenn man noch andere User im System hat, kann man sich mit diesen einloggen und den Benutzer wieder freigeben. Hat man aber nur den Admin-User, z.B. nach einer frischen Installation, kommt man hier nicht weiter.
In diesem Fall kann man sich als Repository-Benutzer auf der Datenbank anmelden und den Benutzer wie folgt entsperren:

SQL> update ENTSECUSERS set ACTIVESTATUS=0 where USERNAME='admin';

1 row updated.

SQL> update CMEEUSERS set ACTIVESTATUS=0 where ENTSECUSERID='99';

1 row updated.

SQL> commit;

Commit complete.

Es kann sein, dass die Daten noch gecached sind. In dem Fall hilft es, den WLS durchzustarten. Danach sollte das Login wieder funktionieren.

Einladung BPM/SOA-Governance Workshop: Anmeldeseite jetzt verfügbar

2011-01-17T03:52:00.000-08:00

Der BPM/SOA-Governance Workshop ist jetzt auf der Anmeldeseite für interssierte Kunden und Partner verfügbar. Nachdem die Anleitungen zum SOA-Governance Teil hier schon in den letzten Wochen zur Verfügung gestellt wurden, haben Sie nun die Gelgenheit die Inhalte zusammen mit mir und meinem Kollegen Bernhard Fischer-Wasels in einem Workshop selbst durchzuführen.

Die Agenda ist wie folgt:

09:30	Vorstellung BPM, SOA, Governance Lösung Parallel Setup Oracle VM VirtualBox
10:30	BPM Lab Erläuterung Einführung in den JDeveloper und das BPMN-Modelling
11:00	Hands-on: BPM Lab 1. Praktische Übung: Modellierung und Ausführung eines BPMN-Prozesses
12:30	Mittagspause
13:15	Oracle Enterprise Repository Lab - Erläuterung
13:45	Hands-On: Oracle Enterprise Repository Lab 2. Praktische Übung: Konfiguration Repository, Deployment von WebServices, Ablage im Repository
15:15	Der Governance Roundtrip mit BPM und OER - Erläuterung Das komplette Bild: SOA Governance als Bindeglied zwischen Fachabteilung und IT
15:30	Kaffeepause
15:45	Hands-On: Der Governance Roundtrip mit BPM und OER 3. Praktische Übung: zum Schluß wird alles zusammen gefügt
16:30	Schluß der Veranstaltung

Bezüglich weiterer Informationen wie Hardware-Anforderungen folgen Sie bitte dem Anmeldelink. Wir freuen uns auf Ihr Kommen.

Fusion Middleware Patchset 3 (PS3) verfügbar

2011-01-16T04:40:00.000-08:00

Oracle hat soeben das Patchset 3 (11.1.1.4) für verschiedene Komponenten wie WebLogic Server, JDeveloper, SOA- und BPM-Suite freigegeben. Einige der Neuerungen sind

Unterstützung für BPEL 2.0
Lauffähigkeit auf Websphere
Vereinfachte Installation in den Administrations-Server für Entwicklungssysteme

Sehr schön zusammengefasst wurden die Informationen auf dem SOA Partner Community Blog. Der kommende BPM/SOA-Governace-Workshop wird auch bereits auf 11.1.1.4 durchgeführt werden, hier lassen sich also gleich praktische Erfahrungen sammeln.

Tip: BPM-Suite und JDeveloper mit OPatch patchen

2010-12-13T06:52:00.000-08:00

Bei der Installation des Patch 9958661 für BPM-Suite und JDeveloper via OPatch bin ich gerade über ein kleines Problem gestolpert. Der Patch besteht aus zwei Teilen: einen für die BPM-Suite und einen für den Server, die separat mittels OPatch installiert werden müssen.

Der Patch für die BPM-Suite verhält sich wie erwartet: wenn JAVA_HOME und ORACLE_HOME gesetzt sind und opatch im Pfad ist, genügt es im Patch-Verzeichnis opatch apply auszuführen und der Patch wird installiert.

Der Versuch, das gleiche mit dem JDeveloper-Home zu machen führt zu der folgenden Meldung:

Fusion Middleware Home is corrupted (WebLogic Home is not found)!
/home/oracle/app/Middleware/jdeveloper/jdk/bin/java is not a valid executable for this platform. OPatch cannot proceed!
OPatch returns with error code = 1

Die Lösung: der Pfad zum JDK muß opatch als Argument mitgegeben werden, also

opatch apply -jdk $JAVA_HOME

und schon klappt es wieder.

Workshop: Überarbeiteten Service im Repository hinterlegen

2010-11-01T04:38:00.000-07:00

Der Portfolio-Verantwortliche kann das Repository nach neuen Anfragen zu Webservices durchsuchen.
Hierzu wird gesucht nach Type 'Request for Service' und Registration Status 'Unregistered'. Auf der rechten Seite wird dann die gefundene Anfrage für den Webservice für Informationen zu Urlaubstagen angezeigt.

Wird der Service in der Trefferliste mit der Maus angewählt, erscheint unten der Klartext der Anfrage. Der Portfolio-Manager erfährt hier den Zweck des benötigten Webservices und kann jetzt überprüfen, ob es bereits einen bestehenden Service gibt, der diesen Zweck erfüllt.

Vorher öffnet er den Asset Editor und akzeptiert die Anfrage mit dem Button Accept).

Auch der Request for Service wird jetzt in den Status 'Registered' überführt, damit er im weiteren im Repository zur Verfügung steht.
Jetzt könnte z.B. gesucht werden nach Search String 'Urlaubstage' und Type 'Service'

Allerdings liefert diese Suche keine Treffer, weil noch kein Webservice zu Urlaubstagen im Repository vorhanden ist. Jetzt könnte der Portfolio-Manager überprüfen, ob es überhaupt Webservices gibt die Informationen zu einer Personalnummer liefern z.B. mit einer Suche nach Type 'Service' und Search String 'personaln'.

Jetzt findet die Suche natürlich den zuvor angelegten Webservice, der von den benötigten Rückgabeparametern Vor-, Nachname und verbleibende Urlaubstage zumindest die ersten beiden liefert. Unser Portfolio-Manager beschließt daher, von dem bestehenden Webservice eine neue Version entwickeln zu lassen, welche auch die benötigten Urlaubstage zurückliefert.
Der gesamte Prozess, bis der neue Serivce zur Verfügung steht, lässt sich auch vom Repository unterstützen. Z.B. könnte jetzt zunächst der neue Service im Repository definiert werden, mit Status auf Entwicklung. Dann könnte er einem Entwickler zugewiesen werden, später könnten die Tests im Repository dokumentiert werden. Für diesen Workshop soll es aber ausreichen, wenn der Service einfach erstellt und in das Repository eingestellt wird.

Dazu bekommt die HRService Anwendung im JDeveloper ein neues Projekt.

Das Generic Project reicht aus.

Es wird wieder die Web Service Technologie ausgewählt, welche Java nach sich zieht. Das Projekt bekommt dann den Namen HRService2. Im nächsten Schritt dann den Dialog beenden.
Jetzt wird im neuen Projekt HRSerivce2 wieder ein PL/SQL-Webservice erstellt. Die Schritte zur Erstellung des Webservices sind im wesentlichen die selben wie im Kapitel Serviceerstellung mit folgenden Änderungen:

Der Service bekommt einen neuen Namen, hier 'HrInfoService2'

Dieses Mal wird die Prozedur GETHRINFO2 verwendet. Den Rest des Wizards dann einfach mit den Defaults durchklicken.

Zur Sicherheit sollte der neue Webservice kurz im JDeveloper getestet werden. Diese neue Version liefert jetzt neben Vor- und Nachnamen auch die verbleibenden Urlaubstage zurück.
Ist der Test erfolgreich gelaufen, kann der Webservice genau wie der vorherige auf den WLS deployed werden, wie im Kapitel 'Webservice deployen' bereits beschrieben.

Danach sollte der neue Webservice unter dem alten HRService in der Weblogic Console unter Deployments angezeigt werden.

Auch auch dem WLS sollte der Webservice kurz getestet werden.
Als nächstes wird der neue Service über den Harvester in das Repository übernommen.

Dazu wird in der HarvesterSettings1.xml (~/app/Middleware/repository111/harvester/) der Eintrag remoteQuery so modifiziert, dass jetzt Hrservice-HRservice2-context-root abgefragt wird. Die Datei wird danach unter einem neuen Namen gespeichert, z.B. HarvesterSettings2.xml.
Jetzt ist wieder der Harvester ,wie bereits im Kapitel 'Webservice ins Enterprise Repository übernehmen' beschrieben, an der Reihe. Also wieder mit

./harvest.sh -settings HarvesterSettings2.xml

den Harvester aufrufen. Wenn der Harvester wieder erfolgreich durchgelaufen ist, steht der neue Service im Repository zur Verfügung.

Über eine Suche nach 'hrservice' werden jetzt sowohl der hrInfoService, als auch der HrInfoService2 gefunden.

Weiter geht es im Asset Editor als admin. Dort kann über den 'Advanced Search' Button oben links neben dem 'Search' Button eine erweiterte Suche nach Typ 'Service' durchgeführt werden.

Der Service kann jetzt im Repository etwas ausführlicher Beschrieben werden. Die Version ist 2.0, er bekommt eine Beschreibung und das Projekt wird zugewiesen.
Auf der Seite Administration kann der Service im Schnelldurchlauf die Schritte zur Registrierung durchlaufen, wie im Kapitel "Webservice ins Enterprise Repository übernehmen" beschrieben.

Weitere Attribute können gesetzt werden, z.B. auf der Seite Support kann das Häkchen für 'Supported', oder entsprechend bei 'Management Review'. Dies sind für einen potentiellen Service-Konsumenten wichtige Informationen, er wird typischerweise eher einen Service wiederverwenden, der supported ist.
Auf der Seite Taxnomy sind noch die Verbindungen ganz unten bei 'Relationships' über den Button 'Add' hinzuzufügen.

Der HrInfoService2 bekommt die Relation 'Previous version is' zu HrInfoService. Die umgekehrte Relation 'Next version is' wird automatisch gesetzt. Mit OK wird der Dialog geschlossen.
Als zweites wird eine 'Implements' Relation zum Antrag 'Webservice für Informationen zu Urlaubstagen' hinterlegt.

Somit sind die Relationen zur Anfrage und zur Vorversion im Repository hinterlegt.
Jetzt wo der neue Service lauffähig deployed und registriert ist, kann der Prozessentwickler diesen nutzen. Dazu kann er im OER z.B. nach hrservice suchen und findet jetzt beide Versionen.

Wird der neue Service im Navigator aufgerufen, zeigt er jetzt alle Relationen an. Sowohl die automatisch mit dem Harvester gesammelten, als auch die manuell nachgetragenen Verbindungen zur Vorgängerversion und der Anfrage.
Somit steht der neue Service dem Prozess jetzt zur Verfügung und kann entsprechend eingebunden werden.

Nächster Schritt ---> BPM-Suite und Oracle Enterprise Repository im Zusammenspiel

Workshop: Antrag auf neuen Webservice ins Repository stellen

2010-10-28T00:33:00.000-07:00

Wenn der Designer eines Prozesses nun einen neuen Service benötigt, kann er grundsätzlich im Repository nachsehen ob er dort einen geeigneten Serivce findet. Allerdings muss der Prozessentwickler nicht zwingend auch ein SOA-Experte sein, so dass er mit der Menge der Assets im Repository möglicherweise nicht viel anzufangen weiß. Selbst wenn er einen grundsätzlich geeigneten Webservice findet, ist er möglicherweise nicht in der Lage zu bewerten ob ein Serivce wirklich für die Verwendung in seinem Prozess geeignet ist.
Eine Kommunikation zwischen den beteiligten Parteien ist hier Grundvoraussetzung, diese kann auch nicht durch ein Werkzeug ersetzt werden. Das Oracle Enterprise Repository kann den Prozess aber unterstützen und dafür sorgen, dass die Ergebnisse nutzbar und nachvollziehbar sind.

Hierzu soll der Prozessentwickler die Möglichkeit bekommen, im Enterprise Repository eine Anfrage nach einem benötigten Service zu hinterlegen. Diese wird abgebildet über einen neuen Asset-Typen 'Request for Webservice', der im Asset Editor angelegt werden kann.

Den Type Manager erreicht man aus dem Asset Editor über den Menüpunkt 'Actions|Manage Types'. Hier werden alle aktuellen Asset-Typen aufgeführt

Über File|New lässt sich ein neuer Service anlegen. Dieser soll hier 'Request for Service' heißen und wird von dem normalen Service abgeleitet.

Zurück im Type Manager lässt sich der 'Request for Service' weiter anpassen. Da er z.B. niemals in der UDDI-Registry auftauchen wird, lässt sich der Punkt auf 'None' setzen. Über die Einstellmöglichkeiten zu Tabs und Elements lässt sich weiter konfigurieren, welche Attribute überhaupt im Asset Editor für den 'Request for Service' angezeigt werden sollen. Das OER lässt sich hier stark an die jeweiligen Bedürfnisse anpassen, aber für den Workshop soll erst einmal mit den Standardeinstellungen verfahren werden.
Die getätigten Einstellungen werden über den Menüpunkt File|Save dauerhaft gesichert.

Als nächstes wird ein Repository-Benutzer für den Prozessentwickler benötigt. Dieser kann im Repository Frontend unter 'Admin|Users|Create New' angelegt werden.

In diesem Dialog kann der User Peter Prozessbauer angelegt werden mit den Rollen businessAnalyst, projectAdministrator und projectArchitect. Die Rolle user ist standardmässig vorhanden. Mit 'Save' (runterscrollen) wird der Dialog beendet.

Analog dazu wird ein Projekt angelegt unter Projects|Create New.

Hier kann das HR-BPMN Projekt angelegt werden. Ein User muss als Project Leader eingetragen werden, den Dialog hierzu erreicht man über den Edit-Button rechts neben 'Users'.

Hier kann der neu angelegte User dem Projekt als Leiter zugewiesen werden. Über 'List All Users' bekommt man die Auflistung der User, hier kann der Anwender 'peter' ausgewählt und über den Doppelpfeil (>>) den 'Projekt Leaders' zugewiesen werden. Der Dialog wird ganz unten über 'OK' verlassen (ggf. scrollen), der Dialog für das Erstellen des Projekts wird ebenfalls unten über 'Save' geschlossen.
Jetzt kann Peter Prozessbauer seinen 'Request for Service' eintragen. Hierzu kann der Administrator ausgeloggt werden, oder alternativ ein zweiter Browser geöffnet werden.

Hier kann sich der neue Projektleiter anmelden.

Seinen Wunsch nach einem neuen Webservice kann er direkt auf der Startseite erfassen über den Link 'Submit an Asset'.

Hier kann der 'Request for Service' jetzt wie jedes andere Asset eingetragen werden. Wichtig ist nur die Auswahl des Type 'Request for Service'. In den Feldern 'Description' und ggf. 'Comments' kann der benötigte Service jetzt beschrieben werden. Die 'File Location URL' ist ein Pflichtfeld, hier kann z.B. die URL einer Feinspezifikation angegeben werden, die im lokalen DMS liegt. Der Link wird aber an dieser Stelle nicht automatisch überprüft, so dass hier auch ein Platzhalter eingegeben werden kann. Per Doppelklick kann dann noch das Projekt 'HR-BPMN Projekt' ausgewählt werden. Via 'Submit' wird der Dialog beendet. Es folgt eine Bestätigung und mit 'Close' wird der Dialog geschlossen.

Damit ist der Request für den Webservice im Repository abgelegt. Überprüfen lässt sich dies auf der Seite 'Assets' über die Suche. Hier wird als 'Type' der 'Request for Service' eingetragen und der 'Registration Status' sollte auf 'All Assets' stehen. Über den 'Search'-Button wird die Suche ausgeführt und rechts der Request für den 'Webservice für Informationen zu Urlaubstagen angezeigt'.

---> Nächster Schritt: Überarbeiteten Service im Repository hinterlegen

Workshop: Webservice ins Enterprise Repository übernehmen

2010-10-20T08:12:00.000-07:00

Jetzt wo der Webservice deployed ist, soll er in das Repository übernommen werden. Um diese Arbeit nicht manuell erledigen zu müssen, liefert Oracle mit dem Repository auch das Harvester Tool.
Der Harvester ist im Workshop-Image bereits konfiguriert, die Anleitung wie der Harvester aufgesetzt wird findet sich auch auf FMW-Deutsch. Falls sich der Harvester nicht starten lässt, bitte die folgenden Schritte beachten:

das harvest.sh Skript muss ausführbar sein, hierzu: chmod +x harvest.sh im gleichen Verzeichnis ausführen.
Die Variable JAVA_HOME muss auf ein passendes JDK gesetzt sein, z.B. für Version 11.1.1.5 wie folgt: export JAVA_HOME=/home/oracle/Oracle/Middleware/jdk160_24

Die Konfiguration, welche dem Harvester mitteilt was er sammeln soll und wohin er das Ergebnis schreiben soll, findet sich in der Datei ~oracle/Oracle/Middleware/repository111/harvester/HarvesterSettings1.xml. (ggf. abweichende repository-Version beachten). Alternativ lässt sich die Datei hier (Link anklicken) herunterladen.
Diese enthält die folgenden Einträge:


<repository>
<uri>http://localhost:7101/oer</uri>
<credentials>
<user>admin</user>
<password>v2_1.qxO4nSjgNEDgcGNqdjE01A==</password>
</credentials>
<timeout>30000</timeout>
</repository>

<remoteQuery>
<serverType>WLS</serverType>
<projectName>HRservice-HRservice-context-root</projectName>
<uri>http://localhost:7001/</uri>
<credentials>
<user>weblogic</user>
<password>v2_1.G+NTr3az8thaGGJBn0vwPg==</password>
</credentials>
</remoteQuery>
</query>

Gestartet wird der Harvester als Shell Script harvest.sh im Verzeichnis ~oracle/app/Middleware/repository111/harvester/ über das Kommando harvest.sh -settings HarvesterSettings1.xml.

Die Fehlermeldungen zum OSB-Plugin kann man hier ignorieren. Wichtig ist am Ende das Ergebnis „Successfully completed the harvest“.
Der erfolgreiche Harvest-Vorgang kann in der Web-Oberfläche des Oracle Enterprise Repositories überprüft werden. Diese findet sich in der Workshop-Umgebung unter der URL http://oel5r5:7101/oer/

Der Username ist admin und das Password wie überall im Workshop Oracle123

Auf der Hauptseite des OER kann jetzt nach den neuen Einträgen gesucht werden. Dazu sollte der 'Registration Status' links auf 'Unregistered' gesetzt und die Suche ausgeführt werden. Auf der rechten Seite werden dann die gefundenen Artefakte aufgelistet: Service, Interface, Endpoint und WSDL.

Wählt man die Zeile mit dem Service aus, lässt sich über den Linken Button der Navigator aufrufen.

Über den Button mit dem schrägen Doppelpfeil lässt sich die Darstellung vergrössern. Dieses sog. Spiderweb-Diagramm zeigt die gesammelten Verbindungen zwischen den Artefakten.

Details zu den Assets und Änderungsmöglichkeiten gibt es im Asset Editor, der über den Menüpunkt 'Edit / Manage Assets' aufgerufen wird.

Der Asset Editor basiert auf der Java WebStart-Technologie. Abhängig vom Browser (hier Firefox wie im Workshop-Image). Falls sich hier keine Java-Webstart Anwendung öffnet, ist möglicherweise das Java-Plugin für den Browser nicht korrekt installiert.

Sofern alles richtig aufgesetzt ist, erscheint der Asset Editor. Hier können die Details für den Service und die gesammelten Artefakte eingesehen werden.

Allerdings sind die Services noch im Status 'Unsubmitted'. Zur Unterstützung einer SOA-Governance durchläuft die Registrierung von Assets einen Prozess. Um im Schnelldurchlauf die Assets zu registrieren, werden die nächsten Schritte zur Vereinfachung direkt nacheinander vom Administrator durchgeführt.

Dazu wird jedes Asset zunächst einzeln submitted, dies geschieht auf dem Reiter 'Administration' über den Button 'Submit'.

Daraufhin befinden sich die Assets im Status 'Pending Review' unter 'Submitted', aufgeschlüsselt nach ihrem jeweiligen Typen.

Weiter geht es von hier aus über den Button 'Accept'

Damit befinden sich die Assets im Status 'Under Review'

Jetzt kann das jewelige Asset mit dem Button 'Register' im Repository registriert werden

Somit stehen die über den Harvester hinzugefügten Assets im Repository registriert zur Verfügung. Das Log des Registrierungsprozesses kann auf der rechten Seite unten eingesehen werden.

Damit der Service später auch wiedergefunden wird, sollte er im Repository ordentlich verschlagwortet werden. Für den Workshop reicht eine kurze Beschreibung: „Liefert zu einer übergebenen Personalnummer den Vor- und Nachnamen des Mitarbeiters“. Die Änderung wird gespeichert mit File|Save.

Über die Verbindung aus dem JDeveloper ist der Service jetzt auch auffindbar.

Damit steht der Webservice jetzt nicht nur auf dem Weblogic Server zur Verfügung, sondern kann auch aus dem JDeveloper im Enterprise Repository gefunden werden.

Über rechte-Maustaste/View in Repository lassen sich die Daten des Webservices auch im Jdeveloper anzeigen.

---> Nächster Schritt: Antrag auf neuen Webservice ins Repository stellen

Workshop: PL/SQL-Webservice erstellen, Webservice deployen

2010-10-11T08:58:00.000-07:00

Nachdem in den vorhergehenden Übungen der Webservice erstellt wurde und die Datenbank sowie der Weblogic Server vorbereitet wurden, kann jetzt der Webservice deployed werden.

Hierzu mit Rechtsklick auf das Projekt das Menü aufrufen und Deploy|WebServices auswählen.

'Deploy to Application Server wählen' und 'Next'

Den Application Server wählen, hier 'SOABPM' und 'Next'

Hier kann der Ziel-Server angegeben werden, was der gleiche sein sollte auf dem auch die Data Source angelegt wurde.

Noch einmal die Zusammenfassung und 'Finish'

Wenn alles geklappt hat, zeigt das Deployment Log unten '--- Deployment Finished ---'

Das Testen des Webservices erfolgt dann aus der Weblogic Server Administration Console. Links in der Domain Structure finden sich die Deployments, rechts muss ggf. über 'Next' geblättert werden bis die Hrservice-HRservice-context-root angezeigt wird. Durch Aufklappen des Baumes darunter findet man den hrInfoService, über den man weiter gelangt.

Auf dem Reiter 'Testing' befindet sich der Link zum Test client.

Bei einem Aufruf eines WLS in einer VM kommt es normalerweise zu einer Fehlermeldung, weil der WLS den Hostnamen aus seiner Sicht auflöst, was ausserhalb der VM typischerweise keine sinnvolle IP-Adresse ergibt. Ersetzt am die IP-Adresse aber durch den Hostnamen oder wahlweise durch die korrekte IP-Adresse, bekommt man den Test client, kann eine gültige empid eingeben und den Service über den gethrinfo-Button starten.

Sofern bis hier alles geklappt hat bekommt man die Daten zu der empid zurück, bei empid 100 ist das Ergebnis Steven King. Damit ist der Service fertig deployed und lauffähig.

---> Nächster Schritt: Webservice ins Enterprise Repository übernehmen

Workshop: PL/SQL-Webservice erstellen, Datasource auf dem Weblogic Server einrichten

2010-10-11T08:29:00.000-07:00

Bevor der Webservice auf den Weblogic Server deployed werden kann, muss eine Data Source eingerichtet werden, ansonsten würde das Deployment abgebrochen werden.
Zum Anlegen der Data Source wird die Weblogic Server Administration Console (http://hostname:7001/console) genutzt.

Die Datasources befinden sich links im Baum 'Domain Structure' unter Services / Data Sources. Dort kann rechts über den Button 'New/Generic Datasource' eine neue Data Source angelegt werden.

Der JDeveloper erwartet eine Data Source mit dem JNDI-Namen jndi/[Name der DB-Connection]DS, also in diesem Fall jdbc/OEL5R5hrDS. Die Data Source sollte das auch als Namen bekommen.

Die üblichen Verbindungsdaten, hier orcl, oel5r5, 1521, hr, hr

Über 'Test Configuration' können die Einstellungen auf Richtigkeit geprüft werden.

Sofern der Test mit 'Connection test succeeded' erfolgreich abgeschlossen ist, geht es hier mit 'Next' weiter.

Der Ziel-Server für die Data Source ist zu wählen, in diesem Fall ist der AdminServer anzuwählen. Mit 'Finish' wird die Erstellung der Data Source abgeschlossen.Somit verfügt die Weblogic-Instanz jetzt über die benötigte Data Source so dass im nächsten Schritt das Deployment erfolgen kann.

---> Nächster Schritt: PL/SQL-Webservice erstellen, Webservice deployen

Workshop: PL/SQL-Webservice erstellen, Webservice generieren

2010-10-11T06:18:00.000-07:00

Im nächsten Schritt wird ein Webservice basierend auf der im vorherigen Schritt erstellten PL/SQL-Prozedur erstellt um die Angaben aus der Datenbank an den Prozess zu liefern. Dieser Webservice kann automatisch mit dem JDeveloper generiert werden.

Hierzu wird eine neue Application erstellt über das Application Menü | New Application.

Es wird eine Generic Application erstellt, der Name der Anwendung wird gesetzt, z.B. HRservice.

Ein Project Name wird vergeben und die Technologie 'Web Services' ausgewählt, diese zieht automatisch die Technologie 'Java' nach sich.

Der Package-Name wird auf hrservice gesetzt...

… und das leere Projekt ist fertig.

Im nächsten Schritt muss dem leeren Projekt der Webservice hinzugefügt werden.

Per Rechtsklick auf den Projektnamen wird der New-Dialog geöffnet.

Ausgewählt wird die Technologie Web Services | PL/SQL Web Service.

J2EE 1.4 JAX-RPC ist OK

Hier kann der Name gesetzt werden, z.B. hrInfoService. Die bereits angelegte Datenbank-Verbindung wird hier ausgewählt und das einzige enthaltene Package bereits vorbelegt.

Message Format RPC/Literal ist OK

Hier wird die Prozedur GETHRINFO ausgewählt. Die Prozedur GETHRINFO2 wird erst in einem späteren Schritt benötigt und bleibt vorerst abgewählt.

Next ...

... und Finish

Einen kleinen Moment warten ...

… und fertig.

Mit dem eingebauten Weblogic Server kann der gerade erzeugte Webservice sofort getestet werden. Hierzu wird per Rechtsklick auf den Service die Option 'Run' ausgewählt.

Falls der interne WLS das erste Mal gestartet wird, legt er automatisch eine Domain an.

Wenn der Service fertig übersetzt und deployed ist, wird die URL im JDeveloper angezeigt.

Per Klick auf die URL erscheint der HTTP Analyzer. Dort kann jetzt die Employee-ID eingegeben werden (z.B. 100) und per Send Request der Webservice aufgerufen werden. Auf der rechten Seite werden dann die Ergebnisse ausgegeben.
Somit ist der Webservice fertig gestellt und auf Lauffähigkeit getestet.

---> Nächster Schritt: PL/SQL-Webservice erstellen, Datasource auf dem Weblogic Server einrichten

Workshop: PL/SQL-Webservice erstellen, Datenbank vorbereiten

2010-10-11T05:08:00.000-07:00

Damit der Webservice erstellt werden kann, müssen zunächst ein paar Schritte auf der Datenbank durchgeführt werden. Weiter unten findet sich ein Script, welches die folgenden Schritte komplett ausführt. Zum setzen des Oracle-Environments kann das Oracle-Skript oraenv wie folgt genutzt werden, die Voreinstellung orcl kann übernommen werden.

. oraenv

Zunächst wird die Datenbank-Tabelle EMPLOYEES im Schema HR um eine Spalte HOLIDAYS erweitert, welche sich unfairerweise aus dem Gehalt geteilt durch 100 ergibt.

alter table EMPLOYEES add(holidays NUMBER);
update employees set holidays= round( salary/100 );
commit;

Weiterhin wird ein Package HR_INFO erstellt, welches eine Stored Procedure GetHRinfo enthält die uns die gewünschten Informationen aus der Datenbank holt.

CREATE OR REPLACE PACKAGE HR_INFO AS
  PROCEDURE GETHRINFO
(
  EMPID IN NUMBER,
  FIRSTNAME OUT VARCHAR2,
  LASTNAME OUT VARCHAR2
);
  PROCEDURE GETHRINFO2
(
  EMPID IN NUMBER,
  FIRSTNAME OUT VARCHAR2,
  LASTNAME OUT VARCHAR2,
  HOLIDAYS OUT NUMBER
);
END HR_INFO;
/

CREATE OR REPLACE PACKAGE BODY HR_INFO AS
PROCEDURE GETHRINFO
(
  EMPID IN NUMBER,
  FIRSTNAME OUT VARCHAR2,
  LASTNAME OUT VARCHAR2
) AS
BEGIN

  select first_name, last_name
  into firstname, lastname
  from employees
  where employee_id = empid;
END GETHRINFO;

PROCEDURE GETHRINFO2
(
  EMPID IN NUMBER,
  FIRSTNAME OUT VARCHAR2,
  LASTNAME OUT VARCHAR2,
  HOLIDAYS OUT NUMBER
) AS
BEGIN
  select first_name, last_name, holidays
  into firstname, lastname, holidays
  from employees
  where employee_id = empid;
END GETHRINFO2;

END HR_INFO;
/

Diese Schritte werden komplett von dem Script HR_INFO.sql (~oracle/Workshop) durchgeführt. Ausgeführt wird es mit

sqlplus hr/hr @HR_INFO.sql

Damit ist die Datenbank für die folgenden Workshop-Aufgaben fertig vorbereitet.

---> Nächster Schritt: PL/SQL-Webservice erstellen, Webservice generieren

JDeveloper Workshop Setup für BPMN und Enterprise Repository

2010-10-05T06:42:00.000-07:00

Für den Handson-Workshop kann der JDeveloper sowohl innerhalb der VM, als auch im Gastsystem benutzt werden. Diese Beschreibung geht von einer Installation im Gastsystem aus, aber der JDeveloper in der VM verhält sich analog.
Für den Workshop benötigt werden die Plugins für SOA, BPM und das Enterprise Repository sowie die Server-Verbindungen zu Datenbank, Application Server und Repository.
Bei bestehender Internet-Verbindung und mit einem OTN-Account können die Plugins direkt aus dem JDeveloper heruntergeladen werden. Wichtig hierbei ist, die Proxy-Einstellungen zu beachten unter Tools|Preferences|Web Browser and Proxy.

Falls in diesem Dialog Änderungen vorgenommen werden, ist es wichtig den JDeveloper danach neu zu starten damit diese auch aktiviert werden.

Über den Menüpunkt Help|Check for Updates gelangt man in den entsprechenden Wizard. Hier 'Next' klicken.

Die korrekten Update-Center sind bereits voreingestellt. Die Workshop-Teilnehmer bekommen die Extensions mit den Kursunterlagen und können hier auch 'Install From Local File' auswählen (aktuell lassen sich die benötigten Jdeveloper-Erweiterungen auch manuell von OTN herunterladen).

Hier werden die folgenden Erweiterungen ausgewählt:

Oracle BPM Studio 11g
Oracle Enterprise Repository Adapter
Oracle Enterprise Repository Harvester
Oracle SOA Suite Composite Editor

Ein OTN-Account wird benötigt...

... und die neuen Erweiterungen werden angezeigt.

Ein Neustart ist notwendig.
Sind alle Erweiterungen installiert, können die Verbindungen eingetragen werden.

Über File|New|Database Tier lässt sich die neue Database Connection anlegen.

Hier werden die Verbindungsdaten eingegeben, über den 'Test Connection' Button lässt sich die Verbindung überprüfen.

Über View|Database|Database Navigator lässt sich die Verbindung im JDeveloper anzeigen.

Über View|Application Server Navigator gelangt man in die entsprechende Ansicht. Hier ist bereits der intgrierte WLS eingetragen. Auf Rechtsklick erscheint die Auswahl zum Anlegen einer neuen Verbindung.

Standalone Server ist bereits voreingestellt.

Jetzt wird der Name vergeben, z.B. SOABPM

Das Admin-Password wird benötigt (standardmässig 'welcome1', im Workshop 'Oracle123')

Hier sind die korrekten Zugangsdaten einzutragen. Für den Workshop sind dies oel5r5 als Hostname und bpm_domain als Weblogic Domain.

Wie gewohnt lässt sich die Verbindung hier testen und der Wizard mit Finish abschliessen.

Der Application Server wird daraufhin im Navigator angezeigt und kann jetzt aus dem JDeveloper genutzt werden.
Zum Abschluss wird noch die Verbindung zum Enterprise Repository benötigt.

Wiederum über File|New, dann über General|Connections kann die Oracle Enterprise Repository Connection ausgewählt werden.

Auch hier wieder die Parametereingabe (Password Oracle123) mit entsprechender Testmöglichkeit, die URL ist http://oel5r5:7101/oer.

Über View|Resource Palette können alle eingetragenen Verbindungen angezeigt werden.

Speicherzuteilung erhöhen

Für die Wizards der BPM-Extension benötigt der JDeveloper mehr Speicher, als für den reinen Java-Betrieb. Daher sollte ihm mehr RAM zugestanden werden, zu konfigurieren ist dies in der Datei (Windows)

d:\Oracle\Middleware\jdeveloper\jdev\bin\jdev.conf

Darin wird die Zeile mit dem Parameter AddVMOption wie folgt geändert:

AddVMOption -XX:MaxPermSize=512M

Nach einem Neustart steht dem JDeveloper dann auch das benötigte RAM zur Verfügung.

Damit ist das Basis-Setup für den Workshop abgeschlossen.

--> Nächster Schritt: BPMN Application und Project anlegen

Setup des VirtualBox Images

2010-10-03T08:46:00.000-07:00

Nach der Installation der VBox-Software für das jeweilige Host-Betriebssystem muss die VM eingebunden und gestartet werden.

Über 'Datei|Appliance importieren' kann die VM importiert werden.

Im 'Appliance importieren'-Dialog kann die entsprechende Datei BPM-SOA-Gov-WS.vmdk ausgewählt werden.

Die Einstellungen werden angezeigt und die Appliance importiert.

Daraufhin steht das VirtualBox-Image zur Verfügung und kann gestartet werden.

Nach dem Linux Bootvorgang erscheint der Login-Bildschirm. Das Login erfolgt im Workshop mit dem User 'oracle'.

Auf dem Linux-Desktop sind bereits Verknüpfungen für die im Workshop benötigten Programme hinterlegt.

Zuerst wird die Datenbank gestartet.

Es öffnet sich ein Shell-Fester, welches sich nach dem Start der Datenbank wieder schliesst.

Im nächsten Schritt wird der Weblogic Server mit der SOA-Suite gestartet.

In dem sich öffnenden Konsolen-Fenster erscheint am Ende 'SOA Platform is running and accepting requests'.

Die letzte zu startende Komponente ist ein separater Weblogic Server mit dem Oracle Enterprise Repository.

Wenn der Startvorgang abgeschlossen ist, erscheint unten

Zu diesem Zeitpunkt sind alle benötigten Server-Prozesse hochgefahren. Der JDeveloper kann wahlweise innerhalb der JVM oder nach separater Installation im jeweiligen Host-Betriebssystem genutzt werden. In diesem Fall ist die Adresse der Server in der JVM die 192.168.56.101.

--> Nächster Schritt: JDeveloper Setup

SOA-BPM-Governance Handson-Workshop

2010-10-01T04:26:00.000-07:00

Anfang nächstes Jahres werde ich zusammen mit meinem Kollegen Bernhard Fischer-Wasels vom SOA und Logistik Blog wieder eine Hands-On Workshop-Reihe in Deutschlands Norden durchführen. Geplant sind zunächst 3 Workshops in den Oracle Geschäftstellen in Hamburg, Hannover und Berlin. Weitere gerne auf Anfrage, bei ausreichend Nachfrage können auch Workshops in anderen Teilen Deutschlands angeboten werden.
Grundsätzlich geht es wieder um die Oracle SOA Suite, aber dieses Mal werden auch die Produkte Oracle BPM-Suite und Oracle Enterprise Repository berücksichtigt. Da die Installation der SOA-Suite bereits Bestandteil der letzten Workshop-Reihe war, bekommt jeder Teilnehmer ein VirtualBox-Image in dem die benötigte Software bereits vorinstalliert ist. Konkret handelt es sich um Oracle Enterprise Linux 5R5, Oracle DB 11.2, Weblogic Server 10.3.4, SOA Suite 11g PS3, BPM Suite, JDeveloper 11g sowie SQLDeveloper.
Die Anleitungen zu den einzelnen Übungen werde ich hier im BLOG veröffentlichen und mit dem Tag soa_bpm_gov_ws versehen, so dass hier immer der aktuelle Stand der Übungen zu finden ist. Teilweise handelt es sich um Wiederholungen von Anleitungen, die ich hier bereits gepostet habe. Da ich aber die gleichen Bezeicher wie im Workshop benutzen möchte, sind diese Anleitungen dann in leicht veränderter Form hier doppelt vorhanden. Die folgende Liste der Übungen wird mit dem Fertigwerden des Workshops aktualisiert.

Die Anmeldeseite für den Workshop ist zu finden unter http://apex.oracle.com/pls/apex/f?p=38040:1:4671628964056695.

Wir freuen uns auf Ihr Kommen!

Oracle Enterprise Repository installieren (Linux)

2010-09-30T08:38:00.000-07:00

Für die Installation des Oracle Enterprise Repositories (OER) muss bereits eine Oracle-DB sowie ein Weblogic-Server installiert sein. In der Datenbank müssen vorher bereits User erzeugt und Tablespaces angelegt sein. Die Scripte dazu sind in der Dokumentation schon fertig vorgeben:

CREATE TABLESPACE OER_DATA
    DATAFILE '/home/oracle/app/oracle/oradata/orcl/oer_data.dbf' SIZE 300M
AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;

CREATE TABLESPACE OER_LOB
    DATAFILE '/home/oracle/app/oracle/oradata/orcl/oer_lob.dbf' SIZE 300M
AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;

CREATE TABLESPACE OER_INDEX
    DATAFILE '/home/oracle/app/oracle/oradata/orcl/oer_index.dbf' SIZE 300M
AUTOEXTEND ON NEXT 5120K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;

Zuerst werden die benötigten tablespaces erstellt. Danach wird noch ein Repository-User angelegt:

CREATE USER OER IDENTIFIED BY welcome1
DEFAULT TABLESPACE OER_DATA
    TEMPORARY TABLESPACE TEMP;

GRANT CREATE MATERIALIZED VIEW TO OER;
GRANT CREATE SEQUENCE TO OER;
GRANT CREATE SESSION TO OER;
GRANT CREATE SYNONYM TO OER;
GRANT CREATE TABLE TO OER;
GRANT CREATE TRIGGER TO OER;
GRANT CREATE VIEW TO OER;
GRANT UNLIMITED TABLESPACE TO OER;

Im Gegensatz zu vielen anderen Oracle-Produkten wird das OER noch nicht über den Oracle Installer installiert.

Statt dessen liegt der OER-Installer als JAR-File vor und wird über ein vorhandenes JDK installiert via

java -jar OER111130_generic.jar

Hierbei bietet sich an, das JDK des WLS zu nehmen, in dessen Home-Verzeichnis das OER installiert werden soll.

Im ersten Screen werden noch einmal die Vorbedingungen aufgeführt.

Hier wird dann das bestehende Middleware-Home ausgewählt.

Die Vorgabe für das Zielverzeichnis kann so übernommen werden.

Als Zielarchitektur ist der WLS 11 bereits voreingestellt.

Bei der Auswahl des Ports ist zu beachten, dass dieser möglicherweise schon von einer bestehenden WLS-Domain belegt sein kann. Hier also ggf. anpassen, z.B. wie hier von 7001 auf 7101.

Hier lässt sich jetzt einstellen, dass die Repository Datenbank festgelegt wird.

Hier werden die Tablespaces wie oben erstellt angegeben.

Hier werden noch die Verbindungsinformationen zur Repository-DB benötigt. Ausserdem muss der JDBC-Treiber angegeben werden. Dieser ist zu finden im Datenbank-Home unter $ORACLE_HOME/jdbc/lib/ojdbc6.jar .

Wenn alles richtig aufgesetzt wurde, wird dies nach einem Test bestätigt.

Und fertig. Als nächster Schritt kann eine WLS-Domain erstellt werden, die das OER beherbergt wie unter Oracle Enterprise Repository in den Admin Server installieren beschrieben.

Tutorial 6: WebService auf externen WLS deployen

2010-09-29T07:41:00.000-07:00

Im Tutorial 4 habe ich gezeigt, wie man im JDeveloper einen einfachen Webservice auf dem internen Weblogic deployed und ausführt. Teil 3 zeigte, wie man ein einfaches Servlet auf einem externen WLS zur Ausführung bringt. In diesem Tutorial wird jetzt beides zusammen genommen und der Webserivce auf dem externen WLS ausgeführt.

Hierzu kann der HelloWS aus Teil 4 oder ein beliebiger anderer (hier SimpleWebservice) genommen werden. Anstelle von 'Run' wird hier per RMB auf dem Projekt die Option 'Deploy|WebServices' ausgewählt.

Hier wählt man 'Deploy to Application Server'

Falls der Weblogic Server so wie hier noch nicht eingetragen ist, wird er über den 'Add'-Button hinzugefügt.

Die Verbindung bekommt einen Namen.

Anmelden ist wichtig ...

... und die Verbindungsdaten werden benötigt.

Wenn bis hier alles richtig gelaufen ist, klappt auch der Verbindungstest.

Nun steht der neu angelegte Server auch im Deployment-Dialog zur Auswahl.

Hier wird der gewünschte Ziel-Server aus der Domain ausgewählt.

In der Summary dann einfach auf 'Finish' klicken.

Sofern alles gelappt hat, sollte das Log wie oben aussehen.

Das Überprüfen des Webservices geht komfortabel aus der Weblogic Console (z.B. http://localhost:7001/console). Über den Menüpunkt 'Deployments' in der Domain Structure werden rechts die aktuellen Deployments angezeigt.

Hat man sehr viele Deployments, so wie in meinem Fall eine komplette SOA- und BPM-Suite, muss man ggf. über den 'Next'-Link ein paar Seiten weiter blättern. Über einen Klick auf das + vor der Web Application und ebenso vor dem Label 'Web Services' wird der Link auf den eben hinzugefügten Webservice angezeigt.

Über diesen Link kommt man auf die Seite für den jeweiligen Webservice. Auf dem Reiter 'Testing' findet man dann unten (ggf. über das + die Unterpunkte für den jeweiligen Webservice anzeigen) die Links auf die WSDL und den Test Client.

Durch Klick auf den entsprechenden Link startet der Weblogic Test Client. Sollte es Probleme bei Aufruf geben, dann liegt das häufig daran, dass der Hostname im Link nicht richtig aufgelöst wurde, z.B. bei Servern mit mehreren IP-Adressen. Hier hilft dann, die falsche IP-Adresse wieder mit dem richtigen Hostnamen zu überschreiben. Dies muss zwei mal erfolgen, hinter 'wsdlUrl=' steht ggf. noch einmal die falsch aufgelöste IP-Adresse.

Wenn alles geklappt hat, lassen sich oben die Parameter eintragen und der Webserive aufrufen. Unten erscheint dann die Rückmeldung des Webservices.

Fix: SOA Suite startet nicht, Heap allocation error unter Windows

2010-07-22T01:28:00.000-07:00

Nach einer erfolgreichen SOA Suite 11.1.1.3 Installation kann es passieren, dass diese sich nicht starten lässt, statt dessen kommt folgende Fehlermeldung:

Could not reserve enough space for object heap
Could not create the Java virtual machine.

Normalerweise hängt dies von den Memory-Parametern ab, die in der setSOADomainEnv.cmd der jeweiligen Domain gesetzt werden. Die defaults sind z.B. für Windows 32-Bit zu hoch eingestellt. Wenn die Summe der Parameter XMX und PermSize grösser als 1408 wird, startet die SOA Suite nicht mehr. Statt dessen sollten die folgenden Einstellungen benutzt werden.:

set DEFAULT_MEM_ARGS=%DEFAULT_MEM_ARGS% -XX:PermSize=128m
set DEFAULT_MEM_ARGS=-Xms512m –Xmx1024m

Falls das nicht hilft, kann das auch ein nicht sauber installiertes JDK als Ursache haben. In meinem Fall waren noch Reste von älteren JDK's auf meinem System, die sich z.T. auch nicht mehr sauber deinstallieren liessen. Statt dessen wurden in der Systemsteuerung/Software noch 1.5er JDK's angezeigt, die beim Versuch diese zu löschen eine Fehlermeldung ausgaben.
Um das Problem zu beheben, sollte wie folgt vorgegangen werden:

Alle JDK's, die sich noch von der Systemsteuerung deinstallieren lassen, sollte von hier aus entfernt werden.
Danach sind alle Reste der JDK's im Dateisystem zu löschen
Als letztes (der zeitaufwändige Teil) sind alle Verweise auf die JDK's mit dem Registry Editor aus der Windows Registry zu löschen.
Jetzt kann ein neues JDK in der passenden Version installiert werden

Damit sollte das Problem behoben sein.

Tutorial 5: Webservice im Oracle Enterprise Repository hinterlegen

2010-06-09T09:28:00.000-07:00

Als einfaches Szenario soll ein Webservice (z.B. jener aus Tutorial 4) im Oracle Enterprise Repository abgelegt werden. Danach kann z.B. eine SOA-Anwendung aus dem JDeveloper darauf zugreifen.

Harvester vorbereiten
Um den Webservice mit allen Artefakten nicht manuell im Repository einzutragen, soll der mitgelieferte Harvester genutzt werden. Hierfür sind ein paar Vorbereitungen zu treffen, die aber alle so auch dokumentiert sind.
Zunächst müssen für den Harvester einige Artefakte importiert werden, die sich im Harvester-Solution-Pack befinden unter ORACLE_HOME>/repository111/core/tools/solutions /11.1.1.2.0-OER-Harvester-Solution-Pack.zip

Dazu wird der Import / Export Client genutzt, der sich im OER unter Admin befindet.

Die oben angegebene Datei wird ausgewählt und importiert.

Als nächstes ist der eigentliche Harvester zu entpacken wie in der Dokumentation beschrieben. Die Datei befindet sich unter /repository111/core/tools/solutions/11.1.1.2.0-OER-Harvester.zip, ich habe sie z.B. entpackt nach /repository111/harvester.

Das Harvesting
Grundsätzlich können dem Harvester alle Parameter auf der Kommandozeile oder in einer Konfigurations-Datei übergeben werden. Eine Beispieldatei names HarvesterSettings.xml wird bereits mitgeliefert.
Hier der relevante Ausschnitt aus meiner HarvesterSettings.xml, im wesentlichen werden dort die Zugangsdaten für das Repository und den Admin-Server des WLS, der den Service beherbergt hinterlegt.

Die Passwörter müssen verschlüsselt abgelegt werden. Entweder man schreibt die Passwörter zunächst im Klartext in die Datei und verschlüsselt diese nachträglich mit dem ebenfalls mitgelieferten encrypt.bat.

Oder man nutzt eine online-Anwendung, die mit dem OER mitgeliefert wird unter http://localhost:7101/oer/diag/encryptstrings.jsp.

Den richtigen Anwendungs-Namen für den zu harvestenden Webservice erhält man aus der WLS Administration Console unter Deployments, dieser muss genau so angegeben werden weil der Harvester sonst ins Leere läuft.

Ist alles richtig konfiguriert, lässt sich der Harvester starten über z.B. harvest -settings HarvesterSettings3.xml und die Ausgabe sollte ähnlich wie oben aussehen.

Überprüfen des Webservices im Oracle Enterprise Repository
Von der Haupseite des OER macht man am besten eine Suche nach Assets vom Status 'Unregistered'.

Danach sollten rechts die gesammelten Artefakte zu unserem Service auftauchen. Generiert wurden neben dem eigentlichen Service noch die Endpoint-, Interface-, WSDL- und XSD-Artefakte.

Im Navigator lassen sich die Abhängigkeiten anzeigen (der linke Button über der Beschreibung in der unteren Hälfte).

Nutzen des Services im JDeveloper
Um das Enterprise Repository aus dem JDeveloper nutzen zu können, muss zunächst die entsprechende Erweiterung im JDeveloper installiert sein. Sofern dies noch nicht erfolgt ist, kann diese über Help|Check for Updates installiert werden.

Mit der passenden Erweiterung taucht unter IDE Connections jetzt auch 'Oracle Enterprise Repository' auf, über einen Rechtsklick lässt sich hier eine neue Verbindung anlegen und testen.

Als Test lässt sich z.B. eine SOA-Anwendung mit einem BPEL Prozess anlegen.

Diese bekommt gleich einen BPEL Prozess

welcher vom JDeveloper automatisch geöffnet wird.

Bevor nun auf das Repository zugegriffen werden kann, muss dieses noch auf Applikations-Ebene bekannt gemacht werden.

Hierzu werden die Application Properties geöffnet

und das vorher angelegte Repository der Anwendung zugeordnet.

Hierzu wird im Composite, nicht im BPEL-Prozess, ein Web Service rechts in die External References gezogen.

Die WSDL URL Suche wird geöffnet

Umschalten auf Resource Palette

Im Enterprise Repository findet sich dann der eben eingetragene Service.

Die WSDL URL wurde entsprechend übernommen.

Damit steht der Webservice jetzt dem Prozess zur Verfügung, und kann genau so genutzt werden wie ein Manuell eingetragener Prozess.

Oracle Enterprise Repository in den Admin Server installieren

2010-05-27T06:22:00.000-07:00

Analog zur Installation der SOA/BPM-Suite in den Admin-Server lässt sich auch das Enterprise Repository in den Admin-Server installieren. Auch in diesem Fall ist diese Variante für einen produktiven Einsatz nicht zu empfehlen. Zum Austesten der Software auf einem nicht übermässig stark ausgestatteten Entwickler-Rechner kann dies aber durchaus Sinn machen.

Zunächst wird das OER gemäss der Dokumentation in ein bestehendes Weblogic-Home installiert (s. auch hier) und der Domain Configuration Wizard aufgerufen.

Als einzige Option wird das Enterprise Repository ausgewählt.

Das Installationsverzeichnis und der Domain-Name wird vorgegeben

Der Benutzername wird gesetzt

und das JDK ausgewählt

Hier jetzt wichtig: Sowohl den Administrations-Server, als auch den Managed Server auswählen.

Falls auf der gleichen Maschine eine weitere Domain (z.B. SOA Suite) läuft, sollte der Port angepasst werden.

Hier die entscheidende Stelle: der Managed Server muss hier gelöscht werden:

Hier wird kein Cluster konfiguriert ...

... aber eine Maschine.

Noch eine kurze Zusammenfassung ...

und fertig

Anleitung: SOA/BPM-Suite komplett in den Admin-Server installieren

2010-05-21T06:38:00.000-07:00

Im voraus ein Hinweis: dieses ist keine für einen Produktionsbetrieb empfohlene Konfiguration. Allerdings kann es nützlich sein, für einen Entwickler-Rechner die komplette SOA- oder BPM-Suite in den Admin-Server zu installieren, um Speicherplatz zu sparen. Das ist nicht ideal, aber eine Alternative falls der entsprechende Rechner zu schwach ausgestattet ist um neben dem Admin- auch den SOA- und den BAM-Server zu betreiben.

Für die BPM-Suite 11.1.1.3 muss zunächst der WebLogic Server 11.1.1.3, die SOA-Suite 11.1.1.2 und das SOA-Suite 11.1.1.3 Upgrade installiert sein. Danach führt man das Repository Creation Utility (RCU) aus. Bis hierher läuft noch alles entsprechend dem Install Guide.

Der eigentliche Trick passiert beim Erstellen der Domain über das Configuration Utility.

Zunächst wählt man die gewünschten Komponenten aus

und gibt den Speicherort an:

Dann wählt man das JDK aus

und konfiguriert die Datenbank-Schemata.

Soweit ist alles noch entsprechend dem Install Guide. Bei der Auswahl der optionalen Konfiguration werden jetzt aber sowohl der Admin-Server, als auch die Managed Server ausgewählt

Den Admin-Server kann man so lassen,

aber der BAM-Server und der SOA-Server müssen gelöscht werden.

so dass die Konfigurationsseite wie folgt aussieht:

Den Cluster habe ich an dieser Stelle ausgelassen,

Aber die Maschine sollte man ruhig konfigurieren:

In Ermangelung anderer Server bleibt dem Konfigurationsassistenten jetzt nichts anderes übrig, als die SOA, BPM und BAM-Komponenten in den Admin-Server zu installieren.

Vor dem Start muss noch die Speicherzuteilung in der setSOADomainEnv.cmd (bzw .sh) angepasst werden, welche sich im Domain-Home unter /bin befindet. Folgende Einstellungen sollten dort gemacht werden, indem die bestehenden Werte entsprechend überschrieben werden:

set JAVA_OPTIONS=%JAVA_OPTIONS%
set DEFAULT_MEM_ARGS=-Xms512m -Xmx512m
set PORT_MEM_ARGS=-Xms512m -Xmx512m

Damit ist die komplette Installation im Admin-Server lauffähig, wenn auch sehr langsam. Wer mehr Speicher erübrigen kann, kann die Werte etwas hochsetzen. Zumindest auf 32-Bit Systemen besteht allerdings die Gefahr, dass der Server dann nicht mehr startet, weil er vom Betriebssystem nicht genug Speicher bekommt.

ADF Mobile Demos für das iPhone verfügbar

2010-03-10T04:04:00.000-08:00

Von Oracle gibt es jetzt ein paar ADF Mobile Demos die z.B. direkt vom iPhone aus aufgerufen werden können. Diese finden sich unter http://stshld.oracle.com:8888/demo/faces/home.jspx. Hier ist sehr schön zu sehen, wie iPhone spezifische Bedienelemente eingebunden werden können. Weitere Informationen zu ADF Mobile gibt es auf der entsprechenden OTN Seite.

Kein JNDI-Zugriff mit SOA-Suite 11.1.1.2?

2010-03-01T07:38:00.000-08:00

Leider gibt es manchmal ein Problem beim Zugriff auf den JNDI-Tree aus der WebLogic Console. Der entsprechende Link reagiert mit einer Fehlermeldung, hinterher ist der Server-Status nicht mehr RUNNING sondern UNKNOWN.
Hierzu hat Oracle den folgenden Bug eingetragen: "BUG 9049147 - RN:CLICKING ON VIEW JNDI TREE MAKES MANAGED SERVER STATUS TO "UNKNOWN". Bis es hierzu einen offiziellen Fix von Oracle gibt, hilft dieser Workaround:
In der Datei /bin/setDomainEnv.sh oder .cmd muss an die Zeile beginnend mit
JAVA_OPTION der folgende Parameter angefügt werden: -Dweblogic.system.StreamPoolSize=0. Anschliessend sind die Server neu zu starten und das Problem sollte gelöst sein.

Die Code-Ninjas

2010-02-10T08:58:00.000-08:00

Bernhard Fischer-Wasels vom SOA-Logistik BLOG hat mich auf diese sehr wissenschaftliche Betrachtung des JDevelopers aufmerksam gemacht ;-)

Tutorial 4: Web Serivce deployen

2010-02-10T08:26:00.000-08:00

Zunächst benötigen wir einen Web Service mit der entsprechenden "Hello World" Geschäftslogik. Dazu legen wir zunächst ein neues Projekt in der gleichen Anwendung (File|new|Projects|Generic Project) an. In diesem erstellen wir eine einfach Java-Klasse:

Diese bekommen wir z.B. via rechter Maus (RMB = Right Mouse Button) auf dem Projekt, dann New|Java|Java Class.

Diese bekommt dann die Methode sayHello mit der entsprechenden "Geschäftslogik", idealerweise in der jeweiligen Landessprache. Für alle Norddeutschen z.B.:

public String sayHello(String s)
{
return "Moin, moin " + s;
}

Um diese Klasse mit den benötigten Annotationen für den Web Service zu versehen, bietet der JDeveloper wieder einen entsprechenden Wizard an:

Per RMB auf der Java-Klasse kann die Funktion 'Create Web Service...' ausgewählt werden.

Die Vorgabe 'Java EE 1.5 with support for JAX-WS Annotations' ist genau richtig

Hier kann man die default-Werte bestätigen und die gewünschte Methode auswählen. Sollte die Methode nicht auswählbar sein, so kann man die Zeile trotzdem aktivieren und den JDeveloper über den Knopf 'Why Not?' nach dem Grund fragen.

Als Ergebnis bekommen wir einen fertigen Webservice vom JDeveloper geliefert, der so direkt ausführbar ist. Dazu wählen wir z.B. direkt auf dem Source-Code via RMB die Funktion 'Run' (grüner Pfeil).

Als Ergebnis erscheint der Web Service Testclient des JDeveloper. Hierin kann man jetzt das Argument (z.B. einen Namen) eingeben und via Send Request den Webservice direkt aufrufen. Das Ergebnis erscheint dann auf der rechten Seite.

Wer es genau wissen möchte, klickt unten auf den Reiter HTTP Content und kann sich die übertragene SOAP-Message im Detail ansehen.

WSDL gehört nicht gerade zu den lesbarsten Dialekten, daher ist an dieser Stelle auch der eingebaute WSDL-Browser nützlich.

Das Deployment auf den externen WLS läuft dann genau wie bei dem vorherigen Beispiel mit dem Servlet ab.

Wenn alles geklappt hat, taucht der Web Service in den Deployments des WLS auf. Hier kann man die Baumstruktur aufklappen, bis der eigentliche Service angezeigt wird.

Klickt man diesen an, kann man auf dem Reiter 'Testing' den 'Test Client' auswählen.

Hier lässt sich, genau wie im JDeveloper, der Parameter für den Web Service Aufruf eingeben und der Web Service aufrufen.

Auch der Web Service Tester des WLS zeigt die übertragenen SOAP Messages übersichtlich an. Dieses Beispiel sollte zeigen, wie einfach es ist, aus einem vorhandenen Java Code mit dem JDeveloper einen Web Service zu erzeugen und diesen auf dem Web Logic Server auszuführen.

WLS Tutorial 3: Deployment auf extrernen WLS

2010-02-10T04:56:00.000-08:00

Nachdem das Servlet auf dem im JDeveloper integrierten WLS läuft, soll es jetzt auf einen standalone WLS deployed werden. Hierzu muss im JDeveloper zunächst eine Application Server Connection eingerichtet werden.

Hierzu wählt man per Rechtsklick auf das Projekt Deploy|New Deployment Profile...

Für das Servlet wird das Deployment Profile 'WAR File' ausgewählt ...

... und die Anwendung bekommt einen Namen. Der Rest kann mit den default-Werten akzeptiert werden. Wenn man hinterher erneut per Rechtsklick|Deploy auswählt, wird dieses als Ziel (timeapp to servername) angeboten.

Hier wählt man 'Deploy to Application Server',

wählt hier noch einmal die korrekte Verbindung aus und entfernt ggf. den Haken bei 'Deploy to all server instances in the domain' (wichtig, wenn sich in der gleichen Domain weitere Server befinden, die für andere Zwecke geplant sind).

Sofern man den Haken entfernt hat, folgt die Auswahl der betreffenden Server.

Nach Abschluss startet der JDeveloper das Deployment. Im Deployment-Log sollte überprüft werden, dass keine Fehler gemeldet werden.

In der Weblogic Console taucht die Anwendung jetzt unter Deployments auf und steht somit zur Verfügung.

Die URL ist abhängig von der Konfiguration des Servers und der Einstellungen im Deployment Profile, in meinem Fall ist es http://127.0.0.1:7103/WLS-Tutorial-TimeServlet-context-root/timeservlet.

Die Einstellungen des Deployment Profiles sind nur beim ersten Mal zu machen, danach kann einfach mit den bestehenden Einstellungen deployed werden. Somit ist ein externer WLS genau so einfach zu nutzen wie der im JDeveloper integrierte

Tip: Installation Oracle Service Registry 11g

2010-02-08T08:56:00.000-08:00

Die Oracle Service Registry 11g (OSR) steht jetzt auf OTN zum Download zur Verfügung. Die Installationsanleitung verschweigt leider ein kleines aber extrem wichtiges Detail: das Installationsverzeichnis muss sich direkt in einem bestehenden WebLogic Server Homeverzeichnis befinden. Ist dies nicht der Fall, läuft der Installer zwar ohne Fehlermeldungen durch, die OSR ist aber nicht korrekt installiert.
Eine detailierte Anleitung, wie es richtig gemacht wird, gibt es im BLOG von Edwin Biemond.

WLS Tutorial 2: WebLogic Server mit Eclipse

2009-10-16T07:21:00.000-07:00

Natürlich funktioniert das Ganze auch mit Eclipse, idealerweise installiert man hierzu das Oracle Enterprise Pack for Eclipse (OEPE). Damit ist das Ganze dann kaum schwieriger als mit dem JDeveloper.

Dazu passend gibt es ein Oracle-by-Example (OBE) unter http://www.oracle.com/technology/obe/obe11jdev/11/eclipse_intro/eclipse_intro.html?msgid=7575543.

WLS Tutorial 1: Ein einfaches Servlet

2009-09-28T08:49:00.000-07:00

Zunächst soll ein einfaches Servlet im JDeveloper erstellt und auf dem beiliegenden Weblogic Server ausgeführt werden. Alle, die bereits die Kombination JDeveloper 10g und oc4j kennen, werden feststellen, dass sich bishier nur wenig für den Entwickler geändert hat.
Zunächst wird eine neue Application WLS-Tutorial aus dem Applications Drop Down Menü erstellt. Diese ist vom Typ 'Generic Application'. Auf der zweiten Seite des Dialogs bekommt das Projekt einen Namen, z.B. 'SimpleServlet'. Dann wird 'JSP and Servlets' den Project Technologies hinzugefügt, Java kommt automatisch dazu. Auf der nächsten Seite kann man noch einmal die Pfade überprüfen und dann bestätigen.

Über den Menüpunkt New bekommt man den Dialog in dem man in der Baumdarstellung unter 'Web Tier|Servlets' den Punkt 'HTTP Servlet' anwählen kann. Daraufhin erscheint ein Wizard in dem man auf der zweiten Seite die Voreinstellung 'Servlet 2.5' stehen lassen kann.
Auf der nächsten Seite kann man dem Servlet einen etwas netteren Namen geben, z.B. 'TestServlet'. Die restlichen Seiten kann man so stehen lassen und bekommt dafür den Quelltest des neuen Servlets.

Um das Servlet ein wenig dynamischer zu gestalten, fügen wir über der Zeile mit dem letzten out.println Kommando noch folgende Zeile hinzu:

out.println(new Date());

Damit wäre die Geschäftslogik abgeschlossen und das Servlet ist bereits ausführbar. Dazu reicht es, den 'Run'-Button oben in der Toolbar (das grüne Dreieck) anzuklicken. Dadurch wird der interne Weblogic gestartet und das Servlet deployed.

Falls sich der Browser mit dem Servlet nicht durch Klick auf den Link ausführen lässt, dann kann man den Link auch einfach in die Adresszeile des Browsers kopieren. Das Ergebnis sollte auf jeden Fall wie folgt aussehen:

Auffällig ist der lange Name der context-root, den der JDeveloper automatisch generiert hat: WLS-Tutorial-SimpleServlet-context-root. Dieser kann, wie viele Einstellungen, in den Projekt Properties konfiguriert werden, die man über den Doppelklick auf das Projekt (der Wurzelknoten, links im Projekt-Browser) erhält.
Hier kann man im Bereich 'Java EE Application' etwas kürzere Namen wählen, z.B. SimpleServlet für die Web Application und WLS-Tutorial für die Context Root.

Zum Redeployment kann man einfach noch einmal auf den Run-Button klicken. Danach erreicht man die Anwendung unter http://127.0.0.1:7101/WLS-Tutorial/testservlet.