Script Provisioning Addon

Script provisioning addon is a plugin for Script Provisioning module - please refer to the module's documentation first.

The addon is available in Settings → Products & Services → Product Addons → Script Provisioning Addon (and duplicated for each new addon needed)

• The plugin is shipped with Script Provisioning module, and once this module is activated, Script Provisioning plugin is available in Product Addons section. 

• Proceed to the Connect with App section and configure the settings:
  
  

  • Check which events should execute a script (ie. terminate/create etc.)

  • From dropdown list select which script to execute (you should create scripts first)

  • Provide arguments that script should be executed with, here you can use variables (up-to-date list is available in product configuration):

Open

Note about arguments: 
All arguments will be escaped before execution for additional security. 

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 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 scripts directory

By default scripts should be located in /home/hostbill/scripts directory, to use custom dir on other installations, edit includes/config.php file and add lines:

Make sure that this directory is not accessible from web (outside of public_html or similar folders)