Using Parameters

About Parameters and Macros

Parameters (also referred to as macros) are global or tier/step-specific system- or user-defined variables for which values can be provided at deployment time. These parameters can be used as tokens or macros inside the application's configuration file or configuration scripts. At deployment time, the macros are replaced by the actual values specified in the parameter.

The CloudCenter platform allows you to define your own parameters or use the CloudCenter-supported parameters.

Defining Parameters

When adding a new service, you can use global parameters, tier/step-specific system parameters, or user-defined parameters and add values at deployment time.

  • Service Parameters: These parameters are specific to a newly-added/modified service. The parameter is called when a user calls this service. See Define a Custom Service and Service Administration for additional context.

  • Global Parameters: These parameters apply to all tiers and steps within this application as displayed in the following screenshot.

  • Deployment (Custom) Parameters: These parameters are specified for each step or tier within an application as displayed in the following screenshot. See Application Tier Properties for additional context.

Parameter Type

Regardless of the parameter being defined at the service level, the global application level, or at a tier level, you can specify the Type for each parameter, as shown in the following screenshot.

The Type dropdown enables you to determine your own value for a custom field:

 by selecting one of the following options from the Type dropdown list.


Provide an alpha-numeric value (limited to 255 characters).

API Enumeration = string (valueConstraint)


Provide a range of numbers (limited to 255 characters).

API Enumeration = number


Provide a list of comma separated text values (limited to 255 characters).

API Enumeration = list (valueList)


WebService is a parameter type introduced in CloudCenter 4.4.

You can provide list of dynamic webservice parameters while deploying a job. From this list, users can select one parameter. The webservice parameter type is available in custom parameters, global parameters, and services. The output should be in the following format:

[{"name":"p1","displayName":"Param 1"},{"name":"p2","displayName":"Param 2"}]

If you configure this parameter type, you must provide the Protocol (HTTP or HTTPS), Web Service URL, and the credentials (Username and Password) for this webservice.

To use this parameter type, you must set the Content-Type to be returned by webservice as application/html.

API Enumeration = webservice (webserviceListParams)

password with confirmation

Provide an alpha-numeric value (limited to 255 characters).

The UI provides a confirmation textbox.

API Enumeration = password_input (valueConstraint )


Enter text with no constraints – for example, use this field for a password that just needs to be entered without validation or confirmation.

The UI does not provide a confirmation textbox.

API Enumeration = password


A URL for the download location at the time of orchestration.

Options for pathDescription

Different repositories supported by CloudCenter.

See Shared Artifact Repositories > CloudCenter Repository Types for a list of options.

Format: %REPO_ID_{id}%xyz.war

Example: %REPO_ID_2%xyz.war where 2 is the ID of the repository in CloudCenter

File in Package

Path of the ZIP file defined in the application package of the application profile parent tier.



Path for the mounted storage location.

Linux VM Example: /shared

URLURLs of type HTTP, HTTPS, and FTP

API Enumeration = path (text that encodes a URL)


You can add any free form text in this area – for example, use this field for to define a parameter with values as file contents, or to define a private key, or to define a script, and so forth.

API Enumeration = textarea (text of any length (long))

secretkeyThis type is useful when configuring a Container Service. When you select this parameter, you can configure another layer of abstraction when specifying the Key Name (group-level coordinate) and the Key (the location) to retrieve the actual value of the secretkey for the deployment parameter that uses this type. The secret value is not visible to users nor is it maintained by the CloudCenter platform – the CloudCenter platform retrieves the secret from the specified location and uses that secret as configured.

Default Value Usage

The cliqrIgnoreAppFailure parameter does not terminate nodes during a failure and continues to keep all failed application deployment nodes running. If you configure this parameter, then you can enter true or false in the Default Value field to ensure that a VM is or is not terminated if an error is encountered at start up. See Troubleshooting Parameters for additional context.

Deployment-Specific Parameters

The CloudCenter platform includes an improvement to allow service parameters to be displayed to end users when they complete a Deployment form. Users are prompted to confirm if a parameter is a deployment parameter. Based on the Permission Control settings for this service a user can also be assigned permissions to change the parameter value at deployment time.

Granular Control for User-Defined Parameters

The User Options that the following table describes provide granular control over a user-defined parameters:

User OptionCheckedUnchecked
Should this parameter be visible to the user?This parameter is visible to users in the Topology Properties sections.This parameter is not visible to users. This allows admins to configure hidden parameters for licensing or tracking purposes (for example, to track how many users are using this service).
Should this parameter be editable by the user?Users can override this parameter in the Topology Properties settings.This service becomes automatically invisible to the user, and therefore not editable.
Should this parameter be optional?

Marked optional – The Cloud Center platform accepts the provided default values, if any (default = None), and the user must select a value to change the default.

Marked required – If a default value is not provided, then the user must select one of the values returned by the web service.

Supported Parameters

Back to: Parameters and Macros

  • No labels
Terms & Conditions Privacy Statement Cookies Trademarks