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

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