Application Services passes defined properties as environment variables to scripts running in a virtual machine. The service version properties define the variables used in the scripts for the service.

Prerequisites

  • Log in to Application Services as an application cloud administrator and an application publisher and deployer.

  • Familiarize yourself with the basic concepts of defining and configuring component properties and actions. See Developing Application Services Components.

  • To view examples about how to define a service, select Library > Services to view the predefined services.

  • Verify that a service version is available in Application Services. See Create a Service Version in the Library.

Procedure

  1. Open an existing service version and click Edit.
  2. For the Property Name and Description, define a variable and add an optional description.

    The property name cannot begin with a digit.

    After a variable is added and defined, you can create an install, configure, start, update, rollback, or teardown script for the service version.

  3. To change the type, select a property type from the drop-down menu.

    You cannot add types to the menu.

  4. Enter the value to substitute for this property when the script runs.

    For example, for a property called http_port, you might type 80 in this field.

    Note:

    For vCloud Director or vRealize Automation, if you add a value to the http_proxy, https_proxy, or ftp_proxy property with service scripts that use the darwin_global.conf file as a file source, when the script runs, these properties override any existing proxy information in the deployed application. Amazon EC2 does not require a proxy to deploy an application.

    If the property type is set to Computed, you cannot type a value.

    If the Required check box is selected and the Overridable in Blueprint check box is not selected, the property must have a value.

  5. From the Auto-Bind Type drop-down menu, select an Auto-Bind type.

    The Auto-Bind Type describes the role that a property is assigned to for autobinding in the blueprint canvas.

    Option

    Description

    None

    The property does not Auto-Bind.

    Consume

    The property value is set with autobinding.

    Expose

    The property can be used to customize another property value with autobinding.

    Note:

    A property cannot have the Consume and Expose roles.

    An Auto-Bind type of Consume or Expose requires at least one Auto-Bind tag to be defined for the property. Auto-Bind tags on the Consume property must be a subset of the tags on the Expose property. The tag sets do not have to be equal.

  6. Define the property type.

    The property type you define affects the Auto-Bind type you can set. The following combination of property type and Auto-Bind types are not allowed.

    Property Type

    Cannot Set Auto-Bind Type to

    Array

    Expose

    Computed

    Consume

    Content

    Expose or Consume

    Single Select

    Expose or Consume

  7. From the Auto-Bind Tags drop-down menu, click New to select an Auto-Bind type to add the Property Descriptor tags to a property.
    Note:

    Tags designated only as Property Descriptor appear in the drop-down menu.

    You can add multiple Auto-Bind tags.

    For example, if the Auto-Bind type for the Apache 2.2.0 service appsrv_routes property is assigned as Consume, and the Auto-Bind type for the vFabric tc Server 2.1.0 service JVM_ROUTE property is assigned as Expose. The appsrv_routes property uses the JVM_ROUTE property values to customize itself. To allow Auto-Bind to connect to these service properties, you can add the Servlet Container and Route tags to the appsrv_routes and JVM_ROUTE properties, respectively. When you create an application that includes the vFabric tc Server and Apache services, the properties Auto-Bind to each other in the blueprint editor if there is a dependency between the two nodes.

  8. Select the Required check box for properties that are required to deploy an application.

    If any of the required property values are left blank, you are prompted to complete them before an application deployment.

    If the property type is Computed, the Required check box is not applicable. If the property type is Content, the Required check box is selected by default and the Secured check box is not applicable.

    For example, for an http_proxy_port property using the Apache JServ Protocol (AJP), you must set the value to 8009.

  9. Select the Secured check box for passwords you define or to obscure the values of other properties.

    If a property is changed from Secured to Unsecured, Application Services resets the property value, for security purposes. You must set a new password value for the property.

    For example, the db_password property in the sample MySQL service is secured.

  10. Select the Overridable in Blueprint check box to allow users such as an application architect to override the value for the property in an application blueprint.

    If the property type is Computed, the Overridable in Blueprint check box is not applicable.

    If a property is not overridable in the blueprint, you cannot set the Auto-Bind type to Consume.

    For example, the application catalog administrator might configure the vFabric tc Server service to have a JVM heap size of 512MB. But for large deployments, the application architect might change the setting to 1024MB.

  11. Click Delete to remove the selected row from the Properties section.
  12. (Optional) : Click Reset to revert to the original property value.
  13. Click Upload to import the property values to a selected CSV file.
  14. Save your service property definitions.

What to do next

Create action scripts for the service version. See Add Action Scripts to the Service Version.