This method returns an array of the IP subnet mappings for this IP Subnet Mapper.

Synopsis

IPSubnetMapping[] getIpSubnetMappings();

IPSubnetMapping represents an association between a mapped network on the primary site with an IPMapping describing IP parameter translation during IP Subnet based customization. It has the following fields:

Field Description
primaryObject Network on the primary (protected) site
secondaryObject Network on the secondary (recovery) site
IPMapping ipMapping IPMapping to apply to the destination network during IP customization

IPMapping defines the rule(s) used to translate VM's IP settings between protection and recovery sites. IPMapping can be associated with a protected site's vim.Network mapped to a recovery site's vim.Network with InventoryMapping.addNetworkMapping method. This allows IP settings for the recovered VMs be deduced based on the IP subnet parameters without a need to configure IP settings for each protected VM individually. It has the following fields:

Field Description
name Name of the IP mapping.
@optional SubnetRule[] rules A set of network rules to evaluate/apply during recovery. The rules are evaluated in the order they are specified. SRM applies the first matched rule.
SubnetRule describes the mapping between protection site IP parameters to recovery site ones for a single IP subnet. It has the following fields:
Field Description
name Name of the Rule.
recoverySiteSubnet CIDR specifying the recovery site subnet.
protectedSiteSubnet CIDR specifying the protected site subnet.
@optional IPSettings recoverySiteIPSettings IP settings to be applied for all matched network adapters on the recovery site when executing Test and Failover workflows.
dnsSuffixes[] DNS Suffixes to be applied to all matched network adapters.
IPSettings is the IP customization info for a specific network adapter. It has the following fields:
Field Description
ipV4Gateways List of IPv4 gateways in the order of preference.
ipV6Gateways List of IPv6 gateways in the order of preference.
dnsServerList List of server IP addresses to use for DNS lookup.

In Windows, these settings are adapter-specific. In Linux they are used to build a global list of DNS servers for all adapters. Specify these servers in order of preference. If set in case of DHCP, the explicit DNS server list overrides the default DNS configuration acquired through DHCP protocol.

WindowsIPSettings is an extension for IPSettings. It is used for setting Windows specific IP customization information for a specific network adapter.

Field Description
domainName A connection-specific DNS domain name.
wins The IP addresses of the primary and secondary WINS servers. The first element in this array is always the address of the primary WINS server and if a second element exists, it is the address of the secondary WINS server.
netBios NetBIOS setting. Possible values are the constants defined by NetBiosMode enum.

NetBiosMode is used for configuring NetBIOS on Windows systems. The values correspond directly to Microsoft constants for NetBIOS mode. It enumerates the following:

Value Description
enableNetBiosViaDhcp Enables the DHCP server to decide whether or not to use NetBIOS.
enableNetBios Explicitly enables NetBIOS.
disableNetBios Explicitly disables NetBIOS.

Faults

  • RuntimeFault

For information about the faults that Site Recovery Manager throws, see Faults in Site Recovery Manager API.