//! Support Krill upgrades, e.g.:
//! - Updating the format of commands or events
//! - Export / Import data
use std::collections::HashMap;
use std::fmt;
use std::str::FromStr;
use clap::crate_version;
use log::{debug, error, info, trace, warn};
use rpki::{
ca::idexchange::{CaHandle, MyHandle},
repository::x509::Time,
};
use serde::{Deserialize, Serialize};
use serde::de::DeserializeOwned;
use crate::{
commons::{
error::KrillIoError,
eventsourcing::{
Aggregate, AggregateStore, AggregateStoreError,
Storable, StoredCommand, WalStoreError,
WithStorableDetails,
},
storage::{Ident, KeyValueError, KeyValueStore},
version::KrillVersion,
KrillResult,
},
constants::{
ACTOR_DEF_KRILL, CASERVER_NS, CA_OBJECTS_NS, KEYS_NS,
PROPERTIES_NS, PUBSERVER_CONTENT_NS, PUBSERVER_NS, SIGNERS_NS,
STATUS_NS, TA_PROXY_SERVER_NS, TA_SIGNER_SERVER_NS, TASK_QUEUE_NS,
},
config::Config,
server::{
manager::KrillManager,
properties::PropertiesManager,
},
upgrades::pre_0_14_0::{
OldStoredCommand, OldStoredEffect, OldStoredEvent,
},
};
use crate::api::aspa::{
AspaDefinition, AspaDefinitionUpdates, CustomerAsn, ProviderAsn,
};
use crate::server::ca::upgrades as ca;
use crate::server::pubd::upgrades as pubd;
#[cfg(feature = "hsm")]
use rpki::crypto::KeyIdentifier;
#[cfg(feature = "hsm")]
use crate::commons::crypto::SignerHandle;
use self::pre_0_14_0::OldCommandKey;
pub mod data_migration;
pub mod pre_0_14_0;
//------------ UpgradeResult -------------------------------------------------
pub type UpgradeResult<T> = Result<T, UpgradeError>;
//------------ CommandMigrationEffect ----------------------------------------
pub enum CommandMigrationEffect<A: Aggregate> {
StoredCommand(StoredCommand<A>),
AspaObjectsUpdates(AspaMigrationConfigUpdates),
Nothing,
}
//------------ AspaMigrationConfigUpdates ------------------------------------
pub struct AspaMigrationConfigUpdates {
pub ca: CaHandle,
pub added_or_updated: HashMap<CustomerAsn, Vec<ProviderAsn>>,
pub removed: Vec<CustomerAsn>,
}
//------------ AspaMigrationConfigs ------------------------------------------
#[derive(Debug, Default)]
pub struct AspaMigrationConfigs(HashMap<CaHandle, Vec<AspaDefinition>>);
impl AspaMigrationConfigs {
pub fn is_empty(&self) -> bool {
self.0.is_empty()
}
}
impl IntoIterator for AspaMigrationConfigs {
type Item = (CaHandle, Vec<AspaDefinition>);
type IntoIter =
std::collections::hash_map::IntoIter<CaHandle, Vec<AspaDefinition>>;
fn into_iter(self) -> Self::IntoIter {
self.0.into_iter()
}
}
//------------ KrillUpgradeReport --------------------------------------------
#[derive(Debug)]
pub struct UpgradeReport {
aspa_migration_configs: AspaMigrationConfigs,
data_migration: bool,
versions: UpgradeVersions,
}
impl UpgradeReport {
pub fn new(
aspa_migration_configs: AspaMigrationConfigs,
data_migration: bool,
versions: UpgradeVersions,
) -> Self {
UpgradeReport {
aspa_migration_configs,
data_migration,
versions,
}
}
pub fn into_aspa_configs(self) -> AspaMigrationConfigs {
self.aspa_migration_configs
}
pub fn data_migration(&self) -> bool {
self.data_migration
}
pub fn versions(&self) -> &UpgradeVersions {
&self.versions
}
}
//------------ KrillUpgradeVersions ------------------------------------------
#[derive(Debug, Eq, PartialEq)]
pub struct UpgradeVersions {
pub from: KrillVersion,
pub to: KrillVersion,
}
impl UpgradeVersions {
/// Returns a KrillUpgradeVersions if the krill code version is newer
/// than the provided current version.
pub fn for_current(
current: KrillVersion,
) -> Result<Option<Self>, UpgradeError> {
let code_version = KrillVersion::code_version();
match code_version.cmp(¤t) {
std::cmp::Ordering::Greater => Ok(Some(UpgradeVersions {
from: current,
to: code_version,
})),
std::cmp::Ordering::Equal => Ok(None),
std::cmp::Ordering::Less => {
Err(UpgradeError::CodeOlderThanData(code_version, current))
}
}
}
pub fn from(&self) -> &KrillVersion {
&self.from
}
pub fn to(&self) -> &KrillVersion {
&self.to
}
}
//------------ UpgradeError --------------------------------------------------
#[derive(Debug)]
#[allow(clippy::large_enum_variant)]
pub enum UpgradeError {
AggregateStoreError(AggregateStoreError),
WalStoreError(WalStoreError),
KeyStoreError(KeyValueError),
IoError(KrillIoError),
Unrecognised(String),
CannotLoadAggregate(MyHandle),
IdExchange(String),
OldTaMigration,
CodeOlderThanData(KrillVersion, KrillVersion),
Custom(String),
}
impl fmt::Display for UpgradeError {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
let cause = match &self {
UpgradeError::AggregateStoreError(e) => format!("Aggregate Error: {e}"),
UpgradeError::WalStoreError(e) => format!("Write-Ahead-Log Store Error: {e}"),
UpgradeError::KeyStoreError(e) => format!("Keystore Error: {e}"),
UpgradeError::IoError(e) => format!("I/O Error: {e}"),
UpgradeError::Unrecognised(s) => format!("Unrecognised: {s}"),
UpgradeError::CannotLoadAggregate(h) => format!("Cannot load: {h}"),
UpgradeError::IdExchange(s) => format!("Could not use exchanged id info: {s}"),
UpgradeError::OldTaMigration => "Your installation cannot be upgraded to Krill 0.13.0 or later because it includes a CA called \"ta\". These CAs were used for the preliminary Trust Anchor support needed by testbed and benchmark setups. They cannot be migrated to the production grade Trust Anchor support that was introduced in Krill 0.13.0. If you want to continue to use your existing installation we recommend that you downgrade to Krill 0.12.1 or earlier. If you want to operate a testbed using Krill 0.13.0 or later, then you can create a fresh testbed instead of migrating your existing testbed. If you believe that you should not have a CA called \"ta\" - i.e. it may have been left over from an abandoned testbed set up - then you can delete the \"ta\" directory under your krill data \"cas\" directory and restart Krill.".to_string(),
UpgradeError::CodeOlderThanData(code, data) => format!("Krill version {code} is older than data version {data}. You either need to upgrade krill, or restore the data from version {code}."),
UpgradeError::Custom(s) => s.clone(),
};
write!(f, "Upgrade preparation failed because of: {cause}")
}
}
impl UpgradeError {
pub fn custom(msg: impl fmt::Display) -> Self {
UpgradeError::Custom(msg.to_string())
}
pub fn unrecognised(msg: impl fmt::Display) -> Self {
UpgradeError::Unrecognised(msg.to_string())
}
}
impl From<AggregateStoreError> for UpgradeError {
fn from(e: AggregateStoreError) -> Self {
UpgradeError::AggregateStoreError(e)
}
}
impl From<WalStoreError> for UpgradeError {
fn from(e: WalStoreError) -> Self {
UpgradeError::WalStoreError(e)
}
}
impl From<KeyValueError> for UpgradeError {
fn from(e: KeyValueError) -> Self {
UpgradeError::KeyStoreError(e)
}
}
impl From<KrillIoError> for UpgradeError {
fn from(e: KrillIoError) -> Self {
UpgradeError::IoError(e)
}
}
impl From<crate::commons::error::Error> for UpgradeError {
fn from(e: crate::commons::error::Error) -> Self {
UpgradeError::Custom(e.to_string())
}
}
impl From<rpki::ca::idexchange::Error> for UpgradeError {
fn from(e: rpki::ca::idexchange::Error) -> Self {
UpgradeError::IdExchange(e.to_string())
}
}
impl std::error::Error for UpgradeError {}
//------------ DataUpgradeInfo -----------------------------------------------
#[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize)]
pub struct DataUpgradeInfo {
// version of the source command
pub last_migrated_command: Option<u64>,
// Version of migrated aggregate. Note certain source commands may be
// dropped.
pub migration_version: u64,
pub aspa_configs: HashMap<CustomerAsn, Vec<ProviderAsn>>,
}
impl DataUpgradeInfo {
fn increment_last_migrated_command(&mut self) {
if let Some(last_command) = self.last_migrated_command {
self.last_migrated_command = Some(last_command + 1);
} else {
self.last_migrated_command = Some(0)
}
}
fn update_aspa_configs(&mut self, updates: AspaMigrationConfigUpdates) {
for removed in updates.removed {
self.aspa_configs.remove(&removed);
}
for (customer, providers) in updates.added_or_updated {
self.aspa_configs.insert(customer, providers);
}
}
}
#[derive(Clone, Copy, Debug)]
pub enum UpgradeMode {
PrepareOnly,
PrepareToFinalise,
}
impl UpgradeMode {
pub fn is_prepare_only(&self) -> bool {
matches!(*self, UpgradeMode::PrepareOnly)
}
pub fn is_finalise(&self) -> bool {
matches!(*self, UpgradeMode::PrepareToFinalise)
}
}
//------------ UnconvertedEffect ---------------------------------------------
pub enum UnconvertedEffect<T> {
Error { msg: String },
Success { events: Vec<T> },
}
impl<T> UnconvertedEffect<T> {
pub fn into_events(self) -> Option<Vec<T>> {
match self {
UnconvertedEffect::Error { .. } => None,
UnconvertedEffect::Success { events } => Some(events),
}
}
}
//------------ UpgradeStore --------------------------------------------------
/// Implement this for automatic upgrades to key stores
pub trait UpgradeAggregateStorePre0_14 {
type Aggregate: Aggregate;
type OldInitEvent: fmt::Display + Eq + PartialEq + Storable + 'static;
type OldEvent: fmt::Display + Eq + PartialEq + Storable + 'static;
type OldStorableDetails: WithStorableDetails;
//--- Mandatory functions to implement
fn store_name(&self) -> &str;
fn deployed_store(&self) -> &KeyValueStore;
fn preparation_key_value_store(&self) -> &KeyValueStore;
fn preparation_aggregate_store(&self)
-> &AggregateStore<Self::Aggregate>;
/// Implement this to convert the old init event to a new
/// StoredCommand for the init.
fn convert_init_event(
&self,
old_init: Self::OldInitEvent,
handle: MyHandle,
actor: String,
time: Time,
) -> UpgradeResult<StoredCommand<Self::Aggregate>>;
/// Implement this to convert an old command and convert the
/// included old events.
///
/// The version for the new command is given, as it might differ
/// from the old command sequence.
fn convert_old_command(
&self,
old_command: OldStoredCommand<Self::OldStorableDetails>,
old_effect: UnconvertedEffect<Self::OldEvent>,
version: u64,
) -> UpgradeResult<CommandMigrationEffect<Self::Aggregate>>;
/// Override this to get a call when the migration of commands for
/// an aggregate is done.
fn post_command_migration(&self, handle: &MyHandle) -> UpgradeResult<()> {
trace!("default post migration hook called for '{handle}'");
Ok(())
}
/// Upgrades pre 0.14.x AggregateStore.
///
/// Expects implementers of this trait to provide function for converting
/// old command/event/init types to the current types.
fn upgrade(
&self,
mode: UpgradeMode,
) -> UpgradeResult<AspaMigrationConfigs> {
// check existing version, wipe it if there is an unfinished upgrade
// in progress for another Krill version.
self.preparation_store_prepare()?;
info!(
"Prepare upgrading {} to Krill version {}",
self.store_name(),
crate_version!(),
);
// Migrate the event sourced data for each scope and create new
// snapshots
for scope in self.deployed_store().scopes()? {
// Getting the Handle should never fail, but if it does then we
// should bail out asap.
let handle =
MyHandle::from_str(&scope.to_string()).map_err(|_| {
UpgradeError::Custom(format!(
"Found invalid handle '{scope}'"
))
})?;
// Get the upgrade info to see where we got to.
// We may be continuing from an earlier migration, e.g. by
// krillup.
let mut data_upgrade_info = self.data_upgrade_info(&scope)?;
// Get the list of commands to prepare, starting with the
// last_command we got to (may be 0)
let old_cmd_keys = self.command_keys(
&scope,
data_upgrade_info.last_migrated_command.unwrap_or(0),
)?;
// Migrate the initialisation event, if not done in a previous
// run. This is a special event that has no command,
// so we need to do this separately.
if data_upgrade_info.last_migrated_command.is_none() {
let old_init_key = Self::event_key(0);
let old_init: OldStoredEvent<Self::OldInitEvent> =
self.get(&scope, &old_init_key)?;
let old_init = old_init.into_details();
// From 0.14.x and up we will have command '0' for the init,
// where beforehand we only had an event. We
// will have to make up some values for the actor and time.
let actor = ACTOR_DEF_KRILL;
// The time is tricky.. our best guess is to set this to the
// same value as the first command, if there
// is any. In the very unlikely
// case that there is no first command, then we might as well
// set it to now.
let time = if let Some(first_command) = old_cmd_keys.first() {
let cmd: OldStoredCommand<Self::OldStorableDetails> =
self.get(&scope, first_command)?;
cmd.time()
} else {
Time::now()
};
// We need to ask the implementer of this trait to convert the
// init event we found to a StoredCommand that we can save.
let command = self.convert_init_event(
old_init,
handle.clone(),
actor.audit_name(),
time,
)?;
self.store_new_command(&scope, &command)?;
data_upgrade_info.increment_last_migrated_command();
}
// Track commands migrated and time spent so we can report
// progress
let mut total_migrated = 0;
let total_commands = old_cmd_keys.len(); // excludes migrated commands
let time_started = Time::now();
// Report the amount of (remaining) work (old)
Self::report_remaining_work(
total_commands,
&handle,
&data_upgrade_info,
)?;
// Process remaining commands
for old_cmd_key in old_cmd_keys {
// Read and parse the command.
trace!(" +- command: {old_cmd_key}");
let old_command: OldStoredCommand<Self::OldStorableDetails> =
self.get(&scope, &old_cmd_key)?;
// And the unconverted effects
let old_effect = match old_command.effect() {
OldStoredEffect::Success { events } => {
let mut full_events: Vec<Self::OldEvent> = vec![]; // We just had numbers, we need to include the full
// events
for v in events {
let event_key = Self::event_key(*v);
trace!(" +- event: {event_key}");
let evt: OldStoredEvent<Self::OldEvent> = self
.deployed_store()
.get(Some(&scope), &event_key)?
.ok_or_else(|| {
UpgradeError::Custom(format!(
"Cannot parse old event: {event_key}"
))
})?;
full_events.push(evt.into_details());
}
UnconvertedEffect::Success {
events: full_events,
}
}
OldStoredEffect::Error { msg } => {
UnconvertedEffect::Error { msg: msg.clone() }
}
};
// The migration version matches the version of the resulting
// aggregate when commands are applied. It
// starts with 0 for the init command, in which case the
// version in the data_upgrade_info is not
// updated.
//
// For commands we set the target version of the migrated to
// command to the current version of the
// aggregate, plus 1. If there is a an actual resulting
// command (with events or even an error) to
// be saved, then we save this command and increment the
// migration_version.
//
// Unfortunately, we do need this double bookkeeping of
// versions of source commands
// that are migrated vs the version of the aggregate, because
// some commands - such as pre 0.14.0 ASPA
// update commands may be dropped.
match self.convert_old_command(
old_command,
old_effect,
data_upgrade_info.migration_version + 1,
)? {
CommandMigrationEffect::StoredCommand(command) => {
self.store_new_command(&scope, &command)?;
// we only increment this when a command is saved
data_upgrade_info.migration_version += 1;
}
CommandMigrationEffect::AspaObjectsUpdates(updates) => {
data_upgrade_info.update_aspa_configs(updates);
}
CommandMigrationEffect::Nothing => {
// nothing to do
}
}
total_migrated += 1;
data_upgrade_info.increment_last_migrated_command();
// Report progress and expected time to finish on every 100
// commands evaluated.
if total_migrated % 100 == 0 {
// expected time: (total_migrated / (now - started)) *
// total
let mut time_passed = (Time::now().timestamp()
- time_started.timestamp())
as usize;
if time_passed == 0 {
time_passed = 1; // avoid divide by zero.. we are
// doing approximate estimates here
}
let migrated_per_second: f64 =
total_migrated as f64 / time_passed as f64;
let expected_seconds =
(total_commands as f64 / migrated_per_second) as i64;
let eta = time_started
+ chrono::Duration::seconds(expected_seconds);
info!(
" migrated {} commands, expect to finish: {}",
total_migrated,
eta.to_rfc3339()
);
}
}
info!("Finished migrating commands for '{scope}'");
// Verify migration
info!(
"Will verify the migration by rebuilding '{}' from migrated commands",
&scope
);
let _latest = self.preparation_aggregate_store().save_snapshot(&handle).map_err(|e| {
UpgradeError::Custom(format!(
"Could not rebuild state after migrating CA '{handle}'! Error was: {e}."
))
})?;
// Call the post command migration hook, this will do nothing
// unless the implementer of this trait overrode it.
self.post_command_migration(&handle)?;
// Update the upgrade info as this could be a prepare only
// run, and this migration could be resumed later after more
// changes were applied.
self.update_data_upgrade_info(&scope, &data_upgrade_info)?;
info!("Verified migration of '{handle}'");
}
match mode {
UpgradeMode::PrepareOnly => {
info!(
"Prepared migrating data to Krill version {}. Will save progress for final upgrade when Krill restarts.",
crate_version!(),
);
Ok(AspaMigrationConfigs::default())
}
UpgradeMode::PrepareToFinalise => {
let mut aspa_configs = AspaMigrationConfigs::default();
for scope in self.deployed_store().scopes()? {
// Getting the Handle should never fail, but if it does
// then we should bail out asap.
let ca = MyHandle::from_str(&scope.to_string()).map_err(
|_| {
UpgradeError::Custom(format!(
"Found invalid handle '{scope}'"
))
},
)?;
let info = self.data_upgrade_info(&scope)?;
let aspa_configs_for_ca: Vec<AspaDefinition> = info
.aspa_configs
.into_iter()
.map(|(customer, providers)| {
AspaDefinition { customer, providers }
})
.collect();
if !aspa_configs_for_ca.is_empty() {
aspa_configs.0.insert(ca, aspa_configs_for_ca);
}
}
self.clean_migration_help_files()?;
info!(
"Prepared migrating data to Krill version {}.",
crate_version!(),
);
Ok(aspa_configs)
}
}
}
//-- Internal helper functions for this trait. Should not be used or
// overridden.
/// Saves the version of the target upgrade. Wipes the store if there is
/// another version set as the target.
fn preparation_store_prepare(&self) -> UpgradeResult<()> {
let code_version = KrillVersion::code_version();
const VERSION: &Ident = Ident::make("version");
if
let Ok(Some(existing_migration_version))
= self.preparation_key_value_store().get::<KrillVersion>(
None, VERSION
)
&& existing_migration_version != code_version
{
warn!("Found prepared data for Krill version {existing_migration_version}, will remove it and start from scratch for {code_version}");
self.preparation_key_value_store().wipe()?;
}
self.preparation_key_value_store()
.store(None, VERSION, &code_version)?;
Ok(())
}
fn report_remaining_work(
total_remaining: usize,
handle: &MyHandle,
data_upgrade_info: &DataUpgradeInfo,
) -> UpgradeResult<()> {
// Unwrap is safe here, because if there was no last_command
// then we would have converted the init event above, and would
// have set this.
let last_command =
data_upgrade_info
.last_migrated_command
.ok_or(UpgradeError::custom(
"called report_remaining_work before converting init event",
))?;
if last_command == 0 {
info!(
"Will migrate {total_remaining} commands for '{handle}'"
);
} else {
info!(
"Will resume migration of {total_remaining} remaining commands for '{handle}'"
);
}
Ok(())
}
fn store_new_command(
&self,
scope: &Ident,
command: &StoredCommand<Self::Aggregate>,
) -> UpgradeResult<()> {
Ok(self.preparation_key_value_store().store_new(
Some(scope),
&Self::new_stored_command_key(command.version()),
command
)?)
}
/// Return the DataUpgradeInfo telling us to where we got to with this
/// migration.
fn data_upgrade_info(
&self,
scope: &Ident,
) -> UpgradeResult<DataUpgradeInfo> {
self.preparation_key_value_store()
.get(Some(scope), DATA_UPGRADE_INFO_KEY)
.map(|opt| opt.unwrap_or_default())
.map_err(UpgradeError::KeyStoreError)
}
/// Update the DataUpgradeInfo
fn update_data_upgrade_info(
&self,
scope: &Ident,
info: &DataUpgradeInfo,
) -> UpgradeResult<()> {
self.preparation_key_value_store()
.store(Some(scope), DATA_UPGRADE_INFO_KEY, info)
.map_err(UpgradeError::KeyStoreError)
}
/// Clean up keys used for tracking migration progress
fn clean_migration_help_files(&self) -> UpgradeResult<()> {
self.preparation_key_value_store()
.drop_key(None, const { Ident::make("version") })
.map_err(UpgradeError::KeyStoreError)?;
for scope in self.preparation_key_value_store().scopes()? {
self.preparation_key_value_store()
.drop_key(Some(&scope), DATA_UPGRADE_INFO_KEY)
.map_err(UpgradeError::KeyStoreError)?;
}
Ok(())
}
/// Find all command keys for the scope, starting from the provided
/// sequence. Then sort them by sequence and turn them back into key
/// store keys for further processing.
fn command_keys(
&self, scope: &Ident, from: u64,
) -> Result<Vec<Box<Ident>>, UpgradeError> {
let keys = self.deployed_store().keys(Some(scope), "command--")?;
let mut cmd_keys: Vec<OldCommandKey> = vec![];
for key in keys {
let cmd_key = OldCommandKey::from_str(key.as_str())
.map_err(|_| {
UpgradeError::Custom(format!(
"Found invalid command key: {key} for ca: {scope}",
))
})?;
if cmd_key.sequence > from {
cmd_keys.push(cmd_key);
}
}
cmd_keys.sort_by_key(|k| k.sequence);
Ok(cmd_keys.into_iter().map(|ck| {
ck.to_storage_key()
}).collect())
}
fn get<V: DeserializeOwned>(
&self, scope: &Ident, key: &Ident
) -> Result<V, UpgradeError> {
self.deployed_store().get(Some(scope), key)?.ok_or_else(|| {
UpgradeError::Custom(
format!("Cannot read key '{key}' in scope '{scope}'.")
)
})
}
fn event_key(nr: u64) -> Box<Ident> {
Ident::builder(
const { Ident::make("delta-") }
).push_u64(
nr
).finish_with_extension(
const { Ident::make("json") }
)
}
fn new_stored_command_key(version: u64) -> Box<Ident> {
Ident::builder(
const { Ident::make("command-") }
).push_u64(
version
).finish_with_extension(
const { Ident::make("json") }
)
}
}
/// Prepares a Krill upgrade related data migration. If no data migration is
/// needed then this will simply be a no-op. Returns the
/// `KrillUpgradeVersions` if the currently deployed Krill version differs
/// from the code version. Note that the version may have increased even if
/// there is no data migration needed.
///
/// In case data needs to be migrated, then new data will be prepared under
/// the directory returned by `config.storage_uri()`. By design, this
/// migration can be executed while Krill is running as it does not affect any
/// current state. It can be called multiple times and it will resume the
/// migration from the point it got to earlier. The idea is that this will
/// allow operators to prepare the work for a migration and (a) verify that
/// the migration worked, and (b) minimize the downtime when Krill is
/// restarted into a new version. When a new version Krill daemon is
/// started, it will call this again - to do the final preparation for a
/// migration - knowing that no changes are added to the event history at this
/// time. After this, the migration will be finalised.
pub fn prepare_upgrade_data_migrations(
mode: UpgradeMode,
config: &Config,
properties_manager: &PropertiesManager,
) -> UpgradeResult<Option<UpgradeReport>> {
// First of all ALWAYS check the existing keys if the hsm feature is
// enabled. Remember that this feature - although enabled by default
// from 0.10.x - may be enabled by installing a new krill binary of
// the same Krill version as the the previous binary. In other words, we
// cannot rely on the KrillVersion to decide whether this is needed.
// On the other hand.. this is a fairly cheap operation that we can
// just do at startup. It is done here, because in effect it *is* a data
// migration.
#[cfg(feature = "hsm")]
record_preexisting_openssl_keys_in_signer_mapper(config)?;
match upgrade_versions(config, properties_manager)? {
None => Ok(None),
Some(versions) => {
info!(
"Preparing upgrade from {} to {}",
versions.from(),
versions.to()
);
// Check if there is any CA named "ta". If so, then we are trying
// to upgrade a Krill testbed or benchmark set up that
// uses the old deprecated trust anchor set up. These TAs cannot
// easily be migrated to the new setup in 0.13.0.
// Well.. it could be done, if there would be a strong use
// case to put in the effort, but there really isn't.
let ca_kv_store = KeyValueStore::create(
&config.storage_uri, CASERVER_NS
)?;
if ca_kv_store.has_scope(const { Ident::make("ta") })? {
return Err(UpgradeError::OldTaMigration);
}
if versions.from < KrillVersion::release(0, 6, 0) {
let msg = "Cannot upgrade Krill installations from before version 0.6.0. Please upgrade to 0.8.1 first, then upgrade to 0.12.3, and then upgrade to this version.";
error!("{msg}");
Err(UpgradeError::custom(msg))
}
else if versions.from < KrillVersion::release(0, 9, 0) {
let msg = "Cannot upgrade Krill installations from before version 0.9.0. Please upgrade to 0.12.3 first, and then upgrade to this version.";
error!("{msg}");
Err(UpgradeError::custom(msg))
}
else if versions.from < KrillVersion::candidate(0, 10, 0, 1) {
// Complex migrations involving command / event conversions
pubd::pre_0_10_0::PublicationServerRepositoryAccessMigration::upgrade(mode, config, &versions)?;
let aspa_configs =
ca::pre_0_10_0::CasMigration::upgrade(mode, config)?;
// The way that pubd objects were stored was changed as well
// (since 0.13.0)
pubd::migrate_pre_0_12_pubd_objects(config)?;
// Migrate remaining aggregate stores used in < 0.10.0 to the
// new format in 0.14.0 where we combine
// commands and events into a single key-value pair.
pre_0_14_0::UpgradeAggregateStoreSignerInfo::upgrade(
SIGNERS_NS, mode, config,
)?;
Ok(Some(UpgradeReport::new(aspa_configs, true, versions)))
} else if versions.from < KrillVersion::candidate(0, 10, 0, 3) {
Err(UpgradeError::custom(
"Cannot upgrade from 0.10.0 RC1 or RC2. Please contact rpki-team@nlnetlabs.nl",
))
} else if versions.from < KrillVersion::candidate(0, 12, 0, 2) {
info!(
"Krill upgrade from {} to {}. Check if publication server objects need migration.",
versions.from(),
versions.to()
);
// The pubd objects storage changed in 0.13.0
pubd::migrate_pre_0_12_pubd_objects(config)?;
// Migrate aggregate stores used in < 0.12.0 to the new format
// in 0.14.0 where we combine commands and
// events into a single key-value pair.
pre_0_14_0::UpgradeAggregateStoreSignerInfo::upgrade(
SIGNERS_NS, mode, config,
)?;
let aspa_configs =
ca::pre_0_14_0::CasMigration::upgrade(mode, config)?;
pubd::pre_0_14_0::UpgradeAggregateStoreRepositoryAccess::upgrade(
PUBSERVER_NS,
mode,
config,
)?;
Ok(Some(UpgradeReport::new(aspa_configs, true, versions)))
} else if versions.from < KrillVersion::candidate(0, 13, 0, 0) {
pubd::migrate_0_12_pubd_objects(config)?;
// Migrate aggregate stores used in < 0.13.0 to the new format
// in 0.14.0 where we combine commands and
// events into a single key-value pair.
pre_0_14_0::UpgradeAggregateStoreSignerInfo::upgrade(
SIGNERS_NS, mode, config,
)?;
let aspa_configs =
ca::pre_0_14_0::CasMigration::upgrade(mode, config)?;
pubd::pre_0_14_0::UpgradeAggregateStoreRepositoryAccess::upgrade(
PUBSERVER_NS,
mode,
config,
)?;
Ok(Some(UpgradeReport::new(aspa_configs, true, versions)))
} else if versions.from < KrillVersion::candidate(0, 14, 0, 0) {
// Migrate aggregate stores used in < 0.14.0 to the new format
// in 0.14.0 where we combine commands and
// events into a single key-value pair.
let aspa_configs =
ca::pre_0_14_0::CasMigration::upgrade(mode, config)?;
pubd::pre_0_14_0::UpgradeAggregateStoreRepositoryAccess::upgrade(
PUBSERVER_NS,
mode,
config,
)?;
pre_0_14_0::UpgradeAggregateStoreSignerInfo::upgrade(
SIGNERS_NS, mode, config,
)?;
pre_0_14_0::UpgradeAggregateStoreTrustAnchorSigner::upgrade(
TA_SIGNER_SERVER_NS,
mode,
config,
)?;
pre_0_14_0::UpgradeAggregateStoreTrustAnchorProxy::upgrade(
TA_PROXY_SERVER_NS,
mode,
config,
)?;
Ok(Some(UpgradeReport::new(aspa_configs, true, versions)))
} else {
Ok(Some(UpgradeReport::new(
AspaMigrationConfigs::default(),
false,
versions,
)))
}
}
}
}
/// Finalise the data migration for an upgrade.
///
/// If there is any prepared data, then:
/// - archive the current data
/// - make the prepared data current
pub fn finalise_data_migration(
upgrade: &UpgradeVersions,
config: &Config,
properties_manager: &PropertiesManager,
) -> KrillResult<()> {
// For each NS
//
// Check if upgrade store to this version exists.
// If so:
// -- drop archive store if it exists
// -- archive current store (rename ns)
// -- move upgrade to current
info!(
"Finish data migrations for upgrade from {} to {}",
upgrade.from(),
upgrade.to()
);
for ns in [
CASERVER_NS,
CA_OBJECTS_NS,
KEYS_NS,
PROPERTIES_NS,
PUBSERVER_CONTENT_NS,
PUBSERVER_NS,
SIGNERS_NS,
STATUS_NS,
TA_PROXY_SERVER_NS,
TA_SIGNER_SERVER_NS,
TASK_QUEUE_NS,
] {
// Check if there is a non-empty upgrade store for this namespace
// that would need to be migrated.
let mut upgrade_store =
KeyValueStore::create_upgrade_store(&config.storage_uri, ns)?;
if !upgrade_store.is_empty()? {
info!("Migrate new data for {ns} and archive old");
let mut current_store =
KeyValueStore::create(&config.storage_uri, ns)?;
if !current_store.is_empty()? {
current_store.migrate_to_archive(&config.storage_uri, ns)?;
}
upgrade_store.migrate_to_current(&config.storage_uri, ns)?;
} else {
// No migration needed, but check if we have a current store
// for this namespace that still includes a version file. If
// so, remove it.
let current_store = KeyValueStore::create(
&config.storage_uri, ns
)?;
if current_store.has(None, VERSION_KEY)? {
debug!("Removing excess version key in ns: {ns}");
current_store.drop_key(None, VERSION_KEY)?;
}
// If we migrate from before 0.15.0, delete the .locks scope.
//
// XXX This is not necessary any more since things starting with
// a dot aren’t valid scopes any more.
}
}
// Set the current version of the store to that of the running code
let code_version = KrillVersion::code_version();
info!("Finished upgrading Krill to version: {code_version}");
if properties_manager.is_initialized() {
properties_manager.upgrade_krill_version(code_version)?;
} else {
properties_manager.init(code_version)?;
}
Ok(())
}
/// Prior to Krill having HSM support there was no signer mapper as it wasn't
/// needed, keys were just created by OpenSSL and stored in files on disk in
/// KEYS_NS named by the string form of their Krill KeyIdentifier. If Krill
/// had created such keys and then the operator upgrades to a version of Krill
/// with HSM support, the keys will become unusable because Krill will not be
/// able to find a mapping from KeyIdentifier to signer as the mappings for
/// the keys were never created. So we detect the case that the signer store
/// SIGNERS_DIR directory has not yet been created, i.e. no signers have been
/// registered and no key mappings have been recorded, and then walk KEYS_NS
/// adding the keys one by one to the mapping in the signer store, if any.
#[cfg(feature = "hsm")]
fn record_preexisting_openssl_keys_in_signer_mapper(
config: &Config,
) -> Result<(), UpgradeError> {
let signers_key_store =
KeyValueStore::create(&config.storage_uri, SIGNERS_NS)?;
if signers_key_store.is_empty()? {
let mut num_recorded_keys = 0;
// If the key value store for the "signers" namespace is empty, then
// it was not yet initialised and we may need to import keys
// from a previous krill installation (earlier version, or a custom
// build that has the hsm feature disabled.)
let keys_key_store =
KeyValueStore::create(&config.storage_uri, KEYS_NS)?;
info!(
"Mapping OpenSSL signer keys, using uri: {}",
config.storage_uri
);
let probe_interval =
std::time::Duration::from_secs(config.signer_probe_retry_seconds);
let krill_signer = crate::commons::crypto::KrillSignerBuilder::new(
&config.storage_uri,
probe_interval,
&config.signers,
)
.with_default_signer(config.default_signer())
.with_one_off_signer(config.one_off_signer())
.build()
.unwrap();
// For every file (key) in the legacy OpenSSL signer keys directory
let mut openssl_signer_handle: Option<SignerHandle> = None;
for key in keys_key_store.keys(None, "")? {
debug!("Found key: {key}");
// Is it a key identifier?
if let Ok(key_id) = KeyIdentifier::from_str(key.as_str()) {
// Is the key already recorded in the mapper? It shouldn't be,
// but asking will cause the initial
// registration of the OpenSSL signer to occur and for it to
// be assigned a handle. We need the handle so
// that we can register keys with the mapper.
if krill_signer.get_key_info(&key_id).is_err() {
// No, record it
// Find out the handle of the OpenSSL signer used to
// create this key, if not yet known.
if openssl_signer_handle.is_none() {
// No, find it by asking each of the active signers if
// they have the key because one of
// them must have it and it should be the one and only
// OpenSSL signer that Krill was
// using previously. We can't just find and use the
// only OpenSSL signers as Krill may
// have been configured with more than one each with
// separate keys directories.
for (a_signer_handle, a_signer) in
krill_signer.get_active_signers().iter()
{
if a_signer.get_key_info(&key_id).is_ok() {
openssl_signer_handle =
Some(a_signer_handle.clone());
break;
}
}
}
// Record the key in the signer mapper as being owned by
// the found signer handle.
if let Some(signer_handle) = &openssl_signer_handle {
let internal_key_id = key_id.to_string();
if let Some(mapper) = krill_signer.get_mapper() {
mapper.add_key(
signer_handle,
&key_id,
&internal_key_id,
)?;
num_recorded_keys += 1;
}
}
}
} else {
debug!("Could not parse key as key identifier: {key}");
}
}
info!(
"Recorded {num_recorded_keys} key identifiers in the signer store"
);
Ok(())
} else {
debug!("Signers were set up before. No need to migrate keys.");
Ok(())
}
}
/// Should be called after the KrillServer is started, but before the web
/// server is started and operators can make changes.
pub async fn post_start_upgrade(
report: UpgradeReport,
server: &KrillManager,
) -> KrillResult<()> {
if report.versions().from() < &KrillVersion::candidate(0, 9, 3, 2) {
info!("Reissue ROAs on upgrade to force short EE certificate subjects in the objects");
server.force_renew_roas().await?;
}
for (ca, configs) in report.into_aspa_configs().into_iter() {
info!("Re-import ASPA configurations after migration for CA '{ca}'");
let aspa_updates = AspaDefinitionUpdates {
add_or_replace: configs,
remove: Vec::new()
};
server.ca_aspas_definitions_update(
ca,
aspa_updates,
server.system_actor(),
)?;
}
Ok(())
}
/// Checks if we should upgrade:
/// - if the code is newer than the version used then we upgrade
/// - if the code is the same version then we do not upgrade
/// - if the code is older then we need to error out
fn upgrade_versions(
config: &Config,
properties_manager: &PropertiesManager,
) -> Result<Option<UpgradeVersions>, UpgradeError> {
if properties_manager.is_initialized() {
// The properties manager was introduced in Krill 0.14.0. However,
// in 0.14.0, it is not being initialised unless a migration from
// an older version happened. This changed in 0.15.0 where it gets
// initialised even on a fresh install.
//
// If it's initialised then it MUST have a Krill Version.
let current = properties_manager.current_krill_version()?;
UpgradeVersions::for_current(current)
}
else {
// No KrillVersion. So, this is an older Krill version.
//
// If this is an existing Krill installation before 0.14.0, then we
// will find version files (keys) in one or more existing key value
// stores used for the various entities in Krill.
//
// If can't find any versions then this is a new install being done
// in the 0.14 series. We treat all of them as 0.14.0.
let mut current: Option<KrillVersion> = None;
// Scan the following data stores. The *latest* version seen will
// determine the actual installed Krill version - this is
// because these version files did not always get updated in
// each store - but only in stores that needed an upgrade (at
// least this is true for some past migrations). So, it's the
// latest version (if any) that counts here.
for ns in &[
CASERVER_NS,
CA_OBJECTS_NS,
PUBSERVER_NS,
PUBSERVER_CONTENT_NS,
] {
let kv_store = KeyValueStore::create(&config.storage_uri, ns)?;
if let Some(key_store_version) =
kv_store.get::<KrillVersion>(None, VERSION_KEY)?
{
if let Some(last_seen) = ¤t {
if &key_store_version > last_seen {
current = Some(key_store_version)
}
} else {
current = Some(key_store_version);
}
}
}
match current {
None => {
UpgradeVersions::for_current(KrillVersion::release(0, 14, 0))
}
Some(current) => UpgradeVersions::for_current(current),
}
}
}
//============ Key Constants =================================================
const DATA_UPGRADE_INFO_KEY: &Ident = Ident::make("upgrade_info.json");
const VERSION_KEY: &Ident = const { Ident::make("version") };
//============ Tests =========================================================
#[cfg(test)]
mod tests {
use std::{fs, path};
use std::path::PathBuf;
use log::LevelFilter;
use tempfile::tempdir;
use url::Url;
use crate::commons::storage::Ident;
use crate::commons::test;
use crate::server::ca::{CaStatus, CaStatusStore};
use super::*;
fn copy_folder(src: impl AsRef<path::Path>, dst: impl AsRef<path::Path>) {
fs::create_dir_all(&dst).unwrap();
for item in fs::read_dir(src).unwrap() {
let item = item.unwrap();
let ft = item.file_type().unwrap();
if ft.is_dir() {
copy_folder(item.path(), dst.as_ref().join(item.file_name()));
}
else if ft.is_file() {
fs::copy(
item.path(),
dst.as_ref().join(item.file_name())
).unwrap();
}
}
}
fn test_upgrade(base_dir: &str, namespaces: &[&str]) {
let temp_dir = tempdir().unwrap();
copy_folder(base_dir, &temp_dir);
// Copy data for the given names spaces into memory for testing.
let mem_storage_base_uri = test::mem_storage();
// This is needed for tls_dir etc, but will be ignored here.
let bogus_path = PathBuf::from("/dev/null");
let mut config = Config::test(
&mem_storage_base_uri,
Some(&bogus_path),
false, false, false, false,
);
config.log_level = LevelFilter::Trace;
let _ = config.init_logging();
let source_url = Url::parse(&format!(
"local://{}", temp_dir.path().to_str().unwrap()
)).unwrap();
for ns in namespaces {
let namespace = Ident::from_str(ns).unwrap();
let source_store = KeyValueStore::create(
&source_url, namespace
).unwrap();
let target_store = KeyValueStore::create(
&mem_storage_base_uri, namespace
).unwrap();
target_store.import(&source_store).unwrap();
}
let properties_manager = PropertiesManager::create(
&config.storage_uri,
config.use_history_cache,
).unwrap();
prepare_upgrade_data_migrations(
UpgradeMode::PrepareOnly,
&config,
&properties_manager,
).unwrap().unwrap();
// and continue - immediately, but still tests that this can pick up
// again.
let report = prepare_upgrade_data_migrations(
UpgradeMode::PrepareToFinalise,
&config,
&properties_manager,
).unwrap().unwrap();
finalise_data_migration(
report.versions(),
&config,
&properties_manager,
).unwrap();
}
#[test]
fn prepare_then_upgrade_0_9_6() {
test_upgrade(
"test-resources/migrations/v0_9_6/",
&["ca_objects", "cas", "pubd", "pubd_objects"],
);
}
#[test]
fn prepare_then_upgrade_0_9_5_pubserver() {
test_upgrade(
"test-resources/migrations/v0_9_5_pubserver/",
&["ca_objects", "cas", "pubd", "pubd_objects"],
);
}
#[test]
fn prepare_then_upgrade_0_10_3() {
test_upgrade(
"test-resources/migrations/v0_10_3/",
&[
"ca_objects",
"cas",
"pubd",
"pubd_objects",
"signers",
"status",
],
);
}
#[test]
fn prepare_then_upgrade_0_11_0() {
test_upgrade(
"test-resources/migrations/v0_11_0/",
&[
"ca_objects",
"cas",
"pubd",
"pubd_objects",
"signers",
"status",
],
);
}
#[test]
fn prepare_then_upgrade_0_12_1_pubserver() {
test_upgrade(
"test-resources/migrations/v0_12_1_pubserver/",
&["pubd", "pubd_objects"],
);
}
#[test]
fn prepare_then_upgrade_0_12_3() {
test_upgrade(
"test-resources/migrations/v0_12_3/",
&[
"ca_objects",
"cas",
"pubd",
"pubd_objects",
"signers",
"status",
],
);
}
#[test]
fn prepare_then_upgrade_0_13_1() {
test_upgrade(
"test-resources/migrations/v0_13_1/",
&[
"ca_objects",
"cas",
"pubd",
"pubd_objects",
"signers",
"status",
],
);
}
#[test]
fn prepare_then_upgrade_0_13_1_pubserver() {
test_upgrade(
"test-resources/migrations/v0_13_1_pubserver/",
&[
"ca_objects",
"cas",
"keys",
"pubd",
"pubd_objects",
"signers",
"status",
"ta_proxy",
"ta_signer",
],
);
}
#[test]
fn parse_0_10_0_rc3_repository_content() {
let json = include_str!(
"../../test-resources/migrations/v0_10_0_pubserver/0.json"
);
let _repo: pubd::pre_0_13_0::OldRepositoryContent =
serde_json::from_str(json).unwrap();
}
#[cfg(all(
feature = "hsm",
not(any(feature = "hsm-tests-kmip", feature = "hsm-tests-pkcs11"))
))]
fn unmapped_keys_test_core(do_upgrade: bool) {
let temp_dir = tempdir().unwrap();
copy_folder("test-resources/migrations/unmapped_keys/", &temp_dir);
let expected_key_id = KeyIdentifier::from_str(
"5CBCAB14B810C864F3EEA8FD102B79F4E53FCC70",
).unwrap();
// Copy test data into test storage
let mem_storage_base_uri = test::mem_storage();
let source_url = Url::parse(&format!(
"local://{}", temp_dir.path().to_str().unwrap()
)).unwrap();
let source_store = KeyValueStore::create(
&source_url, KEYS_NS
).unwrap();
let target_store = KeyValueStore::create(
&mem_storage_base_uri, KEYS_NS
).unwrap();
target_store.import(&source_store).unwrap();
// This is needed for tls_dir etc, but will be ignored here.
let bogus_path = PathBuf::from("/dev/null");
let mut config = Config::test(
&mem_storage_base_uri,
Some(&bogus_path),
false, false, false, false,
);
let _ = config.init_logging();
config.process().unwrap();
if do_upgrade {
record_preexisting_openssl_keys_in_signer_mapper(
&config
).unwrap();
}
// Now test that a newly initialized `KrillSigner` with a default
// OpenSSL signer is associated with the newly created mapper
// store and is thus able to use the key that we placed on
// disk.
let probe_interval = std::time::Duration::from_secs(
config.signer_probe_retry_seconds
);
let krill_signer = crate::commons::crypto::KrillSignerBuilder::new(
&mem_storage_base_uri,
probe_interval,
&config.signers,
).with_default_signer(
config.default_signer()
).with_one_off_signer(
config.one_off_signer()
).build().unwrap();
// Trigger the signer to be bound to the one the migration just
// registered in the mapper
krill_signer.random_serial().unwrap();
// Verify that the mapper has a single registered signer
let mapper = krill_signer.get_mapper().unwrap();
let signer_handles = mapper.get_signer_handles().unwrap();
assert_eq!(1, signer_handles.len());
if do_upgrade {
// Verify that the mapper has a record of the test key belonging
// to the signer
mapper.get_signer_for_key(&expected_key_id).unwrap();
}
else {
// Verify that the mapper does NOT have a record of the test key
// belonging to the signer
assert!(mapper.get_signer_for_key(&expected_key_id).is_err());
}
}
#[cfg(all(
feature = "hsm",
not(any(feature = "hsm-tests-kmip", feature = "hsm-tests-pkcs11"))
))]
#[test]
fn test_key_not_found_error_if_unmapped_keys_are_not_mapped_on_upgrade() {
unmapped_keys_test_core(false);
}
#[cfg(all(
feature = "hsm",
not(any(feature = "hsm-tests-kmip", feature = "hsm-tests-pkcs11"))
))]
#[test]
fn test_upgrading_with_unmapped_keys() {
unmapped_keys_test_core(true);
}
#[test]
fn read_save_status() {
let source_dir_path_str =
"test-resources/status_store/migration-0.9.5/";
let temp_dir = tempdir().unwrap();
copy_folder(source_dir_path_str, &temp_dir);
let source_dir_url = Url::parse(
&format!("local://{}", &temp_dir.path().to_str().unwrap()))
.unwrap();
let source_store =
KeyValueStore::create(&source_dir_url, STATUS_NS).unwrap();
let test_storage_uri = test::mem_storage();
let status_kv_store =
KeyValueStore::create(&test_storage_uri, STATUS_NS).unwrap();
// copy the source KV store (files) into the test KV store (in memory)
status_kv_store.import(&source_store).unwrap();
// get the status for testbed before initialising a StatusStore
// using the copied the data - that will be done next and start
// a migration.
let status_testbed_before_migration: CaStatus = status_kv_store.get(
Some(const { Ident::make("testbed") }),
const { Ident::make("status.json") },
).unwrap().unwrap();
// Initialise the StatusStore using the new (in memory) storage,
// and migrate the data.
let store =
CaStatusStore::create(&test_storage_uri, STATUS_NS).unwrap();
let testbed = CaHandle::from_str("testbed").unwrap();
// Get the migrated status for testbed and verify that it's equivalent
// to the status before migration.
let status_testbed_migrated = store.get_ca_status(&testbed);
assert_eq!(status_testbed_before_migration, status_testbed_migrated);
}
}