Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated @ 2022-11-10T12:48:53.323588
HTML
headtrue
encodingUTF-8
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2022"><meta name="DC.rights.owner" content="(C) Copyright 2022"><meta name="DC.type" content="concept"><meta name="description" content="Importing and exporting configuration scripts allows you to modify in whole or in part the configuration script used on your unit."><meta name="prodname" content="For All Mediatrix Units"><meta name="version" content="DGW 4849.50.27182809"><meta name="platform" content="All"><meta name="DC.date.modified" content="2022-0511-0410"><meta name="DC.date.issued" content="2022-0511-0410"><meta name="DC.date.available" content="2022-0511-0410"><meta name="ChapterNumbering" content="no"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="concept_ctk_fbh_yr"><link href="https://fonts.googleapis.com/css?family=Open+Sans" rel="stylesheet"><link rel="stylesheet" type="text/css" href="https://documentation.media5corp.com/download/attachments/62825785/commonltr.css"><link rel="stylesheet" type="text/css" href="https://documentation.media5corp.com/download/attachments/62825785/custom.css"><title>Configuration Scripts Import and Export</title></head><body><header role="banner"><div class="topicmeta title">Configuration Scripts Import and Export</div><div class="topicmeta date">2022-0511-04<10</div><div class="topicmeta product"> For All Mediatrix Units</div><div class="topicmeta version">DGW 4849.50.2718<2809</div><div class="topicmeta pdf"><a href="https://documentation.media5corp.com/download/attachments/62825785/Configuration%20Scripts%20Import%20and%20Export.pdf" rel="nofollow">Download PDF Document</a></div><hr><span style="float: inline-end;"></span></header><nav role="toc"><ul><li><a href="#concept_ctk_fbh_yr">Configuration Scripts Import and Export</a></li><li><a href="#concept_v5m_n3h_wq">Simple Network Time Protocol (SNTP)</a></li><li><a href="#concept_zk3_lr5_yr">DHCPv4 Auto-Provisioning</a></li><li><a href="#reference_dsd_hs4_yr">Unit Macros</a></li><li><a href="#topic_title_Basic_File_Server_Tasks_d1e19">Basic File Server Tasks</a><ul><li><a href="#task_syk_fkb_wr">Configuring the FTP Server </a></li><li><a href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li><li><a href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li><li><a href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li><li><a href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a></li></ul></li><li><a href="#topic_title_Basic_Export_Tasks_d1e25">Basic Export Tasks</a><ul><li><a href="#task_u1j_3f1_yr">Exporting a Configuration Script Using a File Server</a></li><li><a href="#task_vr5_g41_yr">Exporting a Configuration Script to Your PC </a></li></ul></li><li><a href="#topic_title_Basic_Import_Tasks_d1e28">Basic Import Tasks</a><ul><li><a href="#task_z5d_4sy_xr">Importing a Configuration Script Using a File Server</a></li><li><a href="#task_uk2_1j1_yr">Executing a Configuration Script from the Unit File Management System</a></li><li><a href="#task_gll_zk1_yr">Executing Inline Scripts</a></li><li><a href="#unique_116328731259684150">Importing a Configuration Script from Your PC </a></li><li><a href="#task_w4f_tv5_1s">Importing a Configuration Script to the Unit File Management System</a></li></ul></li><li><a href="#topic_title_Basic_Automation_Tasks_d1e34">Basic Automation Tasks</a><ul><li><a href="#task_cwv_slh_yr">Executing Configuration Scripts from a File Server Periodically</a></li><li><a href="#task_rht_dht_1s">Executing Configuration Scripts from the Unit File Management System Periodically</a></li><li><a href="#task_azs_hhp_yr">Executing Configuration Scripts from a File Server Each Time the Unit is Started </a></li><li><a href="#task_mgx_dlt_1s">Executing Configuration Scripts from the Unit File Management System Each Time the Unit is Started</a></li><li><a href="#task_aqz_l45_yr">Configuring the DHCP to Trigger Configuration Script Execution</a></li></ul></li><li><a href="#reference_dky_yjz_xr">Advanced Configuration Scripts Parameters</a></li><li><a href="#reference_j4g_nbv_gfb">Online Help</a></li><li><a href="#concept_v4k_q3h_1r">DGW Documentation</a></li><li><a href="#concept_fqm_rv4_k4">Copyright Notice</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1"><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="nested0" aria-labelledby="ariaid-title1" id="concept_ctk_fbh_yr">
 <h1 class="title topictitle1" id="ariaid-title1">Configuration Scripts Import and Export</h1>
 
 <div class="body conbody"><p class="shortdesc">Importing and exporting configuration scripts allows you to modify in whole or in part
  the configuration script used on your unit.</p>
  <p class="p">Configuration scripts are files containing textual commands that are sent over the network to a
   Mediatrix unit. Upon receiving the file, the unit executes each command line in sequence. Script
   commands can assign values to configuration variables, or execute configuration commands. </p>
  <p class="p">A configuration script can be used on any firmware version, regardless of the firmware version
   it was exported from. It is possible to import a complete configuration script, a subset of the
   configuration script or even a few lines of a configuration script. </p>
  <div class="p">Importing a configuration script can be useful to:<ul class="ul" id="concept_ctk_fbh_yr__ul_fg3_qdh_yr">
    <li class="li">Change one or several script commands </li>
    <li class="li">Add new commands</li>
    <li class="li">Change parameter values </li>
    <li class="li">Add parameters</li>
    <li class="li">Replace the complete configuration script </li>
   </ul></div>
  <p class="p">Scripts are written by the system administrator and can be used to accomplish various tasks,
   such as automating recurrent configuration tasks or batch-applying configuration settings to
   multiple devices. Scripts can be executed once or periodically at a specified interval. They can
   also be scheduled to be executed when the Mediatrix unit starts.</p>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title2" id="concept_v5m_n3h_wq">
 <h1 class="title topictitle1" id="ariaid-title2">Simple Network Time Protocol (SNTP)</h1>
 
 <div class="body conbody"><p class="shortdesc"> The Simple Network Time Protocol (SNTP) is used to update and synchronise the clock of
  the Mediatrix unit (day, month, time) when it is restarted. </p>
  <p class="p">Mediatrix units do not all include a real time clock allowing them to maintain accurate time
   when they are shutdown. Your system needs to have access to accurate time, for example if you are
   using HTTPS or for the caller ID feature. The Mediatrix unit implements a SNTP client, which can
   synchronise the local clock with remote NTP/SNTP servers. The configuration can be automatic
   (through DHCP for example), with fallback, or static, with up to four servers.</p>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title3" id="concept_zk3_lr5_yr">
 <h1 class="title topictitle1" id="ariaid-title3">DHCPv4 Auto-Provisioning</h1>
 
 <div class="body conbody"><p class="shortdesc">The Mediatrix unit can be configured to automatically download new configuration scripts
  upon receiving options 66 (tftp-server) or 67 (bootfile), or vendor-specific option 43 using
  sub-options 66 and 67 in a DHCPv4 answer</p>
  <p class="p"> A DHCP server answer includes both Bound and Renew. The contents of option 66, 67 or 43
   defines which script to download. The unit's configuration is not used to download the script.
   This allows the unit, for instance, to download a script from a server after a factory reset and
   to reconfigure itself without a specific profile. If the imported configuration script is
   identical to the last executed script, it will not be run again. The script retry mechanism is
   not enabled for the DHCPv4 triggered scripts. If options 66, 67 and 43 are received, all scripts
   are executed independently. The script defined by the tftp-server (option 66) option is executed
   first. If you are using HTTPS to transfer scripts, you must have a time server SNTP that is
   accessible and properly configured.</p>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic reference nested0" aria-labelledby="ariaid-title4" id="reference_dsd_hs4_yr">
  <h1 class="title topictitle1" id="ariaid-title4">Unit Macros</h1>
  <div class="body refbody">
    <table class="table frame-all" id="reference_dsd_hs4_yr__table_p3v_hs4_yr"><caption></caption><colgroup><col style="width:50%"><col style="width:50%"></colgroup><thead class="thead">
          <tr class="row">
            <th class="entry colsep-1 rowsep-1" id="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__1">Macro</th>
            <th class="entry colsep-1 rowsep-1" id="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__2">Description</th>
          </tr>
        </thead><tbody class="tbody">
          <tr class="row">
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__1">%mac% </td>
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__2">the MAC address of the unit </td>
          </tr>
          <tr class="row">
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__1">%version%</td>
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__2"> the MFP version of the unit (firmware version)</td>
          </tr>
          <tr class="row">
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__1">%product% </td>
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__2">the Product name of the unit</td>
          </tr>
          <tr class="row">
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__1">%productseries%</td>
            <td class="entry colsep-1 rowsep-1" headers="reference_dsd_hs4_yr__table_p3v_hs4_yr__entry__2">the Product series name of the unit.</td>
          </tr>
        </tbody></table>
  </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic nested0 nobody" aria-labelledby="ariaid-title5" id="topic_title_Basic_File_Server_Tasks_d1e19">
   <h1 class="title topictitle1" id="ariaid-title5">Basic File Server Tasks</h1>
