Streszczenie -------- Ten dokument zawiera plik readme produktu WebSphere MQ 7.0.1 oraz informacje o jego konserwacji. Anglojęzyczna wersja tego dokumentu jest najbardziej aktualna. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ OPIS ----------- W tym pliku znajdują się następujące informacje: 1. Ograniczenia i znane problemy 2. W jaki sposób można uzyskać i zainstalować ten pakiet poprawek 3. Klient IBM Message Service Client for .NET V2.0.0.13 4. Uwagi i znaki towarowe Najnowsza wersja tego pliku jest dostępna pod adresem: https://ibm.biz/mqreadmes Najnowsza wersja pliku licencji produktu jest dostępna pod adresem: http://www.ibm.com/support/docview.wss?uid=swg27006097 Uzupełnieniem tego pliku są informacje zawarte w serwisie WWW produktu IBM MQ pod adresem: http://www.ibm.com/software/integration/wmq/ Strona WWW pakietu serwisowego znajduje się pod adresem: https://ibm.biz/mqsupportpacs Bieżące informacje na temat znanych problemów i dostępnych poprawek znajdują się na stronie wsparcia w serwisie WWW produktu IBM MQ pod adresem: http://www.ibm.com/software/integration/wmq/support/ Aktualizacje dokumentacji w serwisach WWW Najnowsze aktualizacje dokumentacji produktu IBM MQ zawiera serwis WWW produktu IBM MQ dostępny pod adresem: http://www.ibm.com/software/integration/wmq/library/ Dokument Announcement letter Dokument Announcement letter dla produktu WebSphere MQ 7.0 (w języku angielskim - Stany Zjednoczone) jest dostępny pod adresem: http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-068 (dla platform rozproszonych) lub http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-067 (WebSphere MQ for z/OS). Dokument Announcement letter zawiera następujące typy informacji: - Szczegółowy opis produktu wraz z opisem nowych funkcji - Określenie miejsca produktu w ofercie - Szczegóły dotyczące składania zamówień - Wymagania sprzętowe i programowe +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ HISTORIA AKTUALIZACJI 05.08.2016 - aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 14 12.02.2016 - aktualizacje dla nieaktualnej specyfikacji szyfrowania SSLv3 w pakiecie poprawek 13 01.07.2015 – refaktoryzacja wg pakietu poprawek i aktualizacje dla pakietu poprawek 13 14.03.2014 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 12 20.08.2013 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 11 17.12.2012 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 10 06.07.2012 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 9 13.01.2012 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 8 03.10.2011 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 7 03.06.2011 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 6 03.02.2011 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 5 01.10.2010 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 4 12.08.2010 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 3 28.01.2010 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 2 20.11.2009 – aktualizacje dla produktu WebSphere MQ 7.0.1, pakiet poprawek 1 16.07.2009 – aktualizacje dla produktu WebSphere MQ 7.0.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEKCJA 1: OGRANICZENIA I ZNANE PROBLEMY ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 14 ============================================================= Wycofanie programu narzędziowego migracji migmbbrk ---------------------------------------- Program narzędziowy migmbbrk był wcześniej dostarczany z produktem WebSphere MQ 7. Był on używany do migrowania danych konfiguracyjnych publikowania/subskrypcji z produktu WebSphere Event Broker 6.0 lub WebSphere Message Broker 6.0/6.1 do produktu WebSphere MQ 7. Tę operację można wykonać za pomocą dodatkowych komponentów oprogramowania, które są dostarczane z tym produktem. Ponieważ obsługa odpowiednich wersji produktów WebSphere Event Broker i WebSphere Message Broker została wycofana, program narzędziowy migmbbrk i jego komponenty zależne nie są już dostarczane jako część instalacji produktu MQ. W celu zapewnienia kompatybilności dostarczane są pliki zastępcze o takich samych nazwach, co pozwala zachować układ instalacji na dysku. Autonomiczna wersja programu narzędziowego migmbbrk zostanie udostępniona w serwisie wsparcia IBM. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 13 ============================================================= Dezaktualizacja obsługi słabszych specyfikacji szyfrowania --------------------------------------------- W produkcie WebSphere MQ 7.0.1 z pakietem poprawek 13 zdezaktualizowano protokół SSLv3 i następujące specyfikacje szyfrowania w definicjach kanałów powiązanych z menedżerem kolejek: AES_SHA_US (tylko SSLV3) RC4_SHA_US RC4_MD5_US TRIPLE_DES_SHA_US DES_SHA_EXPORT1024 RC4_56_SHA_EXPORT1024 RC4_MD5_EXPORT RC2_MD5_EXPORT DES_SHA_EXPORT TLS_RSA_WITH_DES_CBC_SHA (inne niż SSLV3) NULL_SHA NULL_MD5 FIPS_WITH_DES_CBC_SHA FIPS_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_NULL_SHA256 (inne niż SSLV3) Próba użycia lub skonfigurowania jednej z tych specyfikacji szyfrowania spowoduje zgłoszenie jednego lub większej liczby następujących komunikatów w dzienniku błędów menedżera kolejek: AMQ8242, AMQ9616, AMQ9635. Aby nadal używać specyfikacji szyfrowania protokołu SSLv3 wymienionych na wcześniejszej liście (czyli dowolnych specyfikacji szyfrowania, oprócz tych oznaczonych jako inne niż SSLV3), należy ustawić zmienną środowiskową AMQ_SSL_V3_ENABLE na wartość TRUE w środowisku, w którym uruchamiany jest menedżer kolejek. Alternatywnie można dodać następujący wpis w sekcji SSL pliku qm.ini menedżera kolejek: AllowSSLV3=Y Ustawienie tej zmiennej środowiskowej spowoduje nadpisanie każdej wartości określonej w pliku qm.ini. Aby nadal używać wszystkich specyfikacji szyfrowania wymienionych na wcześniejszej liście, oprócz tej oznaczonej łańcuchem tylko SSLV3, należy ustawić (lub wyeksportować) zmienną środowiskową AMQ_SSL_WEAK_CIPHER_ENABLE na wartość Yes w środowisku, w którym uruchamiany jest menedżer kolejek. Alternatywnie można dodać następujący wpis w sekcji SSL pliku qm.ini menedżera kolejek: AllowWeakCipherSpec=Yes Ustawienie tej zmiennej środowiskowej spowoduje nadpisanie każdej wartości określonej w pliku qm.ini. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 12 ============================================================= Ten pakiet poprawek nie zawiera żadnych nowych ograniczeń ani problemów, które wymagają uwagi użytkownika. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 11 ============================================================= Sekcja Wprowadzenie pliku EGA.readme.mbr udostępnianego wraz z kodem podstawowym produktu WebSphere MQ 7.0.1 iSeries zawiera nieaktualne odwołanie do podręcznika Krótkie wprowadzenie dostępnego w serwisie pobierania. -------------------------------------------------------------------------- Wprowadzenie Niniejsze instrukcje dotyczą instalowania produktu WebSphere MQ for i5/OS 7.0.1 z obrazu instalacyjnego pobranego z serwisu IBM. Należy ich używać wraz z podręcznikiem Krótkie wprowadzenie dla produktu WebSphere MQ for i5/OS w bieżącej wersji. Wersja książki Krótkie wprowadzenie jest dostępna w serwisie pobierania. Jej opis to: „Dokumentacja dotycząca instalacji produktu WebSphere MQ 7.0”. Ten dokument nie jest już dostępny w serwisie programu Passport Advantage. Informacje są teraz dostępne w wersji elektronicznej w Centrum informacyjnym produktu WebSphere MQ 7 w sekcji Krótkie wprowadzenie dla systemu i5/OS: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqwac.doc/iq10120_.htm OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 10 ============================================================= WebSphere MQ Explorer – komunikaty w języku angielskim w środowisku innego języka --------------------------------------------------------------------------------- Jeśli pakiet poprawek 10 zostanie zainstalowany w środowisku języka innego niż angielski, niektóre komunikaty w programie WebSphere MQ Explorer mogą być nadal wyświetlane w języku angielskim i nie zawierać najnowszego tłumaczenia. Ten problem jest spowodowany przez błąd 201489 środowiska Eclipse: https://bugs.eclipse.org/bugs/show_bug.cgi?id=201489 Aby zainstalować poprawkę Eclipse rozwiązującą ten problem, należy najpierw uruchomić program WebSphere MQ Explorer w trybie środowiska roboczego Eclipse (Eclipse Workbench). Aby wybrać tryb środowiska roboczego Eclipse, należy kliknąć opcję Okna > Preferencje > WebSphere MQ Explorer w środowisku roboczym Eclipse. Zmiany zostaną uwzględnione po zrestartowaniu produktu WebSphere MQ Explorer. Aby móc przeglądać i instalować aktualizacje na platformach Linux, należy uruchamiać program WebSphere MQ Explorer jako administrator. Kliknięcie opcji Pomoc > Aktualizacje oprogramowania spowoduje uruchomienie menedżera aktualizacji. Należy wybrać opcję RCP Patch (bug:201489) z listy dostępnych aktualizacji i zainstalować poprawkę zgodnie z wyświetlanymi instrukcjami. Aby przywrócić program WebSphere MQ Explorer do trybu autonomicznego (jeśli jest to wymagane), należy wybrać odpowiednią opcję ze strony preferencji produktu WebSphere MQ Explorer. Obsługa serwera WebSphere Application Server w systemie z/OS ------------------------------------------------------------ Przed wdrożeniem pakietu poprawek 10 w środowisku serwera WebSphere Application Server w systemie z/OS należy zapoznać się z poniższymi notami technicznymi, które odnoszą się do używanej wersji serwera WebSphere Application Server : Wersja Odsyłacz -------- ------------------------------------------------------------- 7.0 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21316899.htm 8.0 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21498708.htm 8.5 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21498708_85.htm APAR IV31952 ------------ Poprawka dotycząca raportu APAR IV31952 spowodowała zmiany procedur sprawdzania uprawnień wykonywanych przez produkt WebSphere dla obiektów kanału po uruchomieniu komendy RESET CHANNEL. Zastosowanie tej poprawki może powodować zmianę zachowania, ponieważ może być wymagana zmiana niektórych uprawnień. Zmiana ma wpływ na systemy tylko wtedy, gdy kanały są uruchamiane z identyfikatorem użytkownika MCAUSER, po którego rozstrzygnięciu jest uzyskiwany użytkownik inny niż mqm. Komenda resetowania kanału może być uruchamiana wewnętrznie w kodzie produktu WebSphere MQ, a więc zmiana może mieć wpływ na system nawet wtedy, gdy nie uruchamiano ręcznie komendy resetowania kanału. Należy upewnić się, że identyfikator użytkownika MCAUSER kanału ma co najmniej uprawnienia +DSP i +CTRLX dla obiektu kanału, co umożliwi uruchamianie komend resetowania kanału z poziomu tego identyfikatora użytkownika. Przed zastosowaniem poprawki IV31952 produkt WebSphere MQ sprawdzał, czy identyfikator użytkownika ma uprawnienie +ALTUSR, które mogło zostać nadane wcześniej, aby możliwe było działanie kanału. Po zastosowaniu pakietu poprawek 7.0.1.10 lub nowszego do produktu WebSphere MQ można usunąć uprawnienie +ALTUSR użytkownika MCAUSER dla obiektu kanału, ponieważ nie jest ono wymagane na potrzeby komendy resetowania kanału. Należy również sprawdzić, czy identyfikator użytkownika MCAUSER ma uprawnienia +DSP i +CTRLX dla obiektu kanału. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIETY POPRAWEK 8 I 9 =================================================================== Te pakiety poprawek nie zawierają żadnych nowych ograniczeń ani problemów, które wymagają uwagi użytkownika. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 7 ============================================================ Instalowanie pakietu poprawek 7.0.1 w systemie HP-UX, jeśli istnieje instalacja wersji 7.1 --------------------------------------------------------------------- Jeśli w systemie HP-UX podjęta zostanie próba zaktualizowania wersji 7.0.1 z pakietem poprawek 6 do wersji 7.0.1 z pakietem poprawek 7, a na tym komputerze istnieje również instalacja produktu WeSphere MQ 7.1, dziennik instalacji pakietu poprawek może zawierać powtarzające się wielokrotnie poniższe błędy. Ich występowanie nie uniemożliwia jednak pomyślnej instalacji pakietu poprawek. rm: MQSERIES.MQM-RUNTIME: non-existent ERROR: You have specified more than one fileset selection. You must specify only a single fileset when performing file or control file modifications. (rm: MQSERIES.MQM-RUNTIME: nie istnieje BŁĄD: Wybrano więcej niż jeden zestaw plików. Przeprowadzając modyfikację pliku lub pliku sterującego, należy określić tylko jeden zestaw plików). Usuwanie pakietu poprawek 7.0.1 z systemu Linux w czasie, gdy działa menedżer kolejek w wersji 7.1 --------------------------------------------------------------------------- Jeśli w systemie Linux (we wszystkich architekturach) podjęta zostanie próba usunięcia pakietu poprawek 7.0.1, operacja usuwania może częściowo nie powieść się, jeśli są spełnione oba poniższe warunki: – Po usunięciu pakietu poprawek 7.0.1 pozostanie zainstalowana wersja 7.0.1 starsza niż pakiet poprawek 6. – W czasie usuwania w systemie działa menedżer kolejek w wersji 7.1. Komenda rpm może wygenerować komunikat o błędzie podobny do następującego: ERROR: WebSphere MQ shared resources for this installation are still in use. Please ensure no WebSphere MQ processes are running before removing this maintenance package error: %preun(MQSeriesJRE-U844092-7.0.1-7.s390x) scriptlet failed, exit status 1 (BŁĄD: Zasoby współużytkowane tej instalacji produktu WebSphere MQ są wciąż w użyciu. Przed usunięciem tego pakietu serwisowego upewnij się, że nie działają żadne procesy produktu WebSphere MQ error: %preun(MQSeriesJRE-U844092-7.0.1-7.s390x) niepowodzenie skryptletu, status wyjścia 1) Na przykład w systemie, w którym zastosowano następującą kolejność instalacji: (1) Zainstalowano nową instalację produktu WebSphere MQ 7.0.1 z pakietem poprawek Fix Pack 3. (2) Zainstalowano produkt WebSphere MQ 7.0.1 z pakietem poprawek Fix Pack 7. (3) Zainstalowano produkt WebSphere MQ 7.1.0.0. (4) Utworzono i uruchomiono menedżer kolejek w wersji 7.1. (5) Zdeinstalowano pakiet poprawek WebSphere MQ 7.0.1.7. Aby uniknąć tego problemu, wykonaj jedną z następujących czynności: (a) Przed usunięciem pakietu poprawek upewnij się, że wszystkie menedżery kolejek w systemie są w stanie zatrzymania. (b) Upewnij się, że pakiet rpm MQSeriesRuntime jest ostatnim pakietem, który zostanie usunięty podczas deinstalacji pakietu poprawek. Składnia komendy rpm różni się w zależności od jej wersji – uzyskanie tych informacji dla używanego systemu może wymagać nawiązania kontaktu z dostawcą systemu operacyjnego. W systemie Red Hat Enterprise Linux Server 5.7, w którym używana jest komenda rpm w wersji 4.4.2.3, kolejność usuwania jest odwrotna do określonej w wierszu komend. Dlatego określenie pakietu MQSeriesRuntime na początku listy pakietów do usunięcia umożliwi usunięcie pakietu poprawek. Na przykład w systemie Red Hat Enterprise Linux Server 5.7 należy użyć następującej składni komendy, aby pomyślnie usunąć instancję wersji 7.0.1 z pakietem poprawek 7 w czasie, gdy jest uruchomiony menedżer kolejek w wersji 7.1.0.0: rpm -e MQSeriesRuntime-U844091-7.0.1-7 MQSeriesConfig-U844091-7.0.1-7 MQSeriesMsg_es-U844091-7.0.1-7 MQSeriesMsg_ru-U844091-7.0.1-7 MQSeriesMan-U844091-7.0.1-7 MQSeriesMsg_ko-U844091-7.0.1-7 MQSeriesServer-U844091-7.0.1-7 MQSeriesJava-U844091-7.0.1- MQSeriesMsg_cs-U844091-7.0.1-7 MQSeriesMsg_hu-U844091-7.0.1-7 MQSeriesMsg_pl-U844091-7.0.1-7 MQSeriesMsg_Zh_TW-U844091-7.0.1-7 MQSeriesTXClient-U844091-7.0.1-7 MQSeriesClient-U844091-7.0.1-7 MQSeriesJRE-U844091-7.0.1-7 MQSeriesMsg_de-U844091-7.0.1-7 MQSeriesMsg_it-U844091-7.0.1-7 MQSeriesMsg_pt-U844091-7.0.1-7 MQSeriesSamples-U844091-7.0.1-7 MQSeriesKeyMan-U844091-7.0.1-7 MQSeriesMsg_ja-U844091-7.0.1-7 MQSeriesSDK-U844091-7.0.1-7 MQSeriesFTA-U844091-7.0.1-7 MQSeriesMsg_fr-U844091-7.0.1-7 MQSeriesMsg_Zh_CN-U844091-7.0.1-7 Jeśli wystąpi ten problem, należy całkowicie usunąć pakiet poprawek 7.0.1, wykonując następujące kroki: 1. Zatrzymaj wszystkie menedżery kolejek produktu WebSphere MQ w systemie. 2. Usuń pozostałe pakiety RPM powiązane z pakietem poprawek, które nie zostały usunięte podczas pierwszej próby wykonania operacji usuwania. Zmiany atrybutu DEFXMITQ obiektu menedżera kolejek --------------------------------------------------------- W pakiecie poprawek 7 wprowadzono dodatkowe operacje sprawdzania uniemożliwiające ustawienie wartości SYSTEM.CLUSTER.TRANSMIT.QUEUE atrybutu DEFXMITQ dla obiektu menedżera kolejek. Utworzono nowy kod przyczyny MQRCCF_DEF_XMIT_Q_CLUS_ERROR (numer 3269) w celu opisania niepowodzenia próby ustawienia atrybutu DEFXMITQ obiektu menedżera kolejek na wartość SYSTEM.CLUSTER.TRANSMIT.QUEUE. Ponadto w celu uniknięcia problemów (jeśli wcześniej niepoprawnie ustawiono atrybut DEFXMITQ na wartość SYSTEM.CLUSTER.TRANSMIT.QUEUE) dodano nową operację sprawdzania poprawności uniemożliwiającą użycie tego niepoprawnego mechanizmu w wywołaniu MQOPEN lub MQPUT1. Kod przyczyny niepowodzenia jest następujący: MQRC_DEF_XMIT_Q_USAGE_ERROR (numer 2199). OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 6 ============================================================ Zmiany dotyczące domyślnego działania interfejsu API wywołania MQPUT1 z opcją MQPMO_SYNCPOINT w przypadku jego użycia w aplikacji klienckiej ------------------------------------------------------------------- W pakiecie poprawek Fix Pack 6 wprowadzono zmiany w domyślnym działaniu wywołania MQPUT1 z opcją MQPMO_SYNCPOINT w celu umożliwienia synchronicznego umieszczania komunikatów, dzięki czemu pola wyjściowe MQMD i MQOD są zapełniane podczas wywołania MQPUT1. Domyślne działanie można zmienić, ustawiając atrybut Put1AsyncPut pliku konfiguracyjnego klienta w sekcji Channels. Poprawne wartości dla atrybutu Put1AsyncPut: (a) no : Operacja umieszczania jest przeprowadzana zawsze w sposób synchroniczny. Jest to ustawienie domyślne. (b) yes : Operacja umieszczania jest przeprowadzana zawsze w sposób asynchroniczny. (c) syncpoint : Operacja umieszczania jest przeprowadzana w sposób asynchroniczny, jeśli ustawiono opcję MQPMO_SYNCPOINT. W przeciwnym razie operacja jest przeprowadzana w sposób synchroniczny. Nowy atrybut Put1AsyncPut nie zastępuje atrybutu Put1DefaultAlwaysSync. Jeśli konieczne będzie przywrócenie ustawienia domyślnego z wersji wcześniejszej niż pakiet poprawek Fix Pack 6, atrybut Put1AsyncPut pliku konfiguracyjnego klienta należy ustawić na wartość syncpoint. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 5 ============================================================ Usprawniona obsługa produktu WebSphere MQ działającego w systemie HP-UX 11i 3 (na sprzęcie z procesorem Itanium) ---------------------------------------------------------------------------- Dotyczy tylko użytkowników systemu HP-UX 11i 3 (na sprzęcie z procesorem Itanium), w którym nazwa hosta systemu jest dłuższa niż 8 znaków. Produkt WebSphere MQ przed zastosowaniem pakietu poprawek Fix Pack 5 uzyskiwał nazwę hosta przy użyciu wywołania systemowego uname(). W systemie HP-UX 11i 3 (na sprzęcie z procesorem Itanium) wywołanie uname() może się nie powieść, jeśli nazwa hosta zawiera więcej niż 8 znaków. Niepowodzenie wywołania uname() podczas procesu instalacji, a także w trakcie normalnego przetwarzania menedżera kolejek, może spowodować niepoprawne działanie kodu produktu WebSphere MQ. W katalogu /var/mqm mogą zostać niepoprawnie utworzone katalogi zawierające nazwę hosta. Zamiast nazwy hosta zostanie im przypisana nazwa Unknown (nieznany). Raport APAR IZ87770 rozwiązuje ten problem w ten sposób, że zamiast wywołania uname() jest używane wywołane systemowe gethostname(). Po zainstalowaniu pakietu poprawek Fix Pack 5 lub nowszego należy ręcznie usunąć katalogi z niepoprawną nazwą Unknown (Nieznany). Katalogi o nazwie Unknown mogą się znajdować w następujących położeniach: - /var/mqm/ipc - /var/mqm/sockets - /var/mqm/qmgrs//@app - /var/mqm/qmgrs//@qmgr Nie należy usuwać żadnych innych katalogów, na przykład katalogu danych komunikatów /var/mqm/qmgrs//queues. Więcej informacji na temat tego raportu APAR można znaleźć na następującej stronie: http://www.ibm.com/support/docview.wss?uid=swg1IZ87770 Ulepszenie sposobu, w jaki monitor wyzwalacza wysyła informacje do wyzwalanej aplikacji ----------------------------------------------------------------- Raport APAR IC72003 powoduje ulepszenie sposobu, w jaki monitor wyzwalacza wysyła informacje do wyzwalanej aplikacji. Znaki procentu i dolara są obecnie poprzedzane znakiem podwójnego cudzysłowu (w systemie Windows) lub ukośnikiem odwrotnym (w systemie UNIX). Ta zmiana powoduje, że rozszerzanie zmiennych środowiskowych przez system operacyjny jest wstrzymywane w przypadku danych wewnątrz struktury MQTMC2, która jest przekazywana jako parametr do wyzwalanej aplikacji. Jeśli na przykład pole APPLICID procesu zostało zdefiniowane jako java cp %CLASSPATH% TriggerApp, podczas konstruowania struktury MQTMC2 w systemie Windows zostanie zmienione na java cp "%"CLASSPATH"%" TriggerApp. W tym przykładzie aplikacja otrzyma parametr wejściowy java cp %CLASSPATH% TriggerApp. Począwszy od pakietu poprawek 5, aplikacje nie otrzymują rozszerzonej wersji zmiennych środowiskowych wewnątrz struktury MQTMC2. Zamiast tego należy rozszerzyć zmienne środowiskowe w inny sposób, jeśli ich zawartość jest ważna. Zmiany dotyczące użycia opcji MQGMO_CONVERT w klasach produktu WebSphere MQ 7.0 dla usługi JMS -------------------------------------------------------------------------- Raport APAR IC72897 powoduje zmianę sposobu, w jaki klasy produktu WebSphere MQ 7.0 dla usługi JMS żądają komunikatów z menedżera kolejek. Przed zastosowaniem pakietu poprawek Fix Pack 5 klasy produktu WebSphere MQ 7.0 dla usługi JMS żądały komunikatów z menedżera kolejek przy użyciu opcji MQGMO_CONVERT interfejsu API produktu WebSphere MQ. Ta opcja żąda, aby menedżer kolejek wykonywał konwersję danych komunikatu przed jego wysłaniem do odbierającej aplikacji JMS. W klasach produktu WebSphere MQ 6.0 dla usługi JMS nie była używana ta opcja. Niniejsza zmiana zachowania klienta JMS może wpływać na aplikacje JMS w przypadku migracji z wersji 6.0 do 7.0. Zmiana kodu związana z raportem APAR powoduje, że domyślne działanie klas wersji 7.0 jest takie same jak zachowanie wersji 6.0. Po zainstalowaniu pakietu poprawek Fix Pack 5 lub nowszego klasy produktu WebSphere MQ 7.0 dla aplikacji JMS nie używają już opcji MQGMO_CONVERT. Dlatego też menedżer kolejek nie wykonuje żadnej konwersji danych komunikatów w przypadku żądań komunikatów. W ramach tego raportu APAR są też dodawane nowe właściwości, dzięki którym w aplikacji można wybrać, czy ma następować żądanie konwersji danych menedżera kolejek. Te właściwości można skonfigurować programowo przy użyciu metody procedury ustawiającej dla klasy com.ibm.mq.jms.MQDestination, administracyjnie – ustawiając właściwość w przestrzeni nazw JNDI dla miejsca docelowego lub za pomocą zmiennej środowiskowej całego systemu w ramach maszyny JVM – przy użyciu właściwości com.ibm.msg.client.wmq.receiveConversionCCSID. Pełny opis tego raportu APAR wraz z objaśnieniem sposobu używania nowych właściwości oraz ustawieniami umożliwiającymi utrzymanie zachowania klas z wersji 7.0 jako priorytetowego wobec tego pakietu poprawek można znaleźć pod adresem: http://www.ibm.com/support/docview.wss?uid=swg21459994 OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 4 ============================================================ Działanie pola wyjściowego UNCOM komendy DISPLAY QSTATUS ------------------------------------------------------ Poprawka APAR IZ76189 zmieniła działanie komendy DISPLAY QSTATUS w interpreterze komend runmqsc. Działanie pola UNCOM jest teraz zgodne z opisem znajdującym się na stronach Centrum informacyjnego interpretera komend runmqsc. Interfejs runmqsc wyświetli liczbę niezatwierdzonych komunikatów, a nie tylko wartość YES lub NO. Pola UNCOM można użyć w filtrze, np. WHERE(UNCOM LT 10). Jeśli skrypty użytkownika zawierają komendy DISPLAY QSTATUS odnoszące się do interpretera komend runmqsc i opierają się na tych wartościach YES lub NO, konieczne może być ich zmodyfikowanie. Usprawnienie obsługi niedostarczonych komunikatów w klasach produktu WebSphere MQ 7 dla usługi JMS ------------------------------------------------------------------------------ Poprawka APAR IZ78515 zmieniła domyślne działanie obsługi niedostarczonych komunikatów w klasach produktu WebSphere MQ 7 dla usługi JMS. W przypadku używania klas produktu WebSphere MQ 7 dla usługi Java Message Service (JMS) przed zastosowaniem pakietu poprawek Fix Pack 4 komunikaty nieprzetwarzalne, których nie można wysłać do podanej kolejki wycofanych komunikatów, były przekształcane w typ JMSBytesMessage przed wysłaniem do kolejki niedostarczonych komunikatów menedżera kolejek (np. SYSTEM.DEAD.LETTER.QUEUE). Była to zmiana działania względem produktu WebSphere MQ 6. W wersji 6 klasy JMS umieszczały komunikaty w kolejce niedostarczonych komunikatów w oryginalnym formacie, bez przekształcania w typ JMSBytesMessage. Raport APAR IZ78515 zmienia działanie w taki sposób, że komunikaty nieprzetwarzalne są obecnie umieszczane w kolejce niedostarczonych komunikatów bez przekształcania. Jest to poprawne działanie tej funkcji i jest ono zgodne z jej działaniem w produkcie WebSphere MQ 6. Nowe informacje w programie WebSphere MQ Explorer: brak niektórych tekstów w językach innych niż angielski --------------------------------------------------------------------------- W programie WebSphere MQ Explorer w wersjach innych niż angielska brak niektórych najnowszych tekstów (dodanych w pakiecie poprawek Fix Pack 4). (a) Funkcja autoryzacji programu MQ Explorer zawiera obecnie nowy panel, który umożliwia dodawanie uprawnień opartych na rolach. Na tym ekranie znajdują się dwa odsyłacze Więcej informacji. W pakiecie poprawek Fix Pack 4 położony niżej odsyłacz nie udostępnia żądanych informacji w przypadku programu MQ Explorer w wersji językowej innej niż angielska. (b) Do programu MQ Explorer w pakiecie poprawek Fix Pack 4 dodano kilka elementów wynikających z funkcjonalności wprowadzonych ostatnio w protokole SSL/TLS. Elementy te dotyczą konfiguracji kanału i menedżera kolejek. Nowe możliwości: - Konfiguracja specyfikacji szyfrowania SHA-2 z poziomu programu MQ Explorer. - Specyfikacja serwera proxy HTTP na potrzeby korzystania ze standardu OCSP. - Możliwa do skonfigurowania zmiana sposobu sprawdzania poprawności certyfikatów, użyteczna w przypadku małej liczby użytkowników. W przypadku uruchomienia programu MQ Explorer w wersji angielskiej informacje na tych panelach będą zaktualizowane o nowe wartości związane z protokołem SSL/TLS. W innych językach niektóre z nowych informacji nie są wyświetlane, chociaż panele główne są właściwie przetłumaczone. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIET POPRAWEK 3 ============================================================ Począwszy od pakietu poprawek Fix Pack 3: klienty używające usługi JMS łączące się z serwerami z pakietem poprawek Fix Pack 2 ----------------------------------------------------------------------- W przypadku aktualizowania instalacji, w której używane są klasy produktu WebSphere MQ dla usługi Java Message Service (JMS), do wersji z pakietem poprawek Fix Pack 3 należy zapoznać się z następującymi informacjami. Począwszy od pakietu poprawek 3, podczas używania klas produktu WebSphere MQ dla usługi Java Message Service (JMS) w celu nawiązania połączenia z menedżerem kolejek z pakietem poprawek Fix Pack 2 może wystąpić problem z zatrzymaniem instancji kanału SVRCONN. Na przykład po wpisaniu komendy: STOP CHANNEL(KANAL.SVRCONN) Zatrzymanie kanału używanego przez aplikację Java może spowodować pozostanie statusu kanału w stanie Zatrzymywanie. Po zrestartowaniu kanału jego status zostanie zmieniony na Uruchomiony i zostanie utworzona kolejna instancja kanału. Ten problem został rozwiązany przez poprawkę APAR IZ77323 i naprawiony w pakiecie poprawek Fix Pack 3. Dlatego zaleca się zaktualizowanie instalacji serwera produktu WebSphere MQ do wersji z pakietem poprawek Fix Pack 3 lub nowszym przed zaktualizowaniem klientów, które się z nim łączą (jeśli te klienty korzystają z usługi JMS. Dodatkowe przypadki błędów wykrywane przez testy zabezpieczeń programu Explorer ------------------------------------------------------------------------------- Po zainstalowaniu pakietu poprawek Fix Pack 3 lub nowszego w przypadku uruchamiania domyślnych testów programu Explorer w oknie wyników testów prawdopodobnie zostaną wyświetlone komunikaty o błędach, nawet jeśli wcześniej uzyskane wyniki nie zawierały błędów. Dzieje się tak, ponieważ testy domyślne testują obecnie aspekty konfiguracji, które nie były do tej pory testowane. Najczęstsze błędy występują ze względu na brak w systemach przychodzących i kanałach domyślnych (o nazwach zaczynających się od SYSTEM) odpowiedniej ochrony przed niepożądanym dostępem. Inną częstą przyczyną występowania nowych błędów jest dopuszczanie przez pliki systemowe SSL/TLS niepotrzebnie wysokich poziomów dostępu. Konfigurację systemu można zmienić w celu usunięcia wyników testów wskazujących błędy oraz, tam gdzie to konieczne, wyników testów wskazujących ostrzeżenia. Odpowiednie instrukcje zawiera sekcja Dodatkowe informacje powiązana z oknem wyniku testu. Aby zachować klucze i certyfikaty zarówno klienta, jak i menedżera kolejek, należy użyć tych samych plików systemowych SSL/TLS. Jest to jednak konfiguracja o niskim poziomie bezpieczeństwa i nie jest ona zalecana. Ogólnie prawa dostępu lub uprawnienia wymagane w takiej konfiguracji są niezgodne z nowym testem plików systemowych SSL/TLS. Jeśli użytkownik utrzymuje współużytkowanie plików systemowych SSL/TLS przez klienta i menedżera kolejek, ale chce, aby wyniki testu programu Explorer nie zawierały błędów, to może skonfigurować własny zestaw testów standardowych, korzystając z funkcji narzędzia Explorer Uruchom niestandardową konfigurację testów... OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1, PAKIETY POPRAWEK 1 I 2 =================================================================== Te pakiety poprawek nie zawierają żadnych nowych ograniczeń ani problemów, które wymagają uwagi użytkownika. OGRANICZENIA I ZNANE PROBLEMY W WERSJI 7.0.1.0 ================================================== 64-bitowa wersja pakietu GSKit 7 nie jest aktualizowana w przypadku instalacji pakietu poprawek MQ w systemie Windows -------------------------------------------------------------- Z powodu znanych ograniczeń w kodzie instalacji 64-bitowa wersja pakietu GSKit 7 w systemie Windows nie jest aktualizowana, jeśli zainstalowano pakiety poprawek produktu WebSphere MQ. Oznacza to, że 64-bitowe aplikacje klienckie produktu MQ korzystające z połączeń SSL/TLS w systemie Windows nie działają na najnowszym poziomie poprawek pakietu GSKit. Instalacje 32-bitowe pakietu GSKit 7 zostaną jednak zaktualizowane w przypadku instalacji pakietu poprawek. Oznacza to, że menedżery kolejek, kanały po stronie serwera i 32-bitowe aplikacje klienckie z obsługą połączeń SSL/TLS mogą nadal korzystać z nowszych poziomów poprawek pakietu GSKit po konserwacji produktu WebSphere MQ. Klienty Java i JMS nie używają pakietu GSKit w przypadku funkcji SSL/TLS, dlatego ten problem ich nie dotyczy. Informacje na temat konserwacji menedżerów kolejek z wieloma instancjami ------------------------------------------------------------------------- W tej sekcji można znaleźć wskazówki dotyczące stosowania pakietów poprawek w sytuacji, gdy są używane menedżery kolejek z wieloma instancjami: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/cr00060_.htm Zwykle menedżer kolejek z wieloma instancjami może mieć instancje zarówno w wersjach 7.0.x.y, jak i 7.0.a.b. Wyjątki od tej reguły wymieniono poniżej. Inne wyjątki opierają się na zasadzie ogólnej, według której instancja rezerwowa może być instalacją o poziomie pakietu poprawek nowszym lub starszym niż poziom aktywnej instancji. Umożliwia to aktualizowanie lub wycofywanie zmian konserwacji przy minimalnym czasie przestoju. Lista wyjątków: Windows: Wersje 7.0.1.0 i >= 7.0.1.0 nie mogą być używane w połączeniu ze sobą. i5/OS: Wersja 7.0.1.0 nie obsługuje menedżerów kolejek z wieloma instancjami, dlatego nie można jej używać w przypadku instancji rezerwowej lub aktywnej. Uruchamianie programu Explorer z wcześniejszą instalacją produktu WebSphere MQ 7.0.1 ----------------------------------------------------------------------------- Jeśli w systemie znajduje się poprzednia instalacja produktu WebSphere MQ 7.0.1, na przykład wersja beta, może wystąpić problem w momencie uruchamiania programu WebSphere MQ Explorer. Jeśli narzędzie Eclipse uruchamia się, natomiast perspektywa produktu WebSphere MQ nie otwiera się poprawnie, wykonaj następujące czynności: 1. W programie Explorer kliknij menu Okna i wybierz opcję Restartuj perspektywę. 2. Jeśli wykonanie poprzedniego kroku nie spowoduje wyeliminowania problemu: a. Zamknij program Explorer. b. Wykonaj następującą komendę w wierszu komend: strmqcfg -i. c. Ponownie uruchom program Explorer. 3. Jeśli wykonanie poprzedniego kroku nie spowoduje wyeliminowania problemu: a. Zamknij program Explorer. b. Sprawdź, czy nie działa żaden proces Eclipse. c. (Uwaga: to działanie usuwa dane programu Explorer, takie jak definicje zdalnych menedżerów kolejek oraz schematy i filtry niestandardowe, a więc należy zapisać wszystkie dane, które mają zostać zachowane). Usuń następujące foldery: W systemie Windows: C:\Documents and Settings\\Application Data\IBM\MQ Explorer C:\Documents and Settings\\.eclipse W systemie Linux: /home//.mqdata /home//.eclipse d. Wykonaj następującą komendę w wierszu komend: strmqcfg -i. e. Uruchom ponownie program Explorer. Obsługa produktu WebSphere MQ w systemie Windows Vista Japanese Edition ----------------------------------------------------------------------- Produkt WebSphere MQ nie obsługuje japońskiego standardu JIS X 0213:2004. System Windows Vista Japanese Edition oficjalnie obsługuje znaki standardu JIS X 0213:2004. Znaki standardu JIS X 0213:2004 zawierają znaki standardu Unicode CJK Ideographs Extension-B (rozszerzenie B ideogramów CJK, 4-bajtowe znaki par odpowiedników kodowania UTF-16). Program testowy sprawdzający instalację architektury JCA na serwerze WAS CE --------------------------------------------------------------------------- Aby działanie testu IVT architektury JCA na serwerze WebSphere Application Server Community Edition (WAS CE) było możliwe, musi istnieć fabryka połączeń o nazwie qcf oraz kolejka o nazwie miejsca docelowego komunikatów jmstestQ zdefiniowana w pliku geronimo-rar.xml podczas wdrażania pliku RAR. W przypadku pliku wmq.jmsra.ivt.ear, który ma zostać wdrożony w wersji 2.0.1 lub nowszej produktu WAS CE, następujące pliki XML w obrębie pliku EAR muszą zostać zaktualizowane w poniżej pokazany sposób: geronimo-application.xml xmlns:nam="[http://geronimo.apache.org/xml/ns/naming-1.2]"> openejb-jar.xml Grupowanie tematów ------------------ Pomimo tego, że grupowanie tematów jest zasadniczo obsługiwane, nie należy grupować tematów SYSTEM.BASE.TOPIC lub SYSTEM.DEFAULT.TOPIC. Parametr CLUSTER tych tematów musi być pusty. Tematy w klastrach nakładających się ------------------------------------ Jeśli definiowane są przynajmniej dwa tematy, gdzie jeden łańcuch tematu jest bardziej kwalifikowaną wersją drugiego (na przykład SPORT i SPORT/FUTBOL), i tematy te znajdują się w różnych, ale nakładających się klastrach, wówczas publikacje mogą być dostarczane do nieoczekiwanych menedżerów kolejek odbiorców. Na przykład: – Menedżer kolejek qmAB jest w dwóch klastrach: klastrze A i klastrze B. – SPORTY jest tematem klastra w klastrze A. – SPORTY/FUTBOL jest tematem klastra w klastrze B. Subskrybenci tematów SPORTY/FUTBOL w menedżerach kolejek znajdujących się tylko w klastrze A również otrzymują publikacje z menedżera kolejek qmAB. Podobnie, jeśli temat klastra i temat lokalny współużytkują nazwę, mogą być odbierane nieoczekiwane publikacje. Na przykład: - SPORTY jest tematem klastra w klastrze A. - Menedżer kolejek qmC w klastrze A definiuje temat SPORTY bez klastra. Subskrybenci tematu SPORTY w menedżerach kolejek w klastrze A otrzymują publikacje z menedżera kolejek qmC. Niepowodzenie produktu MQ Explorer podczas korzystania z przeglądarki Firefox w systemie Linux ---------------------------------------- Próba uruchomienia Centrum pomocy może spowodować niepowodzenie produktu WebSphere MQ Explorer. Zostanie wyświetlony komunikat o zakończeniu działania wirtualnej maszyny języka Java. Istnieje znany problem występujący podczas uruchamiania przeglądarki SWT (Standard Widget Toolkit) w środowisku Eclipse w niektórych dystrybucjach systemu Linux, gdy domyślną przeglądarką jest Firefox. Aby uniknąć tego problemu, należy ustawić wartość zmiennej środowiskowej MOZILLA_FIVE_HOME na ścieżkę do folderu zawierającego instalację przeglądarki Firefox. Jeśli na przykład przeglądarka Firefox jest zainstalowana w katalogu /usr/lib/firefox-3.0.10, należy użyć komendy: export MOZILLA_FIVE_HOME=/usr/lib/firefox-3.0.10 lub setenv MOZILLA_FIVE_HOME /usr/lib/firefox-3.0.10 zależnie od używanej powłoki (to wymaganie jest zapisane w sekcji często zadawanych pytań dotyczących pakietu SWT dla serwisu WWW Eclipse: http://www.eclipse.org/swt/faq.php#browserlinux). System pomocy aplikacji przesyłania plików nie jest automatycznie dostępny w systemie Linux ------------------------------------------------------------------------------------------- Jeśli pomoc w interfejsie GUI jest niedostępna, podczas uruchamiania aplikacji przesyłania plików wyświetlany jest komunikat o błędzie. Pliki html systemu pomocy znajdują się w położeniu /opt/mqm/eclipse/fta-help/plugins/com.ibm.mq.fta.doc_7.0.1.0/doc.zip Menedżery kolejek o wielu instancjach nie są obsługiwane na platformie IBM i ---------------------------------------------------------------------------- Menedżery kolejek o wielu instancjach zostały wprowadzone w produkcie WebSphere MQ 7.0.1. W Centrum Wiedzy IBM znajduje się informacja, że są one dostępne na wszystkich platformach z wyjątkiem systemu z/OS. W systemie IBM i (wcześniej i5/OS) są one jednak również niedostępne. Komponent Przesyłanie komunikatów języka Java i usługi WWW zawiera obiekt XMS ----------------------------------------------------------------------------- W systemie Windows komponent uprzednio zwany Przesyłanie komunikatów języka Java i usługi WWW obecnie nosi nazwę Przesyłanie komunikatów języka Java i środowiska .NET oraz usług WWW. W związku z tą zmianą w komponencie tym są obecnie zainstalowane dodatkowe pliki umożliwiające użycie klienta Message Service Client for .NET określanego też jako XMS. W przypadku aktualizowania samej instalacji języka Java będzie również instalowany klient Message Service Client for .NET. Więcej informacji na temat przesyłania komunikatów XMS znajduje się w Centrum Wiedzy IBM. Uproszczenie uprawnień publikowania/subskrypcji ----------------------------------------------- Uproszczono sposób określania uprawnień u góry drzewa tematów. Jeśli uprawnienia są definiowane w obiektach tematów SYSTEM.BROKER.DEFAULT.STREAM lub SYSTEM.BROKER.DEFAULT.SUBPOINT (a te obiekty tematów nadal mają puste łańcuchy tematów), nie będą one już uwzględniane. W celu zastosowania uprawnień tematów u góry drzewa tematów należy zastosować je do obiektu SYSTEM.BASE.TOPIC. Użycie maszyny HP Hotspot JVM ----------------------------- W przypadku używania maszyny HP Hotspot JVM należy ustawić właściwość systemową Java -XX:+UseGetTimeOfDay. Jeśli nie zostanie ona ustawiona, aplikacja może nie rejestrować zmian czasu systemowego. Zespoły poprawek XMS w pamięci podręcznej zespołu globalnego pozostałe po deinstalacji ----------------------------------------------------------------------------------- W systemie Windows deinstalacja produktu WebSphere MQ po zainstalowaniu produktu WebSphere MQ 7.0.1 przy użyciu pakietu poprawek może spowodować pozostawienie niektórych zespołów poprawek (IBM.XMS.*.dll) w pamięci GAC platformy .NET. Problem ten będzie występować w przypadku, gdy na komputerze zainstalowano środowisko .NET, a w pierwotnej instalacji produktu WebSphere MQ 7 została wybrana opcja Przesyłanie komunikatów języka Java i usługi WWW (jest ona wybierana domyślnie). Można temu zapobiec, wycofując pakiet aktualizacyjny produktu WebSphere MQ 7.0.1 lub uruchamiając komendę amqiRegsiterdotNet.cmd /u (dostępną w katalogu \bin) przed deinstalacją produktu WebSphere MQ. PROBLEMY DOTYCZĄCE MIGRACJI DO WERSJI 7.0.1 ================================== Migracja z wersji 6.0.2.3 lub wcześniejszej produktu WebSphere MQ w systemie Windows ------------------------------------------------------------------------------------ Podczas migracji z wersji 6.0.2.3 lub wcześniejszej produktu WebSphere MQ do wersji 7.0.1 katalog exits jest opróżniany. Zwykle jest to katalog c:\Program Files\IBM\WebSphere MQ\exits lub c:\Program Files\IBM\WebSphere MQ (x86)\exits, jednak instalacja mogła również mieć miejsce w innym katalogu. Ten problem dotyczy tylko instalacji w systemach Windows. W celu jego rozwiązania przed migracją należy zainstalować poprawkę serwisową 6.0.2.4 lub nowszą do instalacji w wersji 6. Szczegółowe informacje na ten temat zawiera raport APAR IC48397. W przeciwnym razie przed przeprowadzeniem migracji należy utworzyć kopię zapasową katalogu exits. Migracja produktu WebSphere MQ 6 do wersji WebSphere MQ 7 w systemie Windows -------------------------------------------------------------------------- Jeśli podczas migrowania produktu WebSphere MQ 6 do wersji 7 ustawiono właściwość startową menedżera kolejek na wartość Automatyczne, zostanie ona zmieniona podczas migracji na wartość Interaktywne (ręczne). Aby ustawić tę właściwość uruchamiania menedżera kolejek z powrotem na wartość Automatyczne, należy użyć następującej komendy produktu MQ: amqmdain auto nazwa_menedżera_kolejek. Migracja z wersji 6 produktu WebSphere MQ wcześniejszej niż CSD 6.0.2.3 ----------------------------------------------------------------------- Podczas pierwszego uruchomienia programu WebSphere MQ Explorer po migracji może zostać wyświetlony komunikat o błędzie AMQ4473 oraz może zostać zapisany plik FDC informujący, że plik WMQ_Schemes.xml używany do zapisu schematów ma nieprawidłowy format oraz że wszystkie zdefiniowane przez użytkownika schematy muszą zostać ponownie utworzone. W wersjach poprzedzających CSD 6.0.2.3 schematy nie były poprawnie zapisywane. Jeśli użytkownik używa schematów, ten problem wystąpi i konieczna będzie aktualizacja do późniejszego poziomu CSD. Jeśli użytkownik nie utworzył własnych schematów i używa wcześniejszej wersji produktu WebSphere MQ, ten komunikat zostanie wyświetlony podczas uruchomienia programu WebSphere MQ Explorer. Program MQ Explorer będzie jednak kontynuował działanie i utworzy zestaw schematów domyślnych, nie są więc wymagane żadne czynności. Migracja: zapisywanie pliku JMSAdmin.config ------------------------------------------- Przed aktualizacją do wersji 7.0 produktu WebSphere MQ należy zapisać plik JMSAdmin.config (z katalogu /java/bin) w innym katalogu. W przeciwnym razie zostanie on nadpisany. W przypadku korzystania z punktów subskrypcji po użyciu komendy migmbbrk migracja list ACL może zostać przeprowadzona w niepoprawny sposób ----------------------------------------------------------------------------------------------- Użycie narzędzia migracji stanu publikowania lub subskrypcji produktu WebSphere Message Broker (migmbbrk) może spowodować niepoprawną migrację list ACL, jeśli używane są punkty subskrypcji. Należy uwzględnić następujący scenariusz: 1. Subskrypcja brokera WebSphere Message Broker przywołuje drzewo tematów a/b/c. 2. Podczas publikowania w drzewie a/b/c używany jest punkt subskrypcji o nazwie SB1. 3. Łańcuch tematu a/b ma listę ACL, która daje użytkownikowi UŻYTKOWNIK1 prawo dostępu umożliwiające publikowanie. Migracja do menedżera kolejek powoduje utworzenie dwóch obiektów tematów i komendy setmqaut. Punkty subskrypcji są emulowane przez utworzenie obiektu tematu dla punktu subskrypcji SB1 z łańcuchem tematu SB1/a/b/c. Utworzony zostaje również obiekt tematu dla a/b z przyznaniem użytkownikowi UŻYTKOWNIK1 na liście ACL prawa do publikowania. Komenda setmqaut powoduje przyznanie użytkownikowi UŻYTKOWNIK1 prawa do publikowania w temacie a/b. W wyniku migracji w drzewie tematów powstają dwie gałęzie, a/b i SB1/a/b/c. Lista ACL jest zdefiniowana dla gałęzi a/b, ale nie dla gałęzi SB1/a/b/c. Tak więc użytkownik UŻYTKOWNIK1 otrzymuje uprawnienie do publikacji w łańcuchu tematu a/b, ale nie w łańcuchu tematu SB1/a/b/c. Jeśli drzewo tematów zawiera zarówno punkty subskrypcji, jak i zdefiniowane przez użytkownika listy ACL, należy je przejrzeć, aby sprawdzić, czy listy ACL zdefiniowane w brokerze, a następnie zmigrowane do menedżera kolejek, muszą być ręcznie replikowane dla drzew tematów poniżej punktów subskrypcji. Inne zmiany =========== Aktualizacje w przykładowym pliku makefile XA --------------------------------------------- Aktualizowany jest plik xaswit.mak, który obecnie zawiera aktualne odniesienia do katalogów instalacyjnych produktu bazy danych. Katalogi domyślne użyte w przykładowym pliku makefile są zmieniane i przez to bardziej aktualne. Aby odbudować plik ładowania przełącznika i nadal używać starszych katalogów lub wersji instalacyjnych produktu bazy danych, należy sprawdzić i zmienić plik xaswit.mak tak, aby zawierał poprawne informacje dla komputera docelowego. Nie należy odbudowywać plików ładowania przełącznika, jeśli nie jest to konieczne. Odbudowa pliku ładowania przełącznika jest konieczna TYLKO wtedy, GDY katalog instalacyjny produktu bazy danych ulega zmianie, np. po zainstalowaniu nowej wersji produktu bazy danych. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEKCJA 2: JAK UZYSKAĆ I ZAINSTALOWAĆ TEN PAKIET POPRAWEK ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Wersja produktu/komponentu: 7.0 Nazwa aktualizacji: pakiet poprawek 7.1.0.13 produktu WebSphere MQ 2.1. Położenie pliku do pobrania --------------------- Pakiet poprawek można pobrać z następującego położenia: http://www.ibm.com/support/docview.wss?uid=swg21254675 2.2. Wymagania wstępne i dodatkowe ---------------------------------- Przed pobraniem pakietu poprawek wykonaj następujące kroki: 1. Upewnij się, że system spełnia wszystkie wymagania systemowe: http://www.ibm.com/software/integration/wmq/requirements/index.html To działanie zapobiega wystąpieniu problemów technicznych, które mogą zaistnieć po zainstalowaniu i skonfigurowaniu pakietu poprawek. 2. Przejrzyj uzupełnienia i raporty APAR (Authorized Problem Analysis Reports) w serwisie WWW wsparcia produktu WebSphere MQ dla UNIX(R) i Windows(R): http://www.ibm.com/software/integration/wmq/support/ Raporty APAR opisują defekty usuwane przez pakiet poprawek. Lista raportów APAR dla tego pakietu poprawek jest dostępna pod następującym adresem: http://www.ibm.com/support/docview.wss?uid=swg27014224 3. Upewnij się, że ilość wolnego miejsca w systemie plików jest wystarczająca do pobrania i wyodrębnienia pakietu poprawek. W systemie plików musi być jeden gigabajt wolnego miejsca, aby mógł się w nim zmieścić skompresowany plik i zdekompresowany obraz instalacyjny. 4. Upewnij się, że jest dostępne wolne miejsce wymagane do zainstalowania pakietu poprawek. Wolne miejsce musi być dostępne w położeniu aktualizowanej instalacji produktu WebSphere MQ. Na platformach UNIX w celu określenia ilości miejsca zajmowanego przez istniejące produkty WebSphere MQ można wykonać komendę: du -k -s MQDIR gdzie MQDIR reprezentuje położenie instalacji produktu WebSphere MQ. 5. Jeśli produkt WebSphere MQ 7 jest już zainstalowany i uzyskano poprawki specjalne, skontaktuj się z działem wsparcia IBM(R), aby określić, czy przed zainstalowaniem pakietu poprawek wymagana jest zaktualizowana wersja poprawek. Takie działanie zapewni, że system pozostanie spójny, a poprawki specjalne nie zostaną utracone. 2.3. Instalacja -------------- Przed kontynuowaniem procesu instalacji należy zapoznać się z plikiem readme na stronie WWW, aby sprawdzić, czy informacje nie uległy zmianie od czasu, kiedy pobrano plik readme: https://ibm.biz/mqreadmes 2.3.1. Przed rozpoczęciem instalacji ----------------------------------- Przed zainstalowaniem pakietu poprawek wykonaj następujące kroki: 1. Przeczytaj całą treść tego pliku readme. Zwróć szczególną uwagę na dodatkowe kroki, które są wymagane, jeśli zainstalowano pakiet GSKit, aby produkt WebSphere MQ mógł używać kanałów SSL. 2. Pobierz pakiet poprawek i zapisz go w odpowiednim położeniu. 3. Zdekompresuj pakiet poprawek. 4. Zatrzymaj wszystkie procesy produktu WebSphere MQ i jego aplikacje. 2.3.2. Pobieranie pakietu poprawek do odpowiedniego położenia ------------------------------------------------------------ Ścieżka do katalogu, który ma być używany jako miejsce pobierania i dekompresowania pakietu poprawek, nie może zawierać żadnych spacji. Jeśli ścieżka do katalogu będzie zawierać spacje, instalacja nie powiedzie się. Na przykład należy upewnić się, czy ścieżka do katalogu ma postać zbliżoną do poniższego przykładu: /home/WMQFixPack/FP1/ ... Ścieżka do katalogu nie powinna mieć postaci w rodzaju następującej: /home/WMQ FixPack/FP1/ ... 2.3.3. Dekompresowanie obrazów instalacyjnych pakietu poprawek ------------------------------------------------------------- Wszystkie obrazy instalacyjne pakietu poprawek w serwisie pobierania są skompresowane w formacie gz/Z/zip. Aby można było zastosować pakiet poprawek pobrany w tym formacie, należy skopiować pobrane pliki do katalogu tymczasowego, a następnie trzeba rozpakować obraz instalacyjny pakietu poprawek za pomocą komend gunzip/uncompress i tar. 2.3.4. Rozpakowywanie plików instalacyjnych pakietu poprawek ---------------------------------------------------------- Aby rozpakować pliki instalacyjne pakietu poprawek, wykonaj następujące kroki: 1. Skopiuj obraz w formacie gzip/Z do położenia tymczasowego. 2. Przejdź do katalogu, do którego został skopiowany obraz. 3. Poniżej znajdują się przykładowe komendy służące do wyodrębniania obrazu instalacyjnego pakietu poprawek: gunzip -c nazwa_pliku.tar.gz | tar -xvf - zcat nazwa_pliku.tar.Z | tar -xvf - unzip nazwa_pliku.zip gdzie nazwa_pliku.tar.gz etc. jest nazwą pobieranego pliku. 2.3.5. Zatrzymywanie wszystkich procesów produktu WebSphere MQ ------------------------------------------------------------- Należy się upewnić, że wszystkie procesy produktu WebSphere MQ są zatrzymane i że nie zostaną uruchomione automatycznie podczas procedury instalacji. Aby zatrzymać wszystkie procesy produktu WebSphere MQ, wykonaj następujące kroki: 1. Zaloguj się jako użytkownik w grupie mqm. 2. Użyj komendy endmqm, aby zatrzymać wszystkie działające menedżery kolejek. 3. Zatrzymaj procesy nasłuchujące powiązane z menedżerami kolejek, używając komendy: endmqlsr -m nazwa_menedżera_kolejek 4. Aby sprawdzić, czy zostały zatrzymane wszystkie, wprowadź następującą komendę: ps -ef | grep mq Sprawdź, czy na liście nie ma procesów, które zostały uruchomione za pomocą komend rozpoczynających się od łańcuchów amq lub runmq. Zignoruj te, których nazwy zaczynają się od przedrostka amqi. 5. Wykonaj wszystkie dalsze czynności administracyjne (w razie potrzeby jako administrator), aby zatrzymać wszystkie aplikacje, które używają menedżerów kolejek w systemie, i aby zapobiec ich automatycznemu restartowaniu podczas procedury instalacji. 2.3.6. Instalacja ------------------ Więcej informacji na temat instalowania pakietu poprawek można uzyskać w odpowiedniej sekcji Krótkie wprowadzenie w informacjach o produkcie WebSphere MQ: AIX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10720_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10790_.htm Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10860_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10780_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11230_.htm 2.4. Po zakończeniu instalacji ----------------------------- 2.4.1. Dodatkowe informacje o instalacjach pakietów GSKit i JRE ------------------------------------------------------------ Informacje na temat poziomów pakietów GSKit i JRE dołączonych do tego produktu można uzyskać pod następującym adresem: http://www.ibm.com/support/docview.wss?uid=swg27038676 Wykonywanie czynności wymaganych po zakończeniu instalacji ---------------------------------------------------------- Po zainstalowaniu tego pakietu poprawek wykonaj następujące kroki: 1. Sprawdź instalację. Odpowiednie informacje znajdują się w sekcji Krótkie wprowadzenie w dokumentacji produktu WebSphere MQ dla odpowiedniej platformy. 2. Zrestartuj menedżery kolejek. Rekompilowanie aplikacji po zastosowaniu pakietu poprawek nie jest obowiązkowe. 2.4.2. Dodatkowe informacje o instalacjach pakietów GSKit, JDK, JRE i IA9H (produkt IBM Service Client for .NET) ------------------------------------------------------------------- Informacje na temat poziomów pakietów GSKit i JRE dołączonych do tego produktu można uzyskać pod następującym adresem: http://www.ibm.com/support/docview.wss?uid=swg27038676 2.4.3. Instalowanie pakietu GSKit ----------------------- Informacje o instalowaniu pakietu GSKit zawiera sekcja Krótkie wprowadzenie dokumentacji produktu WebSphere MQ dla odpowiedniej platformy: AIX:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq20040_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10870_.htm Linux:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10980_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10860_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq12150_.htm 2.4.4. Rozwiązywanie problemów dotyczących instalacji za pomocą informacji z serwisu wsparcia -------------------------------------------------------------------------------------------- Przed skontaktowaniem się z działem wsparcia IBM jest zalecane zapoznanie się z informacjami w serwisie WWW pod adresem http://www.ibm.com/support/docview.wss?uid=swg21229861, który udostępnia konkretne porady dotyczące rozwiązywania problemów oraz gromadzenia danych w produkcie WebSphere MQ. 2.5. Deinstalacja ---------------- Więcej informacji na temat usuwania pakietu poprawek można uzyskać w odpowiedniej sekcji Krótkie wprowadzenie w informacjach o produkcie WebSphere MQ: AIX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10740_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10810_.htm Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10880_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10800_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11270_.htm 2.6. Lista poprawek ----------------- Poprawki zawarte w tym pakiecie poprawek: http://www.ibm.com/support/docview.wss?uid=swg27014224 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEKCJA 3: IBM MESSAGE SERVICE CLIENT FOR .NET 2.0.0.13 ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3.1. Zmiany wprowadzone w tej wersji ---------------------------------- Ta wersja klienta XMS .NET została przetestowana pod kątem interakcji z produktem IBM WebSphere MQ 7.0.1.13. Oprócz tego zastosowano kilka poprawek rozwiązujących kwestie, które wynikły podczas przeprowadzanych testów lub znajdowały się w opiniach klientów. Jeśli na komputerze zainstalowano środowisko Microsoft .NET Framework 4.0, konieczne może być utworzenie lub ustawienie klucza rejestru HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework w następujący sposób: "OnlyUseLatestCLR"=dword:00000001 3.2. Rozwiązywanie problemów z klientem XMS .NET -------------------------------- a) Uwierzytelnianie użytkownika dla produktu WebSphere MQ jest wykonywane przy użyciu szczegółowych informacji dotyczących zalogowanego użytkownika, a nie na podstawie informacji podanych w polach XMSC.USERID i XMSC.PASSWORD. Celem tego jest zapewnienie spójności z produktem WebSphere MQ. Szczegółowe informacje o uwierzytelnianiu zawiera Centrum Wiedzy IBM. b) Na 64-bitowej platformie Windows ustawianie lub pobieranie wartości dla właściwości o typie double przy użyciu metody SetDoubleProperty() lub GetDoubleProperty() może nie działać prawidłowo, jeśli te wartości są mniejsze niż Double.Epsilon. Na przykład przy próbie ustawienia wartości 4,9E-324 dla właściwości o typie double na 64-bitowych platformach Windows zostanie ona potraktowana jak 0,0. Czyli w rozproszonym środowisku przesyłania komunikatów, jeśli aplikacja JMS lub inna ustawia wartość 4,9E-324 dla właściwości typu double na komputerze z dowolnym systemem Unix lub 32-bitowym systemem Windows, a klient XMS .NET działa na komputerze z systemem 64-bitowym, wartość zwrócona przez metodę GetDoubleProperty() wynosi 0,0. Jest to znany problem dotyczący środowiska Microsoft .NET 2.0. W celu uzyskania szczegółowych informacji należy kliknąć odsyłacz: http://support.microsoft.com/kb/970495 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEKCJA 4 : PRAWA AUTORSKIE, UWAGI I ZNAKI TOWAROWE ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 4.1 Informacje o prawach autorskich i znakach towarowych --------------------------------------- http://www.ibm.com/legal/copytrade.shtml 4.2 Uwagi ----------- 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 typograficzne. Informacje te są okresowo aktualizowane, a zmiany te zostaną uwzględnione 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. WARUNKI, UWAGI I INFORMACJE DOTYCZĄCE LICENCJI OSÓB TRZECICH Umowa licencyjna dla tego projektu odwołuje się do niniejszego pliku w zakresie szczegółowych warunków mających zastosowanie do kodu oprogramowania osób trzecich zawartego w tym produkcie, jak również w zakresie uwag i innych informacji, które IBM musi udostępnić w ramach swych licencji na określony kod oprogramowania. Odpowiednie warunki, uwagi i inne informacje są udostępnione lub przywołane poniżej. Zwracamy uwagę, że jakakolwiek wersja językowa inna niż angielska jest nieoficjalna i udostępniana jest jedynie dla wygody użytkownika. Angielska wersja poniższych licencji, udostępniana jako część angielskojęzycznej wersji niniejszego pliku, jest wersją oficjalną. Bez względu na stanowiące inaczej warunki jakichkolwiek umów zawartych przez Klienta z IBM lub z podmiotem powiązanym lub afiliowanym IBM (które to strony łącznie zwane są "IBM") określony poniżej kod oprogramowania stanowi "Komponenty Wyłączone" i podlega następujących warunkom: * Komponenty Wyłączone są dostarczane w stanie, w jakim się znajdują "AS IS"; * IBM NIE UDZIELA JAKICHKOLWIEK GWARANCJI, WYRAŹNYCH CZY DOMNIEMANYCH (W TYM RÓWNIEŻ WYŁĄCZA RĘKOJMIĘ), ANI NIE USTALA WARUNKÓW W ZAKRESIE KOMPONENTÓW WYŁĄCZONYCH, A W SZCZEGÓLNOŚCI NIE UDZIELA GWARANCJI NIENARUSZANIA CZY NIEZAKŁÓCANIA PRAW OSÓB TRZECICH, DOMNIEMANYCH GWARANCJI CZY WARUNKÓW PRZYDATNOŚCI HANDLOWEJ I PRZYDATNOŚCI DO OKREŚLONEGO CELU; * IBM nie będzie ponosić odpowiedzialności wobec Klienta za jakiekolwiek roszczenia odnoszące się do Komponentów Wyłączonych ani nie będzie zabezpieczać i chronić Klienta przed nimi; * IBM nie będzie ponosić odpowiedzialności za jakiekolwiek szkody bezpośrednie, pośrednie, uboczne, szczególne, powodujące naruszenie dóbr osobistych, szkody, których nie można było przewidzieć przy zawieraniu umowy, powstałe w odniesieniu do Komponentów Wyłączonych. 4.3 Znaki towarowe -------------- Następujące nazwy są znakami towarowymi International Business Machines Corporation w Stanach Zjednoczonych i/lub w innych krajach: AIX FFST i5/OS IBM MQSeries SupportPac WebSphere z/OS Microsoft i Windows są znakami towarowymi Microsoft Corporation w Stanach Zjednoczonych i/lub w innych krajach. Java oraz wszystkie znaki towarowe i logo dotyczące języka Java są znakami towarowymi lub zastrzeżonymi znakami towarowymi Oracle i/lub przedsiębiorstw afiliowanych Oracle. UNIX jest zastrzeżonym znakiem towarowym The Open Group w Stanach Zjednoczonych i w innych krajach. Linux jest zastrzeżonym znakiem towarowym Linusa Torvaldsa w Stanach Zjednoczonych i/lub w innych krajach. Nazwy innych przedsiębiorstw, produktów lub usług mogą być znakami towarowymi lub znakami usług innych podmiotów.