Parallels H-Sphere Documentation System Administrator Guide


Physical Creator

(version 2.3 and higher)

Last modified: 06 Feb 2006


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.

Physical Creator is a java class that generates web hosting resources and configurations on web, win, and mail servers using the data in the H-Sphere system database. This utility is used to recover and migrate user accounts. Since version 2.3 it is included into standard H-Sphere installation.

To run Physical Creator:

  1. Log into the control panel server as cpanel.
  2. Back up the content of the ~cpanel/shiva/psoft/ directory.
  3. Run Physical Creator:
    java -Xms64M -Xmx512M OPTIONS
    -Xms64M - recommended minimum memory for this process
    -Xmx512M - recommended maximum memory for this process
    -h|--help - shows the list of available options
    -rg|--rgroup - resource group to perform operations with
      The following resource groups are allowed:
      unixweb - Unix virtual hosting resources
      winweb - Windows virtual hosting resources
      mysql - MySQL resources
      mail - Mail resources

    -co|--create-only - performs creation resources routines only
    -do|--delete-only - performs delete resources routines only
    -rc|--recreate - performs both delete and creation resources routines
    -lid|--lserverId - process accounts on logical server with given number
    -accs|--accounts - account IDs separated by comma, e.g.:
        java -Xms64M -Xmx512M -rg winweb -co -lid 26 -accs 1725895 > creator.log 2>&1 &
    -st|--start-from - account ID. Process will start from this account ID. E.g.:
        java -Xms64M -Xmx512M -rg winweb -co -lid 26 -st 1590055 > creator.log 2>&1 &
    Here is another example of the entire command:
    bash-2.05a$ java -rg unixweb -co -lid 25
    This command will create:
    - empty home dirs
    - default configuration of FTP and HTTP virtual hosts on unix logical server with ID 25

    If PhysicalCreator hangs on one of the accounts, kill it, debug the issue, and then resume the process starting with this account, e.g.:
        java -Xms64M -Xmx512M -rg winweb -co -lid 26 -st 1590055 > creator.log 2>&1 &

  4. Restore the backup of the ~cpanel/shiva/psoft/ directory to the original (recovery) or target (move) location.
  5. Restart H-Sphere.

© Copyright 2018. Parallels Holdings. All rights reserved.