QUICK START GUIDE

OcNOS® VM VirtualBox
Hypervisor Quick Start Guide
6.3.0
June 2023

Contents
About the OcNOS VM............................................................................................................................................... 2

Benefits of the OcNOS VM................................................................................................................................................... 2

Feature List................................................................................................................................................................................ 2
System Features............................................................................................................................................................................................................ 2

Layer-2 Features........................................................................................................................................................................................................... 2

Layer-3 Features........................................................................................................................................................................................................... 2

MPLS Features............................................................................................................................................................................................................... 3

Multicast Features........................................................................................................................................................................................................ 3

Download the Virtual Machine Image.................................................................................................................... 3

Create a New OcNOS VM on VirtualBox Hypervisor........................................................................................ 3

Set up Basic Configuration in the OcNOS VM..................................................................................................... 8

References..................................................................................................................................................................... 9
About the OcNOS VM
The OcNOS Virtual Machine (VM) from IP Infusion helps you get familiar with OcNOS. The OcNOS
VM runs on a standard x86 environment. The OcNOS VM is used to validate configurations and test
L2, L3, and MPLS features at your own pace, with no costs associated. Without bare metal switches,
OcNOS VM can be on popular hypervisors including KVM, VirtualBox, and VMware. This document
provides information on how to create an OcNOS VM in VirtualBox hypervisor.

All basic Layer 2, Layer 3, and multicast functionality are available. MPLS support is also available,
including limited support of MPLS forwarding. The OcNOS VM comes with a 365 days valid license.

The data plane forwarding functions have limited support. OcNOS VM is designed for feature testing,
and not for data plane performance testing or full bandwidth traffic testing.

Benefits of the OcNOS VM

Following are benefits of OcNOS VM:
• Free
• No need to wait for the hardware
• Get familiar with OcNOS software
• Validate configurations
• Test L2, L3, and MPLS features without any risk
• Prototype network operations

Feature List
CLIs for the following features are available. The complete feature set of OcNOS is supported on
hardware platforms such as the whitebox switches from Dell, Delta Agema, Edgecore, and UFISpace.
For the complete feature list, please contact IP Infusion Sales.

SYSTEM FEATURES • VLAN Interface

• ARP support • QinQ
• SSH/Telnet • 802.1x
• SNMP
LAYER-3 FEATURES
• Debugging and logging
• IPv4 Routing
• AAA
• VRF Support
• DHCP, DNS
• RIP v2, RIP NG
LAYER-2 FEATURES • BFD with BGP, OSPF, ISIS
• STP/RSTP/MSTP • BGP
• BPDU Guard and Root Guard • OSPF v2, OSPF v3
• VLAN, Private VLAN • ISIS
• LACP • VRRP
• LLDP

2 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

MPLS FEATURES • BGP MPLS L3VPN
• MPLS Label Switching • MPLS DCI using ICCP and VPLS redundancy
• LDP and RSVP Support
MULTICAST FEATURES
• RSVP FRR
• IGMP
• VPLS with LDP Signaling
• PIM-SM/SSM/DM
• VPWS with 1:1 backup support
• MSDP Support

Download the Virtual Machine Image

The OcNOS VM is available in these virtual environments:

Hypervisor Format
Name
VirtualBox, vmdk.xz
VMware
KVM qcow2.xz

For the KVM hypervisor, download the OcNOS qcow2.xz image. OcNOS VM image file is archive
compressed using XZ compression. Use Mac OS Archive Utility or 7-zip tools to uncompress the file. To
uncompress the file in Linux, use the command xz -d <file_name>.xz.

Create a New OcNOS VM on VirtualBox Hypervisor

Following are steps to create a new OcNOS VM on VirtualBox Hypervisor:

1. Start Virtual Box. Launch the from All Programs submenu Oracle VM Virtual Box.

The Virtual Box window allows you to create a new virtual machine by clicking the New Icon.

• Name: OcNOS-VM
• Machine Folder: leave the default folder
• Type: Linux
• Version: Debian (64 bit)
• Click Continue

3 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

2. Configure the amount of memory to allocate to the virtual machine. The recommended memory
size is 4096 MB. Click Continue.

3. Add a virtual hard disk to the new virtual machine.

• Select Use an existing virtual hard disk drive
• Specify the-VM image path
• Click Create

4 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

4. Select the VM and click Settings.

