ultraesb / resources / RELEASE_NOTES.TXT

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
AdroitLogic UltraESB

Copyright (c) 2010-2012 AdroitLogic Private Ltd. All Rights Reserved

** Changes for 2.0.0-SNAPSHOT ** [xx-01-2013]
------------------------------------
    - Ability to reload binary jar files and classes in a configuration add or update, guaranteeing the atomicity
    - Introduction of the runtime environment configurations, such as development, testing, staging and production
    - File transport enhanced to support local and distributed locking to be able to concurrently poll files
    - AS2 persistence layer has been improved to support multi-tenancy (Refer to Appendix C)
    - UTerm commands made consistent by making all commands subject first (Refer to Appendix D)

** Changes for 1.7.1 ** [06-03-2012]
------------------------------------
    - Enhancements to the Zabbix registration in UConsole
    - Zabbix trigger dependencies integration for monitoring
    - Zabbix screens integration for monitoring
    - Improved Zabbix registration templates
    - UConsole and UTerm extracted as separate distributions apart from being part of the complete distribution

** Changes for 1.7.0 ** [01-02-2012]
------------------------------------
    - Introducing the new Mediation API with the support interfaces (Refer to Appendix B)
    - AS2 support overhauled
        - Improved and more user friendly AS2Manager API and error reporting and recovery
        - Support for any proxy service to accept or send AS2
        - Support to save messages and meta information to a database and file system
        - Support for improved sync/async MDN handling
    - Native AMQP transport
    - Throttling support for mediation
    - Protocol-Buffers based message mediation
    - Enhanced Zabbix monitoring integration
        - New Zabbix monitoring element registration wizard
        - Automatically creating the Zabbix hosts, host groups and applications as specified in the templates
        - Clustered registration of the templates into a single Zabbix server
        - Cluster graphs with consistent node colors
        - Improved registration statistics
    - Support regular expression based file path patterns for file transport
    - Support relative paths for processed and error locations for file transport
    - Enhanced connection debug logging for premature reads
    - Support restarts of services using JMS, File, Mail and Timer transports on dynamic sub contexts
    - Allow dynamic sub contexts to load/reload custom Spring beans possibly with the same name
    - Audit logs for the management activities
    - Upgrade from Spring 2.5.6 to 3.1.0-RELEASE
    - Upgrade from Spring Security 2.0.5-RELEASE to 3.1.0-RELEASE

** Changes for 1.6.2 ** [08-12-2011]
------------------------------------
    - Improved file handling in file cache
    - Fix the issue with starting the sample configurations in Windows based systems
    - Enhanced logging to remove error logs, which are not errors from the ESB users point of view
    - Fix to stop the server if a compilation failure or configuration error is detected in the dynamic sub context at the startup
    - Fix to acquire the ZooKeeper session and close it properly in a startup just after an abnormal stop of the server
    - Enhanced JMS transport to simplify the implementation of Guaranteed-Delivery pattern
    - Improved REST proxying support when a JMS intermediary is used for guaranteed delivery

** Changes for 1.6.1 ** [24-10-2011]
------------------------------------
    - Introducing the error description for errors mapped to the error codes
    - Improved Zabbix template registration making the process asynchronous
    - Introduction of a global endpoint "mediation.response" and streamline error handling when sending response messages
    - Improved UConsole Zabbix registration interfaces
    - Improved UTerm commands
    - Enhanced the HTTP/S transports

** Changes for 1.6.0 ** [26-09-2011]
------------------------------------
    - Configuration update with zero downtime via JMX, UTerm and UConsole
    - Ability to pin proxy services to a given server name
    - Ability for a server to run as another and UTerm commands to start/stop server acting as another
    - Provide failover for failed nodes automatically in a clustered deployment
    - UltraESB minimal distribution artifact (nearly 6MB)
    - Improved connection debugging information
    - Improved UConsole settings to manage permissions
    - New theme for the UConsole
    - Configuration operations and server state commands added to UTerm
    - UTerm default print width changed to 120 characters and making it a configuration
    - Fixed the server startup and shutdown order
    - Improved logging
    - Improved Zabbix integration for monitoring
    - Enhanced AS2 support
    - Custom password encryption utility

** Changes for 1.5.0 ** [19-7-2011]
------------------------------------
    ** Non backwards compatible change **
    - Ensuring consistency of properties used (See Appendix A below for the complete list)

    - Introduce UTerm the command line management terminal for the UltraESB
    - Zabbix Registration and Template management for instance monitoring
    - Logger and Appender management
    - RAM Disk based file cache for extreme performance
    - Connection debugging facility to show detailed information about connection errors
    - Allow configuration of conditions when a fail-over is safe for an endpoint
    - Better and improved handling of temporary failures of endpoints and subsequent suspension

    - Fix rendering and styling issues for Internet Explorer support for UConsole
    - Fix issue #17 - Implement a Graceful Stop for Proxy Services / Sequences
    - Bundle missing Jar file for XACML support
    - Secure JMX access to UltraESB runtime via UConsole
    - Ability to define servers, users and roles for UConsole access

    Known Issues
    - On IE web browsers the error code table and keep-alive statistics tables for the transport senders and
    listeners may not render properly

** Changes for 1.4.0 ** [2-5-2011]
------------------------------------
    - Implementation of JSON management services and a Web based management console (uconsole) for the UltraESB
    - Support for centralized cluster management via ZooKeeper, with Round-Robin restart of the cluster
    - Support for local and distributed caching across cluster via ehCache - for stateful service state replication
    - JMX support enhancements using MXBeans
    - Native agent for reporting monitoring information to Zabbix monitoring console
    - Integration with FastXML to boost XML processing performance using libraries such as VTD XML
    - Dynamic configuration changes - Updating, loading and unloading of configuration elements
    - Preparation of a configuration before updates to ensure that a switch or load will work
    - Support for XACML for entitlement using PicketBox
    - XML / SOAP to JSON auto conversion

    - Issue #11 - Support for XML / SOAP to JSON conversion using direct streaming or XSLT
    - Enhancements to the SOA ToolBox (Save and restore configurations)

    - Support single addresses for group endpoints such as round-robin, fail over etc.
    - Fix SOAP header extraction to support headers without prefixes
    - Resolve WS-Security compatibility issue with .Net
    - Fix for NTLM authenticated connections without a zero byte expect 100-continue request

    - ** NOTE: Deprecated variable name **
      The variable name used for the current message passed to the JSR 223 scripting language as been changed to "msg"
      to be the same name as passed into Java code fragments. Please update any scripting language sequences accordingly
    - ** NOTE: Service URL pattern change **
      Remove default mapping of "<service_name>*" as the URL of a service (Note: This may require a configuration change)

** Changes for 1.3.0 ** [22-10-2010]
------------------------------------
    - Include a temporary patch for HTTPCORE-239 until its next version is released
    - Issue #8 Support the creation of JSON Data Services using JDBC queries
    - Enhance the Mediation API to convert between JSON and Java beans
    - Enhance the Mediation API to convert between ISO8601 and UTC date formats into java.util.Date and java.sql.Date 
    - Add a sample showing the use of multiple JTA resources, and transaction semantic compliant file system updates
    - Allow response compression to be disabled, even if the request contains Accept-Encoding headers
    - Add a sample showing an email poll and saving attachments into the file system
    - Start sample Jetty server of SOA ToolBox on port 9002 for easy SSL testing

** Changes for 1.2.0 ** [24-9-2010]
-----------------------------------
    - Issue #5 Allow an XML message to be easily split with an XPath and parts processed serially
    - Issue #4 Allow the invocation of a sub-sequence during mediation
    - Issue #3 Provide the ability to log wire-level messages in UltraESB
    - Issue #2 File locking support on Windows
    - Issue #1 Support NTLM / v2 authentication for outgoing requests
    - Update Eclipse project file
    - Expose ability to invoke other sequences
    
    - ToolBox Issue #2 Provide an option in the Toolbox to turn on HTTP/S logging
    - ToolBox Issue #1 Add support for NTLM / v2 authentication to the ToolBox

