IBM Integration Bus 9.0.0, Administering: IBM Integration Bus 9.0.0 Administering

912 Pages·2014·4.51 MB·English

IBM Integration Bus 9.0.0
Version 1 Release 0
IBM Integration Bus 9.0.0
Administering
(cid:1)(cid:2)(cid:3)
Note
Beforeusingthisinformationandtheproductitsupports,readtheinformationin“Notices”onpage895.
WhenyousendinformationtoIBM,yougrantIBManonexclusiverighttouseordistributetheinformationinany
wayitbelievesappropriatewithoutincurringanyobligationtoyou.
©CopyrightIBMCorporation1999,2014.
USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContract
withIBMCorp.
PDF books and IBM Knowledge Center
PDF books are provided as a convenience for printing and offline reading. For the
latest information, see the online product documentation in IBM® Knowledge
Center.
The PDF documentation is updated less frequently than the online product
documentation in IBM Knowledge Center.
Links to product documentation topics outside this PDF book go to the online
product documentation in IBM Knowledge Center. Links to targets outside a PDF
book are marked by icons that indicate whether the target is a PDF book or a web
page.
Table1.Iconsthatprefixlinkstotopicsoutsidethisbook
Icon Description
AlinktoapageintheonlineproductdocumentationinIBMKnowledgeCenter.
Figure1.
Alinktoawebpage.
Figure2.
AlinktoaPDFbook.
Figure3.
©CopyrightIBMCorp.1999,2014 iii
iv IBMIntegrationBus9.0.0,Administering: IBMIntegrationBus9.0.0Administering
Contents
PDF books and IBM Knowledge Center iii Navigatingbrokersandbrokerresourcesina
CMPapplication. . . . . . . . . . . . 80
Figures. . . . . . . . . . . . . . . ix DeployingresourcestoabrokerfromaCMP
application . . . . . . . . . . . . . 87
Settingmessageflowuser-definedpropertiesat
Chapter 1. Administering brokers and
runtimeinaCMPapplication . . . . . . . 90
broker resources. . . . . . . . . . . 1
Workingwithpropertiesofaconfigurableservice
Managingbrokers . . . . . . . . . . . . 2 oftypeUserDefinedatruntimeina
Connectingtoalocalbroker . . . . . . . . 3 JavaComputenode. . . . . . . . . . . 92
Connectingtoaremotebroker . . . . . . . 4 ManagingbrokersinaCMPapplication. . . . 94
Connectingtoaremoteintegrationnodeonz/OS 6 ManagingbrokersfromJavaComputenodes . . 102
Importingintegrationnodedefinitionsintothe WorkingwithresourcestatisticsinaCMP
IBMIntegrationExplorer . . . . . . . . . 8 application . . . . . . . . . . . . . 103
Exportingintegrationnodeconnectiondetails WorkingwithActivitylogsinaCMP
fromtheIBMIntegrationExplorer. . . . . . 10 application . . . . . . . . . . . . . 105
Automaticallyreconnectingtoabroker . . . . 11 RecordingandreplayingdatawithaCMP
Disconnectingfromanintegrationnodeinthe application . . . . . . . . . . . . . 107
IBMIntegrationExplorer. . . . . . . . . 12 SubmittingbatchrequestsfromaCMP
UsingtheAdministrationQueue . . . . . . 12 application . . . . . . . . . . . . . 109
Groupingintegrationnodesbyusingintegration ExamplesofIBMIntegrationAPIcode . . . . 110
sets . . . . . . . . . . . . . . . . 13 Administeringbrokersusingthewebuserinterface 127
Startingandstoppingabroker . . . . . . . 19 Configuringthewebuserinterfaceserver. . . 128
Viewingbrokerproperties . . . . . . . . 26 Enablinganddisablingthewebuserinterface 131
StartingaWebSphereMQqueuemanagerasa Accessingthewebuserinterface . . . . . . 133
Windowsservice . . . . . . . . . . . 27 Customizingthedataviewer . . . . . . . 135
StoppingaWebSphereMQqueuemanagerwhen AdministeringintegrationnodesfromWebSphere
youstopabroker . . . . . . . . . . . 28 ApplicationServer . . . . . . . . . . . 136
Deletingabroker . . . . . . . . . . . 29 Managingresourcesusedbybrokers . . . . . 137
Managingintegrationservers . . . . . . . . 34 Listingdatabaseconnectionsthatthebroker
Creatinganintegrationserver . . . . . . . 35 holds . . . . . . . . . . . . . . . 137
RenaminganintegrationserverusingtheIBM Quiescingadatabase. . . . . . . . . . 138
IntegrationExplorer . . . . . . . . . . 40 UsingaJDBCconnectionpooltomanage
StartinganintegrationserverusingtheIBM databaseresourcesusedbyanintegrationserver 139
IntegrationToolkitorIBMIntegrationExplorer . 41 Managingdatacaching . . . . . . . . . 141
StoppinganintegrationserverusingtheIBM AdministeringJavaapplications . . . . . . . 186
IntegrationToolkitorIBMIntegrationExplorer . 43 TuningJVMparameters. . . . . . . . . 187
Deletinganintegrationserver . . . . . . . 45 ConfiguringclassloadersforJavauser-defined
Managingmessageflows. . . . . . . . . . 50 nodes . . . . . . . . . . . . . . . 187
Settingthestartmodeofflowsandapplications ConfiguringclassloadersforJavaCompute
atruntime . . . . . . . . . . . . . 50 nodes . . . . . . . . . . . . . . . 187
StartingamessageflowbyusingtheIBM ConfiguringclassloadersforESQLroutines . . 188
IntegrationToolkitorIBMIntegrationExplorer . 53 ManagingJMSresources . . . . . . . . . 189
StoppingamessageflowusingtheIBM UnderstandingbehaviorusingActivitylog . . 189
IntegrationToolkitorIBMIntegrationExplorer . 54 Usingconfigurableservices. . . . . . . . 189
DeletingamessageflowusingtheIBM MonitoringJMSresourcestatistics . . . . . 189
IntegrationToolkitorIBMIntegrationExplorer . 55 AccessingAdministrationloginformation. . . . 190
Settinguser-definedpropertiesdynamicallyat ViewingAdministrationloginformation . . . 190
runtimeusingtheIBMIntegrationExplorer . . 56 SavingAdministrationloginformation. . . . 192
DevelopingapplicationsthatusetheIBM ClearingAdministrationloginformation . . . 193
IntegrationAPI . . . . . . . . . . . . . 58 ChangingAdministrationLogviewpreferences 194
TheIBMIntegrationAPI . . . . . . . . . 59 Changingthelocationoftheworkpath . . . . 194
TheIBMIntegrationAPIsamples . . . . . . 60 Changingthelocationoftheworkpathon
Configuringanenvironmentfordevelopingand Windowssystems . . . . . . . . . . . 195
runningCMPapplications . . . . . . . . 72 Changingthelocationoftheworkpathon
ConnectingtoabrokerfromaCMPapplication 79 LinuxandUNIXsystems . . . . . . . . 195
Backingupresources. . . . . . . . . . . 196
©CopyrightIBMCorp.1999,2014 v
Backingupthebroker . . . . . . . . . 197 Enablingsecurityforrecordandreplay. . . . 598
Restoringthebroker . . . . . . . . . . 198 Recordingdata. . . . . . . . . . . . 601
BackinguptheIBMIntegrationExplorerand Viewingrecordeddata . . . . . . . . . 616
IBMIntegrationToolkitworkspace . . . . . 200 Replayingdata. . . . . . . . . . . . 618
Usingmultiplebrokersforrecordandreplay 620
Chapter 2. Security . . . . . . . . . 203 UsingActivitylogs . . . . . . . . . . . 623
Securityoverview. . . . . . . . . . . . 203 Activitylogoverview . . . . . . . . . 624
Authorizationforconfigurationtasks . . . . 205 WorkingwithActivitylogsinIBMIntegration
Securityexits . . . . . . . . . . . . 205 Explorer . . . . . . . . . . . . . . 625
Publickeycryptography . . . . . . . . 206 Viewingandsettingruntimepropertiesfor
Activitylogs. . . . . . . . . . . . . 630
Digitalcertificates. . . . . . . . . . . 208
WritingActivitylogstofiles . . . . . . . 632
Digitalsignatures . . . . . . . . . . . 212
Workloadmanagement . . . . . . . . . . 633
Administrationsecurity . . . . . . . . . . 213
Configureamessageflowtocausenotification
Administrationsecurityoverview . . . . . 214
thresholdmessagestobepublished . . . . . 634
Settingupadministrationsecurity . . . . . 221
Settingthemaximumrateforamessageflow 637
Activatingbrokeradministrationsecurityfor
Unresponsivemessageflows . . . . . . . 639
WebSphereMQVersion7.1,orlater. . . . . 241
Configureaworkloadmanagementpolicy
Messageflowsecurity . . . . . . . . . . 242
withinIntegrationRegistry. . . . . . . . 644
Messageflowsecurityoverview . . . . . . 243
Settingupmessageflowsecurity. . . . . . 292
IntegrationBusserversecurity . . . . . . . 396 Chapter 4. Troubleshooting and
CreatinguserIDs . . . . . . . . . . . 397 support . . . . . . . . . . . . . . 647
SecurityfortheIBMIntegrationToolkitand Troubleshootingoverview . . . . . . . . . 647
IBMIntegrationExplorer . . . . . . . . 398 Recordingthesymptomsoftheproblem . . . 648
Consideringsecurityforabroker. . . . . . 407 Re-creatingtheproblem. . . . . . . . . 648
ConfiguringbrokeruserIDsonz/OS . . . . 409 Eliminatingpossiblecauses. . . . . . . . 648
IntegrationserveruserIDsonz/OS. . . . . 411 Makinginitialchecks. . . . . . . . . . . 650
SpecifyinganalternativeuserIDtorunan HasIBMIntegrationBusrunsuccessfully
integrationserveronz/OS. . . . . . . . 413 before? . . . . . . . . . . . . . . 650
ImplementingSSLauthentication. . . . . . 415 DidyoulogoffWindowswhileIBMIntegration
Buscomponentswereactive? . . . . . . . 651
Chapter 3. Performance, monitoring, AretheLinuxandUNIXenvironmentvariables
and workload management . . . . . 449 setcorrectly? . . . . . . . . . . . . 652
Performance. . . . . . . . . . . . . . 450 Arethereanyerrormessagesorreturncodes
thatexplaintheproblem? . . . . . . . . 653
Performanceplanning . . . . . . . . . 451
Canyouseeallofyourfilesandfolders? . . . 654
Messageflowdesignandperformance . . . . 453
Canyoureproducetheproblem?. . . . . . 654
Codedesignandperformance. . . . . . . 455
Hasthemessageflowrunsuccessfullybefore? 656
Analyzingmessageflowperformance . . . . 469
Haveyoumadeanychangessincethelast
Tuningmessageflowperformance . . . . . 510
successfulrun?. . . . . . . . . . . . 657
Analyzingresourceperformance . . . . . . 529
Isthereaproblemwithdescriptivetextfora
Subscribingtostatisticsreports . . . . . . 542
command? . . . . . . . . . . . . . 658
Tuningthebroker. . . . . . . . . . . 543
Isthereaproblemwithadatabase?. . . . . 659
TuningtheSAPadapterforscalabilityand
Isthereaproblemwiththenetwork? . . . . 660
performance. . . . . . . . . . . . . 558
Doestheproblemaffectallusers? . . . . . 661
TuningSOAPprocessingforscalabilityand
Haveyourecentlychangedapassword? . . . 661
performance. . . . . . . . . . . . . 559
Haveyouappliedanyserviceupdates? . . . 662
Troubleshootingperformanceproblems. . . . 560
Doyouhaveacomponentthatisrunning
Business-levelmonitoring . . . . . . . . . 565
slowly? . . . . . . . . . . . . . . 663
Monitoringoverview. . . . . . . . . . 567
Additionalchecksforz/OSusers . . . . . 664
Configuringmonitoringeventsourcesusing
Dealingwithproblems . . . . . . . . . . 666
monitoringproperties . . . . . . . . . 575
Resolvingproblemswheninstalling. . . . . 667
Configuringmonitoringeventsourcesusinga
monitoringprofile. . . . . . . . . . . 580 Resolvingproblemswhenuninstalling . . . . 675
Activatingmonitoring . . . . . . . . . 583 Resolvingproblemsthatoccurwhenmigrating
orimportingresources . . . . . . . . . 676
Enablinganddisablingeventsources . . . . 585
Resolvingproblemswhenrunningcommands 679
MonitoringflowsbyusingWebSphereBusiness
Monitor . . . . . . . . . . . . . . 587 Resolvingproblemswhenrunningsamples . . 681
Reportingmonitoringsettings. . . . . . . 593 Resolvingproblemswhencreatingresources 685
Recording,viewing,andreplayingdata . . . . 595 Resolvingproblemswhenrenamingresources 687
Recordandreplay. . . . . . . . . . . 597 Resolvingproblemsthatoccurwhenyoustart
resources. . . . . . . . . . . . . . 688
vi IBMIntegrationBus9.0.0,Administering: IBMIntegrationBus9.0.0Administering
Resolvingproblemswhenstoppingresources 705 Formattingtrace . . . . . . . . . . . 856
Resolvingproblemswhendeletingresources 707 Interpretingtrace . . . . . . . . . . . 859
Resolvingproblemswhendevelopingmessage Clearingoldinformationfromtracefiles . . . 861
flows . . . . . . . . . . . . . . . 708 ChangingtracesettingsfromtheIBM
Resolvingproblemswhendeployingmessage IntegrationExplorer . . . . . . . . . . 862
flowsormessagesets . . . . . . . . . 752 ODBCtrace . . . . . . . . . . . . . 864
Resolvingproblemsthatoccurwhendebugging IBMIntegrationAPI(CMP)trace. . . . . . 867
messageflows . . . . . . . . . . . . 768 SwitchingTracenodesonandoff . . . . . 868
Resolvingproblemswhendevelopingmessage Usingdumpsandabendfiles . . . . . . . . 871
models . . . . . . . . . . . . . . 775 Checkingfordumps . . . . . . . . . . 872
Resolvingproblemswhenusingmessages. . . 782 UsingtheDUMPcommandonz/OS . . . . 873
Resolvingproblemswhenyouarewriting Checkingforabendfiles. . . . . . . . . 875
businessrules . . . . . . . . . . . . 796 ContactingyourIBMSupportCenter . . . . . 876
ResolvingproblemswhenyouusetheIBM IBMSupportAssistantDataCollector . . . . . 879
IntegrationToolkit. . . . . . . . . . . 797 CollectingdatainconsolemodewithIBM
ResolvingproblemswhenusingtheIBM SupportAssistantDataCollector. . . . . . 880
IntegrationExplorer . . . . . . . . . . 806 SelectingaproblemcollectorforIBMSupport
ResolvingproblemswhenusingDataAnalysis 808 AssistantDataCollector. . . . . . . . . 881
Resolvingproblemswhenusingdatabases . . 809 Searchingknowledgebases. . . . . . . . . 882
Resolvingproblemswhenusing Gettingproductfixes. . . . . . . . . . . 883
publish/subscribe. . . . . . . . . . . 819 ContactingIBMSoftwareSupport . . . . . . 885
Resolvingproblemswithperformance . . . . 823 Determinetheeffectoftheproblemonyour
Resolvingproblemswhenyoumonitormessage business . . . . . . . . . . . . . . 885
flows . . . . . . . . . . . . . . . 827 Describeyourproblemandgatherbackground
ResolvingproblemswhendevelopingCMP information . . . . . . . . . . . . . 886
applications . . . . . . . . . . . . . 828 SubmityourproblemtoIBMSoftwareSupport 886
Resolvingproblemswithuser-defined Recoveringafterfailure . . . . . . . . . . 887
extensions . . . . . . . . . . . . . 829 Recoveringafterthebrokerfails . . . . . . 888
Resolvingproblemswhenyouconvert Recoveringafteranintegrationserverfails . . 889
WebSphereEnterpriseServiceBusresources . . 835 Recoveringafterthebrokerqueuemanagerfails 890
Usinglogs . . . . . . . . . . . . . . 839 Diagnosticmessages . . . . . . . . . . . 891
Windows:Viewingthelocalerrorlog . . . . 840 Diagnosticmessages:Runtimecomponents . . 891
LinuxandUNIXsystems:Configuringthe Diagnosticmessages:IBMIntegrationToolkit 891
syslogdaemon . . . . . . . . . . . . 841 Diagnosticmessages:WebSphereAdapters . . 892
z/OS:Viewingbrokerjoblogs. . . . . . . 843
ViewingtheEclipseerrorlog . . . . . . . 844 Notices . . . . . . . . . . . . . . 895
Usingtrace . . . . . . . . . . . . . . 845
Programminginterfaceinformation . . . . . . 897
Startingservicetrace . . . . . . . . . . 847
Trademarks . . . . . . . . . . . . . . 897
Checkingservicetraceoptions. . . . . . . 849
Changingservicetraceoptions . . . . . . 851
Sending your comments to IBM . . . 899
Stoppingservicetrace . . . . . . . . . 852
Retrievingservicetrace . . . . . . . . . 854
Contents vii
viii IBMIntegrationBus9.0.0,Administering: IBMIntegrationBus9.0.0Administering
Figures
1. . . . . . . . . . . . . . . . . iii 14. Thisdiagramshowshowaclient
2. . . . . . . . . . . . . . . . . iii authenticatesaserver,andisdescribedinthe
3. . . . . . . . . . . . . . . . . iii precedingtext. . . . . . . . . . . . 211
4. Graphicshowingtheplacementoftheglobal 15. Thisdiagramillustratesmutual
cacheinamulti-brokerenvironment. . . . 144 authentication,andisdescribedinthe
5. Graphicshowingtheplacementoftheglobal precedingtext. . . . . . . . . . . . 211
cacheinamulti-brokerenvironment. . . . 145 16. Diagramshowingtheeightidentity
6. Graphicshowingtheplacementoftheglobal properties. . . . . . . . . . . . . 251
cacheinamulti-brokerenvironment. . . . 146 17. Diagramshowingtheflowofidentity
7. Graphicshowingtheplacementoftheglobal authentication. . . . . . . . . . . . 258
cacheinamultipleclientscenario. . . . . 147 18. Diagramshowingidentityauthorization. 261
8. Graphicshowingtheplacementoftheglobal 19. Diagramshowingidentitymapping.. . . . 264
cacheinamultipleclientscenario. . . . . 148 20. Diagramshowingthesequenceofeventsthat
9. Graphicshowingtheplacementoftheglobal occurwhenamessagearrivesatasecurity
cacheinamultipleclientscenario. . . . . 148 enabledinputnodeinamessageflow. . . . 267
10. Graphicshowingtheplacementoftheglobal 21. Diagramshowingthesequenceofeventsthat
cacheinamultipleclientscenario. . . . . 149 occurwhenamessagearrivesata
11. Diagramshowinghowintegrationserver1 SecurityPEPnodeinamessageflow.. . . . 273
hostsacatalogserverandacontainerserver, 22. Theimageisdescribedinthetext. . . . . 278
andintegrationservers2,3,and4host 23. Diagramshowingtheflowofinteraction
containerserversonly.Integrationservers5 betweenMessageBroker,TFIMV6.2,and
and6donothostanycachecomponents,but TAM. . . . . . . . . . . . . . . 283
theirmessageflowscanstillcommunicate 24. Thediagramisdescribedinthesurrounding
withthecache. . . . . . . . . . . . 156 text.. . . . . . . . . . . . . . . 436
12. Diagramshowingtwobrokersthatare 25. Thediagramisdescribedinthesurrounding
participatinginanembeddedcache. text.. . . . . . . . . . . . . . . 445
Integrationserver1ofbroker1containsa 26. Javacompatibilitylogo . . . . . . . . 897
catalogserverandacontainerserver.
Integrationserver1ofbroker2alsocontains
acatalogserverandcontainerserver.
Integrationservers2,3,and4ofbroker1
containcontainerserver.Integrationserver2
ofbroker2alsocontainsacontainerserver. . 157
13. DiagramshowinghowIBMIntegrationBus
canconnecttoanembeddedcacheanda
WebSphereeXtremeScalegridatthesame
time.Integrationserver1inthebroker
containsacatalogserverandacontainer
server.Integrationservers2,3,and4each
hostacontainerserver.Double-endedarrows
linkthemessageflowsineachintegration
servertotheembeddedcacheandtoa
remoteWebSphereeXtremeScalegrid.
Betweenthemessageflowsandremotegrid
isaboxthatrepresentstheconfigurable
servicethatisusedtoconnecttotheexternal
grid. . . . . . . . . . . . . . . 158
©CopyrightIBMCorp.1999,2014 ix
x IBMIntegrationBus9.0.0,Administering: IBMIntegrationBus9.0.0Administering