Changing an FTP Server

This procedure is used to change the values assigned to an FTP server using the chg-ftp-serv command.

The chg-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
• db - The FTP server for the database backup/restore application.
• dist - the FTP server for the EAGLE software release distribution application.
• user – The FTP servers for the FTP Retrieve and Replace feature.

  Caution:

  While this procedure can be used to change a USERFTP server configuration, any USERFTP server configurations changed by this procedure will be overwritten by the FTP server configuration information sent to the EAGLE by the EAGLE FTP Table Base Retrieval (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 and ipaddr parameters must be specified with the chg-ftp-serv command. The IP address of the FTP server cannot be changed with the chg-ftp-serv command. If you wish to change the IP address of the FTP server, the FTP server must first be removed with the Removing an FTP Server procedure, then re-entered with the new IP address using the Adding an FTP Server procedure.

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.

If the login parameter value is changed, 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 EAGLE FTP Table Base Retrieval (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.

1. Display the FTP servers in the database by 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
   --------  ---------------  ---------------  ----
   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
   

2. Change the FTP server to the database using the chg-ftp-serv command.

   For this example, enter this command.

   chg-ftp-serv:app=meas:ipaddr=1.255.0.101:login=meas25:prio=1

   When this command has successfully completed, the following message should appear.

       rlghncxa03w 08-09-01 21:18:37 GMT EAGLE5 39.2.0
   Enter Password :
       CHG-FTP-SERV: MASP A - COMPLTD
   

   Note:

   If the login parameter was not specified in this step, continue the procedure with 4.
3. Enter a password for the FTP server changed 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.

4. 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      meas25           1
      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
   

5. 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-25 Changing an FTP Server

Sheet 1 of 2

Sheet 2 of 2