]> git.proxmox.com Git - proxmox-backup.git/blobdiff - src/api2/admin/datastore.rs
src/backup/prune.rs: add new helper keeps_something()
[proxmox-backup.git] / src / api2 / admin / datastore.rs
index e1fd5adff4c1df4e4a50f06911ce26b7ec02fed9..4264339b35181fde4c364259c8c20e73025ab2c9 100644 (file)
@@ -1,23 +1,49 @@
-use failure::*;
+use std::collections::{HashSet, HashMap};
 
-use crate::tools;
-use crate::api_schema::*;
-use crate::api_schema::router::*;
-//use crate::server::rest::*;
+use chrono::{TimeZone, Local};
+use failure::*;
+use futures::*;
+use hyper::http::request::Parts;
+use hyper::{header, Body, Response, StatusCode};
 use serde_json::{json, Value};
-use std::collections::{HashSet, HashMap};
-use chrono::{DateTime, Datelike, Local, TimeZone};
-use std::path::PathBuf;
-use std::sync::Arc;
 
-//use hyper::StatusCode;
-//use hyper::rt::{Future, Stream};
+use proxmox::{sortable, identity};
+use proxmox::api::{http_err, list_subdirs_api_method};
+use proxmox::api::{ApiFuture, ApiHandler, ApiMethod, Router, RpcEnvironment, RpcEnvironmentType};
+use proxmox::api::router::SubdirMap;
+use proxmox::api::schema::*;
+use proxmox::tools::{try_block, fs::file_get_contents, fs::file_set_contents};
 
+use crate::api2::types::*;
+use crate::backup::*;
 use crate::config::datastore;
+use crate::server::WorkerTask;
+use crate::tools;
 
-use crate::backup::*;
+fn read_backup_index(store: &DataStore, backup_dir: &BackupDir) -> Result<Value, Error> {
+
+    let mut path = store.base_path();
+    path.push(backup_dir.relative_path());
+    path.push("index.json.blob");
+
+    let raw_data = file_get_contents(&path)?;
+    let data = DataBlob::from_raw(raw_data)?.decode(None)?;
+    let index_size = data.len();
+    let mut result: Value = serde_json::from_reader(&mut &data[..])?;
 
-mod catar;
+    let mut result = result["files"].take();
+
+    if result == Value::Null {
+        bail!("missing 'files' property in backup index {:?}", path);
+    }
+
+    result.as_array_mut().unwrap().push(json!({
+        "filename": "index.json.blob",
+        "size": index_size,
+    }));
+
+    Ok(result)
+}
 
 fn group_backups(backup_list: Vec<BackupInfo>) -> HashMap<String, Vec<BackupInfo>> {
 
@@ -32,37 +58,17 @@ fn group_backups(backup_list: Vec<BackupInfo>) -> HashMap<String, Vec<BackupInfo
     group_hash
 }
 
