Versions Compared

Old Version 3

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Felicity Borrelli

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The External Reference profile allows profile allows you to use configuration values in Image Removed that use configuration values in Usage Engine that originate from property files or exported environment variables from the Platform's startup shell. 

title
Note

Required Properties

To use this property the mzonline.host and mzonline.port properties need to must be added! 

You can use the values provided by External Reference profiles in workflow and agent profile configurations. 

...

...

Note!

For instructions on how to define complex parameters such as lists of brokers, refer to Profiles(3.3).

To create a new External Reference Profile configuration, click the New Configuration button in the upper left part of the Image Removed Desktop Usage Engine Desktop window, and then select External  External Reference Profile Profile from the menu.

...

Setting

Description

External Reference Type

From the drop-down list select the External Reference source type.

The following types are available:

  • S3 Properties File - A file on an Amazon Web Service S3 bucket. For more information, refer to AWS S3 Support for External Reference Profile(3.3).

  • Properties File - A file on the Platform host.

  • Environment Variable -  Exported environment variables from the Platform's startup shell.

  • Properties Database - Use the internal database as an External Reference source. To store values in the internal database, use the

Image Removed

  • Usage Engine web interface and enter values for needed Database Keys.

  • Kubernetes Properties - Use Kubernetes ConfigMap as an External Reference source. For more information, refer to Creating External Reference in Helm Chart(3.3).

Properties File

This field is available when you have selected Properties File in External Reference Type.

Enter the path and the name of the properties file.

Use Custom ConfigMap Name 

This field is available when you have selected Kubernetes Properties in External Reference Type.

By default the ConfigMap name is constructed from the folder name and profile name.

Select this checkbox to set a custom name for the ConfigMap used to set values. 

Local Key

The name to use when referring to this external reference in the workflow table and profiles which allow the use of external references.

Properties File Key

This field is available when you have selected Properties File in External Reference Type.

The name of the External Reference in the properties file or environment variable.

Database Key

This field is available when you have selected Properties Database in External Reference Type.

The name of the External Reference in the Database.

Kubernetes Key

This field is available when you have selected Kubernetes Properties in External Reference Type.

The name of the External Reference in the Kubernetes ConfigMap.

Value Type

The following types are available:

  • String - The value is stored as string

  • List - The value consist of a list of values

  • Map - The value consist of a map of key/values pair

Value

The current value of the External Reference. To update the value from the Properties file, use the Refresh button. If values are not displayed, make sure that a properties file is available in the specified path or that the environment variables are set.

Notetitle

Note!

Environment variables that are set after

Platform

the platform start are not available in the External Reference profile.

For Properties Database and Kubernetes Properties External Reference types, then the values can be set in the profile itself

.The value can be set direct in the Add External Reference Definition dialog and edited by selecting the specific row and click edit button

.

Notetitletitle

Note!

If External Reference type is set to Kubernetes Profile and the use custom ConfigMap name is selected the values can not be set or updated in the profile itself. 

Note

Note!

The value will be saved to the database directly once you click

on the

Add or OK

buttons

on the External Reference Definition dialog.

Insert excerpt
Setting External Reference Values in DB (3.3)
Setting External Reference Values in DB (3.3)
nopaneltrue

...

Note!

In Kubernetes deployment it is possible to provision environment specific external reference values for Properties File based External Reference Profiles by defining them as configMaps as part of the

...

Usage Engine Helm value file. For example:

Code Block
platform:
	configMaps:
	- file: extrefs.txt
   	  data: |
  		parameter1=value1
  		parameter2=value2

YAML tab

A YAML tab is visible when you have selected Kubernetes Properties in External Reference Type and the profile is saved. It shows a YAML definition of the corresponding ConfigMap used to set values.

External Reference Applications

With External Reference Profile and External Reference Values, you can set different type of permissions for saving External Reference Profile keys and values. To know more about these applications, see Access Controller.

...

Note!

Applicable only if you select Properties Database or Kubernetes Properties from External Reference Type. 

For example, the following screenshot shows an access group with the name as 'Values' and different permission that you can assign to that access group for External Reference Values application.

Image Removed

...


The following permissions are available: 

  • Write -  In order to create a new External Reference profile you must have Write access to the External Reference Profile application, however to be able to edit or set Value, you must have Write access to the External Reference Values application. 

    Notetitle

Note!

If you try to set or edit Value of an External Reference Profile for which you do not have the write permission the values field in add or edit dialog is not visible. 

...

  • Execute -  You cannot make any changes to the External Reference Values permission if you have only Execute access. 

...

Note!

To be able to open an existing External Reference Profile, you must have the Read access for that particular External Reference Profile.

...

See Browser(3.0) for more details on the different permission groups pertaining to a configuration.