38.1. TFTP - Trivial File Transfer Protocol

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

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

38.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 [69].

srv-sess

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

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];

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.

IPSRCLIST

Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname]. Default is "PrivateIpAdd".

WDIR

Directory where message files are stored. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (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.