56.1. Provisioning

56.1. Provisioning
	Chapter 56. Provisioning

Provisioning is a new service for auto setup of new installations.

A standard Abilis CF can be equipped with a special configuration file called PROVISIO.CFG so that when it's booted the first time it will contact the servers defined in PROVISIO.CFG to retrieve the proper configuration (DRIVERS.CFG) and licence (LICENCE-.....TXT) based on device serial number identification (ABILIS-ID).

The PROVISIO.CFG has to be prepared in advance by technicians, according to the need of the organization, and copied in all factory CF prepared for the organization in place of the DRIVERS.CFG and DRIVERS.BCK.

The output of the command D I in a new CF prepared for provisioning looks like this:

[17:18:22] ABILIS_CPX:d i
...
File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
CPX.RTB        .......   31/10/2018   13:16:50      7107337
BM.RTB         2053      31/10/2018   13:16:48       283094
DRIVERS.CFG    .......   ..........   ........   ..........   Not found
DRIVERS.BCK    .......   ..........   ........   ..........   Not found
PROVISIO.CFG   8.7       05/11/2018   12:52:06        38912   Ok
...

	Note
	For info about file `PROVISIO.CFG` consult Abilis technical support (`<tem@antek.i>`t).

56.1.1. Provisioning Client

The default configuration of PROVC has the path appropriate for use with the Abilis provisioning server (PROVS) that is running on another Abilis of the organization, however PROVC can be configured for any HTTPS server:

[17:16:15] ABILIS_CPX:d p provc

RES:ProvC ---------------------------------------------------------------------
       DESCR:Abilis_provisioning_client
       LOG:DS          SRCADD:OUT-IP                      TOS:0-N      PROT:SSL
       PROC-RTY-DELAY:600        CONN-RTY-DELAY:60        RESP-WAIT-TIME:60
       SERVER1:
       PORT1:AUTO(443)
       PATH1:/sys/provisioning/
       SERVER2:
       PORT2:AUTO(443)
       PATH2:/sys/provisioning/
       SERVER3:
       PORT3:AUTO(443)
       PATH3:/sys/provisioning/

The meaning:

DESCR

Resource description. Max 79 chars. Spaces require double quotes (E.g. "str1 str2").

LOG

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).

SRCADD

Source IP address for outgoing connections [R-ID, OUT-IP, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

TOS

TOS or DS field:

p-t: PRECEDENCE-TOS, 'p' [0..7], 't' [N, D, T, R, C].
bbbbbb: DS value bit by bit, 'b' [0, 1].

PROT

Select the transport type [SSL]. <ReadOnly>

PROC-RTY-DELAY

Delay between subsequent procedure reties [1..3600 sec].

	Note
	There is no limit to retry attempts.

CONN-RTY-DELAY

Delay between subsequent reconnections [1..3600 sec].

	Note
	There is no limit to reconnection attempts.

RESP-WAIT-TIME

Minimal delay between submission of a request and its completion [1..3600 sec].

SERVER1/SERVER2/SERVER3

1st/2nd/3rd provisioning server IP address [1-126.x.x.x, 127.0.0.1, 128-223.x.x.x] or FQDN name of max 64 characters in the range ['0'..'9', 'a'..'z', '-', '.' ]. FQDN name is forced to lower case.

PORT1/PORT2/PORT3

Port to be used for 1st/2nd/3rd provisioning server [AUTO, 1..65535].

PATH1/PATH2/PATH3

Virtual path for 1st/2nd/3rd provisioning server Max 128 chars. Spaces require double quotes (E.g. "/sys/My path/").

56.1.2. Provisioning Server

For each ABILIS-ID the service permits the provisioning of ONE licence files and ONE or MORE configuration files, one for each major.minor version (e.g. for 8.7.x, 8.8.x, 8.9.x, ...).

The remote Abilis will fetch the licence file and the configuration file corresponding to its major.minor version.

Add the resource to the Abilis system with the following command:

[09:08:14] ABILIS_CPX:a res:provs

RES:CTIAS ALREADY EXISTS

The PROVS resource may already exist in the system, but may not yet be active. Set it active with the command:

[09:10:00] ABILIS_CPX:s act res:provs

COMMAND EXECUTED

	Caution
	You must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis) after adding or setting the PROVS active.

[13:07:41] ABILIS_CPX:d p provs

RES:ProvS ---------------------------------------------------------------------
Run    DESCR:Abilis_provisioning_server
       LOG:DS                   ACT:YES
       WDIR:C:\APP\PROVISIONING\
       IPSRC:*                  IPSRCLIST:#

The meaning:

DESCR: Resource description. Max 79 chars. Spaces require double quotes (E.g. "str1 str2").
LOG: State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).
ACT: Operation activation [NO, YES].
WDIR: Directory where licence and configuration files are saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").
IPSRC: Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
IPSRCLIST: Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

	Important
	For further manage of configuration and licenses files, see the web page: Section 72.27, “Provisioning”.