StableBit CloudDrive Advanced Settings

Settings

Settings are organized by function.

AmazonCloudDrive

• AmazonCloudDrive_ClientId (Default: "") - Override the client ID to use with Amazon Cloud Drive.
• AmazonCloudDrive_ClientSecret (Default: "") - Override the client secret to use with Amazon Cloud Drive.

BitLocker

• BitLocker_CloudPartUnlockDetect (Default: "True") - Adds support for BitLocker encrypted StableBit CloudDrive cache drives. You must still manually unlock the drives, unless the system disk is also encrypted and configured to auto-unlock the other drives. This does cause the software to periodically "ping" the disk (this happens via WMI and not our software, directly).

ChunkIoPipelineTrackingImplementation

• ChunkIoPipelineTrackingImplementation_MaximumClosedIoToTrack (Default: "100") - (???)
• ChunkIoPipelineTrackingImplementation_MaximumInFlightIoToTrack (Default: "100") - (???)

ChunkId

• ChunkId_MemoryLimit - The amount of memory (RAM) to use for caching chunk IDs (for providers that don't have a way of downloading files by file name).
• ChunkId_RequeryOnVerify - This will requery for the Chunk ID when verifying chunks. This is off by default.

CloudDrive

• CloudDrive_CultureOverride (Default: "") - 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 CloudDrive machine with an overridden culture, the UI on the connecting machine will be in the overridden culture.
• CloudDrive_PingHost (Default: "8.8.8.8") - The IP to ping in order to determine if there is an Internet connection available. StableBit CloudDrive will delay service startup and cloud drive mounting until there is an Internet connection available.
• CloudDrive_ResolveHost (Default: "google.com") - The hostname to resolve in order to determine if there is an active Internet connection available. StableBit CloudDrive will delay service startup and cloud drive mounting until there is an Internet connection available.
• CloudDrive_ServiceLoggingEnabled (Default: "True") - Enables normal service logging, such as remote control info, cloud provider I/O info, etc...
• CloudDrive_SynchronousServiceStart (Default: "False") - (???)
• CloudDrive_WaitForInternetS (Default: "120") - How long to wait for an Internet connection to become available before allowing the service to complete startup and mount the first cloud drive (set to 0 to start immediately and not wait).

CloudDrives

• CloudDrives_MountParallelization (Default: "2") - (???) The number of drives to attempt to mount at the same time.

CloudFsDisk

• CloudFsDisk_IsDriveRemovable (Default: "True") - Causes the CloudDrive disks to be marked as removable drives, and exposes the "Removal Policy" tab in Device Manager. This is enabled by default.
• CloudFsDisk_IsQuickRemoval (Default: "True") - Controls whether the drive is set to "Quick Removal" or "Better performance" in the "Removal Policy" tab in Device Manager. This is enabled by default.
• CloudFs_LogSizeMB (Default: "100") - The binary kernel log size. 100MB can be from a few minutes to 10 minutes worth of logs, depending on I/O activity. The kernel binary log records every operation on the cloud drive in a high performance and compact log file.
• CloudFsDisk_MaximumConsecutiveIoFailures (Default: "3") - This setting controls how many unrecoverable I/O failures can occur before the drive is forcefully unmounted from the system. Increasing or disabling this setting can cause issues where the system may hang/lock up, as Windows will wait on the I/O to finish. The window for these errors is 120 seconds, and if this time is exceeded without an error, the count is reset. The default value for this is "3".
• CloudFsDisk_Tracing (Default: "False") - When set to True, kernel driver tracing will be enabled by default at all times. Tracing logs are written to %ProgramData%\StableBit CloudDrive\Service\Logs\CloudFsDisk. They are written in a binary format and can be submitted to technical support for analysis.
• CloudFs_TracingFlushS (Default: "0") - This sets flush to disk the interval. 0 will flush on every trace.

CreateDrive

• CreateDrive_AllowCacheOnDrivePool (Default: "False") - Allows the cache to be created on a DrivePool disk. Default behavior is to exclude Pool drives, due to the fact that the cache files will always be locked and will not be rebalanced, nor can be duplicated if real time duplication is disabled.

DeleteCloudDrive

• DeleteCloudDrive_Retries (Default: "10") - How many times to retry deleting a cloud drive's metadata and data when an error is encountered.

FTP

• Ftp_ConnectionExpireAfter (Default: "00:00:30") - Timeout for FTP connection, closes connection so it's not always open.
• Ftp_DefaultMaximumConnections (Default: "2") - Sets the default maximum number of connections for the FTP provider.
• Ftp_NoAbort (Default: "False") - (???) If enabled, doesn't abort/close connections.
• Ftp_TimeoutMS (Default: "45000") - (???) Errors out if connection takes too long.

Http

• Http_Legacy10 (Default: "False") - (???)

IoManager

• IoManager_DefaultConnectionLimit (Default: "1000") - The maximum number of simultaneous HTTP connections that the service is allowed to create.
  • Clarification needed.
• IoManager_DefaultMaximumReadAggregation (Default: "1048576") - Sets the maximum read I/O aggregation for providers that don't explicitly define one.
  • Clarification needed (Issue #27309)
• IoManager_HttpConnectionReadTimeoutMS (Default: "100000") - The maximum allowed duration of an HTTP connection in MS. The duration is calculated from the time that a connection is attempted until the final response is received.
• IoManager_HttpConnectionWriteTimeoutMS (Default: "3600000") - The maximum allowed duration of an HTTP connection in MS. The duration is calculated from the time that a connection is attempted until the final response is received.
• IoManager_HttpReadWriteTimeoutMS (Default: "") - The maximum allowed duration of an HTTP upload / download in MS.
• IoManager_ReadAbort - Maximum amount of time that a read thread is allowed to run before the thread is aborted (this is a secondary safety measure, if the timeout fails).
• IoManager_NoFreeSpaceCheckOnStorageProvider (Default: "False") - (???) Disables the free space check on provider when creating new drives.
• IoManager_ReadAbort (Default: "00:01:55") - (???) Maximum amount of time that a read thread is allowed to run before the thread is aborted (this is a secondary safety measure, if the timeout fails).
• IoManager_ReadRetries (Default: "10") - How many times to retry provider reads before returning an error to the disk.
• IoManager_ReadThreads (Default: "2") - The default number of read threads when creating a new cloud drive, unless overridden by the provider.
• IoManager_ThrottlingCatchupS(Default: "3.0") - The set limit for the I/O Manager can now be temporarily exceeded in order to "catch up" due to a previous slow down. Set to 0.0 to disable.
• IoManager_UseHttpCompression (Default: "True") - Set to True to use HTTP compression, set to False otherwise.
• IoManager_WriteAbort (Default: "00:05:00") - Maximum amount of time that a write thread is allowed to run before the thread is aborted (this is a secondary safety measure, if the timeout fails).
• IoManager_WriteRetries - How many times to retry provider reads before giving up and showing an error to the user.
• IoManager_WriteThreads - The default number of write threads when creating a new cloud drive, unless overridden by the provider.

LocalIo

• LocalIo_ReleaseHandlesDelayMS - For the Local Disk provider and the File Share provider, how long to wait (in MS) after the last provider I/O call before closing all of the handles to the provider's data.

Performance

• Performance_MaximumClosedIoToTrack (Default: "1000") (???) Maximum number of IO threads to track for the performance window.

PinDiskMetadata

• PinDiskMetadata_IntervalM (Default: "60") - This sets how often to check for file system metadata changes when pinning data to the local cache, in minutes.

RemoteControl

• RemoteControl_Port (Default: "26525") - Specifies the port used by StableBit CloudDrive for remote management.
• RemoteControl_MulticastGroupIp (Default: "232.121.12.3") - The multicast group IP to use for peer discovery.
• RemoteControl_MulticastGroupPort (Default: "52330") - The multicast group port to use for peer discovery.
• RemoteControl_MulticastTimeToLive (Default: "3") - Controls the number of "hops" the remote control packets will travel before being dropped, to prevent the network from being flooded.
• RemoteControl_StaticPeerSeekTime (Default: "00:01:00") - How often to check whether an offline static peer has gone online.

ValidateLogins

• ValidateLogins_MaxDegreeOfParallelism (Default: "20") - When first starting StableBit CloudDrive, how many threads to use in order to validate your existing login credentials.
• ValidateLogins_Timeout (Default: "00:00:30") - Sets the timeout length that the software will wait for a response when waiting for the provider to respond to refreshing credentials.

WholeChunkIoImplementation

• WholeChunkIoImplementation_PartialWriteAggregationMS (Default: "100") - When a cloud provider doesn't support writing partial chunks (which is very common), we aggregate partial shared write requests into a master chunk write request. This is a very complicated optimization and you shouldn't change this value unless instructed to do so by technical support.