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]
config delete [cfgname, all]
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 the note below in cfgname description.

Using config save with no other parameters stores the current settings as the startup configuration using a default name of haistartup.cfg.

When saving a named configuration, using the overwrite option prevents a prompt for confirmation when a configuration with the same name already exists.

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).

delete

Deletes a previously saved configuration identified by <cfgname>. If no filename is specified, the system deletes the default configuration (haistartupcfg.ini).

set

Configures the autosave setting.

list

Displays a list of the available configuration 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.