V2 Backups

V2Master | V2HighLevelDesign

Introduction

This page describes:

  1. How application data (e.g. all application data and state) for individual V2 applications are managed
  2. How backups for individual V2 applications are structured
  3. How backups for VMs are structured
  4. How multiple VM are consolidated on the host server
  5. How multiple server backups consolidated to a backup server

Definitions

  1. Application - An application or service that manages its state in a database and/or a set of data files

  2. VM - A virtual machine, in which (supporting) services and/or applications are run

    1. One or more Applications run on a VM. The limit is set by the capacity of the VM

  3. Server - A hardware/software platform supporting a set of services and application VMs

    1. One or more VMs run on a Server, limited by the capacity of the Server

  4. Service - A host or network service that supports Applications and their underlying infrastructure (see Services)

The entire infrastructure can be scaled by adding additional VMs and Servers

Services

Each Host System must have:

  1. DNS server in a VM that resolves the internal names and IP address of the VMs

  2. Forwarding-only DNS server that forward DNS requests to the DNS server VM

  3. rinetd daemon that forwards incoming TCP traffic to the appropriate VM based on the port number. Typically

    1. All web traffic (ports 80 and 443) is forwarded to the Reverse Proxy server

    2. Note that DNS traffic, which uses both TCP and UDP protocols, is managed by the Host System's forwarding-only DNS server
    3. If the Host System has a VM with a Puppet server then port 8140 is forwarded to it

  4. Reverse Proxy, an Apache module in a web server VM, that forward web requests to the appropriate VM based on the hostname in the HTTP request

Additional services that might be found on a Host System:

  1. Outward facing DNS
  2. Puppet master server

Requirements

Application Data Management Requirements

  1. To ensure good application/service performance given a server consisting of:
    1. RAM, typically 16-32 GB
    2. SSD, typically 128-256 GB
    3. RAID1 HD, typically two 1-3 TB

Recommendation:

  1. On SSD:
    1. Base OS and application support services (web-server, database server, etc.) on SSD
    2. Application footprint, reduced to the actively accessed data (application code, libraries, configuration, database, logs)
  2. On HD
    1. Applications data, revision and attachment files on the RAID hard disk

  3. Issue where to store thumbnail images?

Backup Requirements

  1. To guarantee that the data required to completely restore or duplicate an instance of a application is always available. At a minimum the data to be backed up includes:
    1. The application's files
    2. The application's database
  2. Backups should be made automatically on a nightly basis
  3. The backup data should be stored:
    1. On one or more backup servers
    2. On one or more off-site storage devices (typically USB drives)
  4. There should not a lot of effort required to re-configure backups if an application is moved from one VM or Server to another

Server Backups

Backups Tiers

  1. There are multiple backups tiers. They are, starting from the lowest tier:

    1. Application - Individual application and service backups, hosted on virtual machines

    2. VM - Virtual machine backups, hosted on servers

    3. Local Backups - Backups of multiple VMs on running locally on the server

    4. Remote Backups - Backups of other servers' local backups. E.g. multiple local backups copied from other servers

  2. There is a naming convention that provides unique paths to backups, such that all backup data can be found given:

    1. The application's or service's relpath, e.g. virtual host name and relative path to the application

    2. The VM name on which it runs

    3. The fully qualified domain name of the Server that hosts the VM

  3. The directory structures of the backups, at each backup level, are defined such that it is possible to make:
    1. Remote backups of local backups by copying the entire local backup, without needing to know the details of the VMs and applicationbackups
    2. On VMs backups of application can be made to a well known directory, mounted from the host system, without needing to know the details of remote and local backs

  4. TODO For monitoring: Backup tasks should create backup history files containing:

    1. File name: backup-{name}-{yyyymmdd}, containing:

      1. Number of files
      2. Number of MB of data

    2. Stored in a {history} directory

Backup Paths

  1. Local and Remote backups:

    1. partition = Absolute path to the remote backup directory. Typically: /v01/backup

    2. server = The fully qualified domain name where the local backup is located

    3. Paths to remote and local backup directories: 
      {partition}/remote/{server}            E.g. /v01/backup/remote/zg-1.softxs.ch
{partition}/local                      E.g. /v01/backup/local

  2. Application and Service backups:

    1. relpath = The relative path to the application backup directory. Composed of:

      1. virtual host name - The fully qualified domain name of the virtual host over which the application is provided

      2. relative path - The relative path used to address the application

    2. Example: The rails application http://demo.softxs.ch/hydro, hosted on the server zg-3.softxs.ch in the VM web, which has the relpath v2.softxs.ch/hydro, and its remote and local backups would be located at:

      1. As a local backup: 
        {partition}/local/{vm}/{relpath}             E.g. /v01/backup/local/web/v2.softxs.ch/hydro
      2. As a remote backup: 
        {partition}/remote/{server}/{vm}/{relname}   E.g. /v01/backup/zg-3.softxs.ch/v2.softxs.ch/hydro

  3. Local backups are performed on VMs (or directly on servers when there is no VM) by individual application jobs that push their backup data to the local server's backup directory

    1. The details of what is backed up and how the backup is structured depends on type of application being backed up

    2. See TODO (link to section below) for more details

  4. Remote backups are made by backup servers that pull data from the remote server's local backup directory to their remote backup directory

    1. Example of commands that could be used as remote backup jobs: 
      rsync -a zg-3.softxs.ch:/v01/backup/local/ /v01/remote/backup/zg-3.softxs.ch/
rsync -a odin.softxs.ch:/v01/backup/local/ /v01/remote/backup/odin.softxs.ch/
...

Application Data Management

Backup Types

  1. Rails applications (specifically applications installed by Capistano)

  2. DrawMGT applications
  3. Wiki systems
  4. CVS and GIT repositories
  5. Email repositories

  6. WordPress systems

== Rails Applications =

Rails Application Directory Structure

This is limited to rails applications installed by Capistrano

  1. Capistrano notes:
    1. Rails applications are deployed by Capistrano, which imposes a well-defined directory structure
      1. Supports keeping the codebase of older revisions, and the ability to rollback releases
        1. Provided you can rollback the database migration.

      2. Supports a common directory containing the Rails bundle and other information doesn't change between releases

  2. Local Capistrano extensions:

    1. TODO backup directory

    2. TODO delayed job management

Rails Application Installation Directories

  1. usr = rails application user. Typically v2

  2. name' = application installation name 

    /home/{user}/rails/{name}              Symbolic link to {name}-app/current/public
/home/{user}/rails/{name}-app          Application installation directory

Rails Application Internal Directory Structure

  1. name = application installation name

  2. yymmddhhmmss = release timestamp 

    {name}                                  Symbolic link to {name}-app/current/public
{name}-app
  current                               Symbolic link to releases/{yymmhhmmhhss}. E.g. the current release
  releases
    yymmddhhmmss                        Root rails application directory. Approx. 16 MB. We backup older releases
      app
      config
      ...
    yymmddhhmmss
    yymmddhhmmss
    ...
  shared
    assets                              Small? Appears to be empty
    backup                              Small, only contains backups made during software updates
    bundle                              Large, 130 MB. On SSD
    log                                 Can get large, needs log rotation. On SSD
    pids                                Small
    system                              Empty
    var                                 Symbolic link to data directory. Very large. Contains all file_assets. On HD

Rails Data Directory Structure

  1. The rails application var, which contains all the file_assets is stored on the hard disk

  2. A symbolic link at {name}-app/shared/var points to the applications data directory 

    /v01/rails/data/{relpath}/{name}/var

Rails Backup Directory Structure

  1. vm = VM directory name. E.g. /home/v2/rails/vms/vm

  2. path = Virtual hostname and relative path. E.g. v2.softxs.ch/v2p0-jk1 

    /v01/backup/{vm}/{path}

Rails Application Backup Job

  1. Dump database with timestamp to the backup/db directory

  2. Rsync the following

    1. releases --> backup/releases

    2. shared --> backup/shared

    3. /data/var --> backup/shared

MoinMoin Wiki Directory structure

Backup Directory Structures

Application Backup Directories

VM Backup Directories

Backup Server Backup Directories

Summary of Backup Systems

See also V2VirtualServers and V2DeploymentInstances.

Copyright 2008-2014, SoftXS GmbH, Switzerland