-fn mark_selections<F: Fn(DateTime<Local>, &BackupInfo) -> String> (
-    mark: &mut HashSet<PathBuf>,
-    list: &Vec<BackupInfo>,
-    keep: usize,
-    select_id: F,
-){
-    let mut hash = HashSet::new();
-    for info in list {
-        let local_time = info.backup_dir.backup_time().with_timezone(&Local);
-        if hash.len() >= keep as usize { break; }
-        let backup_id = info.backup_dir.relative_path();
-        let sel_id: String = select_id(local_time, &info);
-        if !hash.contains(&sel_id) {
-            hash.insert(sel_id);
-            //println!(" KEEP ID {} {}", backup_id, local_time.format("%c"));
-            mark.insert(backup_id);
-        }
-    }
-}
-
 fn list_groups(
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    _rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
     let store = param["store"].as_str().unwrap();
 
     let datastore = DataStore::lookup_datastore(store)?;
 
-    let backup_list =  datastore.list_backups()?;
+    let backup_list = BackupInfo::list_backups(&datastore.base_path())?;
 
     let group_hash = group_backups(backup_list);
 
@@ -70,7 +76,7 @@ fn list_groups(
 
     for (_group_id, mut list) in group_hash {
 
-        list.sort_unstable_by(|a, b| b.backup_dir.backup_time().cmp(&a.backup_dir.backup_time())); // new backups first
+        BackupInfo::sort_list(&mut list, false);
 
         let info = &list[0];
         let group = info.backup_dir.group();
@@ -87,351 +93,571 @@ fn list_groups(
     Ok(json!(groups))
 }
 
-fn delete_snapshots (
+fn list_snapshot_files (
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    _rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
     let store = tools::required_string_param(&param, "store")?;
     let backup_type = tools::required_string_param(&param, "backup-type")?;
     let backup_id = tools::required_string_param(&param, "backup-id")?;
     let backup_time = tools::required_integer_param(&param, "backup-time")?;
-    let backup_time = Local.timestamp(backup_time, 0);
-
-    let snapshot = BackupDir::new(BackupGroup::new(backup_type, backup_id), backup_time);
 
     let datastore = DataStore::lookup_datastore(store)?;
+    let snapshot = BackupDir::new(backup_type, backup_id, backup_time);
 
-    datastore.remove_backup_dir(&snapshot)?;
+    let mut files = read_backup_index(&datastore, &snapshot)?;
 
-    Ok(Value::Null)
+    let info = BackupInfo::new(&datastore.base_path(), snapshot)?;
+
+    let file_set = files.as_array().unwrap().iter().fold(HashSet::new(), |mut acc, item| {
+        acc.insert(item["filename"].as_str().unwrap().to_owned());
+        acc
+    });
+
+    for file in info.files {
+        if file_set.contains(&file) { continue; }
+        files.as_array_mut().unwrap().push(json!({ "filename": file }));
+    }
+
+    Ok(files)
 }
 
-fn list_snapshots (
+fn delete_snapshots (
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    _rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
     let store = tools::required_string_param(&param, "store")?;
     let backup_type = tools::required_string_param(&param, "backup-type")?;
     let backup_id = tools::required_string_param(&param, "backup-id")?;
+    let backup_time = tools::required_integer_param(&param, "backup-time")?;
 
-    let group = BackupGroup::new(backup_type, backup_id);
+    let snapshot = BackupDir::new(backup_type, backup_id, backup_time);
 
     let datastore = DataStore::lookup_datastore(store)?;
 
-    let backup_list = datastore.list_backups()?;
+    datastore.remove_backup_dir(&snapshot)?;
 
-    let mut group_hash = group_backups(backup_list);
+    Ok(Value::Null)
+}
 
-    let group_id = group.group_path().to_str().unwrap().to_owned();
+fn list_snapshots (
+    param: Value,
+    _info: &ApiMethod,
+    _rpcenv: &mut dyn RpcEnvironment,
+) -> Result<Value, Error> {
 
-    let group_snapshots = match group_hash.get_mut(&group_id) {
-        Some(data) => {
-            // new backups first
-            data.sort_unstable_by(|a, b| b.backup_dir.backup_time().cmp(&a.backup_dir.backup_time()));
-            data
-        }
-        None => bail!("Backup group '{}' does not exists.", group_id),
-    };
+    let store = tools::required_string_param(&param, "store")?;
+    let backup_type = param["backup-type"].as_str();
+    let backup_id = param["backup-id"].as_str();
 
-    let mut snapshots = vec![];
+    let datastore = DataStore::lookup_datastore(store)?;
+
+    let base_path = datastore.base_path();
 
-    for info in group_snapshots {
+    let backup_list = BackupInfo::list_backups(&base_path)?;
 
+    let mut snapshots = vec![];
+
+    for info in backup_list {
         let group = info.backup_dir.group();
+        if let Some(backup_type) = backup_type {
+            if backup_type != group.backup_type() { continue; }
+        }
+        if let Some(backup_id) = backup_id {
+            if backup_id != group.backup_id() { continue; }
+        }
 
-        snapshots.push(json!({
+        let mut result_item = json!({
             "backup-type": group.backup_type(),
             "backup-id": group.backup_id(),
             "backup-time": info.backup_dir.backup_time().timestamp(),
             "files": info.files,
-        }));
+        });
+
+        if let Ok(index) = read_backup_index(&datastore, &info.backup_dir) {
+            let mut backup_size = 0;
+            for item in index.as_array().unwrap().iter() {
+                if let Some(item_size) = item["size"].as_u64() {
+                    backup_size += item_size;
+                }
+            }
+            result_item["size"] = backup_size.into();
+        }
+
+        snapshots.push(result_item);
     }
 
     Ok(json!(snapshots))
 }
 
-fn prune(
+fn status(
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    _rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
     let store = param["store"].as_str().unwrap();
 
     let datastore = DataStore::lookup_datastore(store)?;
 
-    println!("Starting prune on store {}", store);
+    let base_path = datastore.base_path();
 
-    let backup_list =  datastore.list_backups()?;
+    let mut stat: libc::statfs64 = unsafe { std::mem::zeroed() };
 
-    let group_hash = group_backups(backup_list);
+    use nix::NixPath;
 
-    for (_group_id, mut list) in group_hash {
+    let res = base_path.with_nix_path(|cstr| unsafe { libc::statfs64(cstr.as_ptr(), &mut stat) })?;
+    nix::errno::Errno::result(res)?;
 
-        let mut mark = HashSet::new();
+    let bsize = stat.f_bsize as u64;
+    Ok(json!({
+        "total": stat.f_blocks*bsize,
+        "used": (stat.f_blocks-stat.f_bfree)*bsize,
+        "avail": stat.f_bavail*bsize,
+    }))
+}
 
-        list.sort_unstable_by(|a, b| b.backup_dir.backup_time().cmp(&a.backup_dir.backup_time())); // new backups first
+#[macro_export]
+macro_rules! add_common_prune_prameters {
+    ( [ $( $list1:tt )* ] ) => {
+        add_common_prune_prameters!([$( $list1 )* ] ,  [])
+    };
+    ( [ $( $list1:tt )* ] ,  [ $( $list2:tt )* ] ) => {
+        [
+            $( $list1 )*
+            (
+                "keep-daily",
+                true,
+                &IntegerSchema::new("Number of daily backups to keep.")
+                    .minimum(1)
+                    .schema()
+            ),
+            (
+                "keep-last",
+                true,
+                &IntegerSchema::new("Number of backups to keep.")
+                    .minimum(1)
+                    .schema()
+            ),
+            (
+                "keep-monthly",
+                true,
+                &IntegerSchema::new("Number of monthly backups to keep.")
+                    .minimum(1)
+                    .schema()
+            ),
+            (
+                "keep-weekly",
+                true,
+                &IntegerSchema::new("Number of weekly backups to keep.")
+                    .minimum(1)
+                    .schema()
+            ),
+            (
+                "keep-yearly",
+                true,
+                &IntegerSchema::new("Number of yearly backups to keep.")
+                    .minimum(1)
+                    .schema()
+            ),
+            $( $list2 )*
+        ]
+    }
+}
 
-        if let Some(keep_last) = param["keep-last"].as_u64() {
-            list.iter().take(keep_last as usize).for_each(|info| {
-                mark.insert(info.backup_dir.relative_path());
-            });
-        }
+const API_METHOD_STATUS: ApiMethod = ApiMethod::new(
+    &ApiHandler::Sync(&status),
+    &ObjectSchema::new(
+        "Get datastore status.",
+        &add_common_prune_prameters!([],[
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+        ]),
+    )
+);
 
-        if let Some(keep_daily) = param["keep-daily"].as_u64() {
-            mark_selections(&mut mark, &list, keep_daily as usize, |local_time, _info| {
-                format!("{}/{}/{}", local_time.year(), local_time.month(), local_time.day())
-            });
-        }
+fn prune(
+    param: Value,
+    _info: &ApiMethod,
+    _rpcenv: &mut dyn RpcEnvironment,
+) -> Result<Value, Error> {
 
-        if let Some(keep_weekly) = param["keep-weekly"].as_u64() {
-            mark_selections(&mut mark, &list, keep_weekly as usize, |local_time, _info| {
-                format!("{}/{}", local_time.year(), local_time.iso_week().week())
-            });
-        }
+    let store = param["store"].as_str().unwrap();
 
-        if let Some(keep_monthly) = param["keep-monthly"].as_u64() {
-            mark_selections(&mut mark, &list, keep_monthly as usize, |local_time, _info| {
-                format!("{}/{}", local_time.year(), local_time.month())
-            });
-        }
+    let backup_type = tools::required_string_param(&param, "backup-type")?;
+    let backup_id = tools::required_string_param(&param, "backup-id")?;
+
+    let group = BackupGroup::new(backup_type, backup_id);
+
+    let datastore = DataStore::lookup_datastore(store)?;
+
+    let prune_options = PruneOptions {
+        keep_last: param["keep-last"].as_u64(),
+        keep_daily: param["keep-daily"].as_u64(),
+        keep_weekly: param["keep-weekly"].as_u64(),
+        keep_monthly: param["keep-monthly"].as_u64(),
+        keep_yearly: param["keep-yearly"].as_u64(),
+    };
 
-        if let Some(keep_yearly) = param["keep-yearly"].as_u64() {
-            mark_selections(&mut mark, &list, keep_yearly as usize, |local_time, _info| {
-                format!("{}/{}", local_time.year(), local_time.year())
-            });
+    let worker = WorkerTask::new("prune", Some(store.to_owned()), "root@pam", true)?;
+    let result = try_block! {
+        if !prune_options.keeps_something() {
+            worker.log("No prune selection - keeping all files.");
+            return Ok(());
+        } else {
+            worker.log(format!("Starting prune on store {}", store));
         }
 
-        let mut remove_list: Vec<&BackupInfo> = list.iter()
-            .filter(|info| !mark.contains(&info.backup_dir.relative_path())).collect();
+        let list = group.list_backups(&datastore.base_path())?;
 
-        remove_list.sort_unstable_by(|a, b| a.backup_dir.backup_time().cmp(&b.backup_dir.backup_time())); // oldest backups first
+        let mut prune_info = compute_prune_info(list, &prune_options)?;
 
-        for info in remove_list {
-            datastore.remove_backup_dir(&info.backup_dir)?;
+        prune_info.reverse(); // delete older snapshots first
+
+        for (info, keep) in prune_info {
+            if keep {
+                worker.log(format!("keep {:?}", info.backup_dir.relative_path()));
+            } else {
+                worker.log(format!("remove {:?}", info.backup_dir.relative_path()));
+                datastore.remove_backup_dir(&info.backup_dir)?;
+            }
         }
-    }
 
-    Ok(json!(null))
-}
+        Ok(())
+    };
 
-pub fn add_common_prune_prameters(schema: ObjectSchema) -> ObjectSchema  {
+    worker.log_result(&result);
 
-    schema
-        .optional(
-            "keep-last",
-            IntegerSchema::new("Number of backups to keep.")
-                .minimum(1)
-        )
-        .optional(
-            "keep-daily",
-            IntegerSchema::new("Number of daily backups to keep.")
-                .minimum(1)
-        )
-        .optional(
-            "keep-weekly",
-            IntegerSchema::new("Number of weekly backups to keep.")
-                .minimum(1)
-        )
-        .optional(
-            "keep-monthly",
-            IntegerSchema::new("Number of monthly backups to keep.")
-                .minimum(1)
-        )
-        .optional(
-            "keep-yearly",
-            IntegerSchema::new("Number of yearly backups to keep.")
-                .minimum(1)
-        )
+    if let Err(err) = result {
+        bail!("prune failed - {}", err);
+    }
+
+    Ok(json!(null))
 }
 
-fn api_method_prune() -> ApiMethod {
-    ApiMethod::new(
-        prune,
-        add_common_prune_prameters(
-            ObjectSchema::new("Prune the datastore.")
-                .required(
-                    "store",
-                    StringSchema::new("Datastore name.")
-                )
-        )
+const API_METHOD_PRUNE: ApiMethod = ApiMethod::new(
+    &ApiHandler::Sync(&prune),
+    &ObjectSchema::new(
+        "Prune the datastore.",
+        &add_common_prune_prameters!([
+            ("backup-id", false, &BACKUP_ID_SCHEMA),
+            ("backup-type", false, &BACKUP_TYPE_SCHEMA),
+        ],[
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+        ])
     )
-}
+);
 
-// this is just a test for mutability/mutex handling  - will remove later
 fn start_garbage_collection(
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
-    let store = param["store"].as_str().unwrap();
+    let store = param["store"].as_str().unwrap().to_string();
 
-    let datastore = DataStore::lookup_datastore(store)?;
+    let datastore = DataStore::lookup_datastore(&store)?;
 
     println!("Starting garbage collection on store {}", store);
 
-    datastore.garbage_collection()?;
+    let to_stdout = if rpcenv.env_type() == RpcEnvironmentType::CLI { true } else { false };
 
-    Ok(json!(null))
+    let upid_str = WorkerTask::new_thread(
+        "garbage_collection", Some(store.clone()), "root@pam", to_stdout, move |worker|
+        {
+            worker.log(format!("starting garbage collection on store {}", store));
+            datastore.garbage_collection(worker)
+        })?;
+
+    Ok(json!(upid_str))
 }
 
-pub fn api_method_start_garbage_collection() -> ApiMethod {
-    ApiMethod::new(
-        start_garbage_collection,
-        ObjectSchema::new("Start garbage collection.")
-            .required("store", StringSchema::new("Datastore name."))
+#[sortable]
+pub const API_METHOD_START_GARBAGE_COLLECTION: ApiMethod = ApiMethod::new(
+    &ApiHandler::Sync(&start_garbage_collection),
+    &ObjectSchema::new(
+        "Start garbage collection.",
+        &sorted!([
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+        ])
     )
-}
+);
 
 fn garbage_collection_status(
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
+    _rpcenv: &mut dyn RpcEnvironment,
 ) -> Result<Value, Error> {
 
     let store = param["store"].as_str().unwrap();
 
+    let datastore = DataStore::lookup_datastore(&store)?;
+
     println!("Garbage collection status on store {}", store);
 
-    Ok(json!(null))
+    let status = datastore.last_gc_status();
 
+    Ok(serde_json::to_value(&status)?)
 }
 
-pub fn api_method_garbage_collection_status() -> ApiMethod {
-    ApiMethod::new(
-        garbage_collection_status,
-        ObjectSchema::new("Garbage collection status.")
-            .required("store", StringSchema::new("Datastore name."))
+#[sortable]
+pub const API_METHOD_GARBAGE_COLLECTION_STATUS: ApiMethod = ApiMethod::new(
+    &ApiHandler::Sync(&garbage_collection_status),
+    &ObjectSchema::new(
+        "Garbage collection status.",
+        &sorted!([
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+        ])
     )
+);
+
+fn get_datastore_list(
+    _param: Value,
+    _info: &ApiMethod,
+    _rpcenv: &mut dyn RpcEnvironment,
+) -> Result<Value, Error> {
+
+    let config = datastore::config()?;
+
+    Ok(config.convert_to_array("store"))
 }
 
-fn get_backup_list(
+
+fn download_file(
+    _parts: Parts,
+    _req_body: Body,
     param: Value,
     _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
-) -> Result<Value, Error> {
+    _rpcenv: Box<dyn RpcEnvironment>,
+) -> ApiFuture {
 
-    //let config = datastore::config()?;
+    async move {
+        let store = tools::required_string_param(&param, "store")?;
 
-    let store = param["store"].as_str().unwrap();
+        let datastore = DataStore::lookup_datastore(store)?;
 
-    let datastore = DataStore::lookup_datastore(store)?;
+        let file_name = tools::required_string_param(&param, "file-name")?.to_owned();
 
-    let mut list = vec![];
+        let backup_type = tools::required_string_param(&param, "backup-type")?;
+        let backup_id = tools::required_string_param(&param, "backup-id")?;
+        let backup_time = tools::required_integer_param(&param, "backup-time")?;
 
-    for info in datastore.list_backups()? {
-        list.push(json!({
-            "backup-type": info.backup_dir.group().backup_type(),
-            "backup-id": info.backup_dir.group().backup_id(),
-            "backup-time": info.backup_dir.backup_time().timestamp(),
-            "files": info.files,
-        }));
-    }
+        println!("Download {} from {} ({}/{}/{}/{})", file_name, store,
+                 backup_type, backup_id, Local.timestamp(backup_time, 0), file_name);
 
-    let result = json!(list);
+        let backup_dir = BackupDir::new(backup_type, backup_id, backup_time);
 
-    Ok(result)
-}
+        let mut path = datastore.base_path();
+        path.push(backup_dir.relative_path());
+        path.push(&file_name);
 
-fn get_datastore_list(
-    _param: Value,
-    _info: &ApiMethod,
-    _rpcenv: &mut RpcEnvironment,
-) -> Result<Value, Error> {
+        let file = tokio::fs::File::open(path)
+            .map_err(|err| http_err!(BAD_REQUEST, format!("File open failed: {}", err)))
+            .await?;
 
-    let config = datastore::config()?;
+        let payload = tokio::codec::FramedRead::new(file, tokio::codec::BytesCodec::new())
+            .map_ok(|bytes| hyper::Chunk::from(bytes.freeze()));
+        let body = Body::wrap_stream(payload);
 
-    Ok(config.convert_to_array("store"))
+        // fixme: set other headers ?
+        Ok(Response::builder()
+           .status(StatusCode::OK)
+           .header(header::CONTENT_TYPE, "application/octet-stream")
+           .body(body)
+           .unwrap())
+    }.boxed()
 }
 
+#[sortable]
+pub const API_METHOD_DOWNLOAD_FILE: ApiMethod = ApiMethod::new(
+    &ApiHandler::AsyncHttp(&download_file),
+    &ObjectSchema::new(
+        "Download single raw file from backup snapshot.",
+        &sorted!([
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+            ("backup-type", false, &BACKUP_TYPE_SCHEMA),
+            ("backup-id", false,  &BACKUP_ID_SCHEMA),
+            ("backup-time", false, &BACKUP_TIME_SCHEMA),
+            ("file-name", false, &StringSchema::new("Raw file name.")
+             .format(&FILENAME_FORMAT)
+             .schema()
+            ),
+        ]),
+    )
+);
 
-pub fn router() -> Router {
-
-    let store_schema: Arc<Schema> = Arc::new(
-        StringSchema::new("Datastore name.").into()
-    );
-
-    let datastore_info = Router::new()
-        .get(ApiMethod::new(
-            |_,_,_| Ok(json!([
-                {"subdir": "backups" },
-                {"subdir": "catar" },
-                {"subdir": "gc" },
-                {"subdir": "groups" },
-                {"subdir": "snapshots" },
-                {"subdir": "status" },
-                {"subdir": "prune" },
-           ])),
-            ObjectSchema::new("Directory index.")
-                .required("store", store_schema.clone()))
-        )
-        .subdir(
-            "backups",
-            Router::new()
-                .get(ApiMethod::new(
-                    get_backup_list,
-                    ObjectSchema::new("List backups.")
-                        .required("store", store_schema.clone()))))
-        .subdir(
-            "catar",
-            Router::new()
-                .download(catar::api_method_download_catar())
-                .upload(catar::api_method_upload_catar()))
-        .subdir(
-            "gc",
-            Router::new()
-                .get(api_method_garbage_collection_status())
-                .post(api_method_start_garbage_collection()))
-        .subdir(
-            "groups",
-            Router::new()
-                .get(ApiMethod::new(
-                    list_groups,
-                    ObjectSchema::new("List backup groups.")
-                        .required("store", store_schema.clone()))))
-        .subdir(
-            "snapshots",
-            Router::new()
-                .get(
-                    ApiMethod::new(
-                        list_snapshots,
-                        ObjectSchema::new("List backup groups.")
-                            .required("store", store_schema.clone())
-                            .required("backup-type", StringSchema::new("Backup type."))
-                            .required("backup-id", StringSchema::new("Backup ID."))
-                    )
-                )
-                .delete(
-                    ApiMethod::new(
-                        delete_snapshots,
-                        ObjectSchema::new("Delete backup snapshot.")
-                            .required("store", store_schema.clone())
-                            .required("backup-type", StringSchema::new("Backup type."))
-                            .required("backup-id", StringSchema::new("Backup ID."))
-                            .required("backup-time", IntegerSchema::new("Backup time (Unix epoch.)")
-                                      .minimum(1547797308))
-                    )
-                )
-        )
-        .subdir(
-            "prune",
-            Router::new()
-                .post(api_method_prune()));
+fn upload_backup_log(
+    _parts: Parts,
+    req_body: Body,
+    param: Value,
+    _info: &ApiMethod,
+    _rpcenv: Box<dyn RpcEnvironment>,
+) -> ApiFuture {
 
+    async move {
+        let store = tools::required_string_param(&param, "store")?;
 
+        let datastore = DataStore::lookup_datastore(store)?;
 
-    let route = Router::new()
-        .get(ApiMethod::new(
-            get_datastore_list,
-            ObjectSchema::new("Directory index.")))
-        .match_all("store", datastore_info);
+        let file_name = "client.log.blob";
 
+        let backup_type = tools::required_string_param(&param, "backup-type")?;
+        let backup_id = tools::required_string_param(&param, "backup-id")?;
+        let backup_time = tools::required_integer_param(&param, "backup-time")?;
 
+        let backup_dir = BackupDir::new(backup_type, backup_id, backup_time);
 
-    route
+        let mut path = datastore.base_path();
+        path.push(backup_dir.relative_path());
+        path.push(&file_name);
+
+        if path.exists() {
+            bail!("backup already contains a log.");
+        }
+
+        println!("Upload backup log to {}/{}/{}/{}/{}", store,
+                 backup_type, backup_id, BackupDir::backup_time_to_string(backup_dir.backup_time()), file_name);
+
+        let data = req_body
+            .map_err(Error::from)
+            .try_fold(Vec::new(), |mut acc, chunk| {
+                acc.extend_from_slice(&*chunk);
+                future::ok::<_, Error>(acc)
+            })
+            .await?;
+
+        let blob = DataBlob::from_raw(data)?;
+        // always verify CRC at server side
+        blob.verify_crc()?;
+        let raw_data = blob.raw_data();
+        file_set_contents(&path, raw_data, None)?;
+
+        // fixme: use correct formatter
+        Ok(crate::server::formatter::json_response(Ok(Value::Null)))
+    }.boxed()
 }
+
+#[sortable]
+pub const API_METHOD_UPLOAD_BACKUP_LOG: ApiMethod = ApiMethod::new(
+    &ApiHandler::AsyncHttp(&upload_backup_log),
+    &ObjectSchema::new(
+        "Download single raw file from backup snapshot.",
+        &sorted!([
+            ("store", false, &StringSchema::new("Datastore name.").schema()),
+            ("backup-type", false, &BACKUP_TYPE_SCHEMA),
+            ("backup-id", false, &BACKUP_ID_SCHEMA),
+            ("backup-time", false, &BACKUP_TIME_SCHEMA),
+        ]),
+    )
+);
+
+const STORE_SCHEMA: Schema = StringSchema::new("Datastore name.").schema();
+
+#[sortable]
+const DATASTORE_INFO_SUBDIRS: SubdirMap = &[
+    (
+        "download",
+        &Router::new()
+            .download(&API_METHOD_DOWNLOAD_FILE)
+    ),
+    (
+        "files",
+        &Router::new()
+            .get(
+                &ApiMethod::new(
+                    &ApiHandler::Sync(&list_snapshot_files),
+                    &ObjectSchema::new(
+                        "List snapshot files.",
+                        &sorted!([
+                            ("store", false, &STORE_SCHEMA),
+                            ("backup-type", false, &BACKUP_TYPE_SCHEMA),
+                            ("backup-id", false, &BACKUP_ID_SCHEMA),
+                            ("backup-time", false, &BACKUP_TIME_SCHEMA),
+                        ]),
+                    )
+                )
+            )
+    ),
+    (
+        "gc",
+        &Router::new()
+            .get(&API_METHOD_GARBAGE_COLLECTION_STATUS)
+            .post(&API_METHOD_START_GARBAGE_COLLECTION)
+    ),
+    (
+        "groups",
+        &Router::new()
+            .get(
+                &ApiMethod::new(
+                    &ApiHandler::Sync(&list_groups),
+                    &ObjectSchema::new(
+                        "List backup groups.",
+                        &sorted!([ ("store", false, &STORE_SCHEMA) ]),
+                    )
+                )
+            )
+    ),
+    (
+        "prune",
+        &Router::new()
+            .post(&API_METHOD_PRUNE)
+    ),
+    (
+        "snapshots",
+        &Router::new()
+            .get(
+                &ApiMethod::new(
+                    &ApiHandler::Sync(&list_snapshots),
+                    &ObjectSchema::new(
+                        "List backup groups.",
+                        &sorted!([
+                            ("store", false, &STORE_SCHEMA),
+                            ("backup-type", true, &BACKUP_TYPE_SCHEMA),
+                            ("backup-id", true, &BACKUP_ID_SCHEMA),
+                        ]),
+                    )
+                )
+            )
+            .delete(
+                &ApiMethod::new(
+                    &ApiHandler::Sync(&delete_snapshots),
+                    &ObjectSchema::new(
+                        "Delete backup snapshot.",
+                        &sorted!([
+                            ("store", false, &STORE_SCHEMA),
+                            ("backup-type", false, &BACKUP_TYPE_SCHEMA),
+                            ("backup-id", false, &BACKUP_ID_SCHEMA),
+                            ("backup-time", false, &BACKUP_TIME_SCHEMA),
+                        ]),
+                    )
+                )
+            )
+    ),
+    (
+        "status",
+        &Router::new()
+            .get(&API_METHOD_STATUS)
+    ),
+    (
+        "upload-backup-log",
+        &Router::new()
+            .upload(&API_METHOD_UPLOAD_BACKUP_LOG)
+    ),
+];
+
+const DATASTORE_INFO_ROUTER: Router = Router::new()
+    .get(&list_subdirs_api_method!(DATASTORE_INFO_SUBDIRS))
+    .subdirs(DATASTORE_INFO_SUBDIRS);
+
+
+pub const ROUTER: Router = Router::new()
+    .get(
+        &ApiMethod::new(
+            &ApiHandler::Sync(&get_datastore_list),
+            &ObjectSchema::new("Directory index.", &[])
+        )
+    )
+    .match_all("store", &DATASTORE_INFO_ROUTER);