Product Documentation

Reference: StorageZones Controller configuration files

Mar 30, 2015

This reference provides an overview to the StorageZones Controller configuration files:

  • AppSettingsRelease.config
  • FileDeleteService.exe.config
  • SFAntiVirus.exe.config
  • Web.config

The StorageZones Controller installer creates those files. Changes you make in the StorageZones Controller console are saved to the files.

To use or configure certain features, you must manually add or update some settings in the configuration files. This reference lists those settings and provides links to related information.

AppSettingsRelease.config

AppSettingsRelease.config files are contained in the following folders in the StorageZones Controller installation path (C:\inetpub\wwwroot\Citrix\):

  • StorageCenter

    Defines global settings for StorageZones Controller.

  • StorageCenter\cifs

    Defines settings for StorageZone Connectors for Network File Shares.

  • StorageCenter\sp

    Defines settings for StorageZone Connectors for SharePoint.

Before editing an AppSettingsRelease.config file, verify that you are working in the correct location. The following table includes only the settings that might require manual intervention to enable certain features.

For details about DLP settings, see Data Loss Prevention.

Setting Description

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

After an upgrade, this setting might require manual intervention.

This setting controls what happens when a user attempts to upload a file that is locked by another user. When the value is "0", the upload attempt is denied. When the value is "1", a copy of the file is created with "- Copy(1)" appended to the name.

Add the 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="CacheCredentials" value="1" />

To use StorageZone Connectors for SharePoint with a SharePoint server that is configured for Basic authentication, add the CacheCredentials key to:

C:\inetpub\wwwroot\Citrix\StorageCenter\sp\AppSettingsRelease.config

For more information, see StorageZone Connector for SharePoint in StorageZones Controller system requirements.

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

To run antivirus scans on a server other than the StorageZones Controller, set the QueueSDKRestricted key to "0" in:

C:\inetpub\wwwroot\Citrix\StorageCenter\sp\AppSettingsRelease.config

For more information, see Configure antivirus scans of uploaded files.

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

To enable a page that displays upload performance for a specified file, add the EnableTestUploadPage key to:

C:\inetpub\wwwroot\Citrix\StorageCenter\AppSettingsRelease.config

For more information, see Increase the number of files per zone.

FileDeleteService.exe.config

FileDeleteService.exe.config provides controls used by StorageZones Controller to manage the persistent storage cache. This configuration file is located in:

C:\inetpub\wwwroot\Citrix\StorageCenter\SCFileCleanSvc

For more information, see Customize storage cache operations.

SFAntiVirus.exe.config

SFAntiVirus.exe.config provides the scanner software with information about your StorageZones Controller configuration, the location of the scanner software, and various command options. This configuration file is located in:

C:\inetpub\wwwroot\Citrix\StorageCenter\Tools\SFAntiVirus

For more information, see Configure antivirus scans of uploaded files.

Web.config

In general, C:\inetpub\wwwroot\Citrix\StorageCenter\ConfigService\Web.config contains controls that typically should not be changed. You will, however, need to update it if you are using older StorageZones Controllers with a proxy server.

For StorageZones Controller 2.2 through 2.2.2 only: If a zone has multiple StorageZones Controllers and all HTTP traffic uses a proxy server, you must add a bypass list to Web.config for each secondary server.
Note: As of release 2.2.3, the bypass setting is included in the Network page of the StorageZones Controllers console.
  1. Open the file in a text editor and locate the <system.net> section. Here is a sample of that section after a proxy server is configured:
    <system.net> 
        <defaultProxy enabled="true"> 
          <proxy proxyaddress="http://192.0.2.0:3128" /> 
        </defaultProxy> 
      </system.net> 
    </configuration>
  2. Add a bypass list to that section, as shown:
    <system.net> 
        <defaultProxy enabled="true"> 
          <proxy proxyaddress="http://192.0.2.0:3128" /> 
          <bypasslist> 
            <add address="primaryServer" /> 
          </bypasslist> 
        </defaultProxy> 
      </system.net> 
    </configuration>

    The primaryServer is either an IP address or hostname (servername.subdomain.com).

    If you later change the primary StorageZones Controller IP address or hostname, you must update that information in ConfigService\Web.config for each secondary server.

  3. Restart the IIS server of all zone members.