The Test-SRTopology cmdlet validates a potential replication partnership.
This cmdlet validate on the local host to the destination computer or remotely between source and destination computers.
To use Windows Server 2016 Nano Server, additional steps are required.
Review Storage Replica documentation on Microsoft TechNet.
This cmdlet performs the following validations:
SMB can be accessed over the network, which means that TCP port 445 and/or 5445 are open bi-directionally.
WS-MAN can be accessed over HTTP on the network, which means that TCP port 5985 and 5986 are open.
SR WMIv2 provider can be accessed and accepts requests.
The source and destination volumes exist and are writable.
The source and destination log volume exists with NTFS formatting or ReFS formatting and sufficient free space.
Storage is initialized in GPT format, not MBR, with matching sector sizes.
Measures round-trip latency of ICMP and reports the average.
Measures performance counters for write Input/Output and reports the average seen on that volume.
Measures estimated initial synchronization time.
There is sufficient physical memory to run replication.
Examples
Example 1: Validate requirements
PS C:\>Test-SRTopology -SourceComputerName "SR-SRV05" -SourceVolumeName "D:" -SourceLogVolumeName "E:" -DestinationComputerName "SR-SRV06" -DestinationVolumeName "D:" -DestinationLogVolumeName "E:" -DurationInMinutes 1 -ResultPath "C:\temp" -IgnorePerfTests
Validating data and log volumes...
Test completed. Result at c:\temp\TestSrTopologyReport-2016-10-11-16-13-43.html
This command creates a report that validates the requirements.
It does not check performance.
Example 2: Validate requirements and performance
PS C:\>Test-SRTopology -SourceComputerName "SR-SRV05" -SourceVolumeName "D:" -SourceLogVolumeName "E:" -DestinationComputerName "SR-SRV06" -DestinationVolumeName "D:" -DestinationLogVolumeName "E:" -DurationInMinutes 10 -ResultPath "C:\temp"
Validating data and log volumes...
Measuring Storage Replica recovery and initial synchronization performance...
Measuring Storage Replica synchronous replication performance...
Test completed. Result at c:\temp\TestSrTopologyReport-2016-10-11-16-14-50.html
This command creates a report that validates requirements.
The command also measures initial sync and ongoing performance for a total of approximately ten minutes.
Example 3: Generate a report from previously generated data
PS C:\>Test-SRTopology -GenerateReport -DataPath "C:\temp"
Report file c:\temp\files\TestSrTopologyReport-2016-09-22-18-32-48.html now includes data charts
This command generates a complete report, which includes charts, from data generated previously on a Nano Server.
Parameters
-DataPath
Specifies a path of the raw report files created on Nano Server with a previous run of this cmdlet.
This parameter is only required to finish generation of reports created on a Nano Server, which do not contain the HTML chart generation controls.
Specify a path of the files created in the ResultPath parameter.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
GenerateReportOnlySet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DestinationComputerName
Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) for the destination computer.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Destination
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-DestinationLogVolumeName
Specifies a drive letter, mount point path, or volume GUID where destination replication logs would be created.
The volume must contain an NTFS-formatted volume or ReFS-formatted volume.
The path must exist.
The path cannot be a mapped drive or UNC path.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
DestinationLogVolume
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-DestinationVolumeName
Specifies an array of drive letters or mount point paths of the partitions for the replica.
The volume must exist.
The volume cannot be a mapped drive or UNC path.
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
DestinationVolumes
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-DurationInMinutes
Specifies the number of minutes to run this cmdlet.
This number is halved for initial sync testing and ongoing replication testing.
This cmdlet creates a 100MB test file during these tests and then removes it at the completion of the tests.
Parameter properties
Type:
UInt32
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Duration
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-GenerateReport
Indicates that this cmdlet converts the raw outputs into a readable HTML file.
This parameter is only required for a Nano Server, which does not contain the HTML chart generation controls.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
GenerateReportOnlySet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-IgnorePerfTests
Indicates that this cmdlet only checks requirements.
It does not calculate performance numbers.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
DefaultSet
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ResultPath
Specifies the output path for the measurement files and the finished HTML report.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
OutputResultPath
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-SourceComputerName
Specifies a single replica host computer NetBIOS name or FQDN for the source computer.
The default value is uses the local computer.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Source
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-SourceLogVolumeName
Specifies a drive letter, mount point path, or volume GUID where source replication logs would be created.
The volume must contain an NTFS-formatted volume or ReFS-formatted volume.
The path must exist.
The path cannot be a mapped drive or UNC path.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
SourceLogVolume
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-SourceVolumeName
Specifies an array of drive letters or mount point paths of the partitions for the replica.
The volume must exist.
The volume cannot be a mapped drive or UNC path.
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
SourceVolumes
Parameter sets
DefaultSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.