Konfigurowanie programu IBM Business Monitor do używania usługi Web Services Notification

Usługa Web Services Notification to mechanizm publikowania i subskrypcji usług Web Service. Przy użyciu usługi Web Services Notification można wysyłać zdarzenia z większości źródeł do programu IBM® Business Monitor za pośrednictwem usług Web Services. Usługa Web Services Notification może być używana z usługami Web Services Java™ i .NET dla programu IBM Business Monitor. Udostępnione przykładowe skrypty umożliwiają skonfigurowanie serwera programu IBM Business Monitor w taki sposób, aby obsługiwał przepływ komunikatów zdarzeń.

O tym zadaniu

Przy użyciu usług Web Services można publikować zdarzenia z niemal dowolnej aplikacji klienckiej, która może być klientem usług Web Services. To podejście jest bardzo przydatne, ponieważ usługi Web Services zapewniają elastyczność w wyborze platformy i języka programowania.

Przy użyciu usługi Web Services Notification można opublikować komunikat zdarzenia w infrastrukturze Common Event Infrastructure (CEI). Infrastruktura CEI jest nadal używana do filtrowania zdarzeń oraz ich dystrybucji do bieżących kolejek wejściowych modeli monitorowania. Dlatego usługa Web Services Notification służy jako prosty interfejs usług Web Services przed infrastrukturą CEI.

Informacje na temat włączania zabezpieczeń zawiera dokumentacja techniczna (Redbooks) Web Services Handbook for WebSphere Application Server 6.1 (Podręcznik usług Web Service dla serwera WebSphere Application Server 6.1).

Informacje o pojęciach związanych z usługą Web Services Notification oraz dostępnych w produkcie WebSphere Application Server 8.0 składnikach, które umożliwiają oparte na otwartych standardach przesyłanie komunikatów w trybie publikowania i subskrypcji, można znaleźć w następującym miejscu: The developerWorks Technical Library (Biblioteka techniczna w serwisie developerWorks).

Skrypty konfiguracyjne są instalowane wraz z programem IBM Business Monitor w następującym katalogu: katalog_główny_programu_Monitor\scripts.wbm\wsn. Skrypty te umożliwiają włączenie usługi Web Services Notification przez jej integrację z magistralą integracji usług na serwerze WebSphere Application Server. Skrypty umożliwiają także odpowiednie skonfigurowanie zasobów na potrzeby emitowania zdarzeń do programu IBM Business Monitor przy użyciu magistrali integracji usług (service integration bus - SIBus) oraz infrastruktury CEI.

Aby skonfigurować program IBM Business Monitor do używania usługi Web Services Notification, wykonaj następujące kroki:

