Test-SRTopology
Syntax
Test-SRTopology
-SourceComputerName <String>
-SourceVolumeName <String[]>
-SourceLogVolumeName <String>
-DestinationComputerName <String>
-DestinationVolumeName <String[]>
-DestinationLogVolumeName <String>
-DurationInMinutes <UInt32>
-ResultPath <String>
[-IgnorePerfTests]
[<CommonParameters>]
Test-SRTopology
[-GenerateReport]
-DataPath <String>
[<CommonParameters>]
Description
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.
Required Parameters
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.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) for the destination computer.
Type: | String |
Aliases: | Destination |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | String |
Aliases: | DestinationLogVolume |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | String[] |
Aliases: | DestinationVolumes |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | UInt32 |
Aliases: | Duration |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the output path for the measurement files and the finished HTML report.
Type: | String |
Aliases: | OutputResultPath |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
Specifies a single replica host computer NetBIOS name or FQDN for the source computer. The default value is uses the local computer.
Type: | String |
Aliases: | Source |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | String |
Aliases: | SourceLogVolume |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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.
Type: | String[] |
Aliases: | SourceVolumes |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
Optional Parameters
Indicates that this cmdlet only checks requirements. It does not calculate performance numbers.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |