6.1. Introduction

6.1. Introduction
	Chapter 6. Licencing

Abilis version 8.0 requires an explicit licence with validity for version 8.x or more.
If a remote upgrade to version 8.0 is tried and if a valid license for the version 8 is missing, this will not be loaded, and the last successfully booted version will be started.
If the only firmware available belongs to the version 8, it will only allow to load a valid licence.

6.1.1. ABILIS ID and the class of product

Each Abilis CPX has unique identifier which is visible on the serial number label.

It's easy to retrieve this identifier from a remote Abilis using the commands d i or d g. The identifier is named ABILIS-ID.

[16:02:36] ABILIS_CPX:d i

     Abilis CPX - Ver. 8.0.2/STD - Build 3961.6 - Branch 8.0 - 01/04/2015     
                            (c) 1994/2015 - Abilis                            

ABILIS-ID: 800733

Free/Total Memory (in byte): 117,539,120/260,046,848
Free/Used/Total HD/CF space (in Kibyte): 97,844/26,604/124,448
...


[16:04:14] ABILIS_CPX:d g

...
ABILIS-ID: 800733                                                     <Read Only>

The ABILIS-ID indicates the class of the product followed by its Serial/Number.

Other features may be added purchasing additional licences and installing them using the steps in the chapter Section 6.1.2, “Managing licences”.

The identification of the class is easy:

Table 6.1. Abilis ID and class of products

Number of digits of ABILIS ID	Class of product
5 or less than 5	0 (legacy production)
6	identified by the first, leftmost, number
7	identified by the first two digits, leftmost, number

Examples:

ABILIS-ID: 2001 or ABILIS-ID: 50002 are of class 0
ABILIS-ID: 300049 has class 3, ABILIS-ID: 100031 has class 1
ABILIS-ID: 1600240 has class 16, ABILIS-ID: 1400031 has class 14

	Note
	If there's no ABILIS-ID, it means that Abilis is not equipped with MFIDE device and so it belongs to FP class.

Below there is a table showing the Abilis CPX product classes.

Table 6.2. Class of products

Class	Product	Basic devices included
FP	Former Mini-Abilis	FPANEL
0	Former Abilis Base-x	MFIDE2/MFIDE3
1	Micro-Abilis	MFLPC, BRI4-POTS4 (BS44) or BRI8-ELTI (BS832)
2	Nano-Abilis	MFLPC, MiniBRI1 (BR1)
3	Abilis Base-J	MFIDE3
4	Mini-Abilis	MFIDE3
5	Compact-Abilis	MFPCI, ETH3-BRI4-POTS8 (BS48)
6	Abilis Base-K	MFIDE3
7	PicoAbilis	MFPCMCIA, VoIP (POTS)
8	Micro-Abilis-C3	MFPCIGT, ETH2-BRI4-POTS4 (BS44) or ETH2-BRI4-POTS4-ELTI (BS436)
12	Abilis Base-P	MFLPT
13	Abilis Base-Q	MFLPT
14	Abilis Base-I and Base-Y	MFIDE3
15	Abilis Base-N	MFIDE3
16	Pico-Abilis ELTI	MFLPT, ETH2-ELTI
17	Micro-Abilis-C3 Low Cost	MFPCIGT, ETH2-BRI4-POTS4 (BS44) or ETH2-BRI4-POTS4-ELTI (BS436)
18	Abilis Base-D	MFLPT
22	Abilis Base-D Low Cost	MFLPT

	Caution
	The support of several Abilis models have been discontinued starting with release 8: Nano-Abilis with Geode CPU Micro-Abilis with Geode CPU Compact-Abilis with Atom CPU Former Abilis Base-x equipped with MFIDE2 Former Mini-Abilis

Here's a table showing Classes and licenced features.

Table 6.3. Licenced features

