Patch-ID# 143749-02

Note: This patch requires the NSS/NSPR/JSS, SASL, LDAP C SDK, ICU and OS patches.

6932998 metermaid count not reset to 0 after quota_time (penalize NOT set)
 
(from 143749-01)
 
6404489 webmail proxy login fails if inetdomainsearchfilter doesn't include uid
6512812 fix 30s timeout during append
6697572 tcp_smtp_server core dumps under load with ClamAV
6821205 POLLHUP and RST caused by shutting the connection by SpamAssassin-plugin
6867386 msprobe connections to IMAP over SSL timeout earlier than what is set in service.readtimeout
6868597 No error message is shown when S/MIME is disabled  for encrypted messages sent using Thunderbird
6871101 metermaid test call ignores entry age
6872757 IMAP STATUS command returns incorrect folder size if folder usage is greater then 4GB
6878493 minor problems with mshttpd handling folders larger than 2GB in size
6879169 APOP login with invalid parameter causes popd to crash
6884146 imapd core dump in localpart on sort by To when To is too long
6884437 unable to upgrade corrupted folders from 0102 to 0103
6884857 IMAP SORT on 'From' still sorting incorrectly
6888421 Various problems associated IP address logging in Received: headers
6888664 javascript error
6893506 pipe_master always declares failure on linux
6893514 many tcp_smtp_server processes consuming cpu and not dying after ms-server is stopped
6896215 Add timeout to imexpire when attempting to access locked mailbox
6896382 imapd should timeout waiting for lock for APPEND
6896466 iss scalability test failed due to imapd core during sort
6897240 job_controller crashes on many 0-length files
6899015 appending message with many flags to folder without them crashes imapd
6899556 IMAPD cores multiple times
6902373 Headers lost during service conversions
6904073 JMQ plugin: login takes 30 seconds when JMQ server is not responsive.
6904555 General Error: Original userid not available for user 'xxxx'; can't perform IMAP login when hitting
6904941 Provide Messaging Server the ability to apply charset defaults to illegal, unlabeled rec'd messages.
6911913 genurlauth does not handle non-default domain
6913730 mshttpd assert in get_imap_response
6922304 MMP POP proxy loops on recv() = 0 from client
6923105 tcp_smtp_server core dump
6924519 After session resource timeout, subsequent IMAP connections incorrectly reauthorise as admin user
6925745 if local.http.replayformat is set to %o, all user will access only admin's inbox
6927507 "script" replaced by "sc-ript" in the body of RTF emails (6.x and 7u3 only)
 
 
137201-XX History
=================
 
(from 137201-10)
 
6519467 auto-recreate during rename hang
6767783 job controller should not wait for cache synchronization to process a released .HELD message
6837107 MS6.3/imquotacheck indicates different "Usage" with or without "-n" option.
6843447 imexpire logs incorrect 'too many expire rules' warning messages
6856388 MS 7.0, chooses Japanese encoding although preferred language is zh-TW
6859207 imexpire ignores trailing spaces on messageheader.subject
 
(from 137201-09)
 
4543048 DNS cache for MMP DNS lookups
6771968 Background images are not displayed in Convergence
6817618 IMAP list command does not return a result if foldername is a truncated form of INBOX
6818684 userlist mechanism sometimes gets disabled when maximum connection limit is hit
6838278 imapd core in charset_searchfile
6839140 imexpire core dump in icu::RegexMatcher::MatchAt
6841918 imsrestore cannot be exited and cores with SIGILL causing server restart
6844558 imapd core with conditional JMQ requests: CheckConnection called with null dest
6845956 impurge limits store.cleanupage to 24 hours
6848549 stored crashes due to bad partition path
6854747 imapd cores on shutdown in ens code
 
(from 137201-08)
 
6840267 MMP can wedge due to back-end timeouts after 7u2
 
(from 137201-07)
 
