Creating a TFTP Configuration File

Overview

You must create a TFTP Configuration File that indicates the loads to be downloaded. Each software release comes with a default configuration file which contains information for all cards supported in that release. You can modify the default configuration file.

See the sample TFTP Configuration File below.

TFTP Configuration FIle Format

The entries in the configuration file do not need to be in a specific order, but they must follow this format:

<Card Label_LOAD>=<path/filename>:SAVE_LOAD_<TRUE or FALSE> ‘ Comment

No space is allowed on the line until after the SAVE_LOAD label. The path/filename can be up to 127 characters long.

Card Label

The table below shows the labels used in the TFTP Configuration File for each card.

Table 3-4 Labels for TFTP Configuration File

Matrix Controller Load

You must set the Matrix Controller load to be saved on the Matrix Controller card by including "TRUE" in the line for the matrix (for example, SAVE_LOAD_TRUE). The Save Load option is not supported for any other cards. The load for cards other than the Matrix Controller are retrieved as needed via TFTP.

Timestamp

If you are using BOOTP to initiate the download, you must provide a timestamp in the configuration file.

Important! The configuration filename on the BOOTP server must match the .bin name on the TFTP server.

If you are using the TFTP Manage message to initiate the download, you can include the timestamp in either the TFTP configuration file or in the TFTP Manage message. The TFTP Manage response Status is 0x01 (Two Timestamps Provided).

The timestamp in the TFTP configuration file is formatted as follows:

<month (01-12)>/<day(01-31)>/<year(0000-9999)> <space> <hour(01-23)>:<minute(01-59)>:<second (01-59)>

or as a raw value, such as a hexadecimal number (beginning with "0x"), representing the number of seconds since 1/1/70.

If you are configuring the timestamp in the TFTP Manage message, see the message format in the API Reference for the format of the Timestamp ICB subtype.

Sample TFTP Configuration File

The following is an example of a TFTP configuration file.

Important! If using the TFTP Manage message to initiate the download, the timestamp must be included in either the TFTP Manage message or the TFTP configuration file, but not both.

EXCPU_LOAD=c:\tftpboot\ELX0800073\MTX0800073.BIN=SAVE_LOAD_TRUE

ST1LC_LOAD=c:\tftpboot\ELX0800073\ST10800073.BIN=SAVE_LOAD_FALSE

SE1LC_LOAD=c:\tftpboot\ELX0800073\SE10800073.BIN=SAVE_LOAD_FALSE

SJ1LC_LOAD=c:\tftpboot\ELX0800073\SJ10800073.BIN=SAVE_LOAD_FALSE

SS7PQLC_LOAD=c:\tftpboot\ELX0800073\SPQ0800073.BIN=SAVE_LOAD_FALSE

ISDN32_LOAD=c:\tftpboot\ELX0800073\ISD0800073.BIN=SAVE_LOAD_FALSE

DS3_LOAD=c:\tftpboot\ELX0800073\DS30800073.BIN=SAVE_LOAD_FALSE

EXNTONE_LOAD=c:\tftpboot\ELX0800073\EX10800073.BIN=SAVE_LOAD_FALSE

DSPONE_LOAD=c:\tftpboot\ELX0800073\DSP0800073.BIN=SAVE_LOAD_FALSE

VOIPMOD_LOAD=c:\tftpboot\ELX0800073\VMD0800073.BIN=SAVE_LOAD_FALSE

VOIPMBRD_LOAD=c:\tftpboot\ELX0800073\MBR0800073.BIN=SAVE_LOAD_FALSE

ONELC_LOAD=c:\tftpboot\ELX0800073\TE10800073.BIN=SAVE_LOAD_FALSE

SS7HPLC_LOAD=c:\tftpboot\ELX0800073\SHP0800073.BIN=SAVE_LOAD_FALSE

TIMESTAMP=09/27/01 10:30:15

Using the TFTP Manage Message

The TFTP Manage message is used to initiate a download of system software, update download information, and query the TFTP Configuration.

Initiating a Download

Send the TFTP Manage message to the Excel platform with the following information:

• Local Matrix Controller configuration filename (Data ICB Subtype 0x37)

• Local Matrix Controller server IP address (Data ICB Subtype 0x38)

• Adjacent Matrix Controller configuration filename (Data ICB Subtype 0x39)

• Adjacent Matrix Controller server IP address (Data ICB Subtype 0x39)

• Timestamp (Data ICB Subtype 0x3B) (if not included in the TFTP Configuration File)

• Begin Download (Action ICB Subtype 0x00)

See the API Reference for the format of the TFTP Manage message.

Important! The term "Local" refers to the Matrix Controller to which you are downloading the files.

Updating Information

If you are simply updating information (such as configuration filename or Server IP address) but not downloading a new version of system software, send the relevant data ICBs but do not send the Begin Download action ICB.

Querying TFTP Configuration

You can use the TFTP Manage message to query the following information:

• Local Matrix Configuration Filename

• Adjacent Matrix Configuration Filename

• Local Matrix Server IP Address

• Adjacent Matrix Server IP Address

• Timestamp

• Save Options

• Load Version

• Load Filename

Each query option is performed by inserting the appropriate action ICB into the TFTP Manage message. The response contains an ICB with the relevant data for the query. See the TFTP Manage message in the API Reference for ICB values and a sample message trace.