Manage Service Add-ons

This chapter provides an overview on how to manage user and system service add-ons in OnApp. You can view, create, edit, delete service add-ons and manage their On add, On remove, On VS Destroy and On VS Rebuild events.

  • To manage user service add-ons, ensure that Service Add-ons permissions are on. 
  • To manage system service add-ons, ensure that Manage System Service Add-ons permissions are on. For more information about permissions refer to the Permissions section of this guide.



View service add-ons



The Control Panel's Service Add-ons menu lists all of the service add-ons available on your system.

To view the list of service add-ons: 

  1. Go to your Control Panel > CloudService Add-ons menu in the left navigation pane. You'll see a list of service add-ons on your system together with their details: 
    • Label - the service add-on name ( if you click the service add-on label, you will be redirected to the Edit page)
    • Type - select user or system
    • Compatible with – choose if the service add-on can be assigned to Unix-based, Windows-based, or both types Virtual servers upon creation.

    • Number of Add events - the amount of Add events in the service add-on
    • Number of Remove events - the amount of Remove events in the service add-on
    • Number of On VS Rebuild events - the amount of On VS Rebuild events in the service add-on
    • Number of ON VS Destroy events - the amount of On VS Destroy events in the service add-on
    • Actions column - click the Actions button to view the actions, which you can perform with the service add-on (edit, delete, applied to VS)

The service add-ons are organized into four tabs:

    • All service add-ons - the list of all the service add-ons created in the cloud.
    • Unix service add-ons - the service add-ons that have been created as compatible with Unix virtual servers only. 
    • Windows service add-ons - the service add-ons that can be assigned to Windows VSs only.

    • Unix/Windows service add-ons - the service add-ons that are compatible with both Unix and Windows-based virtual servers.



Create service add-on



When creating a service add-on, at first you specify its properties, and then attach On add, On remove,On VS Destroy and On VS Rebuild events.

To create a service add-on:

  1. Go to your Control Panel > Cloud > Service Add-ons menu. 
  2. Click the "+" button.
  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)

      The icon should have width less than or equal to 200px and should have height less than or equal to 200px.

    • 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 the OS system, with which the service add-on is compatible (Windows, Unix or both)

  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, On Remove, On VS Destroy and On VS Rebuild events. For more details refer to the section below. 

Service add-on events management



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:

Run Recipe Actions

Recipes are available for service add-on configuration. The recipes will run on Virtual servers and vCloud director 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. The recipes are not filtered according to compatible with type. 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.

Be aware, that if you add several recipes to the event, they will be fulfilled in the top-down order.


To create a Run Recipe action:

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, click the "+" button > Add Recipe Action at On add ,On remove,On VS Destroy or On VS Rebuild event menu.
  4. Choose recipe from the drop-down list.
  5. Choose destination:
    • Run on Virtual Server - choose it if you want to run this recipe action only on VS, to which this service add-on will be assigned
    • Run on Control Panel - choose it if you want to run this recipe action on the whole Control Panel. For more information refer to the Control Panel Recipes Settings.
  6. Click Add.


To edit a Run Recipe action: 

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, click the  button next to the Run Recipe action you want to edit.
  4. Choose recipe from the drop-down list and click Update Action.


To delete a Run Recipe action: 

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, click the  button next to the recipe you want to delete. Confirm the deletion.

Raise Event Actions

Raise event actions become available starting with OnApp 5.5 version. This is an action type that sends notification to all subscribed recipients. 


Notification Configuration

To configure a notification, which will be sent when adding a 'Raise Event" action, fulfill the following steps:

  1. Ensure that notifications are enabled for your cloud.
  2. Go to Control Panel > Admin > Notifications > Recipients Lists and create a new recipient list of users whom you want to notify about certain event.
  3. Go to Control Panel > Admin > Notifications > Notification Templates and create message text that will be sent to your users. 

    If you add a '%{message}' text to the template, the notification will contain the information about the service add-on name, VS name and identifier. For example: "The Test Service Add-on has been added to a Test Virtual Server with the ID abcdefghijk."

    If you add a '%{name}' text to the template, the notification will contain the user's name.

  4. Go to Control Panel > AdminNotifications > Gateways and determine in what way users will be contacted: via email or internal notifications in CP.
  5. A subscription is the final step of a notifications configuration which ties together a recipients list, a gateway and a notification template. Go to Control Panel > Notifications > Subscriptions > New Subscription and fill in the following details:
    • Name - the label for the subscription
    • Event - select the Service addon event from the drop-down list.
    • Recipients list - select the recipients list which you have configured in the second step on this instruction.
    • Notification template - select the notifications template which you have configured in the third step on this instruction.
    • Gateway - select the gateway which you have configured in the fourth step on this instruction.
  6. Click Save.

For more information about subscriptions and messages configuration refer to the Notifications Setup.

Then you have to create a Raise Event action. For this:

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, click the "+" button > Raise Event at On add ,On remove,On VS Destroy or On VS Rebuild event menu.
  4. Click Add.


To delete a Raise Event action: 

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, click the  button next to the Raise Event action you want to delete. Confirm the deletion.

Edit service add-on



To edit a service add-on:

  1. Go to your Control Panel > CloudService Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you want to change, then choose Edit.
  3. On the screen that follows, enter service add-on details as required:
    • Label – change the service add-on name
    • Description – edit the service add-on description
    • Icon – change 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 the OS system, with which the service add-on is compatible (Windows, Unix or both)

  4. Click the Save button to finish.

Also you can manage On add, On remove, On VS Destroy and On VS Rebuild events at the Edit page.  


View service add-on applied to VSs



You can view the list of VSs, to which the service add-on is assigned. For this:

  1. Go to your Control Panel > Cloud > Service Add-ons menu. You'll see a list of service add-ons on your system.
  2. Click the Actions icon next to the service add-on you are interested in, then choose Applied to VS.
  3. On the screen that follows, you will get:
  • Label - the service add-on name 
  • Description – the service add-on description
  • The list of virtual servers, to which the service add-on is assigned, if there are any

For more information on how to assign service add-on to VS, refer to the Virtual Server Service Add-ons section of this guide.


Assign system service add-ons to template



If you assign a system service add-on to a template, the system service add-on will be assigned to the virtual servers later built from this template.

To assign system service add-ons to a template:

  1. Go to your Control Panel > Cloud > Template list. You'll see a list of templates, available on your cloud. 
  2. Next to the template in question click the Actions button and select the Manage Service Add-ons option. 
  3. Click the '+' button.
  4. The screen that follows shows the list of the available system service add-ons organized into groups. Click the arrow button next to a group to expand the list of add-ons assigned to it.
  5. Click the label of the necessary system service add-on to see its details:
    • Label
    • Type - user or system
    • Description
    • Price
    • Apply to existing Virtual Servers - move the slider to the right to assign the system service add-on to all the VSs in your cloud built from this template
  6. Click the Assign button to finish. 

Please note if you rebuild a virtual server from a different OS template, all added system service add-ons will be removed from it.

Delete service add-on



To delete a service add-on:

  1. Go to the Control Panel > Cloud > Service Add-ons menu.
  2. Click the Actions icon next to the service add-on you wish to delete, then choose Delete. Confirm the deletion. The transaction to execute the On remove event(s) will be scheduled.