Updating the Recovery Appliance

19 Updating the Recovery Appliance

This section outlines the steps required to install a software update on the Recovery Appliance.

The prerequisite for installing update software on the Recovery Appliance is obtaining from Oracle the appropriate update file. This update file is named zdlra_release.zip in the example below but typically has specific version information in the name.

Copy the update file (zdlra_release.zip) to the Recovery Appliance compute server into the /radump/ directory.
```
scp zdlra_release.zip oracle@zdlraadm01:/radump/
```

As a user in the raadmin group, run various checks to verify that the Recovery Appliance is in a healthy and stable state before. Refer to Running Recovery Appliance Checks. As an example:

[adminra1@zdlra05 ~]# racli list check --status=enabled
check_active_incidents
check_appliance_status
check_cell_alerts
check_compute_alerts
check_image_versions
check_init_parameter
check_invalid_objects
check_ra_export
check_ra_version
[adminra1@zdlra05 ~]#

[adminra1@zdlra05 ~]# racli run check --check_name=check_active_incidents,check_invalid_objects
Wed Oct 10 13:53:07 2018: Start: racli run check --check_name=check_active_incidents,check_invalid_objects
HOST: [nnnnnn01.oracle.com]

Created log file scas10adm01.us.oracle.com:/opt/oracle.RecoveryAppliance/log/racli_run_check_20181010.1353.log
Wed Oct 10 13:53:07 2018: CHECK: Active Incidents - PASS
Wed Oct 10 13:53:09 2018: CHECK: Invalid Objects - PASS
Wed Oct 10 13:53:09 2018: End: racli run check --check_name=check_active_incidents,check_invalid_objects
HOST: [nnnnnn01.oracle.com]
[adminra1@zdlra05 ~]#

You can selectively run other checks, or all enabled checks with racli run check --all.

Pay particular attention to any checks that FAIL, because they may indicate that the Recovery Appliance is not in an appropriate state to continue with the update operation.

On the compute sever, navigate into the /radump/ directory and unzip the upgrade file.

[adminra1@zdlra05 ~]# cd /radump/
[adminra1@zdlra05 radump]# unzip zdlra_release.zip

As a user in the raadmin group, run the following command from the /radump directory.
```
[adminra1@zdlra05 radump]# /usr/bin/perl ra_preinstall.pl
```
Pay attention to any validations that failed , because they may indicate that the Recovery Appliance is not in an appropriate state to continue.
As a user in the raadmin group, run the following commands from the /radump directory.
```
[adminra1@zdlra05 radump]# racli update appliance 
```
This command replaces racli patch appliance and racli upgrade appliance and determines whether the update should be a patch or an upgrade. It performs all the prechecks. If the prechecks pass, it proceeds with the patch or upgrade steps. If the update fails in the middle and after the identified error is corrected, this command can be rerun and it will continue with the step that failed.

Validate the ZDLRA version that was installed on the Recovery Appliance.

[adminra1@zdlra05 radump]# /opt/oracle.RecoveryAppliance/bin/racli version

Validate the ZDLRA services are online.

[adminra1@zdlra05 radump]# /opt/oracle.RecoveryAppliance/bin/racli status appliance

Validate the health of the Recovery Appliance.

[adminra1@zdlra05 radump]# /opt/oracle.RecoveryAppliance/bin/racli run check --all