config

The config command is used to manage configurations on Makito X Series devices. This includes saving the current configuration, loading a saved configuration, and specifying the configuration file to load at startup. The config command also includes a Preset autosave setting.

Note

This is equivalent to saving and loading Presets in the Web interface.

Synopsis

config save [cfgname startup=yes,no [overwrite=yes]]
config load [cfgname startup=yes,no] 
config delete [cfgname, all]
config duplicate cfgname
config rename oldname newname [-f, --force]
config set [autosave=on,off]
config list

Actions

Action	Description
`save`	Saves the current configuration. Saves every parameter in the system, including encoder settings and stream destination and status (excluding the system IP address). All configuration files are stored in `/usr/share/haivision/config`. See `cfgname` parameter below for naming conventions. When saving a named configuration, using the overwrite option prevents a prompt for confirmation when a configuration with the same name already exists. Note Using `config save` with no other parameters will store the current settings to the last loaded and currently active configuration. If the system was started without a startup configuration and no configuration was ever loaded, a new startup configuration named haistartup.cfg will be created.
`load`	Loads a previously saved configuration identified by `<cfgname>`. Reassigns every parameter in the system, including encoder settings and stream destination and status (excluding the system IP address). Note Using `config load` with no other parameters will load the current startup configuration. The startup option on `config load` is only available when autosave is disabled, since loading a configuration with autosave enabled will always set that loaded configuration as the startup configuration.
`duplicate`	Duplicates a saved configuration identified by `<cfgname>`.
`rename`	Renames a saved configuration identified by `<oldname>` to `<newname>`. See `cfgname` parameter below for naming conventions.
`delete`	Deletes a previously saved configuration identified by `<cfgname>`. If no filename is specified, the system deletes the default startup configuration `(haistartupcfg.ini)`.
`set`	Configures the `autosave` setting.
`list`	Configuration files are stored under `/usr/share/haivision/config`. You can use `config list` to display available config files
`help`	Displays usage information for the `config` command.

Parameters

Parameter	Default	Description/Values
`cfgname`	n/a	Name of the configuration to load or save. Note The following special characters are not supported for use in the configuration name (`cfgname`) unless they are escaped using the backward slash (\) character before being used: Single Quote ` Ampersand & Parentheses ( or ) Semicolon ; Apostrophe ’ Double Quote ” Left and Right Angle Brackets < or >
`overwrite`	no	When saving a named configuration, the `overwrite` option can be used to prevent a prompt for confirmation when a configuration with the same name already exists. `yes,no`
`startup`	no	Sets saved configuration as the startup configuration. `yes,no`
`autosave`	on	When enabled, `autosave` automatically saves any applied changes to the encoder and stream settings in the startup configuration. This feature is designed to help users who have not saved their configurations into Presets and want to prevent loss of configuration settings when signing out or rebooting, or when the power is disconnected on their units. A warning indication already appears in the Web Interface title bar on systems with unsaved configuration changes. Preset `autosave` is enabled by default on new units and after a factory reset, but disabled when upgrading from an older version of firmware that did not support this feature (in order to avoid confusing users accustomed to the old preset workflow). The current state is displayed at the end of the `config list` output.

Examples

# config save Class430 startup=yes

Saves the current configuration under the name "Class430" and sets it to be the startup configuration.

# config load Class430

Loads a previously saved configuration identified by the name "Class430" (located in the active (local) directory).

# config set autosave=on

Enables auto-save and returns the following confirmation message.

Auto-save of configuration changes enabled successfully.

# config list

Returns the available configuration files, as well as the auto-save state.

Config Files (in /usr/share/haivision/config/):
4xSRT_MX4E.cfg
4xSRT_MX4E_2xHUB.cfg (startup)
4xUDP_MX4E.cfg
Backup-20210706.cfg
Default.cfg

5 config files are available.
Auto-save of configuration changes is disabled.

Related Topics

Saving and Loading Presets