Media5 Mediatrix 4104, Reference Manual

Page: 215 / 466

Configuration File Download Server Reference Manual (SIP Version)
Mediatrix 4104 193
Configuration Download via HTTP/HTTPS
The following steps explain how to download the configuration files by using the HTTP or HTTPS protocol. If
you are using HTTPS, the Mediatrix 4104 must contain the proper certificate. See
“Configuring the HTTPS
Server” on page 186 for more details.

To download the configuration files via HTTP or HTTPS:
1. Set the configuration file server host and port as defined in “Configuration File Server Settings” on
page 187 .
2. Place the configuration files to download on the computer hosting the HTTP or HTTPS server.
These files must be in a directory under the root path.
3. If not already done, set the configuration file path as described in “Setting up the Configuration File
Download” on page 188 .
4. In the configFileFetchingMIB, set the configFileTransferProtocol variable to http or https .
Your HTTP or HTTPS server may activate some caching mechanism for the file download. This
mechanism caches the initial file download for later processing, thus preventing changes or update
of the original file by the user. This can cause strange problems if a user wants to edit a
configuration file to modify values and upload it immediately. The result will still return the original
file and not the new one.
5. If your HTTP or HTTPS server requires authentication when downloading the configuration file, set
the following:
• The user name in the configFileTransferUsername variable.
• The password in the configFileTransferPassword variable.
6. In the groupAdminMIB , set the groupSetAdmin variable to ForceLock .
All activities in progress on the Mediatrix 4104 are terminated immediately and the unit enters the
maintenance mode (the value of the
groupAdminState variable is “locked”). The configuration file
download may take place.
7. In the sysAdminMIB , initiate the configuration file download via HTTP or HTTPS by setting the
sysConfigCommand variable to updateConfiguration .
The Mediatrix 4104 immediately downloads the configuration files. It is the initiator of the HTTP/
HTTPS sessions.
User Agent Header of HTTP Requests
The User-Agent header field of an HTTP request contains information about the user agent client originating
the request. For instance, the information of the User-Agent header could be something like the following:
User-Agent: Softphone Beta1.5
You can customize the information that the Mediatrix 4104 sends when establishing a communication.

To customize the HTTP User Agent header of HTTP requests:
1. In the interopMIB , set the mxInteropHttpUAHeaderConfig variable with the proper macro.
The following macros are replaced by their representation:
• %version% : Version of the application.
• %mac% : Unit MAC address (lowercase).
• %rev% : Hardware revision number.
• %product% : Product name.
Caution:
When downloading via HTTP or HTTPS, the configuration file server’s port must be 80. You can
query the actual port assigned in the configFileFetchingPort read-only variable (in the ipAddressStatus
folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See
“Configuration File Server Settings” on page 187 for more details.