Skip to end of metadata
Go to start of metadata

Download PDF Document



2019-11-01
All Mediatrix units
Virtuo 4.1.8
Top

1 Information to Know Before you Start

Note

The Virtuo and BroadCloud provisioning process is in TLS. BroadCloud changes the admin and public passwords to some random values in the provisioning. To view the Mediatrix unit configuration, perform a partial reset. Refer to the Technical Bulletins - Performing a Partial Reset document published on the Mediatrix Documentation Portal at https://documentation.media5corp.com/ .

  • The user must have as MSA that allows the use of Virtuo.
  • The Mediatrix unit must have access to:
    • a valid DNS
    • an NTP server otherwise it will be impossible to validate the certificate date and therefore it will be rejected.
    • public internet

Note

BroadCloud will upgrade the Mediatrix unit to another version of firmware (with MX profile). As a result, once the Mediatrix unit has received the provisioning from the BroadCloud server, it will not be able to come back to the Virtuo server, not even with a factory reset.

Top

2 Virtuo EMS Used as a Redirect Sever for the BroadCloud Service

In this use case, the Mediatrix Virtuo EMS will be used as a redirect server for the BroadCloud Service.

Top

2.1 Logging On To Virtuo EMS

Before You Start
A username and a password is required to connect to the Virtuo EMS.
Steps
  1. Go to https://virtuo.media5corp.com
  2. Log on to the Virtuo EMS with your username and password.
Result
The Virtuo EMS home page will be displayed.
Top

2.2 Adding a Configuration File to the Virtuo EMS

Use this procedure if the configuration script you wish to use is not in the Configuration table (Configuration in the Settings section on the left hand side of screen),

Steps
  1. In the Virtuo EMS Web interface, from the Settings section located on the left hand side of the screen, click Configuration .
  2. In the Configuration section, click Upload Configuration .
  3. Browse to the location of the configuration file.
  4. Click Upload .
Result
The uploaded configuration will appear in the Configuration section of the Configuration page. The configuration can now be associated with a group. The configuration can also be associated with a single unit as a specific configuration.
Top

2.3 Associating a Virtuo Configuration File with a Group

Steps
  1. In the Virtuo EMS Web interface, from the Settings section located on the left hand side of the screen, click Configuration .
  2. Click located on the same line as the group to which you wish to associate the configuration script.
  3. In the Group Details page, from the Configuration selection list, choose the appropriate Configuration file.
  4. Click Save Group .
Result
When a Mediatrix unit is associated with the group, the selected configuration script will be applied for provisioning.
Top

2.4 Enabling the Redirect Function on a Mediatrix Unit

Steps
  1. Go to List located under the Units section on the left hand side of the Virtuo Home page.
  2. From the Find selection list located at the bottom of the Units table, select Serial Number .
  3. In the Find field, enter the serial number of the unit .

    Note

    If the unit does not appear in the Units list, then, if you purchased your unit directly from Media5, please contact technical support at tac@media5corp.com, otherwise contact your reseller.

  4. Click the line of the Mediatrix unit.
  5. In the Unit Details page, in the Unit Remote Configuration section, select the Active check box.
  6. From the Generic Configuration Group selection list, choose the corresponding redirect script by picking the right Configuration Group.
  7. Click Save .
  8. Click Back . The Units table will display when the unit last checked in, its profile and firmware version, validating if the unit has come online and reached the Virtuo server or not.
Result
Top

3 Example of a Redirect Script for BroadCloud

  • BroadCloud has deployed different provisioning servers for different region. At the moment, BroadCloud has three provisioning server worldwide:
    • North America (perhaps CALA) - mediatrix.sipflash.com
    • Europe, Middle East, Africa - mediatrix.broadcloud.eu
    • Australia, Asia Pacific - mediatrix.broadcloud.com.au
  • All servers have the same directory setup and filename naming convention. Therefore, when selling Mediatrix devices to the Euro zone, only the provisioning URL in the script needs to be changed

  • Once the unit has downloaded this redirect script, it will restart itself and start another round of provisioning with the BroadCloud provisioning server.

Important

Each scripting line must be written without introducing any spaces or "Enter" commands.

The section in bold is the main redirect script.
##################################################
#
# Copyright(c) 2019 Media5 Corporation ("Media5")
#
# NOTICE: This document contains information that is confidential and 
# proprietary to Media5.
# Media5 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.
# This publication cannot be reproduced, neither in whole nor in part, in any
# form whatsoever without prior written approval by Media5.
# Media5 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.
#
################################################## 
################################################## 
#
#System Name        : Mediatrix C710
#Description        : US BroadSoft Flash File
#
################################################## 

#
# Hoc Service
#
Hoc.HttpUaHeaderFormat = "%product%/v%version% %mac%"
#
# Time Server
#
Hoc.SntpConfigSource = "Static"  # Static, or Automatic (dhcp)
Hoc.StaticSntpServerHost = "ntp.adpt-tech.com"
#
# Config File 
#
DownloadConf.ScriptsLocation = "dms/Mediatrix-C710"
Conf.ScriptsTransferSrvHostname = "mediatrix.sipflash.com"
Conf.ScriptGenericFileName = "C710_%mac%_user.txt"
Conf.ScriptSpecificFilename=""
Conf.ScriptsTransferOnRestartEnable = "Enable"
Conf.ScriptsTransferProtocol = "https"
Conf.ScriptsTransferCertificateValidation = "NoValidation"
Conf.ScriptsTransferCertificateTrustLevel = "LocallyTrusted"
Conf.ScriptsTransferCipherSuite="CS3"
Conf.ScriptsTransferTlsVersion="TLSv1"
#
# Disabling Option 66 provisioning
#
Conf.ScriptsDhcpDownloadEnable = "Disable"
Conf.ScriptsAllowRepeatedExecution = "Disable" 


