Creating Pico Configurations

Create new pico configurations by manually creating a new configuration file in the container (<pico name>.conf) or use the mzsh topo set command.

Run the following commands to create a new pico configuration.

$ mzsh topo set topo://container:<container>/pico:<pico> <conf>

The <config> argument may contain a key-value pair that specifies a template or a pico configuration in HOCON format.

$ mzsh topo set topo://container:main1/pico:ec2 template:mz.standard-ec

When the target container is in the local MZ_HOME, you can add the local flag and omit the container name.

$ mzsh topo set --local pico:ec2 template:mz.standard-ec

When you specify a pico configuration with multiple attributes, it is recommended that you use multi-line strings. 

$ mzsh topo set --local pico:ec2 '{
    template:mz.standard-ec
    config {
        properties {
            ec.httpd.port : 9092
        }
        classpath {
            jars=["lib/picostart.jar"]
        }
    }
}'

mzsh topo set --local pico:ec2 '{
    type:ec
    config {
        properties {
            ec.httpd.port : 9092
        }
        classpath {
            jars=["lib/picostart.jar"]
        }
    }
}'

When you want to set the value of a property so that it is shared by all pico instances in a container, you can set it on the container level instead. Similarly, if the value should be shared by all pico instances in all containers, your can set properties on the cell level. 

$ mzsh topo set topo://container:<container>/val:common.pico.tmpdir '${mz.home}/"tmp"'

$ mzsh topo set topo://cell:default/val:common.pico.rcp.platform.host examplehost

For further information about how to set properties on container- and cell level, see Updating Pico Configurations.