Feature	Description	Class 0/6/13/15	Class 4/7/8/16/17/18	Class 3	Class 5	Class 12/14	Class 22	Extended	VMX
DATACOMP	Data compression service
VMX	VMX system								YES
IPLB	IP Load Balancing service	YES				YES		YES	YES
MULTILINK	Resources over Multi-Links	YES						YES	YES
LCS	Last Calling number service	YES						YES	YES
SOFTPBX	Soft-PBX service (OPC, Address Book, Click&Call, ...)	YES						YES	YES
GPS	GPS resources	YES
ACNT	Accounting service	YES						YES	YES
TRFA	Traffic Analyzer	YES						YES	YES
OSPF	Open Shortest Path First protocol	YES
FTPSRV	FTP server	YES	YES	YES	YES	YES	YES	YES	YES
SMTP	SMTP resource	YES				YES		YES	YES
POP3	POP3 resource	YES						YES	YES
RADIUS	RADIUS resource	YES						YES	YES
VRRP	VRRP resource	YES
POEAC	PPP Over Ethernet Access Concentrator	YES						YES	YES
ARCHIVE	Archive resource	YES						YES	YES
CTIDISA	CTI DISA service	YES						YES	YES
CTIIAX	CTI IAX service	YES	YES	YES	YES	YES	YES	YES	YES
CTISIP	CTI SIP service	YES	YES	YES	YES	YES	YES	YES	YES
CTISMS	CTI SMS service	YES						YES	YES
AIPT	Number of AIPT (Abilis tunnel) resources [0, 1..250]	250	2	4	4	4	2	32	32
IKEHOSTS	Number of IKE hosts [0, 1..128] (IPSEC/IKE resources)	128	1	2	1	2	0	4	4
CTIVR	CTIR Voice Recorder service (requires SoftPbx)
IPSH	IP traffic shaping service
LDAP	LDAP service
SWAC	Number of SWAC channels [0, 1..255]
SIPBLF	Busy Lamp Field for SIP
VS	Videosurveillance
ABILISPHONE	ABILISPHONE users
PCPHONE	Pc-Phones users in CTIP
NPVEXT	New Packet Voice Extended
CHAT	Number of CHAT (XMPP) users [0, 1..1023]

6.1.2. Managing licences

A licence is a text file whose name contains the ABILIS ID (e.g. LIC1-0000002001.TXT). It can be also a mail with the text of the licence file.

There are three way to install a license:

Upload the text file in the directory C:\LICENCE of the Abilis CPX compact flash using FTP (please refer to Chapter 34, FTP - File Transfer Protocol )
Upload the text file in the directory C:\LICENCE of the Abilis CPX compact flash using the command licence put for XMODEM or the command licence put z for ZMODEM (please refer to chapter Section 5.13.6, “FILE PUT” )
Copy and paste the licence text using the command licence set

[19:49:27] ABILIS_CPX:licence SET

Please enter the licence data and terminate with CTRL+Z + ENTER
(type CTRL+C + ENTER to abort):

Tcvk+otc1AmdPyqOXloJj0oZ3LXR/dkJrv1rQl0YyA6lG6by5rvyqdOYTxDoi1i8
ul2pW0BE9sOG1ansjjDAqInA0AoNZ19FgkzJAAi5StsLOsYze/OJZ13Bh+J9Zj/9
M/lCIepQJY4jvcALWddkVlY1O0I4xfCzOdNyTnODhsVl9wpl5fibZvaLnG+c5Jnt
prsOHu+xhfnnoBXyTjkt0SHvg0druqg39SVzKtOxd4YGSO646NfhgXrYLcjVPgPl
eRFmluzTTZtUQpQGYFmh5QWel6cyvVj9Ka5MxrSoStiOdeAnte71D8N6CluJxPYY
iS1KHVzl4zGfp2ADXE778Q==


RECEIVED LICENCE CHECK AND SAVING IN PROGRESS... CHECK PASSED
RECEIVED LICENCE SAVED

[19:49:48] ABILIS_CPX:

Managing licences is easy trough the Abilis CP using the following commands:

[19:49:48] ABILIS_CPX:licence ?

COMPARE        Compare ACTIVE licence and STORED licence
DISPLAY        Display licences or permissions
GET            Download ACTIVE licence or STORED licence file
PUT            Upload STORED licence file
SET            Enter STORED licence value

