General Parameter Registry Keys -- Refreshable

The following keys control certain features or behaviors of Access Connect. The keys in this section are refreshable and take effect when the Refresh Registry button is clicked on the Settings dialog of the Access Connect Administrator or when the service is started.

These keys should be added in the following registry location:

\HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ExtremeZ-IP\Parameters4\Refreshable

AccessRightsExpirationInterval

• Description: How long, in minutes, Access Connect will cache user access rights before reloading the access rights from disk. Access rights must be periodically reloaded if group membership changes are to be noticed.
• Default: 5
• Refreshable: Yes

AdjustModificationDates

• Description: When this Registry key is set to '1', for any file where the modified date is older than the created date, Access Connect will change the modified date presented to the Mac client to be equal to the created date. The actual modified date on disk will not be changed as a result of enabling this key. Enabling this feature may have a significant impact on workflows and is not recommended without extensive testing.
• Default: 0
• Refreshable: Yes

AllowPartialHexFooMatch

• Description: Whether Access Connect does partial matching of OS-9 style ("hex foo") filenames. This can be disabled to restore pre-6.0.3 functionality, but doing so could cause failures is certain Mac applications.
• Default: On
• Refreshable: Yes

CopyFileExBypassCacheThreshold

• Description: Files larger than this size will bypass the system cache when copied server-side.
• Default: 2000 [MB]
• Refreshable: Yes

DefaultDomainName

• Description: DefaultDomainName allows for the specification of one or more default domains. At login, Access Connect will attempt to log the user into the specified domains in the order they appear in the list.
• Default: Off (blank string)
• Type: Multi-string
• Refreshable: Yes

DFSSyncInterval

• Description: [DFS capable servers only.] How often, in seconds, the DFS namespace will be reenumerated. If this is 0 then the lowest value for TimeToLive will be used.
• Default: 0
• Refreshable: Yes

DFSUpServerRecheckInterval

• Description: [DFS capable servers only.] How often, in seconds, Access Connect will check to see if a server marked as down is back online. It takes a long time for the check to timeout if the server is still down, so this should generally be larger than DFSDownServerRecheckInterval (below).
• Default: 300
• Refreshable: Yes

DFSDownServerRecheckInterval

• Description: [DFS capable servers only.] How often, in seconds, Access Connect will check to see if a server marked as up is has gone offline. Since an up server responds immediately, this can be done frequently as compared to DFSUpServerRecheckInterval (above).
• Default: 60
• Refreshable: Yes

DefaultGlobalUmask

• Description: UNIX permissions bits that should be removed from any client requests to modify UNIX permissions. For example, if the client attempts to set UNIX permissions to 777 and DefaultGlobalUmask is 022, UNIX permissions will be set to 755.
• Default: 0
• Refreshable: Yes

DefaultGlobalPermissions

• Description: UNIX permissions bits that should be added from any client requests to modify UNIX permissions. For example, if the client attempts to set UNIX permissions to 700 and DefaultGlobalUmask is 022, UNIX permissions will be set to 722.
• Default: 0
• Refreshable: Yes

DFSUseAdminNamespaceName

• Description: Whether the Access Connect DFS code uses the namespace name as entered (if enabled), or as it appears in the DFS enumeration (if disabled).
• Default: Off
• Refreshable: Yes

DisplaySerialInUI

• Description: Whether or not the Access Connect Administrator (local or remote) will display the serial number in the About Box and Licensing dialog.
• Default: On
• Refreshable: Yes

EnumerationPerformanceOnLocalVolume

• Description: Enables Enumeration Performance on local volumes. Set to 1 to enable.
• Default: Off
• Refreshable: Yes

EventLogOnWrap

• Description: EventLogOnWrap determines whether a message will be written to the event log every time the change journal wraps.
• Default: On
• Refreshable: Yes

FullCrashDump

• Description: When set to 'On' Access Connect will generate larger crash dumps containing more detailed debugging information. These will typically be 100 to 200 MB in size, instead of the 2 to 12 MB in size when this setting is set to 'Off'.
• Default: Off
• Refreshable: Yes

ForcedPasswordChangePeriod

• Description: The period, in days, before a user's password expires that Access Connect forces the user to change their password. This can be used to help ensure that users change their passwords before expiration.
• Default: 0
• Refreshable: Yes

IgnoreExchangeFileSecuritySwap

• Description: Whether or not the server ignores code to swap Access Control Lists (ACLs) during an ExchangeFile operation. This setting is only honored when UNIX permission support is disabled. When enabled, the file server will emulate the (incorrect) behavior in Access Connect 5.1.3 and earlier.
• Default: Off
• Refreshable: Yes

