This document explains how to migrate users into H-Sphere from H-Sphere and other control panels using XML-structured data. It can also serve as a guide to setting up a large number of H-Sphere users at a time. You are expected to have an installed and configured H-Sphere control panel on the target server.

• Migratable Resources
• Migration Procedure
• Formatting User Data
• Preparing Target CP
• Creating Accounts
• Troubleshooting

Migratable Resources

Users can be migrated with the following resources:

• User contact and billing info
• Domains (with or without DNS)
• DNS: custom A, MX, CNAME records; domain vhost aliases; domain aliases with their DNS and mail configuration
• Web: settings, FrontPage, CGI, CGIDir, MIME, PHP, SSI, ErrorDoc, ErrorLog, TransferLog, Webalizer, ModLogAn, RefferrerLog, AgentLog, Vhost alias, Directory indexes, Redirect, Urchin3, Urchin4, ASP, ASP.NET, ColdFusion, MSSQLManager
• Mail: Mailboxes, Autoresponder for mailboxes, Mailforwards, Mailing lists
• FTP: resources: virtual hosts, anonymous virtual hosts, virtual host directories with permissions, virtual host users, FTP subaccounts (Unix)
• MySQL: users, databases with user permissions
• PostgreSQL: users, databases
• MSSQL: users, logins, databases
• ODBC: dsn records with params
• Crontab: crontab records for users

The following resources are NOT YET implemented in XML migration mechanism:

• DNS: instant access domain alias
• Web: SSL, Shared SSL, MivaEmpresa, MivaCart, osCommerce, PhpBB

Migration Procedure

The migration procedure takes the following steps:

1. Create an xml file containing user data (Formatting User Data).
2. Prepare the target control panel.
3. Create reseller plans in the admin CP of the target H-Sphere installation. Omit this step if you don't have resellers.
4. Create resellers. Omit this step if you don't have resellers.
5. Create end user plans.
6. Create end users.

Formatting User Data

Create xml and dtd files to migrate resellers and end users or end users without resellers.

If you are moving users from H-Sphere, do it with the UserInfoExtractor utility as suggested in Creating User Migration XMLs In H-Sphere.

If you are moving users from a different control panel, follow the instruction on Creating User Migration XMLs Outside H-Sphere.

Preparing Target CP

Before you start creating accounts from the xml files, go to the target H-Sphere control panel and do the following:

1. Make sure that the names of the plans are exactly the same as those in your user data xml file. To get a list of all reseller and user plans in the system, run:
   java psoft.hsphere.migrator.ResellerUserCreator -d migrate_resellers.xml -dl -pp
2. In the xml file, find users that have empty or filled mysql tag. In the control panel, enable MySQL resource for the plans you are migrating these users to.
3. If you intend to migrate the existent user content into H-Sphere, include but deactivate FrontPage in all plans you are migrating your customers to, and in which FrontPage will be used.
4. If you want to preserve original billing period start date, make sure that the billing periods have the same duration and go in the same order as those in your old control panel.

Now you are ready to create the accounts.

Creating Accounts

1. Creating Resellers: If you have resellers, run ResellerUserCreator to create resellers without users:
   java psoft.hsphere.migrator.ResellerUserCreator -d migrate_resellers.xml -l migrate.log -dl
   where:
   -d migrate_resellers.xml - the name of the xml file to be migrated;
   -l migrate.log - the name of the log file;
   -dl - write detailed log.
2. Creating End User Plans: Migrate plans for your direct end users and end user of your resellers. To view a list of all reseller and user plans in the system, run:
   java psoft.hsphere.migrator.ResellerUserCreator -d migrate_resellers.xml -dl -pp
3. Creating End Users: Run ResellerUserCreator again to create end users:
   java psoft.hsphere.migrator.ResellerUserCreator -d migrate_resellers.xml -l migrate.log -dl -cu
   where option -cu is used for creating end users.

Troubleshooting

If the migration software fails to create a reseller/end user account, it will return an error and stop the migration. In this case, read the messages on the screen to find which user caused the failure, read the log file and try to remove the cause of the error.

Note: If the domain tag of this user in the XML file contains the ip attribute and if the IP in this user's domain was created before the error occurred, go to the H-Sphere control panel and delete this IP.