Versions Compared

Key

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

...

Info
titleExample - Pico configuration in STR


Code Block
languagetext
themeEclipse
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
languagetext
themeEclipse
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
languagetext
themeEclipse
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
languagetext
themeEclipse
<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
languagetext
themeEclipse
<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
titleExample - Pico Configuration Template


Code Block
languagetext
themeEclipse
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
languagetext
themeEclipse
{
	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
titleExample - Usage of Pico Configuration Template


Code Block
languagetext
themeEclipse
{
	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
languagetext
themeEclipse
$ 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.

...