Seit dem 15. April 2016 ist das neue Release von DB2 Web Query verfügbar: Version 2.2.0. Die zahlreichen Erweiterungen gegenüber den Vorgänger-Releases 2.1.0 bzw. 2.1.1 betreffen sowohl den Basisteil als auch den Data Migrator. Das neue Release läuft auch unter IBM i Version 7.3. In den vorangegangenen Artikeln zu diesem Thema habe ich einen Überblick über die Änderungen und Erweiterungen der neuen Version 2.2.0 gegeben. Im aktuellen Artikel beschreibe ich die Installation sowie die Möglichkeiten der Migration von den Vorgängerversionen nach 2.2.0.
Falls Sie keine DVD von Ihrem Business-Partner erhalten haben, können Sie DB2 Web Query 2.2.0 über ESS herunterladen (siehe nachfolgende Abbildung).
Download des Lizenzprogramms DB2 Web Query von ESS
Was sollten Sie beachten, bevor Sie auf die Version 2.2.0 umsteigen?
- Unter IBM i 7.3 läuft nur die Version 2.2.0 von DB2 Web Query. Die Versionen 2.1.0 und 2.1.1 sowie die älteren Versionen 1.1.1. und 1.1.2 werden unter 7.3 nicht mehr unterstützt.
- Für die Version 2.2.0 benötigen Sie neue Lizenzschlüssel.
- Falls Sie eine SWMA (Software Maintenance) für DB2 Web Query haben, ist der Upgrade auf die Version 2.2.0 kostenlos.
- Es ist nicht möglich, die Versionen 2.1.0 und 2.2.0 parallel zu fahren. Bei Installation der Version 2.2.0 wird die Version 2.1 entfernt oder auch migriert. Die Version 2.1 steht dann nicht mehr zur Verfügung.
Installationsarten
Abhängig von der aktuellen Situation Ihrer IBM i stehen Ihnen verschiedene Installationsmöglichkeiten zur Verfügung:
- Neue Installation – Web Query war noch nicht installiert.
- Neue Installation – Eine ältere Version ist bereits installiert, soll aber nicht migriert werden.
- Installation und Migration von einer älteren Version von DB2 Web Query.
1. Neue Installation – Web Query war noch nicht installiert
Eine Beschreibung der Installation und deren Voraussetzungen finden Sie im Wiki von DB2 Web Query unter dem folgenden Link:
Nachfolgend eine kurze Übersicht über die durchzuführenden Tätigkeiten:
Tätigkeiten VOR der Installation
Für alle Betriebssystemversionen (7.1, 7.2, 7.3) müssen folgende Produkte installiert sein:
5770SS1 Option 3 - Extended Base Directory Support 5770SS1 Option 12 - Host Servers 5770SS1 Option 30 - Qshell 5770SS1 Option 33 - PASE 5761JV1 Option 14 - Java SE 7 32 bit (7.1) 5770JV1 Option 14 - Java SE 7 32 bit (7.2, 7.3) 5770DG1 - IBM HTTP Server for i5/OS 5770TC1 - IBM TCP/IP Connectivity Utilities
Die Sektionen 2A, 2B und 2C des APAR-Dokuments enthalten die erforderlichen PTFs, die für die Installation von Web Query 2.2 vorausgesetzt werden.
Installation
Eine detaillierte Beschreibung enthält folgendes Dokument:
Hier die einzelnen Schritte:
- Erforderliche Produkte, Optionen und PTFs
- Lizenzprogramm DB2 Web Query installieren
- Passwort und CCSID für das Profil QWQADMIN eintragen
- Lizenzschlüssel hinzufügen
- DB2 Web Query starten
- Benutzer-Lizenzen hinnzufügen
- Client für Developer Workbench installieren (optional)
- Sprache(n) für die Auswahlliste im BI-Portak aktivieren
Tätigkeiten NACH der Installaton
Nach der Installation von DB2 Web Query 2.2 müssen noch weitere Produkt-PTFs eingespielt werden. Eine vollständige Übersicht über die erforderlichen PTFs und Lizenzprogramme sowie die Tätigkeiten nach der Installation finden Sie im folgenden APAR II14818:
2. Neue Installation – eine ältere Version ist bereits installiert, soll aber nicht migriert werden
Bevor Sie die neue Version von DB2 Web Query 2.2.0 installieren, müssen Sie die bereits installierte Version löschen. Falls Sie mehrere Versionen von Web Query installiert haben – beispiellsweise Version 1.1.2 und Version 2.1.0 – müssen Sie alle Versionen löschen.
Löschen einer älteren Version von DB2 Web Query
Die anschließende Installation wird dann wie eine komplett neue Installation durchgeführt (siehe Beschreibung oben).
Die folgenden Schritte sind für die komplette De-Installation von Web Query erforderlich:
- Web Query beenden:
QWEBQRY/ENDWEBQRY - Löschen aller Lizenzprogramme 5733 WQX:
GO LICPGM, Auswahl 12, Option 4 für jedes Lizemzprogramm 5733 WQX (siehe Abbildung oben) - Löschen des Ordners QWEBQRY in /qibm/proddata:
EDTF STMF(‚/qibm/proddata‘) und Auswahl 9 für Ordner QWEBQRY - Löschen des Ordners QWEBQRY in /qibm/userdata:
EDTF STMF(‚/qibm/userdata‘) und Auswahl 9 für Ordner QWEBQRY - Bibliotheken QWEBQRY, QWQREPOS und QWQCENT entfernen:
STRSQL
DROP SCHEMA QWEBQRY
DROP SCHEMA QWQREPOS
DROP SCHEMA QWQCENT - Alle Berechtigungslisten QWQ* löschen:
WRKAUTL AUTL(QWQ*) und Option 4 für alle Berechtigungslisten
3. Installation und Migration von einer älteren Version von DB2 Web Query
Bei Installation von Web Query 2.2 sind folgende Upgrades von älteren Versionen möglich:
- Upgrade WQX-Version 2.1 nach 2.2
- Upgrade von V1 nach V2
Für jede Upgradevariante steht ein Dokument zur Verfügung, das die Voraussetzungen und die einzelnen Schritte für die Installation und das Upgrade beschreibt.
Upgrade WQX Version 2.1 nach 2.2
Bei Installation von Web Query 2.2 auf einer Partition, auf der bereits 2.1 installiert ist, wird automatisch ein Upgrade durchgeführt. Das alte Release wird ersetzt und ist nicht mehr verfügbar. Beim Upgrade bleiben Metadaten und Konfigurationseinstellungen wie Adapter-Verbindungen oder Sprachauswahl erhalten. Diese befinden sich im IFS-Ordner /qibm/userdata/qwebqry und werden auf die Vesion 2.2 migriert. Diese Migration erfolgt auch für das Web Query-Repository in Bibliothek QWQREPOS, das die Reports, Zeitpläne und Verteilungslisten enthält.
Das Dokument mit der Beschreibung von Installation und Upgrade finden Sie unter dem folgenden Link:
Upgrade von V1 nach V2
Bei Installation von 5733-WQX (Versionen 2.1.0, 2.1.1 und 2.2.0) bleibt die Vogängerversion mit 5733-QU2, 5733-QU3 und 5733-QU4 erhalten. Wenn Sie die Produkte QU2 und WQX installiert und für beide die Lizenzschlüssel aktiviert haben, können nicht beide parallel laufen. Sie können beide Versionen gleichzeitig nutzen, wenn Sie die Lizenzschlüssel für das neue Produkt WQX nicht aktvieren. In diesem Fall können Sie die Testzeitperiode von maximal 70 Tagen nutzen, um beide Produkte parallel auszuführen. Sobald Sie die Lizenzschlüssel für das Produkt WQX eingeben, ist ein gleichzeitiges Ausführen nicht mehr möglich. Beide Versionen können allerdings alternativ genutzt werden, nur eben nicht gleichzeitig.
Die Abgrenzung zwischen beiden Versionen wird dadurch erreicht, dass beide eigene Administrator-IDs, Produkt-Bibliotheken, IFS-Verzeichnisse und Ports verwenden:
- Das administrative Benutzerprofil für WQX ist QWQADMIN. Mit diesem Profil können Benutzer verwaltet und Konfigurationseinstellungen durchgeführt werden, aber es kann nicht auf Ordner oder Berichte zugegriffen werden.
- Die Produktbibliotheken für WQX sind QWEBQRYX und QWEBQRY.
- Die Bibliothek QWQREPOS enthält das Repository von Web Query.
- Die Bibliothek QWQCENT enthält die Daten, die für das im Redbook enthaltene Tutorial verwendet werden.
- Die Produktverzeichnisse im IFS sind /qibm/userdata/qwebqry und /qibm/proddata/qwebqry.
- Die Zuordnung der Ports entspricht der von Version 1: 1×331 bis 1×339, wobei für x die Versionsnummer eingesetzt wird. Nach der Testperiode von 70 Tagen verwendet WQX den Port 11331 anstelle von Port 12334. Zum Anmelden für WQX wird bei der erforderlichen URL der Port 12331 verwendet.
Wenn WQX installiert wird, bleibt die existierende Installation von QU2 unberührt, mit einer Ausnahme:
Die Proxies in QSYS für die DB2 Web Query-Befehle werden auf die neue Produktbibliothek umgeschaltet. Das bedeutet, dass sich bei nicht qualifizierter Angabe eines Web Query-Befehls dieser Befehl auf WQX bezieht. Wenn Sie beispielsweise den Befehl STRWEBQRY ohne Qualifizierung der Bibliothek in Ihrem Startprogramm eintragen, wird beim nächsten IPL die Version WQX gestartet und nicht die Version QU2. Wenn Sie weiterhin auch die Version QU2 verwenden wollen, müssen Sie die Befehle dafür mit dem Bibliotheksnamen QWEBQRY77 qualifizieren.
Migration QU2 nach WQX mit MIGWEBQRY
Für die Migration einer älteren Installation QU2 nach WQX verwenden Sie den Befehl MIGWEBQRY (Migrate Web Query). Damit werden die Benutzerdaten des alten Produkts in das neue übertragen. Die Migration wird nicht automatisch durchgeführt, wenn Sie auf eine Version nach Web Query 2.1.0 upgraden.
Das Dokument mit der Beschreibung für die Installation und das Upgrade finden Sie unter folgendem Link:
Den Link für das Benutzerhandbuch zum CL-Befehl MIGWEBQRY finden Sie auf der Wiki-Seiite von DB2 Web Query.
Der CL-Befehl MIGWEBQRY
Nach erfolgreicher Installation von DB2 Web Query Version 2.2.0 sollte der Startbildschirm des BI-Portals wie folgt aussehen:
Neu gestaltetes Sign-On-Fenster des BI-Portals
Vorschau:
Im nächsten Artikel stelle ich Ihnen meinen Erfahrungsbericht bei der Umstellung von 2.1.0 auf 2.2.0 vor.
Bis dahin wünsche ich Ihnen weiterhin viel Spaß beim Vermehren Ihrer Fertigkeiten.