INTRODUKTION
Der findes et hotfix, der gør det muligt for BizTalk Adapter til TIBCO EMS at understøtte bestilt levering af meddelelser og SSL-forbindelser (Secure Sockets Layer) i Microsoft BizTalk Server 2006 R2 Service Pack 1 (SP1) og BizTalk Server 2009.
Flere oplysninger
Vigtige bemærkninger
-
Sørg for, at Tibco-serveren er installeret og konfigureret korrekt.
-
Sørg for at føje TIBCO EMS C# API (Tibco.ems.dll) til den globale assemblycache (GAC). Det gør du ved at bruge Gacutil.bat program. Du kan finde flere oplysninger i afsnittet "Reference".
-
SSL understøttes i Tibco, der starter med version 4.4.
Aktivér support af levering af bestilt meddelelse
Når du har anvendt hotfixet, er to nye indstillinger tilgængelige på BizTalk-adapteren til dialogboksen TIBCO EMS-transportegenskaber, hvor du kan aktivere understøttelse af levering af bestilt meddelelse. De to muligheder er Bestilt levering og StopPollingOnFailure. Som standard er indstillingen Bestilt levering indstillet til Falsk, og indstillingen StopPollingOnFailure er angivet til Sand.
Mulighed for bestilt levering
Når du angiver indstillingen Bestilt levering til Sand, forventes meddelelserne at blive forespørgt fra Tibco-serveren og at blive sendt til BizTalk Server. Den rækkefølge, som BizTalk-serveren modtager meddelelser i, er den samme som den rækkefølge, meddelelser sendes til Tibco-serveren i.
Bemærk, at de meddelelser, der har højere prioritet i Tibco-køen, er de meddelelser, der forventes at blive forespørgt og sendt til BizTalk forud for meddelelser med lavere prioritet. Du kan ændre prioriteten af en meddelelse ved hjælp af konfigurationsegenskaben for senderen for indstillingen Meddelelsesprioritet.
Indstillingen StopPollingOnFailure
Denne indstilling gælder kun, hvis indstillingen Bestilt levering er angivet til Sand. Denne indstilling bruges til at beslutte, om du vil fortsætte eller stoppe afstemningen, når indsendelse af en meddelelse til BizTalk mislykkes. Hvis indstillingen StopPollingOnFailure er angivet til Sand, og en meddelelse ikke sendes til BizTalk, stopper den modtagelsesport, der bruger BizTalk-adapteren til TIBCO EMS, yderligere afstemninger af meddelelser fra Tibco-serveren, og derefter deaktiveres porten. Hvis indstillingen StopPollingOnFailure er indstillet til Falsk, stoppes afstemningen ikke, selvom indsendelsen af en meddelelse til BizTalk mislykkes. I dette tilfælde flyttes mislykkede meddelelser til en afbrudt kø.
Bemærk, at når indstillingen StopPollingOnFailure er angivet til Falsk, flyttes de meddelelser, der ikke kan sendes til BizTalk, til den afbrudte kø. Denne funktionsmåde medfører et tab af rækkefølge. Vi anbefaler derfor, at du angiver denne indstilling til Sand.
Aktivere understøttelse af SSL-forbindelse
Når du har anvendt hotfixet, er tre nye indstillinger tilgængelige på BizTalk-adapteren til dialogboksen TIBCO EMS-transportegenskaber, som gør det muligt at aktivere understøttelse af SSL-forbindelse. De tre indstillinger er som følger:
-
UseSSL
-
SSLTargetHostName
-
SSLClientSubjectDN
Bemærk som standard er indstillingen UseSSL indstillet til Falsk, og indstillingen SSLTargetHostName og indstillingen SSLClientSubjectDN er tomme.
Vigtigt! For at understøtte SSL-forbindelser skal du konfigurere nogle nødvendige indstillinger på Tibco-serveren og på BizTalk-serveren. Du kan finde flere oplysninger i afsnittet "Nødvendige indstillinger for at understøtte SSL-forbindelse".
Indstillingen UseSSL
Hvis Indstillingen UseSSL er indstillet til Falsk, opretter adapteren forbindelse til Tibco-serveren på TCP-porten. Hvis indstillingen UseSSL er angivet til Sand, opretter kortet forbindelse til Tibco-serveren på SSL-porten.
Bemærk, at Tibco-serveren er konfigureret i feltet "Servernavn" under sektionen serverforbindelsesdefinition. Både TCP-port og SSL-port er konfigureret i feltet Portnummer under afsnittet om definition af serverforbindelse.
Indstillingen SSLTargetHostName Sørg for, at det pålidelige rodcertifikat for Tibco-serveren er installeret i lageret for pålidelige rodnøglecenters for den bruger, hvis konto er konfigureret
for bizTalk-værtsforekomsten.
SSL ClientSubjectDN Denne
indstilling er obligatorisk, hvis tovejs-SSL er nødvendig. Tibco-serveren kræver f.eks., at klienten præsenterer certifikatet. Certifikatet kan aktiveres eller deaktiveres i ssl_require_client_cert for filen Tibemsd.conf. Denne værdi svarer til det entydige emnenavn for klientcertifikatet. Sørg for, at det pålidelige rodcertifikat for Tibco-serveren er installeret i lageret for pålidelige rodnøglecenter for den bruger, hvis konto er konfigureret til bizTalk-værtsforekomsten.
Følgende er en eksempelværdi for denne indstilling:
E=client@testcompany.com, CN=client, OU=client Unit, O=Test Company, L=us-english, S=California, C=US
Nødvendige indstillinger for at understøtte SSL-forbindelse
SSL er en protokol, der giver sikker godkendelse og overfører krypterede data via internettet eller et intranet. Et SSL-handshake mellem klienten (adapteren) og Tibco-serveren kan forekomme på følgende to måder:
-
Envejs-SSL: Klienten behøver ikke at præsentere certifikatet for serveren.
-
Tovejs-SSL: Klienten skal præsentere nøglecentercertifikatet for serveren.
Konfiguration af envejs-SSL
Skift filen Tibemsd.conf på Tibco-serveren. Det kan du gøre ved at følge disse trin:
-
Deaktiver ssl_require_client_cert egenskab. Det gør du ved at ændre denne indstilling, så den vises på følgende måde:
ssl_require_client_cert = deaktiver -
Angiv den ssl_server_identity egenskab, der skal pege på servercertifikatet, angiv egenskaben ssl_server_key til at bruge den korrekte SSL-nøgle, og angiv egenskaben ssl_password til at bruge den korrekte SSL-adgangskode. Det gør du ved at ændre denne indstilling, så de vises på følgende måde:
ssl_server_identity = server.cert.pem
ssl_server_key = server.key.pem ssl_password =<adgangskode>Bemærk, at
.pem-filerne er tilgængelige i den sti, du angiver. -
Gem filen Tibemsd.conf, og start Tibco EMS-serveren.
På BizTalk-serveren skal du installere det pålidelige rodcertifikat for Tibco-serveren i lageret med pålidelige rodnøglecenter for den bruger, hvis konto er konfigureret til bizTalk-værtsforekomsten. Prøv derefter at oprette forbindelse til Tibco-serveren ved hjælp af Tibco-adapteren.
Konfiguration af tovejs-SSL
Skift filen Tibemsd.conf på Tibco-serveren. Det kan du gøre ved at følge disse trin:
-
Aktivér ssl_require_client_cert egenskab. Det gør du ved at ændre denne indstilling, så den vises på følgende måde:
ssl_require_client_cert = aktivér -
Angiv den ssl_server_identity egenskab, der skal pege på servercertifikatet, angiv egenskaben ssl_server_key til at bruge den korrekte SSL-nøgle, og angiv egenskaben ssl_password til at bruge den korrekte SSL-adgangskode. Det gør du ved at ændre denne indstilling, så de vises på følgende måde:
ssl_server_identity = server.cert.pem
ssl_server_key = server.key.pem ssl_password =<adgangskode>Bemærk, at
.pem-filerne er tilgængelige i den sti, du angiver. -
Angiv ssl_server_trusted, der skal pege på rodcertifikatet for nøglecenter for klientcertifikatet. Det gør du ved at ændre denne indstilling, så den vises på følgende måde:
ssl_server_trusted = client.root.cert.pem Bemærk! Sørg for, at
.pem-filerne er tilgængelige i den sti, du
angiver. -
Gem filen Tibemsd.conf, og start Tibco EMS-serveren
På BizTalk-serveren skal du installere det pålidelige rodcertifikat for Tibco-serveren i lageret med pålidelige rodnøglecenter for den bruger, hvis konto er konfigureret til bizTalk-værtsforekomsten. Installér nøglecentercertifikatet for klientcertifikatet i den aktuelle brugers lager til rodnøglecenter, der er tillid til. Installér klientcertifikatet i den aktuelle brugers personlige lager. Prøv derefter at oprette forbindelse til serveren ved hjælp af Tibco-adapteren.
Oplysninger om hotfix
For BizTalk Server 2006 R2 SP1
Hotfixet er inkluderet i den kumulative opdateringspakke 3 til BizTalk Server 2006 R2 SP1.
Du kan finde flere oplysninger om, hvordan du henter den kumulative opdateringspakke, ved at klikke på følgende artikelnummer for at få vist artiklen i Microsoft Knowledge Base:
2286501Kumulativ opdateringspakke 3 til BizTalk Server 2006 R2 Service Pack 1 Du kan finde flere oplysninger om
bizTalk Server 2006 R2 SP1-hotfixes. klik på følgende artikelnummer for at få vist artiklen i
Microsoft Knowledge Base:
974563Liste over Microsoft BizTalk Server-genvejsrettelser, der er inkluderet i BizTalk Server 2006 R2 Service Pack 1
For BizTalk Server 2009
Hotfixet, der løser dette problem, er inkluderet i den kumulative opdateringspakke 2 til BizTalk Server 2009.
Du kan finde flere oplysninger om, hvordan du henter den kumulative opdateringspakke, ved at klikke på følgende artikelnummer for at få vist artiklen i Microsoft Knowledge Base:
2497794 Kumulativ opdateringspakke 2 til BizTalk Server 2009 Et understøttet hotfix fås nu fra
Microsoft. Det er dog kun hensigten at rette det problem, der er beskrevet i denne artikel. Anvend den kun på systemer, der oplever dette specifikke problem. Dette hotfix kan modtage yderligere test. Hvis du ikke er alvorligt påvirket af dette problem, anbefaler vi derfor, at du venter på den næste softwareopdatering, der indeholder dette hotfix.
Du kan løse problemet med det samme ved at kontakte Microsofts kundesupporttjenester for at få hotfixet. Hvis du vil se en komplet liste over microsoft-kundesupporttjenesters telefonnumre og oplysninger om supportomkostninger, skal du besøge følgende Microsoft-websted:
http://support.microsoft.com/contactus/?ws=supportBemærk i særlige tilfælde kan gebyrer, der normalt påløber for supportopkald, blive annulleret, hvis en Microsoft Supportmedarbejder afgør, at en bestemt opdatering vil løse problemet. De sædvanlige supportomkostninger gælder for supplerende supportspørgsmål og -problemer, der ikke falder ind under den omtalte opdatering.
Forudsætninger
Du skal have Microsoft BizTalk Server 2009 og Microsoft BizTalk Adapter til Enterprise Applications (også kaldet BizTalk LOB-adapter) installeret for at anvende dette hotfix.
Genstartskrav
Du behøver ikke at genstarte computeren, når du har installeret hotfixet.
Oplysninger om udskiftning af hotfix
Dette hotfix erstatter ikke andre hotfixes.
Filoplysninger
Den engelske version af dette hotfix indeholder de filattributter (eller nyere filattributter), der er angivet i følgende tabel. Dato og klokkeslæt for disse filer er angivet i UTC (Coordinated Universal Time). Når du får vist filoplysningerne, konverteres de til lokal tid. Du kan finde forskellen mellem UTC og lokal tid ved at bruge fanen Tidszone i elementet Dato og klokkeslæt i Kontrolpanel.
Filnavn |
Filversion |
Filstørrelse |
Dato |
Klokkeslæt |
Platform |
---|---|---|---|---|---|
Btcore.dll |
1.0.5020.12 |
2,129,744 |
26-apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.bizutil.dll |
1.0.5020.12 |
163,720 |
26-apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.corereceiver.dll |
1.0.5020.12 |
33,680 |
26-apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.coretransmitter.dll |
1.0.5020.12 |
39,320 |
26-apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.tibcoems.dll |
1.0.5020.12 |
88,968 |
26-apr-2010 |
12:16 |
x86 |
Status
Microsoft har bekræftet, at problemet findes i de Microsoft-produkter, der er angivet i afsnittet "Gælder for".
Referencer
Du kan finde flere oplysninger om TIBCO Enterprise Message Service på følgende websted for Microsoft Developer Network (MSDN):
Krav og begrænsninger for TIBCO Enterprise-meddelelsestjenesteDu kan finde flere oplysninger om bestilt levering af meddelelser på følgende MSDN-websted:
Bestilt levering af meddelelserDu kan finde flere oplysninger om hotrettelser til BizTalk Server ved at klikke på følgende artikelnummer for at få vist artiklen i Microsoft Knowledge Base:
2003907 Oplysninger om hotfixes til BizTalk Server