This section describes how to update your environment variables. It covers how to:

  • Set variables.
  • Encrypt variables.
  • Override variables.
  • Delete variables.

Check-in Comment

checkInMessage is an optional attribute. It can be set to a non-empty string that contains the commit comment to use for the configuration changes. If it is not provided, then an empty commit comment is used.

attribute='value'

Description

 
checkInMessage='<commit_comment>'

Add a commit comment to the RLC.

Example

<!-- Set variables (with optional commit comment) -->
<variables checkInMessage='Change the database host and name.'>
    <set name="DatabaseHost" value="rhapsody-test"/>
    <set name="DatabaseName" value="rhapsody-QA"/>
</variables> 

<!-- Set encrypted variable -->
<variables>
    <set name="password" value="123456" encrypt="true"/>
</variables>

<!-- Set variable overrides -->
<variables>
    <set name="DatabaseHost" value="rhapsody-production" override="true"/>
    <set name="DatabaseName" value="rhapsody-dev" override="true"/>
</variables>

<!-- Remove override -->
<variables>
    <delete name="DatabaseHost" override="true"/>
</variables>

<!-- Delete variable -->
<variables>
    <delete name="DatabasePort"/>
</variables>

If a variable already exists on the engine, it can only be updated or deleted if the user has the 'Edit Locker' access right on all the lockers that use the variable. This prevents an update to a variable affecting lockers that the user does not have the right to modify.