Backup and Restore

Edge for Private Cloud v. 4.16.09

This section describes the backup and restore tasks in an on-premises installation of Apigee Edge. It is recommended that you should always create a backup of Apigee Edge components, i.e. configuration and data, at regular intervals and ensure that recovery is performed in an event of a system failure. Backup and restore procedures enable you to restore the state of an entire system (including all components), without affecting other parts of the system.

What to Backup

In an on-premises deployment of Apigee Edge, you must backup the following Edge components:

  • Apache ZooKeeper (apigee-zookeeper)
  • Apache Cassandra (apigee-cassandra)
  • Postgres Server (edge-postgres-server)
  • PostgreSQL database (apigee-postgresql)

    Note: In a Postgres Master/Standby configuration, you only backup the Master. You do not have to backup the slave.
  • Qpid Server (edge-qpid-server)
  • Qpidd (apigee-qpidd)
  • OpenLDAP (apigee-openldap)
  • Management Server (edge-management-server)
  • Message Processor (edge-message-processor)
  • Router (edge-router)
  • Edge UI (edge-ui)

Recovery time objective (RTO) vs. Recovery point objective (RPO)

The RTO is the duration of time and a service level within which a business process must be restored after a disaster (or disruption) in order to avoid unacceptable consequences associated with a break in business continuity.

A RPO is the maximum tolerable period in which data might be lost from an IT service due to a major incident. Both objectives must be taken into consideration before you implement a backup plan for your recovery strategy.

Before You Start: Useful Facts

You may observe that installation data is distributed across several systems, for example organizations are in LDAP, ZooKeeper and Cassandra. Make sure that you take care of the following notes about backup and restore:

  • If you have multiple Cassandra nodes, back them up one at a time. The backup process temporarily shuts down Cassandra, so you do not want to run it at the same time for all Cassandra nodes.
  • If you have multiple ZooKeeper nodes, back them up one at a time. The backup process temporarily shuts down ZooKeeper.
  • If you have multiple Postgres nodes, back them up one at a time.
  • You can back up all other Edge components at the same time on all nodes by using tools such as Ansible or Chef.
  • When you restore one of ZooKeeper, Cassandra or LDAP nodes it is recommended to restore all three nodes in order to achieve consistency (especially when organizations/environments have been created since backup was created).
    Note: The above does not affect restoration of one Cassandra or ZooKeeper node in a datastore cluster, since no backup is used.
  • If LDAP or global administrator passwords are lost/corrupted, a complete backup is required in order to get the same credentials for the last backup and running system.
  • The backup utility writes the generated backup file to /opt/apigee/backup/comp where comp is the name of the component. Because you can generate many backup files, and because these files can get large, you can mount a separate disk at /opt/apigee/backup just for backup files.
  • All backup files, except for PostreSQL, are named in the form:
    backup-(year).(month).(day),(hour).(min).(seconds).tar.gz

    PostreSQL backup files are named:
    (year).(month).(day),(hour).(min).(seconds).dump