How to install a license in OcNOS?

[stordis-toc]

Introduction

Welcome to the STORDIS Support Portal guide! 

Need help with installing OcNOS license? This article explains how to install a license on an existing OcNOS device. You can install an OcNOS license through three different methods: via HTTP, FTP, or by mounting a USB storage device.

Prerequisites

• A valid OcNOS license file
• Network connectivity (for HTTP/FTP methods)
• Administrative access to the OcNOS device
• USB drive (for USB method)
• Installed TFTP server (TFTP method)

In order for any installation method to work you first need to release the license that comes with installed OcNOS system:
 

OcNOS# license release

Method 1: Installing License via HTTP

   STEP 1: Place your license file on an HTTP server accessible from your OcNOS device

   STEP 2: Log in to the OcNOS device with admin privileges

   STEP 3: Enter the following command:

license get http://<server-ip-address>/path/to/license-file

   STEP 4: Verify the license installation:

OcNOS# show license

Method 2: Installing License via FTP

   STEP 1: Ensure your license file is available on an FTP server. If you don't have an FTP server yet, please refer to: 
   How to set up the FTP server (vsftpd) on Ubuntu 20.04? – STORDIS Open2Support & Open2Knowledge Portal

   STEP 2: Log in to the OcNOS device with admin privileges

   STEP 3: After you have configured the server properly, you can download the license like this:
 

license get ftp://{USERNAME}:{FTP_PASSWORD}@{IP_ADDRESS}/{PATH_TO_FILE}

Method 3: Installing License via USB stick

   STEP 1: You need to have a usb stick with OcNOS license on it. It must have filesystem in FAT32 or otherwise            this method may not work (it certainly won't with NTFS).

   STEP 2: Turn on the switch and select the OcNOS from the GRUB menu.

   STEP 3: Login to OcNOS via root login and password:

   STEP 4: Mount the USB

   In order to do this we need to first use the fdisk -l command to check for the disks attached to your system

   In my case it will be the /dev/sdc. In order to check which one is the usb stick, you can plug it in, run the 

   fdisk -l, unplug it and run the command again - look for the disk that appears only on the first command run.
   You need to create the mount point like this:

mkdir /mnt/usb

     Now that we have the disk we can mount it - we do it by executing the command 

mount {DISK_NAME} /mnt/usb

     For example

mount /dev/sdc /mnt/usb

   After confirming that we have mounted it we can exit from the root account and proceed to ocnos user.
   STEP 5: Installation of license

   Login with login: ocnos and password: ocnos and type in  

license get file:///mnt/usb/{LICENSE_FILE}

   Triple slash is not an error.

Method 4: Installing License via TFTP

   STEP 1: Setup the TFTP server on your machine

   You can install and enable it by using the following commands:
 

sudo apt install tftpd-hpa -y
sudo systemctl enable tftpd-hpa

   STEP 2: Move the license to tftp folder and allow the access via chmod:

cp {LICENSE_FILE} /{YOUR_TFTPFOLDER}/
sudo chmod 644 /{YOUR_TFTPFOLDER}/{LICENSE_FILE}

  STEP 3: Install the license on the OcNOS switch:

license get tftp://{IP_ADDRESS}:{PORT}/{PATH_TO_YOUR_TFTPFOLDER}/{LICENSE_FILE}

Summary

If you want to explore more topics, be sure to check out our other guides, including:

Running OcNOS VMs in GNS3 Quick Start Guide

For more free resources, visit: https://stordis.com/free-resources/