The DR IP Customizer tool includes options that you can use to gather networking information about the virtual machines that Site Recovery Manager protects. You can also use the options to apply customizations to virtual machines when they start up on the recovery site.

Note:

This release of Site Recovery Manager allows you to define subnet-level IP mapping rules to customize IP settings on virtual machines, as well as by using the DR IP Customizer tool. You can use subnet-level IP mapping rules in combination with DR IP Customizer. For information about how you can use subnet-level IP mapping rules and DR IP Customizer together, see Customizing IP Properties for Multiple Virtual Machines.

You find the dr-ip-customizer.exe executable file in C:\Program Files\VMware\VMware vCenter Site Recovery Manager\bin on the Site Recovery Manager Server host machine. When you run dr-ip-customizer.exe, you specify different options depending on whether you are generating or applying a comma-separated value (CSV) file.

dr-ip-customizer.exe 
--cfg SRM Server configuration XML
--cmd apply/drop/generate 
[--csv Name of existing CSV File] 
[--out Name of new CSV file to generate] 
[--vc vCenter Server address] 
[--ignore-thumbprint] 
[--extra-dns-columns] 
[--verbose]

You can run the DR IP Customizer tool on either the protected site or on the recovery site. Virtual machine IDs for protected virtual machines are different at each site, so whichever site you use when you run the DR IP Customizer tool to generate the CSV file, you must use the same site when you run DR IP Customizer again to apply the settings.

Some of the options that the DR IP Customizer tool provides are mandatory, others are optional.

Table 1. DR IP Customizer Options

Option

Description

Mandatory

-h [ --help ]

Displays usage information about dr-ip-customizer.exe.

No

--cfg arg

Path to the XML configuration file of the Site Recovery Manager Server, vmware-dr.xml file.

Yes

--cmd arg

You specify different commands to run DR IP Customizer in different modes.

  • The apply command applies the network customization settings from an existing CSV file to the recovery plans on the Site Recovery Manager Server instances.

  • The generate command generates a basic CSV file for all virtual machines that Site Recovery Manager protects for a vCenter Server instance.

  • The drop command removes the recovery settings from virtual machines specified by the input CSV file.

Always provide the same vCenter Server instance for the apply and drop commands as the one that you used to generate the CSV file.

Yes

--csv arg

Path to the CSV file to use as input.

Yes, when running the apply and drop commands.

-o [ --out ] arg

Name of the new CSV output file that the generate command creates. If you provide the name of an existing CSV file, the generate command overwrites its current contents.

Yes, when you run the generate command.

--vc arg

vCenter Server address. Virtual machine IDs for the protected virtual machines are different at each site. Use the same vCenter Server instance when you generate the CSV file and when you apply it.

Yes

-i [ --ignore-thumbprint ]

Ignore the vCenter Server thumbprint confirmation prompt.

No

-e [ --extra-dns-columns ]

Obsolete.

No

-v [ --verbose ]

Enable verbose output. You can include a --verbose option on any dr-ip-customizer.exe command line to log additional diagnostic messages.

No