NSFDB2 - Domino e DB2 e....integrazione AS/400

Domino, DB2 e ... l'altro (IBM AS/400) ovvero: come "combinare" dati Domino e AS/400 in tempo reale con NSFDB2 Autori: Cristian D’Aloisio Vincenzo Capponcelli Professione: Domino Administrator & Developers Ciemme Service s.r.l.

AGENDA

Introduzione a NSFDB2

Come abilitare NSFDB2 su un sistema Lotus Domino su Windows

Abilitazione della Homogeneous Federation su DB2 server per accedere in modo trasparente a dati AS/400

Esempi Domino/Notes che si avvalgono della tecnologia NSFDB2 e della FEDERATION su AS/400

Cos'è NSFDB2?

In Domino 8, possibilità di utilizzare un server DB2 come un data store alternativo

E’ una tecnologia lato server

Non tutti i database devono (o possono) essere salvati in formato nsfdb2

Gli utenti finali collegati al server Domino non hanno conoscenza del fatto che un'applicazione Domino è salvata su DB2

Accesso: sia per clients Notes che per web browsers

SCHEMA CONCETTUALE

I VANTAGGI? Integrazioni: Accesso a dati DB2 direttamente da Domino, senza trasferimenti (LEI,ecc.). Esposizione di dati Domino in formato relazionale, utilizzabili da molteplici clients DB2 (programmi C, Java, ecc.) Join di dati di sistemi diversi: possibilità di realizzare query SQL che mettono in JOIN dati Notes/Domino (anche di diversi db) e dati relazionali DB2 Sicurezza: anche nel caso di integrazioni di dati Domino con altri dati relazionali, viene rispettata la security impostata con le ACL di Domino Performance: la creazione degli indici viene delegata dal server Domino al server DB2, importante nel caso di database Domino con molti documenti e viste Reportistica: flessibilità nell'utilizzo delle viste e nella reportistica (vedi IBM technote 7010956)

DATABASE NON CONVERTITI

Mailbox di tipo IMAP4

Shared Mail (SCOS)

Alcuni database di sistema: per es. names.nsf, log.nsf

NUOVI ELEMENTI DI DESIGN! 1/2

Domino Access View (DAV):

permette di definire l'esposizione di dati Domino in una vista di DB2, sia per Domino che per programmi esterni (SQL)

Lo sviluppatore decide quali dati Notes (moduli e campi specifici) esporre in una vista DB2 accessibile via SQL

Ricordarsi di mappare gli utenti DB2 con gli utenti Notes che accederanno ai dati!

NUOVI ELEMENTI DI DESIGN! 2/2

QUERY VIEW (QV) È una vista Notes definita da una query SQL !

NON ha un indice, viene valutata ad ogni refresh

JOIN fra dati relazionali, sia di Domino che da altre viste DB2

L'istruzione SQL può essere dinamica, con tanto di interazione con l'utente Notes per la richiesta parametri (via web è diverso)

Accesso sia da clients Notes che browsers web

Attenzione al numero di righe selezionate dallo statement SQL!

CONFIGURAZIONE POSSIBILI Configurazione Locale: server Domino e server DB2 server sono installati sullo stesso server Configurazione Remota: server DB2 e server Domino sono installati su server fisici distinti

VERSIONI DB2 SUPPORTATE (8.0.2 release notes)

DB2 Enterprise Server Ed 9.1 FP2 - Microsoft Windows 32-bit

DB2 Enterprise Server Ed 9.1 interim special build 2a - IBM AIX and Linux (SLES10 & RHEL5) 64-bit

DB2 Workgroup Server Ed 9.1 FP2 - Microsoft Windows 32 bit

DB2 Workgroup Server Ed 9.1 interim special build 2a - IBM AIX and Linux (SLES10 & RHEL5) 64-bit

Linux, AIX, Windows... e AS/400 !?

Nsfdb2 NON è disponibile per Domino 8 su AS/400 (i Series,...) !

Workaround : abilitare su DB2 server la feature che si chiama Homogeneous Federation

Federation : si dice al DB2 server (utilizzato da nsfdb2) che alcune tabelle remote (su AS/400) sono viste come tabelle locali

Licenza: l'utilizzo della feature FEDERATION di DB2 NON è attualmente inclusa nella licenza nsf. Chiedere al proprio commerciale IBM.

VOLEVAMO PORTARE L'AS/400... .... MA HANNO PENSATO CHE NON ERA IL CASO!

COSA ABBIAMO UTILIZZATO NELLA NOSTRA CONFIGURAZIONE

Lotus Domino 8.0.2 Enterprise

DB2 Access for Lotus Domino 8.0.2

IBM DB2 9.1 fix pack 2

STEP 1: INSTALLAZIONE DOMINO

Installazione Lotus Domino 8.0.2 Enterprise

Abilitazione del Transaction Log di Domino

STEP2: INSTALLAZIONE SERVER DB2

Local configuration : installazione di DB2 sullo stesso server dove è stato installato Domino, su piattaforma Windows

creazione utente di Windows DB2ADMIN e gruppo DB2DOM

installazione del server DB2 9.1 con l’utente DB2ADMIN

impostazione variabile d'ambiente DB2, SYSCTRL_GROUP , per includere il gruppo DB2DOM

CONSIGLIO In Windows rendere il servizio Lotus Domino DIPENDENTE da quello di DB2: il servizio Domino deve essere lanciato SOLO quando il servizio DB2 è completamente attivo

DB2 SERVER: slideshow

STEP3: installazione di DB2 ACCESS for Domino

Domino Administrator client: creazione di un file server ID che sarà utilizzato dal DB2 Access for Domino

Installazione del DB2 Access for Domino sul server che ospita IBM DB2

Abilitare Domino al DB2

Riavviare Domino

Testare DB2 Access for Domino : da Domino Administrator client

DB2 Access for Domin: slideshow

Configurazioni da Domino Administrator client

Mappare un utente Domino con un utente del DB2 server: es. Domino Administrator > DB2ADMIN

Nel server Document nel names.nsf, nuova “linguetta” DB2 :

impostare un utente di default che il sistema utilizzerà nella consultazione delle Query View

impostare il numero massimo di records da restituire durante la consultazione di una QV (default 500, 0= tutti)

ABILITAZIONE “HOMOGENEOUS FEDERATION” PER DB2

Permette di definire sul server DB2 (nel nostro caso su Windows) una o più tabelle fisicamente localizzate sul sistema remoto AS/400 (files…)

In un sistema NSFDB2 le tabelle federate sono consultabili in modo trasparente una qualsiasi Query View

ATTENZIONE : Le tabelle AS/400, per essere messe sotto FEDERATION in DB2, DEVONO essere messe sotto journaling (giornale)

FEDERATION: slideshow

FAQ 1

Come abilitare un db Notes alla gestione nsfdb2, quando il db è classicamente salvato su hard-disk? load compact -p miodb.nsf

FAQ 2

QV: come impostare da LS la query di selezione SQL di una QV? Impostare la proprietà ( non documentata ) NotesView. selectionQuery : es. view.SelectionQuery= | ” SELECT * FROM schema.tabella ” |

Call view.Refresh

FAQ 3

Come leggere i dati presenti in una QV utilizzando agenti LS (o Java)? Utilizzare la classe NotesViewEntrycollection per navigare i dati esposti dalla QV

ESEMPIO: ARTICOLI IN PRONTA CONSEGNA

Esempio di query su AS/400 che restituisce gli articoli disponibili immediatamente per la vendita (SQL):

Reperimento dati clienti da anagrafica clienti su AS/400

Compilazione di ordine su Notes e salvataggio dell'ordine in formato relazione (nsfdb2)

Reperimento prezzo di vendita da AS/400

ESEMPIO: ARTICOLI NON CONFORMI

Applicazione Notes per la gestione degli articoli “non conformi” agli standard aziendali

Anagrafica articoli e anagrafica clienti memorizzata sul gestionale AS/400

Chiamate articoli non conformi: vengono aperte e gestite su Lotus Notes/Domino

Esempio di utilizzo di Query View (QV) miste , frutto della JOIN fra dati AS/400 e dati Notes, tutto in tempo reale.

RISORSE DI SUPPORTO

Risorse su Internet

manuali Administrator e Designer ;-)

IBM technotes: http://www-01.ibm.com/support/docview.wss?rs=1041&uid=swg27010956

IBM Domino blog: http://www.dominoblog.com

Domino Baloney blog: http://www.dominobaloney.com/

Zoo Lotus blog: http://www.zoolotus.org/

Vistalli blog: http:// www.vistalli.it /

TOOLS

Notepad++ http://notepad-plus.sourceforge.net/it/site.htm Ottimo text editor con svariati plug-in per velocizzare molte operazioni nella stesura delle query SQL molto complesse.