# Adding a temporary VLAN
# Eth Service
#
Eth.Vlan.DeleteAllRows
Eth.AddVlan Idx=1
Eth.Vlan[Idx=1].LinkName = "eth1"
Eth.Vlan[Idx=1].VlanId = "1" 
#
# Build up Network interface table
#
# Bni.NetworkInterfaces.DeleteAllRows
# Bni.AddNetwork Idx=2
# Bni.AddNetwork Idx=3
# Bni.AddNetwork Idx=4
Bni.AddNetwork Idx=5
# Bni.NetworkInterfaces[Idx=1].InterfaceName = "Rescue"
# Bni.NetworkInterfaces[Idx=2].InterfaceName = "Lan1"
# Bni.NetworkInterfaces[Idx=3].InterfaceName = "Uplink"
# Bni.NetworkInterfaces[Idx=4].InterfaceName = "UplinkV6"
Bni.NetworkInterfaces[Idx=5].InterfaceName = "Uplink_VLAN"
# Bni.NetworkInterfaces[Idx=1].LinkName = "eth1"
# Bni.NetworkInterfaces[Idx=2].LinkName = "eth2"
# Bni.NetworkInterfaces[Idx=3].LinkName = "eth1"
# Bni.NetworkInterfaces[Idx=4].LinkName = "eth1"
Bni.NetworkInterfaces[Idx=5].LinkName = "eth1.1"
# Bni.NetworkInterfaces[Idx=1].ConnectionType = "IpStatic"
# Bni.NetworkInterfaces[Idx=2].ConnectionType = "IpStatic"
# Bni.NetworkInterfaces[Idx=3].ConnectionType = "IpDhcp"
# Bni.NetworkInterfaces[Idx=4].ConnectionType = "Ip6AutoConf"
Bni.NetworkInterfaces[Idx=5].ConnectionType = "IpDhcp"
# Bni.NetworkInterfaces[Idx=1].StaticIpAddr = "192.168.0.1/24"
# Bni.NetworkInterfaces[Idx=2].StaticIpAddr = "192.168.0.10/24"
# Bni.NetworkInterfaces[Idx=3].StaticIpAddr = "192.168.10.1/24"
# Bni.NetworkInterfaces[Idx=4].StaticIpAddr = ""
Bni.NetworkInterfaces[Idx=5].StaticIpAddr = "192.168.0.10/24"
# Bni.NetworkInterfaces[Idx=1].StaticDefaultRouter = ""
# Bni.NetworkInterfaces[Idx=2].StaticDefaultRouter = ""
# Bni.NetworkInterfaces[Idx=3].StaticDefaultRouter = ""
# Bni.NetworkInterfaces[Idx=4].StaticDefaultRouter = ""
Bni.NetworkInterfaces[Idx=5].StaticDefaultRouter = ""
# Bni.NetworkInterfaces[Idx=1].Activation = "Disable"
# Bni.NetworkInterfaces[Idx=2].Activation = "Enable"
# Bni.NetworkInterfaces[Idx=3].Activation = "Enable"
# Bni.NetworkInterfaces[Idx=4].Activation = "Disable"
Bni.NetworkInterfaces[Idx=5].Activation = "Disable"
# Bni.NetworkInterfaces[Idx=1].Priority = "100"
# Bni.NetworkInterfaces[Idx=2].Priority = "50"
# Bni.NetworkInterfaces[Idx=3].Priority = "50"
# Bni.NetworkInterfaces[Idx=4].Priority = "50"
Bni.NetworkInterfaces[Idx=5].Priority = "50" 

# Troubleshooting
#
# Nlm.SyslogRemoteHost = "1.1.1.1"
# Bni.MinSeverity = "Debug"
# Conf.MinSeverity = "Debug"
# Nlm.DiagnosticTracesEnable = "Enable"
#
##################################################
# The following scripting line must be written without introducing any spaces or "Enter" commands. 
##################################################
#
#Nlm.DiagnosticTracesFilter ="110=0,120=0,130=0,140=0,150=0,160=0,170=0,710=0,720=0,220=0,225=0,
230=0,240=0,250=0,260=0,270=0,810=0,820=0,825=0,830=0,840=0,850=0,860=0,
870=0,880=0,890=0,900=0,910=0,210=0,320=0,360=0,330=0,340=0,350=0,410=0,
440=0,510=0,515=0,560=0,530=0,540=0,550=0,920=0,930=0,940=0,950=0,960=0,
970=0,980=0,990=0,1000=0,1010=0" 
#
# Restart services
#
Reboot
Top

4 Copyright Notice

Copyright © 2019 Media5 Corporation.

This document contains information that is proprietary to Media5 Corporation.

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.

This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.

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.

Top