Skip to main content
Version: 2023.3

Configuring Services

important

This article only applies to resources based on 1st Gen shells. While CloudShell supports 1st Gen shells, we recommend using 2nd Gen shells, which offer enhanced shell management capabilities. For details, see Shells Overview.

Creating a service catalog category

To make the service available to users of a specific domain, you must create a service category for that domain and then associate the service family to this service category. This is a two step process: first create a service category that can access the domain, and then attach the service category to the service.

Creating a service category for a domain

To create a service category:

  1. Log in to CloudShell Portal as system administrator.

  2. In the main menu, click Manage.

  3. In the left pane, click Categories.

  4. To create a new category click Add New Category.

    The Add New Category dialog box is displayed.

  5. Enter the required information:

    FieldRequiredDescription
    NAMERequiredCategory name that displays in the catalog.
    DESCRIPTIONOptionalDescription of the category.
    CATALOGView onlyThe type of category, selected automatically according to categories view selection
    LOCATIONOptionalDetermines if the current definition is a category or sub-category:
    If you leave the selection with slash (‘/’), then this definition is a Category.
    If you select a value, then this definition becomes a sub-category of the selected category.
    DOMAINSOptionalSelect the domain or domains where the category will be available.
    If you are a domain administrator, the selected domain is displayed but cannot be changed.
    If this category is a sub-category, this field inherits the domain values that were selected for the main category. The sub-category can be displayed in less domains than the main category. However, additional domains cannot be added.
    IMAGEOptionalYou can add an image to the catalog definition. The recommended size for the image is 190x120 pixels (image size is limited to 400x400 pixels or 200Mb).
  6. Make sure to select the required domain.

  7. Click Save.

Creating a service resource family

A service family is a special type of resource family. A service family can hold one or more services of the same type. Service families, and the services under them, are created in the Resource Manager by the administrator.

To create a service resource family:

  1. Open Resource Manager Client with administrator credentials.

  2. In the Admin tab click Resource Families.

  3. In the Resource Families explorer, right-click Resource Families, select New and then click Resource Family.

  4. In the New Resource Family dialog box, in the Name field, enter the name of the resource family.

  5. You can optionally enter a Description and provide an Image for the new resource family for services. The maximum allowed image size is 240 KB but it is recommended to use 32x32 pixel icons.

  6. Select the Service Template check box and from the Type dropdown list that is displayed to the right of the check box, select Regular.

  7. Click OK.

A new service resource family is created.

The new service resource family displays in the Resource Families explorer. In the list of resource families, the service icon displays alongside the name of the service family, distinguishing it from other resource families.

Managing attributes, rules and categories for service families

In Resource Manager Client, in the Parameters workspace of a service family, you can manage the attributes, rules and categories and perform the following actions:

  • Associate attributes and rules to be inherited by all the services of this family.
  • Link the service family to one or more categories.
note

Services only display in the services catalog in CloudShell Portal if the resource family of that service is linked to a service category.

To manage service families parameters:

  1. In Resource Manager Client, in the Admin tab, click Resource Families.

  2. In the Resource Families explorer, select the required service family. For the purposes of this procedure, the Quali VM service family is selected.

    The details of the service family display in the Parameters workspace.

  3. To associate an attribute, in the Attributes tab, click Add/Remove From Bank.

  4. In the Resource Family Attributes dialog box, select the required attributes and click OK.

  5. To apply rules to the attribute, select the attribute in the workspace.

  6. Click Edit Rules.

  7. In the Attribute Rules dialog box, specify the required rules and click OK.

    Important

    The attribute inheritance feature will be deprecated in an upcoming release. Please do not use this setting. For additional information, see Configuring attribute inheritance settings or contact Quali Support.

  8. To link the service family to a domain category, in the Categories tab click Add.

  9. In the Select Category dialog box, select the required categories and click OK.

    The selected categories display in the Categories dashboard.

Creating a service

Services are created under the service families to which they belong. New services are created in Resource Manager using the New Resource Model dialog box.

To create a new service:

  1. In Resource Manager Client, in the Admin tab, click Resource Families.

  2. In the Resource Families explorer, right-click the required service family within which to create the service. For the purposes of this procedure, the Quali VM service family is selected.

  3. Select New and then click Resource Model.

  4. In the New Resource Model dialog box, enter the name and description of the service.

  5. Click OK.

    The new service is created and displays in the Resource Families explorer under the service family to which it belongs.

Configuring service attributes

This section assumes you already added the attribute(s) to the service, as explained in Managing attributes, rules and categories for service families. To learn how to create attributes in CloudShell, see Attributes.

To configure service attributes:

  1. In the Resource Families explorer, select a service and in the Parameters pane select the Attributes tab.
  2. To associate attributes or remove existing attributes, click Add/Remove From Bank.
  3. To set a default attribute value or mark an attribute as user input, click Edit Rules.
    User input attributes are presented to the user when adding a service to a blueprint or a sandbox. The user is then prompted to update the attribute values.

Associating a driver to a service

Service driver commands can be executed manually by the user while the sandbox is active, or automatically by the blueprint driver on blueprint setup and teardown.

To associate a driver to a service:

  1. From the Resource Families explorer, select the required service.

The service’s Properties pane is displayed.

  1. Select the Drivers tab.

  2. Click Add/Remove from bank.

  3. In the Select Drivers dialog box, select the drivers to associate with the service.

  4. Click OK.

Associating a script to a service

Scripts are associated to service models in the Resource Scripts page of the Manage dashboard of the CloudShell Portal. See Managing Assets.