Restoring the Database from the FTP Server

This procedure is used to restore the database from the FTP server using the chg-db command with these parameters.

action=restore
src=server
file - the name of the TAR file on the FTP server that contains database that is being restored. The file parameter value is the file name that was created when the database was backed up to the FTP server. The file parameter value can contain a maximum of 39 alphanumeric characters. Refer to Making a Backup of the Database to the FTP Server for more information about the file name for database backups to the FTP server.

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-card 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-card 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.

The EAGLE must contain at least one E5-IPSM and an FTP server for the DB application. The rtrv-stp command with the gpl=ipshc parameter displays the E5-IPSMs. 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.

Caution:

Using the action=restore parameter with the chg-db command is an emergency recovery procedure, and requires the init-sys command to download the restored database to all the cards in the EAGLE.

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-card output. IPSMs are shown by the entry IPS in the GPL column of the rept-stat-card 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 2.
- If E5-IPSMs are shown in the rept-stat-card output, continue the procedure with 2.
- 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 2.
  - If three entries are shown in this step, no more IPSMs or E5-IPSMs can be added. An 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 2.
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 3.

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 3.

Enter the chg-db command with the action=restore, src=server, and file parameters. For this example, enter this command.

chg-db:action=restore:src=server:file="rlghncxa03w-39.2.0-08092612.tar.gz"

During command execution, these messages appear (the active MASP is displayed first).

RESTORE (SERVER) : Retrieve database archive from server.
RESTORE (SERVER) : Validate database archive.
RESTORE (SERVER) : Restore starts on active MASP.
RESTORE (SERVER) : Restore from server on active MASP complete.
RESTORE (SERVER) : Restore starts on standby MASP.
RESTORE (SERVER) : Restore from server on standby MASP complete.
RESTORE (SERVER) : MASP(s) will reboot to load data.

When the commands have successfully completed, re-initialize the EAGLE using the init-sys command.
Note:
The init-sys command causes a complete reload of the EAGLE, and should only be used during periods of low traffic. Using this command ensures that all cards are running the same database, but will interrupt service.

Note:
The init-sys command must be entered twice within 30 seconds for the EAGLE to be re-initialized. If the init-sys command is not executed twice within 30 seconds, the attempt to re-initialize the EAGLE is aborted.

When the init-sys command is first entered, this message should appear.
```
rlghncxa03w 08-09-01  07:05:01 GMT  EAGLE5 39.2.0
CAUTION: This command causes a complete system reload, and
will result in traffic loss.
Re-enter command within 30 seconds to confirm.
```
When the init-sys command is re-entered within the 30 second time limit, this message should appear.
```
rlghncxa03w 08-09-01  07:05:17 GMT  EAGLE5 39.2.0
Init System command issued at terminal #4
```
From the time that the init-sys command is accepted, you must wait approximately 2 minutes before you can perform 5 (logging into the EAGLE). If the EAGLE terminal is in the VT-100/VT-320 mode, the terminal display will be refreshed with non-zero alarm counts. During this 2 minutes interval, an intermediate screen refresh caused by the MASPs role change from active to standby, and from standby to active. This screen refresh is typically a partial refresh and the alarm indicators are set to zero.

If you are logged into the EAGLE in the KSR mode, the only response you will receive that you are now able to log into the EAGLE is that you will receive UAM 0009, MASP became active. UAM 0009 could be issued twice due to possible transient MASP role change (switching from active to standby). Following the execution of the init-sys command, the MASP that was active before the init-sys command was entered will be the active MASP when the EAGLE has finished reinitializing.

Log into the EAGLE using the login or act-user command.

This is an example of the messages that appear when you have successfully logged into the EAGLE.

NOTICE: This is a private computer system. 
Unauthorized access or use may lead to prosecution. 

0 LOGIN failures since last successful LOGIN
Last successful LOGIN was on port 4 on 08-09-01 @ 05:34:56

Verify that the databases on the removable cartridge (RD BKUP) and the current partitions of both MASPs (FD CRNT) are 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 08-09-01 07:06:18 GMT  Y       35 08-09-01 07:06: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

Figure D-4 Restoring the Database from the FTP Server