5. Click Display, click graphics card, select VBoxVGA Graphics Controller, and click OK.
(OcNOS does not support the VMSVGA graphic controller in Oracle VirtualBox. Select either
VBoxVGA in the display settings.)

Now you can see VBoxVGA shown as Graphics Controller.

5 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

6. Set up the network adapters:
a. Management port: Select Settings > Network > Adapter 1 and set values:
• Choose the adapter setting as Bridge Adapter
• Choose the port to appropriate Management NIC port for the hypervisor as shown below and
click OK

7. Add data ports: adapters 2, 3, and 4 are used for data ports. Set up a virtual network that the
host-only adapter(s) will communicate through.
a. Click File > Host Network Manager > Create.
b. Check Enable under the DHCP Server column of the network you just created.

c. Click Close.

6 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

8. Configure the network adapters for data ports:
a. With the OcNOS VM selected in the VirtualBox console, click Settings > Network.
In the Adapter 2, 3, and 4 tabs, check Enable Network Adapter:
b. For Attached to for each adapter, select Host-Only Adapter or data port NIC.
c. In the Name field, select the virtual network you created in the previous step.

d. Click OK

9. Start the VM by double-clicking it in the list or by selecting it and clicking Start.

10. Click Start icon and the click Show as shown below. This will provide you console to the newly
created OcNOS VM.

7 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

Set up Basic Configuration in the OcNOS VM
Following are steps to setup basic configuration in OcNOS VM so that we can connect to the OcNOS
VM via SSH. This enables us to further configure various features and test them.

1. Log in using the following credentials from the console:

• Username: ocnos
• Password: ocnos
This displays the OcNOS shell prompt.

2. Enter the following commands:

• Enter enable mode
OcNOS>en
• Enter configuration mode:
OcNOS#conf t
• Two options to configure the management port:
If you have a DHCP server in your network, use the following commands:
OcNOS (config)# int eth0
OcNOS (config-if)# ip address dhcp
OcNOS (config-if)# exit
OcNOS (config)# commit
OcNOS (config) #exit
Otherwise manually configure the IP address using the following commands:
OcNOS (config)# int eth0
OcNOS (config-if)# ip address 10.12.44.120/24
OcNOS (config-if)# exit
OcNOS (config)# commit
OcNOS (config) #exit

8 | OcNOS® VM VIRTUALBOX HYPERVISOR 6.3.0 QUICK START GUIDE

3. Check the IP address assigned to the OcNOS VM using the following command:

In this example, 10.10.27.162 is the IP address of the newly created VM in VirtualBox.

4. Using the IP address, you can connect to the VM via ssh as follows below using ocnos userid and
ocnos password.
% ssh [email protected]
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added ‘10.10.27.162’ (ED25519) to the list of known
hosts. [email protected]’s password:
Linux OcNOS 4.19.91-g37f56f98f #1 Fri Oct 16 09:13:49 UTC 2020 x86_64
Last login: Mon Jun 12 16:37:15 2023
OcNOS version DEMO_VM-OcNOS-6.3.0.126-SP_MPLS-x86_-GA 06/02/2023 17:30:26
OcNOS>
Now you can configure and test the newly created VM.

References
The following are reference materials related to OcNOS:
• OcNOS Configuration Guides

ABOUT IP INFUSION
IP Infusion is a leading provider of open network software and solutions for carriers, service providers and data center operators. Our solutions enable network operators to
disaggregate their networks to accelerate innovation, streamline operations, and reduce Total Cost of Ownership (TCO). Network OEMs may also disaggregate network devices
to expedite time to market, offer comprehensive services, and achieve carrier grade robustness. IP Infusion network software platforms have a proven track record in carrier-
grade open networking with over 500 customers and over 10,000 deployments. IP Infusion is headquartered in Santa Clara, Calif., and is a wholly owned and independently
operated subsidiary of ACCESS CO., LTD. Additional information can be found at http://www.ipinfusion.com

© 2023 IP Infusion, Inc. All rights reserved. IP Infusion is a registered trademark and the ipinfusion logo and OcNOS are trademarks of IP Infusion, Inc. All other trademarks
and logos are the property of their respective owners. IP Infusion assumes no responsibility for any inaccuracies in this document. IP Infusion reserves the right to change,
modify, transfer, or otherwise revise this publication without notice.

Phone | +1-877-699-3267 Email | [email protected] Web | www.ipinfusion.com