Physical Creator

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 psoft.hsphere.tools.PhysicalCreator OPTIONS
   where:
   -Xms64M - recommended minimum memory for this process
   -Xmx512M - recommended maximum memory for this process
   OPTIONS:
   

   -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 psoft.hsphere.tools.PhysicalCreator -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 psoft.hsphere.tools.PhysicalCreator -rg winweb -co -lid 26 -st 1590055 > creator.log 2>&1 &
   

   Here is another example of the entire command:
   

   bash-2.05a$ java psoft.hsphere.tools.PhysicalCreator -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 psoft.hsphere.tools.PhysicalCreator -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.