Parallels H-Sphere Documentation System Administrator Guide

 

Creating User Migration XMLs in H-Sphere

(versions 2.4.x)
 
 

Related Docs:   Migrating Users into H-Sphere Creating User Migration XMLs Outside 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


Related Docs:   Migrating Users into H-Sphere Creating User Migration XMLs Outside H-Sphere



© Copyright 2017. Parallels Holdings. All rights reserved.