Date: 06-05-2008 Subject: PATCH RELEASE 9.3A DATA Manager Files These release notes pertain to the following programs or files: SUNDM.EXE 9.3A 05 Jun 2009 9,3,1,500 SUNWSRV.DLL 9.3Aa 05 Jan 2009 9,3,1,101 *============================================================================== Notes for DOCUMENTATION: - The "UPDATE_FILE_ATTRIBUTES={on|off}" keyword was added in release 9.1A. This keyword is implemented for a Primary Replication Server. By default the attributes for files are replicated to the Backup/Secondary Replication Servers when this keyword is not used in the configuration file for the Primary Replication Server. If the UPDATE_FILE_ATTRIBUTES keyword is set to 'off', the attributes for files are not sent to the Backup/Secondary Replication Servers when the files are replicated. *============================================================================== The following files have been changed as follows: ------------------------------------------------------------------------------- SUNDM - A new keyword named 'DM_NO_SHUTDOWN={on|off} has been added for the Data Manager. This keyword can be used to prevent a user logoff or shutdown while the Data Manager is still running. When this keyword is to be used, it should be placed in the [environment] section of the SunDM configuration file. If this keyword is not specified, the default state if 'off' which always allows a system shutdown. - Two new keywords have been added to the Administration Services to give the user some control over the record type and size used for output to the Data Manager log file. See the 'ADMIN' section in the 'pat93a.me' readme file for more details. - Modified the Data Manager to support encryption for the enhanced COPYFILE instructions. See the 'pat93A' readme for details. - Corrected a problem in ODBC support for the Data Manager that would cause a socket communications error to occur when a SQL INSERT was performed using the Data Manager. - Corrected a problem for the AAMDEX, INDEX, and SORT instructions where the S and/or P options did not work when the target character was a single blank (WS) character. Example of problem command line: sort "in,out -S100## ,1-6", SUNDM="127.0.0.1" - Corrected a problem where a Data Manager was trying to logon to an indeterminate/non-existing ip address after processing the LS_ADDR keyword. This problem only existed when the Data Manager was attempting to contact a License Server. ------------------------------------------------------------------------------- SUNDM REPLICATION SUPPORT - The replication message traffic counters have been changed to 64 bit values. This change minimizes a counter overflow. - Added primary file caching to reduce the number of open actions when file synchronization is being done. If a file size is less than the cache size, it is opened and the whole file is read into the cache. The data is processed from the cache. If a file size is larger than the cache size, the partial read routines are used to process the file data. A new keyword named 'CACHE_BUFFER_SIZE={kb} has been added for the [replication] section in a SUNDM configuration file. This keyword can be used to set a user defined cache size or to disable the caching. If this keyword is not specified, the replication caching is enabled with a default cache size of 5MB. If this keyword is specified with a zero value, the replication caching is turned off. - Changes have been made that allow the Primary Replication Server to track whether a rollover situation is possible or not. If a failure occurs that brings down the Primary Server, the Primary Server can be started without user intervention if no rollover was possible. In this case, this change eliminates the need to use the '-b' bypass option or have to delete the '.fm' control file. - Added time stamp and attribute replication for directories. Under Windows, create and modification times are replicated from the primary to a secondary/backup server. Under Unix, the modification times are replicated. Under Windows the hidden attribute is replicated for a directory. Under Unix the write attributes are replicated. A new keyword named 'UPDATE_DIR_ATTRIBUTES={on|off}' has been added. This keyword can be used to enable or disable the replication of time stamp and attributes for directories. This keyword state is ON by default. Note: 1. The replication of time stamps and attributes for directories requires that both UPDATE_FILE_ATTRIBUTES and UPDATE_DIR_ATTRIBUTES keywords must be set to ON. By default, these keywords are ON when they are specified in the configuration file. - A change was made to not send a scan transaction to a secondary when there are no secondary servers configured for scanning. - Modified the file recovery error message that are logged to include the file names that are processed. - Added log entries to give a better sense of the startup progress during the control file transfer and synchronization phases. - Modified the synchronization processing by a Secondary/Backup Replication Server to improve the performance when checking the current file timestamps and attributes. - Modified the startup processing to verify that a drive is on line before attempting to create a directory. - Modified the Primary Server scanning process to detect that Network drives are off-line and attempt to reconnect these drives when the Primary scanning starts. - Modified the '-f' Data Manager operation to force a faster termination for the Data Manager by not waiting for replication cleanup operations. - Modified the write data function for a Secondary Replication Server to optimize the data output by merging multiple blocks of data into a single writing action for blocks with consecutive file addresses. - The startup processing for a Primary Server has been changed to contact all configured secondary servers. The startup actions for the Primary Server are performed as follows: 1. If a secondary has taken control to become a rollover primary, the Primary Server becomes a secondary. 2. If all secondaries can be contacted and no rollover is found, the Primary Server continues to startup as the primary. 3. If the Primary Server can not contact all secondaries to determine the state for a secondary, the Primary Server tries to contact the secondaries for a maximum time specified by a keyword named 'START_WAIT_TIME={seconds}'. The default retry time is 300 seconds ( 5 minutes ). If the retry time expires without finding a rollover or contacting all secondaries, then the Primary Server shall terminate and exit. - Corrected a problem where a Secondary/Backup would terminate when a lost connection occurred while receiving the control data from the Primary Replication Server. - Corrected a problem where a secondary could keep files opened longer than expected after a replication delete file transaction was performed. - Corrected a problem with the error list at a Secondary/Backup Replication server after a '-u' command was performed at the Primary Replication server. The symptom of this problem was that any files on the error list at the Secondary/Backup when the '-u' command was performed would be excluded from any further updates from the Primary. - Corrected a problem where a Backup/Secondary Server was always renaming files to be deleted when the Primary keyword 'SECONDARY_SCAN=on' was used. The corrective change is to allow deleted files to be renamed when both the 'SECONARY_SCAN=on' and the 'NO_FILE_DELETES=on' keywords are used. Otherwise, the files are now deleted when only the 'SECONDARY_SCAN=on' keyword is used without the 'NO_FILE_DELETES=on' keyword being specified. Note: If renamed files exists with a leading '_' character, then the user may want to specify the 'ALLOW_ALL_FILES=on' keyword at the Primary server to insure that these files at the Backup/Secondary Server are deleted when only the 'SECONDARY_SCAN=on' keyword is used without using the 'NO_FILE_DELETES=on' keyword. -------------------------------------------------------------------------------