StableBit DrivePool Advanced Settings - Revision history

Alex: /* Settings */

2019-02-14T00:32:16Z

Settings

2018-02-23T22:48:03Z

CoveFS

2013-11-11T17:54:02Z

2013-07-09T23:25:14Z

2013-04-15T02:04:12Z

CoveFS

2013-02-26T19:55:29Z

2013-02-08T19:53:32Z

DrivePool.Service.config

2012-12-19T15:40:22Z

WHS Command

2012-12-16T16:05:36Z

File Balance

2012-12-16T16:05:05Z

File Balance

← Older revision		Revision as of 00:32, 14 February 2019
Line 25:		Line 25:

	There are also numerical values and time values.		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>.~~

	==== CoveFS ====		==== CoveFS ====

@@ Line 38: / Line 38: @@
 * '''''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_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.

@@ Line 53: / Line 53: @@
 * '''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 ====
@@ Line 72: / Line 61: @@
 * '''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.''
 ==== Legacy ====

@@ Line 3: / Line 3: @@
 You can tweak advanced settings in DrivePool by editing a .config file in notepad.
-The file is located in '''C:\Program Files\StableBit\DrivePool\DrivePool.Service.exe.config_default''' on the server.
+The file is located in '''C:\Program Files\StableBit\DrivePool\DrivePool.Service.exe.config_default''' or '''C:\Program Files\StableBit\DrivePool\DrivePool.Service.exe.default.config''' on the server.
-In order to put the file into effect, you will need to rename it from '''DrivePool.Service.exe.config_default''' to '''DrivePool.Service.exe.config''' and restart the server (or just restart the StableBit DrivePool system service).
+In order to put the file into effect, you will need to rename it to '''DrivePool.Service.exe.config''' and restart the server (or just restart the StableBit DrivePool system service).
-A fresh copy of the .config file is written to C:\Program Files\StableBit\DrivePool\DrivePool.Service.exe.config_default on upgrade, so your changes will not be overwritten.
+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 ===

@@ Line 36: / Line 36: @@
 * '''CoveFs_AsyncNormalThreads''' - How many threads to use for normal asynchronous tasks.
 * '''CoveFs_BoostNetworkIoPriorityWrite''' - Boost the priority of write network I/O.
 * '''CoveFs_Oplocks''' - Enable / disable file system oplock support.
 * '''CoveFs_ReadStripingBlockMode'''' - Switch to the read striping block mode algorithm when sequential read access is used.

@@ Line 47: / Line 47: @@
 ==== 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.''
 ==== File Balance ====

@@ Line 84: / Line 84: @@
 ==== 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.
 ==== WHS Command ====

@@ Line 87: / Line 87: @@
 ==== WHS Command ====
 * '''WhsCommand_TimeoutMS''' - How long to wait for WSS to respond when issuing command to it. If your server is slow and you're getting errors such as ''Cannot retrieve WHS folders'' you may want to increase this time. The value is in milliseconds. For 2 minutes you would set this to 120000. Starting with build 5380 this is only applicable for the M3 to M4 migration process.
 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.

@@ Line 59: / Line 59: @@
 * <strike>'''FileBalance_DriveFillRatioMin''' - When preventing drive fill, do not empty a drive below this level.</strike>
 * '''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 0.0 to 1.0.''
+* '''''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.''
 * <strike>'''FileBalance_PreventDriveFill''' - Prevents pooled drives from getting topped off with pooled files. This is useful if you write a lot of non-pooled files to a pooled drive, or your your existing pooled files tend to greatly increase in size. This is an optimized algorithm that is designed to run very rarely, only when needed.</strike>
 * <strike>'''FileBalance_DriveFillRatio''' - When a drive's used space exceeds this ratio, it becomes a candidate for a re-balance. Actual re-balancing will only be available if the file placement on the drive and the rest of the pool permit it.</strike>