Parallels H-Sphere Documentation System Administrator Guide


IP Migration Map XML File

(2.4 and up)

Related Docs:   IP Migration Running The IP Migrator Script

Last modified: 16 Jun 2005


WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

IP migration map XML file contains the set of IPs to be replaced with new ones. This file must be created in the cpanel user home directory ~cpanel/ and must have cpanel:cpanel ownership.

This document explains alternative ways of creating ipmigration.xml.


Creating ipmigration.xml Manually

IP migration XML has the following format:

<?xml version="1.0"?>
<!DOCTYPE ips [
<!ELEMENT ips (ip+)>

<!ATTLIST ip new_mask CDATA "[New_NetMask]">
    <!-- Delete the lines with IPs you don't want to migrate! -->
    <ip name="[Old_IP1]" new_ip="[New_IP1]"/>
    <ip name="[Old_IP2]" new_ip="[New_IP2]"/>
    <ip name="[Old_IP3]" new_ip="[New_IP3]"/>
    <ip name="[Old_IP4]" new_ip="[New_IP4]" new_mask="[New_NetMask2]"/>

In the DTD header of the XML file, specify what attributes will be provided with each IP. Set [New_NetMask] to the default netmask value for new IPs:

<!ATTLIST ip new_mask CDATA "">

To set a different netmask for a particular IP, set the new_mask attribute in the ip tag for that IP. Otherwise, omit the new_mask attribute.

In the <ips> ... </ips> block, list all old-new IP pairs, including users' dedicated IPs. If you have specified the common netmask in the DTD header, you don't need to set it in the definition line for each individual IP:

<ip name="[Old_IP]" new_ip="[New_IP]" />

If you have set new mask in the DTD header to #REQUIRED, you need to specify the netmask parameter for each IP:

<ip name="[Old_IP]" new_ip="[New_IP]" new_mask="[New_NetMask]"/>


Creating ipmigration.xml By H-Sphere IP Migrator

IP Migrator 3.0 allows you to create ipmigration.xml automatically when you perform migration by running the IP migrator script.

Related Docs:   IP Migration Running The IP Migrator Script

© Copyright 2018. Parallels Holdings. All rights reserved.