snapshot_manager.h

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the Apache 2.0 License.
#pragma once
 
#include "ccf/ds/nonstd.h"
#include "consensus/ledger_enclave_types.h"
#include "host/time_bound_logger.h"
#include "snapshots/filenames.h"
 
#include <charconv>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <optional>
 
namespace fs = std::filesystem;
 
namespace snapshots
{
  class SnapshotManager
  {
  private:
    ringbuffer::WriterPtr to_enclave;
 
    const fs::path snapshot_dir;
    const std::optional<fs::path> read_snapshot_dir = std::nullopt;
    struct PendingSnapshot
    {
      ::consensus::Index evidence_idx;
      std::shared_ptr<std::vector<uint8_t>> snapshot;
    };
    std::map<size_t, PendingSnapshot> pending_snapshots;
 
  public:
    SnapshotManager(
      const std::string& snapshot_dir_,
      ringbuffer::AbstractWriterFactory& writer_factory,
      const std::optional<std::string>& read_snapshot_dir_ = std::nullopt) :
      to_enclave(writer_factory.create_writer_to_inside()),
      snapshot_dir(snapshot_dir_),
      read_snapshot_dir(read_snapshot_dir_)
    {
      if (fs::is_directory(snapshot_dir))
      {
        LOG_INFO_FMT(
          "Snapshots will be stored in existing directory: {}", snapshot_dir);
      }
      else
      {
        asynchost::TimeBoundLogger log_if_slow(fmt::format(
          "Creating snapshot directory - create_directory({})", snapshot_dir));
        if (!fs::create_directory(snapshot_dir))
        {
          throw std::logic_error(fmt::format(
            "Could not create snapshot directory: {}", snapshot_dir));
        }
      }
 
      if (
        read_snapshot_dir.has_value() &&
        !fs::is_directory(read_snapshot_dir.value()))
      {
        throw std::logic_error(fmt::format(
          "{} read-only snapshot is not a directory",
          read_snapshot_dir.value()));
      }
    }
 
    SnapshotManager(const SnapshotManager&) = delete;
    SnapshotManager& operator=(const SnapshotManager&) = delete;
 
    [[nodiscard]] fs::path get_main_directory() const
    {
      return snapshot_dir;
    }
 
    std::shared_ptr<std::vector<uint8_t>> add_pending_snapshot(
      ::consensus::Index idx,
      ::consensus::Index evidence_idx,
      size_t requested_size)
    {
      auto snapshot = std::make_shared<std::vector<uint8_t>>(requested_size);
      pending_snapshots.emplace(idx, PendingSnapshot{evidence_idx, snapshot});
 
      LOG_DEBUG_FMT(
        "Added pending snapshot {} [{} bytes]", idx, requested_size);
 
      return snapshot;
    }
 
#define THROW_ON_ERROR(x, name) \
  do \
  { \
    auto rc = x; \
    if (rc == -1) \
    { \
      throw std::runtime_error( \
        fmt::format(/* NOLINTNEXTLINE(concurrency-mt-unsafe) */ \
                    "Error ({}) writing snapshot {} in " #x, \
                    strerror(errno), \
                    name)); \
    } \
  } while (0)
 
    struct AsyncSnapshotSyncAndRename
    {
      // Inputs, populated at construction
      const std::filesystem::path dir;
      const std::string tmp_file_name;
      const int snapshot_fd;
 
      // Outputs, populated by callback
      std::string committed_file_name;
    };
 
    static void on_snapshot_sync_and_rename(uv_work_t* req)
    {
      auto* data = static_cast<AsyncSnapshotSyncAndRename*>(req->data);
 
      {
        asynchost::TimeBoundLogger log_if_slow(
          fmt::format("Committing snapshot - fsync({})", data->tmp_file_name));
        fsync(data->snapshot_fd); // NOLINT(concurrency-mt-unsafe)
      }
 
      {
        asynchost::TimeBoundLogger log_if_slow(fmt::format(
          "Closing snapshot file - close({})", data->tmp_file_name));
        close(data->snapshot_fd); // NOLINT(concurrency-mt-unsafe)
      }
 
      // e.g. snapshot_100_105.committed
      data->committed_file_name =
        fmt::format("{}{}", data->tmp_file_name, snapshot_committed_suffix);
      const auto full_committed_path = data->dir / data->committed_file_name;
 
      const auto full_tmp_path = data->dir / data->tmp_file_name;
      {
        asynchost::TimeBoundLogger log_if_slow(fmt::format(
          "Renaming snapshot to committed - rename({})", data->tmp_file_name));
        files::rename(full_tmp_path, full_committed_path);
      }
    }
 
    static void on_snapshot_sync_and_rename_complete(
      uv_work_t* req, int /*status*/)
    {
      auto* data = static_cast<AsyncSnapshotSyncAndRename*>(req->data);
 
      LOG_INFO_FMT(
        "Renamed temporary snapshot {} to {}",
        data->tmp_file_name,
        data->committed_file_name);
 
      delete data; // NOLINT(cppcoreguidelines-owning-memory)
      delete req; // NOLINT(cppcoreguidelines-owning-memory)
    }
 
    void commit_snapshot(
      ::consensus::Index snapshot_idx,
      const uint8_t* receipt_data,
      size_t receipt_size)
    {
      asynchost::TimeBoundLogger log_if_slow(
        fmt::format("Committing snapshot - snapshot_idx={}", snapshot_idx));
 
      try
      {
        for (auto it = pending_snapshots.begin(); it != pending_snapshots.end();
             it++)
        {
          if (snapshot_idx == it->first)
          {
            // e.g. snapshot_100_105
            auto file_name = fmt::format(
              "{}{}{}{}{}",
              snapshot_file_prefix,
              snapshot_idx_delimiter,
              it->first,
              snapshot_idx_delimiter,
              it->second.evidence_idx);
            auto full_snapshot_path = snapshot_dir / file_name;
 
            int snapshot_fd = -1;
            {
              asynchost::TimeBoundLogger log_open_if_slow(
                fmt::format("Opening snapshot file - open({})", file_name));
              snapshot_fd = open(
                full_snapshot_path.c_str(), O_CREAT | O_EXCL | O_WRONLY, 0664);
            }
            if (snapshot_fd == -1)
            {
              if (errno == EEXIST)
              {
                // In the case that a file with this name already exists, keep
                // existing file and drop pending snapshot
                LOG_FAIL_FMT(
                  "Cannot write snapshot as file already exists: {}",
                  file_name);
              }
              else
              {
                LOG_FAIL_FMT(
                  "Cannot write snapshot: error ({}) opening file {}",
                  errno,
                  file_name);
              }
            }
            else
            {
              const auto& snapshot = it->second.snapshot;
 
              {
                asynchost::TimeBoundLogger log_write_if_slow(fmt::format(
                  "Writing snapshot data ({} bytes) - write({})",
                  snapshot->size(),
                  file_name));
                // NOLINTNEXTLINE(concurrency-mt-unsafe)
                THROW_ON_ERROR(
                  write(snapshot_fd, snapshot->data(), snapshot->size()),
                  file_name);
              }
              {
                asynchost::TimeBoundLogger log_write_if_slow(fmt::format(
                  "Writing snapshot receipt ({} bytes) - write({})",
                  receipt_size,
                  file_name));
                // NOLINTNEXTLINE(concurrency-mt-unsafe)
                THROW_ON_ERROR(
                  write(snapshot_fd, receipt_data, receipt_size), file_name);
              }
 
              LOG_INFO_FMT(
                "New snapshot file written to {} [{} bytes] (unsynced)",
                file_name,
                snapshot->size() + receipt_size);
 
              // Call fsync and rename on a worker-thread via uv async, as they
              // may be slow
              // NOLINTNEXTLINE(cppcoreguidelines-owning-memory)
              auto* work_handle = new uv_work_t;
 
              {
                // NOLINTNEXTLINE(cppcoreguidelines-owning-memory)
                auto* data = new AsyncSnapshotSyncAndRename{
                  .dir = snapshot_dir,
                  .tmp_file_name = file_name,
                  .snapshot_fd = snapshot_fd,
                  .committed_file_name = {}};
 
                work_handle->data = data;
              }
 
#ifdef TEST_MODE_EXECUTE_SYNC_INLINE
              on_snapshot_sync_and_rename(work_handle);
              on_snapshot_sync_and_rename_complete(work_handle, 0);
#else
              uv_queue_work(
                uv_default_loop(),
                work_handle,
                &on_snapshot_sync_and_rename,
                &on_snapshot_sync_and_rename_complete);
#endif
            }
 
            pending_snapshots.erase(it);
 
            return;
          }
        }
 
        LOG_FAIL_FMT("Could not find snapshot to commit at {}", snapshot_idx);
      }
      catch (std::exception& e)
      {
        LOG_FAIL_FMT(
          "Exception while attempting to commit snapshot at {}: {}",
          snapshot_idx,
          e.what());
      }
    }
#undef THROW_ON_ERROR
 
    std::optional<fs::path> find_latest_committed_snapshot()
    {
      std::vector<fs::path> directories;
      directories.push_back(snapshot_dir);
      if (read_snapshot_dir.has_value())
      {
        directories.push_back(read_snapshot_dir.value());
      }
      return find_latest_committed_snapshot_in_directories(directories);
    }
 
    void register_message_handlers(
      messaging::Dispatcher<ringbuffer::Message>& disp)
    {
      DISPATCHER_SET_MESSAGE_HANDLER(
        disp,
        ::consensus::snapshot_allocate,
        [this](const uint8_t* data, size_t size) {
          auto idx = serialized::read<::consensus::Index>(data, size);
          auto evidence_idx = serialized::read<::consensus::Index>(data, size);
          auto requested_size = serialized::read<size_t>(data, size);
          auto generation_count = serialized::read<uint32_t>(data, size);
 
          auto snapshot =
            add_pending_snapshot(idx, evidence_idx, requested_size);
 
          RINGBUFFER_WRITE_MESSAGE(
            ::consensus::snapshot_allocated,
            to_enclave,
            std::span<uint8_t>{snapshot->data(), snapshot->size()},
            generation_count);
        });
 
      DISPATCHER_SET_MESSAGE_HANDLER(
        disp,
        ::consensus::snapshot_commit,
        [this](const uint8_t* data, size_t size) {
          auto snapshot_idx = serialized::read<::consensus::Index>(data, size);
          commit_snapshot(snapshot_idx, data, size);
        });
    }
  };
}