** Changes for 1.1.0 ** [24-8-2010]
-----------------------------------
    - Release the source code under the GNU Affero General Public License version 3
    - Inclusion of XBean JAR file to optionally configure an ActiveMQ JMS Server within the UltraESB Configuration
    - Added samples related to Email / JMS
    - Fix JMS listener shutdown

** Changes for 1.0.1 ** [7-7-2010]
----------------------------------
    - Support for Gmail/ SSL authenticated email access options for the email transport

** Changes for 1.0.0 ** [3-5-2010]
----------------------------------
    - Add a Quickstart Guide PDF

    - Enable deployment over JEE containers to tap into JTA transaction manager capabilities to suspend/resume from
    different threads

    - Add a JMS Client to the ToolBox for testing purposes

    - Annotate sample configurations for better understanding

    - Simplify execution of performance test scenarios

    - Simplify load balancing and failover for proxying to Tomcat servers with sticky session support

    - Includes debug information for Java code fragments to specify line numbers on Exceptions etc

    - Supports Basic, Digest and AWS S3 authentication for outgoing HTTP/S connections with pre-emptive authentication
    support for Basic and AWS S3 authentication

    - Enhancement of the public APIs with many convenience methods - including support for WS-Addressing and Faults

    - Support for HTTP/S cookie manipulation - reading and setting

    - Support multi-entity response streaming over HTTP/S with support for timeout processing and pre-mature entity close

    - Message splitting and aggregation support with timeouts

    - Introduces MLLP and MLLPS (i.e. over SSL) support for the Health Level 7 (HL7) protocol.

    - Introduces XQuery support using The Saxon XSLT and XQuery Processor from Saxonica Limited. The free and  open
    source version Saxon-HE maybe downloaded from http://sourceforge.net/projects/saxon/ while the more advanced
    Professional and Enterprise editions maybe downloaded from http://www.saxonica.com. To install the Saxon-HE library
    simply copy the saxon9he.jar into the lib/optional directory

    - Introduces Support for Json using the Jackson library

    - Various enhancements and bug fixes


** Changes for 1.0-beta3-b2 ** [18-3-2010]
------------------------------------------

    - Based on user feedback of the source code, the code has now been reorganized to clearly separate the public API
    into a separate JAR file. This will ensure that user developed code will not accidentally link with the UltraESB
    internals.

    - The API JAR is published at the AdroitLogic Maven 2 repository at : http://downloads.adroitlogic.com/maven2

    - The above change removes the static methods of the Mediation class, and makes Mediation an interface. An instance
    is now passed as the variable "mediation" into a sequence, and could be used to invoke the same mediation routines
    as before. Message, Mediation and Configuration are the main

    - The full public API of the UltraESB is published at http://api.adroitlogic.org/

    - The UltraRuntime project files provided to develop with the UltraESB are mainly tested only against IntelliJ
    IDEA Community Edition 9.0 - which is available as free and open source software. The Eclipse and Netbeans files
    are provided-as-is, and we welcome any improvements to them from users.

=== Appendix A ===

This appendix describes the detailed renaming of property keys for version 1.5.0 from previous releases. The left side
shows the pre v1.5.0 name/key of the property and the right side shows the same from v1.5.0 onwards.

To migrate any pre v1.5.0 configuration to a v1.5.0 or later configuration, please refer the following tables, and/or
request for free assistance from AdroitLogic via any preferred support chanel

HttpConstants
*************
FORWARD_URL_POSTFIX             => ultra.http.forward_url_postfix
QUERY_PARAM_MAP                 => ultra.http.query_param_map
HTTP_METHOD                     => ultra.http.method
HTTP_SIZE                       => ultra.http.message_size
RESPONSE_STATUS_CODE            => ultra.http.response_status_code
LOCATION_SWITCH_BACK            => ultra.http.location_switch_back
transport.auth.username         => ultra.http.auth_username
transport.auth.password         => ultra.http.auth_password
transport.auth.domain           => ultra.http.ntlm_auth_domain
transport.auth.workstation      => ultra.http.ntlm_workstation
http.auth.scheme.holder         => ultra.http.auth_scheme_holder
http.auth.connection            => ultra.http.auth_connection
http.auth.scheme                => ultra.http.auth_scheme
ultra.https.client_dn           => ultra.http.ssl_client_dn
ultra.https.client_certs        => ultra.http.ssl_client_certs
stripURLPrefix                  => ultra.http.strip_url_prefix
wsdlURL                         => ultra.http.wsdl_url

JMSConstants
************
JMS_MESSAGE_TYPE                => ultra.jms.message_type
JMS_BYTE_MESSAGE                => bytes_message
JMS_TEXT_MESSAGE                => text_message
JMS_MAP_MESSAGE                 => map_message
JMS_COORELATION_ID              => ultra.jms.correlation_id
JMS_MESSAGE_ID                  => ultra.jms.message_id
JMS_DELIVERY_MODE               => ultra.jms.delivery_mode
JMS_DESTINATION                 => ultra.jms.destination
JMS_EXPIRATION                  => ultra.jms.expiration
JMS_REDELIVERED                 => ultra.jms.redelivered
JMS_REPLY_TO                    => ultra.jms.reply_to
JMS_TIMESTAMP                   => ultra.jms.timestamp
JMS_TYPE                        => ultra.jms.type
JMS_PRIORITY                    => ultra.jms.priority
destinationName                 => ultra.jms.destination
replyDestinationName            => ultra.jms.reply_destination

FileConstants
*************
FilePath                        => ultra.file.path
FileName                        => ultra.file.name
FileSize                        => ultra.file.size
FileScheme                      => ultra.file.scheme
OriginalFileName                => ultra.file.original_name
fileNamePattern                 => ultra.file.name_pattern
moveAfterProcess                => ultra.file.move_after_process
moveAfterFailure                => ultra.file.move_after_failure
moveTimestampFormat             => ultra.file.move_timestamp_format
fileTimestampFormat             => ultra.file.timestamp_format

TCPConstants
************
ultra.http.request_size         => ultra.tcp.request_size
tcp.snd_io_threads              => ultra.tcp.snd_io_threads
tcp.lst_io_threads              => ultra.tcp.lst_io_threads
tcp.socket.timeout              => ultra.tcp.socket_timeout
tcp.tcp.nodelay                 => ultra.tcp.tcp_nodelay
tcp.socket.buffer-size          => ultra.tcp.socket_buffer_size
tcp.socket.linger               => ultra.tcp.socket_linger
tcp.connection.timeout          => ultra.tcp.connection_timeout
tcp.connection.stalecheck       => ultra.tcp.stale_connection_check

MLLPConstants
*************
mllp.max_message_size           => ultra.mllp.max_message_size

HL7Constants
************
HL7SendingApplication           => ultra.hl7.sending_application
HL7SendingFacility              => ultra.hl7.sending_facility
HL7ReceivingApplication         => ultra.hl7.receiving_application
HL7ReceivingFacility            => ultra.hl7.receiving_facility
HL7Timestamp                    => ultra.hl7.timestamp
HL7Security                     => ultra.hl7.security
HL7MessageType                  => ultra.hl7.message_type
HL7TriggerEvent                 => ultra.hl7.trigger_event
HL7MessageControl               => ultra.hl7.message_control
HL7ProcessingId                 => ultra.hl7.processing_id
HL7VersionId                    => ultra.hl7.version_id

