Medias Mediatrix 1204, Reference Manual

Page: 182 / 390

Chapter 12 - Configuration File Download Configuration File Download Server
156 Mediatrix 1204
The file name is case sensitive hence it must be entered properly.
This file should be used to update a large number of units with the same configuration.
If you leave the variable empty, the Mediatrix 1204 does not download the generic configuration file.
3. Set the configFileFetchingSpecificFileName variable with the name of the specific configuration file
to download.
The file name is case sensitive hence it must be entered properly.
This file should be used to update the configuration of a single unit.
This variable may contain macros that are substituted by actual values when downloading the
configuration file. Supported macros are:
• %mac%: the MAC address of the unit
• %product%: the product name of the unit
• %%: the character “%”
For instance:
• The “%mac%.xml” value for a Mediatrix 1204 with MAC address “0090F12345AB” will
be “0090F12345AB.xml”.
• The value “Hello%%Hi” will result in “Hello%Hi”.
• The value “%%%mac%%%mac%.xml” will result in “%0090F12345AB%mac%.xml”.
From left to right: the first macro encountered is first substituted, the second macro
encountered is then substituted, etc.
When the character “%” is not part of a macro, it is not replaced. The following are examples:
• The value “%mac.xml” stays “%mac.xml”
• The value “Hello%Hi” stays “Hello%Hi”
• The value “%moc%.xml” stays “%moc%.xml”
If the variable is empty (after macro substitution), the Mediatrix 1204 does not download the specific
configuration file.
Configuration Update Status
If valid configuration files are successfully downloaded, then the Mediatrix 1204 automatically restarts to apply
all the new settings. If the Mediatrix 1204 does not restart, this could mean the download failed or that the
configuration in the file is the same as the configuration in the unit.
You can validate the status of the configuration update in various ways.
MIB Variable
You can query the status of the last configuration file download in the sysAdminDownloadConfigFileStatus
variable:
idle: No configuration file download has been performed yet.
fail: The last configuration file download failed.
success: The last configuration file download succeeded.
inProgress: A configuration file download is in progress.
listening: The unit is listening and waiting for a configuration file to be sent by the management
server.
Caution:
The specific configuration file must be in XML format, no matter what its file extension.