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

User info can be obtained and formatted with the UsersInfoExtractor utility executed on the Control Panel server as root. 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