Adding an FTP Server

This procedure is used to add FTP servers using the ent-ftp-serv command.

The ent-ftp-serv command uses these parameters.

:app – The application of the FTP server. There are four values for the app parameter:

meas – The FTP servers for the Measurements Platform. A maximum of three FTP servers can be configured for this application.
db - The FTP server for the database backup/restore application. Only one FTP server can be configured for this application.
dist - the FTP server for the EAGLE software release distribution application. Only one FTP server can be configured for this application.
user – The FTP servers for the FTP Retrieve and Replace feature.A maximum of two FTP servers can be configured for this application.
Caution:
While this procedure can be used to add a USERFTP server, any USERFTP servers entered by this procedure will be overwritten by the FTP server configuration information sent to the EAGLE by the FTP-Based Table Retrieve Application (FTRA).

:ipaddr – The IP address of the FTP server.

:login – The name of the FTP server client.

:path – The path to the file on the EAGLE that is to be sent to the FTP server.

:prio – The priority of the FTP server, from 1 to 10.

The app/ipaddr parameter combination must be unique in the database.

The login parameter value can contain from 1 to 15 alpha-numeric characters. The alphabetic characters can be both upper and lower case characters.

The path parameter value is a mixed-case quoted character string with a valid FTP path format that can contain up to 100 characters.

After the FTP server is added to the database with the ent-ftp-serv command, the user is prompted for a password for this FTP server. The password can contain from 1 to 15 alpha-numeric characters. The alphabetic characters must be both upper and lower case characters. The password is not shown on the terminal screen as it is being entered and is not shown in the rtrv-ftp-serv output.

If the EAGLE OA&M IP Security Enhancement Controlled Feature is enabled and activated, the FTP servers configured in this procedure must be secure FTP servers. The FTP-Based Table Retrieve Application (FTRA) and the Measurements Platform must support secure shell connections to the EAGLE. Enter the rtrv-ctrl-feat command to verify whether or not the Eagle OA&M IP Security Enhancement Controlled Feature is enabled and activated.

Because CSV measurement data files do not have unique names across multiple STPs, include the CLLI of the STP in the FTP server path for meas FTP servers.

The IP address of the FTP server cannot be shown as the IPADDR value in the rtrv-ip-lnk or rtrv-seas-config outputs, or the BPIPADDR value in the rtrv-ip-card output.

Display the FTP servers in the database using the rtrv-ftp-serv commandby entering this command..

rtrv-ftp-serv:mode=full

This is an example of the possible output.

rlghncxa03w 08-09-01 09:12:36 GMT EAGLE5 39.2.0
FTP Client Security: ON

APP       IPADDR           LOGIN            PRIO
--------  ---------------  ---------------  ----
meas      1.255.0.100      ftpmeas3         3
   Path:  ~meas\local

FTP SERV table is (1  of 10)  10% full

Add the FTP server to the database using the ent-ftp-serv command.
For this example, enter these commands.

ent-ftp-serv:app=meas:ipaddr=1.255.0.101:login=ftpmeas2:prio=2 :path="\tmp\measurements\backup\dat"

ent-ftp-serv:app=user:ipaddr=1.255.0.100:login=ftpuser1:prio=3 :path="\tmp\user"

ent-ftp-serv:app=user:ipaddr=1.255.0.102:login=ftpuser5:prio=7 :path="\tmp\backup\user"

ent-ftp-serv:app=db:ipaddr=10.20.50.102:login=dbuser1:prio=1 :path="~/eagle"

ent-ftp-serv:app=dist:ipaddr=100.200.50.102:login=dbuser1:prio=1 :path="~/eagle"

Caution:
While this procedure can be used to add a USER FTP server, any USER FTP servers entered by this procedure will be overwritten by the FTP server configuration information sent to the EAGLE by the EAGLE FTP Table Base Retrieval (FTRA).

When each of these commands has successfully completed, the following message should appear.
```
    rlghncxa03w 08-09-01 21:18:37 GMT EAGLE5 39.2.0
Enter Password :
    FTP SERV table is (4 of 10) 40% full
    ENT-FTP-SERV: MASP A - COMPLTD
```
```
rlghncxa03w 06-10-01 21:18:37 GMT EAGLE5 36.0.0
FTP SERV table is (4 of 10) 40% full
ENT-FTP-SERV: MASP A - COMPLTD
```
Enter a password for the FTP server added in 2 at the PASSWORD: prompt.

The password is not shown on the terminal screen as it is entered. The password can contain from 1 to 15 alpha-numeric characters. The alphabetic characters must be both upper and lower case characters.

Display the changes by entering this command.

rtrv-ftp-serv:mode=full

The following is an example of the possible output.

rlghncxa03w 08-09-01 09:12:36 GMT EAGLE5 39.2.0
FTP Client Security: ON


APP       IPADDR           LOGIN            PRIO
--------  ---------------  ---------------  ----
db        10.20.50.102     dbuser1          1
   Path:  ~/eagle
dist      100.200.50.102   dbuser1          1
   Path:  ~/eagle
meas      1.255.0.100      ftpmeas3         3
   Path:  ~meas\local
meas      1.255.0.101      ftpmeas2         2
   Path:  \tmp\measurements\backup\dat
user      1.255.0.100      ftpuser1         3
   Path:  \tmp\user
user      1.255.0.102      ftpuser5         7
   Path:  \tmp\backup\user

FTP SERV table is (6 of 10) 60% full

Back up the new changes using the chg-db:action=backup:dest=fixed command.

These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first

BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure 4-23 Adding an FTP Server

Sheet 1 of 2

Sheet 2 of 2