Netcool/Impact
Transkrypt
Netcool/Impact
Netcool/Impact Wersja 6.1.1.1 Podręcznik integrowania SC85-0531-00 Netcool/Impact Wersja 6.1.1.1 Podręcznik integrowania SC85-0531-00 Uwaga Przed użyciem tych informacji oraz produktu, którego dotyczą, należy przeczytać informacje, które zawiera sekcja “Uwagi”. Uwaga Ta edycja dotyczy wersji 6.1.1.1 produktu IBM Tivoli Netcool/Impact oraz wszystkich kolejnych wydań i modyfikacji, o ile nie podano inaczej w nowych edycjach. © Copyright IBM Corporation 2006, 2014. Spis treści Podręcznik integrowania . . . . . . . v Dla kogo przeznaczona jest ta publikacja . . . . . Publikacje . . . . . . . . . . . . . . Biblioteka programu Netcool/Impact . . . . . Uzyskiwanie dostępu do terminologii . . . . . Uzyskiwanie dostępu do publikacji elektronicznych . Zamawianie publikacji . . . . . . . . . Ułatwienia dostępu. . . . . . . . . . . . Szkolenia techniczne Tivoli . . . . . . . . . Wsparcie dla rozwiązywania problemów . . . . . Uzyskiwanie poprawek . . . . . . . . . Cotygodniowe otrzymywanie aktualizacji . . . . Kontakt z działem wsparcia IBM dla oprogramowania Konwencje użyte w tej publikacji . . . . . . . Konwencje typograficzne . . . . . . . . . Zmienne i ścieżki zależne od systemu operacyjnego . . . . . v v v v . vi . vi . vi . vi . vii . vii . vii viii . x . x . x Rozdział 1. Integrowanie z produktem Netcool/Impact . . . . . . . . . . . . 1 Rozdział 2. Integrowanie produktu Netcool/Impact z portalem Tivoli Enterprise Portal . . . . . . . . . . . 3 Przegląd . . . . . . . . . . . . . . . Obsługiwane systemy operacyjne . . . . . . . Konfigurowanie integrowania. . . . . . . . . Kopiowanie i edytowanie szablonów skryptu OVWrapper Tworzenie definicji uruchamiania . . . . . . . Przykłady widoków operatora. . . . . . . . . . . . . . . 3 3 3 4 5 7 Dodawanie udostępnionych reguł do podstawy reguł TEC . . . . . . . . . . . . . . . . Konfigurowanie produktu Tivoli Enterprise Console do używania ustalonego portu komunikacyjnego. . . . Aktualizowanie pliku ImpactTECAgent.conf . . . . Aktualizowanie strategii TEC . . . . . . . . Tworzenie połączeń z bazą danych . . . . . . . Konfigurowanie czytnika zdarzeń . . . . . . . Testowanie konfiguracji . . . . . . . . . . Rozwiązywanie problemów . . . . . . . . . . Modyfikowanie integrowania . . . . . . . . . Dodawanie nowych szczelin do istniejącej konsoli Tivoli Enterprise Console . . . . . . . . . Aktualizowanie klasy IMPACT . . . . . . . . Lista kontrolna nowej szczeliny . . . . . . . . Przykłady architektur integrowania . . . . . . . . 18 18 19 19 20 22 22 23 25 25 26 26 26 Rozdział 5. Integrowanie produktu Netcool/Impact z Webtop . . . . . . . 29 Funkcje serwera Netcool/Impact . Obsługiwane systemy operacyjne . Konfigurowanie integrowania . . . . . . . . . . . . . . . . . . . . . 29 . 29 . 30 Rozdział 6. Integrowanie produktu Netcool/Impact z produktem WebSphere Business Events . . . . . 31 Konfigurowanie produktu WebSphere Business Events . Integrowanie produktu Netcool/Impact z zewnętrzną kolejką JMS . . . . . . . . . . . . . Używanie funkcji integrowania . . . . . . . . . 31 . 31 . 33 Rozdział 3. Integrowanie produktu Netcool/Impact z produktem IBM Tivoli Monitoring . . . . . . . . . . . . . 9 Rozdział 7. Korzystanie z funkcji IPLtoXML . . . . . . . . . . . . . 35 Konfigurowanie produktu Netcool/Impact w celu wysyłania komunikatów do konsoli Tivoli Monitoring Universal Message Console . . . . . . . . . . . . . 9 Uzyskiwanie danych z produktu Tivoli Monitoring 6.3 z wykorzystaniem dostawcy danych dla interfejsu użytkownika . . . . . . . . . . . . . . 9 37 Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console . . . . . . . . . 11 Przegląd procesu integrowania . . . . . . . . Architektura integrowania . . . . . . . . . Tabele bazy danych konsoli Tivoli Enterprise Console API EIF konsoli Tivoli Enterprise Console . . . Klasy konsoli Tivoli Enterprise Console . . . . Reguły konsoli Tivoli Enterprise Console . . . . Funkcje produktu Tivoli Enterprise Console . . . Konfigurowanie integrowania z konsolą Tivoli Enterprise Console . . . . . . . . . . . . . . . Dodawanie klas do podstawy reguł TEC . . . . © Copyright IBM Corp. 2006, 2014 . 11 . 12 13 . 14 . 15 . 16 . 16 Funkcje z rodziny IPLtoXML - przegląd . . . . . . Tworzenie obiektu dokumentu XML . . . . . . . Dodawanie podelementu . . . . . . . . . . . Tworzenie nieprzypisanego elementu . . . . . . . Prosta metoda dodawania atrybutów XML do obiektów elementów . . . . . . . . . . . . . . . Dodawanie atrybutów XML do obiektów, używając obiektów atrybutów . . . . . . . . . . . . Dodawanie atrybutów XML do obiektów elementów przez dodawanie atrybutów węzła . . . . . . . . . . Dodawanie zawartości do obiektu elementu XML . . . Dołączanie zawartości do obiektów elementów XML . . Dodawanie komentarzy XML do obiektów elementów . . Zagnieżdżanie obiektów elementów XML w innych obiektach . . . . . . . . . . . . . . . Generowanie łańcuchów XML z obiektów dokumentu . . Zastępowanie domyślnych jednostek XML . . . . . Kolejność elementów w XML . . . . . . . . . Przykład użycia funkcji IPLtoXML. . . . . . . . 35 36 36 37 38 39 39 40 40 41 41 42 42 42 . 17 . 18 iii Rozdział 8. Łączenie z WebSphere MQ i DSA JMS . . . . . . . . . . . . . . 47 Opcja konfiguracyjna 1 . Opcja konfiguracyjna 2 . . . . . . . . . . . . . . . . . . . . 47 . 47 Dodatek A. Ułatwienia dostępu . . . . 49 Dodatek B. Uwagi . . . . . . . . . . 51 Znaki towarowe . . . . . . . . . . . . . 53 Glosariusz . . . . . . . . . . . . . 55 A. B. C. D. E. F. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Netcool/Impact: Podręcznik integrowania . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 55 55 56 56 57 G. I . J . K. L. M. N. O. P. S. T. U. W Z. Ź. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 57 57 57 58 58 58 58 59 59 60 60 60 61 61 Indeks . . . . . . . . . . . . . . . 63 Podręcznik integrowania Publikacja Netcool/Impact Podręcznik integrowania zawiera instrukcje integrowania produktu Netcool/Impact z innymi produktami IBM® i innych firm. Dla kogo przeznaczona jest ta publikacja Ta publikacja jest przeznaczona dla użytkowników, którzy są odpowiedzialni za integrowanie produktu Tivoli Netcool/Impact z innym oprogramowaniem IBM i innych firm. Publikacje W tej sekcji zostały wymienione publikacje w bibliotece Netcool/Impact oraz dokumenty pokrewne. Opisano również sposób dostępu do elektronicznych publikacji Tivoli oraz sposób zamawiania publikacji Tivoli. Biblioteka programu Netcool/Impact v Szybki start, CF39PML Zawiera zwięzły opis instalowania i uruchamiania produktu Netcool/Impact po raz pierwszy. v Podręcznik administrowania, SC85-0528-00 Zawiera informacje na temat instalowania, uruchamiania i monitorowania działania produktu. v Interfejs użytkownika, SC85-0529-00 Zawiera instrukcje korzystania z graficznego interfejsu użytkownika (GUI). v Policy Reference Guide, SC14-7561-00 Zawiera pełny opis i skorowidz języka IPL (Impact Policy Language). v DSA Reference Guide, SC27-4852-00 Zawiera informacje na temat adapterów źródeł danych (DSA). v Operator View Guide, SC27-4853-00 Zawiera informacje na temat tworzenia widoków operatora. v Rozwiązania, SC85-0530-00 Zawiera szczegółowe informacje na temat używania funkcji programu Netcool/Impact. v Podręcznik integrowania, SC85-0531-00 Zawiera instrukcje integrowania programu Netcool/Impact z innym oprogramowaniem IBM i innych dostawców. v Troubleshooting Guide, SC27-4855-00 Zawiera informacje na temat rozwiązywania problemów z instalacją, modyfikowaniem, uruchamianiem i konserwowaniem programu Netcool/Impact. Uzyskiwanie dostępu do terminologii Serwis IBM Terminology udostępnia w jednym miejscu terminologię stosowaną w produktach IBM. Serwis ten dostępny jest pod adresem: http://www.ibm.com/software/globalization/terminology © Copyright IBM Corp. 2006, 2014 v Uzyskiwanie dostępu do publikacji elektronicznych Publikacje są dostępne w następujących lokalizacjach: v Dysk DVD Szybki start zawiera publikację Szybki start. Instrukcje dostępu do tych publikacji opisano w pliku readme zamieszczonym na dysku DVD. v Centrum informacyjne Tivoli dostępne pod adresem http://publib.boulder.ibm.com/ infocenter/tivihelp/v8r1/topic/com.ibm.netcoolimpact.doc6.1.1/welcome.html. IBM umieszcza w Centrum informacyjnym Tivoli publikacje dotyczące wszystkich produktów Tivoli, gdy stają się dostępne lub gdy są aktualizowane. Uwaga: Jeśli dokumenty PDF są drukowane na papierze w formacie innym, niż letter, należy w oknie Plik → Drukuj programu Adobe Reader wybrać odpowiednią opcję drukowania. v Serwis Tivoli Documentation Central pod adresem http://www.ibm.com/tivoli/ documentation. Dostęp do publikacji dotyczących poprzednich i bieżącej wersji produktu Netcool/Impact możliwy jest też za pomocą serwisu Tivoli Documentation Central. v Wiki produktu Netcool/Impact zawiera dodatkowe krótkie dokumenty i informacje. Patrz: https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/ Tivoli%20Netcool%20Impact. Zamawianie publikacji Wiele publikacji Tivoli można zamówić w sieci pod adresem http:// www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss. Zamówienie można również złożyć, dzwoniąc pod jeden z następujących numerów telefonów: v W Stanach Zjednoczonych: 800-879-2755 v W Kanadzie: 800-426-4968 W pozostałych krajach skontaktuj się z przedstawicielem do spraw oprogramowania, aby zamówić publikacje Tivoli. Aby znaleźć numer telefonu lokalnego przedstawiciela, wykonaj następujące kroki: 1. Otwórz stronę http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss. 2. Wybierz kraj z listy i kliknij przycisk Go (Wykonaj). 3. Na panelu głównym kliknij odsyłacz About this site (Informacje o serwisie), aby wyświetlić stronę informacji zawierającą numer telefonu lokalnego przedstawiciela. Ułatwienia dostępu Ułatwienia dostępu dla użytkowników niepełnosprawnych pomagają osobom z ograniczoną sprawnością ruchową lub niedowidzącym w posługiwaniu się oprogramowaniem. Używając tego produktu, można korzystać z dźwiękowych i nawigacyjnych technik wspomagania interfejsu. Dostęp do wszystkich funkcji interfejsu graficznego jest możliwy za pomocą myszy i klawiatury. Więcej informacji na ten temat zawiera Dodatek A, “Ułatwienia dostępu”, na stronie 49. Szkolenia techniczne Tivoli Aby uzyskać informacje o szkoleniach technicznych Tivoli, przejdź do następującego serwisu WWW IBM Tivoli Education pod adresem http://www.ibm.com/software/tivoli/education. vi Netcool/Impact: Podręcznik integrowania Wsparcie dla rozwiązywania problemów W przypadku wystąpienia problemów z oprogramowaniem IBM pożądane jest ich szybkie rozwiązanie. Niniejsza sekcja opisuje następujące opcje uzyskiwania wsparcia dla oprogramowania IBM: v “Uzyskiwanie poprawek” v “Cotygodniowe otrzymywanie aktualizacji” v “Kontakt z działem wsparcia IBM dla oprogramowania” na stronie viii Uzyskiwanie poprawek Do rozwiązania problemu może być niezbędna instalacja poprawki dla produktu. Aby określić, które poprawki są dostępne dla produktu oprogramowania Tivoli, należy wykonać następujące kroki: 1. Przejdź do serwisu IBM Software Support pod adresem http://www.ibm.com/software/ support. 2. Otwórz stronę Downloads (Pobieranie). 3. Postępuj zgodnie z instrukcjami, aby odnaleźć poprawkę i pobrać ją. 4. Jeśli nie ma nagłówka Download (Pobierz) dla produktu, podaj wyszukiwany termin, kod błędu lub numer APAR w polu wyszukiwania. Więcej informacji na temat typów dostępnych poprawek można znaleźć w podręczniku IBM Software Support Handbook pod adresem http://www14.software.ibm.com/webapp/set2/sas/f/ handbook/home.html. Cotygodniowe otrzymywanie aktualizacji Aby otrzymywać co tydzień wiadomości z powiadomieniami o poprawkach i inne wiadomości od działu wsparcia dla oprogramowania, wykonaj następujące czynności: 1. Przejdź do serwisu IBM Software Support pod adresem http://www.ibm.com/software/ support. 2. Na pasku narzędzi kliknij odsyłacz Moje ustawienia. Kliknij opcję Wsparcie technologiczne. 3. Jeśli jesteś już zarejestrowanym użytkownikiem, zaloguj się i przejdź do następnego kroku. W przeciwnym razie kliknij odsyłacz zarejestruj się. Wypełnij formularz rejestracyjny, używając adresu e-mail jako identyfikatora IBM i kliknij opcję Wyślij. 4. Zostanie wyświetlona karta Edytuj profil. 5. Z menu Produkty wybierz opcję Oprogramowanie. Z drugiej listy wybierz kategorię produktów (na przykład Tivoli). Z trzeciej listy wybierz podkategorię produktów (np. Wydajność i dostępność aplikacji lub Wydajność systemów). Zostanie wyświetlona lista odpowiednich produktów. 6. Wybierz produkty, dla których chcesz otrzymywać aktualizacje. 7. Kliknij opcję Add products (Dodaj produkty). 8. Po wybraniu interesujących Cię produktów kliknij odsyłacz Zasubskrybuj pocztą elektroniczną na karcie Edytuj profil. 9. Z listy Dokumenty wybierz pozycję Oprogramowanie. 10. Wybierz opcję Proszę o cotygodniowe wysyłanie tych dokumentów w wiadomości. 11. Zaktualizuj adres poczty elektronicznej, jeśli to konieczne. 12. Wybierz typy dokumentów, które chcesz otrzymywać. 13. Kliknij przycisk Aktualizuj. Podręcznik integrowania vii Jeśli wystąpią problemy z korzystaniem z opcji Wsparcie techniczne, możesz poprosić o pomoc: Elektronicznie Wyślij wiadomość e-mail z opisem problemu pod adres [email protected]. Telefonicznie W Stanach Zjednoczonych: zadzwoń pod numer 1-800-IBM-4You (1-800-426-4409). Ogólnoświatowe stanowisko pomocy Kliknij odsyłacz: https://www.ibm.com/account/profile/us?page=reghelpdesk. Kontakt z działem wsparcia IBM dla oprogramowania Zanim zgłosisz problem do działu wsparcia IBM dla oprogramowania, sprawdź, czy Twoja firma ma aktywny kontrakt serwisowy z firmą IBM i czy posiadasz uprawnienia do zgłaszania problemów do firmy IBM. Typ niezbędnego kontraktu serwisowego zależy od typu posiadanego produktu: v Dla produktów oprogramowania dystrybuowanych przez firmę IBM (m.in. produkty Tivoli, Lotus i Rational, produkty DB2 i WebSphere dla systemów operacyjnych Windows i UNIX) można dołączyć do programu Passport Advantage w jeden z poniższych sposobów: Elektronicznie Przejdź do serwisu WWW Passport Advantage pod adresem http://www-306.ibm.com/software/howtobuy/passportadvantage/ pao_customers.htm. Telefonicznie W celu uzyskania numeru telefonu w Twoim kraju, przejdź do serwisu WWW IBM Worldwide IBM Registration Helpdesk pod adresem https://www.ibm.com/account/profile/us?page=reghelpdesk. v Klienci z kontraktami typu S & S (Subscription and Support) korzystają z serwisu WWW Software Service Request Web pod adresem https://techsupport.services.ibm.com/ssr/login. v Klienci korzystający z kontraktów IBMLink, CATIA, Linux, OS/390, iSeries, pSeries, zSeries oraz innych umów serwisowych korzystają z serwisu WWW IBM Support Line Web pod adresem http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006. v Dla produktów oprogramowania IBM eServer (m.in. produkty DB2 i WebSphere dla systemów zSeries, pSeries i iSeries) można zakupić kontrakt serwisowy u przedstawiciela handlowego IBM lub partnera biznesowego IBM. Więcej informacji na temat wsparcia dla produktów oprogramowania eServer znajduje się w serwisie WWW IBM Technical Support Advantage pod adresem http://www.ibm.com/servers/eserver/techsupport.html. Jeśli nie wiadomo, jaki typ kontraktu serwisowego dla oprogramowania jest potrzebny, należy się skontaktować z numerem telefonu 1-800-IBMSERV (1-800-426-7378) w Stanach Zjednoczonych. W innych krajach: przejdź na stronę z kontaktami w podręczniku IBM Software Support Handbook pod adresem http://www14.software.ibm.com/webapp/set2/sas/f/ handbook/home.html i kliknij nazwę regionu geograficznego, aby uzyskać numery telefonów osób odpowiedzialnych za wsparcie w tym regionie. Wykonaj następujące działania, aby się skontaktować z działem wsparcia IBM dla oprogramowania: 1. “Określanie wpływu na działanie przedsiębiorstwa” na stronie ix 2. “Opisywanie problemów i zbieranie informacji” na stronie ix 3. “Zgłaszanie problemów” na stronie ix viii Netcool/Impact: Podręcznik integrowania Określanie wpływu na działanie przedsiębiorstwa Podczas zgłaszania problemu w IBM osoba zgłaszająca proszona jest o określenie poziomu jego istotności. Dlatego należy zrozumieć i ocenić wpływ zgłaszanego problemu na działalność przedsiębiorstwa: Poziom istotności 1 Problem ma newralgiczny wpływ na działalność przedsiębiorstwa. Nie można używać programu, co ma newralgiczne znaczenie dla dalszego działania. Taki problem wymaga natychmiastowego rozwiązania. Poziom istotności 2 Problem ma znaczący wpływ na działalność przedsiębiorstwa. Można korzystać z programu, ale jego użyteczność jest poważnie ograniczona. Poziom istotności 3 Problem ma pewien wpływ na działalność przedsiębiorstwa. Można korzystać z programu, jednak niedostępne są pewne mniej ważne opcje, które nie mają newralgicznego znaczenia dla działań. Poziom istotności 4 Problem ma minimalny wpływ na działalność przedsiębiorstwa. Problem ma niewielki wpływ na działanie przedsiębiorstwa lub zaimplementowano praktyczne obejście tego problemu. Opisywanie problemów i zbieranie informacji Podczas opisywania problemu firmie IBM należy udzielić jak najwięcej konkretnych informacji. Należy uwzględnić wszystkie istotne informacje dotyczące problemu, aby specjalista działu wsparcia IBM dla oprogramowania mógł sprawnie udzielić pomocy w rozwiązaniu problemu. Aby nie tracić czasu, przygotuj odpowiedzi na następujące pytania: v Jakie wersje oprogramowania były uruchomione w momencie wystąpienia problemu? v Czy są dzienniki, pliki śledzenia i komunikaty związane z objawami problemu? Dział wsparcia IBM dla oprogramowania będzie prawdopodobnie prosił o te informacje. v Czy problem można wywołać ponownie? Jeśli tak, jakie czynności należy wykonać, aby wystąpił ten problem? v Czy w systemie wprowadzono jakiekolwiek zmiany? Na przykład czy zmieniono sprzęt, system operacyjny lub oprogramowanie sieciowe? v Czy obecnie jest stosowane obejście problemu? Jeśli tak, należy być przygotowanym do opisania obejścia podczas zgłaszania problemu. Zgłaszanie problemów Istnieją dwie metody zgłaszania problemu do działu wsparcia oprogramowania IBM: Elektronicznie Kliknij Zgłoś i śledź problemy na stronie WWW IBM Software Support pod adresem http://www.ibm.com/software/support/probsub.html. Wpisz informacje w odpowiednim formularzu zgłaszania problemu. Telefonicznie W celu uzyskania numeru telefonu w Twoim kraju przejdź do strony kontaktów w podręczniku elektronicznym IBM Software Support Handbook pod adresem http://www14.software.ibm.com/webapp/set2/sas/f/handbook/home.html i kliknij nazwę regionu geograficznego. Jeśli zgłaszany problem dotyczy oprogramowania albo braku lub nieścisłości dokumentacji, dział wsparcia IBM dla oprogramowania utworzy raport APAR (Authorized Program Analysis Report). Raport taki szczegółowo opisuje problem. Jeśli to możliwe, dział wsparcia IBM dla oprogramowania poinformuje o możliwym obejściu problemu, które można zaimplementować do czasu rozwiązania problemu i dostarczenia poprawki. Firma IBM Podręcznik integrowania ix codziennie publikuje raporty APAR dotyczące rozwiązanych problemów w serwisach WWW wsparcia produktów, dlatego inni użytkownicy, którzy napotykają ten sam problem, mogą skorzystać z tych samych rozwiązań. Konwencje użyte w tej publikacji W publikacji zastosowano kilka konwencji w związku ze specjalnymi terminami i czynnościami oraz ścieżkami i komendami zależnymi od systemu operacyjnego. Konwencje typograficzne W tej publikacji użyto następujących konwencji typograficznych: Pogrubienie v Komendy zapisane małymi literami i przy użyciu mieszanej wielkości liter, które w przeciwnym razie trudno odróżnić od sąsiedniego tekstu. v Elementy sterujące interfejsu (pola wyboru, przyciski, przyciski listy przewijanej, pola, foldery, ikony, pola listy, elementy w polach listy, listy wielokolumnowe, kontenery, opcje menu, nazwy menu, karty, arkusze właściwości), etykiety (na przykład Wskazówka: i Uwagi dotyczące systemu operacyjnego:). v Słowa kluczowe i parametry w tekście. Kursywa v Cytaty (na przykład tytuły publikacji, dyskietek i dysków CD). v Słowa zdefiniowane w tekście (na przykład: linia niekomutowana jest nazywana linią między punktami). v Wyróżnienia słów i liter (słów jak w przykładzie: „Użyj słowa that w celu wprowadzenia klauzuli ograniczającej.”; liter jak w przykładzie: „Adres jednostki logicznej musi rozpoczynać się od litery L.”). v Nowe terminy w tekście (z wyjątkiem listy definicji): widok jest ramką w obszarze roboczym, która zawiera dane. v Zmienne i wartości, które należy podać: ... gdzie mojanazwa reprezentuje... Czcionka o stałej szerokości v Przykłady i przykłady kodu v Nazwy plików, słowa kluczowe języków programowania i inne elementy, które trudno odróżnić od sąsiedniego tekstu. v Tekst komunikatu i zapytań skierowanych do użytkownika. v Tekst, który użytkownik musi wpisać. v Wartości argumentów lub opcji komend. Zmienne i ścieżki zależne od systemu operacyjnego W tej publikacji użyto konwencji systemu operacyjnego UNIX przy określaniu zmiennych środowiskowych i do zapisu katalogów. Gdy używany jest wiersz komend systemu operacyjnego Windows, należy zastąpić zapis zmiennych środowiskowych $zmienna zapisem %zmienna%, każdy ukośnik (/) w ścieżkach katalogów należy zastąpić ukośnikiem odwrotnym (\). Nazwy zmiennych środowiskowych nie zawsze są takie same w systemach operacyjnych Windows i UNIX. Na przykład zmienna środowiskowa %TEMP% w systemach operacyjnych Windows jest odpowiednikiem zmiennej środowiskowej $TMPDIR w systemach operacyjnych UNIX. Uwaga: Przy używaniu powłoki bash w systemie operacyjnym Windows można używać konwencji systemu operacyjnego UNIX. x Netcool/Impact: Podręcznik integrowania Rozdział 1. Integrowanie z produktem Netcool/Impact Integrowanie produktu Netcool/Impact z innym oprogramowaniem firmy IBM® oraz z innym oprogramowaniem firm trzecich. © Copyright IBM Corp. 2006, 2014 1 2 Netcool/Impact: Podręcznik integrowania Rozdział 2. Integrowanie produktu Netcool/Impact z portalem Tivoli Enterprise Portal Dzięki funkcji integrowania serwera Netcool/Impact z portalem Tivoli Enterprise Portal widok operatora serwera Netcool/Impact można otworzyć bezpośrednio w portalu Tivoli Enterprise Portal. Przegląd Widok operatora w produkcie Tivoli Enterprise Portal służy do przeglądania danych pochodzących z różnych aplikacji na jednej stronie WWW oraz do uruchamiania strategii Impact dla danych dodatkowych. Dostępność widoku operatora z portalu Tivoli Enterprise Portal oznacza, że można szybko przejść z obiektu w programie Tivoli Enterprise Portal do powiązanych danych zapisanych w innych aplikacjach. Na przykład można utworzyć widok operatora, który wyświetla historię zgłoszeń serwisowych pochodzących z aplikacji zakupionej u innego dostawcy w połączeniu z historią zmian pochodzącą z aplikacji do zarządzania zmianami. Istnieje możliwość dodania przycisku w widoku operatora do otwierania zgłoszenia serwisowego z użyciem strategii IPL. Rozwiązanie wykorzystuje możliwość programu Tivoli Enterprise Portal do tworzenia definicji uruchamiania procesów zewnętrznych z użyciem prawego przycisku myszy. Użytkownik tworzy definicję uruchamiania wykonującą skrypt opakowujący. Skrypt ten otrzymuje od programu Tivoli Enterprise Portal listę atrybutów oddzielonych spacjami. Następnie skrypt uruchamia przeglądarkę, używając pełnego adresu URL odpowiedniego widoku operatora. Więcej informacji na temat tworzenia skryptów opakowujących i definicji uruchamiania zawierają sekcje “Kopiowanie i edytowanie szablonów skryptu OVWrapper” na stronie 4 i “Tworzenie definicji uruchamiania” na stronie 5. Obsługiwane systemy operacyjne Integracja z produktem Tivoli Enterprise Portal jest zgodna z systemami operacyjnymi obsługiwanymi przez produkt Tivoli Netcool/Impact 6.1.1 oraz IBM Tivoli Enterprise Portal 6.1 i 6.2. Najbardziej aktualne informacje na temat obsługiwanego sprzętu, oprogramowania, przeglądarek i systemów operacyjnych są udostępniane przez raporty zgodności oprogramowania IBM® pod adresem: http://pic.dhe.ibm.com/infocenter/prodguid/v1r0/clarity/ index.html Więcej informacji na temat uruchamiania raportów zgodności oprogramowania zawiera sekcja Overview and Planning (Planowanie i przegląd) w obszarze wiki produktu Tivoli Netcool/Impact pod adresem: https://www.ibm.com/developerworks/mydeveloperworks/ wikis/home/wiki/Tivoli%20Netcool%20Impact/page/Overview%20and %20Planning?lang=en. Konfigurowanie integrowania Poniższa procedura pozwala na skonfigurowanie funkcji integrowania z produktem Tivoli Enterprise Portal. © Copyright IBM Corp. 2006, 2014 3 Procedura 1. Utwórz przynajmniej jeden widok operatora. Więcej informacji na temat widoków operatora zawiera publikacja Operator View Guide. Przykłady widoków operatora dostępne są też w sekcji “Przykłady widoków operatora” na stronie 7. 2. Skopiuj i edytuj szablony skryptu powłoki OVWrapper. Więcej informacji na temat skryptu zawiera sekcja “Kopiowanie i edytowanie szablonów skryptu OVWrapper”. 3. Utwórz definicje uruchamiania w programie Tivoli Enterprise Portal. Więcej informacji na temat definicji uruchamiania zawiera sekcja “Tworzenie definicji uruchamiania” na stronie 5. Kopiowanie i edytowanie szablonów skryptu OVWrapper Istnieje możliwość użycia szablonów skryptu OVWrapper, które dostępne są w katalogu $IMPACT_HOME/impact/integrations/tep, aby skonfigurować integrację produktów. Procedura 1. Skopiuj następujące szablony, w zależności od używanego systemu operacyjnego, na hosty z uruchomionym klientem programu Tivoli Enterprise Portal: v OVWrapper.bat (systemy operacyjne Windows) v OVWrapper.sh (systemy operacyjne UNIX) 2. Skopiuj szablon dla każdego widoku operatora, który ma być wyświetlany. Każdy wyświetlany widok operatora wymaga osobnego skryptu. 3. Zmodyfikuj utworzone kopie, aby działały z wybranym widokiem operatora. Zmień listę nazw atrybutów (var1, var2 itp) oraz komendę uruchamiającą przeglądarkę. Więcej informacji zawierają szablony. Przykład Skrypt OVWrapper.bat dla systemów operacyjnych Windows: @echo off rem TWÓJ adres URL set OV_URL=http://9.15.165.121:16310/opview/displays/ WSCCLUSTERExampleOV_for_wrapper.html rem Ścieżka TWOJEJ przeglądarki set OV_BROWSER=C:\progra~1\mozill~1\firefox.exe rem set BROWSER=C:\progra~1\Intern~1\IEXPLORE.EXE rem Nazwy atrybutów set var1=FirstName set var2=LastName set var3=Age rem Przykład uruchamiania przeglądarki i przekazywania atrybutów start %OV_BROWSER% %OV_URL%?%var1%=%1^&%var2%=%2^&%var3%=%3 rem Uwagi na temat powyższej komendy: rem ^ przed & jest niezbędne do przekazania znaku & rem ? nie wymaga poprzedzania znakiem ^ Skrypt OVWrapper.sh dla systemów operacyjnych UNIX: #!/bin/sh # TWÓJ adres URL set OV_URL=http://9.15.165.121:16310/opview/displays/ WSCCLUSTERExampleOV_for_wrapper.html # Ścieżka TWOJEJ przeglądarki OV_BROWSER=/opt/firefox/firefox 4 Netcool/Impact: Podręcznik integrowania # Nazwy atrybutów var1=FirstName var2=LastName var3=Age # Przykład uruchamiania przeglądarki i przekazywania atrybutów $OV_BROWSER $OV_URL?$var1=$1"&"$var2=$2"&"$var3=$3 # Uwagi na temat powyższej komendy: # Umieszczenie znaku & w cudzysłowie jest wymagane do przekazania znaku & # ? nie wymaga umieszczania w cudzysłowie Tworzenie definicji uruchamiania Można uruchamiać widoki operatora z poziomu produktu Tivoli Enterprise Portal przez tworzenie definicji uruchamiania. Kompletne i szczegółowe informacje na temat dodawania definicji uruchamiania zawiera Podręcznik użytkownika IBM Tivoli Monitoring 6.2. W przypadku uruchamiania widoku operatora z poziomu produktu Tivoli Enterprise Portal można również wybrać opcję przesłania informacji o zdarzeniach do widoku operatora przez zastosowanie argumentów zastępczych w definicji uruchamiania. Poniższy zrzut ekranu przedstawia przykład definicji uruchamiania widoku operatora produktu Netcool/Impact. Ważne: Należy stosować nazwy plików w formacie 8.3 w systemie operacyjnym Windows. W oknie Utwórz lub edytuj definicje uruchamiania należy wypełnić następujące pola dla widoku operatora: Nazwa Rozdział 2. Integrowanie produktu Netcool/Impact z portalem Tivoli Enterprise Portal 5 Nazwa definicji uruchamiania, w tym wypadku jest to ovw. Cel Proces do uruchomienia. Pełna ścieżka w tym przykładzie: C:\ProgramFiles\IBM\ netcool\impact\integrations\ovw\OVWrap-2.bat. Do poprawnego działania (Windows 2000, ITM 6.2 FP 4) długie nazwy plików muszą być skrócone do formatu DOS 8.3. Konwencja 8.3 stosowana do nazw plików ma również zastosowanie w konsoli ITM 6.2.2 oraz w systemie operacyjnym Windows 2003. Argumenty Podstawione wartości z obiektu, dla którego wybrano opcję uruchamiania. W tym przykładzie użyto: &ISITSTSH.ORIGINNODE &EVENTCONSOLE.STATENAME &ISITSTSH.SITNAME. Uruchom w Określa, który folder ma być używany podczas uruchamiania. Należy użyć tego samego folderu, w którym zapisano plik wsadowy. W ścieżkach plików wymagane jest stosowanie konwencji 8.3 dla nazw plików w systemie operacyjnym Windows. Przykład: To jest przykład prostego widoku operatora, który wyświetla przekazane mu dane. 6 Netcool/Impact: Podręcznik integrowania Przykłady widoków operatora Oto przykład widoku operatora. Dane gromadzone z różnych aplikacji są wyświetlane na jednym panelu. Do analizowania uzyskanych danych użyto kolorów czerwonego i zielonego. Przyciski służą do uruchamiania innych strategi lub do wyświetlania innej strony z wynikami. W kolejnym przykładzie widoku operatora różne dane zostały uzyskane z wykorzystaniem strategii, następnie wyświetlone na stronie WWW. Rozdział 2. Integrowanie produktu Netcool/Impact z portalem Tivoli Enterprise Portal 7 8 Netcool/Impact: Podręcznik integrowania Rozdział 3. Integrowanie produktu Netcool/Impact z produktem IBM Tivoli Monitoring Funkcja integracji pozwala programowi IBM Tivoli Monitoring na przesyłanie komunikatów z serwera Netcool/Impact do konsoli Tivoli Monitoring Universal Message Console. Komunikaty są wysyłane z produktu Tivoli Netcool/Impact do konsoli Tivoli Universal Message Console z wykorzystaniem usług WWW. Konfigurowanie produktu Netcool/Impact w celu wysyłania komunikatów do konsoli Tivoli Monitoring Universal Message Console Poniższa procedura pozwala na skonfigurowanie serwera Netcool/Impact w celu wysyłania komunikatów do konsoli Tivoli Monitoring Universal Message Console 6.1 i nowszej. Procedura 1. Pobierz plik ITMLibraryFunctions.zip z serwisu wiki produktu Netcool/Impact devWorks na stronie Scenarios and Examples (Scenariusze i przykłady) pod następującym adresem URL: https://www.ibm.com/developerworks/mydeveloperworks/ wikis/home?lang=en#/wiki/Tivoli%20Netcool%20Impact/page/Scenarios%20and %20examples 2. Rozpakuj skompresowany plik ITMLibraryFunctions.zip. Zawiera on następujące strategie: v ITMLibraryFunctions.ipl, obejmującą wszystkie wywołania funkcji do produktu Tivoli Monitoring z wykorzystaniem funkcji GetHTTP. v ITMFunctionsCaller.ipl, obejmującą przykłady sposobów wywołania funkcji. 3. Zaimportuj obie strategie do serwera Impact. Więcej informacji na ten temat zawiera publikacja Netcool/Impact Interfejs użytkownika, sekcja Praca ze strategiami, Wysyłanie strategii. 4. Zaktualizuj strategię ITMFunctionsCaller konkretnymi danymi produktu Tivoli Monitoring, takimi jak nazwa hosta, port, nazwa użytkownika, hasło, atrybut oraz obiekt na podstawie funkcji, która ma zostać wywołana. Zapamiętaj: Przykładowa funkcja wykorzystuje wartości domyślne. 5. Uruchom strategię. Funkcje zwracają łańcuch w formacie XML. Uzyskiwanie danych z produktu Tivoli Monitoring 6.3 z wykorzystaniem dostawcy danych dla interfejsu użytkownika Aby uzyskać dane z produktu Tivoli Monitoring 6.3, należy użyć agenta DSA dostawcy danych dla interfejsu użytkownika w celu uzyskania dostępu do dostawcy danych produktu Tivoli Monitoring. Procedura Więcej informacji na ten temat można uzyskać pod następującym adresem i w odpowiedniej publikacji w Centrum informacyjnym: © Copyright IBM Corp. 2006, 2014 9 v serwis wiki Netcool/Impact devWorks, strona Scenarios and Examples (Scenariusze i przykłady) pod następującym adresem URL: https://www.ibm.com/developerworks/ mydeveloperworks/wikis/home?lang=en#/wiki/Tivoli%20Netcool%20Impact/page/ Scenarios%20and%20examples v Publikacja Netcool/Impact Rozwiązania, Tworzenie wizualizacji danych z dostawcy danych interfejsu użytkownika w konsoli, Tworzenie wizualizacji stron zespolonych danych z dwóch źródeł produktu IBM Tivoli Monitoring. W tym przykładzie przedstawiono sposób tworzenia wizualizacji danych ze źródeł produktu Tivoli Monitoring w panelu kontrolnym. Można użyć tego sposobu w celu pobrania danych na potrzeby zarządzania zdarzeniami. Jedyną różnicą jest pominięcie kroku, w którym opisano sposób tworzenia parametrów wyjściowych użytkownika dla strategii. 10 Netcool/Impact: Podręcznik integrowania Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console Integracja produktów Tivoli Enterprise Console i Netcool/Impact pozwala użyć konsoli Tivoli Enterprise Console jako źródła zdarzeń dla serwera Netcool/Impact w bardzo podobny sposób jak serwer Netcool/OMNIbus. Przegląd procesu integrowania Serwer Tivoli Enterprise Console może być używany jako źródło zdarzeń dla serwera Netcool/Impact w bardzo podobny sposób jak serwer Netcool/OMNIbus. Można użyć opisywanej tu funkcji integrowania w celu przyłączenia serwera Netcool/Impact do serwera Tivoli Enterprise Console i przetwarzania zdarzeń w taki sam sposób jak przetwarzane są zdarzenia Netcool/OMNIbus. Funkcja integrowania może być używana do: v Przechwytywania za pomocą czytnika zdarzeń nowych lub zaktualizowanych zdarzeń serwera Tivoli Enterprise Console w celu przetwarzania v Wzbogacania zdarzeń przechwyconych przez czytnik zdarzeń v Wstawiania nowych zdarzeń do serwera Tivoli Enterprise Console Serwer Netcool/Impact pobiera nowe lub zaktualizowane zdarzenia z bazy danych konsoli Tivoli Enterprise Console, używając czytnika zdarzeń. Funkcje serwera Netcool/Impact są używane do wzbogacenia istniejących zdarzeń konsoli Tivoli Enterprise Console lub wysyłania nowych zdarzeń do konsoli Tivoli Enterprise Console z wykorzystaniem API EIF Tivoli Enterprise Console. Serwer Tivoli Enterprise Console był platformą zarządzania zdarzeniami Tivoli przed serwerem Netcool/OMNIbus. Jeśli nie masz doświadczenia z produktem Tivoli Enterprise Console, zapoznaj się z następującymi pojęciami: v Tabele bazy danych: – Tabela TEC_T_EVT_REP – Tabela TEC_T_SLOTS_EVT Więcej informacji na temat tabel Tivoli Enterprise Console zawiera sekcja “Tabele bazy danych konsoli Tivoli Enterprise Console” na stronie 13. v Klasy TEC: Każde zdarzenie w serwerze Tivoli Enterprise Console należy do klasy. Klasa definiuje sposób przetwarzania odbieranych w zdarzeniu surowych par atrybut=wartość. Więcej informacji na temat klas zawiera sekcja “Klasy konsoli Tivoli Enterprise Console” na stronie 15. © Copyright IBM Corp. 2006, 2014 11 v Reguły TEC: Produkt Tivoli Enterprise Console uruchamia reguły dla odbieranych zdarzeń na podstawie klas. Więcej informacji na temat reguł zawiera sekcja “Reguły konsoli Tivoli Enterprise Console” na stronie 16. v API EIF: API EIF jest używane do przesyłania zdarzeń Tivoli Enterprise Console. Funkcje API EIF są używane w sondzie Netcool/OMNIbus Tivoli Enterprise Console. Więcej informacji na temat API EIF zawiera sekcja “API EIF konsoli Tivoli Enterprise Console” na stronie 14. Architektura integrowania Serwer Netcool/Impact pobiera nowe lub zaktualizowane zdarzenia z bazy danych konsoli Tivoli Enterprise Console, używając czytnika zdarzeń. Nowe funkcje serwera Netcool/Impact są używane do wzbogacenia istniejących zdarzeń konsoli Tivoli Enterprise Console lub wysyłania nowych zdarzeń do konsoli Tivoli Enterprise Console z wykorzystaniem API EIF Tivoli Enterprise Console. Czytnik zdarzeń jest używany do odczytania nowych lub zaktualizowanych wierszy w tabeli TEC_T_EVT_REP. Funkcje konsoli Tivoli Enterprise Console. Więcej informacji na temat funkcji konsoli Tivoli Enterprise Console zawiera sekcja “Funkcje produktu Tivoli Enterprise Console” na stronie 16. API EIF. Różne funkcje konsoli Tivoli Enterprise Console w serwerze Netcool/Impact wykorzystują API EIF do pobrania nowych lub zaktualizowanych zdarzeń. Zdarzenia przesyłane do konsoli Tivoli Enterprise Console są najpierw zapisywane w tabeli TEC_T_EVT_REC_LOG. Więcej informacji na temat API EIF zawiera sekcja “API EIF konsoli Tivoli Enterprise Console” na stronie 14. Klasy konsoli Tivoli Enterprise Console. Więcej informacji na temat klas konsoli Tivoli Enterprise Console zawiera sekcja “Klasy konsoli Tivoli Enterprise Console” na stronie 15. Reguły konsoli Tivoli Enterprise Console. Więcej informacji na temat reguł konsoli Tivoli Enterprise Console zawiera sekcja “Reguły konsoli Tivoli Enterprise Console” na stronie 16. 12 Netcool/Impact: Podręcznik integrowania Tabele bazy danych konsoli Tivoli Enterprise Console Funkcja integracji używa następujących tabel bazy danych konsoli Tivoli Enterprise Console: v TEC_T_EVT_REP v TEC_T_SLOTS_EVT Tabela TEC_T_EVT_REP w bazie danych Tabela TEC_T_EVT_REP jest główną tabelą, w której przechowywane są zdarzenia i z której są pobierane dane wyświetlane przez interfejs GUI konsoli Tivoli Enterprise Console. Tabela ta jest podobna do alert.status serwera Netcool/OMNIbus z następującymi różnicami: v Tabela TEC_T_EVT_REP nie jest rozszerzalna. Istnieje możliwość zdefiniowania dodatkowych par atrybut=wartość (nazywanych szczelinami) do przechowywania danych, nie będą one jednak mieć własnych pól i będą przechowywane w oddzielnej tabeli. v Tabela TEC_T_EVT_REP ma trzy pola kluczowe: – SERVER_HNDL – EVENT_HDNL – DATE_RECEPTION Pełny opis pól tabeli TEC_T_EVT_REP zawiera dokumentacja konsoli Tivoli Enterprise Console. TEC_T_EVT_REP i Impact TEC_T_EVT_REP jest tabelą produktu Tivoli Enterprise Console sprawdzaną przez czytnik zdarzeń Netcool/Impact w celu przechwycenia nowych lub zaktualizowanych zdarzeń. Polem datownika używanym przy pracy ze zaktualizowanym zdarzeniami jest LAST_MODIFIED_TIME. Polem kluczowym może być cokolwiek. Zdarzenia nie są zwracane do konsoli Tivoli Enterprise Console przez czytnik zdarzeń serwera Netcool/Impact, są przesyłane z użyciem API EIF. Pole CREDIBILITY ma zwykle wartość 0 i nie jest używane przez klientów. Może być używane jako pole serwera Netcool/Impact do wskazania, że wiersz konsoli Tivoli Enterprise Console został przetworzony przez serwer Netcool/Impact. Pole CREDIBILITY ma wartość 5 dla zdarzeń zaktualizowanych przez domyślne reguły produktu Tivoli Enterprise Console dostarczane wraz z funkcją integrowania na serwerze Netcool/Impact. Pole STATUS może mieć wartość 0 (otwarte), 20 (potwierdzone) i 30 (zamknięte). Można używać tego pola zgodnie z potrzebami w filtrach czytnika zdarzeń. Tabela TEC_T_SLOTS_EVT w bazie danych Główna tabela zdarzeń TEC_T_EVT_REP nie jest rozszerzalna. Nowe szczeliny są definiowane i przechowywane w tabeli TEC_T_SLOTS_EVT. Nazwa szczeliny jest zapisywana w polu SLOT_NAME. Wartość jest przechowywana w polu SHORT_SLOT_VALUE lub LONG_SLOT_VALUE w zależności od typu wartości. Konsola Tivoli Enterprise Console dodaje dane do prawej wartości pola. Wiersze w tabeli TEC_T_SLOTS_EVT są łączone z powrotem z wierszami TEC_T_EVT_REP według pól kluczowych SERVER_HNDL, EVENT_HNDL i DATE_RECEPTION. Wartości szczelin zdarzenia można przeglądać w interfejsie GUI produktu Tivoli Enterprise Console. Wybierz zdarzenie i kliknij przycisk Szczegóły. Tabela TEC_T_SLOTS_EVT ma następujące pola: v SLOT_NAME v SHORT_SLOT_VALUE v LONG_SLOT_VALUE v SERVER_HNDL v EVENT_HNDL Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 13 v DATE_RECEPTION TEC_T_SLOTS_EVT i Impact Dodatkowe dane szczeliny zdarzenia są przechowywane w tabeli TEC_T_SLOTS_EVT. Czytnik zdarzeń sprawdza tabelę TEC_T_EVT_REP. Oznacza to, że strategia uruchomiona przez czytnik zdarzeń nie zawiera danych szczeliny. Jeśli w strategii konieczne jest użycie danych szczeliny, można użyć funkcji TEC.getSlots() języka IPL do ich pobrania i dodania do kontenera zdarzeń. Wartość w tych szczelinach można zmieniać tak jak dla zwykłych pól kontenera zdarzeń (@). Konsola Tivoli Enterprise Console określa, gdzie zostaną zapisane wartości po zwróceniu zdarzenia do konsoli Tivoli Enterprise Console przez funkcję TEC.returnTECEvent() języka IPL. API EIF konsoli Tivoli Enterprise Console Różne funkcje konsoli Tivoli Enterprise Console w serwerze Netcool/Impact wykorzystują API EIF do pobrania nowych lub zaktualizowanych zdarzeń. Parametry komunikacyjne produktu Tivoli Enterprise Console wymagane przez funkcję API są zapisane w pliku ImpactTECAgent.conf, który zwykle znajduje się w katalogu $IMPACT_HOME/impact/ etc. Zdarzenia przesyłane do konsoli Tivoli Enterprise Console są najpierw zapisywane w tabeli TEC_T_EVT_REC_LOG, zanim będą używane w klasach lub regułach TEC. Komenda wtdumprl wyświetla zawartość tabeli TEC_T_EVT_REC_LOG w wierszu komend. Komenda wtdumprl jest przydatna podczas próby określenia, dlaczego nowe lub zmienione zdarzenia przesyłane przez serwer Netcool/Impact nie przechodzą do tabeli TEC_T_EVT_REP. API EIF jest używane do przesyłania zdarzeń konsoli Tivoli Enterprise Console. Jest też używane w sondzie Netcool/OMNIbus Tivoli Enterprise Console. Serwer Netcool/Impact używa tego API do przesyłania zdarzeń do konsoli Tivoli Enterprise Console. 14 Netcool/Impact: Podręcznik integrowania Klasy konsoli Tivoli Enterprise Console Zdarzenia w TEC_T_EVT_REC_LOG najpierw są sprawdzane pod względem klasy. Jeśli zdarzenie ma niepoprawną klasę lub pary atrybut=wartość nie są wymienione we wskazanej klasie, zdarzenie nie jest dalej przetwarzane. Funkcja TEC.returnTECEvent() używa klasy IMPACT_Update. Funkcja TEC.insertTECEvent() używa klasy IMPACT. Funkcja TEC.insertTECEventOfClass() używa klasy przekazanej do funkcji. Każde zdarzenie w serwerze Tivoli Enterprise Console należy do klasy. Klasa definiuje sposób przetwarzania odbieranych w zdarzeniu surowych par atrybut=wartość. Klasa definiuje, w których polach TEC_T_EVT_REP są zapisywane odbierane zdarzenia. Jeśli w klasie zdefiniowane są dodatkowe szczeliny, klasa określa również sposób umieszczania pozostałych par atrybut=wartość w TEC_T_SLOTS_EVT. Klasy konsoli Tivoli Enterprise Console obsługują dziedziczenie. Nowe klasy dziedziczą wszystkie przypisania pól i szczeliny z klas nadrzędnych. Jeśli zdarzenie surowe zawiera pary atrybut=wartość, które nie są zdefiniowane w klasie, jest ono odrzucane. Uwaga: Odrzucone zdarzenia można przejrzeć, uruchamiając komendę wtdumprl na hoście konsoli Tivoli Enterprise Console. v v v v IMPACT_Data IMPACT_Base IMPACT IMPACT_Update Klasy konsoli Tivoli Enterprise Console i serwera Netcool/Impact W funkcji integracji istnieją zdefiniowane nowe cztery klasy Tivoli Enterprise Console. v Klasa IMPACT_Data pochodzi od podstawowej klasy konsoli Tivoli Enterprise Console EVENT i dodaje szczeliny impact_Service_Desk_Ticket, impact_OnCall_Technician oraz impact_EventOperatorView. IMPACT_Data jest klasą używaną do dodawania szczelin w celu wzbogacenia klas. v Klasa IMPACT_Base pochodzi od IMPACT_Data i dodaje szczeliny impact_instance oraz impact_status. Szczelina impact_instance może być używana do zidentyfikowania klastra Netcool/Impact, który zaktualizował zdarzenie. Aby ustawić wartość szczeliny impact_instance, należy ręcznie ustawić wartość. Szczelina impact_status jest używana przez reguły konsoli Tivoli Enterprise Console do ustawiania wartości STATUS w aktualizowanym zdarzeniu. Nie ma konieczności samodzielnego ustawiania szczeliny impact_status. Funkcja TEC.returnTECEvent() ustawia impact_status na wartość @STATUS. v Klasa IMPACT pochodzi od IMPACT_Base i dodaje identyfikator szczeliny. Identyfikator musi być ustawiany i jest używany w celu deduplikowania zdarzeń klasy IMPACT wstawianych przez serwer Impact. Wartość ustawianego identyfikatora zależy od użytkownika. Należy ją ustawiać w taki sam sposób jak pole identyfikatora Netcool/OMNIbus. v Klasa IMPACT_Update pochodzi od IMPACT_Base i dodaje szczeliny server_handle, event_handle i date_reception. Wszystkie te szczeliny są ustawiane przez funkcję returnTECEvent(). Wartości są kopiowane z @SERVER_HNDL, @EVENT_HNDL i @DATE_RECEPTION. Są one używane w regułach konsoli Tivoli Enterprise Console. Szczeliny dostarczane z funkcją Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 15 integracji są przykładami. Jeśli jest to konieczne w danym środowisku, można dodać własne szczeliny. Reguły konsoli Tivoli Enterprise Console Reguła Dedup_impact_events jest uruchamiana dla zdarzeń klasy IMPACT. Używa szczeliny identyfikatora w klasie IMPACT do deduplikowania zdarzeń wstawianych przez serwer Impact. Reguła Impact_update_events jest uruchamiana dla zdarzeń klasy IMPACT_Update. Klasa IMPACT_Update jest klasą przypisaną do wszystkich zaktualizowanych zdarzeń zwracanych do produktu Tivoli Enterprise Console przez serwer Netcool/Impact. Ta reguła używa szczelin server_handle, event_handle i data_reception zdefiniowanych w klasie IMPACT_Update w celu odnalezienia i zaktualizowania oryginalnego zdarzenia Tivoli Enterprise Console. Pole credibility w oryginalnym zdarzeniu jest ustawiane na wartość 5. Zdarzenie klasy IMPACT_Update przesyłane przez serwer Impact jest następnie odrzucane. Produkt Tivoli Enterprise Console uruchamia reguły dla odbieranych zdarzeń na podstawie klas. Reguły te mogą korelować zdarzenia w serwerze Tivoli Enterprise Console, aktualizować wartości w serwerze Tivoli Enterprise Console, usuwać zdarzenia i uruchamiać procesy zewnętrzne. Reguły produktu Tivoli Enterprise Console łączą funkcjonalność plików reguł OMNIbus i procedur SQL OMNIbus. Reguły produktu Tivoli Enterprise Console i serwera Netcool/Impact Na potrzeby funkcji integracji zdefiniowano dwie nowe reguły produktu Tivoli Enterprise Console. v Reguła Dedup_impact_events jest uruchamiana dla zdarzeń klasy IMPACT. Używa szczeliny identyfikatora w klasie IMPACT do deduplikowania zdarzeń wstawianych przez serwer Impact. v Reguła Impact_update_events jest uruchamiana dla zdarzeń klasy IMPACT_Update. Klasa IMPACT_Update jest klasą przypisaną do wszystkich zaktualizowanych zdarzeń zwracanych do produktu Tivoli Enterprise Console przez serwer Netcool/Impact. Ta reguła używa szczelin server_handle, event_handle i data_reception zdefiniowanych w klasie IMPACT_Update w celu odnalezienia i zaktualizowania oryginalnego zdarzenia produktu Tivoli Enterprise Console. Zdarzenie klasy IMPACT_Update przesyłane przez serwer Netcool/Impact jest następnie odrzucane. Funkcje produktu Tivoli Enterprise Console Funkcje serwera Netcool/Impact są używane do wzbogacenia istniejących zdarzeń konsoli Tivoli Enterprise Console lub wysyłania nowych zdarzeń do konsoli Tivoli Enterprise Console z wykorzystaniem API EIF Tivoli Enterprise Console. getSlots Ta funkcja pobiera kontener zdarzeń ze zdarzenia produktu Tivoli Enterprise Console, pobiera dodatkowe szczeliny z tabeli TEC_T_SLOTS_EVT i dodaje je do kontenera zdarzeń. Składnia funkcji jest następująca: TEC.getSlots(TEC_T_SLOTS_EVT EventContainer) 16 Netcool/Impact: Podręcznik integrowania Powinna być używana ze zdarzeniami, które mają dane w używanej tabeli szczelin. Ta funkcja jest opcjonalna. returnTECEvent Ta funkcja jest używana do zwracania zaktualizowanego zdarzenia do produktu Tivoli Enterprise Console z wykorzystaniem klasy IMPACT_Update. Składnia funkcji jest następująca: TEC.returnTECEvent(EventContainer) Ta funkcja powinna być wywoływana zamiast funkcji returnevent(). insertTECEvent Ta funkcja pobiera kontekst i przesyła go do produktu Tivoli Enterprise Console jako zdarzenie klasy IMPACT. Składnia funkcji jest następująca: TEC.insertTECEvent(context) Do produktu Tivoli Enterprise Console będą przesyłane tylko te atrybuty kontekstu, których nazwy są umieszczone na liście w zmiennej TEC_Insert_ValidSlots na początku strategii Tivoli Enterprise Console, na przykład myContext.paintColor. Dodatkowe atrybuty kontekstu będą odrzucane przez serwer Impact. Jeśli nowe zdarzenie jest przesyłane do produktu Tivoli Enterprise Console i jeśli zawiera ono szczeliny, które nie są obsługiwane przez klasę IMPACT, zdarzenie zostanie odrzucone przez produkt Tivoli Enterprise Console. Lista w zmiennej IPL TEC_Insert_ValidSlots musi być poprawnie ustawiona. insertTECEventOfClass Ta funkcja pobiera kontekst i przesyła go do produktu Tivoli Enterprise Console jako zdarzenie o klasie podanej w wywołaniu funkcji. Składnia funkcji jest następująca: TEC.insertTECEventOfClass(context, class) Uwaga: Jeśli kontekst ma atrybuty, na przykład myContext.paintColor, które nie są obsługiwane przez klasę, zdarzenie zostanie odrzucone przez produkt Tivoli Enterprise Console. Konfigurowanie integrowania z konsolą Tivoli Enterprise Console Aby skonfigurować funkcję integracji, należy wykonać szereg czynności na serwerach Netcool/Impact i Tivoli Enterprise Console. Procedura 1. Konfigurowanie integrowania z serwerem Tivoli Enterprise Console: a. Dodaj udostępnione klasy do podstawy reguł TEC. Więcej informacji na ten temat zawiera sekcja “Dodawanie klas do podstawy reguł TEC” na stronie 18. b. Dodaj udostępnione reguły do podstawy reguł TEC. Więcej informacji na ten temat zawiera sekcja “Dodawanie udostępnionych reguł do podstawy reguł TEC” na stronie 18. Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 17 c. Sprawdź, czy produkt Tivoli Enterprise Console używa stałego portu komunikacyjnego. Więcej informacji na ten temat zawiera sekcja “Konfigurowanie produktu Tivoli Enterprise Console do używania ustalonego portu komunikacyjnego”. 2. Konfigurowanie integrowania z serwerem Netcool/Impact. a. Zaktualizuj plik ImpactTECAgent.conf. Więcej informacji na ten temat zawiera sekcja “Aktualizowanie pliku ImpactTECAgent.conf” na stronie 19. b. Zaktualizuj strategię TEC. Więcej informacji na ten temat zawiera sekcja “Aktualizowanie strategii TEC” na stronie 19. c. Utwórz połączenia z bazą danych. Więcej informacji na ten temat zawiera sekcja “Tworzenie połączeń z bazą danych” na stronie 20. d. Skonfiguruj czytnik zdarzeń. Więcej informacji na ten temat zawiera sekcja “Konfigurowanie czytnika zdarzeń” na stronie 22. Dodawanie klas do podstawy reguł TEC Nowe klasy są zdefiniowane w pliku IMPACT.baroc w katalogu $IMPACT_HOME/impact/ integrations/tec/rules w serwerze Impact. Procedura Postępuj zgodnie z instrukcjami w dokumentacji produktu Tivoli Enterprise Console, aby dodać klasy do podstawy reguł TEC: http://www.ibm.com/tivoli/documentation. Dodawanie udostępnionych reguł do podstawy reguł TEC Nowe reguły są zdefiniowane w pliku IMPACT_tec.rules w katalogu $IMPACT_HOME/impact/integrations/tec/rules w serwerze Impact. Procedura Postępuj zgodnie z instrukcjami w dokumentacji produktu Tivoli Enterprise Console, aby dodać reguły do podstawy reguł TEC: http://www.ibm.com/tivoli/documentation. Konfigurowanie produktu Tivoli Enterprise Console do używania ustalonego portu komunikacyjnego Może zajść konieczność skonfigurowania instancji produktu Tivoli Enterprise Console do używania ustalonego portu IP. Procedura Otwórz do edycji plik /usr/local/Tivoli/bin/<platforma>/TME/TEC/.tec_config. Jeśli jest to konieczne, usuń komentarz parametru tec_recv_agent_port i zrestartuj serwer Tivoli Enterprise Console. W systemach operacyjnych Windows to może nie być konieczne. Zapoznaj się z dokumentacją produktu Tivoli Enterprise Console dostępną pod adresem: http://www.ibm.com/tivoli/documentation. 18 Netcool/Impact: Podręcznik integrowania Aktualizowanie pliku ImpactTECAgent.conf O tym zadaniu Plik konfiguracyjny agenta Tivoli Enterprise Console ma nazwę ImpactTECAgent.conf i jest zapisywany w katalogu $IMPACT_HOME/impact/etc. BufEvtPath=/home/netcool/data/tecLogs/tecplus.log BufferEvents=YES TransportList=t1_ t1_Type=SOCKET t1_Channels=c1_ c1_ServerLocation=tiv c1_Port=5529 LogLevel=ALL TraceLevel=ALL LogFileName=/home/netcool/data/tecLogs/teclog.log TraceFileName=/home/netcool/data/tecLogs/tectrace.log Należy zmodyfikować następujące parametry: v BufEvtPath - jest to ścieżka do pliku buforu. Plik buforu jest używany do przechowywania wstawień i aktualizacji, gdy występuje problem w komunikacji z serwerem Tivoli Enterprise Console. Jeśli wystąpi problem z komunikacją z serwerem TEC, w pliku tym będą zapisywane buforowane zdarzenia. v c1_ServerLocation - jest to adres IP lub nazwa hosta, na którym działa serwer Tivoli Enterprise Console. v c1_Port - jest to numer portu na którym produkt Tivoli Enterprise Console nasłuchuje na żądania przesyłane przez serwer Impact. Instancja serwera Tivoli Enterprise Console może być skonfigurowana do używania ustalonego portu. Zmodyfikuj plik /usr/local/Tivoli/bin/<platform>/TME/TEC/.tec_config i usuń komentarz dla zmiennej tec_recv_agent_port. Zrestartuj serwer Tivoli Enterprise Console. W systemach operacyjnych Windows to może nie być konieczne. Więcej informacji na ten temat zawiera dokumentacja produktu Tivoli Enterprise Console dostępna w serwisie http://www.ibm.com/tivoli/documentation. v LogFileName - plik dziennika wywołań API EIF. Jeśli wystąpił problem w komunikacji z serwerem Tivoli Enterprise Console, w tym pliku będą rejestrowane komunikaty Failed to connect to port <port> on server "<serwer>". Uwaga: Jeśli wszystko działa, zostanie zarejestrowany problem z plikiem buforującym. v TraceFileName - zawiera szczegółowe informacje na temat komunikacji z serwerem Tivoli Enterprise Console. Jeśli występuje problem w komunikacji z serwerem Tivoli Enterprise Console, w tym dzienniku będzie zapisywany wyjątek odmowy połączenia (Connection Refused). Uwaga: W klastrowym środowisku Netcool/Impact ten plik musi być skonfigurowany na każdym serwerze Netcool/Impact w klastrze. Aktualizowanie strategii TEC Aby dostosować strategię TEC do danego środowiska, należy zmodyfikować pięć zmiennych. 1. W interfejsie GUI serwera Tivoli Integrated Portal wybierz projekt TEC. 2. Wybierz kolejno opcje Automatyzacja zdarzeń > Strategie. 1. Wybierz strategię TEC i kliknij ikonę Edytuj. Odszukaj następujące wiersze: //TEC Class used to identify new inserts from Impact TEC_InsertClass = "IMPACT"; //TEC Class used to identify that updates to an existing event are being passed Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 19 TEC_UpdateClass = "IMPACT_Update"; //valid slots for the TEC class named in TEC_InsertClass TEC_Insert_ValidSlots = "severity, msg, hostname, impact_MRO_Service_Desk_Ticket, impact_instance, identifier"; //valid slots for the TEC class named in TEC_UpdateCLass TEC_Update_ValidSlots = "impact_MRO_Service_Desk_Ticket, severity, msg"; // full path to the ImpactTECAgent.conf file ImpactTECAgentConfFileLocation = "/opt/ibm/netcool/impact/etc/ImpactTECAgent.conf"; v Pierwsze cztery zmienne dotyczą TEC. Wartości domyślne działają z klasami i regułami TEC dostarczanymi wraz z funkcją integrowania. v Jeśli szczeliny obsługiwane przez te klasy i reguły zostały rozbudowane, należy zaktualizować zmienne TEC_Insert_ValidSlots i TEC_Update_ValidSlots. v Ostatnia zmienna (ImpactTECAgentConfFileLocation) jest pełną ścieżką pliku konfiguracyjnego używanego przez serwer Impact do komunikowania się z produktem Tivoli Enterprise Console. Tworzenie połączeń z bazą danych Procedura 1. Skonfiguruj połączenie źródła danych z bazą danych używaną przez serwer Tivoli Enterprise Console. Należy skonfigurować dwa typu danych TEC_evt_rep i TEC_slots_evt, które używają źródła danych DB2TECtiv. Administrator serwera Tivoli Enterprise Console lub bazy danych może podać informacje niezbędne do nawiązania połączenia. 20 Netcool/Impact: Podręcznik integrowania Uwaga: Jeśli serwer Tivoli Enterprise Console używa bazy danych DB2, wówczas może być konieczne zmodyfikowanie ustawień serwera Impact w zależności od wersji produktu Netcool/Impact i bazy danych DB2. Więcej informacji zawiera dokumentacja serwera Netcool/Impact. 2. Utwórz typ danych TEC_evt_rep. 3. W polu Nazwa typu danych utwórz następujący typ danych: TEC_evt_rep. Pole Nazwa źródła danych jest automatycznie zapełniane źródłem danych DB2TECtiv. Pole wyboru Stan jest zaznaczone. 4. Typ danych TEC_evt_rep łączy się z tabelą TEC_T_EVT_REP 5. Kliknij przycisk Nowe obok pola Nowe pole. 6. Dodaj jako pola kluczowe: DATE_RECEPTION, SERVER_HNDL i EVENT_HNDL. 7. Kliknij przycisk OK, następnie kliknij przycisk Zapisz, aby utworzyć typ danych. 8. Utwórz typ danych TEC_slots_evt. Nazwa typu danych i wielkość stosowanych liter ma znaczenie. 9. Typ danych TEC_slots_evt łączy się z tabelą TEC_T_SLOTS_EVT. 10. Kliknij przycisk Nowe obok pola Nowe pole. 11. Dodaj jako pola kluczowe: DATE_RECEPTION, SERVER_HNDL, EVENT_HNDL i SLOT_NAME. Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 21 12. Kliknij przycisk OK, następnie kliknij przycisk Zapisz, aby utworzyć typ danych. Konfigurowanie czytnika zdarzeń Nowe lub zaktualizowane zdarzenia są przechwytywane z Tivoli Enterprise Console za pomocą czytnika zdarzeń. Czytnik zdarzeń musi wskazywać na typ danych TEC_evt_rep: 1. W drzewie nawigacyjnym rozwiń węzły Konfiguracja systemu > Automatyzacja zdarzeń. Następnie kliknij opcję Usługi, aby otworzyć kartę Usługi. 2. Na karcie Usługi wybierz usługę DatabaseEventReader. 3. W polu Nazwa usługi wpisz TECEventReader. 4. W polu Źródło danych wybierz DB2TECtiv. 5. 6. 7. 8. W polu Typ danych wybierz TEC_evt_rep. Zaznacz pola wyboru Uruchamianie i Dziennik usługi. Kliknij kartę Odwzorowanie zdarzeń. Jeśli serwer Netcool/Impact ma przetwarzać zaktualizowane zdarzenia, zaznacz pole wyboru Pobierz zaktualizowane zdarzenia. 9. Wybierz pole LAST_MODIFIED_TIME jako pole datownika. 10. Wartość w polu Pole kluczowe nie ma znaczenia, ponieważ funkcja integrowania serwera Tivoli Enterprise Console nie zapisuje bezpośrednio w bazie danych Tivoli Enterprise Console. Można użyć pola DATE_RECEPTION lub innego. 11. Kliknij przycisk Nowe obok opcji Nowe odwzorowanie, aby otworzyć okno Utwórz nowy filtr zdarzeń. 12. W polu wyrażenia filtru wpisz CREDIBILITY. Pole CREDIBILITY może być używane jako flaga "impact". Pole CREDIBILTITY ma domyślnie wartość 0, zdarzenia zaktualizowane przez serwer Netcool/Impact mają ustawioną wartość 5 przez nowe reguły Tivoli Enterprise Console dostarczane z funkcją integrowania. Wartości w polu STATUS serwera Tivoli Enterprise Console są następujące: v 0 - otwarte v 20 - potwierdzone v 30 - zamknięte 13. Na liście Nazwa strategii wybierz TECexample_update. 14. Zaznacz pole wyboru Aktywne. Kliknij przycisk OK, aby dodać odwzorowanie zdarzeń do czytnika zdarzeń. 15. Kliknij przycisk Zapisz. Testowanie konfiguracji Po zakończeniu wszystkich czynności konfiguracyjnych produktu Tivoli Enterprise Console i Netcool/Impact można przystąpić do testowania integracji. O tym zadaniu Dostępne są trzy strategie testowe: TECexample_insert, TECexample_insert_2 oraz TECexample_update. v Strategia TECexample_insert wstawia nowe zdarzenie do produktu Tivoli Enterprise Console. Nowe zdarzenie będzie mieć nazwę hosta w2kc insario05 i komunikat „test insert from Impact”. Dodatkowa szczelina impact_MRO_Service_Desk_Ticket będzie mieć wartość „none”. 22 Netcool/Impact: Podręcznik integrowania v Strategia TECexample_insert_2 również wstawia nowe zdarzenie do produktu Tivoli Enterprise Console, używa jednak funkcji TEC.insertTECEventOfClass(), która może być używana do wstawiania zdarzenia dowolnej klasy. v Strategia TECexample_update aktualizuje zdarzenie produktu Tivoli Enterprise Console uzyskane przez czytnik zdarzeń. Zaktualizowane zdarzenie będzie mieć dołączony komunikat „updated by Impact” w polu komunikatu, a wartość impact_MRO_Service_Desk_Ticket zostanie zmieniona na „Ticket # 12345”. Procedura 1. Testowanie wstawiania Uruchom strategię Impact o nazwie TECexample_insert. Strategia ta wstawi nowe zdarzenie do produktu TEC, które będzie wyglądać następująco: 2. Testowanie czytnika Skonfiguruj czytnik zdarzeń w celu uruchamiania strategii TECexample_update dla zdarzeń, w których CREDIBILITY < 5 i STATUS < 30 oraz HOSTNAME = ‘w2kcario05'. Następnie uruchom czytnik zdarzeń. Czytnik ten przetwarza zdarzenie. Po odświeżeniu produktu Tivoli Enterprise Console zdarzenie powinno wyglądać następująco: Pole komunikatu zostało zaktualizowane. Wyniki Skonfigurowana integracja działa! Rozwiązywanie problemów Użyj zamieszczonej w tej sekcji listy kontrolnej, aby się upewnić, że wszystkie kroki instalacji zostały poprawnie wykonane. Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 23 Lista kontrolna instalacji ImpactTECAgent.conf v Czy używasz poprawnej nazwy/adresu IP serwera TEC? v Czy używasz poprawnego numeru portu serwera TEC? v Czy serwer TEC jest skonfigurowany do używania stałego portu? v Czy strategia TEC została zaktualizowana w celu dopasowania do danego środowiska? v Czy szczeliny wymienione w zmiennej IPL TEC_Insert_ValidSlots są zgodne z tymi w klasie IMPACT? v Czy szczeliny wymienione w zmiennej IPL TEC_Update_ValidSlots są zgodne z tymi w klasie IMPACT_Update? v Czy pełna ścieżka w zmiennej IPL ImpactTECAgentConfFileLocation jest poprawna? Połączenie źródła danych z bazą danych TEC Użyj przycisku Testuj połączenie. Typ danych TEC_evt_rep v Czy widoczne są elementy danych pochodzące z tabeli TEC_T_EVT_REP? v Czy typ danych ma nazwę TEC_evt_rep? Typ danych TEC_slots_evt v Czy widoczne są elementy danych pochodzące z tabeli table TEC_T_SLOTS_EVT? v Czy typ danych ma nazwę TEC_slots_evt? Rozwiązywanie problemów po stronie serwera TEC Potwierdzenie klasy i reguły 1. Określ podstawę reguł będącą w użyciu: [root@tiv ~]# wrb -lscurrb. 2. Wyświetl listę wszystkich klas, których nazwy zawierają tekst IMPACT: wrb -lsrbclass -detailed IMPACT <nazwa_podstawy_reguł> | more. Powinny być widoczne: IMPACT_Data, IMPACT_Base, IMPACT i IMPACT_Update. 3. Wyświetl listę wszystkich reguł, których nazwy zawierają tekst IMPACT: wrb -lsrbrule IMPACT <nazwa_podstawy_reguł>. Powinna być widoczna pozycja IMPACT_tec.rls. Dzienniki do sprawdzenia v $NCHOME/log/impactserver.log. Jeśli wszystko zostało poprawnie zainstalowane/utworzone, wówczas w pliku impactserver.log nie powinno być wiele informacji poza wywołaniami Java wykonywanymi przez DSA Java. v $IMPACT_HOME/log/tecbuf.log. Jeśli wystąpił problem w komunikacji z serwerem TEC, w tym pliku będą rejestrowane buforowane zdarzenia Impact. v $IMPACT_HOME/log/tectrace.log. Jeśli wystąpił problem w komunikacji z serwerem TEC, w tym pliku zostanie zarejestrowany wyjątek odmowy połączenia (Connection Refused). W tym pliku rejestrowanych jest wiele działań - przewiń plik do końca, aby odszukać wyjątek. v $IMPACT_HOME/log/teclog.log. Jeśli wystąpił problem w komunikacji z serwerem TEC, zostanie zarejestrowany komunikat: Failed to connect to port <port> on server "<serwer>. 24 Netcool/Impact: Podręcznik integrowania Jeśli wszystko działa, może być zarejestrowany problem z plikiem buforującym. Jest to uruchamiane na serwerze TEC w wierszu komend. Zrzucane są wszystkie zdarzenia odbierane przez serwer TEC. v Komenda wtdumprl. Jeśli przekazywane są błędne szczeliny, zdarzenia nie będą przesyłane do konsoli TEC, a komenda wtdumprl wyświetli błąd analizowania: PARSING_FAILED~’Line 1: Slot myBadSlot not defined in class Modyfikowanie integrowania Istnieje możliwość modyfikowania integrowania przez wykonanie następujących czynności: v Dodanie nowych szczelin do istniejących klas TEC. Więcej informacji na ten temat zawiera sekcja “Dodawanie nowych szczelin do istniejącej konsoli Tivoli Enterprise Console”. v Zaktualizowanie klas IMPACT. Więcej informacji na ten temat zawiera sekcja “Aktualizowanie klasy IMPACT” na stronie 26. v Uruchomienie listy sprawdzeń nowej szczeliny. Więcej informacji na ten temat zawiera sekcja “Lista kontrolna nowej szczeliny” na stronie 26. Dodawanie nowych szczelin do istniejącej konsoli Tivoli Enterprise Console Dodawanie nowych szczelin do istniejących klas TEC można łatwo wykonać, stosując dziedziczenie wielobazowe. Przykład: TEC_CLASS : alphaOne ISA EVENT; END TEC_CLASS: IMPACT_Data ISA EVENT DEFINES { impact_MRO_Service_Desk_Ticket: STRING; impact_OnCall_Technician: STRING; impact_EventOperatorView: STRING; }; END TEC_CLASS : BetaTwo ISA [alphaOne, IMPACT_Data]; END W tym przykładzie BetaTwo dziedziczy zarówno z alphaOne jak i z IMPACT_Data. Dzięki dziedziczeniu każda klasa pochodząca od BetaTwo odziedziczy wszystkie szczeliny pochodzące od alphaOne i IMPACT_Data. W ten sposób szczeliny używane z serwerem Impact można szybko dodać do struktury klas. Stosując funkcję returnTECEvent() języka IPL, serwer Impact wysyła zaktualizowane zdarzenia do konsoli TEC z klasą IMPACT_Update. Dzieje się tak niezależnie od tego, jaka była klasa oryginalnego zdarzenia. Jeśli do klasy były dodane szczeliny i jeśli serwer Impact ma je aktualizować, szczeliny muszą być dodane do klasy IMPACT_Update. Zaleca się dodanie wszystkich szczelin dotyczących systemu Impact do klasy IMPACT_Data. Klasa IMPACT_Update dziedziczy z klasy IMPACT_Data. Aktualizowanie serwera Impact w celu obsługi nowych szczelin Po dodaniu szczelin do konsoli TEC, należy zaktualizować strategię TEC w serwerze Impact. Funkcja returnTECEvent() języka IPL wysyła zaktualizowane zdarzenia do konsoli TEC z klasą IMPACT_Update. Dzieje się tak niezależnie od tego, jaka była klasa oryginalnego Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 25 zdarzenia. W zdarzeniu aktualizacji będą wysyłane tylko te szczeliny, które zostały wymienione w zmiennej TEC_Update_ValidSlots strategii. Wszystkie pozostałe szczeliny zostaną pominięte przez strategię. Jeśli do klas TEC zostały dodane szczeliny, które mają być aktualizowane przez serwer Impact, należy zmodyfikować zmienną TEC_Update_ValidSlots w strategii TEC. Aktualizowanie reguły Impact_update_events w celu obsługi nowych szczelin Gdy serwer Impact wysyła zaktualizowane zdarzenie do konsoli TEC, używaną klasą jest klasa IMPACT_Update. Reguła Impact_update_events jest uruchamiana dla zdarzeń klasy IMPACT_Update. Reguła ta używa szczelin IMPACT_Update: server_handle, event_handle i date_reception do odszukania oryginalnego zdarzenia i zaktualizowania wszystkich szczelin określonych w regule. Następnie usuwa zdarzenie klasy IMPACT_Update. Jeśli do klasy były dodane nowe szczeliny i jeśli serwer Impact ma je aktualizować w TEC, należy zaktualizować regułę Impact_update_events do obsługi nowych szczelin. Aktualizowanie klasy IMPACT Nowe zdarzenia przesyłane do TEC przez funkcję insertTECEvent() będą klasy IMPACT. Funkcja integracji udostępnia trzy przykładowe szczeliny: v impact_MRO_Service_Desk_Ticket v mpact_instance v identifier Jeśli do klasy IMPACT zostały dodane nowe szczeliny, należy pamiętać o zaktualizowaniu zmiennej TEC_Insert_ValidSlots na początku strategii TEC, w przeciwnym przypadku nowe szczeliny nie będą przesyłane do konsoli TEC. Domyślną wartością zmiennej TEC_Insert_ValidSlots jest: TEC_Insert_ValidSlots = "severity, msg, hostname, impact_MRO_Service_Desk_Ticket, impact_instance, identifier"; Lista kontrolna nowej szczeliny 1. Zaktualizuj klasę lub klasy TEC, które mają obsługiwać nową szczelinę, następnie się upewnij, że klasa IMPACT_Update również ma tę szczelinę (użycie IMPACT_Data i dziedziczenia wielobazowego ułatwia to zadanie). 2. Zaktualizuj regułę impact_update_event, aby nowa szczelina była przez nią modyfikowana. 3. Uruchom wszystkie niezbędne komendy TEC i zrestartuj produkt Tivoli Enterprise Console. 4. Zaktualizuj wartości w zmiennej TEC_Update_ValidSlots w strategii TEC. Przykłady architektur integrowania Serwer Impact i produkt Tivoli Enterprise Console Produkt Impact jest używany do korelowania i wzbogacania zdarzeń Tivoli Enterprise Console z wykorzystaniem danych zewnętrznych. Strategie Impact pobierają dane w czasie rzeczywistym z zaufanego źródła. Nie istnieją pliki faktów do konserwowania. 26 Netcool/Impact: Podręcznik integrowania Produkt Tivoli Enterprise Console i OMNIbus współużytkujące serwer Impact Produkt Tivoli Enterprise Console i OMNIbus współużytkujące serwer Impact Konsola Tivoli Enterprise Console i OMNIbus z dedykowanymi serwerami Impact Konsola Tivoli Enterprise Console i OMNIbus z dedykowanymi serwerami Impact Rozdział 4. Integrowanie produktu Netcool/Impact z produktem Tivoli Enterprise Console 27 28 Netcool/Impact: Podręcznik integrowania Rozdział 5. Integrowanie produktu Netcool/Impact z Webtop Używając funkcji produktu Netcool/Impact w tej integracji w celu użycia serwera Netcool/Impact do: v udostępniania treści Webtop, takich jak mapy, jednostki i narzędzia; v zarządzania listą kontroli dostępu w Webtop 1.3 lub Webtop 2.0/2.1/NGF; v tworzenia stron NGF zawierających treść containWebtop. Funkcje serwera Netcool/Impact To rozwiązanie udostępnia funkcje, które mogą być wykorzystane do wykonywania następujących czynności: v Tworzenie złożonych struktur XML jak obiekty IPL i przekształcanie tych obiektów w łańcuchy tekstu XML v Zapisywanie łańcuchów XML w plikach lokalnych z pomocą funkcji JRExec lub zdalnie z użyciem SSH v Przesyłanie plików do run waapi lub ngf_api lokalnie z pomocą JRExec lub zdalnie z użyciem SSH v Opcjonalne usuwanie plików po wykonaniu operacji Te funkcje są przechowywane w kilku przykładowych strategiach, które można odnaleźć w projekcie WebTop. Dostępny jest kod przykładowy, obrazujący sposób tworzenia treści Webtop, administrowania Webtop, konfigurowania NGF i tworzenia stron NGF (pliki psml). Obsługiwane systemy operacyjne Funkcja integracji produktu Webtop jest obsługiwana przez produkt Tivoli Netcool/Impact 6.1.1. Najbardziej aktualne informacje na temat obsługiwanego sprzętu, oprogramowania, przeglądarek i systemów operacyjnych są udostępniane przez raporty zgodności oprogramowania IBM® pod adresem: http://pic.dhe.ibm.com/infocenter/prodguid/v1r0/clarity/ index.html Więcej informacji na temat uruchamiania raportów zgodności oprogramowania zawiera sekcja Overview and Planning (Planowanie i przegląd) w obszarze wiki produktu Tivoli Netcool/Impact pod adresem: https://www.ibm.com/developerworks/mydeveloperworks/ wikis/home/wiki/Tivoli%20Netcool%20Impact/page/Overview%20and %20Planning?lang=en. Uwaga: Informacja dla użytkowników systemów operacyjnych *nix: funkcja integracji była testowana tylko w systemie CentOS 4.5. Jedyną komplikacją może być różne zachowanie komendy echo w różnych systemach operacyjnych UNIX. Dostosuj funkcję cleanTextForEcho(text) w strategii UTIL, jeśli zachodzi taka konieczność. WAAPI wymaga ustawienia zmiennej $WAAPI_HOME, a komenda ngf_api wymaga ustawienia zmiennej $NCHOME dla użytkownika, który wydaje komendy produktu Netcool/Impact. Uwaga: W systemach operacyjnych Windows interakcja z WAAPI lub NGF_API wykonywana jest z użyciem SSH. Kod strategii Windows został opracowany w systemie © Copyright IBM Corp. 2006, 2014 29 operacyjnym Windows 2003 Server z działającym programem openSSH, który obsługuje ścieżki zgodne z formatem Windows (C:\katalog). Program openSSH można pobrać z serwisu http://sshwindows.sourceforge.net/. Zmienne $NCHOME i $WAAPI_HOME muszą być ustawione w systemie operacyjnym Windows przed uruchomieniem usługi openSSH. W ścieżkach w systemie operacyjnym Windows należy zawsze używać krótkich ścieżek (C:\progra~1\ibm\netcool). Uwaga: Ta funkcja integracji nie została przetestowana z programem Webtop 2.2 działającym w Tivoli Integrated Portal. Konfigurowanie integrowania Podana w tej sekcji procedura pozwala na skonfigurowanie funkcji integrowania z Webtop. Procedura 1. Zaimportuj strategie do klastra Netcool/Impact. 2. Skonfiguruj strategie dla danego środowiska, edytując funkcję getENV w strategiach WEBTOP, NGF i PSML. Jeśli program Webtop lub NGF jest używany w systemie operacyjnym Windows, na hoście tym musi być zainstalowany klient openSSH. Patrz http:// sshwindows.sourceforge.net/. 30 Netcool/Impact: Podręcznik integrowania Rozdział 6. Integrowanie produktu Netcool/Impact z produktem WebSphere Business Events Instalując produkty Netcool/Impact i WebSphere Business Events na tym samym komputerze, należy w pierwszej kolejności zainstalować produkt WebSphere Business Events i go uruchomić, a potem zainstalować produkt Netcool/Impact. Konfigurowanie produktu WebSphere Business Events Procedura 1. Załaduj konsolę administracyjną WebSphere. 2. Utwórz nową fabrykę jms Topic Connection o nazwie ImpactTopicConnectionFactory z nazwą jndi jms/ImpactTopicConnectionFactory powiązaną z WbeBus. 3. Utwórz nowy temat jms w celu odbierania komunikatów z serwera Netcool/Impact o nazwie impactTopic z nazwą jndi jms/impactTopic. Powiąż ten temat z fabryką ImpactTopicConnectionFactory. 4. Utwórz nowy temat jms w celu wysyłania komunikatów do Netcool/Impact o nazwie wbeTopic z nazwą jndi jms/wbeTopic. Powiąż ten temat z fabryką ImpactTopicConnectionFactory. 5. Załaduj narzędzie WBE Design Data. 6. Załaduj plik Netcool/Impact Integration.xml. 7. Dodaj wszystkie obiekty do repozytorium produktu WebSphere Business Events. Integrowanie produktu Netcool/Impact z zewnętrzną kolejką JMS Należy zainstalować adapter zasobu w serwerze eWAS, w którym działa Netcool/Impact, zanim będzie można zintegrować produkt Netcool/Impact z zewnętrzną kolejką JMS. O tym zadaniu Użyj pliku sibc.jmsra.rar z serwera eWAS 7.0.0.17 lub nowszego. Procedura 1. Pobierz plik sibc.jmsra.rar z następującego adresu URL: ftp://l3.hursley.ibm.com/PMC/ fixes/eWAS-SIBRA/sibc.jmsra-7.0.0.15+PM32130.rar. 2. Można również użyć pliku sibc.jmsra.rar z instalacji WebSphere Application Server 7.5 z katalogu <WAS_INSTALL>/runtimes. 3. Skopiuj plik sibc.jmsra.rar do folderu <TEMP>/scripts. 4. Utwórz plik updateRA_patch_On_Impact_eWASServer.jacl. a. Otwórz edytor tekstu. b. Skopiuj następujący tekst do pliku tekstowego. ########## # # Ten skrypt musi być uruchamiany w serwerze Netcool Impact eWAS. ########## # Wskazanie do pliku rar SIB JMS. Podaj pełną ścieżkę # i się upewnij, że jest ona poprawna. set rarFile "C:/temp/sibc.jmsra.rar" © Copyright IBM Corp. 2006, 2014 31 ########## # Wskazanie serwera, komórki i węzła serwera Impact eWAS. # Nie trzeba zmieniać tych danych, chyba że zainstalowano inną wersję # serwera Impact. Sprawdź te dane przed uruchomieniem skryptu. set serverName "server1" set theCell "ImpactCell" set theNode "ImpactNode" ########## puts "Deinstalowanie istniejącego RA" set ra [$AdminConfig getid "/Cell:$theCell/Node:$theNode/J2CResourceAdapter: Default messaging provider/"] if { $ra != "" } { $AdminConfig uninstallResourceAdapter $ra } ########## puts "Zapisywanie konfiguracji" $AdminConfig save ########## puts "Deinstalowanie istniejącego RA" set ra [$AdminConfig getid "/Cell:$theCell/Node:$theNode/J2CResourceAdapter: WebSphere Application Server JMS Resource Adapter/"] if { $ra != "" } { $AdminConfig uninstallResourceAdapter $ra } ########## puts "Zapisywanie konfiguracji" $AdminConfig save ########## puts "Instalowanie RA" set option { -rar.name "WebSphere Application Server JMS Resource Adapter" -rar.desc "WebSphere Application Server service integration bus JMS resource adapter" } $AdminConfig installResourceAdapter $rarFile $theNode $option ########## puts "Pobieranie wskazania do nowo utworzonego RA" set ra [$AdminConfig getid "/Cell:$theCell/Node:$theNode/J2CResourceAdapter: Default messaging provider/"] ########## puts "Zapisywanie konfiguracji" $AdminConfig save puts "Gotowe." c. Zapisz plik pod nazwą updateRA_patch_On_Impact_eWASServer.jacl. 5. W folderze <TEMP>/scripts otwórz plik updateRA_patch_On_Impact_eWASServer.jacl. 6. Zaktualizuj właściwość rarFile, podając pełną ścieżkę folderu scripts i używając następującej deklaracji: set rarFile "<TEMP>/scripts/sibc.jmsra.rar" Ścieżka podana w cudzysłowie musi być pełną ścieżką pliku sibc.jmsra.rar. Uwaga: W ścieżce należy używać zwykłego ukośnika (/). 7. Przejdź do folderu <TEMP>/scripts/sibc.jmsra.rar i uruchom następującą komendę w wierszu komend: <PROFIL_IMPACT>/bin/wsadmin -f updateRA_patch_On_Impact_eWASServer.jacl -username wasadmin -password netcool 8. Zrestartuj serwer Impact po uruchomieniu skryptu. 32 Netcool/Impact: Podręcznik integrowania Używanie funkcji integrowania W funkcji integrowania po stronie serwera Netcool/Impact istnieje biblioteka strategii o nazwie WBE. Ta strategia zawiera dwie funkcje. Pierwszą jest SendEventToWBE, a drugą ParseWBEMessage. Funkcja SendEventToWBE wymaga podania obiektu Netcool/Impact i tworzy komunikat JMS produktu WebSphere Business Events oraz wysyła go do produktu WebSphere Business Events, używając skonfigurowanego typu danych SendToWBE. Funkcja ParseWBEMessage przetwarza komunikat JMS odebrany z produktu WebSphere Business Events w obiekt Netcool/Impact. Po stronie produktu WebSphere Business Events istnieją dwa punkty styku. Pierwszym jest Netcool/Impact Event, a drugim Netcool/Impact Action. Netcool/Impact Event nasłuchuje na zdarzenie Netcool/Impact na magistrali JMS i tworzy obiekt pośredni o nazwie Netcool Omnibus Event. Netcool/Impact Action wysyła dane do serwera Netcool/Impact, używając magistrali JMS. Rozdział 6. Integrowanie produktu Netcool/Impact z produktem WebSphere Business Events 33 34 Netcool/Impact: Podręcznik integrowania Rozdział 7. Korzystanie z funkcji IPLtoXML Adaptery źródeł danych pozwalają na dostęp do danych pochodzących z wielu różnych źródeł. W wielu przypadkach dane pobierane ze źródeł SQL i dostarczane jak obiekty (konteksty) języka IPL (Impact Policy Language). Jedną z trudności, z którą borykali się twórcy strategii, było przekształcanie obiektów IPL w łańcuchy XML zgodne z formatem oczekiwanym przez aplikacje. Aby ułatwić to zadanie, opracowano zestaw funkcji IPLtoXML służących do generowania łańcuchów XML na podstawie obiektu IPL. Funkcje z rodziny IPLtoXML - przegląd Funkcje IPLtoXML służą do generowania łańcucha XML z obiektu IPL. Polega to na tym, że obiekt IPL wysokiego poziomu, będący obiektem dokumentu XML, jest przekształcany w dane XML. Obiekty IPL zagnieżdżone w obiekcie dokumentu, będące obiektami elementów, stają się elementami XML. Funkcje te są używane do tworzenia dokumentu XML i obiektów elementów i do ustawiania atrybutów, zawartości i komentarzy XML. Obiekt dokumentu XML Obiekt dokumentu XML jest dokumentem podstawowym. Do obiektu dokumentu XML mogą być dodawane obiekty elementów, atrybutów, zawartości i komentarzy XML. Jest to obiekt dokumentu XML, który jest przekształcany w łańcuch XML. Więcej informacji na temat tworzenia obiektu dokumentu XML zawiera sekcja “Tworzenie obiektu dokumentu XML” na stronie 36. Obiekty elementów XML Obiekty elementów XML mogą być dodawane do obiektu dokumentu XML lub zagnieżdżane w innych obiektach elementów XML. Po utworzeniu i dodaniu obiektu elementu XML można użyć innych funkcji w celu dodania do niego atrybutów, zawartości i komentarzy XML. Więcej informacji na temat funkcji z rodziny IPLtoXML służących do tworzenia i dodawania obiektów elementów XML zawierają sekcje “Dodawanie podelementu” na stronie 36 i “Tworzenie nieprzypisanego elementu” na stronie 37. Dodawanie atrybutów XML do obiektów elementu Istnieje możliwość użycia jednej z trzech metod w celu dodania atrybutu do obiektu elementu XML. Najprostszą metodą jest przekazanie obiektu elementu, nazwy atrybutu i wartości atrybutu do funkcji IPLtoXML.addAttribute(). Więcej informacji na temat tej metody zawiera sekcja “Prosta metoda dodawania atrybutów XML do obiektów elementów” na stronie 37. Druga metoda wymaga utworzenia oddzielnego obiektu atrybutu XML i dodania go do obiektu elementu XML za pomocą funkcji IPLtoXML.addAttributeObject(). Więcej informacji na temat sposobu używania tej funkcji zawiera sekcja “Dodawanie atrybutów XML do obiektów, używając obiektów atrybutów” na stronie 38. Ta metoda jest przydatna w przypadku, gdy ten sam atrybut i wartość są używane w wielu miejscach w dokumencie XML. Trzecia metoda polega na jednoczesnym dodaniu kilku atrybutów z pomocą funkcji IPLtoXML.addOrgNodeAttributes(). Funkcja ta służy do szybkiego pobrania danych z © Copyright IBM Corp. 2006, 2014 35 wyników wyszukiwania i dodania wszystkich pól do obiektu elementu XML w postaci atrybutów. Więcej informacji na temat tej metody zawiera sekcja “Dodawanie atrybutów XML do obiektów elementów przez dodawanie atrybutów węzła” na stronie 39. Dodawanie treści XML do obiektów elementów Istnieje możliwość dodania treści do dowolnego elementu oraz dołączenia dodatkowe treści w późniejszym terminie. Więcej informacji na ten temat zawierają sekcje “Dodawanie zawartości do obiektu elementu XML” na stronie 39 i “Dołączanie zawartości do obiektów elementów XML” na stronie 40. Komentarze XML Istnieje możliwość dodania komentarza do dowolnego elementu XML, używając funkcji addCommentToElement. Funkcja ta dodaje znaczniki komentarza XML (<!-- -->), dzięki czemu nie trzeba tego robić ręcznie. Więcej informacji na temat tej funkcji zawiera sekcja “Dodawanie komentarzy XML do obiektów elementów” na stronie 40. Zagnieżdżanie elementów XML W przypadku utworzenia autonomicznego obiektu elementu XML z pomocą funkcji newElement nadal istnieje możliwość zagnieżdżenia tego obiektu, używając funkcji addElement. W większości przypadków nie tworzy się autonomicznych obiektów z pomocą funkcji newElement, zamiast tego tworzy się zagnieżdżone obiekty elementów XML, używając funkcji newSubElement. Więcej informacji na temat dodawania obiektów elementów XML zawiera sekcja “Zagnieżdżanie obiektów elementów XML w innych obiektach” na stronie 41. Tworzenie obiektu dokumentu XML Procedura Aby utworzyć obiekt dokumentu XML, należy użyć następującej funkcji: IPLtoXML.newDocument(obiektDokumentuXML) Zmienna obiektDokumentuXML staje się nowym obiektem dokumentu XML. Przykład newDocument(REM_Album); Dodawanie podelementu Ta funkcja tworzy obiekt elementu XML i zagnieżdża go w obiekcie nadrzędnym (jeden poziom niżej). Procedura Aby dodać podelement, należy użyć następującej funkcji: IPLtoXML.newSubElement(elementNadrzędny, mójElement, typElementu) gdzie 36 Netcool/Impact: Podręcznik integrowania elementNadrzędny Ten obiekt dokumentu lub elementu musi istnieć. mójElement Ta zmienna staje się nowym elementem XML typu typElementu zagnieżdżonym w elemencieNadrzędnym. typElementu Typ tworzonego elementu XML. Przykład IPL: newDocument(Samochody); newSubElement(Samochody, Pojazd, “Honda”); newSubElement(Pojazd, kierowca1, “Jan”); Wygenerowany kod XML: <Honda><Jan/></Honda> Tworzenie nieprzypisanego elementu Zamiast używać tej funkcji to tworzenia nieprzypisanego elementu, można użyć funkcji newSubElement, aby utworzyć zagnieżdżony obiekt elementu XML. Procedura Aby utworzyć nieprzypisany element, należy użyć następującej funkcji: IPLtoXML.newElement(mójElement, typElementu) gdzie mójElement Ta zmienna staje się nowym elementem XML typu typElementu. typElementu Typ tworzonego elementu XML. Przykład IPL: newElement(mójElement, “Honda”); Wygenerowany kod XML: <Honda/> Prosta metoda dodawania atrybutów XML do obiektów elementów Procedura Aby dodać atrybuty XML do obiektu elementu, należy użyć następującej funkcji: IPLtoXML.addAttribute(obiektElementu, nazwaAtrybutu, wartośćAtrybutu) gdzie obiektElementu Element, do którego dodawane są atrybuty. Rozdział 7. Korzystanie z funkcji IPLtoXML 37 nazwaAtrybutu Łańcuch tekstowy nazwy dodawanego atrybutu. wartośćAtrybutu Wartość atrybutu. Przykład IPL: newElement(Pojazd, “Subaru”); addAttribute(Pojazd, “rok”, 2003); Wygenerowany kod XML: <Subaru rok=”2003”/> Uwaga: Funkcja addAttribute jest przydatna, gdy tworzenie obiektu atrybutu nie jest pożądane. Dodawanie atrybutów XML do obiektów, używając obiektów atrybutów Aby dodać atrybuty XML do obiektu elementu, używając obiektów atrybutów, należy wykonać poniższą procedurę. Procedura 1. Utwórz nowy atrybut obiektu. Użyj następującej funkcji: IPLtoXML.newAttributeObject(obiektAtrybutu, nazwaAtrybutu, wartośćAtrybutu) gdzie obiektAtrybutu Ta zmienna staje się nowym obiektem atrybutu XML. nazwaAtrybutu Nazwa atrybutu. wartośćAtrybutu Wartość atrybutu. IPL: newAttributeObject(rokSamochodu, “rok”, 2003); Wygenerowany kod XML: rok=”2003” Uwaga: Obiekty atrybutów są użyteczne, ponieważ mogą być ponownie wykorzystane i dodawane do wielu elementów w kodzie. 2. Dodaj obiekt atrybutu do obiektu elementu. Użyj następującej funkcji: IPLtoXML.addAttributeObject(obiektElementu, obiektAtrybutu) gdzie obiektElementu Obiekt elementu XML, do którego dodawany jest atrybut obiektAtrybutu Obiekt atrybutu XML dodawany do obiektuElementu. IPL: 38 Netcool/Impact: Podręcznik integrowania newElement(Pojazd, “Subaru”); newAttribute(rokSamochodu, “rok”, 2003); addAttributeObject(Pojazd, rokSamochodu); Wygenerowany kod XML: <Subaru rok=”2003”/> Dodawanie atrybutów XML do obiektów elementów przez dodawanie atrybutów węzła Procedura Aby dodać atrybuty z węzła, należy użyć następującej funkcji: IPLtoXML.addOrgNodeAttributes(obiektElementu, węzeł) gdzie obiektElementu Obiekt elementu, do którego dodawane są atrybuty. węzeł Obiekt IPL, którego pola mają być dodane do elementu jako atrybuty. Obiekt może pochodzić z operacji wyszukiwania lub może być zbudowany z pomocą funkcji newobject();. Przykład IPL: newElement(Pojazd, “Subaru”); og=newobject(); og.kolor=”niebieski”; og.drzwi=4; og.turbo=”nie”; addOrgNodeAttributes(Pojazd, og); Wygenerowany kod XML: <Subaru kolor=”niebieski” drzwi=”4” turbo=”nie”/> Dodawanie zawartości do obiektu elementu XML Zawartość może być dodawana do każdego elementu. Procedura Aby dodać zawartość do obiektu elementu XML, należy użyć następującej funkcji: IPLtoXML.setContent(obiektElementu, zawartość) gdzie obiektElementu Obiekt elementu, do którego dodawana jest zawartość. zawartość Łańcuch tekstowy dodawany do obiektuElementu jako zawartość. Przykład IPL: Rozdział 7. Korzystanie z funkcji IPLtoXML 39 newElement(Pojazd, “Subaru”); setContent(Pojazd, “Super wózek”); Wygenerowany kod XML: <Subaru>Super wózek</Subaru> Dołączanie zawartości do obiektów elementów XML Do każdego elementu można dołączyć dodatkową zawartość. Procedura Aby dołączyć zawartość do obiektu elementu XML, należy użyć następującej funkcji: IPLtoXML.appendContent(obiektElementu, zawartość) gdzie obiektElementu Obiekt elementu, do którego dołączana jest zawartość. zawartość Łańcuch tekstowy dołączany do istniejącej zawartości. Przykład IPL: newElement(Pojazd, “Subaru”); setContent(Pojazd, “Super wózek”); appendContent(Pojazd, “ mojego ojca”); Wygenerowany kod XML: <Subaru>Super wózek mojego ojca</Subaru> Dodawanie komentarzy XML do obiektów elementów Procedura Aby dodać komentarze XML do obiektów elementu, należy użyć następującej funkcji: IPLtoXML.addCommentToElement(obiektElementu, komentarz) gdzie obiektElementu Obiekt elementu, do którego dodawany jest komentarz. komentarz Łańcuch tekstowy komentarza XML. Funkcja dodaje znaczniki komentarza XML <!-- -->. Nie należy ich dodawać samodzielnie. Przykład IPL: newElement(Pojazd, “Subaru”); addCommentToElement(Pojazd, “To jest mój ulubiony samochód”); Wygenerowany kod XML: <Subaru><!-- To jest mój ulubiony samochód --></Subaru> 40 Netcool/Impact: Podręcznik integrowania Zagnieżdżanie obiektów elementów XML w innych obiektach Procedura Aby umieścić obiekt elementu XML w innym obiekcie elementu XML, należy użyć następującej funkcji: IPLtoXML.addElement(nadrzędny, obiektElementu) gdzie nadrzędny Dokument XML lub obiekt elementu, do którego dodawany jest istniejący obiektElementu. obiektElementu Obiekt elementu XML dodawany do obiektu nadrzędnego. Przykład IPL: newElement(Samochody, “Samochody”); newElement(Pojazd, “Subaru”); addElement(Samochody, Pojazd); Wygenerowany kod XML: <Samochody><Subaru/></Samochody> Generowanie łańcuchów XML z obiektów dokumentu Procedura Aby wygenerować łańcuch XML z obiektu dokumentu, należy użyć następującej funkcji: IPLtoXML.generateXML(obiektXML, XML) gdzie obiektXML Albo obiekt całego dokumentu XML, albo tylko obiekt pojedynczego elementu XML. XML Zmienna, w której zostanie zapisany łańcuch XML wygenerowany na podstawie obiektuXML. Przykład IPL: STACK=NewJavaObject("java.util.Stack", {}); // to jest zmienna globalna wymagana w konwersji IPLtoXML newDocument(samochodyXML); newElement(Pojazd, “Subaru”); addElement(samochodyXML, Pojazd); addCommentToElement(Pojazd, “To jest mój ulubiony samochód”); generateXML(samochodyXML, dane_wy); Zmienna dane_wy będzie zawierać następujące dane XML: <?xml version="1.0" encoding="UTF- 8"?><Subaru><!-- To jest mój ulubiony samochód--></Subaru> Rozdział 7. Korzystanie z funkcji IPLtoXML 41 Zastępowanie domyślnych jednostek XML Funkcja replaceEntities() pozwala na zastępowanie następujących domyślnych jednostek XML w treści i atrybutach XML: v znak ampersand & jest zastępowany przez & v znak mniejszości < jest zastępowany przez < v znak większości > jest zastępowany przez > v apostrof ’ jest zastępowany przez ' v cudzysłów " jest zastępowany przez " Jeśli oprócz wymienionych jednostek mają być zastępowane inne, należy zmodyfikować funkcję replaceEntities(x) w języku IPL dla strategii XML. Kolejność elementów w XML Kolejność, w której elementy na danym poziomie zagnieżdżania są dodawane do generowanych danych XML, zależy od nazwy zmiennej obiektu elementu. Jako przykład niech posłuży nam następująca strategia: IPLtoXML.newDocument(theWeather); IPLtoXML.newSubElement(theWeather, system, “weatherSystem”); IPLtoXML.newSubElement(system, sub01, “tornado”); IPLtoXML.newSubElement(system, sub05, “thunderstorm”); IPLtoXML.newSubElement(system, SUB, “hail”); IPLtoXML.addComment(sub05, “silne burze i tornado w bieżącym miejscu mojego pobytu”); Wygenerowane XML będą następujące: <weatherSystem><hail/><tornado/><thunderstorm><!-- silne burze i tornado w bieżącym miejscu mojego pobytu --></thunderstorm></weatherSystem> Elementy hail, tornado i thunderstorm są na tym samym poziomie zagnieżdżania w dokumencie XML. Element hail został dodany do danych wynikowych jako pierwszy, nazwa obiektu elementu to SUB. Element tornado został dodany jako drugi, nazwa obiektu elementu to sub01. Element thunderstorm został dodany jako ostatni, nazwa: sub05. Jeśli kolejność elementów w dokumencie XML ma znaczenie, należy uważnie nadawać nazwy obiektom elementów. Przykład użycia funkcji IPLtoXML W tej sekcji zamieszczono trzy przykłady wykorzystania funkcji IPLtoXML. Prosty przykład W tym przykładzie przedstawiono, jak różne funkcje IPLtoXML mogą być wykorzystane do wygenerowania prostej struktury XML. STACK=NewJavaObject("java.util.Stack", {}); // wymagane // w celu umożliwienia użycia rekurencji w funkcji generateXML IPLtoXML.newDocument(obiektDokumentu); IPLtoXML.newElement(samochody, "samochody"); IPLtoXML.addElement(obiektDokumentu, samochody); IPLtoXML.addAttribute(samochody, "nazwisko", "Nowak"); IPLtoXML.setContent(samochody, "Samochody będące własnością rodziny"); IPLtoXML.newElement(subaru, "pojazd"); 42 Netcool/Impact: Podręcznik integrowania IPLtoXML.newElement(honda, "pojazd"); IPLtoXML.addElement(samochody, subaru); IPLtoXML.addElement(samochody, honda); IPLtoXML.newAttributeObject(lokalizacjaSamochodu, "lokalizacja", "w garażu"); IPLtoXML.addAttributeObject(subaru, lokalizacjaSamochodu); IPLtoXML.addAttributeObject(honda, lokalizacjaSamochodu); IPLtoXML.addAttribute(honda, "kolor", "czarny"); IPLtoXML.addAttribute(honda, "drzwi", 4); IPLtoXML.addAttribute(honda, "kierowca", "Jan"); IPLtoXML.addAttribute(honda, "model", "element hondy"); foresterInfo=newobject(); foresterInfo.kolor="niebieski"; foresterInfo.drzwi="4"; foresterInfo.kierowca="tomek"; foresterInfo.model="subaru forester"; IPLtoXML.addOrgNodeAttributes(subaru, foresterInfo); IPLtoXML.newElement(kierowcaHondy, "Kierowca"); IPLtoXML.addAttribute(kierowcaHondy, "Nazwisko", "Jan Nowak"); IPLtoXML.addAttribute(kierowcaHondy, "Wiek", 33); IPLtoXML.addCommentToElement(kierowcaHondy, "ojciec bliźniąt"); IPLtoXML.addElement(honda, kierowcaHondy); IPLtoXML.generateXML(obiektDokumentu, xml); log(xml); Zarejestrowana zostanie następująca wartość zmiennej XML: 07 Oct 2007 17:11:06,888: SynchronousMessageProcessor: Parser log: <?xml version="1.0" encoding="UTF-8"?><samochody nazwisko="Nowak">Samochody będące własnością rodziny<pojazd kolor="niebieski" drzwi="4" kierowca="tomek" lokalizacja="w garażu" model="subaru forester"/><pojazd kolor="czarny" drzwi="4" kierowca="Jan" lokalizacja="w garażu" model="element hondy"><Kierowca Wiek="33" Nazwisko="Jan Nowak"/><!-- ojciec bliźniąt --></pojazd></samochody> Przykład wykorzystania zdarzenia serwera obiektów W tym przykładzie przedstawiono sposób uruchamiania funkcji IPLtoXML dla zdarzenia pochodzącego z serwera obiektów produktu Netcool/OMNIbus. Załóżmy, że przetwarzanie zaczyna się od zdarzenia Netcool/OMNIbus wygenerowanego przez sondę Simnet Netcool/OMNIbus. 1. Tworzenie obiektu dokumentu XML: IPLtoXML.newDocument(eventXML); 2. Tworzenie obiektu elementu XML i dodanie go do obiektu dokumentu XML: IPLtoXML.newSubElement(eventXML, theEvent, “omniEvent”); 3. Dodanie pól kontenera zdarzenia do obiektu elementu theEvent w postaci atrybutów: IPLtoXML.addOrgNodeAttributes(theEvent, EventContainer); 4. Użycie Java™ DSA do utworzenia stosu pamięci Java w zmiennej globalnej o nazwie STACK: STACK=NewJavaObject("java.util.Stack", {}); Uwaga: Zmienna STACK jest wymagana za każdym razem, gdy funkcja generateXML() jest wywoływana i musi to być zmienna globalna (zdefiniowana na zewnątrz wszystkich funkcji). IPLtoXML używa rekurencji i (w wersji 4.x analizatora Impact) nie można rekurencyjnie wywoływać funkcji bez oddzielnego stosu pamięci. 5. Wywołanie funkcji GenerateXML(). Należy przekazać do funkcji obiekt dokumentu XML (eventXML) oraz zmienną, w której zostaną zapisane dane wyjściowe: IPLtoXML.GenerateXML(eventXML, results); Rozdział 7. Korzystanie z funkcji IPLtoXML 43 Wygenerowane dane XML są podobne do następującego przykładu: <?xml version="1.0" encoding="UTF-8"?><omniEvent Acknowledged="0" Agent="LinkMon" AlertGroup="Link" AlertKey="" Class="3300" Customer="" EventId="" EventReaderName="OMNIbusEventReader" ExpireTime="0" FirstOccurrence="1188488450" Flash="0" Grade="0" Identifier="link6LinkMon1Link" InternalLast="1188488841" KeyField="8689" LastOccurrence="1188488841" LocalNodeAlias="" LocalPriObj="" LocalRootObj="" LocalSecObj="" Location="" Manager="Simnet Probe" NmosCauseType="0" NmosObjInst="0" NmosSerial="" Node="link6" NodeAlias="" OwnerGID="0" OwnerUID="65534" PhysicalCard="" PhysicalPort="0" PhysicalSlot="0" Poll="0" ProcessReq="0" ReceivedWhileImpactDown="1" RemoteNodeAlias="" RemotePriObj="" RemoteRootObj="" RemoteSecObj="" Serial="8689" ServerName="NCOMS" ServerSerial="8689" Service="" Severity="0" StateChange="1188488841" Summary="Link Up on port" SuppressEscl="0" Tally="8" TaskList="0" Type="2" URL="" X733CorrNotif="" X733EventType="0" X733ProbableCause="0" X733SpecificProb=""/ > Istnieje jeden element XML o nazwie omniEvent. Każde z pól oryginalnego kontenera zdarzeń jest atrybutem elementu omniEvent. Przykład wygenerowania WAAPI XML z użyciem IPL W tym przykładzie przedstawiono sposób użycia funkcji IPLtoXML do utworzenia łańcucha XML, który może być przekazywany do API Netcool/Webtop (WAAPI). // tworzenie obiektu dokumentu XML IPLtoXML.newDocument(waapiXML); // pierwszy element: methodCall IPLtoXML.newSubElement(waapiXML, myMethodCall, "methodCall"); // element metody zagnieżdżony w elemencie methodCall IPLtoXML.newSubElement(meMethodCall, method1, “method”); // atrybuty method1 IPLtoXML.addAttribute(method1, “methodName”, “entity.createOrReplaceEntity”); // element entitygroup zagnieżdżony w elemencie metody IPLtoXML.newSubElement(method1, entityGroup01, “entitygroup”); // atrybuty entitygroup IPLtoXML.addAttribute(entityGroup01, “name”, “support”); // ta grupa została dodana do elementu jednostki // NGF zagnieżdżonego w entitygroup IPLtoXML.newSubElement(entityGroup01, entity01, “entity”); // atrybuty jednostki IPLtoXML.addAttribute(entity01, “name”, “ncientity01”); IPLtoXML.addAttribute(entity01, “filter”, “Severity > 4”); IPLtoXML.addAttribute(entity01, “metriclabel”, “tom”); IPLtoXML.addAttribute(entity01, “metricshow”, “Average”); IPLtoXML.addAttribute(entity01, “metricof”, “Severity”); // lista jednostek zagnieżdżona w grupie jednostek IPLtoXML.newSubElement(entityGroup01, entitylist01, “entitylist”); // atrybuty entitylist IPLtoXML.addAttribute(entitylist01, “name”, “ncientitylist01”); IPLtoXML.addAttribute(entitylist01, “list”, “AllEvents”); IPLtoXML.addAttribute(entitylist01, “view”, “basic”); IPLtoXML.addAttribute(entitylist01, “metriclabel”, “tom”); Wynikowy łańcuch XML: 44 Netcool/Impact: Podręcznik integrowania <?xml version=“1.0” encoding=“UTF-8”?><methodCall><method methodName=“entity.createOrReplaceEntity”><entitygroup name=“support “><entity filter=“Severity > 4” metriclabel=“tom” metricof=“Severity” metricshow=“Average” name=“ncientity01”/><entitylist list=“AllEvents” metriclabel=“tom” name=“ncientitylist01” view=“basic”/></entitygroup></method></methodCall> Ten łańcuch może być przekazany do WAAPI przez JRExec lub Command/Response w celu utworzenia jednostki Webtop. Rozdział 7. Korzystanie z funkcji IPLtoXML 45 46 Netcool/Impact: Podręcznik integrowania Rozdział 8. Łączenie z WebSphere MQ i DSA JMS Produkt Netcool/Impact 6.1.1 może się komunikować z serwerem WebSphere MQ 7, wykorzystując źródło danych JMS. Szczegółowe informacje na temat DSA JMS zawiera publikacja Netcool/Impact Skorowidz DSA. Dostępne są dwie opcje konfiguracyjne: v Opcja 1: klient i serwer WebSphere MQ oraz program Netcool/Impact działają na jednym komputerze. v Opcja 2: klient WebSphere MQ i serwer Netcool/Impact działają na jednym komputerze, a serwer WebSphere MQ na innym komputerze. Więcej informacji na temat produktu WebSphere MQ zawiera publikacja http://www-01.ibm.com/software/integration/wmq/#. Opcja konfiguracyjna 1 Jak można skonfigurować klienta i serwer WebSphere MQ oraz program Netcool/Impact na jednym komputerze. Procedura 1. Skonfiguruj serwer WebSphere MQ. Aby uzyskać więcej informacji, patrz: http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp. 2. Skopiuj następujące cztery pliki JAR z katalogu MQ_HOME/java/lib do katalogu IMPACT_HOME/dsalib. v com.ibm.mq.jmqi.jar v com.ibm.mqjms.jar v fscontext.jar v providerutil.jar 3. Zrestartuj profil Impact, aby zaczął on używać nowych plików JAR. 4. Moduł Netcool/Impact DSA JMS ma następujące parametry: Więcej informacji na temat konfigurowania DSA JMS zawiera sekcja Właściwości konfiguracyjne źródła danych JMS w publikacji Skorowidz DSA. v Początkowa fabryka JNDI: com.sun.jndi.fscontext.RefFSContextFactory v Adres URL dostawcy JNDI: file:/<PathToBindingDirOnMQClient>, na przykład file:/C:/MQClientBindings. v Nazwa fabryki połączeń JMS tak jak skonfigurowano na serwerze WebSphere MQ. v Nazwa celu JMS tak jak skonfigurowano na serwerze WebSphere MQ. Opcja konfiguracyjna 2 Jak można skonfigurować klienta WebSphere MQ i serwer Netcool/Impact na jednym komputerze, a serwer WebSphere MQ na innym komputerze. Procedura 1. Skopiuj następujących pięć plików JAR z katalogu MQ_HOME/java/lib do katalogu IMPACT_HOME/dsalib. © Copyright IBM Corp. 2006, 2014 47 v v v v v com.ibm.mq.jmqi.jar com.ibm.mqjms.jar fscontext.jar providerutil.jar dhbcore.jar 2. Zrestartuj profil Impact, aby zaczął on używać nowych plików JAR. 3. Serwer MQSeries® należy skonfigurować w celu użycia dostawcy JNDI wykorzystującego system plików. Wtedy produkt WebSphere MQ będzie używać lokalnego systemu plików jako rejestru JNDI, gdy rejestruje zasoby JMS używane przez DSA. Więcej informacji na temat DSA JMS zawiera publikacja Skorowidz DSA. 4. W fabryce połączeń na serwerze WebSphere MQ należy użyć trybu „klienta”, aby klient WebSphere MQ komunikował się z serwerem WebSphere MQ za pomocą protokołu TCP. 5. Upewnij się, że program nasłuchujący został skonfigurowany na preferowanym porcie na serwerze WebSphere MQ. 6. Utwórz wymagane kolejki i cele zgodnie z opisem zamieszczonym w dokumentacji produktu WebSphere MQ. Aby uzyskać więcej informacji, patrz: http:// publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp. 7. Skopiuj katalog powiązań, skonfigurowany na serwerze WebSphere MQ, do lokalnego systemu plików klienta WebSphere MQ. 8. Moduł Netcool/Impact DSA JMS ma następujące parametry: Więcej informacji na temat konfigurowania DSA JMS zawiera sekcja Właściwości konfiguracyjne źródła danych JMS w publikacji Skorowidz DSA. v Początkowa fabryka JNDI: com.sun.jndi.fscontext.RefFSContextFactory v Adres URL dostawcy JNDI: file:/<PathToBindingDirOnMQClient>, na przykład file:/C:/MQClientBindings. v Nazwa fabryki połączeń JMS tak jak skonfigurowano na serwerze WebSphere MQ. v Nazwa celu JMS tak jak skonfigurowano na serwerze WebSphere MQ. 9. Jeśli konfiguracja serwera WebSphere MQ zostanie zmieniona, należy powtórzyć czynności z punktu 7, aby się upewnić, że klient WebSphere MQ użyje zmienionej konfiguracji. 48 Netcool/Impact: Podręcznik integrowania Dodatek A. Ułatwienia dostępu Ułatwienia dostępu pomagają użytkownikom niepełnosprawnym fizycznie,na przykład ograniczonym ruchowo lub niedowidzącym, w efektywnym korzystaniu z oprogramowania. Poniżej wymieniono główne funkcje ułatwień dostępu dostępne w produkcie Netcool/Impact, gdy dostęp do niego uzyskiwany jest z użyciem emulatora terminalu IBM Personal Communications: v Wszystkie funkcje dostępne są przy użyciu klawiatury, a nie tylko myszy. v Tekst może być odczytywany z wykorzystaniem technik wspomagających. v Można używać ustawień systemowych określających czcionkę, wielkość i kolor wszystkich elementów sterujących interfejsu użytkownika. v Zawartość ekranu może być powiększana. Więcej informacji na temat przeglądania plików PDF w produktach firmy Adobe dostępnych jest w serwisie http://www.adobe.com/enterprise/accessibility/main.html. © Copyright IBM Corp. 2006, 2014 49 50 Netcool/Impact: Podręcznik integrowania Dodatek B. Uwagi Niniejsza publikacja została przygotowana z myślą o produktach i usługach oferowanych w Stanach Zjednoczonych. IBM może nie oferować w innych krajach produktów, usług lub opcji omawianych w tej publikacji. Informacje o produktach i usługach dostępnych w danym kraju można uzyskać od lokalnego przedstawiciela IBM. Odwołanie do produktu, programu lub usługi IBM nie oznacza, że można użyć wyłącznie tego produktu, programu lub usługi. Zamiast nich można zastosować ich odpowiednik funkcjonalny pod warunkiem, że nie narusza to praw własności intelektualnej IBM. Jednakże cała odpowiedzialność za ocenę przydatności i sprawdzenie działania produktu, programu lub usługi, pochodzących od producenta innego niż IBM, spoczywa na użytkowniku. IBM może mieć patenty lub złożone wnioski patentowe na towary i usługi, o których mowa w niniejszym dokumencie. Przedstawienie tej publikacji nie daje żadnych uprawnień licencyjnych do tychże patentów. Pisemne zapytania w sprawie licencji można przesyłać na adres: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. Zapytania w sprawie licencji na informacje dotyczące zestawów znaków dwubajtowych (DBCS) należy kierować do lokalnych działów własności intelektualnej IBM (Intellectual Property Department) lub zgłaszać na piśmie pod adresem: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan Poniższy akapit nie obowiązuje w Wielkiej Brytanii, a także w innych krajach, w których jego treść pozostaje w sprzeczności z przepisami prawa miejscowego: INTERNATIONAL BUSINESS MACHINES CORPORATION DOSTARCZA TĘ PUBLIKACJĘ W STANIE, W JAKIM SIĘ ZNAJDUJE ("AS IS") BEZ UDZIELANIA JAKICHKOLWIEK GWARANCJI (W TYM TAKŻE RĘKOJMI), WYRAŹNYCH LUB DOMNIEMANYCH, A W SZCZEGÓLNOŚCI DOMNIEMANYCH GWARANCJI PRZYDATNOŚCI HANDLOWEJ, PRZYDATNOŚCI DO OKREŚLONEGO CELU ORAZ GWARANCJI, ŻE PUBLIKACJA NIE NARUSZA PRAW OSÓB TRZECICH. Ustawodawstwa niektórych krajów nie dopuszczają zastrzeżeń dotyczących gwarancji wyraźnych lub domniemanych w odniesieniu do pewnych transakcji; w takiej sytuacji powyższe zdanie nie ma zastosowania. Informacje zawarte w niniejszej publikacji mogą zawierać nieścisłości techniczne lub błędy drukarskie. Informacje te są okresowo aktualizowane, a zmiany te zostaną ujęte w kolejnych wydaniach tej publikacji. IBM zastrzega sobie prawo do wprowadzania ulepszeń i/lub zmian w produktach i/lub programach opisanych w tej publikacji w dowolnym czasie, bez wcześniejszego powiadomienia. © Copyright IBM Corp. 2006, 2014 51 Wszelkie wzmianki w tej publikacji na temat stron internetowych innych podmiotów zostały wprowadzone wyłącznie dla wygody użytkownika i w żadnym wypadku nie stanowią zachęty do ich odwiedzania. Materiały dostępne na tych stronach nie są częścią materiałów opracowanych dla tego produktu IBM, a użytkownik korzysta z nich na własną odpowiedzialność. IBM ma prawo do korzystania i rozpowszechniania informacji przysłanych przez użytkownika w dowolny sposób, jaki uzna za właściwy, bez żadnych zobowiązań wobec ich autora. Licencjobiorcy tego programu, którzy chcieliby uzyskać informacje na temat programu w celu: (i) wdrożenia wymiany informacji między niezależnie utworzonymi programami i innymi programami (łącznie z tym opisywanym) oraz (ii) wspólnego wykorzystywania wymienianych informacji, powinni skontaktować się z: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Informacje takie mogą być udostępnione, o ile spełnione zostaną odpowiednie warunki, w tym, w niektórych przypadkach, uiszczenie odpowiedniej opłaty. Licencjonowany program opisany w niniejszej publikacji oraz wszystkie inne licencjonowane materiały dostępne dla tego programu są dostarczane przez IBM na warunkach określonych w Umowie IBM z Klientem, Międzynarodowej Umowie Licencyjnej IBM na Program lub w innych podobnych umowach zawartych między IBM i użytkownikami. Wszelkie dane dotyczące wydajności zostały zebrane w kontrolowanym środowisku. W związku z tym rezultaty uzyskane w innych środowiskach operacyjnych mogą się znacząco różnić. Niektóre pomiary mogły być dokonywane na systemach będących w fazie rozwoju i nie ma gwarancji, że pomiary te wykonane na ogólnie dostępnych systemach dadzą takie same wyniki. Niektóre z pomiarów mogły być estymowane przez ekstrapolację. Rzeczywiste wyniki mogą być inne. Użytkownicy powinni we własnym zakresie sprawdzić odpowiednie dane dla ich środowiska. Informacje dotyczące produktów firm innych niż IBM pochodzą od dostawców tych produktów, z opublikowanych przez nich zapowiedzi lub innych powszechnie dostępnych źródeł. Firma IBM nie testowała tych produktów i nie może potwierdzić dokładności pomiarów wydajności, kompatybilności ani żadnych innych danych związanych z tymi produktami. Pytania dotyczące możliwości produktów innych podmiotów należy kierować do dostawców tych produktów. Wszelkie stwierdzenia dotyczące przyszłych kierunków rozwoju i zamierzeń IBM mogą zostać zmienione lub wycofane bez powiadomienia. Wszystkie przedstawione ceny IBM są sugerowanymi przez IBM bieżącymi cenami detalicznymi, które mogą zostać zmienione bez powiadomienia. Ceny oferowane przez dealerów mogą się różnić. Ta publikacja służy tylko do planowania. Informacja ta podlega zmianom do chwili, gdy produkty, których ona dotyczy, staną się dostępne. Publikacja ta zawiera przykładowe dane i raporty używane w codziennych operacjach działalności gospodarczej. W celu kompleksowego ich zilustrowania podane przykłady zawierają nazwiska osób prywatnych, nazwy przedsiębiorstw oraz nazwy produktów. 52 Netcool/Impact: Podręcznik integrowania Wszystkie te nazwy/nazwiska są fikcyjne i jakiekolwiek podobieństwo do istniejących nazw/nazwisk i adresów jest całkowicie przypadkowe. LICENCJA W ZAKRESIE PRAW AUTORSKICH: Niniejsza publikacja zawiera przykładowe aplikacje w kodzie źródłowym, ilustrujące techniki programowania w różnych systemach operacyjnych. Użytkownik może kopiować, modyfikować i dystrybuować te programy przykładowe w dowolnej formie bez uiszczania opłat na rzecz IBM, w celu projektowania, używania, sprzedaży lub dystrybucji aplikacji zgodnych z aplikacyjnym interfejsem programowym dla tego systemu operacyjnego, dla którego napisane zostały programy przykładowe. Kody te nie zostały kompleksowo przetestowane we wszelkich możliwych warunkach. IBM nie może zatem gwarantować ani sugerować niezawodności, użyteczności i funkcjonalności tych programów. Programy przykładowe są dostarczane w stanie, w jakim się znajdują ("AS IS"), bez jakichkolwiek gwarancji (rękojmię również wyłącza się). IBM nie ponosi odpowiedzialności za jakiekolwiek szkody wynikające z używania programów przykładowych. Każda kopia tych przykładowych programów lub jakiejkolwiek ich części, a także jakakolwiek praca pochodna, musi zawierać następującą klauzulę dotyczącą praw autorskich: © (nazwa przedsiębiorstwa użytkownika, rok). Fragmenty niniejszego kodu pochodzą z przykładowych programów IBM Corp. © Copyright IBM Corp. _wpisać rok lub lata_. Wszelkie prawa zastrzeżone. W przypadku przeglądania niniejszych informacji w formie elektronicznej, zdjęcia i kolorowe ilustracje mogą nie być wyświetlane. Znaki towarowe IBM, logo IBM i ibm.com są znakami towarowymi lub zastrzeżonymi znakami towarowymi International Business Machines Corp w wielu krajach na świecie. Inne nazwy produktów i usług mogą być znakami towarowymi IBM lub innych firm. Aktualna lista znaków towarowych IBM jest dostępna w sieci WWW na stronie Copyright and trademark information pod adresem www.ibm.com/legal/copytrade.shtml. Adobe, Acrobat, PostScript i wszystkie znaki towarowe dotyczące Adobe są znakami towarowymi lub zastrzeżonymi znakami towarowymi firmy Adobe Systems Incorporated w Stanach Zjednoczonych i w innych krajach. Java oraz wszystkie znaki towarowe i logo dotyczące Java są znakami towarowymi firmy i jej firm zależnych. Linux jest znakiem towarowym Linusa Torvaldsa w Stanach Zjednoczonych i w innych krajach. Microsoft, Windows, Windows NT oraz logo Windows są znakami towarowymi Microsoft Corporation w Stanach Zjednoczonych i w innych krajach. UNIX jest zastrzeżonym znakiem towarowym The Open Group w Stanach Zjednoczonych i w innych krajach. Dodatek B. Uwagi 53 Inne nazwy produktów i usług mogą być znakami towarowymi IBM lub innych firm. 54 Netcool/Impact: Podręcznik integrowania Glosariusz Niniejszy glosariusz zawiera terminy i definicje dotyczące systemu Netcool/Impact. W glosariuszu stosowane są następujące odnośniki: v Odnośnik Patrz kieruje czytelnika od danego terminu do jego preferowanego synonimu lub od akronimu bądź skrótu do zdefiniowanej pełnej formy. v Odnośnik Patrz także kieruje czytelnika do terminu pokrewnego lub przeciwstawnego. Glosariusze dotyczące innych produktów IBM są dostępne na stronie www.ibm.com/ software/globalization/terminology (jest wyświetlana w nowym oknie). A adapter źródła danych (DSA) Komponent, który umożliwia aplikacjom dostęp do danych przechowywanych w zewnętrznym źródle danych. adapter źródła danych JMS (DSA JMS) Adapter źródła danych, który wysyła i odbiera komunikaty Java Message Service (JMS). adapter źródła danych LDAP (DSA LDAP) Adapter źródła danych odczytujący dane katalogowe zarządzane przez serwer LDAP. Patrz także Lightweight Directory Access Protocol. adapter źródła danych SNMP (DSA SNMP) Adapter źródła danych umożliwia zarządzanie informacjami gromadzonymi przez agenty SNMP w celu ustawiania i pobierania. Można go także wykorzystać do wysyłania pułapek SNMP i powiadomień do menedżerów SNMP. Patrz także Simple Network Management Protocol. adapter źródła danych XML Adapter źródła danych, który umożliwia odczyt danych XML z łańcuchów i plików oraz z serwerów WWW przy użyciu HTTP. aktywator strategii Usługa uruchamiająca konkretną strategię w zdefiniowanych odstępach czasu. aktywator zahibernowanych strategii Usługa odpowiedzialna za budzenie zahibernowanych strategii. B baza danych (DB) Kolekcja powiązanych lub niezależnych elementów danych zapisanych razem w celu obsługi co najmniej jednej aplikacji. Patrz także serwer bazy danych. C Common Object Request Broker Architecture (CORBA) Architektura i specyfikacja dotycząca zorientowanego obiektowo przetwarzania rozproszonego, w którym programy klienckie i serwery są oddzielone formalną definicją interfejsu. © Copyright IBM Corp. 2005, 2011 © IBM 2006, 2014 55 CORBA Patrz Common Object Request Broker Architecture. czytnik wiadomości błyskawicznych Usługa oczekująca na wiadomości od zewnętrznych serwerów wiadomości błyskawicznych i na ich podstawie wyzwalająca strategie. czytnik wiadomości e-mail Usługa, która w określonych odstępach czasu pobiera wiadomości z serwera poczty elektronicznej POP i na podstawie zawartych w nich informacji wyzwala odpowiednie strategie. czytnik zdarzeń Usługa, która monitoruje źródło zdarzeń w poszukiwaniu nowych, zmodyfikowanych i/lub usuniętych zdarzeń i na podstawie informacji o zdarzeniach wyzwala odpowiednie strategie. Patrz także czytnik zdarzeń bazy danych, standardowy czytnik zdarzeń. czytnik zdarzeń bazy danych Program monitorujący źródło zdarzeń bazy danych SQL w celu wykrycia nowych i zmienionych zdarzeń, który na tej podstawie wyzwala strategie. Patrz także czytnik zdarzeń. D DB Patrz baza danych. DSA Patrz adapter źródła danych. DSA bazy danych SQL Adapter źródła danych, który umożliwia pobieranie informacji z relacyjnych baz danych i innych źródeł danych udostępniających publiczny interfejs wykorzystujący mechanizm JDBC (Java Database Connectivity). DSA bazy danych SQL umożliwia także dodawanie, modyfikowanie i usuwanie informacji przechowywanych w tych źródłach danych. DSA JMS Patrz adapter źródła danych JMS. DSA LDAP Patrz adapter źródła danych LDAP. DSA Mediator Typ adaptera źródła danych, który umożliwia uzyskanie dostępu do danych dostarczanych przez inne systemy, urządzenia i aplikacje. DSA SNMP Patrz adapter źródła danych SNMP. DSA usług WWW Adapter źródła danych, który umożliwia wymianę informacji z zewnętrznymi aplikacjami wykorzystującymi interfejs API usług WWW. DSA używający gniazd Adapter źródła danych używający serwera gniazd jako agenta brokera. E element danych Jednostka informacji, którą można przetworzyć. 56 Netcool/Impact: Podręcznik integrowania F filtr Urządzenie lub program, który oddziela dane, sygnały lub materiały zgodnie z określonymi kryteriami. Patrz także filtr LDAP, filtr SQL. filtr LDAP Wyrażenie używane do wybierania elementów danych w drzewie katalogów LDAP. Patrz także filtr. filtr SQL Wyrażenie używane do wybierania wierszy z tabeli bazy danych. Składnia filtru jest podobna do klauzuli WHERE w języku SQL. Patrz także filtr. funkcja Instrukcja lub zestaw powiązanych instrukcji realizujących konkretną operację. Patrz także funkcja zdefiniowana przez użytkownika. funkcja zdefiniowana przez użytkownika Niestandardowa funkcja służąca do organizowania kodu w strategii. Patrz także funkcja. G graficzny interfejs użytkownika (GUI) Interfejs komputerowy, który prezentuje wizualną metaforę rzeczywistego świata, zwykle pulpit, na którą składają się grafika wysokiej rozdzielczości, urządzenia wskazujące, paski menu i inne menu, nakładające się okna, ikony i relacje wiążące obiekty z działaniami. Patrz także serwer graficznego interfejsu użytkownika. I interfejs GUI patrz graficzny interfejs użytkownika. IPL Patrz język strategii serwera Netcool/Impact. J Java Database Connectivity (JDBC) Standard przemysłowy połączeń, niezależnych od bazy danych, między platformą Java i wieloma różnymi bazami danych. Interfejs JDBC udostępnia interfejs na poziomie wywołania podczas dostępu do baz danych typu SQL lub XQuery. Java Message Service (JMS) Aplikacyjny interfejs programistyczny, który udostępnia funkcje w języku Java do obsługi komunikatów. JDBC Patrz Java Database Connectivity. język strategii Netcool/Impact (IPL) Język programowania używany do pisania strategii. JMS Patrz Java Message Service. K konkatenacja łańcuchów W języku REXX, operacja łączenia dwóch znaków lub łańcuchów w określonej kolejności. W wyniku operacji powstaje jeden łańcuch, którego długość jest równa sumie długości połączonych znaków lub łańcuchów. Glosariusz 57 L LDAP Patrz Lightweight Directory Access Protocol. Lightweight Directory Access Protocol (LDAP) Otwarty protokół wykorzystujący TCP/IP w celu udostępnienia katalogów. Obsługuje on model X.500 i nie wymaga zasobów potrzebnych do obsługi bardziej skomplikowanego protokołu X.500 Directory Access Protocol (DAP). Protokołu LDAP można używać na przykład do znajdowania osób, organizacji i innych zasobów w katalogach internetowych lub intranetowych. Patrz także adapter źródła danych LDAP. M mechanizm strategii Funkcja automatyzująca zadania określane przez użytkownika w języku skryptowym strategii. menedżer wiersza komend Usługa zarządzająca interfejsem wiersza komend. menedżer wykonywania komend Usługa zarządzająca zdalnym wykonywaniem komend przy użyciu funkcji w strategiach. menedżer zabezpieczeń Komponent odpowiedzialny za uwierzytelnianie logowania użytkowników. model danych Abstrakcyjna reprezentacja danych biznesowych i metadanych używana w instalacji. Model danych zawiera źródła danych, typy danych, połączenia i źródła zdarzeń. N nadawca poczty elektronicznej Usługa, która wysyła pocztę elektroniczną za pośrednictwem serwera SMTP (Simple Mail Transfer Protocol). O ogólny program nasłuchujący zdarzeń Usługa, która nasłuchuje zdarzenia przychodzące z zewnętrznego źródła danych i na podstawie informacji o zdarzeniach wyzwala odpowiednie strategie. operator Wbudowana funkcja służąca do przypisania wartości do zmiennej, wykonania operacji na wartości lub określenia sposobu porównania dwóch wartości w strategii. Patrz także operator przypisania, operator boolowski, operator porównania, operator matematyczny, operator łańcuchowy. operator boolowski Wbudowana funkcja, która określa operację logiczną AND, OR lub NOT podczas wartościowania zestawów operacji. Operatorami boolowskimi są &&, || oraz !. Patrz także operator. operator łańcuchowy Wbudowana funkcja służąca do wykonywania operacji na dwóch łańcuchach. Patrz także operator. 58 Netcool/Impact: Podręcznik integrowania operator matematyczny Wbudowana funkcja służąca do wykonywania operacji matematycznych na dwóch wartościach. Operatorami matematycznymi są znaki: +, -, *, / oraz %. Patrz także operator. operator porównania Wbudowana funkcja służąca do porównywania dwóch wartości. Operatory porównania to ==, !=, <, >, <= oraz >=. Patrz także operator. operator przypisania Operator nadający lub resetujący wartość zmiennej. Patrz także operator. P pole Zestaw jednego lub kilku przylegających znaków, które tworzą jednostkę danych w zdarzeniu lub elemencie danych. pole klucza Pole, które jednoznacznie identyfikuje element danych w typie danych. połączenie Element modelu danych definiujący relację między elementami danych w typach danych. Patrz także połączenie dynamiczne, połączenie statyczne. połączenie dynamiczne Połączenie dynamiczne jest elementem modelu danych, który reprezentuje dynamiczną relację między elementami danych w typach danych. Patrz także połączenie. połączenie statyczne Element modelu danych definiujący statyczną relację między elementami danych w wewnętrznych typach danych. Patrz także połączenie. POP Patrz Post Office Protocol. Post Office Protocol (POP) Protokół używany do wymiany poczty elektronicznej w sieci oraz do dostępu do skrzynek pocztowych. procesor zdarzeń Usługa odpowiedzialna za zarządzanie zdarzeniami poprzez czytnik zdarzeń, program nasłuchujący zdarzeń i czytnik wiadomości e-mail. Procesor zdarzeń zarządza kolejką nadchodzących zdarzeń i jest odpowiedzialny za wysyłanie kolejkowanych zdarzeń do mechanizmu strategii w celu ich przetworzenia. program nasłuchujący zdarzeń bazy danych Usługa nasłuchująca wiadomości nadchodzących ze źródła danych bazy SQL, a następnie wyzwalająca strategię odpowiednią dla danych znajdujących się w tych wiadomościach. Program nasłuchujący zdarzeń Precision Usługa oczekująca na komunikaty od aplikacji i wyzwalająca strategie na ich podstawie. program rejestrujący strategii Usługa zapisująca komunikaty w dzienniku strategii. S serwer Komponent odpowiedzialny za obsługę modelu danych, zarządzanie usługami i uruchamianie strategii. Glosariusz 59 serwer bazy danych Oprogramowanie wykorzystujące menedżera bazy danych w celu udostępnienia usług bazy danych innym programom lub komputerom. Patrz także baza danych. serwer graficznego interfejsu użytkownika (serwer interfejsu GUI) Komponent korzystający z protokołu HTTP, który udostępnia przeglądarkom WWW graficzny interfejs użytkownika. Patrz także graficzny interfejs użytkownika. serwer interfejsu GUI Patrz serwer graficznego interfejsu użytkownika. Simple Mail Transfer Protocol (SMTP) Internetowy protokół służący do przesyłania poczty elektronicznej między użytkownikami w Internecie. Simple Network Management Protocol (SNMP) Zestaw protokołów służących do monitorowania systemów i urządzeń w złożonych sieciach. Informacje o zarządzanych urządzeniach są zdefiniowane i przechowywane w bazie MIB (Management Information Base, MIB). Patrz także adapter źródła danych SNMP. SMTP Patrz Simple Mail Transfer Protocol. SNMP Patrz Simple Network Management Protocol. standardowy czytnik zdarzeń Usługa, która monitoruje bazę danych w poszukiwaniu nowych, zmodyfikowanych i/lub usuniętych zdarzeń i na podstawie informacji o zdarzeniach wyzwala odpowiednie strategie. Patrz także czytnik zdarzeń. strategia Zestaw reguł i działań, które muszą być wykonane przez serwer Netcool/Impact, gdy w środowisku wystąpią zdefiniowane zdarzenia lub warunki. struktura sterująca Blok instrukcji w strategii, który jest wykonywany po spełnieniu warunków sterujących. T typ danych Element modelu danych reprezentujący zestaw danych przechowywanych w źródle danych, na przykład tabela lub widok w relacyjnej bazie danych. U usługa Wykonywalny podkomponent sterowany przez użytkownika z graficznego interfejsu użytkownika (GUI). usługa samomonitorująca Usługa monitorująca pamięć i inne warunki statusu i zgłaszająca je jako zdarzenia. usługa wiadomości błyskawicznych Usługa wysyłająca wiadomości błyskawiczne do klientów wiadomości błyskawicznych z wykorzystaniem serwera Jabber. W wyjątek Warunek lub zdarzenie, którego nie można obsłużyć podczas normalnego przetwarzania. 60 Netcool/Impact: Podręcznik integrowania wyrażenie kluczowe Wyrażenie określające wartość jednego lub kilku pól kluczowych w elemencie danych, które są niezbędne, aby można było pobrać element danych w języku IPL. Z zdarzenie Wystąpienie czegoś istotnego dla zadania lub systemu. Zdarzeniami są: zakończenie lub niepowodzenie operacji, działanie użytkownika lub zmiana stanu procesu. zmienna Reprezentacja wartości, która może się zmieniać. Ź źródło danych Repozytorium danych, z którym serwer stowarzyszony może nawiązać połączenie, a następnie pobierać dane używając programów opakowujących. Źródło danych może zawierać relacyjne bazy danych, pliki XML, arkusze Excel, pliki ze strukturą tabel oraz inne obiekty. W systemie stowarzyszonym źródła danych są widziane jako pojedyncza wspólna baza danych. źródło zdarzeń Źródło danych, które przechowuje zdarzenia i zarządza nimi. Glosariusz 61 62 Netcool/Impact: Podręcznik integrowania Indeks N C Centrum informacyjne Tivoli vi D dział wsparcia IBM dla oprogramowania cotygodniowe otrzymywanie aktualizacji vii kontaktowanie viii przegląd vii nazwy katalogów notacja x nazwy ścieżek notacja x niepełnosprawność 49 notacja kroje pisma x nazwy ścieżek x zmienne środowiskowe x O E edukacja Patrz szkolenia techniczne Tivoli określanie i rozwiązywanie problemów ix P G glosariusz 55 I IPLtoXML, funkcja dodawanie atrybutów XML do obiektów elementu 37, 38, 39 dodawanie komentarzy XML do obiektów elementów 40 dodawanie podelementu 36 dodawanie zawartości do obiektów elementów XML 40 dodawanie zawartości do obiektu elementu XML 39 domyślne jednostki XML 42 generowanie łańcuchów XML z obiektów dokumentu 41 jednostki XML 42 kolejność elementów 42 przegląd 35 przykłady 42 tworzenie nieprzypisanego elementu 37 tworzenie obiektu dokumentu XML 36 zagnieżdżanie obiektów elementów XML w innych obiektach 41 podręczniki patrz: publikacje v, vi poprawki uzyskiwanie vii publikacje v dostęp vi zamawianie vi publikacje elektroniczne uzyskanie dostępu vi S szkolenia Tivoli, techniczne vi szkolenia techniczne Tivoli vi U ułatwienia dostępu vi, 49 W WebSphere MQ 47 wsparcie klienta viii Z K zamawianie publikacji vi zmienne notacja x zmienne środowiskowe notacja x konwencje kroje pisma x konwencje typograficzne x książki patrz: publikacje v, vi Ł łączenie z WebSphere MQ 47 © Copyright IBM Corp. 2006, 2014 63 64 Netcool/Impact: Podręcznik integrowania Drukowane w USA SC85-0531-00