Creating User Migration XMLs in H-Sphere

Last modified: 27 Dec 2007

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.

This document explains how to create XML files with H-Sphere reseller and end user data for migration to a different H-Sphere cluster.

User info can be obtained and formatted with the UsersInfoExtractor utility executed under Control Panel user.

In H-Sphere versions earlier than 2.5, UsersInfoExtractor extracts resellers together with their end users into a single XML file.

Note: Starting with version 2.5, UsersInfoExtractor extracts resellers and their end users into separate XMLs. See Creating User Migration XMLs in H-Sphere (HS 2.5 and up)

UsersInfoExtractor can be used with the following parameters:

• -usersbynames - extract individual users by usernames:
  

  java psoft.hsphere.migrator.UsersInfoExtractor [-force] -resellersbynames -usersbynames <USERNAME-1> ... <USERNAME-N>

  Make sure -resellersbynames are specified as a parameter
• -resellersbynames - extract users that belong to certain resellers:
  

  java psoft.hsphere.migrator.UsersInfoExtractor [-force] -resellersbynames <RESELLER-1> ... <RESELLER-N>

• -usersfromfile - extract individual users by usernames listed in a plain text file:
  

  java psoft.hsphere.migrator.UsersInfoExtractor [-force] -usersfromfile /home/users.txt

• -resellersfromfile - extract users that belong to resellers listed in a plain text file:
  

  java psoft.hsphere.migrator.UsersInfoExtractor [-force] -resellersfromfile /home/resellers.txt

• -usersbylserver - extract users located on a certain logical server:
  

  java psoft.hsphere.migrator.UsersInfoExtractor [-force] -usersbylserver <LSERVER_ID>

Use the force parameter to ignore errors. Error messages will be written to migrate_errors.log.

Note: You can't extract admin data to migrate as a reseller. This has to be done manually. The reverse also holds true.

See also:
Sample xml file with reseller and end user data
Sample dtd file for resellers   |   Explanations to dtd file for resellers
Sample dtd file for end users   |   Explanations to dtd file for end users