Customizing OVF environment settings with cot edit-properties

Synopsis

cot edit-properties --help
cot <opts> edit-properties PACKAGE
                           [-p KEY1=VALUE1 [-p KEY2=VALUE2 ...]]
                           [-l LABEL1 [-l LABEL2 ...]]
                           [-d DESC1 [-d DESC2 ...]] [-c CONFIG_FILE]
                           [-u [USER_CONFIGURABLE]]
                           [-t TRANSPORT [TRANSPORT2 ...]]
                           [-o OUTPUT]
cot <opts> edit-properties PACKAGE [-u [USER_CONFIGURABLE]]
                           [-o OUTPUT]

Description

Configure environment properties of the given OVF or OVA. The user may specify keys and values as command-line arguments or may provide a config-file to read from. If neither --config-file, --properties, nor --transport are given, the program will run interactively.

Options

PACKAGE
OVF descriptor or OVA file to edit

General options

-h, --help Show this help message and exit
-o OUTPUT, --output OUTPUT
 Name/path of new OVF/OVA package to create instead of updating the existing OVF

Property setting options

-u <USER_CONFIGURABLE>, --user-configurable <USER_CONFIGURABLE>
 Update the 'userConfigurable' flag on all edited properties to True or the given value
-c CONFIG_FILE, --config-file CONFIG_FILE
 Read configuration CLI from this text file and generate generic properties for each line of CLI
-p <KEY1[=VALUE1][+TYPE1]...>, --properties <KEY1[=VALUE1][+TYPE1]...>
 Update or create the given property keys. A '=' delimits the optional value to set this key to. A '+' delimits the optional type to enforce for this key. This argument may be repeated as needed to specify multiple properties to edit.
-l <LABEL1...>, --labels <LABEL1...>
 Set the label(s) for the property(s) being edited. If this option is specified, the number of properties and the number of labels must be equal.
-d <DESC1...>, --descriptions <DESC1...>
 Set the description(s) for the property(s) being edited. If this option is specified, the number of properties and the number of descriptions must be equal.
-t <TRANSPORT...>, --transports <TRANSPORT...>
 Set the transport method(s) for properties. Known values are 'iso', 'vmware', and 'ibm', or an arbitrary URI may be specified.

Examples

Add configuration from a text file and mark the resulting properties as non-user-configurable.

cot edit-properties input.ovf -c config.txt -u=0

Add/update two properties, one a string with no default value and the other a boolean defaulting to true, and mark both properties as user-configurable.

cot edit-properties input.ovf -p string-property+string \
    -p bool-property=true+boolean --user-configurable

Update the label and description of two existing properties

cot edit-properties input.ovf -p hostname -l "Hostname" \
    -d "Hostname of this device" -p enable-ssh -l "Enable \
    remote SSH access" -d "Enable sshd and disable telnetd"