Importing Labs

The Import Lab page supports the import of both CML 2.x .yaml topology files and 1.x .virl topology files.

When importing a .virl topology from a 1.x system, be aware of the following limitations:

  • Images being used in the imported topology may not be available on the CML 2.x system.

  • The network configuration for the imported lab may not match the CML 2.x system and may require further editing.

  • Some images are no longer supported in CML 2.x. For example, the Ostinato node type has been replaced by Cisco TRex.

Tip

CML will attempt to map unsupported node types from a 1.x .virl file to the closest matching node definition. For example, Ostinato drone nodes will become TRex nodes in the imported topology. Note that the import only converts the node to the new node definition. It cannot convert the node’s associated configuration. To ensure that the topology functions as expected, you must check the topology and especially the configuration associated with the nodes. Manually update the configuration of the converted nodes to implement the desired behavior.

Procedure

From the Dashboard, click the Import button.

Click in the File(s) to import field and use the file browser to select one or more topology files to import from your local system.

Click Import.

The topology is imported, and the page displays a message, such as Uploaded as lab abc123.

If you are importing a 1.x .virl file, you may also see warnings, such as

Warnings
Node /lxc-ostinato-drone-1: lxc-ostinato-drone node mapped to trex, manual adaption required!
Node /lxc-1: lxc node mapped to alpine, manual adaption required!

Pay attention to any warnings displayed during import. Warnings indicate that the topology contains features or node types that have changed since version 1.6. You should check the imported topology before running it and make necessary changes to the node configurations, especially for any nodes mentioned in the warnings.

Click Go to Lab to open the newly-imported lab in the Workbench, or click Dashboard to return to that page and see the new lab in the list of labs.