View source for StableBit DrivePool 2.X Advanced Settings

#REDIRECT [[StableBit_DrivePool_2.x_Advanced_Settings]]
== DrivePool.Service.config ==

You can tweak advanced settings in Stablebit DrivePool by editing a .config file in notepad.

The file is located in '''C:\Program Files\StableBit\DrivePool\DrivePool.Service.exe.default.config'''.

In order to put the file into effect, you will need to rename the .config file to '''DrivePool.Service.exe.config''' and restart the StableBit DrivePool system service (or reboot).

Any time you upgrade, or reinstall DrivePool, it writes an updated "default" config file, but leaves the current "DrivePool.Service.exe.config" alone so it doesn't alter any of your settings.

=== Editing the config file ===
Open the file in notepad. You will see an XML formatted file. If you're not familiar with XML then all that you need to know is that the values that you can change look like this:

 <value>'''True'''</value>

You can change this line to:

 <value>'''False'''</value>

The setting name is right above that line:

 <setting name="'''CoveFsLogSizeMB'''" serializeAs="String">

In this case the name is ''CoveFsLogSizeMB''.

There are also numerical values and time values.

=== Settings ===
Settings are organized by function. 

The newest settings are '''''emphasized'''''.<br />
Obsolete settings are <strike>crossed out</strike>.

==== BitLocker ====
* '''BitLocker_PoolPartUnlockDetect''' - Set to True to add support for BitLocker encrypted pool parts. Adds a small overhead and is Disabled by default.

==== CoveFS ====
* '''CoveFs_AsyncCriticalThreads''' - How many threads to use for critical asynchronous tasks. Asynchronous tasks are used throughout CoveFS to parallelize various file system operations. In particular, this affects how many disks in the pool are accessed at the same time when we need to query all the disks for some information.
* '''CoveFs_AsyncNormalThreads''' - How many threads to use for normal asynchronous tasks.
* '''CoveFs_BoostNetworkIoPriorityWrite''' - Boost the priority of write network I/O.
* '''CoveFs_BypassNtfsFilters''' - When CoveFS accesses the pool parts, if this is set to true it will bypass NTFS file system filters. This should be set to true or else you will end up with programs, such as anti-viruses, double or triple scanning all I/O.
* '''CoveFs_EfsEnabled''' - Enable experimental EFS support on the pool.
* '''CoveFs_LogSizeMB''' - When CoveFs_TracingEnabled is enabled, this is the maximum size of the trace log file.
* '''CoveFs_OpenByFileId''' - Open by file ID support. This allows applications to open any file on the pool by its unique file ID, instead of the file name. This feature is required by the NFS server. When enabled, the pool will keep track of every file ID that it gives out in pagable memory (memory that is saved to disk and loaded as necessary).
* '''CoveFs_Oplocks''' - Enable / disable file system oplock support.
* '''CoveFs_ReadStripingBlockMode'''' - Switch to the read striping block mode algorithm when sequential read access is used.
* '''CoveFs_ReadStripingBlockModeNoCache''' - Disable the NT read ahead cache when using read striping block mode.
* '''CoveFs_ReadStripingStripeSize''' - The stripe size to use for reading in block mode.
* '''CoveFs_ReportAsNtfs''' - Report as "NTFS" to most applications that ask.
* '''CoveFs_SynchronizeDirectoryTimes''' - On NTFS, when creating a new file in a directory, the last write time of the directory that contains that file gets updated. In order to have CoveFS ensure that directory modification times are updated consistently, this needs to be enabled. There is a small real-time performance penalty for having this enabled. The algorithm that makes this work is multi-threaded and will benefit from multiple CPU cores.
* '''CoveFs_TracingEnabled''' - Enables detailed file system I/O tracing. This should be left disabled unless you're actively generating an I/O trace.
* '''CoveFs_TracingFlushS''' - When CoveFs_TracingEnabled is enabled, this sets flush to disk the interval. 0 will flush on every trace.
* '''CoveFs_WaitForVolumesOnMountMs''' - How long to wait for all the volumes to arrive in MS.

==== CoveFS Disk ====
* '''CoveFsDisk_LogSizeMB''' - When CoveFs_TracingEnabled is enabled, this is the maximum size of the trace log file.

==== DrivePool ====
* '''DrivePool_BackgroundTasksVeryLowPriority''' - Sets the CPU priority of background tasks such as re-measuring, background duplication and re-balancing to IDLE (Windows Priority 1). Note that this setting does not affect I/O priority which is set separately.
* '''''DrivePool_CultureOverride''''' - Overrides the UI culture setting. When set, text will appear in a different language than your OS culture. Set to a culture string such as "de", "es", "fr", etc... This works with remote control as well. When connecting to a StableBit DrivePool machine with an overridden culture, the UI on the connecting machine will be in the overridden culture.
* '''DrivePool_ServiceLoggingEnabled''' - Controls whether to log user mode service activity to a log file.
* '''DrivePool_VerifyAfterCopy''' - After performing a file copy (or move), verify that the destination file was copied successfully by comparing it with the source.

==== File Balance ====
* '''FileBalance_BackgroundIO''' - Use background I/O for re-balancing the pool.
* '''FileBalance_CalculateRatioForceByteDelta''' - How many bytes have to be processed by the pool before the ratio is recalculated. The ratio calculation involves no I/O, is done asynchronously and does not block the pool.
* '''FileBalance_DuplicationObstructionLimitRatio''' - Internal variable that controls balance ratio calculation.
* '''FileBalance_EvacuationPadding''' - When evacuating a disk (i.e. re-balancing to move all the files off of it), we pad the amount selected to move off by the ratio of the amount of free space on the target. This is that ratio which is a value from 0.0 to 1.0.

==== File Duplication ====
* '''FileDuplication_BackgroundIO''' - Use background I/O for background file duplication.
* '''FileDuplication_DuplicateTime''' - The time of day when files will be duplicated, if real-time duplication is disabled.
* '''FileDuplication_MaximumPathDepthForEstimation''' - This is the maximum path depth that background duplication will traverse to estimate the number of folders on the pool that it needs to work on. Increasing this value will increase the delay at the start of background duplication before it starts doing actual work, but will provide more resolution in the completion percentage reported in the Dashboard.
* '''FileDuplication_NoConsistencyCheckOnNewPool''' - Do not check duplication consistency when a pool is connected to the system.

==== Performance ====
* '''Performance_SampleIntervalMS''' - Controls how often to sample disk and file system performance data. Samples are only collected if there is at least one UI connected to the service.

==== Remote Control ====
* '''RemoteControl_MulticastTimeToLive''' - The time to live (TTL) on the multicast packets that get sent out for discovery purposes.
* '''RemoteControl_Port''' - The port to use for remote control. This is just a hint, and if this port is in use another one will be chosen.
* '''RemoteControl_StaticPeerSeekTime''' - How often to check whether an offline static peer has gone online.

==== Remove Drive ====
* '''RemoveDrive_PoolReadOnly''' - Make unduplicated folders on the pool read-only while a disk is being removed. Duplicated folders are always made read-only to preserve data integrity.

Don't forget to rename the config file after you make the change and restart the server (or service), as noted at the top of this page.