|
|
|
|
Below we describe command line tools for importing data in the form of XML file into Parallels Business Automation - Standard database.
Only accounts, documents, and hosting plans can be imported as an XML file. Subscriptions are imported using a special script that uses the Parallels Business Automation - Standard XML API.
Note: Parallels Business Automation - Standard provides web-based tools for XML data import (Import-Export Manager in Provider Control Center). If you would like to, you can use this tool (please refer to the Parallels Business Automation - Standard Provider's guide fo more information or go to Provider Control Center and click Help link for detailed HTML help).
After the Parallels Business Automation - Standard installation, the import script location on your Management Node is /usr/sbin/hspc-import.pl.
The Import script reads an XML file that contains the data to be imported, imports data Parallels Business Automation - Standard database, after the XML file is validated and the data correctness is checked. Errors (if any) are put in STDERR.
Command line syntax:
/usr/sbin/hspc-import.pl [keys] file.xml
where file.xml must be replaced with the name of an actual xml file containing billing data to be imported.
Keys:
-h, --help see help page
If an XML file is not defined the data is read from STDIN.
If something goes wrong, e.g., an XML structure is not valid, the script stops and rolls back all the changes made before an outage.
To prepare for the billing data import, you will need to create a set of relevant hosting plans in Parallels Business Automation - Standard to "move" customers to these hosting plans. When you create such hosting plans, you should take into account the fees, resources configuration, applications set, and all the other parameters of the subscription you are going to move to Parallels Business Automation - Standard for future management and billing.
When you create hosting plans in Parallels Business Automation - Standard, each of these plans gets the unique numerical identifier (ID) assigned automatically in Parallels Business Automation - Standard to all objects (including hosting plans). This ID should be indicated with the relevant tag in the XML file so that the import script could fetch the fees and other data from this hosting plan when creating the subscription.
The import script creates accounts and, for each account imported - one or more subscriptions that correspond to the preset Parallels Business Automation - Standard hosting plans. As a result, a customer obtains the "empty" Container or Plesk domain that is managed and billed by Parallels Business Automation - Standard. The personal customer data (websites, mailboxes, home directory contents, etc.) can be manually moved into a newly created Container or Plesk domain.