[19:54:04] ABILIS_CPX:licence compare ?

LICENCE COMPARE                      Compare ACTIVE and STORED licences

[19:54:11] ABILIS_CPX:licence display ?

LICENCE DISPLAY                      Display ACTIVE licence and compare it
                                     with the STORED licence
LICENCE DISPLAY ACTIVE               Display ACTIVE licence
LICENCE DISPLAY FILE                 Display STORED licence
LICENCE DISPLAY PERMISSIONS          Display ACTIVE permissions and compare
                                     them with the STORED ones
LICENCE DISPLAY PERMISSIONS ACTIVE   Display ACTIVE permissions
LICENCE DISPLAY PERMISSIONS CLASS    Display permissions pertaining to Abilis
                                     Class Id.
LICENCE DISPLAY PERMISSIONS FILE     Display STORED permissions

[19:54:22] ABILIS_CPX:licence get ?

ACTIVE         Download ACTIVE licence
FILE           Download STORED licence file

[19:54:35] ABILIS_CPX:licence set ?

LICENCE SET                          Receive licence file from the keyboard

You can display the enabled features by the current licence using the command:

[19:55:12] ABILIS_CPX:licence display permissions

ACTIVE PERMISSIONS:

-------------|-----------|-----------------------------------------------------
Name         |Value      |Description                                          
-------------|-----------|-----------------------------------------------------
ABILISID     |800733     |Abilis CPX serial number                             
EXPIRY       |20151231   |Licence expiration date YYYYMMDD                     
MAXVER       |8          |Licence is valid up this Abilis major version        
-------------|-----------|-----------------------------------------------------
DATACOMP     |YES        |Data compression service                             
IPLB         |YES        |IP Load Balancing service                            
LCS          |YES        |Last Calling number service                          
MULTILINK    |YES        |Resources over Multi-Links                           
SOFTPBX      |YES        |Soft-PBX service (OPC, Address Book, Mixer, Voice Mai
                          l, CtiAS)                                            
VMX          |YES        |VMX system                                           
GPS          |YES        |GPS resources                                        
ACNT         |YES        |Accounting service                                   
TRFA         |YES        |Traffic Analyzer                                     
OSPF         |YES        |Open Shortest Path First protocol                    
FTPSRV       |YES        |FTP server                                           
SMTP         |YES        |SMTP resource                                        
POP3         |YES        |POP3 resource                                        
RADIUS       |YES        |RADIUS resource                                      
VRRP         |YES        |VRRP resource                                        
POEAC        |YES        |PPP Over Ethernet Access Concentrator                
ARCHIVE      |YES        |Archive resource                                     
CTIDISA      |YES        |CTI DISA service                                     
CTIIAX       |YES        |CTI IAX service                                      
CTISIP       |YES        |CTI SIP service                                      
CTISMS       |YES        |CTI SMS service                                      
AIPT         |250        |Number of AIPT (Abilis tunnel) resources [0, 1..250] 
IKEHOSTS     |128        |Number of IKE hosts [0, 1..128] (IPSEC/IKE resources)
CTIVR        |YES        |CTIR Voice Recorder service (requires SoftPbx)       
IPSH         |YES        |IP Shaping service                                   
LDAP         |YES        |LDAP service                                         
SWAC         |MAX        |Maximal number of SWAC [0, 1..255]                   
SIPBLF       |YES        |Busy Lamp Field service for SIP                      
VS           |YES        |Video-Surveillance service                           
ABILISPHONE  |MAX        |Abilisphone2 or CtiVo channels (requires SoftPbx) [0,
                           1..1023]                                            
PCPHONE      |400        |Number of Pc-Phones [0, 1..400]                      
NPVEXT       |YES        |Extended NPV service supporting up to 1000 NPVL      
CHAT         |MAX        |Number of CHAT (XMPP) users [0, 1..1023]             

LICENCE STORED IN FILE EQUALS THE ACTIVE ONE