This chapter provides an overview on what service add-ons in OnApp are, the management tips, the information on creating your own service add-ons and providing them as a paid resource for your customers.

Service Add-ons functionality allows you to present to your customers additional services on top of your current IaaS Virtual Server offering. You can offer features such as Managed Services, Software Installations and components currently not integrated in OnApp.


System Service Add-Ons

In OnApp, there are two types of service add-ons: user and system. User service add-on can be optionally assigned or removed by users upon their desire to use or not the specific extra resources you offer. A system service add-on provides the ability for you to add obligatory services to a virtual server, template, or OVA, which cannot be removed by an end user. 

Below you can find more details on each step of the workflow. 

Create Service Add-On

  1. Go to your Control Panel > Cloud > Service Add-ons > Service Add-ons menu in the left navigation pane. 
  2. On the following page, click upper right.
  3. On the screen that follows:
    • Label – give your service add-on a name 
    • Description – add the service add-on description

    • Icon – upload the service add-on icon (click Choose File to select a necessary image)

    • Available on VS provisioning - move the slider to the right to be able to choose this service add-on when creating a VS (providing that the Replace recipes permission is enabled and the billing settings allow). 
    • System service add-on - move the slider to the right to make the add-on obligatory for a user and impossible to remove. 

    • Compatible with – choose if the service add-on can be assigned to Unix-based, Windows-based, or both types Virtual servers upon creation.

  4. Click Save. The service add-on will be created and you will be redirected to the Edit page, where you can manage On Add and On Remove events. 

For details on service add-on creation, refer to the Manage Service Add-ons section of this guide.

Add Events to Service Add-On

Service add-on events let you configure which actions will be run on the VS, to which the service add-on is assigned. The transactions for running the On Add events will be scheduled at the  moment when the service add-on is assigned to a VS. The transactions for running the On Remove events will be scheduled at the moment when the service add-on is re-assigned from a VS. The transactions for running the On VS Destroy events will be executed before 'Destroy VS' transaction. The transactions for running the On VS Rebuild events will be executed after VS rebuild. 

Currently the following events are available:

1) Run Recipe actions are available for service add-on configuration, in particular the recipes that run on Virtual Servers. 

Prerequisite

The recipes should be created beforehand, properly configured and tested.

The list of recipes that can be assigned to a service add-on depends on the user plan settings - it is possible to choose only from those recipe groups which are added to the bucket. Also it is required to have the View recipes permission to be able to attach a recipe event to a service add-on. Make sure that the recipe Compatible with parameter and the service add-on Compatible with parameter are consistent. Otherwise, running the event will fail for a VS.

2) Raise Event action type that sends notification to all subscribed recipients. The subscriptions and the messages are configured at Subscription.

For more information on how to manage On add events and On remove events for service add-on, refer to the Manage Service Add-ons section of this guide.

Service Add-On Store

After you have created the service add-ons and properly configured events for them, proceed to arranging the service add-ons into a groups of services. A Service add-on store enables you to organize individual service add-ons into groups that can be further added to a plan to control user access. Only those groups which are added to a bucket will be available to a user. You can arrange the service add-ons into groups depending on their type, price, or whatever other attribute.

The prices for the individual service add-ons are also set in the Service add-ons store per service add-on per hour. This is the additional price that will be calculated for the VS besides the resources cost.

For detailed instructions, refer to the  Manage Service Add-on Store section of this guide.

Pricing and Access Control

To make service add-on available to users, go to the bucket's Access Control section and add the required service add-on groups. The users under the bucket will have access only to the service add-on groups which were added to their Access Control.

To set the pricing for the individual service add-ons, go to the bucket's Rate Card section menu and indicate the price for required service add-ons per service add-on per hour as well as the additional cost for VS CPU, RAM and disk size. These prices will be charged additionally to the VS price.

For more info, refer to the  Manage Service Add-on Store and Configure Resource Allocation And Prices sections of this guide.

Permissions

The following permissions regulate service add-on functionality:

Service Add-ons

  • Any actions on Service Add-ons - the user can perform any operations on Service Add-ons - view, create, edit and delete service add-ons
  • Create new Service Add-ons - the user can create new Service Add-ons (Control Panel > Cloud > Service Add-ons > Service Add-ons menu > )
  • Delete Service Add-ons and Delete own Service Add-ons - the user can delete Service Add-ons  (Control Panel > Cloud > Service Add-ons > Service Add-ons menu > the Actions button > Delete)
  • Edit any Service Add-on and Edit own Service Add-ons - the user can update Service Add-ons (Control Panel > Cloud > Service Add-ons > Service Add-ons menu > the Actions button > Edit)
  • Read all Service Add-ons and Read own Service Add-ons - the user can view Service Add-ons (Control Panel > Cloud > Service Add-ons > Service Add-ons menu)

Service Add-on Groups

  • Any action on Service Add-on Groups - the user can take any action on Service Add-on Groups -  view, create, edit and delete service add-on groups
  • Create a new Service Add-on group - the user can create a new Service Add-on group and add child service add-on groups (Control Panel > Cloud > Service Add-ons > Store menu > and Add Child button)
  • Destroy any Service Add-on group and Destroy own Service Add-on group  - the user can delete Service Add-on groups (Control Panel > Cloud > Service Add-ons > Store menu >  next to the service add-on group you want to delete)
  • See all Service Add-on groups - the user can see all Service Add-on groups (Control Panel > Cloud > Service Add-ons > Store menu)
  • Manage any Service Add-on group - the user can manage a Service Add-on group (the user can edit a service add-on group, assign a particular service add-on to a service add-on group, remove service add-on from the service add-on group, edit service add-on price).

Virtual Servers

  • Manage Service Add-ons for all virtual servers and Manage Service Add-ons for own virtual servers - the user can manage Service Add-ons for virtual servers (Control Panel > Cloud > Virtual Servers menu > VS label > Overview > Service Add-ons)
  • Manage System Service Add-ons - the user can manage the system service add-ons of all VSs in the cloud
  • Manage own System Service Add-ons - the user can manage system service add-ons assigned to one's own virtual servers

Virtual Machine Statistics

  • See Virtual Machine Statistics - the user can see the system service add-ons usage report

Replace Recipes

  • Replace recipes - the user can replace Recipes with Service Add-ons in VS creation wizard. The Service Add-ons step will appear in wizard if the other conditions are met (such as availability in buckets, etc.). This permission is disabled by default.

OVAs

  • Manage System Service Add-ons - the user can manage the system service add-ons assigned to all OVAs in the cloud
  • Manage own System Service Add-ons - the user can manage system service add-ons assigned to the OVAs uploaded by the user

Templates

  • Manage System Service Add-ons - the user can manage the system service add-ons assigned to all templates in the cloud
  • Manage own System Service Add-ons - the user can manage system service add-ons assigned to the templates uploaded by this user

For more information about permissions, refer to the Permissions chapter of this guide.

See also:

Leave feedback