IgnoreOffspringCount

• Description: When set to 'On', Access Connect will not count the number of items in any folder during an enumeration. This could potentially speed up enumeration performance, but might effect some third party applications. It is recommended you consult with GroupLogic Support before enabling this setting.
• Default: Off
• Refreshable: Yes

IdleTimeoutOpenForks

• Description: If idle users are timed out (see above), this controls the amount of time Access Connect will wait before disconnecting an idle user with open forks. These users could potentially lose data. Setting this to 0 will prevent idle users with open forks from being timed out. This value is specified in minutes.
• Default: 1440 [24 hours]
• Refreshable: Yes

IdleTimeoutNoOpenForks

• Description: If idle users are timed out (see above), this controls the amount of time Access Connect will wait before disconnecting an idle user with no open forks. Setting this to 0 will prevent idle users with no open forks from being timed out. This value is specified in minutes.
• Default: 360 [6 hours]
• Refreshable: Yes

KeepOwnerSetByWindows

• Description: Whether or not Access Connect will keep the owner of files as set by Windows. If disabled, Access Connect will set the owner to the user that create the file. This can differ from the owner assigned by Windows, as files created by members of the Administrators group are assigned an owner of "Administrators" by Windows.
• Default: Off
• Refreshable: Yes

LoginMsgW

• Description: The logon message sent to users immediately after login. This setting is normally edited through the Access Connect Administrator, but this setting can be edited directly in order to support longer logon messages. The Administrator restricts logon messages to 199 characters for compatability for OS 9, but by editing this registry value directly, the message length can be increased to 1024 characters. Note that while Access Connect supports logon messages up to 1024 characters, current versions of Macintosh OS X will fail to display messages longer than 500 characters.
• Default: Blank
• Refreshable: Yes

MaxNodeTableSize

• Description: Size of the node table cache (in MB). The cache contains a list of information about files that are being shared. Setting a different cache size allows you to adjust the tradeoff between performance and memory usage. Access Connect retains information in RAM for the most recently accessed files, up to the limit specified. If a Mac user requests a file that is not in the node table cache, Access Connect goes to disk to retrieve the information and stores it in the node table. If the maximum cache size has been reached, Access Connect discards the oldest entry in the node table. You can specify the maximum size in the Cache Size text box of the File Server Setttings dialog. The maximum allowed size is 500MB. It is possible to set a higher size via a registry key, but doing so may cause severe problems. contact GroupLogic Support if you are interested in experimenting with sizes greater than 500MB.
• Default: 20
• Refreshable: Yes

MaxDuplicateSessionsWaiting

• Description: The maximum number of sessions that can be waiting for reconnect from a single IP address with a single username.
• Default: 5
• Refreshable: Yes

MappingFlushFrequency

• Description: How often, in seconds, Access Connect flushes new ID/index pairs to disk. Decreasing this setting will reduce performance, but can ensure that newly created file IDs get committed to disk in the event of a server crash.
• Default: 600 [10 minutes]
• Refreshable: Yes

MigrateHiddenSMBShares

• Description: If disabled, the file server will not migrate hidden SMB shares.
• Default: 0
• Refreshable: Yes

MaxIORequestsPerSession

• Description: The maximum number of simultaneous outstanding I/O requests for an individual session.
• Default: 250
• Refreshable: Yes

MaxEnumerationListSize

• Description: The maximum amount of memory, in MB, Access Connect will devote to caching enumeration information.
• Default: 32
• Refreshable: Yes

MaxIdPathMapSize

• Description: The maximum size, in megabytes, of the ID/path map. This in-memory data structure is only used in environments where at least one Access Connect volume is on a non-NTFS filesystem.
• Default: 800
• Refreshable: Yes

PasswordExpirationReminderInterval

• Description: How often, in minutes, to send connected users a message indicating that there password is about to expire. The "SendPasswordExpirationWarnings" setting must be enabled for this feature to take effect.
• Default: 0
• Refreshable: Yes

PruningInterval

• Description: PruningInterval specifies the frequency that Access Connect will walk its list of Macintosh file IDs and remove obsolete records.
• Default: 10080 [one week]
• Refreshable: Yes

PasswordExpirationWarningThreshold

• Description: Number of days prior to expiration to begin warning (value should be between 1 and 366). This can also be configured in the Access Connect Administrator.
• Default: 14 Days
• Refreshable: Yes

ReplayCacheSize

• Description: Size of the replay cache (number of cached reply requests).
• Default: 32
• Refreshable: Yes

RetryOpeningReparsePoints

• Description: Whether or not Access Connect should retry opening reparse points when encounting a reparse error.
• Default: Yes
• Refreshable: Yes

ReconnectServerKeyLifetime

• Description: Number of minutes that the reconnect server key is valid before a new key is automatically generated.
• Default: 2 weeks (20160 minutes)
• Refreshable: Yes

ReconnectUAMExpirationInterval

• Description: Number of seconds that reconnect credentials are valid before they expire.
• Default: 2 days (172800 seconds)
• Refreshable: Yes

ReconnectTimeout

• Description: Number of minutes session waiting for reconnect will wait before disconnecting.
• Default: 5 minutes
• Refreshable: Yes

ReindexOnWrap

• Description: ReindexOnWrap determines whether volumes will be automatically reindexed when the change journal wraps.
• Default: On
• Refreshable: Yes

ServerSupportsReconnectUAM

• Description: If the server supports the Reconnect UAM.
• Default: On
• Refreshable: Yes

SetEOFOnResize

• Description: SetEOFOnResize governs whether end of file for files being written to the server is updated as the file is in the act of being written.
• Default: Off
• Refreshable: Yes

SendPasswordExpirationWarnings

• Description: Enables password expiration notifications. This can also be configured in the Access Connect Administrator.
• Default: Off
• Refreshable: Yes

ServerEmbedsPasswordInReconnectCredential

• Description: If the server embeds the user's password inside its reconnect credential. Doing this allows users to reconnect even after the server has been rebooted because all authentication data exists inside the credential. However, enabling this feature does mean that all users passwords are encrypted with the same server key.
• Default: On
• Refreshable: Yes

SleepTimeout

• Description: Amount of time (in minutes) before timing out sleeping sessions.
• Default: 1440
• Refreshable: Yes

ServerTruncatesOS9Comments

• Description: Truncates OS 9-style comments to 127 bytes, rather than the default of 199 bytes. Enabling this key fixes a bug in Photoshop CS2, which crashes when encoutering comments that are larger than 127 characters. Even though Photoshop CS2 is an OS X application, it makes a request for OS 9 comments. This problem is known to occur in Mac OS 10.4.6.
• Default: Off
• Refreshable: Yes

ServerIgnoresReadOnlyFolders

• Description: If enabled, the server will not display any folders as locked, even if they are marked "read-only" in Windows. The read-only attribute on Windows does not truly map to the Macintosh locked attribute, since read-only directories on Windows can be renamed, deleted and have files added and removed from it. Folders are marked read-only on Windows if they have a customized view, such as a custom icon. Starting with OS 10.4.6, folders over the network can appear as locked. Enabling this setting will also cause the server to ignore requests to change the locked status of the folder.
• Default: On
• Refreshable: Yes

ServerDisconnectsGhostedUsers

• Description: Whether or not the server will disconnect ghosted users when clients log in. A ghosted user is defined as a user that had logged in from the logging-in user's machine with the same user/domain name as the logging-in user. This feature can ensure that clients that are waiting for reconnect get disconnected before the reconnect timeout in the event that the clients do not reconnect.
• Default: 1
• Refreshable: Yes

ServerMigratesDotUnderscoreFiles

• Description: Whether or not Access Connect will migrate SMB dot underscore (._) files to resource fork and finder information streams.
• Default: Yes
• Refreshable: Yes

ServerDeletesMigratedDotUnderscoreFiles

• Description: Whether or not Access Connect will delete SMB dot underscore (._) files after migrating to resource fork and finder information streams.
• Default: No
• Refreshable: Yes

ServerNotificationTime

• Description: How often, in seconds, the server will send clients notifications that the volumes they have open have changed. Set 0 to disable server notifications.
• Default: 10
• Refreshable: Yes

ServerResetsPermissionsOnMove

• Description: Whether or not Access Connect will reset permissions on folders after a move so that the folder inherits from its new parent folder.
• Default: No
• Refreshable: Yes

ServerRemovesTemporaryItems

• Description: Whether or not Access Connect will delete "Temporary Items" and ".TemporaryItems" folders at shutdown.
• Default: No
• Refreshable: Yes

ServerCreatesEmptyStreams

• Description: Whether or not the service creates empty alternate data streams as a marker that there are no dot underscore files to migrate. This feature was enabled in earlier versions of Access Connect but was disabled because the creation of so many empty alternate streams could interfere with Windows-side activity, such as Rampage.
• Default: Off
• Refreshable: Yes

