36.1. TFTP - Trivial File Transfer Protocol

The TFTP has been introduced to bootstrap certain IP phones models.

36.1.1. Activating the TFTP resource

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

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

RES:TFTP ALREADY EXISTS

The TFTP resource may already exist in the system, but may not yet be active: set it active with the following command.

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

COMMAND EXECUTED
[Caution]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 TFTP active.

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

RES:Tftp ----------------------------------------------------------------------
Run    DESCR:Trivial_File_Transfer_protocol
       LOG:NO        ACT:NO    udp-locport:69   srv-sess:10   TOS:0-N
       RTY:5         TOUT:3    WRITE-PERMISSIONS:NO
       IPSRC:127.000.000.001   IPSRCLIST:PrivateIpAdd
       WDIR:C:\APP\TFTP\
[Caution]Caution

Execute the initialization command init res:tftp to activate the changes made on the upper case parameters; use save conf and warm start commands to set active the changes made on the lowercase parameters.

[10:50:25] ABILIS_CPX:s p tftp act:yes

COMMAND EXECUTED

[10:51:33] ABILIS_CPX:d p tftp

RES:Tftp - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Run    DESCR:Trivial_File_Transfer_protocol
       LOG:NO        ACT:YES   udp-locport:69   srv-sess:10   TOS:0-N
       RTY:5         TOUT:3    WRITE-PERMISSIONS:NO
       IPSRC:127.000.000.001   IPSRCLIST:PrivateIpAdd
       WDIR:C:\APP\TFTP\

[10:51:41] ABILIS_CPX:save conf

VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

[10:51:53] ABILIS_CPX:init res:tftp

COMMAND EXECUTED

36.1.2. TFTP resource parameters

Use the command below to display the parameters of the resource; the d p tftp ? command shows the meaning of parameters.

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

RES:Tftp ----------------------------------------------------------------------
Run    DESCR:Trivial_File_Transfer_protocol
       LOG:NO        ACT:YES   udp-locport:69   srv-sess:10   TOS:0-N
       RTY:5         TOUT:3    WRITE-PERMISSIONS:NO
       IPSRC:127.000.000.001   IPSRCLIST:PrivateIpAdd
       WDIR:C:\APP\TFTP\

Meaning of the most important parameters:

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).

ACT

Operation activation [NO, YES].

udp-locport

TFTP server local UDP port. Default is 69.

srv-sess

Number of TFTP server sessions [1..255].Default is 10.

TOS

Type Of Service octet or Differentiated Services Field (DS): -' p-t', i.e. PRECEDENCE and TOS values, where 'p' can be [0..7] and 't' can be [N=None, D=Min. Delay, T=Max. Throughput, R=Max. Reliability, C=Min. Monetary Cost] - 'bbbbbb', i.e. DS value bit by bit, where 'b' can be [0, 1]. Default is 0-N.

RTY

Number of retransmissions [1..30]. Default is 5.

TOUT

Time that TFTP waits for TFTP peer responses [1..15 sec.]. Default is 3.

WRITE-PERMISSIONS

Specifies the write permissions [NO: write operations are disabled, YES: all write operations are enabled, IF-EXISTS: write operations are enabled only if file already exists]. Default is NO.

IPSRC

Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x]. Default is 127.0.0.1.

IPSRC-LIST

Incoming requests: name of the IP/IR/RU/MR list for source IP address acceptance [#, 0..9, a..z, A..Z, _]. Default is "PrivateIpAdd".

WDIR

Directory where message files are located. It cannot be empty. Physical full path in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. Max. 128 characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: "C:\My dir\"). Default is C:\APP\TFTP\.

The following command allows the administrator to change the configuration of the resource:

s p tftp parameter:value...

[Caution]Caution

Execute the initialization command init res:tftp to activate the changes made on the upper case parameters; use save conf and warm start commands to set active the changes made on the lowercase parameters.