Mar. 19, 2015
StorageZones for ShareFile Data requires a network share for your private data. When multiple StorageZones Controllers are configured for high availability and load balancing within a zone, all Controllers access the same shared location for private data.
Even if you store ShareFile files in a supported third-party storage system, StorageZones Controller requires a network share for encryption keys, queued files, other temporary items, and a storage cache for file uploads to or downloads from that storage system. For more information about the storage cache, see Customize storage cache operations.
StorageZones Controllers access a network share using the IIS Account Pool user. By default, application pools operate under the Network Service user account, which has low-level user rights. StorageZones Controller uses the Network Service account by default. You can use a named user account instead of the Network Service account to access the share. However, you should run the IIS application pool and the Citrix ShareFile Services using the Network Service account.
By default, a StorageZones Controller configured to use a CIFS share stores all zone files in a single folder. As a result, the maximum number of files supported for a zone is limited by the maximum number of files per folder supported by your storage array.
You can configure StorageZones Controller to divide the persistent storage layout. This increases the maximum number of files per zone for some types of storage arrays from less than a half million to ten million or more. If you need even more capacity, you can change the default.
To enable StorageZones Controller to store files in multiple folders
On all StorageZones Controllers in the zone, update the value of the registry key HKLM\Software\Wow6432Node\Citrix\StorageZone\PathSelection from 0 to 1. If a StorageZones Controller registry does not include that key after an upgrade, add it.
Restart IIS on the StorageZones Controllers when you are finished editing the registry.
To increase the maximum number of folders
By default, divided storage layout has 256 top-level folders, each of which contains 256 folders. That configuration is represented in the primary StorageZones Controller registry key HKLM\Software\Wow6432Node\Citrix\StorageZone: PathSelectionParams=2,2. The first value constrains the number of top-level folders to "16 to the power of 2" or 256. The second value also constrains the number of child folders of the top-level folders to 256.
Using that same formula (16 to the power of N) you can determine the appropriate values for your site. For example, PathSelectionParams=3,4,4,4 constrains the number of top-level folders to 4096 (16 to the power of 3). The second value constrains the child folders of the top-level folders to 65536 (16 to the power of 4). The third value constrains the child folders of the second-level folders to 65536, and so on.
Restart IIS on the primary and secondary StorageZones Controllers if you are finished editing the registry.
To remove empty folders
When StorageZones Controller stores files in multiple folders, file deletion can result in empty folders. By default, StorageZones Controller removes empty folders. The file delete service will delete empty folders, starting at the bottom of the tree and continuing up until it reaches a non-empty folder.
However, some upgrade paths might not update your settings. After an upgrade, verify that the following key appears in C:\inetpub\wwwroot\Citrix\StorageCenter\SCFileCleanSvc\FileDeleteService.exe.config:
<add key="DeleteEmptyFoldersAfterFileDeletion” value=“1”/>
If you need to add the key, restart the File Delete Service when you are finished.