Physical Creator

(version 2.3 and higher)


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:
    - home dirs with the default H-Sphere content (NOT user content)
    - 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.

Home   Products   Services   News
© Copyright. . PSOFT. All Rights Reserved. Terms | Site Map