VIRL February (virl.1.0.26) release is an upgrade building on the VIRL 1.0.x release.
NOTE - If you have VIRL 1.0.0 or 1.0.11 installed today, you can perform an in-place upgrade.
In-place upgrade from VIRL versions below 1.0.0 is NOT supported. If you are running an earlier release, a new installation image MUST be downloaded and installed. Please refer to http://community.dev-innovate.com/t/virl-1-0-0-november15-release-now-available-for-download/6078 for more information.
Installation images are available for VMware Workstation, Workstation Player, Fusion Pro, and ESXi now. Bare-metal system image will follow.
Please see the section below on Self-Service Downloads for instructions on how to obtain the appropriate installation image.
NOTE - SUPPORT FOR VIRL v1.0.0 and v1.0.11 WILL END ON 4th March. PLEASE UPGRADE AS SOON AS POSSIBLE!
Online training material is available - this is designed to help get you started and productive quickly - VIRL Learning Lab Tutorial - NOTE, this includes video walkthroughs - ensure that your browser supports H.264 video and any plugins are enabled.
Every registered VIRL user is now able to download the OVA and ISO images from https://virl.mediuscorp.com/my-account/. The new 'Download VIRL' link on this page will take you through to a self-service selection page where you are able to select the image you would like.
Please note that the downloads are large. The use of download manager application is strongly recommended.
In-place upgrade instructions
NOTE - you must have communication to a Cisco salt-master and have a valid license key in order to perform the upgrade.
Existing VIRL 1.0.x users are able to upgrade to the latest release by logging into the User Workspace Managment (UWM) interface as 'uwmadmin'. From the menu on the left-hand side of the page, select 'VIRL Server'/'VIRL Software'. After a ~60 seconds a list of available images will be presented. New packages will be shown as available for installation with a tick-box present in the 'Install Y/N' column. Select the package and press the 'Start installation' button.
New Virtual machine images are also available from the 'Cisco VM image upgrades' section of the VIRL Software package. Again, check the appropriate tick-box and press the 'Start installation' button.
Performing a new installation - instructions
Please use the installation guides posted at http://virl-dev-innovate.cisco.com/ and select the instructions appropriate for your platform.
VIRL software component versions
The release contains the following versions:
- Openstack Kilo
- VM Maestro 1.2.5 Build Dev-388 (NEW)
- AutoNetkit 0.21.4/0.21.6 (NEW)
- Live Network Collection Engine 0.8.12 (NEW)
- VIRL_CORE 0.10.22.7 (NEW)
YOU MUST UPDATE YOUR VM MAESTRO CLIENT TO 1.2.5 Dev-388 OR LATER - USING OLDER RELEASES IS NOT SUPPORTED! Download the new VM Maestro client from "http://your VIRL server IP/download". Once installed, update the available node types as follows:
- Launch VM Maestro
- Select 'File / Preferences / Node Subtypes
- Press 'Fetch From Server'
- Press 'Apply'
Platform reference model VMs
- IOSv - 15.6(1)T image
- IOSvL2 - 15.2.4055 DSGS image
- IOSXRv - 6.0.0 image (NEW)
- IOS XRv 9000 - 6.0.0 image (NEW - NOT BUNDLED - click HERE for details)
- CSR1000v - 3.17 XE-based image
- NX-OSv 7.2.0.D1.1(121)
- ASAv 9.5.1
- Ubuntu 14.4.2 Cloud-init
Linux Container images
- Ubuntu 14.4.2 LXC
- iPerf LXC
- Routem LXC
- Ostinato LXC
Bare-Metal installation image (.ISO) - NOTE
The .ISO installer image will install the Ubuntu 14.4.3 operating system as well as all of the software stack for VIRL. Due to space issues, the CSR1000v image is not included in the .ISO installation image. Once VIRL has been installed, your salt-key has been applied and communication established to the Cisco salt-masters, you will be able to install the CSR1000v 3.17 image from the VIRL Software panel in the User Workspace Management interface.Use a Web-browser to log into the User Workspace Management interface and select the 'VIRL Software' tab from the panel on the left. Select the CSR1000v and then press 'Start Installation'.
SALT MASTER SETTINGS
Once you have installed VIRL, apply for VIRL license key as per the installation instructions. Update you salt-master list as follows:
us-1.virl.info, us-2.virl.info, us-3.virl.info, us-4.virl.info
eu-1.virl.info, eu-2.virl.info, eu-3.virl.info, eu-4.virl.info
You should enter at least two hosts picking a number between 1 and 4. Do not enter the same number twice! You can list up to four salt-masters. There must be a ',' and a space between each salt-master.
Bare-metal installation (ISO) - when following the installation instructions and selecting 'LVM' for partition management, the system will report that there is insufficient disk space and that you should increase the size of the /boot partition. THIS MESSAGE CAN BE IGNORED. Press the 'continue' button. The installation will proceed without issue.
Following an upgrade from 1.0.11 to 1.0.23, the following message may be observed when trying to start up a simulation:
(ERROR) [Feb/04/2016 21:14:51] Failed to start simulation "LXC_demo-clsv9_": local variable 'message' referenced before assignment
Workaround: Reboot your VIRL server and please try to start your simulation once more.
IOSv 15.6(1)T - On boot-up the following message may be observed:%SYS-3-CPUHOG: Task is running for (1997)msecs, more than (2000)msecs (0/0),process = TTY Background.-Traceback= 114ECF8z 130425z 15E20Ez 15DF30z 15DD3Dz 157D75z 158A2Bz 1589BFz 159B67z 153672z 3C9740Az 3C868CEz 3C89BEFz 5125F91z 491D86Cz 492E540z - Process "Crypto CA", CPU hog, PC 0x00157D2C
This is cosmetic and can be ignored.
IOSv 15.6(1)T / IOSvL2 15.2(4055) DSGS - CSCuv77089 - CVAC: day0 configuration only partially saved
When booting an IOSv or IOSvL2 instance within VIRL, it will insert the bootstrap configuration into running-config and report the following message:
*Aug 10 15:06:08.555: %CVAC-4-CONFIG_DONE: Configuration generated from file flash3:/ios_config.txt was applied and saved to NVRAM. See 'show running-config' or 'show startup-config' for more details.
The running-config is fully applied. However, the startup configuration only contains partial content.
Workaround: issuing the command 'copy run start' after the device has fully booted, will copy the running-configuration content to the startup-configuration as expected.Note: VIRL's configuration extraction function performs a 'copy run start' operation as part of its execution.
VIRLDEV-3140 - Live Visualization - ping with 50% packet loss - timeout reported
Configured a link with 50% packet loss and use the 'ping from' 'ping to' function. The ping 'failed' reporting the following:
ping 192.168.0.6 source 192.168.0.5
This issue impacts the ping function within the Live Visualisation system but does not impact the regular operation of pings from the VMs themselves.
Workaround: reduce the packet loss on the selected link.
VIRLDEV-3119 - Rehost operation - changing the internalnet_port IP address from 172.16.10.250 results in broken system
Changing the internalnet_port IP address from the default (172.16.10.250) value and then performing the 'vinstall rehost' operation results in an VIRL system which is not operational.
Changing the internalnet_port IP address is NOT supported.
VM Maestro - terminal preference for detached internal terminals - this function has been deprecated in VM Maestro 1.2.4 onwards.
Workaround: you can manual 'tear' the terminal pane from the main VM Maestro window. Use this in conjunction with the VM Maestro preference (Cisco terminal) - "multiple tabs for one simulation".
Virtual Machines and Container images
IOS XRv 6.0.0 - An updated IOS XRv virtual machine is now available and becomes the default IOS XRv instance.
IOS XRv 9000 6.0.0 - This release includes support for the new IOS XRv 9000 virtual router. Due to the size of the VM's disk image, this is not included in the OVA/ISO installation image but must be downloaded separately. Click HERE for details.
Salt-master connectivity check - The Salt Configuration and Status page in UWM now includes a connectivity check report to help diagnose issues between your VIRL server and the first Cisco Salt-master that you've configured your system with. The system checks DNS resolution of the salt-master, pings the salt-master, checks communication on TCP Ports 4505 and 4506 and then confirms that your key has been accepted, resulting in the output as per below:
If a problem is identified, it will result in a 'cross' being reported.
Interface name changes in UWM System Configuration - Users who need to change the name of the interfaces on their VIRL server, or need to operate with a reduced number of interfaces are now able to adjust their VIRL system software via the System Configuration panel.
Users with bare-metal systems may not have interfaces reporting as 'eth0', 'eth1' etc. They may instead see 'p1p3', 'p1p4' etc. The System Configuration panel now includes field for all of the interfaces that can be adjusted to suit your needs. In the example below, the Flat Network Interface is changed from 'eth1' to 'p1p2'.
After pressing the 'Apply' button, the system will be reconfigured to use the new interface names.
NOTE - if you need to operate with a reduced number of interfaces (less than 5), you are able to set the name to 'dummyX' as per the installation instructions.
System Operation check - a new System operation check has been introduced and is available in UWM under the VIRL Server / System status tab. The check performs a series of tests to ensure that your system is in functional state. This includes checking all of the core services as well as starting up a small simulation. The results will confirm if your system is performing as expected or if there are problems, and if so, in which area(s) the problems lie. The tests will take ~5 minutes to complete. Once completed, the detailed results can be downloaded for review.
System TCP port allocation controls - The UWM system configuration panel now offers additional controls under the 'VIRL Services' tab. Users are able to specify the TCP port used by the Apache web-server (which provides the main HTML landing page for the VIRL server) as well as defining the TCP port range to be used by the system when bringing up the Mgmt-LXC instance inside your simulation.
When a Mgmt-LXC is started, an external reachable IP address is assigned as well as a TCP port on the VIRL Server which when accessed using SSH, will be forwarded on to the Mgmt-LXC. Users are the able to SSH to the IP address of the VIRL server using the designed TCP port number and will be connected to the Mgmt-LXC from where you then able to connect to the VMs running inside your simulation
The TCP port range controls enable users working with firewalls to specify a port range from which the forwarded TCP port will be taken.
Download Proxy - user who are operating behind a proxy system are now able to specify the address, authentication and exceptions associated with the use of the proxy. A set of new fields are available in the UWM system configuration panel under the 'Resources' tab. Please work with your network administrator to determine if proxy usage is required.
Direct SSH access from VM Maestro - When using LXCs or Linux servers, VM Maestro's Active Canvas now offers the ability in to select the node, to right-click and to see the option to connect to port 22 (ssh) using the IP address of the node on the Flat or Flat 1 network. In order for this to work, you must have IP access t the Flat or Flat 1 network from the system where VM Maestro is being run.
Visual Traceroute to / from Linux servers and LXCs - The visual traceroute function in Live Visualisation has been extended to enable users to set Linux servers and LXCs as the source and destination of the traceroute.
Traceroute path information display - The visual traceroute function in Live Visualisation draws the path taken between nodes in the network. Once the path 'arrow' has been drawn, a 'mouse over' action will reveal details of the path taken.
VLAN visualisation - When a simulation makes use of the IOSvL2 virtual machine, Live Visualisation is now able to present details of the Vlans in use on a per-interface basis by performing a 'mouse over' action on the interface of the IOSvL2 icon in the diagram. Please see https://youtu.be/nBKIAw4FURU?t=1782 for an overview of the function.
Spanning Tree visualisation - When a simulation makes use of the IOSvL2 virtual machine, Live Visualisation is now able to present details of the Spanning Tree in use in each VLAN. Using a filter function, you're able to select the VLAN
of interest. The diagram then shows the Spanning Tree root node as well as the ports on each IOSvL2 instance that are in forwarding mode towards the root. Please see https://youtu.be/nBKIAw4FURU?t=1847 for an overview of the function.
For details of the features included in VIRL 1.0.11, please refer to the release notes for the VIRL 1.0.11 release at http://community.dev-innovate.com/t/virl-1-0-11-december15-release-now-available-for-download-and-upgrade/6517
Customer defects resolved
The following customer-found defects are resolved in this version of VIRL: