Templates
You define inline templates in the templates section. The templates included in this section are identified by a unique template alias. In the templates section, you can include the following optional sections:
products
A list of IDs for the products that you want to install. You can list the product IDs using the
sagcc list repository products
content command or by selecting the
Show ID Column check box when viewing the contents of a product repository in the web user interface.
Example syntax:
products:
productID:
instanceName:
instanceParameter1: value
instanceParameter2: value
configuration:
runtimeComponentID:
CONFIG-TYPE:
CONFIG-TYPE-instance1:
config_setting1: value
config_setting2: value
You can also use a reference variable for instanceName:
${instance.name}:
Note that when a product does not support multiple instances the instance name is default:
You can specify migration settings for a product instance defined under
instanceName. See
Migration Settings for Product
Instances.
Based on the type of data that each configuration setting supports, you can specify the values in the configuration settings parameters in one of the following formats:
YAML
JSON
XML
multi-line plain text
variable
Following is an example with configuration settings in XML format:
products:
TES:
default:
configuration:
TES-default:
TC-CONFIG:
TC-CONFIG: |
<ns2:tc-config xmlns:ns2="http://www.terracotta.org/config">
<servers>
<mirror-group group-name="stripe1">
<server name="${tc.host}" host="${tc.host}" >
<data>../data</data>
<logs>../logs</logs>
<index>../index</index>
<tsa-port>${tc.tsa.port}</tsa-port>
<jmx-port>${tc.jmx.port}</jmx-port>
<tsa-group-port>${tc.grp.port}</tsa-group-port>
<management-port>${tc.mgt.port}</management-port>
<dataStorage size="${tc.storage.size}">
<offheap size="${tc.offheap.size}"/>
<hybrid/>
</dataStorage>
</server>
fixes
A list of IDs for the fixes that you want to install. You can list the fix IDs using the
sagcc list repository fixes content or by selecting the
Show Fix Name Column check box when viewing the contents of a fix repository in the web user interface. If you set
fixes: ALL, Command Central installs all fixes from the fix repository that are required for the products, which are available in the installation.
files
A map of files that Command Central will copy to the target installation. For example:
target/file1: “src/file”
where target is the path to the directory to which to copy the file and scr is the path to the source directory from which to get the file. The target path is always relative to the target installation directory and the source path is relative to the root folder of the composite template.
licenses
A map of license key aliases that Command Central uses to copy the license key file assigned to a specific license key alias to the target location. For example:
"target/licenseKey1": "${alias}"
where target is the path to the directory to which to copy the license key file and “alias” is the license key alias.
You refer to the license key file by an alias, which you can define in:
the Licensing view of the Command Central web user interface
an environment properties file
the CLI license-tools keys commands
Example
In the following example, Command Central executes the following actions when applying the inline template with alias "is-my"
1. Copies the "IntegrationServer/config/licenseKey.xml" license key file, which is assigned to the "is.license.key.alias" alias, to the "IntegrationServer/config/licenseKey.xml" target installation directory.
2. Installs Integration Server, Monitor, and Rules Engine, along with their dependent components.
3. Applies the “wMFix.integrationServer.Core” fix.
4. Creates an Integration Server instance with alias “myInstance”, using the port and database connection details specified in the integrationServer/myInstance section.
5. Configures the “myInstance” Integration Server instance with the security credentials, included in the integrationServer/myInstance/configuration property.
templates:
is-my:
licenses:
"IntegrationServer/config/licenseKey.xml": ${is.license.key.alias}
fixes:
- wMFix.integrationServer.Core
products:
integrationServer:
myInstance:
primary.port: 5555
diagnostic.port: 9999
jmx.port: 9064
db.type: ${db.type}
db.url: ${db.url}
db.username: ${db.username}
db.password: ${db.password}
license.file: IntegrationServer/config/licenseKey.xml
configuration:
integrationServer-${instance.name}:
COMMON-LOCAL-USERS:
COMMON-LOCAL-USERS-Administrator:
"@id": Administrator
Password: secret123
brmspackage:
Monitor: