All Heirloom PaaS subscriptions come with automatic backup and the ability to restore a complete working image of your application. The Backup Calendar Portlet (https://heirloomcomputing.zendesk.com/entries/21266873-backup-calendar-portlet) of the Heirloom PaaS Dashboard is how you manage backups for your persistent data volumes (application files and databases) as well as restore new, running instances of your application from those backups. Access the Heirloom PaaS Dashboard through paas.heirloomcomputing.com > Sign In > Dashboard.
The backup and restoration subsystem uses proprietary technology to carry out scheduled and unscheduled backups in a manner similar to Enterprise IT shops that run large mainframe environments. The Heirloom PaaS Dashboard is the window in the System Operators (SysOps) operations activity you control through a browser.
The standard Heirloom PaaS paid subscription backup schedule consists of daily backups taken at approximately 2am UTC (4pm PDT, 7PM EDT). It is approximate because the time it takes to complete a backup varies depending upon the load of the underlying infrastructure. Daily backups are managed and converted to weekly (Sunday) each week. A daily backup from the first of each month is also converted to a monthly backup. All backups adhere to the following schedule:
- Daily backups with retention of 7 days
- Weekly backups with retention of 5 weeks
- Monthly backups with retention of 7 years (72 months)
An entire or full backup is taken of the underlying device housing your application files and database. For Windows-based Heirloom PaaS, this is the D: and/or F: drive. For Linux-based Heirloom PaaS environments this all files residing under /data or /hcc paths. A backup is replicated in 3 physical places. Although the original data volume resides on a single device, that device uses hardware (RAID-5) redundancy.
Typically backups are taken over a period of seconds. Because these backup transactions are not synced with your application, you may experience inconsistency among database records or file records. Standard database and database and file system checking (e.g., database undo/redo log application) are required should you restore from an in-use backup. Based on your subscription and level of instance concurrency associated with it, you can restore from one or more backups at once and use (application techniques) to move data records among the backups to your live system.
The actual volume snapshots are not accessible to you directly ... you cannot download or replicate them directly. Instead you use the Backup Portlet of the Heirloom PaaS Dashboard to "restore to a running instance". From that instance you can choose to download files using the instance's File Explorer.
Restoration of a backup tape implies the starting of a new instance of your application (with a new domain name to access it) and does not affect the running system. Restored systems are not meant to become "live" as the restored systems are temporary and the volumes associated with them will be removed when the instance is shut down. Use application techniques (or the file management interface provided to Heirloom PaaS instances) to move data between the restored instance and your production instance.
When you select a backup from the list available for a particular day a dialog box will show information about that particular backup.
The dialog indicates the type of backup (e.g., daily), the time it was taken and whether the backup was taken from a live running system (in-use), the integrity of the backup (100% Complete indicates a healthy backup) and whether you have restored it at any time prior to this date. From this dialog you can,
- Restore a volume by starting a new instance of your application,
- Delete the backup tape associated with the volume,
- Cancel out of the menu without acting on the backup tape.
- Inform your users that unscheduled maintenance is taking place, perhaps by redirecting your DNS alias from its current myapp.apps.elpaas.com to a Web server with a static page "System Unavailable"
- Use the Backup Portlet of the ELPaaS Dashboard to restore and start an instance from the most recent backup
- Verify the integrity of the application and its data using the restore URL given to you when restored
- Use the Instance Portlet to bring down your damaged application instance, if it is still running
- Use the Instance Portlet to bring down the working restoration instance r-xxxxxxx
- Use the Volume Portlet to rename the production (now not-in-use) volume to "myapp-old"
- Use the Volume Portlet to rename the r-xxxxxxxx restored version to your production myapp
- Use the Instance Portlet to start your new myapp instance
- Verify that your DNS redirection to myapp.apps.elpaas.com and, thus, to your working production instance.
- Use the Backup Portlet of the Heirloom PaaS Dashboard to restore and start an instance from the most recent backup
- Copy individual data files or conduct DB dump/restore from the restored system to the production system
- Use the Instance Portlet to terminate your restored instance. Its volume will eventually be removed (although the backup from which it was made can be re-restored at any time).