Skip to main content

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

ActionDescription

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

ParameterDefaultDescription/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 >
overwritenoWhen 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

autosaveon

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.