4536819 EXAMINE command may not be RFC 2060 compliant
4763788 RFE: Filters on body
6476460 Make MMP logging of LDAP server connection timed out errors more useful
6556094 REGRESSION: imsconnutil -k fails to disconnect imap client connection
6570574 RFC 2231 support in the MTA
6587405 tcp_smtp_server core in he_write_header_internal - current_item out of range
6649238 reconstruct -a -t option should say something meaningful how the number of threads are calculated
6663386 smf: watcher fails to restart if pop/http/purge die multiple times
6690323 reconstruct -u userid should fail
6731809 dispatcher fails to shutdown and hangs
6757584 ims_master doesn't shut down properly under load
6758411 ENS notifications fail during imap idle stress
6759783 reconstruct -a should not imply -f and needs -n
6769691 SNMP failing to report inbound associations
6772112 JMQNotify:	AnnotateMsg, ExpungeMsg and ChangeFlag aren't in confdesc.xml; adjust defaults
6773287 JMQNotify: UID lists in ExpungeMsg, ChangeFlag and Copy events can exceed max JMQ string prop size
6773299 JMQNotify: uidList in ChangeFlag event should contain list of UIDs acted on from UID STORE command
6775388 Renaming folders does not update subscriptions
6775468 Subscribed folder still shown even after removing the permission to the shared folder
6776604 msstart should de-bounce multiple restart requests from watcher
6776679 Saving drafts with blank 'To' field will show the default value in the layout
6781087 Purify reporting memory leaks with IMAP THREAD REFERENCES command
6781168 Empty config.xml causes core dump
6783505 CI:  Couldn't open IMTA_COMMAND_DATA: Permission denied
6783657 indexeradmins cannot get the IMAP flags correctly from users
6785735 config-servicetags fails on S9_x86 freshbit - configure fails
6785930 POPD connects to ENS when it should not connect (because ENS is disabled by default)
6785943 mboxutil -d returns the "Cursor position must be set before performing this operation" message
6786143 Purify reporting free memory read during IMAP RENAME operation
6786564 mboxutil -c, -r or -d should generate event notifications
6786724 Purify reporting uninitialised memory read in ENS
6786768 Purify reporting uninitialised memory read during IMAP SELECT command
6787256 Purify reporting memory leaks with IMAP THREAD ORDEREDSUBJECT command
6787745 install-newconfig failed on MS tip
6788254 Change EHLO "AUTH=LOGIN" to "AUTH=LOGIN PLAIN" due to mutt confusion
6790776 Message Store lock db locker table runs out of space
6792183 incorrect timestamps for non-zero-minute zone offset in nslog log files
6792844 endp memory growth with IMAP IDLE
6793739 libjmqnotify.so can not find libmqcrt.so in an altroot install
6793934 Enabling quota bypass doesn't disable mailuserstatus "overquota" check
6796244 msprobe leaks an FD when IMAP/SSL test fails
6796347 msgadm tool has a misleading name that conflicts with admin tools of other Comms products
6798750 IMAP flags added in Sieve do not transfer through LMTP
6798758 Sieve scripts attached to lists defined in the aliases file don't work
6798853 Dispatcher assert failures at process shutdown
6798893 Body search of a phrase when wasabi is enabled (searching from convergence) has problems
6799079 cnbuild and dispatcher do not log any error about two IP addresses on INTERFACE_ADDRESS parameter
6800193 Milter enhanced status code handling inconsistent
6800293 AService core in lpool_result_release
6802162 Provide option to translate milter server Discard response to jettison action
6805729 Forwarding with $D	in FORWARD mapping not	treated as an alias
6805731 Requeues of spam filter temporary failures can subsequently bypass the filter
6806772 The default value of IMTA_LANG is not set correctly which results in poorly formatted DSN
6806867 RFE: mshttpd viewing mail should try GBK although encoding says GB2312
6807254 Editheader actions don't attach to fileintos in system-level sieves
6807800 MMP syslog messages switch from AService to ImapProxy to PopProxy
6808164 Wasabi IMAP search to Miso must quote the folder name if it contains a space
6810328 mail.log entries for SMTP bad authentication limit messages include extra CRLF characters
6810854 mailEventNotificationDestination missing from schema
6810969 WASABI: IMAP flags search is silently ignored
6810970 WASABI: smaller search criteria is ignored silently
6810973 WASABI: search cc with two addresses doesn't work
6810977 WASABI Imap: search based on before date is not sent to MISO
6811536 ims_master dumps core during STH stress w/JMQ
6812159 Small memory leak in imapd w/JMQ enabled
6812160 MTA connection rejection records wrap over two log lines when 4XX returned by peer server
6812166 MTA log output records invalid message size under certain circumstances
6812178 local.service.http.showunreadcounts configuration parameter does not apply to Convergence web client
6814677 msprobe incorrect default for SMTP service when trying to send warning email
6815025 mshttpd listfolders.mjs generates error
6817664 Attachments wih special character missing
6818616 mailfromdnsverify fails to check for A records as fallback behaviour
6819189 tsock_connectbyname() Operation in progress errors	appearing in MMP logs on regular basis
6820369 RFE: Add "saslswitchchannel tcp_submit" to tcp_submit definition
6820794 imapd core in _enp_recv_request_cb - sdata not locked?
6820916 imsbackup/imsrestore should handle SIGHUP
6821112 crash may happen in seen_reconstruct after an aborted transaction
6821710 reconstruct FD leak if no store.idx
6821717 "Unknown error 255" upon accessing message with multipart more 20 on convergence
6823378 config.txt gives wrong port number values after configuration
6823382 watcher fails to start if service.listenaddr is set to a ipv6 address
6824508 UTF-8 line separator sequence not substituted in text/html
6825637 watcher does not shut down by stop-msg
6825818 idle with ens deadlocks
6826155 'ens' service doesn't start in HA environment
6826430 rpm --verify sun-messaging-server  fails
6828999 SASL auth fails through IPv6 interface1
6830753 IMAP gets stuck when long uid lists notification is created
 
