GitHub    Download    Forum
Overview
Tutorial
C++ API
C# API
DTDL
DADL
Setup
DataFS SDK setup
DataFS setup
DataFS Tools
Connection
Server instances
Configuration connections
Client connections
Domain
Disk
Storage
Schema
Settings
Recovery
DataFS setup parameters

DataFS Tools – disk

Create-Disk

Create-Disk
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
          -Path 'filepath'
         [-ClusterShift 'value']
         [-DiskType 'value']
         [-MaxActiveIo 'value']
         [-IdleBlockSize 'value']
         [-CacheSizeMin 'value']
         [-CacheSizeMax 'value']
         [-CacheSizeDelta 'value']
         [-CacheHalfLife 'value']
         [-FragmentingStep 'value']
         [-FragmentingMaxSteps 'value']
         [-FragmentingLength 'value']
DiskGuid
The GUID of the disk.
Path
Path to the “disk” (a file).
ClusterShift (optional)
Defines a cluster’s size (the smallest allocation unit). A cluster’s size is 1 << ClusterShift. ClusterShift is increased automatically on creation to ensure that the resulting cluster size is at least as large as the system’s memory page size.
Be sure not to use values that are less than the block size of the storage device you are creating the database on.
DiskType (optional)
The type of the disk. 0x0 for HDD, 0x10 for SSD. This parameter is used to optimize algorithms for the type of disk used.
MaxActiveIo (optional)
Maximum count of parallel active read or write actions on the disk. If the limit is reached, the system first waits for an action to be completed before it starts a new one.
Minimum value: 1
Default value: 1
IdleBlockSize (optional)
Maximum size of a block that is written in idle mode. If larger blocks are written in idle mode, they are split into multiple blocks and disk actions. This is done to prevent higher-priority jobs from being blocked for too long.
Minimum value: 1048576 (1 MB)
Default value: 1048576 (1 MB)
CacheSizeMin (optional)
Minimum size (in bytes) of the cache that should be used for read / write operations.
Default value: 8388608 (8 MB)
CacheSizeMax (optional)
Maximum size (in bytes) of the cache that should be used for read / write operations.
Default value: 268435456 (256 MB)
CacheSizeDelta (optional)
Delta size (in bytes) that the cache is reduced by after not being used for more than the CacheHalfLife time.
Default value: CacheSizeMax / 32
CacheHalfLife (optional)
Timeout (in milliseconds) after which the cache is temporarily reduced by CacheSizeDelta.
Minimum value: 1000 (1 sec.)
Default value: 120000 (2 min.)
FragmentingStep (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
See stcStorageDiskSettings for more information.
Default value: 2
FragmentingMaxSteps (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
The minimum fragment size that the system uses during data allocation can be greater than the usFragmentingLength, but is never greater than the usFragmentingLength << usFragmentingMaxSteps.
See stcStorageDiskSettings for more information.
Default value: 9
FragmentingLength (optional)
Absolute minimum fragment size used during data allocation (except for allocations that are less than this size).
Default value: 8


Attach-Disk

Attach-Disk
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
          -Path 'filepath'
         [-DiskType 'value']
         [-MaxActiveIo 'value']
         [-IdleBlockSize 'value']
         [-CacheSizeMin 'value']
         [-CacheSizeMax 'value']
         [-CacheSizeDelta 'value']
         [-CacheHalfLife 'value']
         [-FragmentingStep 'value']
         [-FragmentingMaxSteps 'value']
         [-FragmentingLength 'value']
DiskGuid
The GUID of the disk.
Path
Path to the “disk” (a file).
DiskType (optional)
The type of the disk. 0x0 for HDD, 0x10 for SSD. This parameter is used to optimize algorithms for the type of disk used.
MaxActiveIo (optional)
Maximum count of parallel active read or write actions on the disk. If the limit is reached, the system first waits for an action to be completed before it starts a new one.
Minimum value: 1
Default value: 1
IdleBlockSize (optional)
Maximum size of a block that is written in idle mode. If larger blocks are written in idle mode, they are split into multiple blocks and disk actions. This is done to prevent higher-priority jobs from being blocked for too long.
Minimum value: 1048576 (1 MB)
Default value: 1048576 (1 MB)
CacheSizeMin (optional)
Minimum size (in bytes) of the cache that should be used for read / write operations.
Default value: 8388608 (8 MB)
CacheSizeMax (optional)
Maximum size (in bytes) of the cache that should be used for read / write operations.
Default value: 268435456 (256 MB)
CacheSizeDelta (optional)
Delta size (in bytes) that the cache is reduced by after not being used for more than the CacheHalfLife time.
Default value: CacheSizeMax / 32
CacheHalfLife (optional)
Timeout (in milliseconds) after which the cache is temporarily reduced by CacheSizeDelta.
Minimum value: 1000 (1 sec.)
Default value: 120000 (2 min.)
FragmentingStep (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
See stcStorageDiskSettings for more information.
Default value: 2
FragmentingMaxSteps (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
The minimum fragment size that the system uses during data allocation can be greater than the usFragmentingLength, but is never greater than the usFragmentingLength << usFragmentingMaxSteps.
See stcStorageDiskSettings for more information.
Default value: 9
FragmentingLength (optional)
Absolute minimum fragment size used during data allocation (except for allocations that are less than this size).
Default value: 8


Detach-Disk

Detach-Disk
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
DiskGuid
The GUID of the disk.


Enum-Disk

Enum-Disk
This function has no parameters.


Set-DiskInfo

Set-DiskInfo
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
         [-Path 'filepath']
         [-DiskType 'value']
         [-MaxActiveIo 'value']
         [-IdleBlockSize 'value']
         [-CacheSizeMin 'value']
         [-CacheSizeMax 'value']
         [-CacheSizeDelta 'value']
         [-CacheHalfLife 'value']
         [-FragmentingStep 'value']
         [-FragmentingMaxSteps 'value']
         [-FragmentingLength 'value']
DiskGuid
The GUID of the disk.
Path (optional)
Path to the “disk” (a file).
DiskType (optional)
The type of the disk. 0x0 for HDD, 0x10 for SSD. This parameter is used to optimize algorithms for the type of disk used.
MaxActiveIo (optional)
Maximum count of parallel active read or write actions on the disk. If the limit is reached, the system first waits for an action to be completed before it starts a new one.
Minimum value: 1
Default value: 1
IdleBlockSize (optional)
Maximum size of a block that is written in idle mode. If larger blocks are written in idle mode, they are split into multiple blocks and disk actions. This is done to prevent higher-priority jobs from being blocked for too long.
Minimum value: 1048576 (1 MB)
Default value: 1048576 (1 MB)
CacheSizeMin (optional)
Minimum size (in bytes) of the cache that should be used for read / write operations.
CacheSizeMax (optional)
Maximum size (in bytes) of the cache that should be used for read / write operations.
CacheSizeDelta (optional)
Delta size (in bytes) that the cache is reduced by after not being used for more than the CacheHalfLife time.
CacheHalfLife (optional)
Timeout (in milliseconds) after which the cache is temporarily reduced by CacheSizeDelta.
Minimum value: 1000 (1 sec.)
Default value: 120000 (2 min.)
FragmentingStep (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
See stcStorageDiskSettings for more information.
Default value: 2
FragmentingMaxSteps (optional)
Values used to find the minimum fragment size that the system uses during data allocation.
The minimum fragment size that the system uses during data allocation can be greater than the usFragmentingLength, but is never greater than the usFragmentingLength << usFragmentingMaxSteps.
See stcStorageDiskSettings for more information.
Default value: 9
FragmentingLength (optional)
Absolute minimum fragment size used during data allocation (except for allocations that are less than this size).
Default value: 8


Get-DiskInfo

Get-DiskInfo
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
DiskGuid
The GUID of the disk.


Get-DiskStatus

Get-DiskStatus
          -DiskGuid "{EE2AD8F5-5508-4FDE-95E6-0E2AADD06884}"
DiskGuid
The GUID of the disk.
© 2022 Mobiland AG