> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Creating an MVE Integrated with Versa
> This help topic describes how to create and configure a Megaport Virtual Edge (MVE) with Versa Secure SD-WAN.
export const Anchor = ({name}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Anchor -';
if (name === undefined || name === null || name === 'undefined') {
console.error(`${errorPrefix} \`name\` must have a value — rendering an empty string instead`);
return <>;
}
const raw = typeof name === 'string' ? name : JSON.stringify(name);
const id = raw.replace(/\s+/g, '-').replace(/[^A-Za-z0-9_-]/g, '').replace(/-+/g, '-').replace(/^-+|-+$/g, '');
if (!id) {
console.error(`${errorPrefix} \`name\` "${name}" sanitizes to an empty id — rendering an empty string instead`);
return <>;
}
return ;
};
export const Image = ({src, alt = '', caption, width, height, shadow}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
if (typeof src !== 'string') {
src = String(src);
}
if (!src || src === 'undefined') {
console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
return <>;
}
const img = ;
return caption ?
{img}
{caption} : img;
};
export const InlineImage = ({src, alt, height = 16, shadow, width}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: InlineImage -';
if (typeof src !== 'string') {
src = String(src);
}
if (!src || src === 'undefined') {
console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
return <>;
}
if (typeof alt !== 'string') {
alt = String(alt);
}
if (alt === 'undefined') {
console.error(`${errorPrefix} \`alt\` is required (use "" for decorative images) — rendering an empty string instead`);
return <>;
}
if (height) {
height = height.toString().replaceAll(/\D/g, '');
}
if (width) {
width = width.toString().replaceAll(/\D/g, '');
}
return ;
};
export const Link = ({href, children}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Link -';
if (typeof href !== 'string') {
href = String(href);
}
if (!href || href === 'undefined') {
console.error(`${errorPrefix} the \`href\` property is required — rendering an empty string instead`);
return <>;
}
if (href.includes('{') || href.toUpperCase().includes('%7B')) {
console.error(`${errorPrefix} could not resolve a variable in href "${href}" — rendering an empty string instead`);
return <>;
}
const isExternal = (/^https?:\/\//).test(href);
return
{children ?? href}
{isExternal && (opens in a new tab)}
;
};
This topic describes how to create and configure a Megaport Virtual Edge (MVE) with Versa Secure SD-WAN. Before you begin, you need user accounts with ordering permissions that provide access to the Megaport Portal and to Versa.
For more information about setting up a Megaport account, see [Creating an Account](/setting-up/registering).
Versa provides documentation for their SD-WAN product, including Versa Director and cloud connections, at [VOS SD-WAN Configuration Product Documentation](https://docs.versa-networks.com/Versa_Operating_System/VOS_SD-WAN_Configuration).
## Basic steps
The basic steps to configure an MVE with Versa are:
* Obtain information for Versa Director.
* Create a new workflow template in Director.
* Add a new device group in Director.
* Add a new device in Director.
* Create the Versa MVE Instance in the Megaport Portal.
* View the MVE public IP address assignment in the Megaport Portal.
* Verify that the MVE is registered and is in-sync from the Versa Director UI.
The following sections provide detailed instructions.
## Obtaining required information for Versa Director
To set up Versa you need the following information:
* **Versa Director IPv4 address or FQDN** -- For example: cloud211.versa-networks.com.
* **Versa Controller IPv4 address or FQDN** -- In Versa Director, select the **Configuration** tab in the top menu bar. Select Templates > Device Templates in the horizontal menu bar, and select a template. In the template details page, select the **Services** tab (the gear icon) and then select SDWAN > System > Controller Config. The window displays a list of controllers, their IP address, and any assigned FQDNs.
* **Local Auth String** -- The default is `SDWAN-Branch@Versa.com` which can be modified in Versa Director.
* **Remote Auth String** -- The default is `Controller-1-staging@Versa.com` which can be modified in Versa Director.
* **Serial Number** -- This value is created when you add a new device in Versa Director.
## Creating a new workflow template in Director
The next step is to create a new workflow template and device in Versa Director. Versa strongly suggests using their workflows for creating templates and devices. The workflows automatically build and create some behind-the-scenes configurations and variable values that could otherwise be missed.
**To create a new workflow template in Director**
1. Log in to Versa Director.
2. Select the **Workflows** tab in the top menu bar.
3. In the left navigation, select Template > Templates.
4. Click (Add) to create a template.
5. In the **Basic** tab, specify these details.
* **Name** -- Enter a name for the staging template.
* **Type** -- Select the template type SDWAN Post Staging from the drop-down menu.
* **Organization** -- Select the provider organization to associate with the template.
* **Device Type** -- Select SDWAN from the drop-down menu.
* Select the appropriate role (Full Mesh, Hub, Hub Controller, or Spoke).
* **Controllers** -- Select a controller node from your network to associate with the template.
* **Subscription** -- Select the appropriate subscription information for your network.
* **Solution Tier** -- Network service to be configured.
* **Service Bandwidth** -- Allocated bandwidth for the service in Mbps.
* **Preferred Software Version** -- Preferred version of the software that should be deployed on Versa Director. The preferred software version applies to zero-touch provisioning (ZTP). During ZTP, Versa Director upgrades a branch to the preferred version, if applicable. The preferred version can be backward compatible for up to two previous VOS versions.
For more information about creating Versa staging templates, see [Create and Manage Staging and Post-Staging Templates](https://docs.versa-networks.com/Versa_Operating_System/VOS_SD-WAN_Configuration/Basic_SD-WAN_Configuration/Create_and_Manage_Staging_and_Post-Staging_Templates).
6. Select the **Interfaces** tab and specify these details.
* **Number of Ports** -- Choose 4. MVE requires 4 ports.\
Note, Port 0 is reserved for management (Mgmt) and cannot be changed.
* Click the icon for port 1 and select **WAN** from the drop-down menu. A row is added to the WAN Interfaces list. (The WAN interface is automatically configured by the MVE creation process to connect through the Megaport Internet connection with bandwidth determined by the MVE size.)
* **VLAN ID** -- The value should be set to **0**.
* **Network Name** -- The value should be set to **INET-1**.
* **IPv4** -- The value should be set to **DHCP**.
* The remaining fields can be left unchanged.
You can optionally enter circuit information.
7. Click **Continue** (at the bottom right) until you see the **Create** option, then click **Create**.
You can now apply the template to a new device group.
## Adding a new device group in Director
The next step is to create a new device group.
1. Log in to Versa Director.
2. Select the **Configuration** tab in the top menu bar.
3. In the horizontal menu bar, select Devices > Device Groups.
4. Click (Add) to add a device group.
5. Specify these details:
* **Name** -- Enter a name for the device group that is easily identifiable.
* **Description** -- Enter descriptive information about the device group.
* **Tags** (optional) -- Enter strings for users to search on.
* **Organization** -- Select your organization from the drop-down.
* **Post Staging Template** -- Select the template you created previously.
6. Click **OK**.
## Adding a new device in Director
The next step is to add a new device.
1. Log in to Versa Director.
2. Select the **Workflows** tab in the top menu bar.
3. In the left navigation, select Devices > Devices.
4. Click (Add) to open the Add Device window.
5. In the **Basic** tab, specify these details.
* **Name** -- Specify a meaningful name for the device.
* **Global Device ID** -- Versa Director automatically assigns the next available ID.
* **Organization** -- Choose your organization from the drop-down.
* **Deployment Type** -- Choose **CPE-Baremetal Device** from the drop-down.
* **Serial Number** -- Enter a serial number for the device. Specify a unique and meaningful value for the device and make a note of it, as you need it again when creating the Versa MVE instance in the Megaport Portal.
* **Device Groups** -- Choose the device group you created previously. This will assign the new device to that device group.
6. Click **Continue**.
7. In the **Location Information** tab, enter the country where the device is located.
8. Click **Continue** until you see the **Deploy** button.
9. Click **Deploy**.\
The new device is now deployed in Versa Director.
## Creating an MVE in the Megaport Portal
When creating an MVE, select a location that supports the MVE and is in a compatible metro area for your network design. You can connect multiple locations to an individual MVE. For more information about location details, see [Planning Your Deployment](/mve/versa/plan-deployment).
You can deploy multiple MVEs within the same metropolitan area for redundancy or capacity reasons. As part of the MVE creation process, you will also typically create a Megaport Internet connection.
**To create an MVE**
1. In the Megaport Portal, go to the **Services** page.
2. Click **Add Services**, then select **MVE**.
3. Select **Versa FlexVNF**.
4. Select the software version.
The MVE will be configured to be compatible with that version of Versa.
5. Click **Next**.
6. Specify the MVE details:
* **Location** -- Select the MVE location.
Select a location geographically close to your target branch and/or on-premises locations.
The country you choose must be a market in which you have already registered.
If you haven't registered a billing market in the location where you will deploy the MVE, follow the procedure in [Enabling Billing Markets](/finance/enabling-market).
You can use the **Search** field to find the Port name, Country, Metro City, or address of your destination Port. You can also filter by diversity zone.
* **Diversity Zone** -- Select a diversity zone.
You can select either Red or Blue, or select Auto and have Megaport select the zone for you. The selected or allocated diversity zone will be displayed on the location details through the rest of the provisioning, and on the Summary page at the end.\
For more information, see [MVE Diversity](/mve/mcr-mve-diversity).
* **Size** -- Select a size from the list of available sizes. Available sizes are highlighted in green and labeled **Available**. The sizes support varying numbers of concurrent connections, and individual partner product metrics vary slightly.
If the MVE size you want is not in the list, then there is not enough capacity at the selected location. You can either select another location with enough capacity or contact your Account Manager to discuss requirements.
* **Minimum Term** -- Select No Minimum Term, 12 Months, 24 Months, 36 Months, 48 Months, or 60 Months. Longer terms result in a lower monthly rate. *12 Months* is selected by default. Take note of the information on the screen to avoid early termination fees (ETF).
Enable the [Minimum Term Renewal](/portal-admin/auto-renew/#auto-renew) option for services with a 12, 24, 36, 48 or 60-month term to automatically renew the contract at the same discounted price and term length at the end of the contract. If you don't renew the contract, at the end of the term, the contract will automatically roll over to month-to-month contract for the following billing period, at the same price, without term discounts.
For more information, see [MVE Pricing and Contract Terms](/finance/mve-pricing).
7. Click **Next**.
8. Specify the Versa-specific settings:
* **Director Address** -- Enter the FQDN or IPv4 address of your Versa Director.
* **Controller Address** -- Enter the FQDN or IPv4 address of your Versa Controller.
* **Local Auth** -- Enter the Local Auth string as configured in your Versa Director.
* **Remote Auth** -- Enter the Remote Auth string as configured in your Versa Director.
* **Serial Number** -- Enter the serial number that you used when creating the device in Versa Director.
* **Virtual Interfaces (vNICs)** -- Each MVE is configured with one vNIC named *Data Plane* by default. To change the name, type over the name text in the box. You can also change the vNIC name later, after the MVE has been deployed.
You can add a total of five vNICs to the MVE, including the one added by default. For more information, see [Types of vNIC Connections](/mve/vnic-connections).
To add a vNIC:
1. Click **+ Add**.
2. Enter a name for the vNIC.
If you want to increase or decrease the number of vNICs on this MVE after it has been deployed, you will have to delete the entire MVE and recreate it. You cannot add or delete vNICs on a deployed MVE.
* **Megaport Marketplace** -- By default, each service is private to your enterprise and consumes services from the Megaport network for your own internal company, team, and resources. When set to private, the service is not searchable in the Megaport Marketplace, however, others can still connect to you using a [service key](/marketplace/service-keys). Megaport Marketplace visibility is controlled on your Megaport Marketplace profile. For more information about how to make your service visible to the Megaport Marketplace, see [Adding services to your profile](/marketplace/profile#adding-services-to-your-profile).
9. Click **Next**.
10. Specify optional settings:
* **MVE Name** -- Enter a name for the MVE that is easily identifiable, particularly if you plan on provisioning more than one. This name appears in the Megaport Portal.
The MVE name is auto-generated based on the location name and shown on the Summary page. You can override it by entering your own.
* **Service Level Reference** (optional) -- Specify a unique identifying number for your Megaport service to be used for billing purposes, such as a cost center number, unique customer ID, or purchase order number. The service level reference number appears for each service under the Product section of the invoice. You can also edit this field for an existing service.
* **Resource Tags** -- You can use resource tags to add your own reference metadata to a Megaport service.\
To add a tag:
1. Click **Add Tags**.
2. Click **Add New Tag**.
3. Enter details into the fields:
* **Key** -- string maximum length 128. Valid values are a-z 0-9 \_ : . / \ -
* **Value** -- string maximum length 256. Valid values are a-z A-Z 0-9 \_ : . @ / + \ - (space)
4. Click **Save**.
If you already have resource tags for that service, you can manage them by clicking **Manage Tags**.
Never include sensitive information in a resource tag. Sensitive information includes commands that return existing tag definitions and information that will identify a person or company.
11. Confirm the configuration and pricing on the Summary page.
The monthly rate is based on location and size.
12. Click **Add MVE**.
You are prompted to create a Megaport Internet connection. A Megaport Internet connection provides connectivity and allows MVE to register and communicate with Versa SD-WAN.
**To create the Megaport Internet connection**
1. Click **Create Megaport Internet** to proceed (recommended), or click **Not now** to provision internet access at a later time.
MVE requires connectivity to the internet onto the management plane virtual interface. You can either provision a Megaport Internet connection or configure a third-party internet connection using a private VXC. **We strongly recommend that you create a Megaport Internet connection for the initial MVE startup and deployment to ensure that the MVE is provisioned and functioning correctly**.
2. Select the target Port (the internet router).\
The B-End of a Megaport Internet connection can be anywhere that Megaport Internet is available.\
You can use the **Search** field to find the Port name, Country, Metro City, or address of your destination Port. You can also filter by diversity zone.
3. Click **Next**.
4. Specify the connection details:
* **Connection Name** -- The name of your Megaport Internet connection to be shown in the Megaport Portal.
* **Service Level Reference** (optional) -- Specify a unique identifying number for your Megaport service to be used for billing purposes, such as a cost center number, unique customer ID, or purchase order number. The service level reference number appears for each service under the Product section of the invoice. You can also edit this field for an existing service.
Use the same Service Level Reference numbers for the Megaport Internet connection and MVE to help identify the matching pair in your invoice.
* **Rate Limit** -- The speed of your connection in Mbps. The rate limit is configurable starting from 20 Mbps and can scale to several Gbps or more, in 1 Mbps increments. Available speed tiers might vary by location and service type. You can change the speed as required after you create the Megaport Internet connection. Monthly billing details appear based on location and rate limit.
* **VXC State** -- Select **Enabled** or **Shut Down** to define the initial state of the connection. For more information, see [Shutting Down a VXC for Failover Testing](/connections/shut-down-vxc).
If you select **Shut Down**, traffic will not flow through this service and it will behave as if it was down on the Megaport network. Billing for this service will remain active and you will still be charged for this connection.
* **A-End vNIC** -- Select **vNIC-0** for initial management access.
* **Preferred A-End VLAN** (optional) -- Select **Untagged** to remove VLAN tagging and allow first-time administrative login to the device.
* **Minimum Term** -- Select No Minimum Term, 12 Months, 24 Months, 36 Months, 48 Months, or 60 Months. Longer terms result in a lower monthly rate. *12 Months* is selected by default. Take note of the information on the screen to avoid early termination fees (ETF).
Enable the [Minimum Term Renewal](/portal-admin/auto-renew/#auto-renew) option for services with a 12, 24, 36, 48 or 60-month term to automatically renew the contract at the same discounted price and term length at the end of the contract. If you don't renew the contract, at the end of the term, the contract will automatically roll over to month-to-month contract for the following billing period, at the same price, without term discounts.
For more information, see [Megaport Internet Pricing and Contract Terms](/finance/megaport-internet-pricing) and [VXC, Megaport Internet, and IX Billing](/finance/billing-details).
* **Resource Tags** -- You can use resource tags to add your own reference metadata to a Megaport service.\
To add a tag:
1. Click **Add Tags**.
2. Click **Add New Tag**.
3. Enter details into the fields:
* **Key** -- string maximum length 128. Valid values are a-z 0-9 \_ : . / \ -
* **Value** -- string maximum length 256. Valid values are a-z A-Z 0-9 \_ : . @ / + \ - (space)
4. Click **Save**.
If you already have resource tags for that service, you can manage them by clicking **Manage Tags**.
Never include sensitive information in a resource tag. Sensitive information includes commands that return existing tag definitions and information that will identify a person or company.
5. Click **Next** to proceed to the connection detail summary.
6. Click **Add VXC** to move this configuration to your cart.
7. Repeat these steps to provision any additional VXCs.
8. Click **Review Order** to proceed through the checkout process, or click **Save** to save the configured services before placing the order.
9. Review the Important Information section and confirm agreement with the Service Agreements.
If you do not have a promotion code, skip to the **Order Now** step. If you do have a promotion code, enter it into the **Enter discount code** field then click **Apply**. Alternatively, if a code already appears in the **Discounts** field, verify it is correct and click **Apply**.
The promotional discount appears below the Standard Term discount. This discount is not reflected in the Monthly Rate shown here, it is applied at the time of billing. If an invalid or expired code causes an error with your order, contact your Megaport Account Manager for a replacement code.
If you entered an incorrect promotion code, you can remove it by clicking **Remove**.
10. Click **Order Now**.
Ordering MVE provisions the appliance and assigns IP addresses from the Megaport SDN. The MVE provisioning takes only a few minutes to complete. The provisioning process spins up a Versa FlexVNF.
## Viewing the MVE in the Megaport Portal
After creating the MVE, you can view it in the Megaport Portal on the Services page. You can also view the public IP addresses assigned.
**To view an MVE in the Megaport Portal**
* Go to the **Services** page.
The Megaport Internet icon differs from a standard VXC icon in the Megaport Portal, as shown in the image.
For more information about the Services page, see [Understanding the Services Page](/portal-admin/services-page).
**To view the public IP addresses assigned to the MVE**
1. Click the gear icon next to the Megaport Internet connection.\
The Connection Configuration screen appears. From here, you can modify any of the Megaport Internet connection details.
2. Select the **Details** tab.
3. Locate the public IP address (IPv4 or IPv6).\
These are the public IP addresses assigned to the MVE. Make a note of these addresses for use later.
4. Verify that you see your new MVE device in the Megaport Portal under **Services**.
## Viewing the MVE in Versa Director
After creating the MVE, you can monitor the status in Director. In Director, verify that the new MVE configuration is synchronized, the service is up, and it is reachable.
**To view an MVE in Director**
1. Log in to Versa Director.
2. Select the **Monitor** tab, then select Devices in the horizontal menu.
3. Review the Config Synchronized, Reachability and Service columns.
It can take up to 10 minutes for the MVE to register with Versa Director.
## Next steps
Once the MVE is provisioned with an Active status, the next step is to connect a VXC to a Cloud Service Provider (CSP), a local port, or a third-party network. You can optionally connect a physical Port to the MVE through a private VXC or connect to a service provider in the Megaport Marketplace.
For more information, see [Creating a VXC](/mve/versa/creating-mve-vxc).