Product Documentation

What's new

Sep 27, 2015

What's new in StorageZones Controller 2.3

StorageZones Controller 2.3 includes the following enhancements.

More files per zone — Previously, a StorageZones Controller configured to use a CIFS share stored all zone files in a single folder. As a result, the maximum number of files supported in a zone was limited by the maximum number of files per folder supported by your storage array.

StorageZones Controller 2.3 can divide the persistent storage layout, increasing the maximum number of files per zone for some types of storage arrays from less than a half million to ten million or more. This feature is off by default. To enable and configure it, see Increase the number of files per zone.

File upload latency testing — StorageZones Controller now includes a web page that helps you troubleshoot potential latency issues. The page provides the elapsed time and rate for a specified file upload. The time and rate values are provided for the upload to StorageZones Controller and for the upload to the storage cache. This feature is off by default. To enable it, see Test upload latency.

What's new in StorageZones Controller 2.2.3

StorageZones Controller 2.2.3 improves the following features.

Proxy server bypass configuration — Primary and secondary StorageZones Controllers communicate with each other using HTTP. If your network configuration directs all HTTP traffic through an outbound proxy server that does not support connections back to an internal server, StorageZones Controllers must bypass the proxy server so they can communicate with each other.

You can now update the Networking page in the StorageZones Controller console instead of manually editing the Web.config files to enable the primary StorageZones Controller to not use a web proxy when communicating with its secondary controllers. For more information, see Specify a proxy server for StorageZones.

StorageZones Controller file delete service — New and updated settings in FileDeleteService.exe.config now provide you with more control over when files are deleted from the StorageZones Controller persistent storage cache. The new settings are particularly useful for busy sites that fill up ShareFile storage cache in less than a day. You can specify:

  • A range of off-peak hours when the service can delete files.
  • The minimum interval between the last access of a file and when the service deletes it.
  • The frequency that the service checks for files to be deleted.
    Important: If you are upgrading to StorageZones Controller 2.2.3 and previously customized the ProducerTimer or DeleteTimer settings, please contact Support for help with configuring the new ProducerTimerInterval and DeleteTimerInterval settings in FileDeleteService.exe.config.

For more information, see Customize storage cache operations.

What's new in StorageZones Controller 2.2.2 hotfix

The StorageZones Controller 2.2.2 hotfix addresses several key issues. The installer for StorageZones Controller 2.2.2 replaces the one for StorageZones Controller 2.2.1. For more information, refer to the ShareFile StorageZones Controller 2.2.x download page, available from

What's new in StorageZones Controller 2.2.1

StorageZones Controller 2.2.1 provides the following enhancements:

Support for Windows Server 2012 R2 — You can now use StorageZones Controller on servers running Windows Server 2012 R2, in addition to Windows Server 2008 R2.

More flexibility in restricting access to Connector sites — In addition to specifying the paths of allowed UNC paths or SharePoint server addresses, you can now specify the denied paths. A connection is first checked against the allowed paths and, if it passes those requirements, is then checked against the denied paths. For more information, see Install StorageZones Controller and create a zone.

What's new in StorageZones Controller 2.2

StorageZones Controller 2.2 provides the following enhancements:

Support for Windows Azure storage containers — If you have a Windows Azure account, you can use an Azure storage container for your private data storage instead of a locally-maintained share.

To get started create a new zone and choose the Azure option when you configure StorageZones for ShareFile Data. For more information, see Install StorageZones Controller.

Connectors to SharePoint root-level sites — You can now create a StorageZone Connector for a SharePoint root-level site or site collection, enabling users to navigate all of the subsites and document libraries in the site. To provide more limited access, you can continue to create connectors to individual SharePoint document libraries. For more information, see Create and manage StorageZone Connectors.

Connectors to user home drives based on Active Directory — You can now create a Connector for network file shares that reliably points to user home drives. To create a connector for user home drives, set the UNC path to the variable %homedrive%. StorageZones Controller will then create connectors based on the user home folder path property in Active Directory.

Installation on non-English operating systems — You can install the English version of StorageZones Controller on the following operating system versions: French, German, Japanese, Simplified Chinese, and Spanish.

Issues fixed in release 2.2.3

  • During an upgrade to release 2.2.1, the following key is not added to the AppSettingsRelease.config file: [#34112]

    <add key="RenameFileOnUploadConflict" value="0"/>

    Without that key, a user is unable to upload a file if it is in use. With the key, a copy of the file is created if the file is in use when uploaded. "- Copy(1)" is appended to the name of the copied file.

    To work around this issue after an upgrade to release 2.2.1, add the following key to the <appSettings> section of the AppSettingsRelease.config file in C:\inetpub\wwwroot\Citrix\StorageCenter\cifs and C:\inetpub\wwwroot\Citrix\StorageCenter\sp:

    <add key="RenameFileOnUploadConflict" value="1"/>

  • If your deployment includes StorageZones from a * account and the ShareFile Outlook Plug-in 3.0 Limited Release, an error message occurs after a user tries to send a file from Outlook. To work around this issue, change your C:\inetpub\wwwroot\Citrix\StorageCenter\AppSettingsRelease.config file as follows: Search for the key allowable-top-level-app-domains and add to its value list [#21329]
  • When a user navigates to a folder on a network file share, and that folder includes a file with a tilde (~) character in its name, the download might not complete. [#13357]

Issues fixed in release 2.2.1

  • After a change to the Network share location (used with on-premises storage) or the Shared cache location (used with Azure storage) on the primary StorageZones Controller, the secondary StorageZones Controllers continue to use the previous location. [#19552]
  • Files are not uploaded to an Azure container if a proxy server is configured for StorageZones Controller. [#19850]
  • After you create a StorageZone for a * account, you must edit the file C:\inetpub\wwwroot\Citrix\StorageCenter\AppSettingsRelease.config to change to [#19959]

Known issues

  • By design, configuration changes to a StorageZones Controller are not propagated to other Controllers in the same StorageZone. After any configuration change, be sure to restart the IIS server on the primary and secondary servers.
  • For allowed and denied paths, long-form URL paths to SharePoint folders are not always enforced. Use the short form instead. [#25318]

    Example short URL path: one/

    In the long version of that same URL, Folder one is expanded to Forms/AllItems.aspx?RootFolder=%xxx.

  • SharePoint documents are truncated if StorageZones Controller and SharePoint share the same XenServer host and the network adapter setting Large Send Offload is enabled on the SharePoint server. To work around this issue, disable Large Send Offload on the SharePoint server or disable Large Receive Offload on the StorageZones Controller server. [#17103]
  • In some situations, the Save button is labeled Register. [#8138]
  • If your StorageZones Controller is behind a proxy server configured with Basic or Windows Challenge/Response (NTLM) authentication, you cannot set up Azure storage for your ShareFile StorageZone data. To use Azure storage for StorageZone data, configure the proxy server for Anonymous authentication. [#105283]
  • The ShareFileURL registry entry is not updated after you change your ShareFile subdomain. To work around this issue, update the value of the following ShareFileURL entries on each StorageZones Controller server: [#102158]