Configuring end-user Option Choices in service blueprints

There is no difference in functionality from where you open the Options Editor; these locations merely provide convenience to the cloud administrator.

1. Open the Options Editor
   
2. In the Options area, click New Option .
3. In the New Option window, enter a name and description for the option.
   
4. For Option Type, select whether the option is for request definition (service offering), post-deploy action (requestable offering), or any request.
   • Any Request — Available as an option for both service offerings and requestable offerings.
   • Request Definition (the default) — Available as an option for service offerings. This option lets you modify the service blueprint to take parameters that are used when the packages are deployed.
   • Post-deploy Action — Available as an option for requestable offerings.
5. Click Set Icon to upload an image (.jpeg, .png, or .gif formats) to the server and set it as an icon for the selected option.
6. Click OK.
    The new option is listed.

7. To allow users to choose more than one choice for an option, choose Multi-Select.
   By default, Multi-Select is not enabled, and end-users can select only one choice per option.

   Note

   Use caution when choosing Multi-Select. For example, do not choose Multi-Select if you are creating a service offering with the Storage Size option of 1 GB, 2 GB, or 3 GB. Users should only be allowed to pick one Storage Size choice in the service offering! Be careful not to create illogical combinations of fulfillment offerings.

8. In the Option Choices area, click New Option Choice.
   
9. In the New Option Choice window, enter a name (for example, 4 GB) and description for the option choice.
10. Set the Customer Price or Deployment Cost.
    
11. In the New Option Choice window, click OK.
     The new option choice is listed.
12. Repeat steps 8-11 for the 8 GB and 16 GB option choices.
13. To change the order of the choices, select a choice, and click the move up or down button.
     Customers will see the order of choices that you have defined.
14. To make a choice the default, select the Pre-Select check box.
15. Click Option Choice Blueprint Configuration Editor to select the appropriate option that modifies or extends the service blueprint configuration.
     For more information, see .
16. Click New Blueprint Configuration .
17. In the editor, select a blueprint configuration.
     For example, to add a memory option that extends the service blueprint, select Blueprint Configuration > Service Deployment Definition > Compute Resources > Memory Size.
    
18. In the Resource Set Identifier area, enter the Name of a resource set in the service blueprint, or select a Tag that identifies the resource set.
    
    For example, select Resource Sets > Web Servers to identify that you only want to update the memory of your web servers and not your database servers.
    If a service blueprint includes multiple resource sets, you must identify the particular instance. You can identify the particular instance by Name or by indicating a tag group or tag that is matched to a tag in the service blueprint.
19. Enter the values that extend the service blueprint.
     For example, enter memory size option (4096 MB).
20. Click OK.
21. In the Option Choice Blueprint Configuration Editor, click OK.
22. Create the remaining option choices (for example, for 8 GB and 16 GB).
23. When you are finished in the Option Editor, click OK to save your changes.

1. Open the Options Editor.
2. Click New Option .
3. Enter the Option Name and Option Description.
4. Select an option type.
    For example, select Request Definition.
5. (optional) Upload or copy an icon.
6. Click OK.
7. Click New Option Choice .
8. Enter the option choice, description, customer price, and deployment cost.
9. Click OK.
10. Select the option choice, and then click Option Choice Blueprint Configuration Editor .
     Here you select the appropriate option that modifies or extends the service blueprint configuration.
11. Click New Blueprint Configuration .
12. Click Blueprint Configuration, and select an option from the list.
     For example, select Blueprint Configuration > Service Definition > Component > Software Packages.
13. In the Component Identifier area, enter the Name of a component in the service blueprint, or select a Tag that identifies the component.
    
    For example, select Components > All Components to place the software on all components.
    If a service blueprint includes multiple components, you must identify the particular instance. You can identify the particular instance by Name or by indicating a tag group or tag that is matched to a tag in the service blueprint.
14. Select one software package from the list (consisting of BMC Server Automation packages).
     To filter the list of software packages that are displayed, type a letter, word, or phrase in the Search field, and then click the search magnifying glass. The search operation is based on all the fields that comprise the software package names.
15. (optional) In the Install tab, for each software package, specify the pre-installation and post-installation type of action to run before or after the installation.
    1. Select the action type (an NSH script or BMC Atrium Orchestrator (AO) workflow that runs a particular action).
        For example, you can run an AO workflow that checks the hardware configuration on your VM or an NSH script that opens the Windows port.

    2. Enter the name of the NSH script or AO workflow.
        For example, enter open_port_windows.nsh to open the Windows port. You must ensure that the script or workflow is actually available on your system. The NSH scripts and AO workflow are defined in BMC Server Automation.
       For information about creating NSH scripts, see the Adding a Network Shell script and the Summarized descriptions of Network Shell commands topics in the BMC Server Automation online technical documentation.

       For information about creating BMC Atrium Orchestrator workflows, see the Workflow basics and the Workflow coding recommendations topics in the BMC Atrium Orchestrator online technical documentation.

16. (optional) Click the Operation tab.
    For each software package, define the start and stop operations to perform on the software packages.
    1. Select the action type (for example, Script).
    2. Enter the name of the NSH script or AO workflow (for example, "open_port_windows.nsh").
17. Click OK.
18. In the Option Choice Blueprint Configuration Editor, click OK to save the changes.
19. Click OK to close the Options Editor.

1. Open the Options Editor.
2. Click New Option .
3. Enter the Option Name and Option Description.
4. Select an option type.
    For example, select Any Request.
5. (optional) Upload or copy an icon.
6. Click OK.
7. Click New Option Choice .
8. Enter the option choice, description, customer price, and deployment cost.
    For example, typical custom action options might be Take snapshot or Format Disk.