MailConstants
*************
protocol                        => ultra.mail.protocol
folder                          => ultra.mail.folder
concurrentPollingAllowed        => ultra.mail.concurrent_polling_allowed
processMailInParallel           => ultra.mail.process_in_parallel
moveAfterFailure                => ultra.mail.move_after_failure
moveAfterProcess                => ultra.mail.move_after_process
leaveAfterFailure               => ultra.mail.leave_after_failure
leaveAfterProcess               => ultra.mail.leave_after_process
preserveHeaders                 => ultra.mail.preserve_headers
removeHeaders                   => ultra.mail.remove_headers
mainPartIdentificationPriority  => ultra.mail.main_part_identification_priority
retainAlternativeParts          => ultra.mail.retain_alternative_parts
from                            => ultra.mail.from
cc                              => ultra.mail.cc
bcc                             => ultra.mail.bcc
subject                         => ultra.mail.subject

PollingConstants
****************
cronExpression                  => ultra.polling.cron_expression
startDelay                      => ultra.polling.start_delay
repeatInterval                  => ultra.polling.repeat_interval
repeatCount                     => ultra.polling.repeat_count
concurrent                      => ultra.polling.concurrent
disabled                        => ultra.polling.disabled

BaseConstants
*************
url                             => ultra.transport.url

ConfigurationConstants
**********************
switchLocationHeadersTo         => ultra.endpoint.switch_location_headers_to
socket_timeout                  => ultra.endpoint.socket_timeout
keepalive_timeout               => ultra.endpoint.keepalive_timeout
responseValidatorBean           => ultra.endpoint.response_validator_bean

Misc
****
SOAP_HEADERS                    => ultra.soap.headers
MERGED                          => ultra.mediation.aggregator.merged
EXPIRED                         => ultra.mediation.aggregator.expired
AGGREGATION_EXPIRY              => ultra.mediation.aggregator.expiry_time
part                            => ultra.mediation.aggregator.part
size                            => ultra.mediation.aggregator.size


=== Appendix B ===

This appendix describes the detailed re-factoring of Mediation API for version 1.7.0 from previous releases. The left side
shows the pre v1.7.0 mediation API methods and the right side shows the same from v1.7.0 onwards with the support interfaces.

Support interfaces improves the usability of the API, by grouping the similar operations into a single interface.

To migrate any pre v1.7.0 configuration to a v1.7.0 or later configuration, please refer the following tables, and/or
request for free assistance from AdroitLogic via any preferred support chanel. Please note that the previous API methods
are still available as deprecated and planned to be removed in a next version of the UltraESB and hence migrating to the
new API is highly recommended.


SOAPSupport
***********

setPayloadToSOAP11Fault         => SOAPSupport#setPayloadToSOAP11Fault
setPayloadToSOAP12Fault         => SOAPSupport#setPayloadToSOAP12Fault
isSoap                          => SOAPSupport#isSoap
getSoapFaultCode                => SOAPSupport#getSoapFaultCode
getSoapFaultString              => SOAPSupport#getSoapFaultString
getSoapFaultDetail              => SOAPSupport#getSoapFaultDetail
getSoapHeaderAsString           => SOAPSupport#getSoapHeaderAsString
getSoapHeadersAsStrings         => SOAPSupport#getSoapHeadersAsStrings
getSoapAddressingTo             => SOAPSupport#getSoapAddressingTo
getSoapAction                   => SOAPSupport#getSoapAction
getSoapAddressingAction         => SOAPSupport#getSoapAddressingAction
getSoapAddressingReplyTo        => SOAPSupport#getSoapAddressingReplyTo
getSoapAddressingFaultTo        => SOAPSupport#getSoapAddressingFaultTo
getSoapAddressingFrom           => SOAPSupport#getSoapAddressingFrom
getSoapAddressingMessageID      => SOAPSupport#getSoapAddressingMessageID
convertFromFI                   => SOAPSupport#convertFromFI
convertToFI                     => SOAPSupport#convertToFI
convertSOAPToJSONStream         => SOAPSupport#convertSOAPToJSONStream
validate                        => SOAPSupport#validate
filter                          => SOAPSupport#filter
remove                          => SOAPSupport#remove
extractAsStringUsingXPath       => SOAPSupport#extractAsStringUsingXPath
transform                       => SOAPSupport#transform
splitAndProcess                 => SOAPSupport#splitAndProcess


