esb_deploy - Progress Sonic ESB Deployment Guide 8.5 - Product ...

More documents

Recommendations

Info

Chapter 4: Analyzing ESB Artifacts in Archives, Stores, and File Systems Overview The decoupling of Sonic ESB artifacts from the underlying messaging infrastructure means that you must tune the artifacts and their parameters when you import them into a new domain. To help evaluate the potential changes, Sonic provides a set of analysis reports that extract differences and dependencies into XML files. The analysis reports discover and document variations in ESB artifact files and their content, and reveals SonicMQ configuration parameters required by ESB artifacts. The analysis commands assess the files in a file store, archive, or directory service in three categories: XML, text, or binary. In an analysis that offers the -v verbose switch, not enabling the option provides a Boolean response to differences. A file’s extension classifies it for analysis and appropriate verbose information, as shown in this table: File Type Extensions Differencing Verbose [-v] XML .amap .bp .cbr .esbws .esbdb .prj .wsdl .xaction .xcbr .xml .xsd .xsl .xslt Text .bat .css .html .js .properties .sh .txt .xquery Binary .bpv .gif .jar .jpg .xar any other extension Requires XML equivalence. The order of elements is not significant—a series of tags listed in a different sequence is treated as equivalent. Reports on differences in the content of XML elements. The content (payload) of an element is case sensitive. XML tag names are not case sensitive. Exact textual match. Reported as in a standard text difference. Case sensitive. Exact binary match. Offset into the document of the first byte difference 96 Progress Sonic ESB Deployment Guide 8.5
Reporting Differences Reporting Differences The diff command assesses the difference between two artifact stores. Unlike a generic differencing engine, the ESBAdmin diff command only assesses specific filetypes in certain store types. The stores can be Sonic archive files—XAR files—(-xar store type), file systems (-fs store type), or Directory Service stores (-ds store type). Differences include: ● Artifacts that are in both stores, yet do not have identical content. You can choose to identify only that the files are dissimilar or to expose the differences in detail. ● Artifacts that are in the source store, but not in the target store. ● Artifacts that are in the target store, but not in the source store. The syntax of the diff command in the Sonic ESB Admin Tool is: diff -storeType storeParameters -storeType storeParameters [-out outputFile.xml] [-v] where: ■ The first -storeType storeParameters identifies the source artifact store, and the next -storeType storeParameters identifies the target artifact store. ■ storeType is { xar | fs | ds }. ■ storeParameters are: ❑ When storeType is xar, the archive location on a file system ❑ When storeType is fs, the root of the hierarchy on a file system ❑ When storeType is ds, the management connection to a domain in the form: domain url [username password] [managementNode] ■ outputfile is the preferred target XML file name and location for the analysis report on the file system. When you do not specify this parameter, the output file is created as Sonic_Diff.xml in the tool’s directory. ■ -v requests verbose reporting. Examples of diff Commands ● Comparing two XAR files: ESBAdmin> diff -xar sourceStore.xar -xar targetStore.xar ● Comparing a XAR file with a Directory Service store: ESBAdmin> diff -xar sourceStore.xar -ds Domain1 myHost:2506 aUser aPassword ● Comparing a file system with a XAR file in verbose output: ESBAdmin> diff -fs C:/myinstalldir/ESB -xar targetStore.xar -v Progress Sonic ESB Deployment Guide 8.5 97
Page 1 and 2:
® ® PROGRESS® SONIC® Sonic ESB
Page 3 and 4:
the redistribution, if any, must in
Page 5 and 6:
the relevant code modules. All Righ
Page 7 and 8:
OF USE, DATA, OR PROFITS; OR BUSINE
Page 9:
products derived from this software
Page 12 and 13:
Contents Using the Deployment Expor
Page 14 and 15:
Contents Chapter 7: Updating a Revi
Page 16 and 17:
Preface About This Guide This guide
Page 18 and 19:
Preface Progress Sonic Documentatio
Page 20 and 21:
Preface 20 Progress Sonic ESB Deplo
Page 22 and 23:
Chapter 1: Introduction Roles in Re
Page 24 and 25:
Chapter 1: Introduction Developing
Page 26 and 27:
Chapter 1: Introduction ESB Artifac
Page 28 and 29:
Chapter 1: Introduction Different P
Page 30 and 31:
Chapter 1: Introduction 30 Progress
Page 32 and 33:
Chapter 2: Exporting ESB Artifacts
Page 34 and 35:
Page 36 and 37:
Page 38 and 39:
Page 40 and 41:
Page 42 and 43:
Page 44 and 45:
Page 46 and 47: Chapter 2: Exporting ESB Artifacts
Page 60 and 61: Chapter 3: Mapping ESB Artifacts to
Page 98 and 99: Chapter 4: Analyzing ESB Artifacts
Page 106 and 107: Chapter 5: Importing Deployment Art
Page 122 and 123: Chapter 6: Adapting Imported Servic
Page 140 and 141: Chapter 7: Updating a Revised Deplo
Page 146 and 147:
Chapter 8: Distributed Deployment a
Page 148 and 149:
Page 150 and 151:
Page 152 and 153:
Page 154 and 155:
Page 156 and 157:
Page 158 and 159:
Page 160 and 161:
Page 162 and 163:
Index ESBWS WSDL files external to
Page 164:
Index 164 Progress Sonic ESB Deploy
show all

esb_deploy - Progress Sonic ESB Deployment Guide 8.5 - Product ...

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?