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


-------------- Example 1 Sets the server cache for a server specified by name --------------
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
   

-------------- Example 2 Set the cache size for all servers by piping objects --------------
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