XMLSupport
**********

convertFromFI                   => XMLSupport#convertFromFI
convertToFI                     => XMLSupport#convertToFI
convertToDOM                    => XMLSupport#convertToDOM
convertXMLToJSONStream          => XMLSupport#convertXMLToJSONStream
validate                        => XMLSupport#validate
filter                          => XMLSupport#filter
remove                          => XMLSupport#remove
extractAsStringUsingXPath       => XMLSupport#extractAsStringUsingXPath
extractAsNodeListUsingXPath     => XMLSupport#extractAsNodeListUsingXPath
transform                       => XMLSupport#transform
retainElementAsPayload          => XMLSupport#retainElementAsPayload
mergeXMLAttachmentsUnderElement => XMLSupport#mergeXMLAttachmentsUnderElement
splitAndProcess                 => XMLSupport#splitAndProcess
createDOMDocument               => XMLSupport#createDOMDocument


HTTPSupport
***********

isHessian                       => HTTPSupport#isHessian
setCookie                       => HTTPSupport#setCookie
getCookie                       => HTTPSupport#getCookie
addPreemptiveBasicAuthentication => HTTPSupport#addPreemptiveBasicAuthentication
getJvmRoute                     => HTTPSupport#


JSONSupport
***********

convertXMLToJSONStream          => JSONSupport#convertXMLToJSONStream
convertJSONToStream             => JSONSupport#convertJSONToStream
convertSOAPToJSONStream         => JSONSupport#convertSOAPToJSONStream
convertXMLToJSONStream          => JSONSupport#convertXMLToJSONStream
convertToUntypedJSON            => JSONSupport#convertToUntypedJSON
convertToTypedJSON              => JSONSupport#convertToTypedJSON
processBasicJSONDataServiceRequest => JSONSupport#processBasicJSONDataServiceRequest


XACMLSupport
************

isPermitted                     => XACMLSupport#isPermitted


DateSupport
***********

getISO8601FormattedString       => DateSupport#getISO8601FormattedString
getDateFromISO8601String        => DateSupport#getDateFromISO8601String
getSQLDateFromISO8601String     => DateSupport#getSQLDateFromISO8601String
getUTFFormattedString           => DateSupport#getUTFFormattedString
getDateFromUTCString            => DateSupport#getDateFromUTCString
getSQLDateFromUTCString         => DateSupport#getSQLDateFromUTCString


CachingSupport
**************

getLocalCache                   => CachingSupport#getLocalCache()
getLocalPermanentCache          => CachingSupport#getLocalPermanentCache()
getLocalPersistentCache         => CachingSupport#getLocalPersistentCache()
getDistributedCache             => CachingSupport#getDistributedCache()
getDistributedPermanentCache    => CachingSupport#getDistributedPermanentCache()
getDistributedPersistentCache   => CachingSupport#getDistributedPersistentCache()


=== Appendix C ===

This appendix describes the detailed re-factoring of AS2 persistence layer DB schema for version 2.0.0 from previous
releases. The left side shows the pre v2.0.0 schema table column names while the right side shows the same from v2.0.0
onwards.

To migrate any pre v2.0.0 schema to a v2.0.0 or later schema, you will need to add few columns into some tables and
change some properties of the schema too. All those properties are described next to the changed column.

Please consult AdroitLogic for further support on migrating the existing AS2 system into the new version.


PARTNER Table
*************

** The Table name itself has been changed from "PARTNER" to "partner". Note the case of the letters. This change is only
applicable to databases case sensitive naming. (most of the databases are case sensitive, including MySQL and many other)

as2Identifier           => as2identifier [This column is no more unique, the unique property has been removed]
signMessages            => sign_messages
encryptMessages         => encrypt_messages
compressBefore          => compress_before
compressAfter           => compress_after
requestMDN              => requestmdn
requestSignedMDN        => request_signedmdn
requestAsyncMDN         => request_asyncmdn
asyncReceiptURL         => async_receipturl
messageSubject          => message_subject
encryptCertAlias        => encrypt_cert_alias


MESSAGE Table
*************

** The Table name itself has been changed from "MESSAGE" to "message". Note the case of the letters. This change is only
applicable to databases case sensitive naming. (most of the databases are case sensitive, including MySQL and many other)

relatedMessageID        => related_messageid
userAgent               => user_agent
rawFilePath             => raw_file_path
rawHeadersPath          => raw_headers_path
containsPayload         => contains_payload
sendFailed              => send_failed
transportStatusReceived => transport_status_received

=== Appendix D ===

This appendix describes the detailed re-factoring of UTerm command names for the 2.0.0 release from previous
releases. The left side shows the pre v2.0.0 commands while the right side shows the same from v2.0.0
onwards.

The rationale behind this refactoring is to make the UTerm commands consistent across the norms. The change is mainly
on bringing the subject as a first class entity to the command over the action. For example "list-endpoints" (previously
action first - "list"), will be now "endpoint-list" (subject first "endpoint")

Please consult AdroitLogic for further support on migrating the existing scripts using these commands to the newer
version.
     __________________________________________________________________________________________
    |                          LONG FORM                              |    SHORT FORM          |
    |_________________________________________________________________|________________________|
    |       v < 2.0.0               |       v >= 2.0.0                | v < 2.0.0 | v >= 2.0.0 |
 ___|_______________________________|_________________________________|___________|____________|
| S | list-servers                  | server-list                     | ls        | sl         |
| E | check-server-state            | server-state-check              | chksst    | sstchk     |
| R | start-server                  | server-start                    | strs      | sstr       |
| V | stop-server                   | serve-stop                      | stps      | sstp       |
| R | restart-server                | server-restart                  | rs        | srstr      |
|___|_______________________________|_________________________________|___________|____________|
| E |                               |                                 |           |            |
| N | list-endpoints                | endpoint-list                   | lep       | epl        |
| D | get-endpoint                  | endpoint-view                   | getep     | epv        |
| P | stop-endpoint                 | endpoint-stop                   | stpep     | epstp      |
| O | start-endpoint                | endpoint-start                  | strep     | epstr      |
| I | enable-debug-endpoint         | endpoint-debug-enable           | edbep     | epdbe      |
| N | disable-debug-endpoint        | endpoint-debug-disable          | ddbep     | epdbd      |
| T | reset-statistics-endpoint     | endpoint-statistics-reset       | rststep   | epstrst    |
|___|_______________________________|_________________________________|___________|____________|
| P |                               |                                 |           |            |
| R | list-proxy-services           | proxy-service-list              | lps       | psl        |
| O | get-proxy-service             | proxy-service-view              | getps     | psv        |
| X | stop-proxy-services           | proxy-service-stop              | stpps     | psstp      |
| Y | start-proxy-service           | proxy-service-start             | strps     | psstr      |
|   | enable-debug-proxy-service    | proxy-service-debug-enable      | edbps     | psdbe      |
| S | disable-debug-proxy-service   | proxy-service-debug-disable     | ddbps     | psdbd      |
| V | reset-statistics-proxy-service| proxy-service-statistics-reset  | rststps   | psstrst    |
|___|_______________________________|_________________________________|___________|____________|
| S |                               |                                 |           |            |
| E | list-sequences                | sequence-list                   | lsq       | sql        |
| Q | get-sequence                  | sequence-view                   | getsq     | sqv        |
| U | stop-sequence                 | sequence-stop                   | stpsq     | sqstp      |
| E | start-sequence                | sequence-start                  | strsq     | sqstr      |
| N | enable-debug-sequence         | sequence-debug-enable           | edbsq     | sqdbe      |
| C | disable-debug-sequence        | sequence-debug-disable          | ddbsq     | sqdbd      |
| E | reset-statistics-sequence     | sequence-statistics-reset       | rststsq   | sqstrst    |
|___|_______________________________|_________________________________|___________|____________|
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.