Recipes are scripts that automatically run on a virtual machine after OS deployment from a template. They help prepare a virtual machine for specific operations: install packages, edit configuration files, etc.

Adding recipes in BILLmanager

To be able to use recipes, you need to enable the corresponding option for the processing module. Navigate to "Integration" → "Processing module" → "Add" or "Edit":

Use recipes - select this check box to be able to choose a recipe when ordering a service. The "Pre-installed" field will be added to the service order form.

Completion of server deployment - this parameter defines when a service status in BILLmanager will change into "Active'. Possible values: 

  • After template setup - a service status will change to "Active" after OS template is successfully installed; the recipe installation command will be executed, but the system won't wait for the command to complete. 
  • After recipe setup - a service status will change to "Active" after the recipe is successfully installed on a selected OS; in the case of an error, the server won't be deployed, and the system will try to create another virtual machine.

In BILLmanager recipes are represented by the "Pre-installed software" parameter with a list of values. Navigate to  "Products" → "Product types" → select "VPS" → "Parameters" → "Preinstalled software" → "Values":

Every value has a tag which allows binding the "Pre-installed software" parameter with the "Operating system" and "Control panel license". 

Rules:

  • A recipe is compatible with the operating system if the "Pre-installed software" and "Operating system" parameters have at least one similar tag. 
  • A control panel license corresponds to the recipe if the selected parameter "Pre-installed software" has the special tag:  'lic_<License_name>'. A tag is generated from the 'lic_' prefix and license name. Spaces in the name should be changed into underscore: 'ISPmanager_5_Lite'.  Tag: 'lic_ISPmanager_5_Lite'.

For every operating system, you can see only those recipes that are compatible with that OS. When selecting a recipe the "Control panel license" addon is set automatically (if the  lic_License_name  tag is specified and the corresponding license is ordered)

How to configure recipes in VMmanager.