You are here: CSP Developer’s Guide: Overview > 3 Getting Started > Creating a TFTP Configuration File
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.
The table below shows the labels used in the TFTP Configuration File for each card.
Table 3-4 Labels for TFTP Configuration File
Card Name |
Card Label |
---|---|
EXCPU |
|
E-ONE, T-ONE, J-ONE |
ONELC |
ST1LC |
ST1LC |
SE1LC |
SE1LC |
SJ1LC |
SJ1LC |
DSP-ONE |
DSPONE |
SS7 PQ |
SS7PQLC |
SS7 Series 3 |
SS7HPLC |
Subrate Controller |
SRC |
DSP Series 2 |
|
ISDN32 |
|
ISDN Series 3 |
ISDNHPLC |
EXNET-ONE |
EXNTONE |
DS3 |
DS3 |
VDAC Module |
VOIPMOD |
VDAC Main Board |
VOIPMBRD |
EXCPU |
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.
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
The TFTP Manage message is used to initiate a download of system software, update download information, and query the TFTP Configuration.
Send the TFTP Manage message to the CSP 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.
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.
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.