Making a Backup of the Database to the FTP Server

This procedure is used to make a backup of the database to FTP server using the chg-db command with these parameters.

:action=backup
:dest=server

The database in the active partition of the active MASP (FD CRNT) must be coherent. The status of the database is shown in the rept-stat-db command. For more information on verifying the database, refer to Verifying the Database.

Note:

As of Release 46.5, the E5-IPSM card and its functionality is replaced by the E5-ENET-B (p/n 870-2971-01) or SLIC (p/n 7094646) card. Any references to E5-IPSM and the 870-2877-01 part number should be replaced by the 46.5 and greater card and part number.

The EAGLE must contain at least one E5-IPSM and an FTP server for the DB application. The rept-stat-gpl command with the appl=ips parameter displays the E5-IPSMs and IPSMs that are in the database. E5-IPSMs are shown by the entry IPSHC in the GPL column of the rept-stat-gpl output. IPSMs are shown by the entry IPS in the GPL column of the rept-stat-gpl output. The rtrv-ftp-serv command shows the FTP servers that are configured. E5-IPSMs can be added by performing the procedure Adding an E5-IPSM. FTP servers can be added by performing the procedure Adding an FTP Server.

When a backup of the database to the FTP server is performed, A file containing the database is created with the following naming convention is created:

“CLLI string”-“Release number string”-“yymmddhh”.tar.gz

The CLLI string is the CLLI value shown in the output header. The release number string is the release number shown in the output header. If the archbldid option, shown in the rtrv-stpopts output, is set to yes, the release number string contains the build number instead of the release number. If you wish to change the archbldid option, perform the procedure Configuring the Archive Build ID Option. The string yymmddhh is the year (yy - 2 digits), the month (mm), the day (dd), and the hour (hh) that the backup was performed. For example, the file name for a backup performed on September 26, 2008 at 12 noon would be: rlghncxa03w-39.2.0-08092612.tar.gz. This file name will be needed to restore the database from the FTP server. The file name for the backup can contain a maximum of 39 alphanumeric characters.

Verify that the database in the active partition of the active MASP (FDCRNT) is coherent using the rept-stat-db command.

This is an example of the possible output.

rlghncxa03w 08-09-01 16:07:48 GMT  EAGLE5 39.2.0
DATABASE STATUS: >> OK <<
        TDM 1114 ( STDBY)                 TDM 1116 ( ACTV )
         C  LEVEL     TIME LAST BACKUP     C  LEVEL     TIME LAST BACKUP
         - -------- ---------------------  - -------- ---------------------
FD BKUP  Y       35 04-06-01 10:19:18 GMT  Y       35 04-06-01 10:19:18 GMT
FD CRNT  Y      106                        Y      106           
         MDAL 1117
         - --------
RD BKUP  -    -         -        -

If E5-based control cards are installed in the EAGLE, this is an example of the output.

rlghncxa03w 09-03-01 16:07:48 GMT  EAGLE5 40.1.0
DATABASE STATUS: >> OK <<
        TDM 1114 ( STDBY)                 TDM 1116 ( ACTV )
        C   LEVEL    TIME LAST BACKUP     C   LEVEL    TIME LAST BACKUP
        - -------- ---------------------- - -------- ----------------------
FD BKUP Y       35 09-02-19 09:38:25 GMT  Y       35 09-02-19 09:38:25 GMT
FD CRNT Y      106                        Y      106
        MCAP 1113                         MCAP 1115
        - --------                        - --------
RD BKUP -    -         -        -         Y       35 09-02-19 09:27:17 GMT
USB BKP -    -         -        -         Y        3 09-02-07 01:11:22 GMT

If the database is coherent, continue the procedure with 2.

If the database is not coherent, refer to Verifying the Database and resolve the database problems. After the database problems have been resolved, continue the procedure with 2.

Display the E5-IPSMs that are in the database by entering this command.
rept-stat-card:appl=ips

This is an example of the possible output.
```
rlghncxa03w 08-09-01 16:07:48 GMT  EAGLE5 39.2.0
CARD   VERSION      TYPE      GPL        PST            SST        AST     
1111   131-010-000  IPSM      IPSHC      IS-NR          Active     -----     
1317   -----------  IPSM      IPS        OOS-MT         Isolated   -----     
2217   131-010-000  IPSM      IPS        IS-NR          Active     -----     

Command Completed.
```
E5-IPSMs are shown by the entry IPSHC in the GPL column of the rept-stat-gpl output. IPSMs are shown by the entry IPS in the GPL column of the rept-stat-gpl output. Continue the procedure by performing one of these actions.
- If no entries are shown in the rept-stat-card output, add an E5-IPSM by performing the procedure Adding an E5-IPSM. After the E5-IPSM has been added, continue the procedure with 3.
- If E5-IPSMs are shown in the rept-stat-card output, continue the procedure with 3.
- If only IPSMs are shown in the rept-stat-card output, continue the procedure by performing one of these actions.
  - If two or less entries are shown in this step, add the E5-IPSM by performing the procedure Adding an E5-IPSM After the E5-IPSM has been added, continue the procedure with 3.
  - If three entries are shown in this step, no more IPSMs or E5-IPSMs can be added. A IPSM must be removed so the E5-IPSM can be added. perform the procedure Removing an E5-IPSM to remove the IPSM. Add the E5-IPSM by performing the procedure Adding an E5-IPSM After the E5-IPSM has been added, continue the procedure with 3.
Display the FTP servers that are provisioned in the database by entering the rtrv-ftp-serv command. This is an example of the possible output.
```
rlghncxa03w 08-09-01 16:07:48 GMT  EAGLE5 39.2.0

APP       IPADDR           LOGIN            PRIO  PATH
--------  ---------------  ---------------  ----  ----
db        10.20.50.102     dbuser1          1     ~/eagle
dist      100.200.50.102   dbuser1          1     ~/eagle
meas      1.255.0.100      ftpmeas3         3     ~meas\local
```
If the entry db is shown in the APP column, continue the procedure with 4.

If the entry db is not shown in the APP column, perform the procedure Adding an FTP Server to add the FTP server. After the FTP server has been added, continue the procedure with 4.
Enter the chg-db:action=backup:dest=server command.
During command execution, these messages should appear.
```
BACKUP (SERVER): MASP A - Backup starts on active MASP.
BACKUP (SERVER) : Copy Database to card memory for processing.
BACKUP (SERVER) : Compress Database before archiving.
BACKUP (SERVER) : Send database archive to server.
BACKUP (SERVER): MASP A - Backup to remote server complete.
```
A file with the following naming convention is created.

“CLLI string”-“Release number string”-“yymmddhh”.tar.gz

The CLLI string is the CLLI value shown in the output header. The release number string is the release number shown in the output header. If the archbldid option, shown in the rtrv-stpopts output, is set to yes, the release number string contains the build number instead of the release number. If you wish to change the archbldid option, perform the procedure Configuring the Archive Build ID Option. The string yymmddhh is the year (yy - 2 digits), the month (mm), the day (dd), and the hour (hh) that the backup was performed. For example, the file name for a backup performed on September 26, 2008 at 12 noon would be: rlghncxa03w-39.2.0-08092612.tar.gz. The file name for the backup can contain a maximum of 39 alphanumeric characters. This file name will be needed to restore the database from the FTP server. Record this filename.

Figure D-3 Making a Backup of the Database to the FTP Server

Sheet 1 of 2

Sheet 2 of 2