9. Click OK.
10. Select the option choice (for example, Format Disk), and then click Option Choice Blueprint Configuration Editor .
     Here you select the appropriate option that modifies or extends the service blueprint configuration.
11. Click New Blueprint Configuration .
12. Click Blueprint Configuration, and select an option choice.
     For example, select Blueprint Configuration > Custom Action.
    
13. In the Resource Set Identifier area, enter the Name of a resource set in the service blueprint, or select a Tag that identifies the resource set.
     For example, select Resource Sets > All Servers to identify that you want this custom action to apply to all servers, not just your database servers or web servers.
     If a service blueprint includes multiple resource sets, you must identify the particular instance. You can identify the particular instance by Name or by indicating a tag group or tag that is matched to a tag in the service blueprint.
14. From the Action Type menu, select the action (an NSH script or AO workflow) that specifies what change to make.

15. In the Action field, enter the name of the NSH script or AO workflow.
     For example, enter format D 100 or lvm /data 100 (to format the virtual system disk into one 100 GB partition). You must ensure that the script or workflow is actually available on your system. They are defined in BMC Server Automation.
    For information about creating NSH scripts, see the Adding a Network Shell script and the Summarized descriptions of Network Shell commands topics in the BMC Server Automation online technical documentation.

    For information about creating BMC Atrium Orchestrator workflows, see the Workflow basics and the Workflow coding recommendations topics in the BMC Atrium Orchestrator online technical documentation.

    Note

    Do not use the Additional input field to enter parameters; the field has been deprecated is used for backward compatibility purposes only.

    To enter parameters, see To configure optional parameters.

16. Click OK.
17. In the Option Choice Blueprint Configuration Editor, click OK.

18. When you are finished in the Option Editor, click OK.

    Note

    You must click OK in the Options Editor to save your changes to the options and option choices.

For example, the cloud administrator can configure the Apache server package so that end-users can modify the HTTP port or webmaster email address when they provision the VM.

1. Open the Options Editor.
2. Click New Option .
3. Enter the Option Name and Option Description.
4. Select an option type.
    For example, select Request Definition.
5. (optional) Upload or copy an icon.
6. Click OK.
7. Click New Option Choice .
8. Enter the option choice, description, customer price, and deployment cost.
9. Click OK.
10. Select the option choice, and then click Option Choice Blueprint Configuration Editor .
     Here you select the appropriate option that modifies or extends the service blueprint configuration.
11. Click New Blueprint Configuration .
12. Choose one of the following options in the Option Choice Blueprint Configuration Editor:
    • Blueprint Configuration > Service Definition > Service Definition > Parameters

    • Blueprint Configuration > Service Deployment Definition > Service Deployment Definition > Parameters
      

      Note

      Service Definition parameters apply to all deployments for the service (for example, Small, Medium, and Large); Service Deployment Definition parameters apply only to one deployment (for example, Small but not Medium and Large).

13. Enter a unique parameter name.
    This field is required. You cannot edit this value later. If you made a mistake, delete the parameter and create a new one.

    Note

    If you enter a BLPackage or NSH script, the values must match the local properties of your BLPackage or the parameters of your NSH script.

14. Enter a "user friendly" display label.
     The end user sees this label when the package is provisioned instead of the parameter name. This field is required.
15. Enter a short description.
     This information appears as a tooltip.

16. Select the appropriate data type (for example, String, Numeric, Boolean, or Token).
     Depending on which data type you select, only specific options are displayed. For example, if you select Boolean, only the Default Value, User Entry, and Required options appear.
    You cannot modify data types later.

    Important

    Do not mismatch data types after you create a parameter in the service blueprint. If your parameter is a String datatype in the service blueprint, do not try to override it by changing to a different datatype (for example, Numeric) in the optional parameter.

17. In Default Value, enter the parameter value (for example, the default value if you storing user input).
     Make sure that you enter appropriate values per data type; there is no validation checking in the UI other than the Java Regular Expression pattern. However, the Numeric data type will not let you enter non-numeric values.
     If you select Boolean, you can only choose true or false as the default value.
18. In Regular Expression, enter the pattern text that the parameter must match for validation.
     For example, if you want the parameter value to consist only of alphabetical characters, enter [a-zA-Z]* as the String values.
    You can use Java Regular Expression with String or Numeric data types, but not Boolean.
19. Click Ignore Case to only compare character sequence.
     For example, you would select Ignore Case if ABC and abc are both considered valid matching patterns.
20. Click User Entry to prompt the user to enter the value when the application is being provisioned.
     This action allows the end-user to specify an input and, if needed, override the default value. It also activates the Required field.
21. Click Required if input is mandatory.
22. Click Password Field for password-style input (where the values are not displayed).
     The password values are initially displayed as you enter them. But after you save the parameters, they are then masked as asterisks.
    The Password Field is independent of the User Entry field — you can mask the default value even if User Entry is not selected.
23. Click OK.
24. In the Option Choice Blueprint Configuration Editor, click OK to save the changes.

25. Click OKto close the Options Editor.

    Note

    You must click OK in the Options Editor to save your changes to the options and option choices.

1. Open the Options Editor.
2. Click Upload Icon .
3. Navigate to the image that you want to use and then select Open.
    The image then appears in the Icon column.
   
4. Create or modify a service offering.
5. Click the Options tab.
6. Add the option (that includes the icon) to the Selected Options list.
7. Continue to create the requestable offering.
    When the requestable offering becomes available in the Service Catalog (in SRM), this icon will be displayed in the service request.