Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This is potentially dangerous module - it can execute any command script from scripts directory you pass to it, so its important to run your HostBill php/php-fpm processes under a isolated system user (not root).Syntax mistakes in module configuration can lead to irreversible data loss. 

System requirements & security precautions

...

Precautions below are for enterprise version installed using auto-install script. If your HostBill is installed on different user/paths - refer also to section Non-enterprise install

  • Make sure that /home/hostbill/scripts directory exists, and belongs to user hostbill
  • This module relies on php proc_open and exec functions, that are by default disabled in php.ini's disable_functions directive, to use it:
    • Use HostBill Queue module that runs tasks in background/trough cron, and with that can make use of different php settings, or
    • (not advised) remove proc_open and exec functions from php.ini disable_functions directive
  • Its not advised to use this module on shared environment.

Scripts requirements

...

  • Scripts should be placed in /home/hostbill/scripts 
  • Script should be made executable for hostbill user (chmod u+x)
  • If possible, use hashbang in your custom scripts 
  • On success your script should return 0 exit code.
  • On failure return any other exit code
  • Any script output is logged in related account log on error/success 
  • Before executing any script, module changes working directory (cwd) to main HostBill installation directory
  • Its not advised to use this module on shared environment.

...

  •  scripts directory