/// <summary>
///
/// </summary>
/// <remarks>Exposed for testability.</remarks>
internal static async Task PopulateMetadataAsync(MetadataTable metadataTable, Stream stream, string traceType)
{
// Read and validate the Footer section. The footer is always at the end of the stream, minus space for the checksum.
var footerHandle = new BlockHandle(stream.Length - FileFooter.SerializedSize - sizeof(ulong), FileFooter.SerializedSize);
var footer = await FileBlock.ReadBlockAsync(stream, footerHandle, (sectionReader, sectionHandle) => FileFooter.Read(sectionReader, sectionHandle)).ConfigureAwait(false);
// Verify we know how to deserialize this version of the file.
if (footer.Version != FileVersion)
{
throw new InvalidDataException(SR.Error_MetadataManager_Deserialized);
}
// Read and validate the Properties section.
var propertiesHandle = footer.PropertiesHandle;
var properties =
await
FileBlock.ReadBlockAsync(
stream,
propertiesHandle,
(sectionReader, sectionHandle) => FilePropertySection.Read <MetadataManagerFileProperties>(sectionReader, sectionHandle)).ConfigureAwait(false);
// Read disk metadata into memory.
await ReadDiskMetadataAsync(metadataTable.Table, stream, properties, traceType).ConfigureAwait(false);
metadataTable.CheckpointLSN = properties.CheckpointLSN;
}
/// <summary>
/// Deserializes the metadata (footer, properties, etc.) for this checkpoint file.
/// </summary>
private async Task ReadMetadataAsync()
{
Stream filestream = null;
try
{
filestream = this.ReaderPool.AcquireStream();
// Read and validate the Footer section. The footer is always at the end of the stream, minus space for the checksum.
var footerHandle = new BlockHandle(filestream.Length - FileFooter.SerializedSize - sizeof(ulong), FileFooter.SerializedSize);
this.Footer =
await FileBlock.ReadBlockAsync(filestream, footerHandle, (sectionReader, sectionHandle) => FileFooter.Read(sectionReader, sectionHandle)).ConfigureAwait(false);
// Verify we know how to deserialize this version of the checkpoint file.
if (this.Footer.Version != FileVersion)
{
throw new InvalidDataException(SR.Error_KeyCheckpointFile_Deserialized);
}
// Read and validate the Properties section.
var propertiesHandle = this.Footer.PropertiesHandle;
this.Properties =
await
FileBlock.ReadBlockAsync(
filestream,
propertiesHandle,
(sectionReader, sectionHandle) => FilePropertySection.Read <KeyCheckpointFileProperties>(sectionReader, sectionHandle)).ConfigureAwait(false);
}
finally
{
this.ReaderPool.ReleaseStream(filestream, true);
}
}
public static async Task <RecoveryPointMetadataFile> OpenAsync(
Stream filestream,
string recoveryPointMetadataFilePath,
CancellationToken cancellationToken)
{
var recoveryPointMetadataFile = new RecoveryPointMetadataFile(recoveryPointMetadataFilePath);
// Read and validate the Footer section. The footer is always at the end of the stream, minus space for the checksum.
var footerHandle = new BlockHandle(
filestream.Length - FileFooter.SerializedSize - sizeof(ulong),
FileFooter.SerializedSize);
recoveryPointMetadataFile.footer =
await
FileBlock.ReadBlockAsync(
filestream,
footerHandle,
(reader, handle) => FileFooter.Read(reader, handle)).ConfigureAwait(false);
cancellationToken.ThrowIfCancellationRequested();
// Verify we know how to deserialize this version of the backup log file.
if (recoveryPointMetadataFile.footer.Version != Version)
{
throw new InvalidDataException(
string.Format(
CultureInfo.CurrentCulture,
SR.Error_BackupMetadata_Deserialized,
recoveryPointMetadataFile.footer.Version,
Version));
}
// Read and validate the properties section.
var propertiesHandle = recoveryPointMetadataFile.footer.PropertiesHandle;
recoveryPointMetadataFile.properties =
await
FileBlock.ReadBlockAsync(
filestream,
propertiesHandle,
(reader, handle) => FileProperties.Read <RecoveryPointMetadataFileProperties>(reader, handle)).ConfigureAwait(false);
cancellationToken.ThrowIfCancellationRequested();
return(recoveryPointMetadataFile);
}
/// <summary>
/// Deserializes the metadata (footer, properties, etc.) for this checkpoint file.
/// </summary>
private async Task ReadMetadataAsync()
{
Stream filestream = null;
try
{
filestream = this.ReaderPool.AcquireStream();
var snapFileStream = filestream as FileStream;
Diagnostics.Assert(snapFileStream != null, this.traceType, "fileStream must be a FileStream");
Microsoft.ServiceFabric.Replicator.Utility.SetIoPriorityHint(snapFileStream.SafeFileHandle, this.priorityHint);
// Read and validate the Footer section. The footer is always at the end of the stream, minus space for the checksum.
var footerHandle = new BlockHandle(filestream.Length - FileFooter.SerializedSize - sizeof(ulong), FileFooter.SerializedSize);
this.Footer =
await FileBlock.ReadBlockAsync(filestream, footerHandle, (sectionReader, sectionHandle) => FileFooter.Read(sectionReader, sectionHandle)).ConfigureAwait(false);
// Verify we know how to deserialize this version of the checkpoint file.
if (this.Footer.Version != FileVersion)
{
throw new InvalidDataException(SR.Error_ValueCheckpoint_Deserialized);
}
// Read and validate the Properties section.
var propertiesHandle = this.Footer.PropertiesHandle;
this.Properties =
await
FileBlock.ReadBlockAsync(
filestream,
propertiesHandle,
(sectionReader, sectionHandle) => FilePropertySection.Read <ValueCheckpointFileProperties>(sectionReader, sectionHandle)).ConfigureAwait(false);
}
finally
{
this.ReaderPool.ReleaseStream(filestream, true);
}
}
internal static async Task ValidateAsync(string path, string traceType)
{
// MCoskun: Open of metadata file's IO priority is not set.
// Reason: USed during CompleteCheckpoint which can block copy and backup.
using (var stream = FabricFile.Open(path, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, FileOptions.Asynchronous))
{
// Read and validate the Footer section. The footer is always at the end of the stream, minus space for the checksum.
var footerHandle = new BlockHandle(stream.Length - FileFooter.SerializedSize - sizeof(ulong), FileFooter.SerializedSize);
var footer = await FileBlock.ReadBlockAsync(stream, footerHandle, (sectionReader, sectionHandle) => FileFooter.Read(sectionReader, sectionHandle)).ConfigureAwait(false);
// Verify we know how to deserialize this version of the file.
if (footer.Version != FileVersion)
{
throw new InvalidDataException(SR.Error_MetadataManager_Deserialized);
}
// Read and validate the Properties section.
var propertiesHandle = footer.PropertiesHandle;
var properties = await FileBlock.ReadBlockAsync(
stream,
propertiesHandle,
(sectionReader, sectionHandle) => FilePropertySection.Read <MetadataManagerFileProperties>(sectionReader, sectionHandle)).ConfigureAwait(false);
}
}