<article class="topic task nested1" aria-labelledby="ariaid-title6" id="task_syk_fkb_wr">
    <h2 class="title topictitle2" id="ariaid-title6">Configuring the FTP Server </h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>If you are not familiar with the procedure on how to set the FTP root path, please
            refer to your FTP server's documentation.</section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>
            <p class="p">Perform this procedure if you plan to use the FTP transport protocol.</p>
        </section>
        <section id="task_syk_fkb_wr__steps_ukh_gkb_wr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_syk_fkb_wr__steps_ukh_gkb_wr"><li class="li step stepexpand">
                <span class="ph cmd">Set an FTP service on the assigned server.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the FTP server can be reached by the Mediatrix unit.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the file server is located behind a firewall, make sure that TCP port
                        21 is open.</div>
                </div>
            </li></ol></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_u1j_3f1_yr">Exporting a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_z5d_4sy_xr">Importing a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_cwv_slh_yr">Executing Configuration Scripts from a File Server Periodically</a></li><li class="linklist"><a class="link" href="#task_azs_hhp_yr">Executing Configuration Scripts from a File Server Each Time the Unit is Started</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title7" id="task_dpx_4dq_5q">
    <h2 class="title topictitle2" id="ariaid-title7">Configuring the TFTP Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>If you are not familiar with the procedure on how to set the TFTP root path, please
            refer to your TFTP server's documentation.</section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>Perform this procedure if you plan to use the TFTP transport protocol.</section>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Set a TFTP service on the assigned server.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the TFTP server can be reached by the Mediatrix unit.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the file server is located behind a firewall, make sure the UDP port 69
                        is open.</div>
                </div>
            </li></ol></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_u1j_3f1_yr">Exporting a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_z5d_4sy_xr">Importing a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_cwv_slh_yr">Executing Configuration Scripts from a File Server Periodically</a></li><li class="linklist"><a class="link" href="#task_azs_hhp_yr">Executing Configuration Scripts from a File Server Each Time the Unit is Started</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title8" id="task_ebc_zwg_wq">
    <h2 class="title topictitle2" id="ariaid-title8">Configuring the HTTP Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>If you are not familiar with the procedure on how to set the HTTP root path, refer
            to your HTTP server's documentation. </section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>Perform this procedure if you plan to use the HTTP transport protocol.</section>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Set an HTTP service on the assigned server.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the HTTP server can be reached by the Mediatrix unit.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the file server is located behind a firewall, make sure the TCP port 80
                        is open.</div>
                </div>
            </li></ol></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_u1j_3f1_yr">Exporting a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_z5d_4sy_xr">Importing a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_cwv_slh_yr">Executing Configuration Scripts from a File Server Periodically</a></li><li class="linklist"><a class="link" href="#task_azs_hhp_yr">Executing Configuration Scripts from a File Server Each Time the Unit is Started</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title9" id="task_qhf_hyg_wq">
    <h2 class="title topictitle2" id="ariaid-title9">Configuring the HTTPS Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div> If you are not familiar with the procedure on how to set the HTTPS root path,
            please refer to your HTTPS documentation. <p class="p">Make sure the unit is set to the proper
                date (refer to <a class="xref" href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a>.</p></section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>Perform this procedure if you plan to use the HTTPS transport protocol.</section>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Set an HTTPS service on the assigned server.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the HTTPS server can be reached by the Mediatrix unit.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the file server is located behind a firewall, make sure the TCP port
                        443 is open.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure that in the <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Certificates</span> tab, in the
                        <span class="keyword wintitle">Certificate Import Through Web
                Browser</span> table, there is a certificate that authenticates the HTTPS server selected in
                    the <span class="keyword wintitle">Path</span> field, and
                    that <span class="keyword wintitle">Other</span> is selected
                    in the <span class="keyword wintitle">Type</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Set the configuration parameters.</span>
            </li></ol></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title10" id="task_ofy_g2q_5q">
    <h2 class="title topictitle2" id="ariaid-title10">Configuring the Mediatrix Unit to Use an SNTP Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Make sure there is an SNTP server available.</section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>
            </section>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Network</span>/<span class="keyword wintitle">Host</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">SNTP Configuration</span> table,
                    from the <span class="keyword wintitle">Configuration Source</span>
                    selection list, select the connection type from which you wish to obtain the
                    SNTP parameters. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> Complete <a class="xref" href="#task_ofy_g2q_5q__Step3">Step 3</a>
                        only if you are using static SNTP server(s), otherwise go to <a class="xref" href="#task_ofy_g2q_5q__Step4">Step 4</a>.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd" id="task_ofy_g2q_5q__Step3">Provide an IP address or domain name and port numbers for each SNTP
                    server you are using.</span>
            </li><li class="li step stepexpand" id="task_ofy_g2q_5q__Step4">
                <span class="ph cmd">If necessary, change the displayed default value of the <span class="keyword wintitle">Synchronisation Period</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If necessary, change the displayed default value of the <span class="keyword wintitle">Synchronisation Period on Error</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The SNTP host name and port will be displayed in the <span class="keyword wintitle">Host Status</span> table under <span class="keyword wintitle">Network</span>/<span class="keyword wintitle">Status</span>.<br><img class="image" id="task_ofy_g2q_5q__image_ixb_rl4_1s" src="https://documentation.media5corp.com/download/attachments/62825785/SNTPConfiguration.png" width="800"><br></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_u1j_3f1_yr">Exporting a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_z5d_4sy_xr">Importing a Configuration Script Using a File Server</a></li><li class="linklist"><a class="link" href="#task_cwv_slh_yr">Executing Configuration Scripts from a File Server Periodically</a></li><li class="linklist"><a class="link" href="#task_azs_hhp_yr">Executing Configuration Scripts from a File Server Each Time the Unit is Started</a></li></ul></div></nav></article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic nested0 nobody" aria-labelledby="ariaid-title11" id="topic_title_Basic_Export_Tasks_d1e25">
   <h1 class="title topictitle1" id="ariaid-title11">Basic Export Tasks</h1>
<article class="topic task nested1" aria-labelledby="ariaid-title12" id="task_u1j_3f1_yr">
    <h2 class="title topictitle2" id="ariaid-title12">Exporting a Configuration Script Using a File Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Depending on the type of transport protocol used, one of the following procedures
            must be completed: <ul class="ul" id="task_u1j_3f1_yr__ul_lpt_1qz_xv">
                <li class="li"><a class="xref" href="#task_syk_fkb_wr">Configuring the FTP Server</a></li>
                <li class="li"><a class="xref" href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li>
                <li class="li"><a class="xref" href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li>
                <li class="li"><a class="xref" href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li>
            </ul></section>
        
        <section id="task_u1j_3f1_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_u1j_3f1_yr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Export</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Export Script</span>
                    table, from the <span class="keyword wintitle">Content</span> selection list, choose if you wish to export only what is different from the
                    factory configuration script or the complete configuration. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Service Name</span>
                    selection list, choose if you wish to export the configuration script of a
                    specific service or of all services.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Send To URL</span>
                    field, enter the
                        <code class="ph codeph">protocol://[user[:password]@]hostname[:port]/[path/]filename</code>
                    where to export the configuration file.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> This must be consistent with the file server you have configured. The file
                        name may be replaced by a macro. For more details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. As a
                        best practice, add the *.cfg extension to the file name.</div>
                </div>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> Remember, if you have several units with several configurations and plan
                        to reuse the configuration on another unit, the name must be explicit.
                        Indicate the date of your script, the interfaces used, the device model,
                        etc.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If you wish to use encryption for transfer operations, enter a encryption key
                    in the <span class="keyword wintitle">Privacy Key</span>
                    field. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> Media5 corp strongly recommends to use encryption to protect certificates
                        and passwords.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the file server is started.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Export and Download</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be exported to the specified file server.<br><img class="image" id="task_u1j_3f1_yr__image_nzy_dpt_1s" src="https://documentation.media5corp.com/download/attachments/62825785/ExportScript.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title13" id="task_vr5_g41_yr">
    <h2 class="title topictitle2" id="ariaid-title13">Exporting a Configuration Script to Your PC </h2>
    <div class="body taskbody">
        
        <section id="task_vr5_g41_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_vr5_g41_yr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Export</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If you are not using HTTPS, click <span class="keyword wintitle">Activate unsecure
                file importation from the Web browser</span> located at the top of the page. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Download Script From Web
                Browser</span>
                    table, from the <span class="keyword wintitle">Content</span> selection list, choose if you wish to export only what is different from the
                    factory configuration script or the complete configuration.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If you wish to use encryption for transfer operations, complete the <span class="keyword wintitle">Privacy Key</span> field. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> Media5 strongly recommends to use encryption to protect certificates
                        and passwords.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Export and Download</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be exported to your PC in the Downloads folder. The
            system generates a macAddress.cfg file name. <br><img class="image" id="task_vr5_g41_yr__image_sl4_32n_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/DownloadScriptFromWebBrowser.png" width="800"><br></section>
    </div>
</article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic nested0 nobody" aria-labelledby="ariaid-title14" id="topic_title_Basic_Import_Tasks_d1e28">
   <h1 class="title topictitle1" id="ariaid-title14">Basic Import Tasks</h1>
<article class="topic task nested1" aria-labelledby="ariaid-title15" id="task_z5d_4sy_xr">
    <h2 class="title topictitle2" id="ariaid-title15">Importing a Configuration Script Using a File Server</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Depending on the type of transport protocol used, one of the following procedures
            must be completed: <ul class="ul" id="task_z5d_4sy_xr__ul_ftj_5dp_wr">
                <li class="li"><a class="xref" href="#task_syk_fkb_wr">Configuring the FTP Server</a></li>
                <li class="li"><a class="xref" href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li>
                <li class="li"><a class="xref" href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li>
                <li class="li"><a class="xref" href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li>
            </ul></section>
        
        <section id="task_z5d_4sy_xr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_z5d_4sy_xr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Execute Scripts</span>
                    table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive and may be replaced by a macro. For more
                        details on macros, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg. file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select the type of protocol you wish to use to transfer your configuration
                    script. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> This must be consistent with the file server you have configured.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Host Name</span>
                    field, enter the file server IP address or FQDN.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Location</span>
                    field, enter the path relative to the root of the file server where the
                    configuration script is saved.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If your server requires authentication, enter your username and password.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the files are encrypted, provide the privacy key in the <span class="keyword wintitle">Privacy Key</span> field.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        file.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the file server is started.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Depending on your use case, set the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field to <span class="keyword wintitle">Enable</span> or
                        <span class="keyword wintitle">Disable</span>. This
                    parameter defines if the Mediatrix unit will execute a script or not, when it is
                    the same as the last executed script.",</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply &amp; Execute</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be imported from the file server, and any changes to
            the script will be applied to the running configuration. Keep in mind that if you import
            a generic and a specific file, the commands of the specific file will override the
            commands of the generic file.<br><img class="image" id="task_z5d_4sy_xr__image_g1x_s2n_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteScripts.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title16" id="task_uk2_1j1_yr">
    <h2 class="title topictitle2" id="ariaid-title16">Executing a Configuration Script from the Unit File Management System</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>A configuration script must have been imported to the unit's file management system.
            Refer to <a class="xref" href="#task_w4f_tv5_1s">Importing a Configuration Script to the Unit File Management System</a>.</section>
        
        <section id="task_uk2_1j1_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_uk2_1j1_yr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Execute Scripts</span>
                    table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import, or use the <span class="keyword wintitle">Suggestion</span> selection
                    list.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive, and may be replaced by a macro. For more
                        details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select <span class="keyword wintitle">File</span>. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> This option is not available on the Mediatrix 4102S running a firmware
                        version more recent than DGW 2.0.26.451</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the file is encrypted, complete the <span class="keyword wintitle">Privacy Key</span> field. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        file.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">As a best practice, enable the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply &amp; Execute</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be imported from the unit's file management system,
            and any changes to the script will be applied to the running configuration. Keep in mind
            that if you import a generic and specific file, the commands of the specific file will
            override the commands of the generic file.<br><img class="image" id="task_uk2_1j1_yr__image_at1_hfn_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteScripts_file.png" width="800"><br>
        </section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title17" id="task_gll_zk1_yr">
    <h2 class="title topictitle2" id="ariaid-title17">Executing Inline Scripts</h2>
    <div class="body taskbody">
        <section id="task_gll_zk1_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_gll_zk1_yr__steps_n14_vvy_xr"><li class="li step">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">If you are not using HTTPS, click <span class="keyword wintitle">Activate unsecure
                file importation from the Web browser</span>. </span>
            </li><li class="li step">
                <span class="ph cmd">In the <span class="keyword wintitle">Execute Inline Script</span> table,
                    insert the configuration lines. </span>
            </li><li class="li step">
                <span class="ph cmd">Click <span class="keyword wintitle">Execute</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>All the lines of the script will be transferred to the unit, executed in batch in
            background, and applied to the running configuration. The <span class="keyword wintitle">Scripts Status Execute</span> table
            will display the current state and result of the execution.<br><img class="image" id="task_gll_zk1_yr__image_nqp_d3n_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteInlineScript.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title18" id="unique_116328731259684150">
    <h2 class="title topictitle2" id="ariaid-title18">Importing a Configuration Script from Your PC </h2>
    <div class="body taskbody">
        
        <section id="unique_116328731259684150__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="unique_116328731259684150__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If you are not using HTTPS, click <span class="keyword wintitle">Activate unsecure
                file importation from the Web browser</span>. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Upload Script Through Web Browser</span> table, browse to the location of the file you wish to import. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the file is encrypted, complete the <span class="keyword wintitle">Privacy Key</span> field. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        file.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Upload and Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Located at the top of the page, click <span class="keyword wintitle">Refresh</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be imported from your PC and any changes to the script
            will be applied to the running configuration.<br><img class="image" id="unique_116328731259684150__image_vl4_dcn_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/UploadThroughWebBrowser.png" width="800"><br>
        </section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title19" id="task_w4f_tv5_1s">
    <h2 class="title topictitle2" id="ariaid-title19">Importing a Configuration Script to the Unit File Management System</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>This option is not available on the Mediatrix 4102S running a firmware version more
            recent than DGW 2.0.26.451</section>
        
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">File</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If you are not using HTTPS, click <span class="keyword wintitle">Activate unsecure
                file importation from the Web browser</span> located at the top of the page. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Import File Through Web Browser</span>
                    table, from the <span class="keyword wintitle">Path</span>
                    selection list, select <span class="keyword wintitle">Conf/</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Browse to the location of the configuration file.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Import</span>. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> A factory reset will remove the file from the Internal file.</div>
                </div>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The imported configuration file will appear in the <span class="keyword wintitle">Internal files</span> table, under <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">File</span> . <br><img class="image" id="task_w4f_tv5_1s__image_mjd_mz5_1s" src="https://documentation.media5corp.com/download/attachments/62825785/ImportFileThroughWebBrowser_Configuration.png" width="800"><br></section>
    </div>
</article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic nested0 nobody" aria-labelledby="ariaid-title20" id="topic_title_Basic_Automation_Tasks_d1e34">
   <h1 class="title topictitle1" id="ariaid-title20">Basic Automation Tasks</h1>
<article class="topic task nested1" aria-labelledby="ariaid-title21" id="task_cwv_slh_yr">
    <h2 class="title topictitle2" id="ariaid-title21">Executing Configuration Scripts from a File Server Periodically</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Depending on the type of transport protocol used, one of the following procedures
            must be completed: <ul class="ul" id="task_cwv_slh_yr__ul_ftj_5dp_wr">
                <li class="li"><a class="xref" href="#task_syk_fkb_wr">Configuring the FTP Server</a></li>
                <li class="li"><a class="xref" href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li>
                <li class="li"><a class="xref" href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li>
                <li class="li"><a class="xref" href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li>
            </ul><p class="p">Mediatrix units do not all include a real time clock allowing them to maintain
                accurate time when they are shutdown. You must have a time server SNTP that is
                accessible and properly configured or the automatic configuration update feature may
                not work properly. Refer to <a class="xref" href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a>.</p></section>
        
        <section id="task_cwv_slh_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_cwv_slh_yr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Execute Scripts</span>
                    table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive, and may be replaced by a macro. For more
                        details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg. file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select the type of protocol you wish to use to transfer your script. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> This must be consistent with the file server you have configured.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Host Name</span>
                    field, enter the file server IP address or FQDN.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Location</span>
                    field, enter the path relative to the root of the file server where the script
                    is saved. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If your server requires authentication, enter your username and password.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the files are encrypted, provide the privacy key in the <span class="keyword wintitle">Privacy Parameters</span>
                    section.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        file.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the file server is started.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Automatic Script
              Execution</span>
                    section, from the <span class="keyword wintitle">Execute Periodically</span>
                    selection list, choose <span class="keyword wintitle">Enable</span>. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Complete the <span class="keyword wintitle">Time Unit</span>, <span class="keyword wintitle">Period</span> and
                        <span class="keyword wintitle">Time Range</span> fields
                    according to your needs.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The time range ( hh[:mm[:ss]] or hh[:mm[:ss]] - hh[:mm[:ss]]) is based on
                        the <span class="keyword wintitle">Static Time Zone</span>
                        field, under the <span class="keyword wintitle">Network</span> &gt; <span class="keyword wintitle">Host</span> page.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">As a best practice, enable the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be imported from the file server at the specified time
            or at a random time within the specified interval and thereafter at the period defined
            by the <span class="keyword wintitle">Period</span> field. Any
            change to the script will be applied to the running configuration. The unit
            configuration is only updated if at least one parameter value defined in the imported
            configuration scripts is different from the actual unit configuration. Keep in mind that
            if you import a generic and a specific file, the commands of the specific file will
            override the commands of the generic file.<br><img class="image" id="task_cwv_slh_yr__image_g1x_s2n_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteScripts.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title22" id="task_rht_dht_1s">
    <h2 class="title topictitle2" id="ariaid-title22">Executing Configuration Scripts from the Unit File Management System Periodically</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div><p class="p">You must have a time server SNTP that is accessible and properly configured or
                the automatic configuration update feature may not work properly. Refer to <a class="xref" href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a>. Configuration scripts files must be available in the unit's file management
                system. Refer to <a class="xref" href="#task_w4f_tv5_1s">Importing a Configuration Script to the Unit File Management System</a>.</p>A configuration script must have been imported to the unit's file management
            system. Refer to <a class="xref" href="#task_w4f_tv5_1s">Importing a Configuration Script to the Unit File Management System</a>.</section>
        
        <section id="task_rht_dht_1s__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_rht_dht_1s__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Execute Scripts</span>
                    table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import or use the <span class="keyword wintitle">Suggestion</span> selection
                    list.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive, and may be replaced by a macro. For more
                        details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg. file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select <span class="keyword wintitle">File</span>.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the files are encrypted, provide the privacy key in the <span class="keyword wintitle">Privacy Key</span> field.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        files.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Automatic Script
              Execution</span>
                    section, from the <span class="keyword wintitle">Execute Periodically</span>
                    selection list, choose <span class="keyword wintitle">Enable</span>. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Complete the <span class="keyword wintitle">Time Unit</span>, <span class="keyword wintitle">Period</span> and
                        <span class="keyword wintitle">Time Range</span> fields
                    according to your needs.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The time range ( hh[:mm[:ss]] or hh[:mm[:ss]] - hh[:mm[:ss]]) is based on
                        the <span class="keyword wintitle">Static Time Zone</span>
                        field, under the <span class="keyword wintitle">Network</span> &gt; <span class="keyword wintitle">Host</span> page.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">As a best practice, enable the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>The configuration script will be imported from the system's file management system
            at the specified time or at a random time within the specified interval and thereafter
            at the period defined by the <span class="keyword wintitle">Period</span> field. Any change to the
            script will be applied to the running configuration. The unit configuration is only
            updated if at least one parameter value defined in the imported configuration scripts is
            different from the actual unit configuration. Keep in mind that if you import a generic
            and specific file, the commands of the specific file will override the commands of the
            generic file.<br><img class="image" id="task_rht_dht_1s__image_iyd_jyn_gkb" src="https://documentation.media5corp.com/download/attachments/62825785/AutomaticScriptExecution_File.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title23" id="task_azs_hhp_yr">
    <h2 class="title topictitle2" id="ariaid-title23">Executing Configuration Scripts from a File Server Each Time the Unit is Started </h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Depending on the type of transport protocol used, one of the following procedures
            must be completed: <ul class="ul" id="task_azs_hhp_yr__ul_ftj_5dp_wr">
                <li class="li"><a class="xref" href="#task_syk_fkb_wr">Configuring the FTP Server</a></li>
                <li class="li"><a class="xref" href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li>
                <li class="li"><a class="xref" href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li>
                <li class="li"><a class="xref" href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li>
            </ul></section>
        
        <section id="task_azs_hhp_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_azs_hhp_yr__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Execute Scripts</span> table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive, and may be replaced by a macro. For more
                        details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg. file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select the type of protocol you wish to use to transfer your script. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> This must be consistent with the file server you have configured.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Host Name</span>
                    field, enter the file server IP address or FQDN.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Location</span>
                    field, enter the path relative to the root of the file server where the script
                    is saved. </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If your server requires authentication, enter your username and password.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the files are encrypted, provide the privacy key in the <span class="keyword wintitle">Privacy Parameters</span>
                    section.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The privacy key must match the privacy key used to encrypt the
                        files.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Make sure the file server is started.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Automatic Script
              Execution</span>
                    section, from the <span class="keyword wintitle">Execute on Startup</span> selection
                    list, choose <span class="keyword wintitle">Enable</span>.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">As a best practice, enable the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>When the unit is restarted, the configuration script will be imported from the file
            server, and any changes to the script will be applied to the running configuration. Keep
            in mind that if you import a generic and a specific file, the commands of the specific
            file will override the commands of the generic file.<br><img class="image" id="task_azs_hhp_yr__image_nyb_bzn_gkb" src="https://documentation.media5corp.com/download/attachments/62825785/AutomaticScriptExecution_File_eachUnitStart.png" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title24" id="task_mgx_dlt_1s">
    <h2 class="title topictitle2" id="ariaid-title24">Executing Configuration Scripts from the Unit File Management System Each Time the Unit
        is Started</h2>
    <div class="body taskbody">
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>A configuration script must have been imported to the unit's file management system.
            Refer to <a class="xref" href="#task_w4f_tv5_1s">Importing a Configuration Script to the Unit File Management System</a>.</section>
        
        <section id="task_mgx_dlt_1s__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_mgx_dlt_1s__steps_n14_vvy_xr"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Execute Scripts</span> table, in the <span class="keyword wintitle">Generic File Name</span> and/or
                        <span class="keyword wintitle">Specific File Name</span>
                    field, indicate the name of the files you wish to import or use the <span class="keyword wintitle">Suggestion</span> selection
                    list.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The file name is case sensitive, and may be replaced by a macro. For more
                        details, refer to the <a class="xref" href="#reference_dsd_hs4_yr">Unit Macros</a> section. Make
                        sure to add the *.cfg. file extension.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Transfer Protocol</span> selection
                    list, select <span class="keyword wintitle">File</span>.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If the files are encrypted, provide the privacy key in the <span class="keyword wintitle">Privacy Parameters</span>
                    section.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Automatic Script
              Execution</span>
                    section, from the <span class="keyword wintitle">Execute on Startup</span> selection
                    list, choose <span class="keyword wintitle">Enable</span>.
                </span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">As a best practice, enable the <span class="keyword wintitle">Allow Repeated Execution</span>
                    field.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>When the unit is restarted, the configuration script will be imported from the
            system's file management system, and any changes to the script will be applied to the
            running configuration. Keep in mind that if you import a generic and specific file, the
            commands of the specific file will override the commands of the generic file. <br><img class="image" id="task_mgx_dlt_1s__image_qbp_rzn_gkb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteScripts_FileManagementSystem_EachUnitStartup.PNG" width="800"><br></section>
    </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title25" id="task_aqz_l45_yr">
    <h2 class="title topictitle2" id="ariaid-title25">Configuring the DHCP to Trigger Configuration Script Execution</h2>
    
    <div class="body taskbody"><p class="shortdesc">The Mediatrix unit can be configured to automatically import new configuration
        scripts upon receiving options 66 (tftp-server) or 67 (bootfile), or vendor-specific option
        43 using sub-options 66 and 67 in a DHCPv4 answer. A DHCP answer includes both Bound and
        Renew. </p>
        <section class="section prereq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Before you begin</strong></div>Depending on the type of transport protocol used, one of the following procedures
            must be completed: <ul class="ul" id="task_aqz_l45_yr__ul_ftj_5dp_wr">
                <li class="li"><a class="xref" href="#task_syk_fkb_wr">Configuring the FTP Server</a></li>
                <li class="li"><a class="xref" href="#task_dpx_4dq_5q">Configuring the TFTP Server</a></li>
                <li class="li"><a class="xref" href="#task_ebc_zwg_wq">Configuring the HTTP Server</a></li>
                <li class="li"><a class="xref" href="#task_qhf_hyg_wq">Configuring the HTTPS Server</a></li>
            </ul><p class="p">Mediatrix units do not all include a real time clock allowing them to maintain
                accurate time when they are shutdown. If you are using HTTPS, you must have an SNTP
                server that is accessible and properly configured or the automatic configuration
                update feature may not work properly. Refer to <a class="xref" href="#task_ofy_g2q_5q">Configuring the Mediatrix Unit to Use an SNTP Server</a>.</p></section>
        <section class="section context"><div class="tasklabel"><strong class="sectiontitle tasklabel">Context</strong></div>
            <p class="p"> For more details on
                DHCPv4 Auto-Provisionning, refer to <a class="xref" href="#concept_zk3_lr5_yr" title="The Mediatrix unit can be configured to automatically download new configuration scripts upon receiving options 66 (tftp-server) or 67 (bootfile), or vendor-specific option 43 using sub-options 66 and 67 in a DHCPv4 answer">DHCPv4 Auto-Provisioning</a></p>
        </section>
        <section id="task_aqz_l45_yr__steps_n14_vvy_xr"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_aqz_l45_yr__steps_n14_vvy_xr"><li class="li step">
                <span class="ph cmd">Go to <span class="keyword wintitle">Management</span>/<span class="keyword wintitle">Configuration Scripts</span>/<span class="keyword wintitle">Execute</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">In the <span class="keyword wintitle">Automatic Script
              Execution</span>
                    section, from the <span class="keyword wintitle">Allow DHCP to Trigger Scripts
                Execution</span> selection list, choose <span class="keyword wintitle">Enable</span>. </span>
            </li><li class="li step">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>
            <p class="p">The instructions sent FROM the DHCP server can be in different formats and will be
                understood by the Mediatrix unit according to what was chosen for the
                    <span class="keyword parmname">ScriptsDhcpOptionsFormat</span> MIB parameter (not accessible via
                Web page). Possible values with their respective formats are: </p>
            <ul class="ul" id="task_aqz_l45_yr__ul_ufq_xmn_j1b">
                <li class="li">Fully Qualified: Script=[protocol]://[username]
                    :[password]@[server]/[path]/[file].</li>
                <li class="li">Url: [protocol]:// [username] :[password]@[server]/[path]/[file]</li>
                <li class="li">ServerHost: Allow one DHCP option to specify the IP address or FQDN of a file
                    server. Uses the path and filename specified in the ScriptLocation and
                    ScriptGenericFileName parameters, use the transfer protocol, username and
                    password specified in ScriptTransferProtocol, ScriptTransferUsername and
                    ScriptTransferPassword parameters.</li>
                <li class="li">AutoDetect: A value beginning with "Script=" is considered as "FullyQualified",
                    A value beginning with "[protocol]://" is considered as a URL. A value that
                    looks like an IPv4/IPv6 address or domain name is considered as a "ServerHost".
                    (default value)</li>
            </ul>
            <p class="p">When the unit starts, it will receive the location of the config script from the DHCP
                response, as per the format defined by the
                    <span class="keyword parmname">ScriptsDhcpOptionsFormat</span> parameter. The unit will then
                import and execute the configuration scripts from the specified location. Any
                changes to the script will be applied to the running configuration. The unit
                configuration is only updated if at least one parameter value defined in the
                imported configuration scripts is different from the actual unit configuration. </p>
            <br><img class="image" id="task_aqz_l45_yr__image_g3p_1hn_dhb" src="https://documentation.media5corp.com/download/attachments/62825785/ExecuteScripts_startup.png" width="800"><br>
        </section>
    </div>
</article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic reference nested0" aria-labelledby="ariaid-title26" id="reference_dky_yjz_xr">
  <h1 class="title topictitle1" id="ariaid-title26">Advanced Configuration Scripts Parameters</h1>
  <div class="body refbody">
        <section class="section">Although the services can be configured in great part in the Web browser, some
            aspects of the configuration can only be completed with the configuration parameters by
                :<ul class="ul" id="reference_dky_yjz_xr__ul_gfn_14v_wr">
                <li class="li">using a MIB browser</li>
                <li class="li">using the CLI</li>
                <li class="li">creating a configuration script containing the configuration parameters</li>
            </ul></section>
        <section class="section">For more details on the following parameters, refer to the <a class="xref" href="https://documentation.media5corp.com/display/DGWLATEST/Reference+Guide" target="_blank">DGW Configuration Guide - Reference Guide</a>
            published on the <a class="xref" href="https://documentation.media5corp.com/" target="_blank">Media5 Documentation Portal</a>. The
            Reference Guide contains all the parameters used in the DGW software with their
            description, default values, and interactions. </section>
    <section class="section"><h2 class="title sectiontitle">Scripts Transfer Certificate Validation</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsTransferCertificateValidation</span>.</section>
    <section class="section"><h2 class="title sectiontitle">Scripts Transfer Certificate Trust Level</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsTransferCertificateTrustLevel</span>.</section>
    <section class="section"><h2 class="title sectiontitle">Scripts Transfer Cipher Suite</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsTransferCipherSuite</span>.</section>
    <section class="section"><h2 class="title sectiontitle">Scripts Transfer Tls Version</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsTransferTlsVersion</span> .</section>
    <section class="section"><h2 class="title sectiontitle">Scripts Dhcp Options Format</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsDhcpOptionsFormat</span>.</section>
    <section class="section"><h2 class="title sectiontitle">Scripts Transfer Retries Number</h2>Refer to<span class="keyword parmname"> Conf.
                ScriptsTransferRetriesNumber</span>.</section>
  </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic reference nested0" aria-labelledby="ariaid-title27" id="reference_j4g_nbv_gfb">
  <h1 class="title topictitle1" id="ariaid-title27">Online Help</h1>
  <p class="shortdesc"><span class="ph">If you are not familiar with the meaning of the fields and
                buttons, click <span class="keyword wintitle">Show Help</span>, located at the upper right corner of
                the Web page. When activated, the fields and buttons that offer online help will
                change to green and if you hover over them, the description will bedisplayed.</span></p>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title28" id="concept_v4k_q3h_1r">
 <h1 class="title topictitle1" id="ariaid-title28">DGW Documentation</h1>
 
 <div class="body conbody"><p class="shortdesc">Mediatrix devices are supplied with an exhaustive set of documentation. </p>
  <p class="p">Mediatrix user documentation is available on the <a class="xref" href="http://documentation.media5corp.com" target="_blank">Media5 Documentation
    Portal</a>.</p>
  <div class="p">Several types of documents were created to clearly present the information you are looking for.
   Our documentation includes:<ul class="ul" id="concept_v4k_q3h_1r__ul_bqy_cjh_1r">
    <li class="li"><strong class="ph b">Release notes</strong>: Generated at each GA release, this document includes the known and
     solved issues of the software. It also outlines the changes and the new features the release
     includes.</li>
    <li class="li"><strong class="ph b">Configuration notes</strong>: These documents are created to facilitate the configuration of a
     specific use case. They address a configuration aspect we consider that most users will need to
     perform. However, in some cases, a configuration note is created after receiving a question
     from a customer. They provide standard step-by-step procedures detailing the values of the
     parameters to use. They provide a means of validation and present some conceptual information.
     The configuration notes are specifically created to guide the user through an aspect of the
     configuration. </li>
    <li class="li"><strong class="ph b">Technical bulletins</strong>: These documents are created to facilitate the configuration of a
     specific technical action, such as performing a firmware upgrade.</li>
    <li class="li"><strong class="ph b">Hardware installation guide</strong>: They provide the detailed procedure on how to safely and
     adequately install the unit. It provides information on card installation, cable connections,
     and how to access for the first time the Management interface.</li>
    <li class="li"><strong class="ph b">User guide</strong>: The user guide explains how to customise to your needs the configuration
     of the unit. Although this document is task oriented, it provides conceptual information to
     help the user understand the purpose and impact of each task. The User Guide will provide
     information such as where and how TR-069 can be configured in the Management Interface, how to
     set firewalls, or how to use the CLI to configure parameters that are not available in the
     Management Interface.</li>
    <li class="li"><strong class="ph b">Reference guide</strong>: This exhaustive document has been created for advanced users. It
     includes a description of all the parameters used by all the services of the Mediatrix units.
     You will find, for example, scripts to configure a specific parameter, notification messages
     sent by a service, or an action description used to create Rulesets. This document includes
     reference information such as a dictionary, and it does not include any step-by-step
     procedures. </li>
   </ul></div>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title29" id="concept_fqm_rv4_k4">
 <h1 class="title topictitle1" id="ariaid-title29">Copyright Notice</h1>
 

 <div class="body conbody"><p class="shortdesc">Copyright © 2022 Media5 Corporation.</p>
  <p class="p">This document contains information that is proprietary to Media5 Corporation.</p>
  <p class="p">Media5 Corporation reserves all rights to this document as well as to the Intellectual Property
   of the document and the technology and know-how that it includes and represents.</p>
  <p class="p">This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever,
   without written prior approval by Media5 Corporation.</p>
  <p class="p">Media5 Corporation reserves the right to revise this publication and make changes at any time
   and without the obligation to notify any person and/or entity of such revisions and/or
   changes.</p>
 </div>
</article></article></main></body></html>