Procedura

  1. Zainstaluj i skonfiguruj aplikację repozytorium obiektów danych usług (Service Data Objects - SDO) na serwerze WebSphere Application Server. Ponieważ usługi Web Services są włączane przy użyciu magistrali integracji usług, jako standardowego formatu zapisywania i pobierania definicji WSDL (Web Services Description Language) należy używać obiektów SDO. Oznacza to, że należy utworzyć repozytorium SDO implementowane przy użyciu mechanizmu bazy danych. Odpowiednie instrukcje zawiera Centrum informacyjne serwera WebSphere Application Server.
  2. Skopiuj pliki zawierające zasoby konfiguracyjne do katalogu roboczego. Pliki zawierają skrypty w języku jython i plik właściwości (zgodnie z opisem znajdującym się w poniższej tabeli).
    Tabela 1. Zawartość katalogu scripts.wbm\wsn
    Plik Komentarze
    configEventWSN.py Ten skrypt służy do konfigurowania wymaganych zasobów usługi Web Services Notification, usługi JMS, magistrali SIBus oraz infrastruktury CEI.
    removeEventWSN.py Ten skrypt służy do deinstalowania zasobów usługi Web Services Notification, usługi JMS, magistrali SIBus oraz infrastruktury CEI.
    eventWSN.properties Ten plik zawiera wspólne nazwy zasobów oraz właściwości używane przez te dwa skrypty.
  3. Zmodyfikuj plik eventWSN.properties w taki sposób, aby zostały w nim odzwierciedlone właściwości unikalne w danym środowisku.
    Tabela 2. Właściwości dostępne w pliku eventWSN.properties i ich opisy
    Właściwość Opis
    crtCellName = Nazwa komórki produktu WebSphere Application Server
    crtNodeName = Nazwa węzła produktu WebSphere Application Server
    crtServerName = Nazwa serwera produktu WebSphere Application Server
    host = Host, na którym zainstalowano produkt WebSphere Application Server. Wartość localhost jest poprawna. Nie trzeba jej zmieniać.
    wsnPort = Port transportowy HTTP serwera WebSphere Application Server
    EventServiceMdb = Ten plik jest umieszczony w archiwum EventServiceMdb.ear, które zazwyczaj znajduje się w katalogu katalog_główny_WAS/installedApps.

    Jeśli na przykład pakiet programu Monitor jest zainstalowany w produkcie Integration Designer 8.0, plik EventServerMdb.jar znajduje się w archiwum katalog_główny_profilu/nazwa_profilu/installedApps/nazwa_komórki/EventService.ear.

  4. Uruchom poniższy skrypt configEventWSN.py:
    wsadmin -f <ścieżka>/configEventWSN.py
    -lang jython <ścieżka>/eventWSN.properties -profileName <profil>
    -conntype=SOAP

    Gdzie:

    <ścieżka> to ścieżka do miejsca, w którym znajdują się skrypty.

    <profil> to nazwa profilu utworzonego dla serwera produktu IBM Business Monitor. Na przykład profil WBMon01 wsadmin znajduje się w ścieżce <katalog_główny_WAS>/bin </profil></ścieżka></profil></ścieżka></ścieżka>.

    Poniższy kod przedstawia przykładowe wykonanie skryptu na serwerze testów jednostkowych programu IBM Business Monitor zainstalowanym w ramach produktu Integration Designer:

    c:\ibm\WID61\runtimes\bi_v61\bin\wsadmin -f c:\ibm\dev\WSN\scripts\configEventWSN.py
    -lang jython c:\ibm\dev\WSN\scripts\eventWSN.properties -profileName WBMonSrv_wps
    -conntype=SOAP
  5. Zrestartuj produkt WebSphere Application Server, aby włączyć definicję magistrali i zasoby JNDI usługi JMS.
    Uwaga: Jeśli zabezpieczenia na serwerze programu IBM Business Monitor są włączone, ale zabezpieczenia usług Web Services nie mają być używane podczas początkowego testowania klienta usługi Web Services Notification, zabezpieczenia można wyłączyć w ramach magistrali integracji usług CommonEventInfrastructure_Bus.
    Po uruchomieniu skryptu należy sprawdzić, czy skrypt pomyślnie utworzył następujące artefakty:
    1. Usługa Web Services Notification.
    2. Obiekt nasłuchiwania punktów końcowych.
    3. Punkt usługi Web Services Notification.
    4. Miejsce docelowe magistrali integracji usług na potrzeby komunikatów przychodzących do infrastruktury CEI.
    5. Przestrzeń nazw tematów Web Services Notification.
    6. Nowy temat JMS na potrzeby komunikatów przychodzących do infrastruktury CEI.
    7. Nowy temat JMS używany przez infrastrukturę CEI do publikowania w usłudze Web Services Notification. Ten temat nie jest używany do wysyłania zdarzeń do programu IBM Business Monitor. Przy jego użyciu można natomiast publikować zdarzenia dla innych konsumentów usługi Web Services Notification.
    8. Profil grupy zdarzeń CEI używanej przez tę infrastrukturę do publikowania w usłudze Web Services Notification.
    9. Nowa specyfikacja aktywowania JMS na potrzeby komponentu bean sterowanego komunikatami przychodzącego do infrastruktury CEI.
    10. Zainstalowany i skonfigurowany komponent bean sterowany komunikatami CEI.
  6. Jeśli nie zostanie utworzony którykolwiek z artefaktów wymienionych w poprzednim kroku, uruchom skrypt removeEventWSN.py, rozwiąż problem, który spowodował, że skrypt nie został wykonany pomyślnie, a następnie ponownie spróbuj wykonać krok 4.
    wsadmin -f <ścieżka>/removeEventWSN.py
    -lang jython <ścieżka>/eventWSN.properties -profileName <profil>
    -conntype=SOAP

    Gdzie:

    <ścieżka> to ścieżka do miejsca, w którym znajdują się skrypty.

    <profil> to nazwa profilu utworzonego dla serwera programu IBM Business Monitor.

    Poniższy kod przedstawia przykładowe wykonanie skryptu na serwerze testów jednostkowych programu IBM Business Monitor zainstalowanym w ramach produktu Integration Designer:

    c:\ibm\WID61\runtimes\bi_v61\bin\wsadmin -f c:\ibm\dev\WSN\scripts\removeEventWSN.py
    good-lang jython c:\ibm\dev\WSN\scripts\eventWSN.properties -profileName WBMonSrv_wps
    -conntype=SOAP 

Co dalej

Po wykonaniu powyższych czynności można zaprojektować i przetestować klienta usługi Web Services Notification na potrzeby wysyłania zdarzeń do programu IBM Business Monitor. Przydatne informacje dotyczące tworzenia klientów zawiera podręcznik Web Services Handbook for WebSphere Application Server 6.1 (Podręcznik usług Web Service dla serwera WebSphere Application Server 6.1).

Aby opracować klient usługi Web Services Notification na potrzeby wysyłania zdarzeń do programu IBM Business Monitor można użyć pakietu Business Monitor development toolkit 8.5.6 w produkcie Integration Designer 8.0. W celu utworzenia klienta aplikacji można także użyć pakietu Business Monitor development toolkit 8.5.6 w produkcie Rational Application Developer 8.5.x. Jednak w przypadku używania produktu Rational Application Developer 8.5.x i pakietu Business Monitor development toolkit należy zainstalować wymagany poziom pakietu składników usług Web Services.