You can use the DR IP Customizer tool to customize the IP properties for multiple virtual machines that Site Recovery Manager protects.
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.
Prerequisites
- Use the DR IP Customizer tool on a computer with access to vCenter Server instances in your environment.
- If you are using Site Recovery Manager for Windows, the user account that you use to run the DR IP Customizer tool requires at least the Site Recovery Manager Recovery Plans Administrator role.
- If you are using the Site Recovery Manager Virtual Appliance, you must SSH with the admin user.
Procedure
- Log in to the Site Recovery Manager Server host and open a command shell.
- Change the working directory to:
- For Windows C:\Program Files\VMware\VMware vCenter Site Recovery Manager\bin.
- For Linux /opt/vmware/srm/bin/.
- Run the dr-ip-customizer command to generate a comma-separated value (CSV) file that contains information about the protected virtual machines.
- If you have a Platform Services Controller with a single vCenter Server instance
For Windows, run the following command:
dr-ip-customizer.exe --cfg "SRM_install_dir\config\vmware-dr.xml"
--cmd generate --out "path_to_CSV_file.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
For Linux, run the following command:
/opt/vmware/srm/bin/dr-ip-customizer --cfg "/opt/vmware/srm/conf/vmware-dr.xml"
--cmd generate --out "/home/admin/output.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
This example points dr-ip-customizer to the vmware-dr.xml file of the Site Recovery Manager Server and generates the CSV file for the vCenter Server instance that is associated with the Platform Services Controller at https://Platform_Services_Controller_address.
- If you have a Platform Services Controller that includes multiple vCenter Server instances, you must specify the vCenter Server ID in the --vcid parameter. If you do not specify --vcid, or if you provide an incorrect ID, the tool lists all available vCenter Server instances.
For Windows, run the following command:
dr-ip-customizer.exe --cfg "SRM_install_dir\config\vmware-dr.xml"
--cmd generate --out "path_to_CSV_file.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
--vcid vCenter_Server_ID
For Linux, run the following command:
/opt/vmware/srm/bin/dr-ip-customizer --cfg "/opt/vmware/srm/conf/vmware-dr.xml"
--cmd generate --out "/home/admin/output.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
--vcid vCenter_Server_ID
This example points dr-ip-customizer to the vmware-dr.xml file of the Site Recovery Manager Server and generates the CSV file for the vCenter Server instance with the ID vCenter_Server_ID.
Note: The
vCenter Server ID is not the same as the
vCenter Server name.
- (Required) Check the vCenter Server thumbprint and enter y to confirm that you trust this vCenter Server instance.
If you specified the
--ignore-thumbprint option, you are not prompted to check the thumbprint.
- Enter the login credentials for the vCenter Server instance.
You might be prompted again to confirm that you trust this
vCenter Server instance.
- Edit the generated CSV file to customize the IP properties for the virtual machines in the recovery plan.
You can use a spread sheet application to edit the CSV file. Save the modified CSV file under a new name.
- Run dr-ip-customizer to apply the customized IP properties from the modified CSV file.
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.
- If you have a Platform Services Controller with a single vCenter Server instance
For Windows, run the following command:
dr-ip-customizer.exe --cfg "SRM_install_dir\config\vmware-dr.xml"
--cmd apply --csv "path_to_CSV_file.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
For Linux, run the following command:
/opt/vmware/srm/bin/dr-ip-customizer --cfg "/opt/vmware/srm/conf/vmware-dr.xml"
--cmd apply --csv "/home/admin/output.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
This example points dr-ip-customizer to the vmware-dr.xml file of the Site Recovery Manager Server and applies the customizations in the CSV file to the vCenter Server that is associated with the Platform Services Controller at https://Platform_Services_Controller_address.
- If you have a Platform Services Controller that includes multiple vCenter Server instances, you must specify the vCenter Server ID in the --vcid parameter.
For Windows, run the following command:
dr-ip-customizer.exe --cfg "SRM_install_dir\config\vmware-dr.xml"
--cmd apply --csv "path_to_CSV_file.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
--vcid vCenter_Server_ID
For Linux, run the following command:
/opt/vmware/srm/bin/dr-ip-customizer --cfg "/opt/vmware/srm/conf/vmware-dr.xml"
--cmd apply --csv "/home/admin/output.csv"
--uri "https://Platform_Services_Controller_address[:port]/lookupservice/sdk"
--vcid vCenter_Server_ID
This example points dr-ip-customizer to the vmware-dr.xml file of the Site Recovery Manager Server and applies the customizations in the CSV file to the vCenter Server instance with the ID vCenter_Server_ID.
Results
The specified customizations are applied to all of the virtual machines named in the CSV file during a recovery. You do not need to manually configure IP settings for these machines when you edit their recovery plan properties.