Citrix

Product Documentation



Download full document

Create a network share for private data storage

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.

  1. If you want to use a named user account instead of the Network Service account to access the share, create a named user account in Active Directory. We will refer to that named user account as the ShareFile Service account.
    Note: When you configure StorageZones Controller, you will specify the Network Share User Name and Network Share Password, which are the credentials for the account you will use to access the share, either the ShareFile Service account or the Network Service account.
  2. Connect to the server that will host the network share and create a folder for your ShareFile private data.
  3. Right-click the folder and choose Share with specific people....
  4. Add the account you will use to access the share (Network Service account or ShareFile Service account) and change the Permission Level to Read/Write.
  5. Click Share and then click Done.
  6. Right-click the folder and choose Properties.
  7. On the Security tab, verify that the account you will use to access the share (Network Service account or ShareFile Service account) has Full Access permissions.

Increase the number of files per zone

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

Caution: Editing the Registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

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.

Back to Top