NAME
Set-DcsServerCacheSize
SYNOPSIS
Changes the cache size of a server.
SYNTAX
Set-DcsServerCacheSize -Server <Object> -Size <DataSize> [ -Connection <String> ] [ -PipelineVariable <String> ]
Set-DcsServerCacheSize -Server <Object> [ -SystemManaged] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Changes the cache size of a server. After changing the cache size, the server must be stopped and restarted for the changes to take effect (see Stop-DcsServer, Start-DcsServer). Caution: The default setting is the system managed cache size which has been optimized for I/O performance based on memory in the server. Do not alter default settings unless you are aware of the affect your changes will have on performance.
PARAMETERS
- -Server<Object>
- ServerHostData object, computer name, or ID that identifies the server. The computer name must be unique or the name must be fully qualified.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Size<DataSize>
- Specify the new size of the cache. Valid values consist of the number followed by the unit of measurement (MiB or GiB). For example, "256MiB" or "1GiB" could be valid sizes.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Connection<String>
- Alias of the connection to the server group. If not specified, the default connection will be used.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -PipelineVariable<String>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -SystemManaged<SwitchParameter>
- Use this parameter to set the cache size to system managed, which is optimized for I/O performance by the operating system based on the amount of memory in the server.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
INPUTS
ServerHostData : Object that identifies the server.
OUTPUTS
ServerHostData : Object that identifies the server.
NOTES
Also see Get-DcsServerCacheSize, Get-DcsServer, Stop-DcsServer, Start-DcsServer.
EXAMPLES
Set-DcsServerCacheSize -Server SSV1 -SystemManaged
The server cache for the server named "SSV1" is set to System Managed. In order for this to take effect the server must be stopped and restarted (see Stop-DcsServer, Start-DcsServer).
GroupId | : | 4ba07046-5f6b-44f1-acf8-41d77d0dc184 |
RegionNodeId | : | ExecutiveNode:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
CacheSize | : | 0.00 B |
State | : | Online |
SupportState | : | Idle |
SnapshotMapStoreId | : | V.{91e63003-ca79-11e0-a962-00155d11e921}-00000017 |
SnapshotMapStorePoolId | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921} |
InstallPath | : | C:\Program Files\DataCore\SANsymphony |
ProductName | : | DataCore SANsymphony |
ProductType | : | Standard |
ProductVersion | : | 8.1, Update 1 |
OsVersion | : | Windows Server 2008 R2 x64 Edition, Service Pack 1 |
ProcessorInfo | : | DataCore.Executive.ProcessorInformation |
ProductBuild | : | 13.1.1.813 |
BuildType | : | Release |
DiagnosticMode | : | Enabled |
LicenseRemaining | : | 21546000000000 |
ReplicationBufferFolder | : | E:\ |
TotalSystemMemory | : | 1,023.56 MiB |
AvailableSystemMemory | : | 111.92 MiB |
LogStatus | : | Operational |
LicenseSettings | : | DataCore.Executive.LicenseSettings |
IsLicensed | : | True |
StorageUsed | : | 0.00 B |
PowerState | : | ACOnline |
CacheState | : | WritebackGlobal |
BackupStorageFolder | : | |
IpAddresses | : | {172.20.17.63, fe80::ac9f:4abc:8e7:447a, 13.0.0.31, fe80::2de4:e3b4:87d0:b299...} |
Description | : | |
HostName | : | SSV1.datacoresoftware.com |
Id | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
Caption | : | SSV1 |
ExtendedCaption | : | SSV1 in LOCAL |
Internal | : | False |
Get-DcsServer -ServerGroup LOCAL | Set-DcsServerCacheSize -Size 255MiB
The cmdlet Get-DcsServer is invoked with the ServerGroup parameter to obtain all ServerHostData objects for the local server group named "LOCAL". The objects are piped to Set-DcsServerCacheSize with a size of 255MiB. This causes the cache size of all servers in the LOCAL server group to be set to 255MiB. In order for this to take effect the servers must be stopped and restarted (see Stop-DcsServer, Start-DcsServer).
GroupId | : | 4ba07046-5f6b-44f1-acf8-41d77d0dc184 |
RegionNodeId | : | ExecutiveNode:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
CacheSize | : | 255.00 MiB |
State | : | Online |
SupportState | : | Idle |
SnapshotMapStoreId | : | V.{91e63003-ca79-11e0-a962-00155d11e921}-00000017 |
SnapshotMapStorePoolId | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921} |
InstallPath | : | C:\Program Files\DataCore\SANsymphony |
ProductName | : | DataCore SANsymphony |
ProductType | : | Standard |
ProductVersion | : | 8.1, Update 1 |
OsVersion | : | Windows Server 2008 R2 x64 Edition, Service Pack 1 |
ProcessorInfo | : | DataCore.Executive.ProcessorInformation |
ProductBuild | : | 13.1.1.813 |
BuildType | : | Release |
DiagnosticMode | : | Enabled |
LicenseRemaining | : | 21546000000000 |
ReplicationBufferFolder | : | E:\ |
TotalSystemMemory | : | 1,023.56 MiB |
AvailableSystemMemory | : | 111.92 MiB |
LogStatus | : | Operational |
LicenseSettings | : | DataCore.Executive.LicenseSettings |
IsLicensed | : | True |
StorageUsed | : | 0.00 B |
PowerState | : | ACOnline |
CacheState | : | WritebackGlobal |
BackupStorageFolder | : | |
IpAddresses | : | {172.20.17.63, fe80::ac9f:4abc:8e7:447a, 13.0.0.31, fe80::2de4:e3b4:87d0:b299...} |
Description | : | |
HostName | : | SSV1.datacoresoftware.com |
Id | : | 84972D6B-7E71-4616-BDA1-57ECEAF3FFC4 |
Caption | : | SSV1 |
ExtendedCaption | : | SSV1 in LOCAL |
Internal | : | False |
GroupId | : | 4ba07046-5f6b-44f1-acf8-41d77d0dc184 |
RegionNodeId | : | ExecutiveNode:C553D471-3527-47EC-9326-D53E04204F2B |
CacheSize | : | 255.00 MiB |
State | : | Online |
SupportState | : | Idle |
SnapshotMapStoreId | : | V.{9437d954-ca79-11e0-857f-00155d11e923}-0000000B |
SnapshotMapStorePoolId | : | C553D471-3527-47EC-9326-D53E04204F2B:{9437d954-ca79-11e0-857f-00155d11e923} |
InstallPath | : | C:\Program Files\DataCore\SANsymphony |
ProductName | : | DataCore SANsymphony |
ProductType | : | Standard |
ProductVersion | : | 8.1, Update 1 |
OsVersion | : | Windows Server 2008 R2 x64 Edition, Service Pack 1 |
ProcessorInfo | : | DataCore.Executive.ProcessorInformation |
ProductBuild | : | 13.1.1.813 |
BuildType | : | Release |
DiagnosticMode | : | Enabled |
LicenseRemaining | : | 21546000000000 |
ReplicationBufferFolder | : | |
TotalSystemMemory | : | 1,023.56 MiB |
AvailableSystemMemory | : | 137.17 MiB |
LogStatus | : | Operational |
LicenseSettings | : | DataCore.Executive.LicenseSettings |
IsLicensed | : | True |
StorageUsed | : | 0.00 B |
PowerState | : | ACOnline |
CacheState | : | WritebackGlobal |
BackupStorageFolder | : | |
IpAddresses | : | {172.20.17.157, fe80::2920:ddc6:93a7:45df, 13.0.0.35, fe80::6181:9311:6644:c8d2...} |
Description | : | |
HostName | : | SSV2.datacoresoftware.com |
Id | : | C553D471-3527-47EC-9326-D53E04204F2B |
Caption | : | SSV2 |
ExtendedCaption | : | SSV2 in LOCAL |
Internal | : | False |