Description

Configuration templating system built into HCL Launch. Configuration Templates are text files held within HCL Launch that have placeholders for variable configuration. This plugin writes out these configuration files at deployment time substituting in environment or target specific properties. This plugin also reads in properties from a file.

Quick Info

Product
HCL Launch
Type
plugin
Compatibility
HCL Launch version 7.0 or later
Created by
HCL Software
Website
Version Name Action

13.1106796

launch-configmanagement-13.1106796.zip

13.1102023

launch-uconfigmanagement-13.1102023.zip

launch-configmanagement-13.1106796.zip

13.1106796


launch-uconfigmanagement-13.1102023.zip

13.1102023


Summary

This plugin includes steps that install configuration templates and import properties.

Compatibility

This plugin requires HCL Launch version 7.0 or later.

This plugin runs on all operating systems that are supported by the HCL Launch agent, including z/OS with UNIX System Services.

This plugin includes one or more steps, click Steps for step details and properties.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
13 Minor enhancements

Steps

The following process steps are available in the HCL Launch Configuration Management plugin.

Batch Import Properties

Import Component Environment Properties from a properties file.

Input properties for the Batch Import Properties step
Name Type Description Required
Delete Extra Properties Boolean Remove all properties not present in the properties file. No
Excludes String Property files or directories containing property files to exclude. No
Includes String Property files or directories containing property files to include. Yes

Import Properties

Import Component Environment Properties from a properties file.

Input properties for the Import Properties step
Name Type Description Required
Component Name String The component to import properties to. Yes
Delete Extra Properties Boolean Remove all properties not present in the properties file. No
Properties File String The properties file to import. Yes
Template File String The property file to output property resolution values to. Yes

Import Resource Properties

Import Resource Properties from a properties file.

Input properties for the Import Resource Properties step
Name Type Description Required
Properties File String The properties file to import. This file must be in EBCDIC format for z/OS systems. Yes
Resource Name String The path/id of the resource to import properties to. Yes

Install Template

Install a configuration template from HCL Launch.

Input properties for the Install Template step
Name Type Description Required
Environment Property List String Yes
File Name String The name of the template file to download. No
Repository URL String The base URL of the VFS server. Yes
Request Id String The request Id to lookup the correct template to download. Yes

Troubleshooting

When using the Batch Import Properties step, you must include the component name in the properties file as shown in the following example code:

ComponentName=Component A
name=myName
state=myState

If you do not include the component name in the properties file, the following error message is displayed:

Error Updating Properties!
java.io.IOException: 404 Not Found
No component for null