...
Info |
---|
title | Example - Pico configuration in STR |
---|
|
Code Block |
---|
| config {
properties {
ec {
httpd {
port=9090
}
}
}
}
template="mz.standard-ec"
|
HOCON also supports a "flat" format that you can use with properties, a type of attribute that you can set to control the behavior of pico instances in the STR : Code Block |
---|
| config {
properties {
ec.httpd.port=9090
}
}
template="mz.standard-ec"
|
|
client.conf
The file client.conf
contains custom default values for Desktop properties and JVM arguments. These values are set for all connected Desktop instances. You may override the default properties in the Desktop launcher.
Code Block |
---|
config {
jvmargs {
. . .
}
properties {
. . .
}
} |
default.conf
The file default.conf contains the installed default values for Desktop properties and JVM arguments. Though it is possible to edit this file, it is recommended that you add set custom default in in client.conf
, since the contents may be overwritten by at by Image Added at any time.
Code Block |
---|
config {
jvmargs {
. . .
}
properties {
. . .
}
} |
cell.conf
The file cell.conf
contains properties that are common to the Platform , EC/ECSAs and SCsECs.
Code Block |
---|
|
common {
config {
name=common
}
#properties
}
|
custom.conf
The file custom.conf
contains user defined service definitions.These definitions consist of a set of attributes that are required to run the services on one or more Service Contexts. Attributes that you set in custom.conf
overrides attributes in standard.conf
.
Code Block |
---|
|
<service> {
config {
#properties...
}
start-after=[service1,...,service
n]
template="1/standard/basic"
} |
standard.conf
The file standard.conf
contains predefined service definitions that are required by the system. You can override the properties in this file by updating custom.conf
.
Code Block |
---|
|
<service> {
config {
#properties...
}
start-after=[service1,...,service n]
template="1/standard/basic"
} |
templates/<template name space>/picos/<template name>.conf
The files in the templates
directory contains pico configuration templates. The subfolder mz
contains preconfigured templates that should not be edited:
standard-ec
standard-ecsa
standard-sc
standard-platform
standard
(base template for all pico types)
...
Though it is possible to edit these files, it is recommended that you add custom templates in separate files and subdirectories, since the contents in mz
may be overwritten by at by Image Added at any time.
Info |
---|
title | Example - Pico Configuration Template |
---|
|
Code Block |
---|
| config {
properties {
ec {
backlog {
dir=${mz.home}"/tmp"
}
httpd {
password="DR_DEFAULT_KEY-1D2E6A059AF8120841E62C87CFDB3FF4"
port=9090
user=mzadmin
}
shutdown {
time=60000
}
}
pico {
bootstrapclass="com.digitalroute.wf.pico.ECSAHTTPDECHTTPD"
type=ec
}
}
}
template="mz.standard"
template-only=true
type=ec |
|
<pico name>.conf
Each pico configuration is stored in a separate file with the suffix .conf
, e g platform.conf
or ec1.conf
. The configuration includes template references, classpaths, JVM arguments, and properties. When you change these attributes in a configuration, the corresponding pico instance must be restarted. Properties that are set in <pico name>.conf
override properties in container.conf
and cell.conf
.
A configuration may also include "settings" attributes. Unlike e g properties, this type of attribute may contain array values and changes do not require restart of pico instances.
File contents:
Excerpt |
---|
Code Block |
---|
| {
template=<template name space>.<template file name>
settings {
pico-groups=[]
state=enabled
tags=[]
}
config {
classpath {
#classpaths...
}
jvmargs {
#jvmargs...
}
properties {
#properties...
}
}
} |
|
You can set the attributes of the pico process directly and/or inherit the attributes of a template. Attributes that are set directly will override those that are inherited from a template.
...
Info |
---|
title | Example - Usage of Pico Configuration Template |
---|
|
Code Block |
---|
| {
template="example-ec"
settings {
pico-groups=[group1]
state=enabled
tags=[tag1,tag2]
}
config {
properties {
ec.httpd.port: 9090
}
}
} |
|
container.conf
The file container.conf
holds system properties and attributes that describe the container. Properties that are set in container.conf
overrides properties in cell.conf
.
...
Code Block |
---|
|
$ mzsh topo register -u --address <IP address or hostname> |
If you want to prevent EC/ECSAs or SCs ECs from starting in a container, set the attribute disabled
to true. The default value is false.
...