(from 137201-06)
 
6779919 imapd core dump in index_threadreferences
6804720 MMP core dump in user_cacheadd() when HostedDomains option is disabled
6809593 MAX_HDRS limit of 32 should be increased
6814918 POP and IMAP servers bind SSL port to all interface addresses when service.listenaddr is used
 
(from 137201-05)
 
6726739 metermaid integer overflow with large quota:time ratio
6764059 ReplayFormat fails for cached user lookups
6775369 mshttpd aborts in MEE_LocalToInternetMessageHeader
6777364 imapd core dump in idle_done ...
6778115 imapd core dumps at mailbox_create()
6781779 Imap IDLE should work if local.store.notifyplugin.LogUser.enable is set to 0.
6781833 dispatcher can crash updating its counters
6786062 imapd core dump at Mblock_New()
6791660 Extra characters being dropped when EOL converted from CRLF to space for sms messages.
6796505 seen db repair corrupts data
6797532 tcp_smtp_server core dump due to abort in pmt_tls_nss.c
6797790 mkbackupdir core dump
6800219 when peruser flags list is very long, imsbackup corrupts memory and crashes
6800798 tcp_smtp_server SIGBUS in MD4Update
6803563 imapd with IMAP IDLE dumps core on shutdown under load - Subscriber already freed
 
(from 137201-04)
 
6773371 imapd core dump in index_check
6774157 tcp_lmtp_server core dump due to memory corruption
6776956 incremental backup now backs up all messages that had been changed and not only the new emails
6785468 mgrpErrorsTo address not applied to emails queued in reprocess channel
6785888 imapd crash - double free - two threads shutting down same ctx
6788373 tcp_smtp_server core in sy_swild_match
6788828 recipientlimit and recipientcutoff channel options should enforce single address RCPT TO
6788832 Name changes in Sieve DSN extensions
6789724 Reputation check code in 7.0U1 is incomplete
 
(from 137201-03)
 
4557438 GDisp_group doesn't take effect until current callback returns
4666501 Implement log rotation function for MMP
5102814 Bug allows inactive users to login to mail services
6207821 immonitor-access failed to show stats with -H -S together
6249584 Message store automatic recovery should evaluate use of secondary snapshot
6446484 qm summarize -hosts columns misleading
6569452 Mailbox database error: environment reference count went negative
6572690 MMP memory leak when AService default:NumThreads increased to large value (e.g 8)
6577387 mbox.msc should take a startuid parameter
6610970 msprobe does not handle EAGAIN/EWOULDBLOCK on reading response
6663234 store utils fail when domainUidSeparator set
6670973 sleeypcat mutex API bypasses dtrace instrumentation
6686534 Problem in folder rename JMS notification event
6689930 IDLE (very rarely) reporting store corruption
6691204 instability in the idle code
6693247 Comms Express can't decode From: header line that has some type of encoded words.
6693979 CLI Configurator - English message when canceling installation
6694062 imsrestore unable to restore messages that link to messages on a different file system
6694520 imapd core - prot_write() overwrites stack with error message
6699401 reconstruct -a logs error 256 times if problem with first level hash
6699496 reconstruct -a should let you know what it has done
6699654 big imapd fetch keeps allocating memory, crashes server
6701409 seenuidsptr leak in index_checkperuser
6701759 user didn't get email notification while idle with JMQ
6706255 service.authcachesize and service.authcachettl descriptions are wrong
6706761 MISO: Imapd dumped core when miso is not enabled
6708239 Connection log O record doesn't match C record when SMTP proxy used
6711815 need MTA option to time out connections waiting for helo/ehlo
6712994 imapd exit when idle is enabled with ENS
6715294 Provide HULA cache statistics logging and hooks
6716794 proxy authentication needs method to not update login date/time records
6718232 Reenqueue of a subset of SMTP recipients with temporary delivery failures loses delivery flags
6722562 notifications plugins slow down imap
6724305 confusing auto restart error message
6725119 webmail server to prevent compromised accounts from sending mass spam
6725559 Update Msg event missing message body text
6725658 Allow SMTP AUTH on internal submissions in initial config (put maysaslserver on tcp_intranet)
6725661 Have webmail (mshttpd) configured to do SMTP AUTH by default
6726092 TDopen cores if we opened the file on the second try
6726843 IMAP IDLE not working reliably
6727501 Z reenqueues get empty envelope From if any R rejections happened in the transaction
6729516 ident*symbolc settings don't perform IP-based channel switching
6730755 dispatcher core dumps on msg tip machines
6734507 quoted phrase body searches aren't handled properly (spaces are lost)
6734707 imapd memory leak and dumped core after moving IDLE over JMQ
6735497 JMQ notification event for Create folder missing UID validity
6735619 bin/deliver should generate JMQ events
6737033 returnenvelope 16 doesn't return proper error when returnenvelope 8 is also set
6737064 rename of folder should generate a new uid validity value
6737068 rename folder notification event needs to supply uid validity
6737877 imapd, popd, mshttpd core dumps on tip machines, dbx info shows they failed at same place
6738301 msstart message confusing when watcher is already running
6738548 memory leak, bad code, and local.store.notifyplugin requires full path
6739511 imexpire core dumps in imapIdleJMQ on tip machines
6741785 meterMaid issue -- imsimta test -mapping got stuck
6742241 immonitor-access fail to connect to any service port
6747061 BURL fails to set "URL used" logging flag
6749877 vacation sieve support for allowing settings for "internal" & "external" domains
6750553 imapd core during (jmq) IDLE stress run
6750582 deliver dumped core in nsplugin_notify_append3
6752099 Linux boxes can't handle "SEARCH CHARSET ISO8859-1 TEXT {5}" on tip, and generate imapd core
6752161 Job controller reporting bogus value for volume of active messages
6752340 MS configure can not locate java with CI 6u1 which installs java 6
6753799 imapd cores in mboxname_userownsmailbox appending to remote shared folder
6753974 potential for job controller to fail on while scanning files
6754244 imapd core in 'unmakeSubscription'
6754355 metermaid.table.default.quota is not working correctly
6754456 IDLE notifications are not seen when folder name contain spaces
6756458 mboxutil core dumps on tip, some machines even have imapd cores
6756836 imapd suggests maxsessions 0
6757509 trouble starting/stopping imapd on linux having changed fd limit after failed attempt to start
6758079 MMP diagnostic regressions due to IPv6
6758608 IMAP access to non-INBOX folder hangs on single CPU systems
6758936 messaging 7.0 is using well known binary names (ls and grep) as script names in messaging bin dir
6760926 AService dumped core in hula_cache_stats
6761656 logfile.pop.maxlogfilesize is not working properly
6763141 libasync GDisp can starve a ready task if no threads can be created
6763223 frequent errors "The mail server unexpectedly closed the connection" in Convergence
6764366 acceptalladdresses channel keyword doesn't always ensure email is accepted
6766347 loading of 2 plugin is ignored when idle is enabled (
6766997 append failures can leave mailbox locked forever
6767584 ChangeFlag event notification missing UID validity info
6767802 Store daemons fail to start under cluster control due to file descriptor limits enforced by cluster
6767838 MS HA: MS services didn't come up in MS HA environment when MMP service is configured.
6768781 UTF-8 line separator sequence not escaped by mshttpd
6769331 Copy JMQNotify should use a sequence set representation for uidlists
6769814 MTA time zone offset incorrect for negative offsets from UT with non-zero minutes
6770770 Certain patterns can put the mapping file parser into an infinite loop
6771352 Stored core under STH stress
6771859 Purify reporting minor memory leak when JMQ failures occur
6771994 Purify reporting memory leak when copying messages in IMAP
6772036 Purify reporting memory leak during mailbox deletion
6772550 Various problems with the MTA's SRS support
6772648 Purify reporting memory leak during copy to remote mailbox
6772677 Purify reporting memory leak during IMAP APPEND
6774264 'ens' service is unable to start in HA environment
6776924 SMTP client can get into an infinite delivery attempt loop
6777003 ENPD not listening on 7997 port (after the fix to 6774264)
6777801 mshttpd crashing during Convergence automation run
6777867 crl smime :: Serial numbers mismatch between client and server when there is leading zero.
6778037 all store related daemons crash with IMAP idle configured
6781684 CI :  CI messaging server postupgrade couldn't find /usr/bin/nawk for RHEL4
6788820 MS7.0 patch 137203-02 default install directory
 
(from 137201-02)
 
6641386 Throws 'Unknown Code-254' error while trying to get external mail with invalid server name
6698495 listing folders in Convergence is too slow
6703210 mailbox is locked and updated everytime a seen/deleted flag is set
6738492 imapd crashing in index_threadreferences
6740634 mshttpd does not show write-only shared folders
6748648 imapd core with thread references.
6748650 imapd core dump in eliminate_dummies()
6752200 "Critical: ENS server is not responding" logged when ENS is not config'd
6753364 store maintenance queue max locker is too small
6753609 Missing IMAP parent folder causes "Mailbox has an invalid format" error
6754281 store flags command replayed incorrectly to remote backend
6754333 ASock_Printf call missing an argument
6754371 MMP core dumped in user_release (hula code)
6755058 appending message to remote IMAP folder using LITERALPLUS IMAP extension does not work
6755061 copying a message from a local IMAP folder to a remote IMAP folder does not work
6755384 imapd can crash during mailbox creation
6756522 MMP removal of 255 octet length limit in password field
6757114 remote shared folder operation generates unrelated CONDSTORE error
6757966 store daemons crash on invalid start_offset in store.idx
6757967 error message needs to be clearer if alarm.msgalarmnoticehost is misconfigured
6759016 imapd failing with "too many open files"
6759022 reconstruct -a fails with "too many open files"
6761108 job_controller can leak fd's due to non-standards compliant implementation of mmap() on LINUX
6763047 mshttpd crash in print_intl_string()
6765080 reconstruct works on wrong folder if folder name begins with INBOX
6766274 imapd core dump in idle_done ... unsubscribe_a subs structure overwritten with junk ( 7.x only)
6766876 enpd fails to start on cluster - cannot connect to watcher on 127.0.0.1
6766883 Crashes in mshttpd due to Sun Studio libCstd compiler bug (sort routines)
6766951 msprobe uses service.ens.enable to connect to enpd.
6768101 mshttpd crashing in prot_free()
 
(from 137201-01)
 
6489378 MMP: make the pending LDAP operation limit adjustable
6602072 imapd core on reconstructing mailbox in index_scanperuser
6604027 many processes dumped core in ens on shut down
6604629 need to URI encode argv's in print_login_headers
6627615 store access daemons core in various globalmutex_* routines
6650145 smime.conf passwords should not be written to logfile
6683902 enpd core dumps under load
6696602 need msprobe switch to do the test and return status, but not initiate restart
6703686 imapd crash on long folder name - makeEventkey buffer overrun
6703943 ens notification plugin fails with very long mailbox names
6704720 Sieve ereject not working
6706580 Watcher support for enpd
6709755 incremental imsbackup opens files unnecessarily
6710005 imapd core dumps in mailbox_reopen_index during an expunge
6711543 MS6.2: tcp_smtp_server core in memcpy
6717954 purging mailboxes after expunge is causing problems in Convergence
6720422 enpd core dumps in ibiff and imapIdle on msg tip machines
6720986 SPF incorrectly returns PermError when it should return Pass
6726735 refresh kills metermaid
6727976 imapd crashing during IMAP idle notifications if error occurs opening a mailbox
6732926 garbage debug information in imap log file
6732971 Third party authentication server samples make incorrect use of b64_decode
6734637 IMAP FETCH ALL returns BAD
6734657 IMAP envelope address group parsing bug
6738583 mshttpd does not provide attachment of content-type "application/mac-binhex40" to client
6738810 metermaid count increments by more than 1
6739883 MMP core assert HULA_USERONLY in hula_dance
6742425 Non-IPv4 IP address entries in /etc/hosts causes subsequent entries to be skipped
6743256 unable to configure folder quota for the INBOX
6746376 tcp_lmtp_server cores because os_swap does not reserve enough space for 64bit frames
6746594 IPv4 address patterns employing a /4 mask don't work properly
6747104 ibiff failures: no enpd notifications for ReadMsg, UpdateMsg etc. events triggered by pop,imap, http
6748629 ens related imapd cores due to GDisp assert() failure
6750733 Milter: Extraneous null terminating character at the end of BODY data
6751017 SNMP agent should not require an MTA config

-------------------------------- 
 
For Solaris 9 releases, refer to the man pages for instructions
on using 'patchadd' and 'patchrm' scripts provided with Solaris.
Any other special or non-generic installation instructions should be
described below as special instructions.  The following example
installs a patch to a standalone machine:
 
       example# patchadd /var/spool/patch/104945-02
 
The following example removes a patch from a standalone system:
 
       example# patchrm 104945-02
 
For additional examples please see the appropriate man pages.

-----------------------------
 
This patch corresponds to version: 7u2-12.01
 
Stop services before installing the patch.
 
The patch will generate the directory
  <msg_svr_base>/install/patch/143749-02
to store log files, create file lists and backup old versions.
 
The files and directories under
<msg_svr_base>/install/patch/143749-02 are as follows:
- There are log files (where YYYYMMDDHHMMSS indicates a timestamp)
  - prepatch script in prepatch_YYYYMMDDHHMMSS.log
  - postpatch script in postpatch_YYYYMMDDHHMMSS.log
  - patch-config script in patch-config_YYYYMMDDHHMMSS.log
  - install-newconfig script in install-newconfig_YYYYMMDDHHMMSS.log
  - uninstall-newconfig script in uninstall-newconfig_YYYYMMDDHHMMSS.log
- There are intermediate file lists:
  - empty_file - an empty file used for diff3 if a version of the file
    does not exist.
  - config.list - list of config files one per line. The first column
    is the location of the template, the second column is the location
    of the active file. This file is generated by the prepatch script.
  - install.list - output of dryrun devinstall. It is used 
    to generate file.list.  This file is generated by the
    postpatch script. 
  - file.list - a list of files that devinstall creates and
    modifies. It is used by the postpatch script to create backups of
    the files under 
      <msg_svr_base>/install/patch/143749-02/backout 
    The file is created in the postpatch script.
  - newconfig.list - This file is generated by patch-config. It is a
    list of "new" candidate config files. It is a subset of the files
    in config.list, i.e. only those that have changed since the last
    version are listed. This file is used install-newconfig and
    uninstall-newconfig as the list of files to operate on.
- The directories are:
  - backout/ - backup of files overwritten during the patch. Generated
    by prepatch script.
  - save/ - where new candidate config files are generated. Backups of
    the active config files at the time patch-config is run are also
    placed here. The files are generated by patch-config.
  - config_YYYYMMDDHHMMSS/ - A backup of config files overwritten by
    the install-newconfig script. This is generated by the
    install-newconfig script.
 
After applying the patch, the configuration files may need to be
upgraded. You must not run the Messaging Server with the old
configuration files. You must install the new configuration files.
 
An overview of the steps is as follows:
- Use the <msg_svr_base>/bin/patch-config utility to generate new
  candidate configuration files. e.g.
    cd <msg_svr_base>
    bin/patch-config install/patch/143749-02
- The <msg_svr_base>/bin/install-newconfig utility will
  install the new candidate configuration  files, e.g.
    cd <msg_svr_base>
    bin/install-newconfig install/patch/143749-02
  install-newconfig has a -f switch to avoid asking for confirmation
  for every file.
- Apply changes to the Directory Server using ldif files. The ldif
  files are located under <msg_svr_base>/lib/patch. See the comments
  in the ldif files for instructions. Note that there is no utility to
  help backout the changes made.
- The uninstall-newconfig can be used to backout the changes made by
  the install-newconfig script. It can be run as follows:
    cd <msg_svr_base>
    bin/uninstall-newconfig install/patch/143749-02
  uninstall-newconfig has a -f switch to avoid asking for confirmation
  for every file.
 
The patch-config script generates new candidate config files. 
- It does not alter your existing configuration.
- The new candidate config files are created under 
    <msg_svr_base>/install/patch/143749-02/save/config
  It has the same directory structure as the <msg_svr_base>/config
  directory.
- The new candidate config files will have a .new extension
- Backups of the existing config files will be copied under the same
  area with no additional extension.
- It does a 3 way diff (diff3) to generate the new candidate config
  file. The three versions are:
  - the old template of the config file (saved during the patch by
    the prepatch script into 
    <msg_svr_base>/install/patch/143749-02/backout/lib/config-templates).
  - the new template of the config file (located under
    <msg_svr_base/lib/config-templates) 
  - the active config file located under <msg_svr_base>/config
  For example, for the imta.cnf config file. The diff3 can be run as
  follows:
    cd <msg_svr_base>
    diff3 -E config/imta.cnf \
      install/patch/143749-02/backout/lib/config-templates/imta.cnf \
      lib/config-templates/imta.cnf > /tmp/imta.cnf.script
  A new candidate file is created by applying the generated ed script, e.g.
    cp config/imta.cnf /tmp/imta.cnf.new
    (cat /tmp/imta.cnf.script; echo '1,$p') | ed - /tmp/imta.cnf.new
- The diff3 may not be able to do a clean merge of the files. In this
  case, the .new file will contain "conflicts". See the diff3(1) man
  page, under the -E switch, for details. The overlapping files from
  both new versions will be inserted into the file delimited by <<<<<<<
  and >>>>>>> lines. The two sections will be separated by a line
  containing =======.
  - In this case, you must manually "resolve" conflicts by picking and
    choosing the correct lines and removing the bracketing lines <<<<<<<,
    >>>>>>>, and =======.
- diff3 only does a lexical merge of the config files. It is strongly
  recommended that you examine and test the new candidate config files
  carefully prior to installing them.
 
The install-newconfig script copies the new candidate config files to
the active configuration
- The list of config files is taken from the newconfig.list file.
- It checks to make sure there are no conflicts to any config file,
  before it starts installing the new config files. If there is a
  conflict in any config file, no new config files will be installed.
- A backup of the current config files are saved under
    <msg_svr_base>/install/patch/143749-02/config_YYYYMMDDHHMMSS
- Note that the candidate config files are created by patch-config, so
  any changes made to active config files after patch-config is run,
  will not be reflected in the new config files. 
- The script will prompt you for confirmation for every new config
  file. Use the -f switch to avoid the prompting.
 
The uninstall-newconfig script restores a backup of the config files
as captured at patch-config time
- The list of files restored is taken from the newconfig.list file
- The backups are taken at patch-config file, and are copied from the
    <msg_svr_base>/install/patch/143749-02/save/config 
  area.
- The script will prompt you for confirmation for every new config
  file. Use the -f switch to avoid the prompting.
 
For HA (High Availability) systems, you should remove the Messaging
Server from the cluster prior to applying the patch. For example, this
could be done by removing the messaging services from the cluster
resource groups.
 
You can not remove this patch without first backing up your message
stores. If you remove the patch and do not restore your databases, the
system will hang on start-msg.
 
README -- Last modified date:  Thursday, August 26, 2010