Installing License under Linux prompt
PICOS can be installed on bare metal switches listed in Switch Machine Outline and System Characteristics. A software license is needed to activate PICOS on the specific switch it is installed on.
Please refer to page License Portal Guide, to see how to download licenses for switches.
Terminology
The following terms are used throughout this section:
- Bundle: This license includes all PICOS features. That is, it bundles all three licenses.
- Evaluation License: There is no evaluation license because users can evaluate PICOS without a license. Please note that only the first four switch ports (and the management port) are active without a license.
- Hardware ID: Hardware ID is needed when users download a license. Users can view their own switch ID by executing the license show command license -s.
- Mode: There are two license modes: switch license and site license.
- Type: There are two speed types: 1G and 10G.
PICOS License Types
PICOS includes two types of licenses: Enterprise License and SDN License. Different types of licenses contain different available features. You can purchase the appropriate license according to the network requirements.
Enterprise License
The Enterprise License contains all the features of PICOS, and if you purchase the Enterprise license, all the PICOS features can be applied, which are divided into three types of features: Base Feature, Layer 3 Feature and OpenFlow Feature.
Base Feature
The following features are available as part of the Base feature:
- Network Linux
- Layer 2 (STP/RSTP/MSTP, LLDP, LACP, IGMP-Snooping, dot1x, sFlow, UDLD)
- Multi-chassis Link Aggregation (MLAG)
- Simple Network Management Protocol (SNMP)
- Security
- Zero Touch Provisioning (ZTP)
- Static Routes
Layer 3 Feature
The following features are available as part of the Layer3 feature:
- Open Shortest Path First (OSPF)
- Border Gateway Protocol (BGP)
- Protocol-Independent Multicast (PIM)
- Network Address Translation (NAT)
- Virtual Extensible LAN (VXLAN)
- VRRP (Virtual Router Redundancy Protocol)
OpenFlow Feature
The following features are available as part of the OpenFlow feature:
- Open vSwitch Database Management Protocol (OVSDB)
- OpenFlow Releases 1.3 and 1.4
- Multi Protocol Label Switching (MPLS)
- CrossFlow
- Virtual Extensible LAN (VXLAN)
SDN License
The SDN license only includes the OpenFlow feature, and only the OpenFlow feature can be applied with the purchase of an SDN license.
OpenFlow Feature
The following features are available as part of the OpenFlow feature:
- Open vSwitch Database Management Protocol (OVSDB)
- OpenFlow Releases 1.3 and 1.4
- Multi Protocol Label Switching (MPLS)
- CrossFlow
- Virtual Extensible LAN (VXLAN)
Available Ports without Installing a License
If there is no license installed, only the first four ports and the first two uplink ports (if exist) of the switch are available. The first four ports and the first two uplink ports (if exist) should support to enable any protocol whether there is a license or not. This is also the perfect way to test PICOS without buying a full license.
Note that without a license installed, only the first four physical ports and the first two uplink ports (if exist) can be used, not logical ports. If the first two uplink port is split into four interfaces, available ports for Pica8 switches are listed in Table 1 if no license is installed or the license is expired.
Table 1. Available Ports for Pica8 Switches when no License is Installed
Devices | Available Ports |
AS4610 Series Switches | ge-1/1/1, ge-1/1/2, ge-1/1/3, ge-1/1/4 te-1/1/1,te-1/1/2 |
AS5712_54X, AS5812_54T, AS5812_54X, S4048-ON, S4128F-ON, S4148F-ON, S4148T-ON | te-1/1/1, te-1/1/2, te-1/1/3, te-1/1/4 (xe-1/1/1.1, xe-1/1/1.2, xe-1/1/1.3, xe-1/1/1.4 after breakout) (xe-1/1/2.1, xe-1/1/2.2, xe-1/1/2.3, xe-1/1/2.4 after breakout) |
AS7712_32X, Z9100-ON | xe-1/1/1 (xe-1/1/1.1, xe-1/1/1.2, xe-1/1/1.3, xe-1/1/1.4 after breakout) xe-1/1/2 (xe-1/1/2.1, xe-1/1/2.2, xe-1/1/2.3, xe-1/1/2.4 after breakout) xe-1/1/3 (xe-1/1/3.1, xe-1/1/3.2, xe-1/1/3.3, xe-1/1/3.4 after breakout) xe-1/1/4 (xe-1/1/4.1, xe-1/1/4.2, xe-1/1/4.3, xe-1/1/4.4 after breakout) |
AS7816_64X, Z9264F-ON | xe-1/1/1 (xe-1/1/1.1, xe-1/1/1.2, xe-1/1/1.3, xe-1/1/1.4 after breakout) xe-1/1/2 xe-1/1/3 (xe-1/1/3.1, xe-1/1/3.2, xe-1/1/3.3, xe-1/1/3.4 after breakout) xe-1/1/4 |
Speed
There are two speeds available for each license.
- 1GE: Platform with 48 x 1GE OR 48 x 1GE + 4 x 10GE ports
- 10GE: Platform with 48 x 10GE + 4 x 40GE OR 48 x 10GE + 6 x 40GE OR 32 x 40GE ports
Mode
- Switch: Use this to install a license on a single switch only.
- Site: Use this to install the same license on all switches at a site.
Accessing Hardware ID
User must have the hardware ID available to download a license. A utility generates hardware ID using the license -s command in PICOS OVS mode.
admin@PicOS-OVS$license -s No license installed. Use below information to create a license. Type: 1GE Hardware ID: E385-FB53-4D57-05EB
Installing the License
If no license is installed, only the first four ports and the first two uplink ports (if exist) of the switch are available after the upgrade. To upgrade the switch without production impact, user should install a license before the upgrade.
It is possible to install a license in PICOS 2.3 (starting with PICOS 2.3.3).
To upgrade a switch from a PICOS version earlier than 2.3, it may be necessary to upgrade to PICOS 2.3 first to install a license on the system. To avoid this step, user can run a script that can install the license on PICOS releases earlier than 2.3. Please contact Pica8 support or look at the section below for older PICOS releases.
The license file cannot name pica.lic, or license will install failed.
Customers can download the generated license file and copy it to the /etc/picos/ directory.
The following example shows the contents of a switch-based license file:
{ "Type": "1GE", "Feature":["Open Flow", "Base Product", "Layer3"], "Hardware ID":"8A68-A7AC-D702-70D2", "Expire Date":"2020-10-28" }
In the license file shown above, the type is 1GE while the feature is Base Product, Layer3, and Open Flow. Hardware ID is unique to every switch.
The switch cannot upgrade to a PICOS version whose build date is later than the license expiration date.
The following example shows the contents of a site-based license file:
{ "Type": "1GE", "Feature":["Open Flow", "Base Product", "Layer3"], "Mode":"site", "Site Name":"CompanyA", "Expire Date":"2020-10-28" }
The license file can be installed with the command-line utility called license with the -i option. The following example installs a license file named js.lic:
admin@XorPlus$cd /etc/picos admin@XorPlus$ls -l total 32 drwxrwxr-x 2 root xorp 4096 Feb 4 22:00 ./ drwxrwxr-x 60 root xorp 4096 Feb 4 21:56 ../ -rw-rw-r-- 1 root xorp 26 Feb 4 18:27 fs_status -rw-r--r-- 1 root root 399 Feb 4 21:59 js.lic -rw-rw-r-- 1 root xorp 247 Sep 4 2014 license.conf -rw-rw-r-- 1 root xorp 183 Aug 10 2014 p2files.lst -rw-rw-r-- 1 root xorp 488 Feb 4 18:28 picos_start.conf -rw-r--r-- 1 root root 251 Feb 4 22:00 public.key admin@XorPlus$sudo license -i js.lic License successfully added, the switch need to be rebooted to activate the license. admin@XorPlus$ls -l total 32 drwxrwxr-x 2 root xorp 4096 Feb 4 22:00 ./ drwxrwxr-x 60 root xorp 4096 Feb 4 21:56 ../ -rw-rw-r-- 1 root xorp 26 Feb 4 18:27 fs_status -rw-rw-r-- 1 root xorp 247 Sep 4 2014 license.conf -rw-rw-r-- 1 root xorp 183 Aug 10 2014 p2files.lst -rw-r--r-- 1 root root 382 Feb 4 22:00 pica.lic -rw-rw-r-- 1 root xorp 488 Feb 4 18:28 picos_start.conf -rw-r--r-- 1 root root 251 Feb 4 22:00 public.key -rw-r--r-- 1 root root 251 Feb 4 22:00 switch-public.key admin@XorPlus$
If the license is installed successfully, after license -i command, the following message will be displayed:
License successfully added, the switch need to be rebooted to activate the license.
To activate the new license, the switch must be restarted.
Troubleshooting License Installation
User may encounter various problems during license installation as detailed below.
- The public.key file cannot be found.
admin@XorPlus$sudo license -i js.lic Install failed: Cannot find public key.
- The license file does not exist.
admin@XorPlus$sudo license -i js.lic Install failed: No such file or directory.
- The header or the key is disrupted.
admin@XorPlus$sudo license -i js.lic Install failed: License or KEY is disrupted.
- The license format is not valid.
admin@XorPlus$sudo license -i js.lic Install failed: License format error.
- The license file is not compatible with the switch (verify failed).
admin@XorPlus$sudo license -i js.lic Install failed: Invalid license.
Displaying License Information
User can display the license information using the license -s command at the Linux shell.
The following example displays information about the switch-based license:
admin@XorPlus$license -s { "Type": "1GE", "Feature": ["Open Flow", "Base Product", "Layer3"], "Expire Date": "2020-10-28", "Hardware ID": "8A68-A7AC-D702-70D2" }
The following example displays information about the site-based license:
admin@XorPlus$license -s { "Type": "1GE", "Feature": ["Base Product", "Layer3", "Open Flow"], "Expire Date": "2020-10-28", "Hardware ID": "8A68-A7AC-D702-70D2", "Site Name": " CompanyA " }
If the license is not valid, the license -s command generates the following output:
admin@XorPlus$license -s Invalid license. Use below information to create a license. Type: 1GE Hardware ID: 8A68-A7AC-D702-70D2 admin@PicOS-OVS$
If no license is installed, the license -s command generates the following output:
admin@XorPlus$license -s No license installed. Use below information to create a license. Type: 1GE Hardware ID: 8A68-A7AC-D702-70D2 admin@PicOS-OVS$
Removing a License
User can use the license -r command at the Linux shell to remove a license as detailed below:
admin@XorPlus$cd /etc/picos admin@XorPlus$ls -l total 32 drwxrwxr-x 2 root xorp 4096 Feb 4 22:00 ./ drwxrwxr-x 60 root xorp 4096 Feb 4 21:56 ../ -rw-rw-r-- 1 root xorp 26 Feb 4 18:27 fs_status -rw-rw-r-- 1 root xorp 247 Sep 4 2014 license.conf -rw-rw-r-- 1 root xorp 183 Aug 10 2014 p2files.lst -rw-r--r-- 1 root root 382 Feb 4 22:00 pica.lic -rw-rw-r-- 1 root xorp 488 Feb 4 18:28 picos_start.conf -rw-r--r-- 1 root root 251 Feb 4 22:00 public.key -rw-r--r-- 1 root root 251 Feb 4 22:00 switch-public.key admin@XorPlus$pwd /etc/picos admin@XorPlus$ admin@XorPlus$license -r admin@XorPlus$ls -l total 28 drwxrwxr-x 2 root xorp 4096 Feb 4 22:05 ./ drwxrwxr-x 60 root xorp 4096 Feb 4 21:56 ../ -rw-rw-r-- 1 root xorp 26 Feb 4 18:27 fs_status -rw-rw-r-- 1 root xorp 247 Sep 4 2014 license.conf -rw-rw-r-- 1 root xorp 183 Aug 10 2014 p2files.lst -rw-rw-r-- 1 root xorp 488 Feb 4 18:28 picos_start.conf -rw-r--r-- 1 root root 251 Feb 4 22:00 public.key -rw-r--r-- 1 root root 251 Feb 4 22:00 switch-public.key admin@XorPlus$
If the license is modified or removed, the switch must be rebooted for the change to be effective.
License Update on Older Releases
To upgrade a switch to PICOS 2.4 from a version earlier than 2.3, it may be necessary to upgrade to PICOS 2.3 first and install a license on the system. To avoid this extra step, user can install a new script on PICOS releases prior to 2.3 and use the script to install a license.
This new script supports the PICOS releases 2.1, 2.2, and 2.3. User has to follow the following steps to install a license using the script:
- Download the file named license-powerpc.bin or license-powerpcspe.bin according to the switch model. For example, download the file license-powerpc.bin for the Pica8 P-3290 switch.
- Run the command ./license-powerpc -s to display the hardware ID.
- Copy the upgrade.sh script from https://github.com/Pica8/Upgrade to the switch.
- Copy the license tool from http://www.pica8.com/portal/standard/ to the switch. The tool can be used to install a license on PICOS 2.3 or earlier but the license will only become effective after upgrading to PICOS 2.4 or later.
The Pica8 P-3290 and P-3295 use the license-powerpc file. All other PICOS switches use the license-powerpcspe file.
The following example describes how to upgrade a Pica8 P-3297 switch from PICOS 2.3.
Step 1: Check the version of PICOS using the version command at the Linux shell.
admin@XorPlus$version Copyright (C) 2009-2014 Pica8, Inc. =================================== Hardware Model : P-3297 PicOS Version : 2.3.2S2 Software Revision : 15911
Step 2: Copy license tool:
admin@XorPlus$cd /etc/picos admin@XorPlus$ls -l total 20 drwxrwxr-x 2 root xorp 4096 Jun 29 08:01 ./ drwxrwxr-x 60 root xorp 4096 Jun 29 08:03 ../ -rw-rw-r-- 1 root xorp 26 Jun 29 08:01 fs_status -rw-rw-r-- 1 root xorp 183 Jun 30 2014 p2files.lst -rw-rw-r-- 1 root xorp 488 Jun 29 08:01 picos_start.conf admin@XorPlus$
Step 3: Copy public.key, license.conf and license to /etc/picos:
admin@XorPlus$ls -l total 132 drwxrwxr-x 2 root xorp 4096 Jun 29 08:09 ./ drwxrwxr-x 60 root xorp 4096 Jun 29 08:03 ../ -rw-r--r-- 1 root root 354 Jun 29 08:09 1GE-SITE-PICA8.lic -rw-rw-r-- 1 root xorp 26 Jun 29 08:01 fs_status -rwxr-xr-x 1 root root 98575 Jun 29 08:08 license-powerpc* -rw-rw-r-- 1 root xorp 183 Jun 30 2014 p2files.lst -rw-rw-r-- 1 root xorp 548 Jun 29 08:07 picos_start.conf -rw-r--r-- 1 root root 251 Jun 29 08:07 public.key admin@XorPlus$./license-powerpc -s No license installed. Use below information to create a license. Type: 1GE Hardware ID: A326-8F2D-3661-AE76 admin@XorPlus$
Step 4: Install license:
admin@PicOS-OVS$sudo ./license-powerpcspe -i 1GE-SITE-PICA8.lic License successfully added, the switch need to be rebooted to activate the license. admin@PicOS-OVS$
Add License Directly From License Command
User can also add the license directly from the license command. The PICOS 2.6 image supports this command.
Step 1: Paste the license content.
Step 2: Press enter and then press crtl+d.
Example for P5401, add a site license:
admin@PicOS-OVS$sudo license -i - sJXhrpDdd2ZsMemcJ26fqvjjw7vH30gf/4OVtLsROgPNl2VjFQhIJvS3zliF+DK+ tW2QpssH0JB4n8ae9/SumsRWdwdPpbQNB1WaeNq0onWdoTRz2HGiH+XudDAm6B37 kQvCGev7pAe0tCjnB+63F3Z5ZGPbQE89/fNSBGkE6mfZ6dG1F/86C9Bn/MyqkQSI 4uDtRwfo46elZOmwn5aD/mGyh/i2qg8IfhssIn0CbHVaJY8hyt7tYuvgkEb6Xlhx 7i9+qnk9c15ksBdak0f8gxorZDOCacwWACDt/K8NJokOMWTDLnLmDczrXO0Z5l75 eGc7ZygxCjd/jzc5oW9cgIyd License successfully added, the switch need to be rebooted to activate the license. admin@PicOS-OVS$
Reboot system and license can be activated.
Copyright © 2024 Pica8 Inc. All Rights Reserved.