-------------------------------------------------------------------------------------- ExtremeZ-IP 3.2.2x15 READ ME June 28, 2005 -------------------------------------------------------------------------------------- Group Logic, Inc. 1100 N. Glebe Road Suite 800 Arlington, VA 22201 Phone: 703.528.1555 Fax: 703.528.3296 Email: info@grouplogic.com Web: www.grouplogic.com This document contains additional information not found in the regular documentation. ExtremeZ-IP gives Windows the ability to serve files to Macintosh clients using AppleTalk Filing Protocol (AFP) services over TCP/IP. This functionality allows for better performance (because TCP/IP is generally faster than AppleTalk) and enhanced remote access (because it is based on IP, which is generally easier to route than AppleTalk, and is routed over the Internet). Group Logic greatly values your feedback. If you encounter problems or issues, please contact us using one of the above methods. If you have problems or questions, please consult our Knowledge Base at http://www.grouplogic.com/knowledge -------------------------------------------------------------------------------------- Server System Requirements -------------------------------------------------------------------------------------- ExtremeZ-IP can be run on the following versions of Windows: - Windows NT 4 Workstation or Server - Windows 2000 Professional or Server - Windows XP Professional - Windows 2003 Memory requirements are significant. We recommend that your Windows system have at least 128 MB of RAM installed for optimal performance. You may need substantially more depending on the number of volumes and users and other applications running on the server. ----------------------------------------------- Upgrading from Previous Versions of ExtremeZ-IP ----------------------------------------------- You can install this version of ExtremeZ-IP without uninstalling the previous version. Simply run the new installer. You may receive an inadvertent error message indicating that the service could not be stopped or that a file could not be removed. If you receive this error, the best strategy is to manually stop the ExtremeZ-IP service first, then re-run the installer. You should not need to uninstall the old version. If you are upgrading from ExtremeZ-IP 1.0, please contact Group Logic Support for information about upgrading. -------------------------------------------------------------------------------------- AppleTalk and Services for Macintosh Compatibility Information -------------------------------------------------------------------------------------- If you have the AppleTalk protocol installed, then ExtremeZ-IP will attempt to appear in the Chooser for Macintosh users. If your server does not appear in the Chooser, look for an error in the Windows Event Viewer "Application" section. ExtremeZ-IP will log errors which occur trying to register on the AppleTalk network to this location. Using NT Services for Macintosh (SFM) on the same machine as ExtremeZ-IP is supported in certain configurations, but not recommended. ExtremeZ-IP provides access using TCP/IP, and should yield significant performance gains. On Windows NT, you must install SFM to use AppleTalk. On Windows 2000 and 2003, you can easily install AppleTalk without installing SFM. Windows XP does not support AppleTalk. Please see the ExtremeZ-IP manual for more information. ExtremeZ-IP and Services for Macintosh should not be configured to share the same volumes. Because ExtremeZ-IP and Services for Macintosh use exactly the same format for sharing type and creator information, the two services should not be used together to share the same volumes; otherwise, they will compete for access to the ":AFP_AfpInfo" stream and problems may occur. If ExtremeZ-IP detects that Services for Macintosh is running and sharing the same volume, ExtremeZ-IP will shutdown this volume and log an error to the Event Viewer. Contact Group Logic if you need more information regarding this limitation. If you must continue using Services for Macintosh, then you should be aware of the following issue. If you manually configure ExtremeZ-IP to use the same machine name as SFM, then either SFM or ExtremeZ-IP will not function properly. If SFM is started first, then ExtremeZ-IP will work, but it will not appear in the Chooser; in this situation, ExtremeZ-IP will log an error to the Event Viewer. If, however, ExtremeZ-IP is started first, then SFM will not start up because it cannot register itself on the AppleTalk network. By default, ExtremeZ-IP will not use the same name as SFM. SFM's default name is the name of the Windows computer, while ExtremeZ-IP will use the name of the Windows computer + " IP". Consequently, if you use the defaults for both SFM and ExtremeZ-IP, you will not encounter this limitation. If you run ExtremeZ-IP and Services for Macintosh on the same machine under Windows 2000, you will need to reconfigure the TCP/IP port of either SFM or ExtremeZ-IP (two servers cannot use the same port). Consult the ExtremeZ-IP documentation for information on changing the TCP/IP port for ExtremeZ-IP. Contact Microsoft for information on changing the port of SFM. -------------------------------------------------------------------------------------- Support for Microsoft Networking Domains -------------------------------------------------------------------------------------- ExtremeZ-IP supports Microsoft networking domains, including Active Directory. When you connect to an ExtremeZ-IP server from the Macintosh, you normally enter your user name and password. ExtremeZ-IP will authenticate this account against the primary domain of the Windows machine that it is running on. If this machine is not a member of a domain, then the account must be a member of the local accounts that appear in User Manager. If the machine is a member of a domain, then the user name you supply can be either a member of the primary domain, the local accounts or a trusted domain. You may specify to be authenticated against a specific domain by prefixing the user name with the domain name and a backslash ('\'). For example, to authenticate using the account "rob" from the "MARKETING" domain, you would enter "MARKETING\rob" in the user name portion of your AFP client logon. ExtremeZ-IP uses the same technique for accessing owners and groups for folders in the sharing information using the Finder. Be advised that older Macintosh clients prior to 9.2 have only limited support for passwords longer than 8 characters. -------------------------------------------------------------------------------------- Support for Encrypted Logins (DHX UAM) -------------------------------------------------------------------------------------- ExtremeZ-IP supports Apple's DHX UAM for encrypted logons. The DHX UAM is included with the AppleShare Client 3.8.3 available from Apple. However, there are serious problems in the client as released by Apple. Specifically, it contains debugging code that can cause your Macintosh to crash if you are not running MacsBug. Under Mac OS 9, DHX UAM support has been rolled into AppleShare Client 3.8.5, and should no longer exhibit this behavior. However, it may have other limitations. In particular, there are problems where the DHX UAM can crash under certain circumstances, and changing passwords using the DHX UAM does not work correctly. Apple has corrected the crash in AppleShare Client 3.8.6, and will be correcting the password change issue in the next version of the AppleShare client. Group Logic recommends using the latest AppleShare client available for your Mac OS version. -------------------------------------------------------------------------------------- Known Issues -------------------------------------------------------------------------------------- 1) The Macintosh client may crash if a Windows user moves a large folder hierarchy that the Mac is currently displaying, or removes items from the invisible "Network Trash Folder" while the Mac user has the trash can open. This problem has been determined to be a problem with the Mac OS Finder which affects other AFP servers, including Apple's AppleShare IP and Microsoft's Services for Macintosh. 2) Some Macintosh programs may report a "disk full" error when there is in fact adequate disk space available. This problem has been determined to be a bug in the Mac OS "PBAllocate" routine when used on network volumes that support the 64-bit size parameters, and affects other servers, including Apple's AppleShare IP. 3) If a Macintosh user performs a "Get Info..." on a folder in the Finder, but they do not have permissions to access that folder, some Mac OS versions will hang. This problem affects Mac OS 8.1, and happens with other servers, including Apple's AppleShare IP and Microsoft's Services for Macintosh. 4) Folders shared from Windows XP or 2003 will not have guest access enabled unless the "Network access: Let Everyone permissions apply to anonymous users" Local Security Setting is enabled. See http://www.microsoft.com/technet/prodtechnol/windowsserver2003/proddocs/standard/616.asp for more information about enabling this setting. -------------------------------------------------------------------------------------- Windows Registry Keys -------------------------------------------------------------------------------------- ExtremeZ-IP can be optionally configured through the Windows Registry. Group Logic recommends that this configuration only be performed by advanced users. All of the following registry keys are of type DWORD, and exist in the following location: \HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Most of the following parameters are on/off: a value of 1 enables the particular features, while a value of 0 disables them. If the registry key does not already exist, create a new DWORD key and set it to the appropriate value. Certain keys are "refreshable" - that is, their state can be changed while the ExtremeZ-IP service is running. To dynamically change these settings, make the appropriate registry change and enable debugging to force ExtremeZ-IP to re-read the values. Keys that are not refreshable require that the ExtremeZ-IP service be restarted before they take effect. Key Name Default Refreshable Description -------------------------------------------------------------------------------------------------- DebugLogUseTimeStamps on Yes Adds millisecond timestamps to debug log DebugLogSecurityACLs off Yes Logs security ACL information DebugSessionLifecyclesAlways off Yes Logs session lifecycles regardless of debug logging being turned on; useful for long-term "ghost sessions" problem diagnosis DebugLogsFindingNodes off Yes Logs information about catalog node resolution DebugLogBasicFileIO off Yes Logs basic file IO operations from clients DebugLogLogonInfo off Yes Logs more details about user logons DebugLogLimit 200 Yes # of MB to limit log file size (should be between 1 and 999) DebugLogDetailedNodeConstruction off Yes Logs information about node construction - value of 1 to enable (DWORD key) DebugLogNodeTableLocks off Yes Logs details about threads obtaining and release the lock on the node table DebugLogDeletedPool off Yes Logs details about the size of the deleted pool DebugLogAddNotifications off Yes Logs details about the processing of add notifications DebugLogForkFlusherLocks off Yes Logs details about fork flush processing DebugLogForkFlushQueueLocks off Yes Logs details about primary fork flush queue state DebugLogSecondaryForkFlushQueueLocks off Yes Logs details about secondary fork flush queue state DebugLogPerformance off Yes Logs details about performance of the File Server DebugLogFileAndLine off Yes Logs details about what files and what lines of code have executed DebugLogVolumeListing off Yes Logs details about listing available volumes DebugLogCloseHandle off Yes Logs details about CloseHandle calls UseCriticalSectionMonitor off Yes Logs details about critical sections within ExtremeZ-IP DebugLogThrowThreadException off Yes Server will throw exception and crash, for testing generation of DrWatson logs Contact Group Logic for instructions on usage DebugLogPrintAccounting off Yes Logs details about Print Accounting within ExtremeZ-IP CriticalSectionMonitorLogFrequencyInMilliseconds 60000 Yes The frequency (in milliseconds) of critical section monitor logging (if enabled), default is one minute SupportAFP3 on No Enables support for AFP 3.1 (disabling this feature forces ExtremeZ-IP to support AFP 2.2 only SendPasswordExpirationWarnings off No Enables password expiration notifications PasswordExpirationWarningThreshold 14 days No Number of days prior to expiration to begin warning (value should be between 1 and 366) UseMacStylePermissions off No Enables Mac style permissions. See below. ShowInaccessibleFolders off No Controls whether or not users are able to see folders for which they do not have at least "read attributes" privileges (DWORD key). The "read attributes" property does not imply the ability to read a file or the contents of a folder, but only to be able to see what the permissions and other attributes of the object are. ShowInaccessibleFiles off No Controls whether or not users are able to see files for which they do not have at least "read attributes" privileges (DWORD key). The "read attributes" property does not imply the ability to read the file but only to be able to see what the permissions and other attributes of the file are. UseProfileHomeDirectory off No Controls whether volume enumerations should be filtered by the home directory stored in user's account on the domain controller. Used in combination with ShowInaccessibleFolders (see above). See 3.2.2 enhancements section for more details. UseUserNameAsHomeDirectory off No Controls whether user name will be used as a home directory name for filtering out volume root directory enumeration results. Used in combination with ShowInaccessibleFolders (see above). See 3.2.2 enhancements section for more details. MemoryMappedWrites on No Controls whether memory mapping will be used when writing files to the server UseSeparateSendThread off No Spins off a new thread for each session to handle send requests. This may avoid problems such as freezes, crashes or -36 errors when copying from one EZIP volume to another on Mac OS X. UseSeparateVolumeDeletionsThread off No Handles the processing of files deleted from the volume in its own thread. Use value of 1 to enable. This thread was combined with another volume thread to reduce the amount of resources allocated per volume. Enabling this key will revert ExtremeZ-IP to pre-3.1 behavior. UseTransmitFileForReads off No Use TransmitFile for read calls when applicable TCP_SO_RCVBUF 46720 No size of socket receive buffer TCP_SO_SNDBUF 46720 No size of socket send buffer CreatePrecomposedMacRoman off No Tells ExtremeZ-IP to create new MacRoman files with precomposed Unicode filenames. SleepTimeout 1440 No Amount of time (in minutes) before timing out sleeping sessions. RenameLogAtStartup off N/A At Startup ExtremeZ-IP will rename any existing log with current date and time for easy archiving. RenameCopyDebugLog off No Controls whether hang logs will be created by renaming the log file instead of making a copy of it PrintAccountingLogFilePath N/A No Full path for outputting Print Accounting log information PrintAccountingLogVersion1 off Yes When on will output Print Accounting information in old format PersistentMappedNetworkFolderPrintQueues on Yes Print Queues configured with 'Send To Specified Directory' whose paths are to network folders will map the network folder to a local drive that will persist as long as the ExtremeZ-IP server is running. If the registry key is set to 0, mapped network folders persist only for each individual print job. Version N/A N/A Stores current ExtremeZ-IP version number. Updated automatically. ------------- Legal Notices ------------- Copyright 1999-2005, Group Logic Incorporated. All rights reserved. Support for encrypted logins includes software developed by the OpenSSL project for use in the OpenSSL Toolkit (http://www.openssl.org/). Support for encrypted logins includes cryptographic software written by Eric Young (eay@cryptsoft.com). Support for Rendezvous includes software developed by the Rendezvous Project (http://developer.apple.com/darwin/projects/rendezvous/). ---------------------------------------------------------------------------------------- Version History ---------------------------------------------------------------------------------------- Numbers such as "[#2717]" refer to Group Logic's internal change tracking record. Numbers such as "[x3]" indicate the specific build in which a change was introduced. Group Logic periodically releases "hot fixes" to its products to provide customers with access to bug fixes and new features before a full public release is available. Typically, a version will go through a number of hot fix releases (e.g., 3.1.2x1, 3.1.2x2, etc.) before a full product release. Customers can use this information to evaluate whether to update to the latest hot fix. 3.2.2 (03.02.02.15) - Enhancements * Improved performance of the home directory feature - replaced iterating through volume volume root's children with binary search for the home directory [#4339][3.2.2x13] * Implemented an option for creating hang logs by renaming the log file instead of making a copy of it. RenameCopyDebugLog registry parameter has to be set to 1 in order to enable the feature [#4189][3.2.2x10] * Implemented logging AFPWrite commands when AFP command logging is enabled [#4197][3.2.2x10] * Implemented storing current version number in the registry (stored in the Version string value) [#4184][3.2.2x10] * Further improved Native API logging (suppressed irrelevant messages) [#4020][3.2.2x08] * Implemented using a user name as a home directory for filtering out volume root enumeration results. An ExtremeZ-IP volume can be marked as home directory volume in the registry by adding a "HomeDirVolume=1" string to the volume's parameters multistring; when enumerating the root of such volume, the server will filter the enumeration results by the name of the currently logged in user assuming the user has a home directory in that volume and its name is the same as the user name. The UseUserNameAsHomeDirectory registry parameter has to be set to 1 and the ShowInaccessibleFolders parameter has to be set to 0 in order to enable this feature. [#4088][3.2.2x08] * Improved browsing / enumeration performance [#3887][3.2.2x06] * Improved filtering out inaccessible items during enumeration [#3955][3.2.2x06] * Responding to client DSITickle messages is now off by default [#3889][3.2.2x05] * Improved debug logging (several logging messages have been discarded in order to make debug logs more informative) [#3894][3.2.2x05] * Implemented an option for turning off memory mapping when writing files to the server. Memory mapping is on by default; in order to turn it off, create a DWORD registry value named MemoryMappedWrites in ExtremeZ-IP parameters and set it to 0 [#3776][3.2.2x03] * Implemented home directory feature -- initial volume enumerations can be filtered by the home directory stored in a user's profile on the domain controller. In order to enable the feature, the UseProfileHomeDirectory registry value has to be set to 1 and the ShowInaccessibleFolders registry value has to be set to 0. The Home directory stored in a user's profile on the domain controller has to comply with the following format: drive:[\folder[\folder[...]]]\volume root\home directory if ExtremeZ-IP is running on the domain controller or \\server\share[\folder[\folder[...]]]\volume root\home directory if ExtremeZ-IP is running elsewhere on the network. A home directory has to be located in the root of a volume. This feature allows avoiding full volume enumerations which improves performance on volumes with a large number of folders in the root [#3531][3.2.2x02] * Improved Native API logging (suppressed irrelevant messages) [#3520][3.2.2x01] - Bug Fixes * Fixed displaying inaccessible folders - instead of being grayed out and disappearing when clicked on, those are displayed with the "no access" mark [#4149][3.2.2x14] * Disabled guest access to home directory volumes [#4147][3.2.2x13] * Fixed a crash in the administrator UI when changing color scheme [#3388][3.2.2x08] * Fixed problems with disconnecting a volume that contains drop folders [#3488][3.2.2x07] * Fixed service crashes when shutting down with suspended volumes [#4016][3.2.2x07] * Fixed losing directory change notifications under certain circumstances [#3907][3.2.2x05] * Fixed handling NTFS stream change notifications [#3801][3.2.2x04] * Fixed possible corruption problem when transferring files over 2GB [#3431][3.2.2x01] * Fixed logging errors that could cause service to crash [#3528][3.2.2x01] * Fixed high CPU usage when SLP is not configured correctly [#3603][3.2.2x01] * Fixed high CPU usage on multiple processor systems [#3608][3.2.2x01] 3.2.1 (03.02.01.07) - Enhancements * Reversed separate send thread to off by default - problem in OS X that occurred when performing a volume to volume copy that the separate send thread feature took care of is fixed as of OS X 10.3.5, so the separate send thread feature is no longer required, unless using an earlier version of OS X on the client side. [#3423] [3.2.1x05] * Added registry key called "RespondsToTickles" when set to 0 will change ExtremeZ-IP behavior so that it does not respond to a client-side tickle with a tickle of its own. The default is 1. [#3312] [3.2.1x03] * Added option to prevent users from seeing files for which they do not have at least "read attributes" privileges. The "read attributes" property does not imply the ability to read a file, but only to be able to see what the permissions and other attributes of the file are. [#3268] [3.2.1x02] This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- ShowInaccessibleFiles off Controls whether or not users are able to see files for which they do not have at least "read attributes" privileges (DWORD key) - Bug Fixes * Fixed DHX encryption problem with zero high order byte keys [#3424][3.2.1x05] * Fixed memory leak [#3427][3.2.1x05] * Fixed problem where restarting a volume from the UI crashed the service [#3390][3.2.1x05] 3.2.0 (03.02.00.13) Note: Some changes in this section were first available as 3.1.2 hot fixes. - Enhancements * Added option to prevent users from seeing folders for which they do not have at least "read attributes" privileges. The "read attributes" property does not imply the ability to read a file or the contents of a folder, but only to be able to see what the permissions and other attributes of the object are. [#2911] [3.2x9] This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- ShowInaccessibleFolders off Controls whether or not users are able to see folders for which they do not have at least "read attributes" privileges (DWORD key) * Several enhancements in this release relate to printing. Please see ExtremeZ-IP Print README.TXT if you have print support installed. * Added ability get server statistics using the EZIPUTIL command-line program. Enter "EZIPUTIL SERVER /INFO" from the command-line to receive information on the number of connected users, number of volumes, total number of files and folders across all volumes, and the average number of files and folders per volume. [#2717] * Added ability to set a custom icon for ExtremeZ-IP volumes using the EZIPUTIL command-line program. Enter "EZIPUTIL VOLUME" from the command-line for more information. [#2633] * Added ability to configure ExtremeZ-IP to convert OS X MacRoman filenames into precomposed Unicode on the server. Enabling this feature will allow MacRoman files to be displayed normally in Windows Explorer, and will allow for compatibility with third party applications such as Adobe Acrobat Distiller. This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- CreatePrecomposedMacRoman off Tells ExtremeZ-IP to create new MacRoman files with precomposed Unicode filenames (DWORD key) [#2563] * The default for 'UseSeparateSendThread' is now 'on'. This should eliminate problems when a Mac copies files between two ExtremeZ-IP volumes. However, it also increases the number of threads that will be used, which can cause problems on servers with large numbers of active users and/or volumes. To turn the option off, follow the instructions in the Windows Registry Keys section above. For more information about memory and thread usage, see http://www.grouplogic.com/knowledge/index.cfm/fuseaction/view/docID/122 [#2839][3.1.2x24] - Bug Fixes * Fixed problem where directory names longer than 31 characters could not be found with Mac Panther client. [#2853][#2854][3.1.2x22] * Fixed problem where node name comparisons would crash from NULL name pointers [#2780][3.1.2x21] * Fixed problem where disconnected sessions could not reconnect, sometimes forcing the Mac Client to reboot. [#2772][#2776][3.1.2x21] * Fixed problem where processing session exceptions and disconnecting the session would cause other sessions to hang and disconnect from the volume. [#2772][2776][3.1.2x21] * Fixed problem when removing child nodes from a NULL node would crash [#2760][3.1.2x21] * Properly disconnect sessions that are or have been sleeping. [#2693][3.1.2x20] * Properly handle session exceptions (for example, I/O errors during a write). Shut down the session rather than having the entire application crash. [#2716][3.1.2x20] * Fixed problem where password expiration notifications would only be sent if debugging was enabled and then disabled. [#2520][3.1.2x19] * Fixed problem where clients performing a rename or delete could cause the server to hang for up to 15 minutes before reverting to a normal state. [#2694][3.1.2x18] * Fixed crash where fast creation/deletion/creation/deletion of same file was mishandled [#2632][3.1.2x08] * Fixed bugs where a volume's connected Macs would all disconnect. [#2617] [#2630][3.1.2x08] * Fixed possible hang when the Administrator Files dialog was kept open while the service was running. [#2610][3.1.2x08] * Fixed possible hang during heavy server load. Previous behavior was that all currently active sessions would hang, and new connections could not be made. [#2564][3.1.2x03] * Fixed bug in critical section monitor where critical section monitor logging could be incorrect if a thread entered a single critical section multiple times before leaving. [#2557][3.1.2x01] * Improved ability to handle heavy Windows-side file activity that could previously have caused files and folders to temporarily disappear when viewed from a Mac. By default this change could cause significant additional memory usage for servers with hundreds of ExtremeZ-IP shared volumes. For information about optimizing ExtremeZ-IP on such servers, see the knowledgebase article: http://www.grouplogic.com/knowledge/index.cfm/fuseaction/view_Info/docID/157 [#3007][3.2x12] - Diagnostic Enhancements * New Registry key 'DebugLogPrintAccounting' for tracking Print Accounting information. [#2944][3.1.2x32] * New Registry key 'DebugLogThrowThreadException' for testing whether Dr. Watson crash logging is configured. [#2927][3.1.2x30] This is a string value with the following possible values "AfpCatSearch", "AfpSessionMainThread", "AfpSessionSendThread", "AfpSessionATMainThread", "RascalQueuePAPThread", "RascalSessionMainThread", "RascalSessionLprThread", "WaitForDirectoryChangesThread", "ForkFlusherThread" Contact Group Logic for recommended usage. * New Registry key 'DebugLogCloseHandle' added for enhanced debug logging on CloseHandle calls [#2899][3.1.2x26] * When 'RenameLogAtStartup' and 'UseCriticalSectionMonitor' are both enabled, if the server hangs, a copy of the debug log will be made automatically at 30 seconds, 2 minutes and 10 minutes after the hang is detected [#2855][3.1.2x24] * CPU usage (average / current) Memory Usage: (RAM/ virtual/ current load) added to Date line in debug log [#2754][3.1.2x21] * Date, time and minute log entry added to the debug log on a per-minute basis. [#2749][3.1.2x21] * New registry key 'RenameLogAtStartup' added so that clients will automatically get a log ready to send to Group Logic after restarting the server. [#2750][3.1.2x21] Key Name Default Description -------------------------------------------------------------------------------------------------- RenameLogAtStartup off Renames the debugging log at startup for easy archiving - value of 1 to enable (DWORD key) [#2750][3.1.2x21] * Added code to log when processing large folder hierarchies (dropped in an ExtremeZ-IP volume from the Windows server) takes a long time. This logging will allow us to help diagnose future client hangs. [#2697][3.1.2x18] * Added more logging for tracking notification processing * Added new registry key for tracking what portions of the code have executed Key Name Default Description -------------------------------------------------------------------------------------------------- DebugLogFileAndLine off Logs source file and lines of execution - value of 1 to enable (DWORD key) [#2685] * Added different critical section logging registry key "CriticalSectionMonitorLogFrequencyInMilliseconds", so that we have finer control of granularity. The old registry key "CriticalSectionMonitorLogFrequency" was in minutes and has now been deprecated. * Added support for logging of volume enumeration. This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- DebugLogVolumeListing off Logs details about listing available volumes - value of 1 to enable (DWORD key) [#2556] * Enhanced critical section monitor to provide information about whether a thread is stuck inside a critical section, or is stuck waiting on a critical section. [#2558] 3.1.1 (03.01.01.09) - Enhancements * Improved performance over a WAN (wide area network) connections, especially ones with high bandwidth and high latency. [#2513] - Bug Fixes * Fixed problem with Mac OS X 10.3 (Panther) where reading from the server was very slow. [#2496] * Fixed problem where files with Unicode characters were not accessible from OS 9 if they were placed on the server from OS X. [#2478 and #2534] 3.1.0 (03.01.00.20) - Enhancements * Most enhancements in 3.1 relate to printing and are listed in the ExtremeZ-IP Print Read Me file. * Added full support for Windows 2003 * Reduced consumption of server resources by reducing the number of threads per volume. * The EZIP server will update its Rendezvous registration on the network dynamically. * Removed volume deletion thread and combined it with another thread to reduce memory usage. This feature can be configured from the following registry entry -- enabling this key will revert ExtremeZ-IP to pre-3.1 behavior: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- UseSeparateVolumeDeletionsThread off Handles the processing of files deleted from the volume in its own thread - value of 1 to enable (DWORD key) * Added support for Mac style permissions. Enabling this feature will cause ExtremeZ-IP to limit the permissions on folders to an owner, a single group, "Everyone" and the SYSTEM user. The default behavior of ExtremeZ-IP (and Windows in general) is to allow any number of users and groups to have permissions to a particular folder. By default, changing group permissions from the Macintosh client will change permissions for the primary group only -- any other groups with permissions to that folder will not be changed. Users that wish to restrict access to only the primary group should enable this new feature. This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- UseMacStylePermissions off Enables Mac style permissions - value of 1 to enable (DWORD key) - Bug Fixes * Fixed a potential error that the installer could encounter when installing over a previous version. This could occur if AdjustMacPermissions.DLL or ShareWithEZIP.DLL had been loaded and Windows Explorer was not closed before re-installation. * Fixed a bug that caused print support not to install properly if the trial version had previously been installed. * Fixed bug where Register Server on AppleTalk Network setting would be lost after upgrading. * Fixed crash when Mac client sent commands to EZIP after logout. * Fixed problems with creation and modification dates on Mac OS X. These dates would appear different from the dates appearing on Windows and OS 9 by one or two minutes. * Fixed issue with some UNICODE characters -- copying, deleting or moving files with certain UNICODE characters could fail. * Fixed support for Unicode characters in file and usernames. Previously, files with names containing Unicode characters that were placed on the server from OS X could not be accessed from Mac OS 9. * Fixed problems with volume names containing characters over ASCII 127 (e.g. ""). These volumes were not accessible from OS X. * Fixed a bug that caused files with certain Unicode characters (over character #65,535) to be displayed improperly and fail to copy. * Fixed a potential -50 error on Mac OS X when attempting to copy a file with certain characters in the filename from the client to an ExtremeZ-IP volume (characters 1-31). * Fixed problems with certain characters, including "" "" and "" -- files with this character could not be viewed properly from OS 9. * Fixed possible stall if a large number of files are moved in or out of a shared ExtremeZ-IP volume at a high rate over a sustained period of time. * Fixed potential repeated crash when attempting to access certain files. * Fixed ghosted session issue - the Administrator would list multiple session from a single client machine, and would never disconnect these "ghosted" sessions. * Fixed potential crash when disconnecting a session. * Fixed potential crash when shutting down a session. * Fixed problem with users being unable to connect to a server that is sharing many volumes. * Added support for a separate send thread. This option can help to resolve problems that occur when Mac OS X users copy files from one ExtremeZ-IP volume to another. The problems may appear in the form of Mac users encountering "-36" errors or kernel panic crashes. This feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- UseSeparateSendThread off Spins off a new thread for each session to handle send requests . Use a value of 1 to enable (DWORD key) - Diagnostic Enhancements * About Box now shows the version and build number for the ExtremeZ-IP Administrator and Service separately. * Administrator indicates when debug logging is enabled * Debug log indicates the state of all settings, even for those settings where a registry key is not present. * Shows date and timestamp in log when logging the message Debugging Log Enabled By Administrator * Added support for the monitoring of critical sections within ExtremeZ-IP - this feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- UseCriticalSectionMonitor off Logs details about critical sections within ExtremeZ-IP. Use value of 1 to enable (DWORD key) CriticalSectionMonitorLogFrequency 5 The frequency (in minutes) of critical section monitor logging (if enabled) * Added support for logging of node construction - this feature can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- DebugLogDetailedNodeConstruction off Logs information about node construction - value of 1 to enable (DWORD key) * Added support for logging node table locks, changes to the deleted pool and the processing of add notifications within ExtremeZ-IP - these features can be configured from the following registry entry - use a value of 1 to enable: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Key Name Default Description -------------------------------------------------------------------------------------------------- DebugLogNodeTableLocks off Logs details about threads obtaining and release the lock on the node table DebugLogDeletedPool off Logs details about the size of the deleted pool DebugLogAddNotifications off Logs details about the processing of add notifications * Added support for the logging of non-AFP DSI command information. 3.0.2 (03.00.02.10) - Enhancements * Added experimental support for Windows 2003. Contains a fix for a bug that would cause files to not appear. Windows 2003 is fully supported as of ExtremeZ-IP 3.1 * Added support for server to notify clients that their passwords are about to expire. The logging can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Each key is a DWORD key Key Name Default Description -------------------------------------------------------------------------------------------------- SendPasswordExpirationWarnings off Enables password expiration notifications - value of 1 to enable PasswordExpirationWarningThreshold 14 days Number of days prior to expiration to begin warning - must be between 1 and 99. - Bug Fixes * Fixed Windows 2003 issue - Windows 2003 support was not available in demo version of ExtremeZ-IP. * Fixed issue with password expirations notifications for domain users - added code to switch to the SYSTEM account to obtain expiration information if the logged-in user does not have permission to retrieve it. * Fixed issues with some sessions never disconnecting - added code to timeout these "stuck" sessions. * Fixed potential crash with debug logging when manipulating files or folders with '%' in their name * Fixed issue with volume passwords - creating a new volume with no password and then editing the volume to have a password would prevent users from mounting that volume until ExtremeZ-IP was restarted. * Fixed Windows 2003 issue - installer could not remove a previous version of ExtremeZ-IP. * Fixed minor issues with password notification - notifications did not occur if the PasswordExpirationWarningThreshold was set higher than the system "Maximum Password Age". * Fixed conflict between EZIP and DNS servers -- EZIP would listen on port 53, the same port that DNS servers listen on. * Fixed Windows 2003 issue - files were not visible to the client. * Fixed Mac OS X crash - Macintosh was crashing when attempting to reconnect after network failure. - Diagnostic Enhancements * Added symbols to service and administrator executables so that Dr. Watson crash logs can provide more detailed information. 3.0.1 (03.00.01.01) - Bug Fixes * Fixed permissions issue - folders were not visible if the SYSTEM user was not given read permission. 3.0 (03.00.00.00) - Enhancements * AFP 3.1 support is on by default for the server This can overridden with the registry key: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\SupportAFP3 This is a DWORD value and should be set to 0 to disable AFP 3.1 support and support only AFP 2.2 * Mac OS X computers can use filenames longer than 31 characters. * Mac OS X computers can access files larger than 2GB. * Mac OS X computers can access volumes larger than 4GB. * Added support for Rendezvous to allow Mac OS X clients to easily find and connect to the ExtremeZ-IP server. Rendezvous is based on the multicast DNS protocol and does not require AppleTalk on the network. Rendezvous support can be enabled from Windows 2000 and XP, but not NT. * Significant enhancements to the EZIPUTIL command line utility - Type EZIPUTIL.EXE to get help on the commands * Enhancements to the "Create Volume" dialog to allow new folders to be created * Free disk space reported to Macintosh clients now properly reflects user disk quotas * Unicode File Names: With Mac OS X, users can create files using the Unicode character set, which is used worldwide to support the wide variety of characters found in different languages. * Optimizations for Enumerating Folders, Catalog Searches: Through AFP 3.1, Mac OS X clients gain improvements that allow applications to discover the contents of folders more efficiently than in previous versions. With this change, the client and server are able to communicate significantly more information with each transaction on the network, which results in improved performance. - Bug Fixes * Users that were connecting but not logged in yet appeared with random characters for their user name * Fixed bug where error codes were not returned properly on Read operations when using newline masks. This was introduced in 2.1 and caused imports by MacManager to fail. * ExtremeZ-IP now detects if a client has disconnected but not cleaned up their Network Trash Can Folder, and cleans up the folder itself. This resolves a problem where servers with a lot of users would slowly accumulate Network Trash Can folders and cause logons to slow down over time as clients enumerated all of the trash cans at startup. * Removed multiple lock contention issues when using the ExtremeZ-IP Administrator. This could potentially have caused problems if the Administrator failed or locked up, preventing new users from connecting, the service from stopping, or connected users from opening files. This may also have resulted in a build of TCP/IP connections in a "CLOSE_WAIT" state after the Administrator failed. These issues could have occurred when displaying active sessions or open files, when sending messages, when manually closing files, or when manually disconnecting users. * Made fixes that significantly improve server responsiveness to client requests, especially when the client is Mac OS X 10.2 or later. This will resolve problems with "slow network performance", for example when saving documents from various applications. * Fixed crash in the server that could occur if a Macintosh attempted to close a file that it had open but which had been closed manually using the ExtremeZ-IP Administrator program. * Improved recovery of server when the ExtremeZ-IP Administrator program goes down unexpectedly; should improve the ability to re-connect and manage the service without having to restart. * Made fixes that allow multiple concurrent API calls, and allow API calls to be simultaneous with use of the Administrator. * Fixed a bug in AFP3 support that prevented folders from being copied from server volume to the client. * Fixed a bug in AFP3 support that prevented files larger than 4 GB from being copied from client to server. * Fixed a bug that prevented the use of international characters in usernames and passwords. * Fixed a bug in AFP3 support that prevented files from being locked and unlocked. * Fixed a bug that prevented some files and folders from appearing in file dialogs of classic applications running under Mac OS X. * Fixed bugs that prevented opening and saving documents from Microsoft Office X applications when AFP3 support is enabled. * Fixed a bug in which ExtremeZ-IP Drop Boxes work only if the user that logged in as a member of the Administrators group. - Diagnostic Enhancements * The ExtremeZ-IP Administrator now displays the full version number in the About Box (e.g., 3.0x01) * The ExtremeZ-IP debug log now contains the full version and build number (e.g., 3.0x01) * Numerous debug logging configuration options can now be set from the debug dialog in the ExtremeZ-IP Administrator. Changes to the options now take place by clicking "Enable log" immediately, instead of requiring the ExtremeZ-IP service to be restarted. * Improved debug logging for volume startup and indexing to diagnose indexing problems * Improved debug logging on memory allocation failures to capture machine memory status * Improved debug logging to diagnose slow AFP logon problems * Improved debug logging for SLP lookup requests to diagnose SLP network problems * Added optional millisecond timestamps to debug log; can be enabled with registry key \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\DebugLogUseTimeStamps this is a DWORD key with value of 1 to enable * Improved debug log timestamps to only log on new lines * Made logging of security ACLs optional; can be enabled with registry key \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\DebugSecurityACLs this is a DWORD key with value of 1 to enable * Improved debug logging of connections / disconnections to diagnose "ghost sessions" * ExtremeZ-IP can limit the size of the log file. By default begin wrapping at 200MB. The value can be changed as follows: In the registry, set \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\DebugLogLimit this is a DWORD key with value of 'x', when x is greater than zero it will enable limiting the size of the log file. The value of 'x' is in megabytes. If no key is present, the default value is 200 (i.e., 200MB). Behavior: When a line being written to the log would pass the specified megabyte limit of log file size, a line will be written to the beginning of the file that wrapping has occurred and entries will be added from the start of file until they wrap again. When ExtremeZ-IP starts or restarts entries are always added at the current end of file. No attempt is made to keep track of the last offset if the file has wrapped. If timestamps have been enabled then the viewer of a wrapped log file can determine the last valid entry when the timestamp value suddenly changes to a lesser value. * Numerous improvements to debug logging to assist in diagnosing problems. The logging can be configured from the following registry entry: \HKLM\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters\ Each key is a DWORD key with a value of 1 to enable; default values are indicated in () Key Name Default Description -------------------------------------------------------------------------------------------------- DebugLogUseTimeStamps on Adds millisecond timestamps to debug log DebugLogSecurityACLs off Logs security ACL information DebugSessionLifecyclesAlways off Logs session lifecycles regardless of debug logging being turned on; useful for long-term "ghost sessions" problem diagnosis DebugLogsFindingNodes off Logs information about catalog node resolution DebugLogBasicFileIO off Logs basic file IO operations from clients DebugLogLogonInfo off Logs more details about user logons DebugLogLimit on DWORD value specifying # of MB to limit log file size default value is 200MB if not specified 2.1.1 (02.01.01.00) - Bug Fixes * Internal changes to improve performance on servers with many files and/or under heavy load - In some cases, these changes will result in significant gains in file manipulation and directory browsing, and possibly reduced CPU utilization, compared to all previous versions of the server. - There will be a slight increase in memory usage in the server compared to earlier versions. * Fixed potential crash of the server when Macintosh clients are opening files in QuarkXPress 4.1 * Fixed problem with server not responding to SLP lookups that include a "previous responders" list 2.1 (02.01.00.00) - Enhancements * User interface provides more status information, control * Significantly better support for larger, more complex file systems * Enhanced Explorer plug-in for adjusting permissions * Command line utility (EZIPUTIL) can remove shared volumes - New Features * Registry value to specify IP addresses reported to client when connecting via AppleTalk - Other Changes * Default SLP scope is now "Local Services" 2.0.5 (02.00.05.00) - Minor updates for measuring internal performance. 2.0.4 (02.00.04.00) - Fixed a potential crash when receiving print jobs from Macintosh clients. 2.0.3 (02.00.03.00) - Bug Fixes * Fix for password changing on networks with domain controllers. - Enhancements * Better logging options for authentication problems. * Support for registry key to specify SLP host and scope. 2.0.2 (02.00.02.00) - Bug Fixes * Fix memory leak when modifying same file repeatedly. * Added support for drop boxes. 2.0.1 (02.00.01.00) - Bug Fixes * Sherlock searches with capital letters work correctly. * Fixed a problem where read operations beyond the end-of-file might cause the server to appear locked up. 2.0.0 (02.00.00.00) - New Features * Remote Administration * Support for optional IP printing services * Explorer plug-ins for sharing Macintosh volumes, adjusting permissions * Command line utility (EZIPUTIL) for creating shared volumes - Enhancements * Much faster directory access * Much faster Sherlock searches (support for Catalog Search operations) * Access to log information from within ExtremeZ-IP Administrator * Better support for certain Macintosh applications (file ID support) * Better support for access permissions and restrictions * Better move, rename, delete and copy operations * Resizable windows in ExtremeZ-IP Administrator * Support for longer file extensions for type/creator mappings - Bug Fixes * Support for NTFS volumes with disabled 8.3 names. 1.1.3 (01.01.03.00) - Enhancements * Better read and write performance. * Better use of memory resources. * Ability to ignore Macintosh requests to change permissions. * Minor installer enhancements for updating existing installations. - Bug Fixes * Fix for situations where type/creator information would not be flushed to disk. * Fix for problem connecting to server via the Chooser. * Fix for problems starting up if SYSTEM account did not have access. * Fix for logging being accidentally left on, causing huge log files. 1.1.2 (01.01.02.00) - Enhancements * Windows 2000 support enabled by default. * Better read and write performance, especially for fast networks. * Made TCP port for server configurable via registry key. * Better handling of file-modified notifications, resulting in better performance. - Bug Fixes * Better handling of specific AFP user/group mappings. * Fixes for problems during index rebuilding that would cause certain files to be unavailable to Macintosh users. 1.1.1 (01.01.01.00) - New Features * More control over security settings. * Better status information for volumes. - Enhancements * Better write performance, especially on machines with large amounts of memory. * Better read performance, especially for Finder copies. - Bug Fixes * Better support for password changing on Macintosh. * Better support for viewing and editing permissions from a Macintosh, especially in multi-domain environments. * Fixes for problems where files might become invisible to Macintosh users even though they existed on the server. * Fix for file/directory names beginning with period (.). * Fix for PBHCopyFile routine when destination name is empty. * Fix memory leak for threaded copy operations. * Support for creating volumes that are already read-only. * Fix for deleting nested directory hierarchy on Windows. 1.1.0 (01.01.00.00) - New Features * Support for Windows NT on the Alpha processor. * Faster startup indexing. * Performance improvements. * Better SFM compatibility. * Custom color icons for new volumes. * Support for DHX UAM, allowing encrypted logins and long passwords. * Support for Mac OS 9 Network Browser. * Support for hiding volumes that user cannot access. * Support for default security settings (i.e., SYSTEM account not granted access). * Network Trash Folder improvements. * Support for reporting password expiration to client. - Bug Fixes * Problems where ExtremeZ-IP might crash when running with ColorCentral. * Incorrect modification times on folders and files. * Volumes ending in space (' ') or period ('.'). * Memory leak when deleting a volume. * Multihomed machines. * Directories "moved" into an ExtremeZ-IP share would show up empty to Macs. * Fixes for reading in "new line" mode in certain Macintosh programs. 1.0.0 (01.00.00.00) - Initial product release. Copyright (c) 1999-2005 Group Logic Incorporated. All rights reserved.