ServerConvertsShortcutsToLinks

• Description: Whether or not the server displays Windows Shortcut (.lnk) files to Macintosh clients as symbolic links.
• Default: On
• Refreshable: Yes

SupportACLs

• Description: Whether or not the server supports Access Control Lists (ACLs).
• Default: Off
• Refreshable: Yes

ServerOpensExchangeFileHandlesByFullPath

• Description: Whether or not the server opens folders by full path (as opposed to file ID) when doing ExchangeFiles operation. This setting is useful on Windows 2008, which can blue screen if Mac clients save files to an Access Connect volume through a client application using the ExchangeFiles command. This command is used by a number of applications, including Microsoft Word. By opening folders by full path rather than ID during ExchangeFile processing, this Windows 2008 bug can be bypassed. Microsoft is aware of the issue and will be issuing a fix at an unspecified date. Because this change is only useful as a way to workaround the Windows 2008 issue, this setting is ignored on Windows 2003.
• Default: On for Windows 2008 (and later), off for earlier OS versions
• Refreshable: Yes

ServerAllows8Dot3Names

• Description: Whether or not the server files supports the access of files and folders using their Windows 8.3 filename. While Access Connect does not communicate these 8.3 filenames to Mac clients, workflows such as Prinergy that involve Windows and Mac components can result in Mac clients making requests for files and folders by these names.
• Default: Off
• Refreshable: Yes

ServerAllowsLargeEABuffers

• Description: Whether or not Access Connect supports extended attributes buffers larger than 4Kb. As of Mac OS 10.5.6, the "ditto" command fails to duplicate files containing extended attributes when these files are located on a remote server. Enabling this setting allows Access Connect to workaround this client-side issue.
• Default: Off
• Refreshable: Yes

SupportSCP

• Description: Whether or not the server will register itself in Active Directory as a Service Connection Point (SCP).
• Default: On
• Refreshable: Yes

ShowInaccessibleFiles

• Description: Controls whether users are able to see files for which they do not have at least "read attributes". 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.
• Default: On
• Refreshable: Yes

ShowInaccessibleFolders

• Description: Controls whether users are able to see folders for which they have neither read nor write access
• Default: On
• Refreshable: Yes

ServerUsesRelativeHandles

• Description: Controls whether or not Access Connect will open file handles relative to folder handles. This setting should be disable for users of CommVault Simpana software.
• Default: On
• Refreshable: Yes

SlowAFPCommandLogFrequency

• Description: Frequency, in seconds, in which the server logs information about slow AFP commands. Setting this value to 0 will disable slow AFP command logging.
• Default: 3600 (1 hour)
• Refreshable: Yes

SupportCopyFileEx

• Description: Whether or not the server supports new server-side copy semantics for improved performance.
• Default: Yes
• Refreshable: Yes

TimeoutIdleUsers

• Description: Controls whether or not idle users are timed out after some period of time.
• Default: Off
• Refreshable: Yes

UnixOwnerPermissionsMode

• Description: This registry key is in effect only when Support UNIX permissions and ACLs is enabled in the product. Gives the administrator full control over files that have no owner or the owner is disabled or unreachable.
• Default: 7 (on upgrades it will be 0)
• Refreshable: Yes

UNIXCalculatedPermissionsMode

• Description: Determines how UNIX permissions are calculated for files and folders that don't already have UNIX permissions assigned. If 0, the Windows GetEffectiveRightsFromACL call is used to determine UNIX permissions. If 1, calls to GetEffectiveRightsFromACL are avoided when possible to improve performance. If 2, UNIX permissions are always returned as 777 (full rights) if no explicit UNIX permissions have been assigned.
• Default: 1
• Refreshable: Yes

UNIXGroupPermissionsMode

• Description: Determines how group UNIX permissions are calculated for files and folders that don't already have UNIX permissions assigned. If 0, the calculation mode as set by UNIXCalculatedPermissionsMode is used. If 1, group permissions are the sum of the permissions for all groups (not just the primary group). If 2, group UNIX permissions are always returned as 7 (full rights) if no explicit UNIX permissions have been assigned.
• Default: 0
• Refreshable: Yes

WriteFlushThreshold

• Description: Specifies the number of bytes that can be written to a open fork before Access Connect forces a flush of that data to disk. Setting this value to 0 indicates that these flushes should never occur. Small values force a large number of flushes, which help prevent periodic long file system delays by spreading out flushes over a large number of writes.
• Default: 0
• Refreshable: Yes