Inleiding
Er is een hotfix beschikbaar waarmee BizTalk Adapter voor TIBCO EMS bestelde berichtlevering en SSL-verbindingen (Secure Sockets Layer) kan ondersteunen in Microsoft BizTalk Server 2006 R2 Service Pack 1 (SP1) en BizTalk Server 2009.
Meer informatie
Belangrijke notities
-
Zorg ervoor dat de Tibco-server goed is geïnstalleerd en geconfigureerd.
-
Zorg ervoor dat u de TIBCO EMS C#-API (Tibco.ems.dll) toevoegt aan de Global Assembly Cache (GAC). Gebruik hiervoor de Gacutil.bat toepassing. Zie de sectie'Verwijzing'voor meer informatie.
-
SSL wordt ondersteund in Tibco die begint met release 4.4.
Ondersteuning voor berichtbezorging inschakelen
Nadat u de hotfix hebt toegepast, zijn er twee nieuwe opties beschikbaar in het dialoogvenster BizTalk Adapter for TIBCO EMS-transporteigenschappen waarmee u de ondersteuning van berichtbezorging via bestelling kunt inschakelen. De twee opties zijn Bestellingsbezorging en StopPollingOnFailure. De optie Bestelde bezorging is standaard ingesteld op Onwaar en de optie StopPollingOnFailure is ingesteld op Waar.
Optie voor bestelde bezorging
Wanneer u de optie Voorbezorging besteld instelt op Waar, worden de berichten naar verwachting gepeild vanaf de Tibco-server en verzonden naar BizTalk Server. De volgorde waarin BizTalk-server berichten ontvangt, is dezelfde als de volgorde waarin berichten naar de Tibco-server worden verzonden.
Let op: De berichten met een hogere prioriteit in de Tibco-wachtrij zijn de berichten die naar verwachting worden peild en worden verzonden naar BizTalk voor de berichten met een lagere prioriteit. U kunt de prioriteit van een bericht wijzigen met behulp van de configuratie-eigenschap van de configuratie van het bericht van de optie Berichtprioriteit.
Optie StopPollingOnFailure
Deze optie is alleen van toepassing als de optie Bestelde bezorging is ingesteld op Waar. Deze optie wordt gebruikt om te bepalen of u de peiling wilt voortzetten of stoppen wanneer de inzending van een bericht bij BizTalk mislukt. Als de optie StopPollingOnFailure is ingesteld op Waar en er geen bericht wordt verzonden naar BizTalk, stopt de ontvangstpoort die gebruikmaakt van de BizTalk Adapter voor TIBCO EMS het extra peilen van de berichten van de Tibco-server, en wordt de poort uitgeschakeld. Als de optie StopPollingOnFailure is ingesteld op Onwaar, wordt de peiling niet gestopt, ook niet als de inzending van een bericht bij BizTalk mislukt. In dit geval worden mislukte berichten verplaatst naar een opgeschorte wachtrij.
Opmerking Wanneer de optie StopPollingOnFailure is ingesteld op False, worden de berichten die niet bij BizTalk kunnen worden ingediend, verplaatst naar de wachtrij. Dit gedrag veroorzaakt een verlies van volgorde. U wordt daarom aangeraden deze optie in te stellen op Waar.
De ondersteuning van SSL-verbinding inschakelen
Nadat u de hotfix hebt toegepast, zijn er drie nieuwe opties beschikbaar in het dialoogvenster Transporteigenschappen van BizTalk Adapter voor TIBCO EMS waarmee u de ondersteuning van SSL-verbinding kunt inschakelen. De drie opties zijn als volgt:
-
UseSSL
-
SSLTargetHostName
-
SSLClientSubjectDN
Opmerking De optie UseSSL is standaard ingesteld op Onwaar en de optie SSLTargetHostName en de optie SSLClientSubjectDN zijn leeg.
Belangrijk Om SSL-verbindingen te ondersteunen, moet u enkele benodigde instellingen configureren op de Tibco-server en op de BizTalk-server. Zie de sectie Noodzakelijke instellingen voor het ondersteunen van SSL-verbinding voor meer informatie.
OptieSSL gebruiken
Als de optie UseSSL is ingesteld op Onwaar, maakt de adapter verbinding met de Tibco-server op de TCP-poort. Als de optie UseSSL is ingesteld op Waar, maakt de adapter verbinding met de Tibco-server op de SSL-poort.
Let op: de Tibco-server is geconfigureerd in het veld Servernaam onder de sectie serververbindingsdefinitie. Zowel de TCP-poort als de SSL-poort zijn geconfigureerd in het veld Poortnummer onder de sectie Serververbindingsdefinitie.
Optie SSLTargetHostName Zorg ervoor dat het vertrouwde hoofdcertificaat van de Tibco-server is geïnstalleerd in het winkel van de vertrouwde basiscertificeringsinstanties van de gebruiker van wie het account is geconfigureerd voor het
host-exemplaar bizTalk.
SSL ClientSubjectDN-optie Deze optie is verplicht als SSL in tweeweg
is vereist. De Tibco-server vereist bijvoorbeeld dat de client het certificaat presenteert. Het certificaat kan worden in- of uitgeschakeld in ssl_require_client_cert eigenschap van het tibemsd.conf-bestand. Deze waarde komt overeen met de DSN-naam van het clientcertificaat. Zorg ervoor dat het vertrouwde basiscertificaat van de Tibco-server is geïnstalleerd in de winkel van de vertrouwde basiscertificeringsinstanties van de gebruiker van wie het account is geconfigureerd voor het host-exemplaar BizTalk.
Hier volgt een voorbeeldwaarde voor deze optie:
E=client@testcompany.com, CN=client, OU=client Unit, O=Test Company, L=us-english, S=California, C=US
Benodigde instellingen voor het ondersteunen van SSL-verbinding
SSL is een protocol dat beveiligde verificatie biedt en versleutelde gegevens verzendt via internet of een intranet. Een SSL-handshake tussen de client (Adapter) en de Tibco-server kan op de volgende twee manieren voorkomen:
-
SSL in één manier: De client hoeft het certificaat niet aan de server te presenteren.
-
SSL in tweeweg: de client moet het certificaat van de certificeringsverklaring aan de server presenteren.
SSL in één manier configureren
Wijzig op de Tibco-server het bestand Tibemsd.conf. Ga hiervoor als volgt te werk:
-
Schakel de eigenschap ssl_require_client_cert uit. U doet dit door deze instelling zo te wijzigen dat deze als volgt wordt weergegeven:
ssl_require_client_cert = uitschakelen -
Stel de ssl_server_identity-eigenschap in op het servercertificaat, stel de eigenschap ssl_server_key in op het gebruik van de juiste SSL-sleutel en stel de eigenschap ssl_password in op het juiste SSL-wachtwoord. Hiervoor wijzigt u deze instelling zodat deze als volgt worden weergegeven:
ssl_server_identity = server.cert.pem
ssl_server_key = server.key.pem
ssl_password =<-wachtwoord>Zorg ervoor dat de
PEM-bestanden beschikbaar zijn in het pad dat u instelt. -
Sla het bestand Tibemsd.conf op en start de Tibco EMS-server.
Installeer op de BizTalk-server het vertrouwde hoofdcertificaat van de Tibco-server in de winkel van de vertrouwde basiscertificeringsinstanties van de gebruiker van wie het account is geconfigureerd voor het host-exemplaar BizTalk. Probeer vervolgens verbinding te maken met de Tibco-server via de Tibco-adapter.
Tweeweg-SSL configureren
Wijzig op de Tibco-server het bestand Tibemsd.conf. Ga hiervoor als volgt te werk:
-
Schakel de eigenschap ssl_require_client_cert in. U doet dit door deze instelling zo te wijzigen dat deze als volgt wordt weergegeven:
ssl_require_client_cert = inschakelen -
Stel de ssl_server_identity-eigenschap in op het servercertificaat, stel de eigenschap ssl_server_key in op het gebruik van de juiste SSL-sleutel en stel de eigenschap ssl_password in op het juiste SSL-wachtwoord. Hiervoor wijzigt u deze instelling zodat deze als volgt wordt weergegeven:
ssl_server_identity = server.cert.pem
ssl_server_key = server.key.pem ssl_password =<-wachtwoord>Zorg ervoor dat de
PEM-bestanden beschikbaar zijn in het pad dat u instelt. -
Stel de ssl_server_trusted zo in dat deze naar het basiscertificaat voor de certificerings- of certificeringsverklaring van het clientcertificaat wijzen. Hiervoor wijzigt u deze instelling zodat deze als volgt wordt weergegeven:
ssl_server_trusted = client.root.cert.pem Let op: de
PEM-bestanden zijn beschikbaar in het pad dat u hebt
ingesteld. -
Sla het bestand Tibemsd.conf op en start de Tibco EMS-server
Installeer op de BizTalk-server het vertrouwde hoofdcertificaat van de Tibco-server in de winkel van de vertrouwde basiscertificeringsinstanties van de gebruiker van wie het account is geconfigureerd voor het host-exemplaar BizTalk. Installeer het certificaat voor de certificeringsinstantie van het clientcertificaat in de winkel van de vertrouwde basiscertificeringsinstanties van de huidige gebruiker. Installeer het clientcertificaat in de persoonlijke winkel van de huidige gebruiker. Probeer vervolgens verbinding te maken met de server via de Tibco-adapter.
Hotfix-informatie
Voor BizTalk Server 2006 R2 SP1
De hotfix is opgenomen in cumulatieve updatepakket 3 voor BizTalk Server 2006 R2 SP1.
Voor meer informatie over het verkrijgen van het cumulatieve updatepakket, klikt u op het volgende artikelnummer om het artikel te bekijken in de Microsoft Knowledge Base:
2286501Cumulative update package 3 for BizTalk Server 2006 R2 Service Pack 1 For more information about BizTalk Server 2006 R2 SP1 hotfixes, klik op het volgende artikelnummer om het artikel te bekijken in de
Microsoft Knowledge Base:
974563List of Microsoft BizTalk Server hot fixes that are included in BizTalk Server 2006 R2 Service Pack 1
Voor BizTalk Server 2009
De hotfix om dit probleem op te lossen is opgenomen in cumulatieve updatepakket 2 voor BizTalk Server 2009.
Voor meer informatie over het verkrijgen van het cumulatieve updatepakket, klikt u op het volgende artikelnummer om het artikel te bekijken in de Microsoft Knowledge Base:
2497794 Cumulatieve updatepakket 2 voor BizTalk Server 2009 Een ondersteunde hotfix is nu beschikbaar bij
Microsoft. Het is echter alleen bedoeld om het probleem te corrigeren dat in dit artikel wordt beschreven. Alleen toepassen op systemen die dit specifieke probleem ondervinden. Voor deze hotfix kunnen aanvullende tests worden uitgevoerd. Als u niet ernstig door dit probleem wordt getroffen, is het raadzaam te wachten op de volgende software-update met deze hotfix.
Neem contact op met de klantenservice van Microsoft om de hotfix op te halen om dit probleem direct op te lossen. Ga naar de volgende Microsoft-website voor een volledige lijst met telefoonnummers en informatie over ondersteuningskosten van Microsoft-klantenservice:
http://support.microsoft.com/contactus/?ws=supportOpmerking In speciale gevallen kunnen kosten die gewoonlijk worden gemaakt voor ondersteuningsoproepen worden geannuleerd als door Microsoft Support Professional wordt bepaald dat het probleem wordt opgelost met een specifieke update. De normale ondersteuningskosten blijven gelden voor extra ondersteuningsvragen die niet in aanmerking komen voor de specifieke update.
Vereisten
Microsoft BizTalk Server 2009 en Microsoft BizTalk Adapter for Enterprise Applications (ook wel bekend als BizTalk LOB Adapter) moeten zijn geïnstalleerd om deze hotfix toe te passen.
Vereiste voor opnieuw opstarten
U hoeft de computer niet opnieuw op te starten nadat u de hotfix hebt toegepast.
Hotfix-vervangende informatie
Deze hotfix vervangt geen andere hotfixes.
Bestandsgegevens
De Engelse versie van deze hotfix heeft de bestandskenmerken (of latere bestandskenmerken) die in de volgende tabel worden vermeld. De datums en tijden voor deze bestanden worden vermeld in Coordinated Universal Time (UTC). Wanneer u de bestandsgegevens bekijkt, wordt deze geconverteerd naar lokale tijd. Als u het verschil tussen UTC en de lokale tijd wilt vinden, gebruikt u het tabblad Tijdzone in het onderdeel Datum en tijd in het Configuratiescherm.
Bestandsnaam |
Bestandsversie |
Bestandsgrootte |
Datum |
Tijd |
Platform |
---|---|---|---|---|---|
Btcore.dll |
1.0.5020.12 |
2,129,744 |
26-04-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.bizutil.dll |
1.0.5020.12 |
163,720 |
26-04-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.corereceiver.dll |
1.0.5020.12 |
33,680 |
26-04-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.coretransmitter.dll |
1.0.5020.12 |
39,320 |
26-04-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.tibcoems.dll |
1.0.5020.12 |
88,968 |
26-04-2010 |
12:16 |
x86 |
Status
Microsoft heeft bevestigd dat dit probleem zich kan voordoen in de Microsoft-producten die worden vermeld in de sectie Van toepassing op.
Verwijzingen
Ga naar de volgende MSDN-website (Microsoft Developer Network) voor meer informatie over de TIBCO Enterprise Message Service:
Vereisten en beperkingen van de TIBCO-berichtenservice voor ondernemingenGa naar de volgende MSDN-website voor meer informatie over geordende bezorging van berichten:
Berichtbezorging geordendKlik op het volgende artikelnummer voor meer informatie over hotfixes voor BizTalk Server om het artikel in de Microsoft Knowledge Base te bekijken:
2003907 Informatie over bizTalk Server-hotfixes