```
Edit version in `lib/pgBackRest/Version.pm`, e.g.:
```
use constant PROJECT_VERSION => '2.14';
```
to:
```
use constant PROJECT_VERSION => '2.15dev';
```
Run deploy to generate git history (ctrl-c as soon as the file is generated):
```
doc/release.pl --build
```
Build to generate files and test documentation:
```
test/test.pl --vm=u18 --build-only
```
Commit and push to integration:
```
git commit -m "Begin v2.15 development."
git push origin integration
```
pgbackrest-release-2.24/doc/doc.pl 0000775 0000000 0000000 00000031357 13625315071 0017072 0 ustar 00root root 0000000 0000000 #!/usr/bin/perl
####################################################################################################################################
# doc.pl - PgBackRest Doc Builder
####################################################################################################################################
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
$SIG{__DIE__} = sub { Carp::confess @_ };
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Getopt::Long qw(GetOptions);
use Pod::Usage qw(pod2usage);
use Storable;
use lib dirname(abs_path($0)) . '/lib';
use lib dirname(dirname(abs_path($0))) . '/lib';
use lib dirname(dirname(abs_path($0))) . '/build/lib';
use lib dirname(dirname(abs_path($0))) . '/test/lib';
use BackRestDoc::Common::Doc;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
use BackRestDoc::Common::DocRender;
use BackRestDoc::Html::DocHtmlSite;
use BackRestDoc::Latex::DocLatex;
use BackRestDoc::Markdown::DocMarkdown;
use pgBackRest::Common::Exception;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestTest::Common::Storage;
use pgBackRestTest::Common::StoragePosix;
####################################################################################################################################
# Usage
####################################################################################################################################
=head1 NAME
doc.pl - Generate pgBackRest documentation
=head1 SYNOPSIS
doc.pl [options]
General Options:
--help Display usage and exit
--version Display pgBackRest version
--quiet Sets log level to ERROR
--log-level Log level for execution (e.g. ERROR, WARN, INFO, DEBUG)
--deploy Write exe.cache into resource for persistence
--no-exe Should commands be executed when building help? (for testing only)
--no-cache Don't use execution cache
--cache-only Only use the execution cache - don't attempt to generate it
--pre Pre-build containers for execute elements marked pre
--var Override defined variable
--key-var Override defined variable and use in cache key
--doc-path Document path to render (manifest.xml should be located here)
--out Output types (html, pdf, markdown)
--out-preserve Don't clean output directory
--require Require only certain sections of the document (to speed testing)
--include Include source in generation (links will reference website)
--exclude Exclude source from generation (links will reference website)
Variable Options:
--dev Set 'dev' variable to 'y'
--debug Set 'debug' variable to 'y'
=cut
####################################################################################################################################
# Load command line parameters and config (see usage above for details)
####################################################################################################################################
my $bHelp = false;
my $bVersion = false;
my $bQuiet = false;
my $strLogLevel = 'info';
my $bNoExe = false;
my $bNoCache = false;
my $bCacheOnly = false;
my $rhVariableOverride = {};
my $rhKeyVariableOverride = {};
my $strDocPath;
my @stryOutput;
my $bOutPreserve = false;
my @stryRequire;
my @stryInclude;
my @stryExclude;
my $bDeploy = false;
my $bDev = false;
my $bDebug = false;
my $bPre = false;
GetOptions ('help' => \$bHelp,
'version' => \$bVersion,
'quiet' => \$bQuiet,
'log-level=s' => \$strLogLevel,
'out=s@' => \@stryOutput,
'out-preserve' => \$bOutPreserve,
'require=s@' => \@stryRequire,
'include=s@' => \@stryInclude,
'exclude=s@' => \@stryExclude,
'no-exe', \$bNoExe,
'deploy', \$bDeploy,
'no-cache', \$bNoCache,
'dev', \$bDev,
'debug', \$bDebug,
'pre', \$bPre,
'cache-only', \$bCacheOnly,
'key-var=s%', $rhKeyVariableOverride,
'var=s%', $rhVariableOverride,
'doc-path=s', \$strDocPath)
or pod2usage(2);
####################################################################################################################################
# Run in eval block to catch errors
####################################################################################################################################
eval
{
# Display version and exit if requested
if ($bHelp || $bVersion)
{
print PROJECT_NAME . ' ' . PROJECT_VERSION . " Documentation Builder\n";
if ($bHelp)
{
print "\n";
pod2usage();
}
exit 0;
}
# Disable cache when no exe
if ($bNoExe)
{
$bNoCache = true;
}
# Make sure options are set correctly for deploy
if ($bDeploy)
{
my $strError = 'cannot be specified for deploy';
!$bNoExe
or confess "--no-exe ${strError}";
!@stryRequire
or confess "--require ${strError}";
}
# one --include must be specified when --required is
if (@stryRequire && @stryInclude != 1)
{
confess "one --include is required when --require is specified";
}
# Set console log level
if ($bQuiet)
{
$strLogLevel = 'error';
}
# If --dev passed then set the dev var to 'y'
if ($bDev)
{
$rhVariableOverride->{'dev'} = 'y';
}
# If --debug passed then set the debug var to 'y'
if ($bDebug)
{
$rhVariableOverride->{'debug'} = 'y';
}
# Doesn't make sense to pass include and exclude
if (@stryInclude > 0 && @stryExclude > 0)
{
confess "cannot specify both --include and --exclude";
}
logLevelSet(undef, uc($strLogLevel), OFF);
# Get the base path
my $strBasePath = abs_path(dirname($0));
my $oStorageDoc = new pgBackRestTest::Common::Storage(
$strBasePath, new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
if (!defined($strDocPath))
{
$strDocPath = $strBasePath;
}
my $strOutputPath = "${strDocPath}/output";
# Create the out path if it does not exist
if (!-e $strOutputPath)
{
mkdir($strOutputPath)
or confess &log(ERROR, "unable to create path ${strOutputPath}");
}
# Merge key variables into the variable list and ensure there are no duplicates
foreach my $strKey (sort(keys(%{$rhKeyVariableOverride})))
{
if (defined($rhVariableOverride->{$strKey}))
{
confess &log(ERROR, "'${strKey}' cannot be passed as --var and --key-var");
}
$rhVariableOverride->{$strKey} = $rhKeyVariableOverride->{$strKey};
}
# Load the manifest
my $oManifest = new BackRestDoc::Common::DocManifest(
$oStorageDoc, \@stryRequire, \@stryInclude, \@stryExclude, $rhKeyVariableOverride, $rhVariableOverride,
$strDocPath, $bDeploy, $bCacheOnly, $bPre);
if (!$bNoCache)
{
$oManifest->cacheRead();
}
# If no outputs were given
if (@stryOutput == 0)
{
@stryOutput = $oManifest->renderList();
if ($oManifest->isBackRest())
{
push(@stryOutput, 'man');
}
}
# Build host containers
if (!$bCacheOnly && !$bNoExe)
{
foreach my $strSource ($oManifest->sourceList())
{
if ((@stryInclude == 0 || grep(/$strSource/, @stryInclude)) && !grep(/$strSource/, @stryExclude))
{
&log(INFO, "source $strSource");
foreach my $oHostDefine ($oManifest->sourceGet($strSource)->{doc}->nodeList('host-define', false))
{
if ($oManifest->evaluateIf($oHostDefine))
{
my $strImage = $oManifest->variableReplace($oHostDefine->paramGet('image'));
my $strFrom = $oManifest->variableReplace($oHostDefine->paramGet('from'));
my $strDockerfile = "${strOutputPath}/doc-host.dockerfile";
&log(INFO, "Build vm '${strImage}' from '${strFrom}'");
$oStorageDoc->put(
$strDockerfile,
"FROM ${strFrom}\n\n" . trim($oManifest->variableReplace($oHostDefine->valueGet())) . "\n");
executeTest("docker build -f ${strDockerfile} -t ${strImage} ${strBasePath}");
}
}
}
}
}
# Render output
for my $strOutput (@stryOutput)
{
if (!($strOutput eq 'man' && $oManifest->isBackRest()))
{
$oManifest->renderGet($strOutput);
}
&log(INFO, "render ${strOutput} output");
# Clean contents of out directory
if (!$bOutPreserve)
{
my $strOutputPath = $strOutput eq 'pdf' ? "${strOutputPath}/latex" : "${strOutputPath}/$strOutput";
# Clean the current out path if it exists
if (-e $strOutputPath)
{
executeTest("rm -rf ${strOutputPath}/*");
}
# Else create the html path
else
{
mkdir($strOutputPath)
or confess &log(ERROR, "unable to create path ${strOutputPath}");
}
}
if ($strOutput eq 'markdown')
{
my $oMarkdown =
new BackRestDoc::Markdown::DocMarkdown
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/markdown",
!$bNoExe
);
$oMarkdown->process();
}
elsif ($strOutput eq 'man' && $oManifest->isBackRest())
{
# Generate the command-line help
my $oRender = new BackRestDoc::Common::DocRender('text', $oManifest, !$bNoExe);
my $oDocConfig =
new BackRestDoc::Common::DocConfig(
new BackRestDoc::Common::Doc("${strBasePath}/xml/reference.xml"), $oRender);
$oStorageDoc->pathCreate(
"${strBasePath}/output/man", {strMode => '0770', bIgnoreExists => true, bCreateParent => true});
$oStorageDoc->put("${strBasePath}/output/man/" . lc(PROJECT_NAME) . '.1.txt', $oDocConfig->manGet($oManifest));
}
elsif ($strOutput eq 'html')
{
my $oHtmlSite =
new BackRestDoc::Html::DocHtmlSite
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/html",
"${strBasePath}/resource/html/default.css",
defined($oManifest->variableGet('project-favicon')) ?
"${strBasePath}/resource/html/" . $oManifest->variableGet('project-favicon') : undef,
defined($oManifest->variableGet('project-logo')) ?
"${strBasePath}/resource/" . $oManifest->variableGet('project-logo') : undef,
!$bNoExe
);
$oHtmlSite->process();
}
elsif ($strOutput eq 'pdf')
{
my $oLatex =
new BackRestDoc::Latex::DocLatex
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/latex",
"${strBasePath}/resource/latex/preamble.tex",
!$bNoExe
);
$oLatex->process();
}
}
# Cache the manifest (mostly useful for testing rendering changes in the code)
if (!$bNoCache && !$bCacheOnly)
{
$oManifest->cacheWrite();
}
# Exit with success
exit 0;
}
####################################################################################################################################
# Check for errors
####################################################################################################################################
or do
{
# If a backrest exception then return the code
exit $EVAL_ERROR->code() if (isException(\$EVAL_ERROR));
# Else output the unhandled error
print $EVAL_ERROR;
exit ERROR_UNHANDLED;
};
# It shouldn't be possible to get here
&log(ASSERT, 'execution reached invalid location in ' . __FILE__ . ', line ' . __LINE__);
exit ERROR_ASSERT;
pgbackrest-release-2.24/doc/example/ 0000775 0000000 0000000 00000000000 13625315071 0017407 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/example/pgsql-pgbackrest-info.sql 0000664 0000000 0000000 00000001513 13625315071 0024332 0 ustar 00root root 0000000 0000000 -- An example of monitoring pgBackRest from within PostgreSQL
--
-- Use copy to export data from the pgBackRest info command into the jsonb
-- type so it can be queried directly by PostgreSQL.
-- Create monitor schema
create schema monitor;
-- Get pgBackRest info in JSON format
create function monitor.pgbackrest_info()
returns jsonb AS $$
declare
data jsonb;
begin
-- Create a temp table to hold the JSON data
create temp table temp_pgbackrest_data (data jsonb);
-- Copy data into the table directly from the pgBackRest info command
copy temp_pgbackrest_data (data)
from program
'pgbackrest --output=json info' (format text);
select temp_pgbackrest_data.data
into data
from temp_pgbackrest_data;
drop table temp_pgbackrest_data;
return data;
end $$ language plpgsql;
pgbackrest-release-2.24/doc/example/pgsql-pgbackrest-query.sql 0000664 0000000 0000000 00000001140 13625315071 0024540 0 ustar 00root root 0000000 0000000 -- Get last successful backup for each stanza
--
-- Requires the monitor.pgbackrest_info function.
with stanza as
(
select data->'name' as name,
data->'backup'->(
jsonb_array_length(data->'backup') - 1) as last_backup,
data->'archive'->(
jsonb_array_length(data->'archive') - 1) as current_archive
from jsonb_array_elements(monitor.pgbackrest_info()) as data
)
select name,
to_timestamp(
(last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,
current_archive->>'max' as last_archived_wal
from stanza;
pgbackrest-release-2.24/doc/lib/ 0000775 0000000 0000000 00000000000 13625315071 0016522 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/ 0000775 0000000 0000000 00000000000 13625315071 0020646 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/ 0000775 0000000 0000000 00000000000 13625315071 0022076 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/Doc.pm 0000664 0000000 0000000 00000060645 13625315071 0023154 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MODULE
####################################################################################################################################
package BackRestDoc::Common::Doc;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Scalar::Util qw(blessed);
use XML::Checker::Parser;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strFileName},
my $strSgmlSearchPath,
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strFileName', required => false},
{name => 'strSgmlSearchPath', required => false},
);
# Load the doc from a file if one has been defined
if (defined($self->{strFileName}))
{
my $oParser = XML::Checker::Parser->new(ErrorContext => 2, Style => 'Tree');
$oParser->set_sgml_search_path(
defined($strSgmlSearchPath) ? $strSgmlSearchPath : dirname(dirname(abs_path($0))) . '/doc/xml/dtd');
my $oTree;
eval
{
local $XML::Checker::FAIL = sub
{
my $iCode = shift;
die XML::Checker::error_string($iCode, @_);
};
$oTree = $oParser->parsefile($self->{strFileName});
return true;
}
# Report any error that stopped parsing
or do
{
my $strException = $EVAL_ERROR;
$strException =~ s/at \/.*?$//s; # remove module line number
die "malformed xml in '$self->{strFileName}':\n" . trim($strException);
};
# Parse and build the doc
$self->{oDoc} = $self->build($self->parse(${$oTree}[0], ${$oTree}[1]));
}
# Else create a blank doc
else
{
$self->{oDoc} = {name => 'doc', children => []};
}
$self->{strName} = 'root';
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# parse
#
# Parse the xml doc into a more usable hash and array structure.
####################################################################################################################################
sub parse
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$oyNode
) =
logDebugParam
(
__PACKAGE__ . '->parse', \@_,
{name => 'strName', trace => true},
{name => 'oyNode', trace => true}
);
my %oOut;
my $iIndex = 0;
my $bText = $strName eq 'text' || $strName eq 'li' || $strName eq 'p' || $strName eq 'title' ||
$strName eq 'summary' || $strName eq 'table-cell' || $strName eq 'table-column' || $strName eq 'list-item' ||
$strName eq 'admonition';
# Store the node name
$oOut{name} = $strName;
if (keys(%{$$oyNode[$iIndex]}))
{
$oOut{param} = $$oyNode[$iIndex];
}
$iIndex++;
# Look for strings and children
while (defined($$oyNode[$iIndex]))
{
# Process string data
if (ref(\$$oyNode[$iIndex]) eq 'SCALAR' && $$oyNode[$iIndex] eq '0')
{
$iIndex++;
my $strBuffer = $$oyNode[$iIndex++];
# Strip tabs, CRs, and LFs
$strBuffer =~ s/\t|\r//g;
# If anything is left
if (length($strBuffer) > 0)
{
# If text node then create array entries for strings
if ($bText)
{
if (!defined($oOut{children}))
{
$oOut{children} = [];
}
push(@{$oOut{children}}, $strBuffer);
}
# Don't allow strings mixed with children
elsif (length(trim($strBuffer)) > 0)
{
if (defined($oOut{children}))
{
confess "text mixed with children in node ${strName} (spaces count)";
}
if (defined($oOut{value}))
{
confess "value is already defined in node ${strName} - this shouldn't happen";
}
# Don't allow text mixed with
$oOut{value} = $strBuffer;
}
}
}
# Process a child
else
{
if (defined($oOut{value}) && $bText)
{
confess "text mixed with children in node ${strName} before child " . $$oyNode[$iIndex++] . " (spaces count)";
}
if (!defined($oOut{children}))
{
$oOut{children} = [];
}
push(@{$oOut{children}}, $self->parse($$oyNode[$iIndex++], $$oyNode[$iIndex++]));
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => \%oOut, trace => true}
);
}
####################################################################################################################################
# build
#
# Restructure the doc to make walking it easier.
####################################################################################################################################
sub build
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oDoc
) =
logDebugParam
(
__PACKAGE__ . '->build', \@_,
{name => 'oDoc', trace => true}
);
# Initialize the node object
my $oOut = {name => $$oDoc{name}, children => [], value => $$oDoc{value}};
my $strError = "in node $$oDoc{name}";
# Get all params
if (defined($$oDoc{param}))
{
for my $strParam (keys %{$$oDoc{param}})
{
$$oOut{param}{$strParam} = $$oDoc{param}{$strParam};
}
}
if ($$oDoc{name} eq 'p' || $$oDoc{name} eq 'title' || $$oDoc{name} eq 'summary' ||
$$oDoc{name} eq 'table-cell' || $$oDoc{name} eq 'table-column' || $$oDoc{name} eq 'list-item' ||
$$oDoc{name} eq 'admonition')
{
$$oOut{field}{text} = $oDoc;
}
elsif (defined($$oDoc{children}))
{
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
my $oSub = $$oDoc{children}[$iIndex];
my $strName = $$oSub{name};
if ($strName eq 'text')
{
$$oOut{field}{text} = $oSub;
}
elsif ((defined($$oSub{value}) && !defined($$oSub{param})) && $strName ne 'code-block')
{
$$oOut{field}{$strName} = $$oSub{value};
}
elsif (!defined($$oSub{children}) && !defined($$oSub{value}) && !defined($$oSub{param}))
{
$$oOut{field}{$strName} = true;
}
else
{
push(@{$$oOut{children}}, $self->build($oSub));
}
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oOut, trace => true}
);
}
####################################################################################################################################
# nodeGetById
#
# Return a node by name - error if more than one exists
####################################################################################################################################
sub nodeGetById
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strId,
$bRequired,
) =
logDebugParam
(
__PACKAGE__ . 'nodeGetById', \@_,
{name => 'strName', trace => true},
{name => 'strId', required => false, trace => true},
{name => 'bRequired', default => true, trace => true}
);
my $oDoc = $self->{oDoc};
my $oNode;
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ((defined($strName) && $$oDoc{children}[$iIndex]{name} eq $strName) &&
(!defined($strId) || $$oDoc{children}[$iIndex]{param}{id} eq $strId))
{
if (!defined($oNode))
{
$oNode = $$oDoc{children}[$iIndex];
}
else
{
confess "found more than one child ${strName} in node $$oDoc{name}";
}
}
}
if (!defined($oNode) && $bRequired)
{
confess "unable to find child ${strName}" . (defined($strId) ? " (${strId})" : '') . " in node $$oDoc{name}";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oNodeDoc', value => $self->nodeBless($oNode), trace => true}
);
}
####################################################################################################################################
# nodeGet
#
# Return a node by name - error if more than one exists
####################################################################################################################################
sub nodeGet
{
my $self = shift;
return $self->nodeGetById(shift, undef, shift);
}
####################################################################################################################################
# nodeTest
#
# Test that a node exists
####################################################################################################################################
sub nodeTest
{
my $self = shift;
return defined($self->nodeGetById(shift, undef, false));
}
####################################################################################################################################
# nodeAdd
#
# Add a node to to the current doc's child list
####################################################################################################################################
sub nodeAdd
{
my $self = shift;
my $strName = shift;
my $strValue = shift;
my $oParam = shift;
my $oField = shift;
my $oDoc = $self->{oDoc};
my $oNode = {name => $strName, value => $strValue, param => $oParam, field => $oField};
push(@{$$oDoc{children}}, $oNode);
return $self->nodeBless($oNode);
}
####################################################################################################################################
# nodeBless
#
# Make a new Doc object from a node.
####################################################################################################################################
sub nodeBless
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oNode
) =
logDebugParam
(
__PACKAGE__ . '->nodeBless', \@_,
{name => 'oNode', required => false, trace => true}
);
my $oDoc;
if (defined($oNode))
{
$oDoc = {};
bless $oDoc, $self->{strClass};
$oDoc->{strClass} = $self->{strClass};
$oDoc->{strName} = $$oNode{name};
$oDoc->{oDoc} = $oNode;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc, trace => true}
);
}
####################################################################################################################################
# nodeList
#
# Get a list of nodes.
####################################################################################################################################
sub nodeList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$bRequired,
) =
logDebugParam
(
__PACKAGE__ . '->nodeList', \@_,
{name => 'strName', required => false, trace => true},
{name => 'bRequired', default => true, trace => true},
);
my $oDoc = $self->{oDoc};
my @oyNode;
if (defined($$oDoc{children}))
{
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if (!defined($strName) || $$oDoc{children}[$iIndex]{name} eq $strName)
{
if (ref(\$$oDoc{children}[$iIndex]) eq "SCALAR")
{
push(@oyNode, $$oDoc{children}[$iIndex]);
}
else
{
push(@oyNode, $self->nodeBless($$oDoc{children}[$iIndex]));
}
}
}
}
if (@oyNode == 0 && $bRequired)
{
confess 'unable to find ' . (defined($strName) ? "children named '${strName}'" : 'any children') . " in node $$oDoc{name}";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oyNode', value => \@oyNode, trace => true}
);
}
####################################################################################################################################
# nodeRemove
#
# Remove a child node.
####################################################################################################################################
sub nodeRemove
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oChildRemove
) =
logDebugParam
(
__PACKAGE__ . '->nodeRemove', \@_,
{name => 'oChildRemove', required => false, trace => true}
);
my $bRemove = false;
my $oDoc = $self->{oDoc};
# Error if there are no children
if (!defined($$oDoc{children}))
{
confess &log(ERROR, "node has no children");
}
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ($$oDoc{children}[$iIndex] == $oChildRemove->{oDoc})
{
splice(@{$$oDoc{children}}, $iIndex, 1);
$bRemove = true;
last;
}
}
if (!$bRemove)
{
confess &log(ERROR, "child was not found in node, could not be removed");
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# nodeReplace
#
# Replace a child node with one or more child nodes.
####################################################################################################################################
sub nodeReplace
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oChildRemove,
$oyChildReplace,
) =
logDebugParam
(
__PACKAGE__ . '->nodeReplace', \@_,
{name => 'oChildRemove', trace => true},
{name => 'oChildReplace', trace => true},
);
my $bReplace = false;
my $iReplaceIdx = undef;
my $iReplaceTotal = undef;
my $oDoc = $self->{oDoc};
# Error if there are no children
if (!defined($$oDoc{children}))
{
confess &log(ERROR, "node has no children");
}
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ($$oDoc{children}[$iIndex] == $oChildRemove->{oDoc})
{
splice(@{$$oDoc{children}}, $iIndex, 1);
splice(@{$$oDoc{children}}, $iIndex, 0, @{$oyChildReplace});
$iReplaceIdx = $iIndex;
$iReplaceTotal = scalar(@{$oyChildReplace});
$bReplace = true;
last;
}
}
if (!$bReplace)
{
confess &log(ERROR, "child was not found in node, could not be replaced");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'iReplaceIdx', value => $iReplaceIdx, trace => true},
{name => 'iReplaceTotal', value => $iReplaceTotal, trace => true},
);
}
####################################################################################################################################
# nameGet
####################################################################################################################################
sub nameGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->nameGet');
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strName', value => ${$self->{oDoc}}{name}, trace => true}
);
}
####################################################################################################################################
# valueGet
####################################################################################################################################
sub valueGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->valueGet');
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strValue', value => ${$self->{oDoc}}{value}, trace => true}
);
}
####################################################################################################################################
# valueSet
####################################################################################################################################
sub valueSet
{
my $self = shift;
my $strValue = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->valueSet');
# Set the value
${$self->{oDoc}}{value} = $strValue;
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# paramGet
#
# Get a parameter from a node.
####################################################################################################################################
sub paramGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$bRequired,
$strDefault,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramGet', \@_,
{name => 'strName', trace => true},
{name => 'bRequired', default => true, trace => true},
{name => 'strDefault', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
my $strValue = ${$self->{oDoc}}{$strType}{$strName};
if (!defined($strValue))
{
if ($bRequired)
{
confess "${strType} '${strName}' is required in node '$self->{strName}'";
}
$strValue = $strDefault;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strValue', value => $strValue, trace => true}
);
}
####################################################################################################################################
# paramTest
#
# Test that a parameter exists or has a certain value.
####################################################################################################################################
sub paramTest
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strExpectedValue,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramTest', \@_,
{name => 'strName', trace => true},
{name => 'strExpectedValue', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
my $bResult = true;
my $strValue = $self->paramGet($strName, false, undef, $strType);
if (!defined($strValue))
{
$bResult = false;
}
elsif (defined($strExpectedValue) && $strValue ne $strExpectedValue)
{
$bResult = false;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'bResult', value => $bResult, trace => true}
);
}
####################################################################################################################################
# paramSet
#
# Set a parameter in a node.
####################################################################################################################################
sub paramSet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strValue,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramSet', \@_,
{name => 'strName', trace => true},
{name => 'strValue', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
${$self->{oDoc}}{$strType}{$strName} = $strValue;
# Return from function and log return values if any
logDebugReturn($strOperation);
}
####################################################################################################################################
# fieldGet
#
# Get a field from a node.
####################################################################################################################################
sub fieldGet
{
my $self = shift;
return $self->paramGet(shift, shift, shift, 'field');
}
####################################################################################################################################
# fieldTest
#
# Test if a field exists.
####################################################################################################################################
sub fieldTest
{
my $self = shift;
return $self->paramTest(shift, shift, 'field');
}
####################################################################################################################################
# textGet
#
# Get a field from a node.
####################################################################################################################################
sub textGet
{
my $self = shift;
return $self->nodeBless($self->paramGet('text', shift, shift, 'field'));
}
####################################################################################################################################
# textSet
#
# Get a field from a node.
####################################################################################################################################
sub textSet
{
my $self = shift;
my $oText = shift;
if (blessed($oText) && $oText->isa('BackRestDoc::Common::Doc'))
{
$oText = $oText->{oDoc};
}
elsif (ref($oText) ne 'HASH')
{
$oText = {name => 'text', children => [$oText]};
}
return $self->paramSet('text', $oText, 'field');
}
####################################################################################################################################
# fieldSet
#
# Set a parameter in a node.
####################################################################################################################################
sub fieldSet
{
my $self = shift;
$self->paramSet(shift, shift, 'field');
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/DocConfig.pm 0000664 0000000 0000000 00000102343 13625315071 0024272 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC CONFIG MODULE
####################################################################################################################################
package BackRestDoc::Common::DocConfig;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRestBuild::Config::Data;
use pgBackRest::Version;
####################################################################################################################################
# Help types
####################################################################################################################################
use constant CONFIG_HELP_COMMAND => 'command';
push @EXPORT, qw(CONFIG_HELP_COMMAND);
use constant CONFIG_HELP_CURRENT => 'current';
use constant CONFIG_HELP_DEFAULT => 'default';
use constant CONFIG_HELP_DESCRIPTION => 'description';
push @EXPORT, qw(CONFIG_HELP_DESCRIPTION);
use constant CONFIG_HELP_EXAMPLE => 'example';
use constant CONFIG_HELP_NAME => 'name';
use constant CONFIG_HELP_NAME_ALT => 'name-alt';
push @EXPORT, qw(CONFIG_HELP_NAME_ALT);
use constant CONFIG_HELP_OPTION => 'option';
push @EXPORT, qw(CONFIG_HELP_OPTION);
use constant CONFIG_HELP_SECTION => 'section';
push @EXPORT, qw(CONFIG_HELP_SECTION);
use constant CONFIG_HELP_SUMMARY => 'summary';
push @EXPORT, qw(CONFIG_HELP_SUMMARY);
use constant CONFIG_HELP_SOURCE => 'source';
push @EXPORT, qw(CONFIG_HELP_SOURCE);
use constant CONFIG_HELP_SOURCE_DEFAULT => 'default';
use constant CONFIG_HELP_SOURCE_SECTION => CONFIG_HELP_SECTION;
use constant CONFIG_HELP_SOURCE_COMMAND => CONFIG_HELP_COMMAND;
push @EXPORT, qw(CONFIG_HELP_SOURCE_COMMAND);
####################################################################################################################################
# Config Section Types
####################################################################################################################################
use constant CFGDEF_COMMAND => 'command';
use constant CFGDEF_GENERAL => 'general';
use constant CFGDEF_LOG => 'log';
use constant CFGDEF_REPOSITORY => 'repository';
####################################################################################################################################
# Option define hash
####################################################################################################################################
my $rhConfigDefine = cfgDefine();
####################################################################################################################################
# Returns the option defines based on the command.
####################################################################################################################################
sub docConfigCommandDefine
{
my $strOption = shift;
my $strCommand = shift;
if (defined($strCommand))
{
return defined($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}) &&
defined($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}) &&
ref($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}) eq 'HASH' ?
$rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand} : undef;
}
return;
}
####################################################################################################################################
# Does the option have a default for this command?
####################################################################################################################################
sub docConfigOptionDefault
{
my $strOption = shift;
my $strCommand = shift;
# Get the command define
my $oCommandDefine = docConfigCommandDefine($strOption, $strCommand);
# Check for default in command
my $strDefault = defined($oCommandDefine) ? $$oCommandDefine{&CFGDEF_DEFAULT} : undef;
# If defined return, else try to grab the global default
return defined($strDefault) ? $strDefault : $rhConfigDefine->{$strOption}{&CFGDEF_DEFAULT};
}
push @EXPORT, qw(docConfigOptionDefault);
####################################################################################################################################
# Get the allowed setting range for the option if it exists
####################################################################################################################################
sub docConfigOptionRange
{
my $strOption = shift;
my $strCommand = shift;
# Get the command define
my $oCommandDefine = docConfigCommandDefine($strOption, $strCommand);
# Check for default in command
if (defined($oCommandDefine) && defined($$oCommandDefine{&CFGDEF_ALLOW_RANGE}))
{
return $$oCommandDefine{&CFGDEF_ALLOW_RANGE}[0], $$oCommandDefine{&CFGDEF_ALLOW_RANGE}[1];
}
# If defined return, else try to grab the global default
return $rhConfigDefine->{$strOption}{&CFGDEF_ALLOW_RANGE}[0], $rhConfigDefine->{$strOption}{&CFGDEF_ALLOW_RANGE}[1];
}
push @EXPORT, qw(docConfigOptionRange);
####################################################################################################################################
# Get the option type
####################################################################################################################################
sub docConfigOptionType
{
my $strOption = shift;
return $rhConfigDefine->{$strOption}{&CFGDEF_TYPE};
}
push @EXPORT, qw(docConfigOptionType);
####################################################################################################################################
# Test the option type
####################################################################################################################################
sub docConfigOptionTypeTest
{
my $strOption = shift;
my $strType = shift;
return docConfigOptionType($strOption) eq $strType;
}
push @EXPORT, qw(docConfigOptionTypeTest);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oDoc},
$self->{oDocRender}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oDoc'},
{name => 'oDocRender', required => false}
);
$self->process();
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Parse the xml doc into commands and options.
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Iterate through all commands
my $oDoc = $self->{oDoc};
my $oConfigHash = {};
foreach my $strCommand (cfgDefineCommandList())
{
my $oCommandDoc = $oDoc->nodeGet('operation')->nodeGet('command-list')->nodeGetById('command', $strCommand);
$$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand} = {};
my $oCommand = $$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand};
$$oCommand{&CONFIG_HELP_SUMMARY} = $oCommandDoc->nodeGet('summary')->textGet();
$$oCommand{&CONFIG_HELP_DESCRIPTION} = $oCommandDoc->textGet();
}
# Iterate through all options
my $oOptionDefine = cfgDefine();
foreach my $strOption (sort(keys(%{$oOptionDefine})))
{
# Skip options that are internal only for all commands (test options)
next if $oOptionDefine->{$strOption}{&CFGDEF_INTERNAL};
# Iterate through all commands
my @stryCommandList = sort(keys(%{defined($$oOptionDefine{$strOption}{&CFGDEF_COMMAND}) ?
$$oOptionDefine{$strOption}{&CFGDEF_COMMAND} : $$oConfigHash{&CONFIG_HELP_COMMAND}}));
foreach my $strCommand (@stryCommandList)
{
if (!defined($$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}))
{
next;
}
if (ref(\$$oOptionDefine{$strOption}{&CFGDEF_COMMAND}{$strCommand}) eq 'SCALAR' &&
$$oOptionDefine{$strOption}{&CFGDEF_COMMAND}{$strCommand} == false)
{
next;
}
# Skip options that are internal only for the current command
next if $oOptionDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_INTERNAL};
my $oCommandDoc = $oDoc->nodeGet('operation')->nodeGet('command-list')->nodeGetById('command', $strCommand);
# First check if the option is documented in the command
my $oOptionDoc;
my $strOptionSource;
my $oCommandOptionList = $oCommandDoc->nodeGet('option-list', false);
if (defined($oCommandOptionList))
{
$oOptionDoc = $oCommandOptionList->nodeGetById('option', $strOption, false);
$strOptionSource = CONFIG_HELP_SOURCE_COMMAND if (defined($oOptionDoc));
}
# If the option wasn't found keep looking
my $strSection;
if (!defined($oOptionDoc))
{
# Next see if it's documented in the section
if (defined($$oOptionDefine{$strOption}{&CFGDEF_SECTION}))
{
# &log(INFO, " trying section ${strSection}");
foreach my $oSectionNode ($oDoc->nodeGet('config')->nodeGet('config-section-list')->nodeList())
{
my $oOptionDocCheck = $oSectionNode->nodeGetById('config-key-list')
->nodeGetById('config-key', $strOption, false);
if ($oOptionDocCheck)
{
if (defined($oOptionDoc))
{
confess 'option exists in more than one section';
}
$oOptionDoc = $oOptionDocCheck;
$strOptionSource = CONFIG_HELP_SOURCE_SECTION;
$strSection = $oSectionNode->paramGet('id');
}
}
}
# If no section is defined then look in the default command option list
else
{
$oOptionDoc = $oDoc->nodeGet('operation')->nodeGet('operation-general')->nodeGet('option-list')
->nodeGetById('option', $strOption, false);
$strOptionSource = CONFIG_HELP_SOURCE_DEFAULT if (defined($oOptionDoc));
}
}
# If the option wasn't found then error
if (!defined($oOptionDoc))
{
confess &log(ERROR, "unable to find option '${strOption}' for command '${strCommand}'")
}
# if the option is documented in the command then it should be accessible from the command line only.
if (!defined($strSection))
{
if (defined($$oOptionDefine{$strOption}{&CFGDEF_SECTION}))
{
&log(ERROR,
"option ${strOption} defined in command ${strCommand} must not have " . CFGDEF_SECTION .
" defined");
}
}
# Store the option in the command
$$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_SOURCE} =
$strOptionSource;
my $oCommandOption = $$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_OPTION}{$strOption};
$$oCommandOption{&CONFIG_HELP_SUMMARY} = $oOptionDoc->nodeGet('summary')->textGet();
$$oCommandOption{&CONFIG_HELP_DESCRIPTION} = $oOptionDoc->textGet();
$$oCommandOption{&CONFIG_HELP_EXAMPLE} = $oOptionDoc->fieldGet('example');
$$oCommandOption{&CONFIG_HELP_NAME} = $oOptionDoc->paramGet('name');
# Generate a list of alternate names
if (defined($rhConfigDefine->{$strOption}{&CFGDEF_NAME_ALT}))
{
my $rhNameAlt = {};
foreach my $strNameAlt (sort(keys(%{$rhConfigDefine->{$strOption}{&CFGDEF_NAME_ALT}})))
{
$strNameAlt =~ s/\?//g;
if ($strNameAlt ne $strOption)
{
$rhNameAlt->{$strNameAlt} = true;
}
}
my @stryNameAlt = sort(keys(%{$rhNameAlt}));
if (@stryNameAlt > 0)
{
if (@stryNameAlt != 1)
{
confess &log(
ERROR, "multiple alt names are not supported for option '${strOption}': " . join(', ', @stryNameAlt));
}
$oCommandOption->{&CONFIG_HELP_NAME_ALT} = \@stryNameAlt;
}
}
# If the option did not come from the command also store in global option list. This prevents duplication of commonly
# used options.
if ($strOptionSource ne CONFIG_HELP_SOURCE_COMMAND)
{
$$oConfigHash{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_SUMMARY} = $$oCommandOption{&CONFIG_HELP_SUMMARY};
my $oOption = $$oConfigHash{&CONFIG_HELP_OPTION}{$strOption};
if (defined($strSection))
{
$$oOption{&CONFIG_HELP_SECTION} = $strSection;
}
$$oOption{&CONFIG_HELP_NAME} = $oOptionDoc->paramGet('name');
$oOption->{&CONFIG_HELP_NAME_ALT} = $oCommandOption->{&CONFIG_HELP_NAME_ALT};
$$oOption{&CONFIG_HELP_DESCRIPTION} = $$oCommandOption{&CONFIG_HELP_DESCRIPTION};
$$oOption{&CONFIG_HELP_EXAMPLE} = $oOptionDoc->fieldGet('example');
}
}
}
# Store the config hash
$self->{oConfigHash} = $oConfigHash;
# Return from function and log return values if any
logDebugReturn($strOperation);
}
####################################################################################################################################
# manGet
#
# Generate the man page.
####################################################################################################################################
sub manGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest
) =
logDebugParam
(
__PACKAGE__ . '->manGet', \@_,
{name => 'oManifest'}
);
# Get index.xml to pull various text from
my $oIndexDoc = ${$oManifest->sourceGet('index')}{doc};
# Write the header
my $strManPage =
"NAME\n" .
' ' . PROJECT_NAME . ' - ' . $oManifest->variableReplace($oIndexDoc->paramGet('subtitle')) . "\n\n" .
"SYNOPSIS\n" .
' ' . PROJECT_EXE . ' [options] [command]';
# Output the description (first two paragraphs of index.xml introduction)
my $iParaTotal = 0;
$strManPage .= "\n\n" .
"DESCRIPTION";
foreach my $oPara ($oIndexDoc->nodeGetById('section', 'introduction')->nodeList('p'))
{
$strManPage .= ($iParaTotal == 0 ? "\n" : "\n\n") . ' ' .
manGetFormatText($oManifest->variableReplace($self->{oDocRender}->processText($oPara->textGet())), 80, 2);
last;
}
# Build command and config hashes
my $hConfigDefine = cfgDefine();
my $hConfig = $self->{oConfigHash};
my $hCommandList = {};
my $iCommandMaxLen = 0;
my $hOptionList = {};
my $iOptionMaxLen = 0;
foreach my $strCommand (sort(keys(%{$$hConfig{&CONFIG_HELP_COMMAND}})))
{
my $hCommand = $$hConfig{&CONFIG_HELP_COMMAND}{$strCommand};
$iCommandMaxLen = length($strCommand) > $iCommandMaxLen ? length($strCommand) : $iCommandMaxLen;
$$hCommandList{$strCommand}{summary} = $$hCommand{&CONFIG_HELP_SUMMARY};
if (defined($$hCommand{&CONFIG_HELP_OPTION}))
{
foreach my $strOption (sort(keys(%{$$hCommand{&CONFIG_HELP_OPTION}})))
{
my $hOption = $$hCommand{&CONFIG_HELP_OPTION}{$strOption};
if ($$hOption{&CONFIG_HELP_SOURCE} eq CONFIG_HELP_SOURCE_COMMAND)
{
$iOptionMaxLen = length($strOption) > $iOptionMaxLen ? length($strOption) : $iOptionMaxLen;
$$hOptionList{$strCommand}{$strOption}{&CONFIG_HELP_SUMMARY} = $$hOption{&CONFIG_HELP_SUMMARY};
}
}
}
}
foreach my $strOption (sort(keys(%{$$hConfig{&CONFIG_HELP_OPTION}})))
{
my $hOption = $$hConfig{&CONFIG_HELP_OPTION}{$strOption};
$iOptionMaxLen = length($strOption) > $iOptionMaxLen ? length($strOption) : $iOptionMaxLen;
my $strSection = defined($$hOption{&CONFIG_HELP_SECTION}) ? $$hOption{&CONFIG_HELP_SECTION} : CFGDEF_GENERAL;
$$hOptionList{$strSection}{$strOption}{&CONFIG_HELP_SUMMARY} = $$hOption{&CONFIG_HELP_SUMMARY};
}
# Output Commands
$strManPage .= "\n\n" .
'COMMANDS';
foreach my $strCommand (sort(keys(%{$hCommandList})))
{
# Construct the summary
my $strSummary = $oManifest->variableReplace($self->{oDocRender}->processText($$hCommandList{$strCommand}{summary}));
# $strSummary = lcfirst(substr($strSummary, 0, length($strSummary) - 1));
# Output the summary
$strManPage .=
"\n " . "${strCommand}" . (' ' x ($iCommandMaxLen - length($strCommand))) . ' ' .
manGetFormatText($strSummary, 80, $iCommandMaxLen + 4);
}
# Output options
my $bFirst = true;
$strManPage .= "\n\n" .
'OPTIONS';
foreach my $strSection (sort(keys(%{$hOptionList})))
{
$strManPage .= ($bFirst ?'' : "\n") . "\n " . ucfirst($strSection) . ' Options:';
foreach my $strOption (sort(keys(%{$$hOptionList{$strSection}})))
{
my $hOption = $$hOptionList{$strSection}{$strOption};
# Construct the default
my $strCommand = grep(/$strSection/i, cfgDefineCommandList()) ? $strSection : undef;
my $strDefault = docConfigOptionDefault($strOption, $strCommand);
if (defined($strDefault))
{
if ($strOption eq CFGOPT_REPO_HOST_CMD || $strOption eq CFGOPT_PG_HOST_CMD)
{
$strDefault = PROJECT_EXE;
}
elsif ($$hConfigDefine{$strOption}{&CFGDEF_TYPE} eq &CFGDEF_TYPE_BOOLEAN)
{
$strDefault = $strDefault ? 'y' : 'n';
}
}
#
# use Data::Dumper; confess Dumper($$hOption{&CONFIG_HELP_SUMMARY});
# Construct the summary
my $strSummary = $oManifest->variableReplace($self->{oDocRender}->processText($$hOption{&CONFIG_HELP_SUMMARY}));
$strSummary = $strSummary . (defined($strDefault) ? " [default=${strDefault}]" : '');
# Output the summary
$strManPage .=
"\n " . "--${strOption}" . (' ' x ($iOptionMaxLen - length($strOption))) . ' ' .
manGetFormatText($strSummary, 80, $iOptionMaxLen + 8);
}
$bFirst = false;
}
# Write files, examples, and references
$strManPage .= "\n\n" .
"FILES\n" .
"\n" .
' ' . docConfigOptionDefault(CFGOPT_CONFIG) . "\n" .
' ' . docConfigOptionDefault(CFGOPT_REPO_PATH) . "\n" .
' ' . docConfigOptionDefault(CFGOPT_LOG_PATH) . "\n" .
' ' . docConfigOptionDefault(CFGOPT_SPOOL_PATH) . "\n" .
' ' . docConfigOptionDefault(CFGOPT_LOCK_PATH) . "\n" .
"\n" .
"EXAMPLES\n" .
"\n" .
" * Create a backup of the PostgreSQL `main` cluster:\n" .
"\n" .
' $ ' . PROJECT_EXE . ' --' . CFGOPT_STANZA . "=main backup\n" .
"\n" .
' The `main` cluster should be configured in `' . docConfigOptionDefault(CFGOPT_CONFIG) . "`\n" .
"\n" .
" * Show all available backups:\n" .
"\n" .
' $ ' . PROJECT_EXE . ' ' . CFGCMD_INFO . "\n" .
"\n" .
" * Show all available backups for a specific cluster:\n" .
"\n" .
' $ ' . PROJECT_EXE . ' --' . CFGOPT_STANZA . '=main ' . CFGCMD_INFO . "\n" .
"\n" .
" * Show backup specific options:\n" .
"\n" .
' $ ' . PROJECT_EXE . ' ' . CFGCMD_HELP . ' ' . CFGCMD_BACKUP . "\n" .
"\n" .
"SEE ALSO\n" .
"\n" .
' /usr/share/doc/' . PROJECT_EXE . "-doc/html/index.html\n" .
' ' . $oManifest->variableReplace('{[backrest-url-base]}') . "\n";
return $strManPage;
}
# Helper function for manGet() used to format text by indenting and splitting
sub manGetFormatText
{
my $strLine = shift;
my $iLength = shift;
my $iIndentRest = shift;
my $strPart;
my $strResult;
my $bFirst = true;
do
{
my $iIndent = $bFirst ? 0 : $iIndentRest;
($strPart, $strLine) = stringSplit($strLine, ' ', $iLength - $iIndentRest);
$strResult .= ($bFirst ? '' : "\n") . (' ' x $iIndent) . trim($strPart);
$bFirst = false;
}
while (defined($strLine));
return $strResult;
}
####################################################################################################################################
# helpConfigDocGet
#
# Get the xml for configuration help.
####################################################################################################################################
sub helpConfigDocGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->helpConfigDocGet');
# Build a hash of the sections
my $oConfigHash = $self->{oConfigHash};
my $oConfigDoc = $self->{oDoc}->nodeGet('config');
my $oSectionHash = {};
foreach my $strOption (sort(keys(%{$$oConfigHash{&CONFIG_HELP_OPTION}})))
{
my $oOption = $$oConfigHash{&CONFIG_HELP_OPTION}{$strOption};
if (defined($$oOption{&CONFIG_HELP_SECTION}))
{
$$oSectionHash{$$oOption{&CONFIG_HELP_SECTION}}{$strOption} = true;
}
}
my $oDoc = new BackRestDoc::Common::Doc();
$oDoc->paramSet('title', $oConfigDoc->paramGet('title'));
# set the description for use as a meta tag
$oDoc->fieldSet('description', $oConfigDoc->fieldGet('description'));
# Output the introduction
my $oIntroSectionDoc = $oDoc->nodeAdd('section', undef, {id => 'introduction'});
$oIntroSectionDoc->nodeAdd('title')->textSet('Introduction');
$oIntroSectionDoc->textSet($oConfigDoc->textGet());
foreach my $strSection (sort(keys(%{$oSectionHash})))
{
my $oSectionElement = $oDoc->nodeAdd('section', undef, {id => "section-${strSection}"});
my $oSectionDoc = $oConfigDoc->nodeGet('config-section-list')->nodeGetById('config-section', $strSection);
# Set the summary text for the section
$oSectionElement->textSet($oSectionDoc->textGet());
$oSectionElement->
nodeAdd('title')->textSet(
{name => 'text',
children=> [$oSectionDoc->paramGet('name') . ' Options (', {name => 'id', value => $strSection}, ')']});
foreach my $strOption (sort(keys(%{$$oSectionHash{$strSection}})))
{
$self->helpOptionGet(undef, $strOption, $oSectionElement, $$oConfigHash{&CONFIG_HELP_OPTION}{$strOption});
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc}
);
}
####################################################################################################################################
# helpCommandDocGet
#
# Get the xml for command help.
####################################################################################################################################
sub helpCommandDocGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->helpCommandDocGet');
# Working variables
my $oConfigHash = $self->{oConfigHash};
my $oOperationDoc = $self->{oDoc}->nodeGet('operation');
my $oOptionDefine = cfgDefine();
my $oDoc = new BackRestDoc::Common::Doc();
$oDoc->paramSet('title', $oOperationDoc->paramGet('title'));
# set the description for use as a meta tag
$oDoc->fieldSet('description', $oOperationDoc->fieldGet('description'));
# Output the introduction
my $oIntroSectionDoc = $oDoc->nodeAdd('section', undef, {id => 'introduction'});
$oIntroSectionDoc->nodeAdd('title')->textSet('Introduction');
$oIntroSectionDoc->textSet($oOperationDoc->textGet());
foreach my $strCommand (sort(keys(%{$$oConfigHash{&CONFIG_HELP_COMMAND}})))
{
my $oCommandHash = $$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand};
my $oSectionElement = $oDoc->nodeAdd('section', undef, {id => "command-${strCommand}"});
my $oCommandDoc = $oOperationDoc->nodeGet('command-list')->nodeGetById('command', $strCommand);
$oSectionElement->
nodeAdd('title')->textSet(
{name => 'text',
children=> [$oCommandDoc->paramGet('name') . ' Command (', {name => 'id', value => $strCommand}, ')']});
$oSectionElement->textSet($$oCommandHash{&CONFIG_HELP_DESCRIPTION});
# use Data::doc;
# confess Dumper($oDoc->{oDoc});
if (defined($$oCommandHash{&CONFIG_HELP_OPTION}))
{
my $oCategory = {};
foreach my $strOption (sort(keys(%{$$oCommandHash{&CONFIG_HELP_OPTION}})))
{
# Skip secure options that can't be defined on the command line
next if ($rhConfigDefine->{$strOption}{&CFGDEF_SECURE});
my ($oOption, $strCategory) = helpCommandDocGetOptionFind($oConfigHash, $oOptionDefine, $strCommand, $strOption);
$$oCategory{$strCategory}{$strOption} = $oOption;
}
# Iterate sections
foreach my $strCategory (sort(keys(%{$oCategory})))
{
my $oOptionListElement = $oSectionElement->nodeAdd(
'section', undef, {id => "category-${strCategory}", toc => 'n'});
$oOptionListElement->
nodeAdd('title')->textSet(ucfirst($strCategory) . ' Options');
# Iterate options
foreach my $strOption (sort(keys(%{$$oCategory{$strCategory}})))
{
$self->helpOptionGet($strCommand, $strOption, $oOptionListElement,
$$oCommandHash{&CONFIG_HELP_OPTION}{$strOption});
}
}
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc}
);
}
# Helper function for helpCommandDocGet() to find options. The option may be stored with the command or in the option list depending
# on whether it's generic or command-specific
sub helpCommandDocGetOptionFind
{
my $oConfigHelpData = shift;
my $oOptionDefine = shift;
my $strCommand = shift;
my $strOption = shift;
my $strSection = CONFIG_HELP_COMMAND;
my $oOption = $$oConfigHelpData{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_OPTION}{$strOption};
if ($$oOption{&CONFIG_HELP_SOURCE} eq CONFIG_HELP_SOURCE_DEFAULT)
{
$strSection = CFGDEF_GENERAL;
}
elsif ($$oOption{&CONFIG_HELP_SOURCE} eq CONFIG_HELP_SOURCE_SECTION)
{
$oOption = $$oConfigHelpData{&CONFIG_HELP_OPTION}{$strOption};
if (defined($$oOption{&CONFIG_HELP_SECTION}) && $strSection ne $strCommand)
{
$strSection = $$oOption{&CONFIG_HELP_SECTION};
}
if (($strSection ne CFGDEF_GENERAL && $strSection ne CFGDEF_LOG &&
$strSection ne CFGDEF_REPOSITORY && $strSection ne CFGDEF_SECTION_STANZA) ||
$strSection eq $strCommand)
{
$strSection = CONFIG_HELP_COMMAND;
}
}
return $oOption, $strSection;
}
####################################################################################################################################
# helpOptionGet
#
# Get the xml for an option.
####################################################################################################################################
sub helpOptionGet
{
my $self = shift;
my $strCommand = shift;
my $strOption = shift;
my $oParentElement = shift;
my $oOptionHash = shift;
# Create the option section
my $oOptionElement = $oParentElement->nodeAdd(
'section', undef, {id => "option-${strOption}", toc => defined($strCommand) ? 'n' : 'y'});
# Set the option section title
$oOptionElement->
nodeAdd('title')->textSet(
{name => 'text',
children=> [$$oOptionHash{&CONFIG_HELP_NAME} . ' Option (', {name => 'id', value => "--${strOption}"}, ')']});
# Add the option summary and description
$oOptionElement->
nodeAdd('p')->textSet($$oOptionHash{&CONFIG_HELP_SUMMARY});
$oOptionElement->
nodeAdd('p')->textSet($$oOptionHash{&CONFIG_HELP_DESCRIPTION});
# Get the default value (or required=n if there is no default)
my $strCodeBlock;
if (defined(docConfigOptionDefault($strOption, $strCommand)))
{
my $strDefault;
if ($strOption eq CFGOPT_REPO_HOST_CMD || $strOption eq CFGOPT_PG_HOST_CMD)
{
$strDefault = '[INSTALL-PATH]/' . PROJECT_EXE;
}
else
{
if (docConfigOptionTypeTest($strOption, CFGDEF_TYPE_BOOLEAN))
{
$strDefault = docConfigOptionDefault($strOption, $strCommand) ? 'y' : 'n';
}
else
{
$strDefault = docConfigOptionDefault($strOption, $strCommand);
}
}
$strCodeBlock = "default: ${strDefault}";
}
# This won't work correctly until there is some notion of dependency
# elsif (optionRequired($strOption, $strCommand))
# {
# $strCodeBlock = 'required: y';
# }
# Get the allowed range if it exists
my ($strRangeMin, $strRangeMax) = docConfigOptionRange($strOption, $strCommand);
if (defined($strRangeMin))
{
$strCodeBlock .= (defined($strCodeBlock) ? "\n" : '') . "allowed: ${strRangeMin}-${strRangeMax}";
}
# Get the example
my $strExample;
my $strOptionPrefix = $rhConfigDefine->{$strOption}{&CFGDEF_PREFIX};
my $strOptionIndex = defined($strOptionPrefix) ?
"${strOptionPrefix}1-" . substr($strOption, length($strOptionPrefix) + 1) : $strOption;
if (defined($strCommand))
{
if (docConfigOptionTypeTest($strOption, CFGDEF_TYPE_BOOLEAN))
{
if ($$oOptionHash{&CONFIG_HELP_EXAMPLE} ne 'n' && $$oOptionHash{&CONFIG_HELP_EXAMPLE} ne 'y')
{
confess &log(ERROR, "option ${strOption} example should be boolean but value is: " .
$$oOptionHash{&CONFIG_HELP_EXAMPLE});
}
$strExample = '--' . ($$oOptionHash{&CONFIG_HELP_EXAMPLE} eq 'n' ? 'no-' : '') . $strOptionIndex;
}
else
{
$strExample = "--${strOptionIndex}=" . $$oOptionHash{&CONFIG_HELP_EXAMPLE};
}
}
else
{
$strExample = "${strOptionIndex}=" . $$oOptionHash{&CONFIG_HELP_EXAMPLE};
}
$strCodeBlock .= (defined($strCodeBlock) ? "\n" : '') . "example: ${strExample}";
$oOptionElement->
nodeAdd('code-block')->valueSet($strCodeBlock);
# Output deprecated names
if (defined($oOptionHash->{&CONFIG_HELP_NAME_ALT}))
{
my $strCaption = 'Deprecated Name' . (@{$oOptionHash->{&CONFIG_HELP_NAME_ALT}} > 1 ? 's' : '');
$oOptionElement->
nodeAdd('p')->textSet("${strCaption}: " . join(', ', @{$oOptionHash->{&CONFIG_HELP_NAME_ALT}}));
}
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/DocExecute.pm 0000664 0000000 0000000 00000120133 13625315071 0024464 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC EXECUTE MODULE
####################################################################################################################################
package BackRestDoc::Common::DocExecute;
use parent 'BackRestDoc::Common::DocRender';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use Storable qw(dclone);
use pgBackRest::Common::Exception;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestBuild::Config::Data;
use BackRestDoc::Common::DocManifest;
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestTest::Common::HostTest;
use pgBackRestTest::Common::HostGroupTest;
####################################################################################################################################
# User that's building the docs
####################################################################################################################################
use constant DOC_USER => getpwuid($UID) eq 'root' ? 'ubuntu' : getpwuid($UID) . '';
####################################################################################################################################
# Generate indexed defines
####################################################################################################################################
my $rhConfigDefineIndex = cfgDefine();
foreach my $strKey (sort(keys(%{$rhConfigDefineIndex})))
{
# Build options for all possible db configurations
if (defined($rhConfigDefineIndex->{$strKey}{&CFGDEF_PREFIX}) &&
$rhConfigDefineIndex->{$strKey}{&CFGDEF_PREFIX} eq CFGDEF_PREFIX_PG)
{
my $strPrefix = $rhConfigDefineIndex->{$strKey}{&CFGDEF_PREFIX};
for (my $iIndex = 1; $iIndex <= CFGDEF_INDEX_PG; $iIndex++)
{
my $strKeyNew = "${strPrefix}${iIndex}" . substr($strKey, length($strPrefix));
$rhConfigDefineIndex->{$strKeyNew} = dclone($rhConfigDefineIndex->{$strKey});
$rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_INDEX_TOTAL} = CFGDEF_INDEX_PG;
$rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_INDEX} = $iIndex - 1;
# Options indexed > 1 are never required
if ($iIndex != 1)
{
$rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_REQUIRED} = false;
}
if (defined($rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_DEPEND}) &&
defined($rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_DEPEND}{&CFGDEF_DEPEND_OPTION}))
{
$rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_DEPEND}{&CFGDEF_DEPEND_OPTION} =
"${strPrefix}${iIndex}" .
substr(
$rhConfigDefineIndex->{$strKeyNew}{&CFGDEF_DEPEND}{&CFGDEF_DEPEND_OPTION},
length($strPrefix));
}
}
delete($rhConfigDefineIndex->{$strKey});
}
else
{
$rhConfigDefineIndex->{$strKey}{&CFGDEF_INDEX} = 0;
}
}
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strType'},
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new($strType, $oManifest, $bExe, $strRenderOutKey);
bless $self, $class;
if (defined($self->{oSource}{hyCache}))
{
$self->{bCache} = true;
$self->{iCacheIdx} = 0;
}
else
{
$self->{bCache} = false;
}
$self->{bExe} = $bExe;
$self->{iCmdLineLen} = $self->{oDoc}->paramGet('cmd-line-len', false, 80);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# executeKey
#
# Get a unique key for the execution step to determine if the cache is valid.
####################################################################################################################################
sub executeKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strHostName,
$oCommand,
) =
logDebugParam
(
__PACKAGE__ . '->executeKey', \@_,
{name => 'strHostName', trace => true},
{name => 'oCommand', trace => true},
);
# Add user to command
my $bUserForce = $oCommand->paramTest('user-force', 'y') ? true : false;
my $strCommand = $self->{oManifest}->variableReplace(trim($oCommand->fieldGet('exe-cmd')));
my $strUser = $self->{oManifest}->variableReplace($oCommand->paramGet('user', false, DOC_USER));
$strCommand = ($strUser eq DOC_USER || $bUserForce ? '' : ('sudo ' . ($strUser eq 'root' ? '' : "-u $strUser "))) . $strCommand;
# Format and split command
$strCommand =~ s/[ ]*\n[ ]*/ \\\n /smg;
$strCommand =~ s/ \\\@ \\//smg;
my @stryCommand = split("\n", $strCommand);
my $hCacheKey =
{
host => $strHostName,
cmd => \@stryCommand,
output => JSON::PP::false,
};
$$hCacheKey{'run-as-user'} = $bUserForce ? $strUser : undef;
if (defined($oCommand->fieldGet('exe-cmd-extra', false)))
{
$$hCacheKey{'cmd-extra'} = $oCommand->fieldGet('exe-cmd-extra');
}
if (defined($oCommand->paramGet('err-expect', false)))
{
$$hCacheKey{'err-expect'} = $oCommand->paramGet('err-expect');
}
if ($oCommand->paramTest('output', 'y') || $oCommand->paramTest('show', 'y') || $oCommand->paramTest('variable-key'))
{
$$hCacheKey{'output'} = JSON::PP::true;
}
$$hCacheKey{'load-env'} = $oCommand->paramTest('load-env', 'n') ? JSON::PP::false : JSON::PP::true;
$$hCacheKey{'bash-wrap'} = $oCommand->paramTest('bash-wrap', 'n') ? JSON::PP::false : JSON::PP::true;
if (defined($oCommand->fieldGet('exe-highlight', false)))
{
$$hCacheKey{'output'} = JSON::PP::true;
$$hCacheKey{highlight}{'filter'} = $oCommand->paramTest('filter', 'n') ? JSON::PP::false : JSON::PP::true;
$$hCacheKey{highlight}{'filter-context'} = $oCommand->paramGet('filter-context', false, 2);
my @stryHighlight;
$stryHighlight[0] = $self->{oManifest}->variableReplace($oCommand->fieldGet('exe-highlight'));
$$hCacheKey{highlight}{list} = \@stryHighlight;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hExecuteKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# execute
####################################################################################################################################
sub execute
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$strHostName,
$oCommand,
$iIndent,
$bCache,
$bShow,
) =
logDebugParam
(
__PACKAGE__ . '->execute', \@_,
{name => 'oSection'},
{name => 'strHostName'},
{name => 'oCommand'},
{name => 'iIndent', optional => true, default => 1},
{name => 'bCache', optional => true, default => true},
{name => 'bShow', optional => true, default => true},
);
# Working variables
my $hCacheKey = $self->executeKey($strHostName, $oCommand);
my $strCommand = join("\n", @{$$hCacheKey{cmd}});
my $strOutput;
if ($bShow && $self->{bExe} && $self->isRequired($oSection))
{
# Make sure that no lines are greater than 80 chars
foreach my $strLine (split("\n", $strCommand))
{
if (length(trim($strLine)) > $self->{iCmdLineLen})
{
confess &log(ERROR,
"command has a line > $self->{iCmdLineLen} characters:\n${strCommand}\noffending line: ${strLine}");
}
}
}
&log(DEBUG, (' ' x $iIndent) . "execute: $strCommand");
if ($self->{oManifest}->variableReplace($oCommand->paramGet('skip', false, 'n')) ne 'y')
{
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('exe', $hCacheKey);
if ($bCacheHit)
{
$strOutput = defined($$hCacheValue{output}) ? join("\n", @{$$hCacheValue{output}}) : undef;
}
else
{
# Check that the host is valid
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot execute on host ${strHostName} because the host does not exist");
}
my $oExec = $oHost->execute(
$strCommand . (defined($$hCacheKey{'cmd-extra'}) ? ' ' . $$hCacheKey{'cmd-extra'} : ''),
{iExpectedExitStatus => $$hCacheKey{'err-expect'},
bSuppressError => $oCommand->paramTest('err-suppress', 'y'),
iRetrySeconds => $oCommand->paramGet('retry', false)}, $hCacheKey->{'run-as-user'},
{bLoadEnv => $hCacheKey->{'load-env'}, bBashWrap => $hCacheKey->{'bash-wrap'}});
$oExec->begin();
$oExec->end();
if (defined($oExec->{strOutLog}) && $oExec->{strOutLog} ne '')
{
$strOutput = $oExec->{strOutLog};
# Trim off extra linefeeds before and after
$strOutput =~ s/^\n+|\n$//g;
}
if (defined($$hCacheKey{'err-expect'}) && defined($oExec->{strErrorLog}) && $oExec->{strErrorLog} ne '')
{
$strOutput .= $oExec->{strErrorLog};
}
if ($$hCacheKey{output} && defined($$hCacheKey{highlight}) && $$hCacheKey{highlight}{filter} && defined($strOutput))
{
my $strHighLight = @{$$hCacheKey{highlight}{list}}[0];
if (!defined($strHighLight))
{
confess &log(ERROR, 'filter requires highlight definition: ' . $strCommand);
}
my $iFilterContext = $$hCacheKey{highlight}{'filter-context'};
my @stryOutput = split("\n", $strOutput);
undef($strOutput);
# my $iFiltered = 0;
my $iLastOutput = -1;
for (my $iIndex = 0; $iIndex < @stryOutput; $iIndex++)
{
if ($stryOutput[$iIndex] =~ /$strHighLight/)
{
# Determine the first line to output
my $iFilterFirst = $iIndex - $iFilterContext;
# Don't go past the beginning
$iFilterFirst = $iFilterFirst < 0 ? 0 : $iFilterFirst;
# Don't repeat lines that have already been output
$iFilterFirst = $iFilterFirst <= $iLastOutput ? $iLastOutput + 1 : $iFilterFirst;
# Determine the last line to output
my $iFilterLast = $iIndex + $iFilterContext;
# Don't got past the end
$iFilterLast = $iFilterLast >= @stryOutput ? @stryOutput -1 : $iFilterLast;
# Mark filtered lines if any
if ($iFilterFirst > $iLastOutput + 1)
{
my $iFiltered = $iFilterFirst - ($iLastOutput + 1);
if ($iFiltered > 1)
{
$strOutput .= (defined($strOutput) ? "\n" : '') .
" [filtered ${iFiltered} lines of output]";
}
else
{
$iFilterFirst -= 1;
}
}
# Output the lines
for (my $iOutputIndex = $iFilterFirst; $iOutputIndex <= $iFilterLast; $iOutputIndex++)
{
$strOutput .= (defined($strOutput) ? "\n" : '') . $stryOutput[$iOutputIndex];
}
$iLastOutput = $iFilterLast;
}
}
if (@stryOutput - 1 > $iLastOutput + 1)
{
my $iFiltered = (@stryOutput - 1) - ($iLastOutput + 1);
if ($iFiltered > 1)
{
$strOutput .= (defined($strOutput) ? "\n" : '') .
" [filtered ${iFiltered} lines of output]";
}
else
{
$strOutput .= (defined($strOutput) ? "\n" : '') . $stryOutput[-1];
}
}
}
if (!$$hCacheKey{output})
{
$strOutput = undef;
}
if (defined($strOutput))
{
my @stryOutput = split("\n", $strOutput);
$$hCacheValue{output} = \@stryOutput;
}
if ($bCache)
{
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
# Output is assigned to a var
if ($oCommand->paramTest('variable-key'))
{
$self->{oManifest}->variableSet($oCommand->paramGet('variable-key'), trim($strOutput), true);
}
}
elsif ($$hCacheKey{output})
{
$strOutput = 'Output suppressed for testing';
}
}
# Default variable output when it was not set by execution
if ($oCommand->paramTest('variable-key') && !defined($self->{oManifest}->variableGet($oCommand->paramGet('variable-key'))))
{
$self->{oManifest}->variableSet($oCommand->paramGet('variable-key'), '[Test Variable]', true);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strCommand', value => $strCommand, trace => true},
{name => 'strOutput', value => $strOutput, trace => true}
);
}
####################################################################################################################################
# configKey
####################################################################################################################################
sub configKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oConfig,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'oConfig', trace => true},
);
my $hCacheKey =
{
host => $self->{oManifest}->variableReplace($oConfig->paramGet('host')),
file => $self->{oManifest}->variableReplace($oConfig->paramGet('file')),
};
if ($oConfig->paramTest('reset', 'y'))
{
$$hCacheKey{reset} = JSON::PP::true;
}
# Add all options to the key
my $strOptionTag = $oConfig->nameGet() eq 'backrest-config' ? 'backrest-config-option' : 'postgres-config-option';
foreach my $oOption ($oConfig->nodeList($strOptionTag))
{
my $hOption = {};
if ($oOption->paramTest('remove', 'y'))
{
$$hOption{remove} = JSON::PP::true;
}
if (defined($oOption->valueGet(false)))
{
$$hOption{value} = $self->{oManifest}->variableReplace($oOption->valueGet());
}
my $strKey = $self->{oManifest}->variableReplace($oOption->paramGet('key'));
if ($oConfig->nameGet() eq 'backrest-config')
{
my $strSection = $self->{oManifest}->variableReplace($oOption->paramGet('section'));
$$hCacheKey{option}{$strSection}{$strKey} = $hOption;
}
else
{
$$hCacheKey{option}{$strKey} = $hOption;
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hCacheKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# backrestConfig
####################################################################################################################################
sub backrestConfig
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->backrestConfig', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $hCacheKey = $self->configKey($oConfig);
my $strFile = $$hCacheKey{file};
my $strConfig = undef;
&log(DEBUG, (' ' x $iDepth) . 'process backrest config: ' . $$hCacheKey{file});
if ($self->{bExe} && $self->isRequired($oSection))
{
# Load module dynamically
require pgBackRest::Common::Ini;
pgBackRest::Common::Ini->import();
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('cfg-' . PROJECT_EXE, $hCacheKey);
if ($bCacheHit)
{
$strConfig = defined($$hCacheValue{config}) ? join("\n", @{$$hCacheValue{config}}) : undef;
}
else
{
# Check that the host is valid
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot configure backrest on host ${strHostName} because the host does not exist");
}
# Reset all options
if ($oConfig->paramTest('reset', 'y'))
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}})
}
foreach my $oOption ($oConfig->nodeList('backrest-config-option'))
{
my $strSection = $self->{oManifest}->variableReplace($oOption->paramGet('section'));
my $strKey = $self->{oManifest}->variableReplace($oOption->paramGet('key'));
my $strValue;
if (!$oOption->paramTest('remove', 'y'))
{
$strValue = $self->{oManifest}->variableReplace(trim($oOption->valueGet(false)));
}
if (!defined($strValue))
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey});
if (keys(%{${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}}) == 0)
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection});
}
&log(DEBUG, (' ' x ($iDepth + 1)) . "reset ${strSection}->${strKey}");
}
else
{
# Make sure the specified option exists
# ??? This is too simplistic to handle new indexed options. The check below works for now but it would be good
# ??? to bring back more sophisticated checking in the future.
# if (!defined($rhConfigDefineIndex->{$strKey}))
# {
# confess &log(ERROR, "option ${strKey} does not exist");
# }
# If this option is a hash and the value is already set then append to the array
if (defined($rhConfigDefineIndex->{$strKey}) &&
$rhConfigDefineIndex->{$strKey}{&CFGDEF_TYPE} eq CFGDEF_TYPE_HASH &&
defined(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey}))
{
my @oValue = ();
my $strHashValue = ${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey};
# If there is only one key/value
if (ref(\$strHashValue) eq 'SCALAR')
{
push(@oValue, $strHashValue);
}
# Else if there is an array of values
else
{
@oValue = @{$strHashValue};
}
push(@oValue, $strValue);
${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey} = \@oValue;
}
# else just set the value
else
{
${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey} = $strValue;
}
&log(DEBUG, (' ' x ($iDepth + 1)) . "set ${strSection}->${strKey} = ${strValue}");
}
}
my $strLocalFile = '/home/' . DOC_USER . '/data/pgbackrest.conf';
# Save the ini file
$self->{oManifest}->storage()->put($strLocalFile, iniRender($self->{config}{$strHostName}{$$hCacheKey{file}}, true));
$oHost->copyTo(
$strLocalFile, $$hCacheKey{file},
$self->{oManifest}->variableReplace($oConfig->paramGet('owner', false, 'postgres:postgres')), '640');
# Remove the log-console-stderr option before pushing into the cache
# ??? This is not very pretty and should be replaced with a general way to hide config options
my $oConfigClean = dclone($self->{config}{$strHostName}{$$hCacheKey{file}});
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL}{&CFGOPT_LOG_LEVEL_STDERR});
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL}{&CFGOPT_LOG_TIMESTAMP});
if (keys(%{$$oConfigClean{&CFGDEF_SECTION_GLOBAL}}) == 0)
{
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL});
}
$self->{oManifest}->storage()->put("${strLocalFile}.clean", iniRender($oConfigClean, true));
# Push config file into the cache
$strConfig = ${$self->{oManifest}->storage()->get("${strLocalFile}.clean")};
my @stryConfig = undef;
if (trim($strConfig) ne '')
{
@stryConfig = split("\n", $strConfig);
}
$$hCacheValue{config} = \@stryConfig;
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
else
{
$strConfig = 'Config suppressed for testing';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strFile', value => $strFile, trace => true},
{name => 'strConfig', value => $strConfig, trace => true},
{name => 'bShow', value => $oConfig->paramTest('show', 'n') ? false : true, trace => true}
);
}
####################################################################################################################################
# postgresConfig
####################################################################################################################################
sub postgresConfig
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->postgresConfig', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $hCacheKey = $self->configKey($oConfig);
my $strFile = $$hCacheKey{file};
my $strConfig;
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('cfg-postgresql', $hCacheKey);
if ($bCacheHit)
{
$strConfig = defined($$hCacheValue{config}) ? join("\n", @{$$hCacheValue{config}}) : undef;
}
else
{
# Check that the host is valid
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot configure postgres on host ${strHostName} because the host does not exist");
}
my $strLocalFile = '/home/' . DOC_USER . '/data/postgresql.conf';
$oHost->copyFrom($$hCacheKey{file}, $strLocalFile);
if (!defined(${$self->{'pg-config'}}{$strHostName}{$$hCacheKey{file}}{base}) && $self->{bExe})
{
${$self->{'pg-config'}}{$strHostName}{$$hCacheKey{file}}{base} =
${$self->{oManifest}->storage()->get($strLocalFile)};
}
my $oConfigHash = $self->{'pg-config'}{$strHostName}{$$hCacheKey{file}};
my $oConfigHashNew;
if (!defined($$oConfigHash{old}))
{
$oConfigHashNew = {};
$$oConfigHash{old} = {}
}
else
{
$oConfigHashNew = dclone($$oConfigHash{old});
}
&log(DEBUG, (' ' x $iDepth) . 'process postgres config: ' . $$hCacheKey{file});
foreach my $oOption ($oConfig->nodeList('postgres-config-option'))
{
my $strKey = $oOption->paramGet('key');
my $strValue = $self->{oManifest}->variableReplace(trim($oOption->valueGet()));
if ($strValue eq '')
{
delete($$oConfigHashNew{$strKey});
&log(DEBUG, (' ' x ($iDepth + 1)) . "reset ${strKey}");
}
else
{
$$oConfigHashNew{$strKey} = $strValue;
&log(DEBUG, (' ' x ($iDepth + 1)) . "set ${strKey} = ${strValue}");
}
}
# Generate config text
foreach my $strKey (sort(keys(%$oConfigHashNew)))
{
if (defined($strConfig))
{
$strConfig .= "\n";
}
$strConfig .= "${strKey} = $$oConfigHashNew{$strKey}";
}
# Save the conf file
if ($self->{bExe})
{
$self->{oManifest}->storage()->put($strLocalFile, $$oConfigHash{base} .
(defined($strConfig) ? "\n# pgBackRest Configuration\n${strConfig}\n" : ''));
$oHost->copyTo($strLocalFile, $$hCacheKey{file}, 'postgres:postgres', '640');
}
$$oConfigHash{old} = $oConfigHashNew;
my @stryConfig = undef;
if (trim($strConfig) ne '')
{
@stryConfig = split("\n", $strConfig);
}
$$hCacheValue{config} = \@stryConfig;
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
else
{
$strConfig = 'Config suppressed for testing';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strFile', value => $strFile, trace => true},
{name => 'strConfig', value => $strConfig, trace => true},
{name => 'bShow', value => $oConfig->paramTest('show', 'n') ? false : true, trace => true}
);
}
####################################################################################################################################
# hostKey
####################################################################################################################################
sub hostKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oHost,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'oHost', trace => true},
);
my $hCacheKey =
{
name => $self->{oManifest}->variableReplace($oHost->paramGet('name')),
image => $self->{oManifest}->variableReplace($oHost->paramGet('image')),
};
if (defined($oHost->paramGet('id', false)))
{
$hCacheKey->{id} = $self->{oManifest}->variableReplace($oHost->paramGet('id'));
}
else
{
$hCacheKey->{id} = $hCacheKey->{name};
}
if (defined($oHost->paramGet('option', false)))
{
$$hCacheKey{option} = $self->{oManifest}->variableReplace($oHost->paramGet('option'));
}
if (defined($oHost->paramGet('param', false)))
{
$$hCacheKey{param} = $self->{oManifest}->variableReplace($oHost->paramGet('param'));
}
if (defined($oHost->paramGet('os', false)))
{
$$hCacheKey{os} = $self->{oManifest}->variableReplace($oHost->paramGet('os'));
}
$$hCacheKey{'update-hosts'} = $oHost->paramTest('update-hosts', 'n') ? JSON::PP::false : JSON::PP::true;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hCacheKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# cachePop
####################################################################################################################################
sub cachePop
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strCacheType,
$hCacheKey,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'strCacheType', trace => true},
{name => 'hCacheKey', trace => true},
);
my $bCacheHit = false;
my $oCacheValue = undef;
if ($self->{bCache})
{
my $oJSON = JSON::PP->new()->canonical()->allow_nonref();
# &log(WARN, "checking cache for\ncurrent key: " . $oJSON->encode($hCacheKey));
my $hCache = ${$self->{oSource}{hyCache}}[$self->{iCacheIdx}];
if (!defined($hCache))
{
confess &log(ERROR, 'unable to get index from cache', ERROR_FILE_INVALID);
}
if (!defined($$hCache{key}))
{
confess &log(ERROR, 'unable to get key from cache', ERROR_FILE_INVALID);
}
if (!defined($$hCache{type}))
{
confess &log(ERROR, 'unable to get type from cache', ERROR_FILE_INVALID);
}
if ($$hCache{type} ne $strCacheType)
{
confess &log(ERROR, 'types do not match, cache is invalid', ERROR_FILE_INVALID);
}
if ($oJSON->encode($$hCache{key}) ne $oJSON->encode($hCacheKey))
{
confess &log(ERROR,
"keys at index $self->{iCacheIdx} do not match, cache is invalid." .
"\n cache key: " . $oJSON->encode($$hCache{key}) .
"\ncurrent key: " . $oJSON->encode($hCacheKey), ERROR_FILE_INVALID);
}
$bCacheHit = true;
$oCacheValue = $$hCache{value};
$self->{iCacheIdx}++;
}
else
{
if ($self->{oManifest}{bCacheOnly})
{
confess &log(ERROR, 'Cache only operation forced by --cache-only option');
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'bCacheHit', value => $bCacheHit, trace => true},
{name => 'strCacheType', value => $strCacheType, trace => true},
{name => 'hCacheKey', value => $hCacheKey, trace => true},
{name => 'oCacheValue', value => $oCacheValue, trace => true},
);
}
####################################################################################################################################
# cachePush
####################################################################################################################################
sub cachePush
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$hCacheKey,
$oCacheValue,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'strType', trace => true},
{name => 'hCacheKey', trace => true},
{name => 'oCacheValue', required => false, trace => true},
);
if ($self->{bCache})
{
confess &log(ASSERT, "cachePush should not be called when cache is already present");
}
# Create the cache entry
my $hCache =
{
key => $hCacheKey,
type => $strType,
};
if (defined($oCacheValue))
{
$$hCache{value} = $oCacheValue;
}
push @{$self->{oSource}{hyCache}}, $hCache;
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# sectionChildProcesss
####################################################################################################################################
sub sectionChildProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oChild,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionChildProcess', \@_,
{name => 'oSection'},
{name => 'oChild'},
{name => 'iDepth'}
);
&log(DEBUG, (' ' x ($iDepth + 1)) . 'process child: ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'host-add')
{
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('host', $self->hostKey($oChild));
if ($bCacheHit)
{
$self->{oManifest}->variableSet('host-' . $hCacheKey->{id} . '-ip', $hCacheValue->{ip}, true);
}
else
{
if (defined($self->{host}{$$hCacheKey{name}}))
{
confess &log(ERROR, 'cannot add host ${strName} because the host already exists');
}
executeTest("rm -rf ~/data/$$hCacheKey{name}");
executeTest("mkdir -p ~/data/$$hCacheKey{name}/etc");
my $strHost = $hCacheKey->{name};
my $strImage = $hCacheKey->{image};
my $strHostUser = $self->{oManifest}->variableReplace($oChild->paramGet('user'));
# Determine if a pre-built image should be created
if (defined($self->preExecute($strHost)))
{
my $strPreImage = "${strImage}-${strHost}";
my $strFrom = $strImage;
&log(INFO, "Build vm '${strPreImage}' from '${strFrom}'");
my $strCommandList;
# Add all pre commands
foreach my $oExecute ($self->preExecute($strHost))
{
my $hExecuteKey = $self->executeKey($strHost, $oExecute);
my $strCommand =
join("\n", @{$hExecuteKey->{cmd}}) .
(defined($hExecuteKey->{'cmd-extra'}) ? ' ' . $hExecuteKey->{'cmd-extra'} : '');
$strCommand =~ s/'/'\\''/g;
$strCommand =
"sudo -u ${strHostUser}" .
($hCacheKey->{'bash-wrap'} ?
" bash" . ($hCacheKey->{'load-env'} ? ' -l' : '') . " -c '${strCommand}'" : " ${strCommand}");
if (defined($strCommandList))
{
$strCommandList .= "\n";
}
$strCommandList .= "RUN ${strCommand}";
&log(DETAIL, " Pre command $strCommand");
}
# Build container
my $strDockerfile = $self->{oManifest}{strDocPath} . "/output/doc-host.dockerfile";
$self->{oManifest}{oStorage}->put(
$strDockerfile,
"FROM ${strFrom}\n\n" . trim($self->{oManifest}->variableReplace($strCommandList)) . "\n");
executeTest("docker build -f ${strDockerfile} -t ${strPreImage} " . $self->{oManifest}{oStorage}->pathGet());
# Use the pre-built image
$strImage = $strPreImage;
}
my $strHostRepoPath = dirname(dirname(abs_path($0)));
# Replace host repo path in mounts with if present
my $strMount = undef;
if (defined($oChild->paramGet('mount', false)))
{
$strMount = $self->{oManifest}->variableReplace($oChild->paramGet('mount'));
$strMount =~ s/\{\[host\-repo\-path\]\}/${strHostRepoPath}/g;
}
# Replace host repo mount in params if present
my $strOption = $$hCacheKey{option};
if (defined($strOption))
{
$strOption =~ s/\{\[host\-repo\-path\]\}/${strHostRepoPath}/g;
}
my $oHost = new pgBackRestTest::Common::HostTest(
$$hCacheKey{name}, "doc-$$hCacheKey{name}", $strImage, $strHostUser, $$hCacheKey{os},
defined($strMount) ? [$strMount] : undef, $strOption, $$hCacheKey{param}, $$hCacheKey{'update-hosts'});
$self->{host}{$$hCacheKey{name}} = $oHost;
$self->{oManifest}->variableSet('host-' . $hCacheKey->{id} . '-ip', $oHost->{strIP}, true);
$$hCacheValue{ip} = $oHost->{strIP};
# Add to the host group
my $oHostGroup = hostGroupGet();
$oHostGroup->hostAdd($oHost);
# Execute initialize commands
foreach my $oExecute ($oChild->nodeList('execute', false))
{
$self->execute(
$oSection, $$hCacheKey{name}, $oExecute, {iIndent => $iDepth + 1, bCache => false, bShow => false});
}
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
}
# Skip children that have already been processed and error on others
elsif ($oChild->nameGet() ne 'title')
{
confess &log(ASSERT, 'unable to process child type ' . $oChild->nameGet());
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation
);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/DocManifest.pm 0000664 0000000 0000000 00000063150 13625315071 0024635 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MANIFEST MODULE
####################################################################################################################################
package BackRestDoc::Common::DocManifest;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use JSON::PP;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
####################################################################################################################################
# File constants
####################################################################################################################################
use constant FILE_MANIFEST => 'manifest.xml';
####################################################################################################################################
# Render constants
####################################################################################################################################
use constant RENDER => 'render';
use constant RENDER_COMPACT => 'compact';
push @EXPORT, qw(RENDER_COMPACT);
use constant RENDER_FILE => 'file';
use constant RENDER_MENU => 'menu';
push @EXPORT, qw(RENDER_MENU);
use constant RENDER_PRETTY => 'pretty';
push @EXPORT, qw(RENDER_PRETTY);
use constant RENDER_TYPE => 'type';
use constant RENDER_TYPE_HTML => 'html';
push @EXPORT, qw(RENDER_TYPE_HTML);
use constant RENDER_TYPE_MARKDOWN => 'markdown';
push @EXPORT, qw(RENDER_TYPE_MARKDOWN);
use constant RENDER_TYPE_PDF => 'pdf';
push @EXPORT, qw(RENDER_TYPE_PDF);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oStorage},
$self->{stryRequire},
$self->{stryInclude},
$self->{stryExclude},
$self->{rhKeyVariableOverride},
my $rhVariableOverride,
$self->{strDocPath},
$self->{bDeploy},
$self->{bCacheOnly},
$self->{bPre},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oStorage'},
{name => 'stryRequire'},
{name => 'stryInclude'},
{name => 'stryExclude'},
{name => 'rhKeyVariableOverride', required => false},
{name => 'rhVariableOverride', required => false},
{name => 'strDocPath', required => false},
{name => 'bDeploy', required => false},
{name => 'bCacheOnly', required => false},
{name => 'bPre', required => false, default => false},
);
# Set the bin path
$self->{strBinPath} = abs_path(dirname($0));
# Set the base path if it was not passed in
if (!defined($self->{strDocPath}))
{
$self->{strDocPath} = $self->{strBinPath};
}
# Set cache file names
$self->{strExeCacheLocal} = $self->{strDocPath} . "/output/exe.cache";
$self->{strExeCacheDeploy} = $self->{strDocPath} . "/resource/exe.cache";
# Load the manifest
$self->{oManifestXml} = new BackRestDoc::Common::Doc("$self->{strDocPath}/manifest.xml");
# Iterate the sources
$self->{oManifest} = {};
foreach my $oSource ($self->{oManifestXml}->nodeGet('source-list')->nodeList('source'))
{
my $oSourceHash = {};
my $strKey = $oSource->paramGet('key');
my $strSourceType = $oSource->paramGet('type', false);
logDebugMisc
(
$strOperation, 'load source',
{name => 'strKey', value => $strKey},
{name => 'strSourceType', value => $strSourceType}
);
# Skip sources in exclude list
if (grep(/^$strKey$/, @{$self->{stryExclude}}))
{
next;
}
$$oSourceHash{doc} = new BackRestDoc::Common::Doc("$self->{strDocPath}/xml/${strKey}.xml");
# Read variables from source
$self->variableListParse($$oSourceHash{doc}->nodeGet('variable-list', false), $rhVariableOverride);
${$self->{oManifest}}{source}{$strKey} = $oSourceHash;
${$self->{oManifest}}{source}{$strKey}{strSourceType} = $strSourceType;
}
# Iterate the renderers
foreach my $oRender ($self->{oManifestXml}->nodeGet('render-list')->nodeList('render'))
{
my $oRenderHash = {};
my $strType = $oRender->paramGet(RENDER_TYPE);
# Only one instance of each render type can be defined
if (defined(${$self->{oManifest}}{&RENDER}{$strType}))
{
confess &log(ERROR, "render ${strType} has already been defined");
}
# Get the file param
$${oRenderHash}{file} = $oRender->paramGet(RENDER_FILE, false);
$${oRenderHash}{&RENDER_COMPACT} = $oRender->paramGet(RENDER_COMPACT, false, 'n') eq 'y' ? true : false;
$${oRenderHash}{&RENDER_PRETTY} = $oRender->paramGet(RENDER_PRETTY, false, 'n') eq 'y' ? true : false;
$${oRenderHash}{&RENDER_MENU} = false;
logDebugMisc
(
$strOperation, ' load render',
{name => 'strType', value => $strType},
{name => 'strFile', value => $${oRenderHash}{file}}
);
# Error if file is set and render type is not pdf
if (defined($${oRenderHash}{file}) && $strType ne RENDER_TYPE_PDF)
{
confess &log(ERROR, 'only the pdf render type can have file set')
}
# Iterate the render sources
foreach my $oRenderOut ($oRender->nodeList('render-source'))
{
my $oRenderOutHash = {};
my $strKey = $oRenderOut->paramGet('key');
my $strSource = $oRenderOut->paramGet('source', false, $strKey);
# Skip sources in exclude list
if (grep(/^$strSource$/, @{$self->{stryExclude}}))
{
next;
}
# Skip sources not in include list
if (@{$self->{stryInclude}} > 0 && !grep(/^$strSource$/, @{$self->{stryInclude}}))
{
next;
}
# Preserve natural order
push(@{$${oRenderHash}{stryOrder}}, $strKey);
$$oRenderOutHash{source} = $strSource;
# Get the filename
if (defined($oRenderOut->paramGet('file', false)))
{
if ($strType eq RENDER_TYPE_HTML || $strType eq RENDER_TYPE_MARKDOWN)
{
$$oRenderOutHash{file} = $oRenderOut->paramGet('file');
}
else
{
confess &log(ERROR, "file is only valid with html or markdown render types");
}
}
# Get the menu caption
if (defined($oRenderOut->paramGet('menu', false)) && $strType ne RENDER_TYPE_HTML)
{
confess &log(ERROR, "menu is only valid with html render type");
}
if (defined($oRenderOut->paramGet('menu', false)))
{
$${oRenderHash}{&RENDER_MENU} = true;
if ($strType eq RENDER_TYPE_HTML)
{
$$oRenderOutHash{menu} = $oRenderOut->paramGet('menu', false);
}
else
{
confess &log(ERROR, 'only the html render type can have menu set');
}
}
logDebugMisc
(
$strOperation, ' load render source',
{name => 'strKey', value => $strKey},
{name => 'strSource', value => $strSource},
{name => 'strMenu', value => $${oRenderOutHash}{menu}}
);
$${oRenderHash}{out}{$strKey} = $oRenderOutHash;
}
${$self->{oManifest}}{render}{$strType} = $oRenderHash;
}
# Set the doc path variable
$self->variableSet('doc-path', $self->{strDocPath});
# Read variables from manifest
$self->variableListParse($self->{oManifestXml}->nodeGet('variable-list', false), $rhVariableOverride);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# isBackRest
#
# Until all the backrest specific code can be abstracted, this function will identify when BackRest docs are being built.
####################################################################################################################################
sub isBackRest
{
my $self = shift;
return($self->variableTest('project-exe', 'pgbackrest'));
}
####################################################################################################################################
# Evaluate the if condition for a node
####################################################################################################################################
sub evaluateIf
{
my $self = shift;
my $oNode = shift;
my $bIf = true;
# Evaluate if condition
if (defined($oNode->paramGet('if', false)))
{
my $strIf = $self->variableReplace($oNode->paramGet('if'));
# In this case we really do want to evaluate the contents and not treat it as a literal
$bIf = eval($strIf);
# Error if the eval failed
if ($@)
{
confess &log(ERROR, "unable to evaluate '${strIf}': $@");
}
}
return $bIf;
}
####################################################################################################################################
# variableListParse
#
# Parse a variable list and store variables.
####################################################################################################################################
sub variableListParse
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oVariableList,
$rhVariableOverride
) =
logDebugParam
(
__PACKAGE__ . '->variableListParse', \@_,
{name => '$oVariableList', required => false},
{name => '$rhVariableOverride', required => false}
);
if (defined($oVariableList))
{
foreach my $oVariable ($oVariableList->nodeList('variable'))
{
if ($self->evaluateIf($oVariable))
{
my $strKey = $oVariable->paramGet('key');
my $strValue = $self->variableReplace($oVariable->valueGet());
if ($oVariable->paramTest('eval', 'y'))
{
# In this case we really do want to evaluate the contents of strValue and not treat it as a literal.
$strValue = eval($strValue);
if ($@)
{
confess &log(ERROR, "unable to evaluate ${strKey}: $@\n" . $oVariable->valueGet());
}
}
$self->variableSet($strKey, defined($rhVariableOverride->{$strKey}) ? $rhVariableOverride->{$strKey} : $strValue);
logDebugMisc
(
$strOperation, ' load variable',
{name => 'strKey', value => $strKey},
{name => 'strValue', value => $strValue}
);
}
}
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# variableReplace
#
# Replace variables in the string.
####################################################################################################################################
sub variableReplace
{
my $self = shift;
my $strBuffer = shift;
my $strType = shift;
if (!defined($strBuffer))
{
return;
}
foreach my $strName (sort(keys(%{$self->{oVariable}})))
{
my $strValue = $self->{oVariable}{$strName};
$strBuffer =~ s/\{\[$strName\]\}/$strValue/g;
}
if (defined($strType) && $strType eq 'latex')
{
$strBuffer =~ s/\\\_/\_/g;
$strBuffer =~ s/\_/\\\_/g;
$strBuffer =~ s/\\\#/\#/g;
$strBuffer =~ s/\#/\\\#/g;
}
return $strBuffer;
}
####################################################################################################################################
# variableSet
#
# Set a variable to be replaced later.
####################################################################################################################################
sub variableSet
{
my $self = shift;
my $strKey = shift;
my $strValue = shift;
my $bForce = shift;
if (defined(${$self->{oVariable}}{$strKey}) && (!defined($bForce) || !$bForce))
{
confess &log(ERROR, "${strKey} variable is already defined");
}
${$self->{oVariable}}{$strKey} = $self->variableReplace($strValue);
}
####################################################################################################################################
# variableGet
#
# Get the current value of a variable.
####################################################################################################################################
sub variableGet
{
my $self = shift;
my $strKey = shift;
return ${$self->{oVariable}}{$strKey};
}
####################################################################################################################################
# variableTest
#
# Test that a variable is defined or has an expected value.
####################################################################################################################################
sub variableTest
{
my $self = shift;
my $strKey = shift;
my $strExpectedValue = shift;
# Get the variable
my $strValue = ${$self->{oVariable}}{$strKey};
# Return false if it is not defined
if (!defined($strValue))
{
return false;
}
# Return false if it does not equal the expected value
if (defined($strExpectedValue) && $strValue ne $strExpectedValue)
{
return false;
}
return true;
}
####################################################################################################################################
# Get list of source documents
####################################################################################################################################
sub sourceList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->sourceList');
# Check that sources exist
my @strySource;
if (defined(${$self->{oManifest}}{source}))
{
@strySource = sort(keys(%{${$self->{oManifest}}{source}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strySource', value => \@strySource}
);
}
####################################################################################################################################
# sourceGet
####################################################################################################################################
sub sourceGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource
) =
logDebugParam
(
__PACKAGE__ . '->sourceGet', \@_,
{name => 'strSource', trace => true}
);
if (!defined(${$self->{oManifest}}{source}{$strSource}))
{
confess &log(ERROR, "source ${strSource} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oSource', value => ${$self->{oManifest}}{source}{$strSource}}
);
}
####################################################################################################################################
# renderList
####################################################################################################################################
sub renderList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->renderList');
# Check that the render output exists
my @stryRender;
if (defined(${$self->{oManifest}}{render}))
{
@stryRender = sort(keys(%{${$self->{oManifest}}{render}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'stryRender', value => \@stryRender}
);
}
####################################################################################################################################
# renderGet
####################################################################################################################################
sub renderGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->renderGet', \@_,
{name => 'strType', trace => true}
);
# Check that the render exists
if (!defined(${$self->{oManifest}}{render}{$strType}))
{
confess &log(ERROR, "render type ${strType} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oRenderOut', value => ${$self->{oManifest}}{render}{$strType}}
);
}
####################################################################################################################################
# renderOutList
####################################################################################################################################
sub renderOutList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->renderOutList', \@_,
{name => 'strType'}
);
# Check that the render output exists
my @stryRenderOut;
if (defined(${$self->{oManifest}}{render}{$strType}))
{
@stryRenderOut = sort(keys(%{${$self->{oManifest}}{render}{$strType}{out}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'stryRenderOut', value => \@stryRenderOut}
);
}
####################################################################################################################################
# renderOutGet
####################################################################################################################################
sub renderOutGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$strKey,
$bIgnoreMissing,
) =
logDebugParam
(
__PACKAGE__ . '->renderOutGet', \@_,
{name => 'strType', trace => true},
{name => 'strKey', trace => true},
{name => 'bIgnoreMissing', default => false, trace => true},
);
if (!defined(${$self->{oManifest}}{render}{$strType}{out}{$strKey}) && !$bIgnoreMissing)
{
confess &log(ERROR, "render out ${strKey} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oRenderOut', value => ${$self->{oManifest}}{render}{$strType}{out}{$strKey}}
);
}
####################################################################################################################################
# cacheKey
####################################################################################################################################
sub cacheKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheKey');
# Generate a cache key from the variable override
my $strVariableKey = JSON::PP->new()->canonical()->allow_nonref()->encode($self->{rhKeyVariableOverride});
if ($strVariableKey eq '{}')
{
$strVariableKey = 'default';
}
my $strRequire = defined($self->{stryRequire}) && @{$self->{stryRequire}} > 0 ?
join("\n", @{$self->{stryRequire}}) : 'all';
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strVariableKey', value => $strVariableKey},
{name => 'strRequire', value => $strRequire},
);
}
####################################################################################################################################
# cacheRead
####################################################################################################################################
sub cacheRead
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheRead');
$self->{hCache} = undef;
my $strCacheFile = $self->{bDeploy} ? $self->{strExeCacheDeploy} : $self->{strExeCacheLocal};
if (!$self->storage()->exists($strCacheFile) && !$self->{bDeploy})
{
$strCacheFile = $self->{strExeCacheDeploy};
}
if ($self->storage()->exists($strCacheFile))
{
my ($strCacheKey, $strRequire) = $self->cacheKey();
my $oJSON = JSON::PP->new()->allow_nonref();
$self->{hCache} = $oJSON->decode(${$self->storage()->get($strCacheFile)});
foreach my $strSource (sort(keys(%{${$self->{oManifest}}{source}})))
{
my $hSource = ${$self->{oManifest}}{source}{$strSource};
if (defined(${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource}))
{
$$hSource{hyCache} = ${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource};
&log(DETAIL, "cache load $strSource (key = ${strCacheKey}, require = ${strRequire})");
}
}
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# cacheWrite
####################################################################################################################################
sub cacheWrite
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheWrite');
my $strCacheFile = $self->{bDeploy} ? $self->{strExeCacheDeploy} : $self->{strExeCacheLocal};
my ($strCacheKey, $strRequire) = $self->cacheKey();
foreach my $strSource (sort(keys(%{${$self->{oManifest}}{source}})))
{
my $hSource = ${$self->{oManifest}}{source}{$strSource};
if (defined($$hSource{hyCache}))
{
${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource} = $$hSource{hyCache};
&log(DETAIL, "cache load $strSource (key = ${strCacheKey}, require = ${strRequire})");
}
}
if (defined($self->{hCache}))
{
my $oJSON = JSON::PP->new()->canonical()->allow_nonref()->pretty();
$self->storage()->put($strCacheFile, $oJSON->encode($self->{hCache}));
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# cacheReset
####################################################################################################################################
sub cacheReset
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource
) =
logDebugParam
(
__PACKAGE__ . '->cacheReset', \@_,
{name => 'strSource', trace => true}
);
if ($self->{bCacheOnly})
{
confess &log(ERROR, 'Cache reset disabled by --cache-only option');
}
&log(WARN, "Cache will be reset for source ${strSource} and rendering retried automatically");
delete(${$self->{oManifest}}{source}{$strSource}{hyCache});
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# Getters
####################################################################################################################################
sub storage {shift->{oStorage}};
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Common/DocRender.pm 0000664 0000000 0000000 00000103656 13625315071 0024314 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC RENDER MODULE
####################################################################################################################################
package BackRestDoc::Common::DocRender;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use JSON::PP;
use Storable qw(dclone);
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use BackRestDoc::Common::DocManifest;
####################################################################################################################################
# XML tag/param constants
####################################################################################################################################
use constant XML_SECTION_PARAM_ANCHOR => 'anchor';
push @EXPORT, qw(XML_SECTION_PARAM_ANCHOR);
use constant XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT => 'no-inherit';
push @EXPORT, qw(XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT);
####################################################################################################################################
# Render tags for various output types
####################################################################################################################################
my $oRenderTag =
{
'markdown' =>
{
'quote' => ['"', '"'],
'b' => ['**', '**'],
'i' => ['_', '_'],
# 'bi' => ['_**', '**_'],
'ul' => ["\n", ""],
'ol' => ["\n", "\n"],
'li' => ['- ', "\n"],
'id' => ['`', '`'],
'file' => ['`', '`'],
'path' => ['`', '`'],
'cmd' => ['`', '`'],
'param' => ['`', '`'],
'setting' => ['`', '`'],
'pg-setting' => ['`', '`'],
'code' => ['`', '`'],
# 'code-block' => ['```', '```'],
# 'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['', ''],
'postgres' => ['PostgreSQL', ''],
'admonition' => ["\n> **", "\n"],
},
'text' =>
{
'quote' => ['"', '"'],
'b' => ['', ''],
'i' => ['', ''],
# 'bi' => ['', ''],
'ul' => ["\n", "\n"],
'ol' => ["\n", "\n"],
'li' => ['* ', "\n"],
'id' => ['', ''],
'host' => ['', ''],
'file' => ['', ''],
'path' => ['', ''],
'cmd' => ['', ''],
'br-option' => ['', ''],
'pg-setting' => ['', ''],
'param' => ['', ''],
'setting' => ['', ''],
'code' => ['', ''],
'code-block' => ['', ''],
'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['', ''],
'postgres' => ['PostgreSQL', ''],
'admonition' => ["\n", "\n\n"],
},
'latex' =>
{
'quote' => ['``', '"'],
'b' => ['\textbf{', '}'],
'i' => ['\textit{', '}'],
# 'bi' => ['', ''],
'ul' => ["\\begin{itemize}\n", "\\end{itemize}\n"],
# 'ol' => ["\n", "\n"],
'li' => ['\item ', "\n"],
'id' => ['\textnormal{\texttt{', '}}'],
'host' => ['\textnormal{\textbf{', '}}'],
'file' => ['\textnormal{\texttt{', '}}'],
'path' => ['\textnormal{\texttt{', '}}'],
'cmd' => ['\textnormal{\texttt{', "}}"],
'user' => ['\textnormal{\texttt{', '}}'],
'br-option' => ['', ''],
# 'param' => ['\texttt{', '}'],
# 'setting' => ['\texttt{', '}'],
'br-option' => ['\textnormal{\texttt{', '}}'],
'br-setting' => ['\textnormal{\texttt{', '}}'],
'pg-option' => ['\textnormal{\texttt{', '}}'],
'pg-setting' => ['\textnormal{\texttt{', '}}'],
'code' => ['\textnormal{\texttt{', '}}'],
# 'code' => ['\texttt{', '}'],
# 'code-block' => ['', ''],
# 'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['\textnormal{\texttt{', '}}'],
'postgres' => ['PostgreSQL', ''],
'admonition' => ["\n\\begin{leftbar}\n\\textit{\\textbf{", "}\n\\end{leftbar}\n"],
},
'html' =>
{
'quote' => ['', ' '],
'b' => ['', ' '],
'i' => ['', ' '],
# 'bi' => ['', ' ', ' '],
'li' => ['', ' '],
'id' => ['', ' '],
'host' => ['', ' '],
'file' => ['', ' '],
'path' => ['', ' '],
'cmd' => ['', ' '],
'user' => ['', ' '],
'br-option' => ['', ' '],
'br-setting' => ['', ' '],
'pg-option' => ['', ' '],
'pg-setting' => ['', ' '],
'code' => ['', ' '],
'code-block' => ['', ' '],
'exe' => [undef, ''],
'setting' => ['', ' '], # ??? This will need to be fixed
'backrest' => [undef, ''],
'proper' => ['', ' '],
'postgres' => ['PostgreSQL ', ''],
'admonition' => ['', '
'],
}
};
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strType},
$self->{oManifest},
$self->{bExe},
$self->{strRenderOutKey},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strType'},
{name => 'oManifest', required => false},
{name => 'bExe', required => false},
{name => 'strRenderOutKey', required => false}
);
# Create JSON object
$self->{oJSON} = JSON::PP->new()->allow_nonref();
# Initialize project tags
$$oRenderTag{markdown}{backrest}[0] = "{[project]}";
$$oRenderTag{markdown}{exe}[0] = "{[project-exe]}";
$$oRenderTag{text}{backrest}[0] = "{[project]}";
$$oRenderTag{text}{exe}[0] = "{[project-exe]}";
$$oRenderTag{latex}{backrest}[0] = "{[project]}";
$$oRenderTag{latex}{exe}[0] = "\\textnormal\{\\texttt\{[project-exe]}}\}\}";
$$oRenderTag{html}{backrest}[0] = "{[project]} ";
$$oRenderTag{html}{exe}[0] = "{[project-exe]} ";
if (defined($self->{strRenderOutKey}))
{
# Copy page data to self
my $oRenderOut =
$self->{oManifest}->renderOutGet($self->{strType} eq 'latex' ? 'pdf' : $self->{strType}, $self->{strRenderOutKey});
# If these are the backrest docs then load the reference
if ($self->{oManifest}->isBackRest())
{
$self->{oReference} =
new BackRestDoc::Common::DocConfig(${$self->{oManifest}->sourceGet('reference')}{doc}, $self);
}
if (defined($$oRenderOut{source}) && $$oRenderOut{source} eq 'reference' && $self->{oManifest}->isBackRest())
{
if ($self->{strRenderOutKey} eq 'configuration')
{
$self->{oDoc} = $self->{oReference}->helpConfigDocGet();
}
elsif ($self->{strRenderOutKey} eq 'command')
{
$self->{oDoc} = $self->{oReference}->helpCommandDocGet();
}
else
{
confess &log(ERROR, "cannot render $self->{strRenderOutKey} from source $$oRenderOut{source}");
}
}
elsif (defined($$oRenderOut{source}) && $$oRenderOut{source} eq 'release' && $self->{oManifest}->isBackRest())
{
require BackRestDoc::Custom::DocCustomRelease;
BackRestDoc::Custom::DocCustomRelease->import();
$self->{oDoc} =
(new BackRestDoc::Custom::DocCustomRelease(
${$self->{oManifest}->sourceGet('release')}{doc},
defined($self->{oManifest}->variableGet('dev')) && $self->{oManifest}->variableGet('dev') eq 'y'))->docGet();
}
else
{
$self->{oDoc} = ${$self->{oManifest}->sourceGet($self->{strRenderOutKey})}{doc};
}
$self->{oSource} = $self->{oManifest}->sourceGet($$oRenderOut{source});
}
if (defined($self->{strRenderOutKey}))
{
# Build the doc
$self->build($self->{oDoc});
# Get required sections
foreach my $strPath (@{$self->{oManifest}->{stryRequire}})
{
if (substr($strPath, 0, 1) ne '/')
{
confess &log(ERROR, "path ${strPath} must begin with a /");
}
if (!defined($self->{oSection}->{$strPath}))
{
confess &log(ERROR, "required section '${strPath}' does not exist");
}
if (defined(${$self->{oSection}}{$strPath}))
{
$self->required($strPath);
}
}
}
if (defined($self->{oDoc}))
{
$self->{bToc} = !defined($self->{oDoc}->paramGet('toc', false)) || $self->{oDoc}->paramGet('toc') eq 'y' ? true : false;
$self->{bTocNumber} =
$self->{bToc} &&
(!defined($self->{oDoc}->paramGet('toc-number', false)) || $self->{oDoc}->paramGet('toc-number') eq 'y') ? true : false;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# Set begin and end values for a tag
####################################################################################################################################
sub tagSet
{
my $self = shift;
my $strTag = shift;
my $strBegin = shift;
my $strEnd = shift;
$oRenderTag->{$self->{strType}}{$strTag}[0] = defined($strBegin) ? $strBegin : '';
$oRenderTag->{$self->{strType}}{$strTag}[1] = defined($strEnd) ? $strEnd : '';
}
####################################################################################################################################
# variableReplace
#
# Replace variables in the string.
####################################################################################################################################
sub variableReplace
{
my $self = shift;
return defined($self->{oManifest}) ? $self->{oManifest}->variableReplace(shift, $self->{strType}) : shift;
}
####################################################################################################################################
# variableSet
#
# Set a variable to be replaced later.
####################################################################################################################################
sub variableSet
{
my $self = shift;
return $self->{oManifest}->variableSet(shift, shift);
}
####################################################################################################################################
# variableGet
#
# Get the current value of a variable.
####################################################################################################################################
sub variableGet
{
my $self = shift;
return $self->{oManifest}->variableGet(shift);
}
####################################################################################################################################
# Get pre-execute list for a host
####################################################################################################################################
sub preExecute
{
my $self = shift;
my $strHost = shift;
if (defined($self->{preExecute}{$strHost}))
{
return @{$self->{preExecute}{$strHost}};
}
return;
}
####################################################################################################################################
# build
#
# Build the section map and perform filtering.
####################################################################################################################################
sub build
{
my $self = shift;
my $oNode = shift;
my $oParent = shift;
my $strPath = shift;
my $strPathPrefix = shift;
# &log(INFO, " node " . $oNode->nameGet());
my $strName = $oNode->nameGet();
if (defined($oParent))
{
# Evaluate if condition -- when false the node will be removed
if (!$self->{oManifest}->evaluateIf($oNode))
{
my $strDescription;
if (defined($oNode->nodeGet('title', false)))
{
$strDescription = $self->processText($oNode->nodeGet('title')->textGet());
}
&log(DEBUG, " filtered ${strName}" . (defined($strDescription) ? ": ${strDescription}" : ''));
$oParent->nodeRemove($oNode);
return;
}
}
else
{
&log(DEBUG, ' build document');
$self->{oSection} = {};
}
# Build section
if ($strName eq 'section')
{
my $strSectionId = $oNode->paramGet('id');
&log(DEBUG, "build section [${strSectionId}]");
# Set path and parent-path for this section
if (defined($strPath))
{
$oNode->paramSet('path-parent', $strPath);
}
$strPath .= '/' . $oNode->paramGet('id');
&log(DEBUG, " path ${strPath}");
${$self->{oSection}}{$strPath} = $oNode;
$oNode->paramSet('path', $strPath);
# If depend is not set then set it to the last section
my $strDepend = $oNode->paramGet('depend', false);
my $oContainerNode = defined($oParent) ? $oParent : $self->{oDoc};
my $oLastChild;
my $strDependPrev;
foreach my $oChild ($oContainerNode->nodeList('section', false))
{
if ($oChild->paramGet('id') eq $oNode->paramGet('id'))
{
if (defined($oLastChild))
{
$strDependPrev = $oLastChild->paramGet('id');
}
elsif (defined($oParent->paramGet('depend', false)))
{
$strDependPrev = $oParent->paramGet('depend');
}
last;
}
$oLastChild = $oChild;
}
if (defined($strDepend))
{
if (defined($strDependPrev) && $strDepend eq $strDependPrev && !$oNode->paramTest('depend-default'))
{
&log(WARN,
"section '${strPath}' depend is set to '${strDepend}' which is the default, best to remove" .
" because it may become obsolete if a new section is added in between");
}
}
else
{
$strDepend = $strDependPrev;
}
# If depend is defined make sure it exists
if (defined($strDepend))
{
# If this is a relative depend then prepend the parent section
if (index($strDepend, '/') != 0)
{
if (defined($oParent->paramGet('path', false)))
{
$strDepend = $oParent->paramGet('path') . '/' . $strDepend;
}
else
{
$strDepend = "/${strDepend}";
}
}
if (!defined($self->{oSection}->{$strDepend}))
{
confess &log(ERROR, "section '${strSectionId}' depend '${strDepend}' is not valid");
}
}
if (defined($strDepend))
{
$oNode->paramSet('depend', $strDepend);
}
if (defined($strDependPrev))
{
$oNode->paramSet('depend-default', $strDependPrev);
}
# Set log to true if this section has an execute list. This helps reduce the info logging by only showing sections that are
# likely to take a log time.
$oNode->paramSet('log', $self->{bExe} && $oNode->nodeList('execute-list', false) > 0 ? true : false);
# If section content is being pulled from elsewhere go get the content
if ($oNode->paramTest('source'))
{
my $oSource = ${$self->{oManifest}->sourceGet($oNode->paramGet('source'))}{doc};
# Section should not already have title defined, it should come from the source doc
if ($oNode->nodeTest('title'))
{
confess &log(ERROR, "cannot specify title in section that sources another document");
}
# Set title from source doc's title
$oNode->nodeAdd('title')->textSet($oSource->paramGet('title'));
foreach my $oSection ($oSource->nodeList('section'))
{
push(@{${$oNode->{oDoc}}{children}}, $oSection->{oDoc});
}
# Set path prefix to modify all section paths further down
$strPathPrefix = $strPath;
# Remove source so it is not included again later
$oNode->paramSet('source', undef);
}
}
# Build link
elsif ($strName eq 'link')
{
&log(DEBUG, 'build link [' . $oNode->valueGet() . ']');
# If the path prefix is set and this is a section
if (defined($strPathPrefix) && $oNode->paramTest('section'))
{
my $strNewPath = $strPathPrefix . $oNode->paramGet('section');
&log(DEBUG, "modify link section from '" . $oNode->paramGet('section') . "' to '${strNewPath}'");
$oNode->paramSet('section', $strNewPath);
}
}
# Store block defines
elsif ($strName eq 'block-define')
{
my $strBlockId = $oNode->paramGet('id');
if (defined($self->{oyBlockDefine}{$strBlockId}))
{
confess &log(ERROR, "block ${strBlockId} is already defined");
}
$self->{oyBlockDefine}{$strBlockId} = dclone($oNode->{oDoc}{children});
$oParent->nodeRemove($oNode);
}
# Copy blocks
elsif ($strName eq 'block')
{
my $strBlockId = $oNode->paramGet('id');
if (!defined($self->{oyBlockDefine}{$strBlockId}))
{
confess &log(ERROR, "block ${strBlockId} is not defined");
}
my $strNodeJSON = $self->{oJSON}->encode($self->{oyBlockDefine}{$strBlockId});
foreach my $oVariable ($oNode->nodeList('block-variable-replace', false))
{
my $strVariableKey = $oVariable->paramGet('key');
my $strVariableReplace = $oVariable->valueGet();
$strNodeJSON =~ s/\{\[$strVariableKey\]\}/$strVariableReplace/g;
}
my ($iReplaceIdx, $iReplaceTotal) = $oParent->nodeReplace($oNode, $self->{oJSON}->decode($strNodeJSON));
# Build any new children that were added
my $iChildIdx = 0;
foreach my $oChild ($oParent->nodeList(undef, false))
{
if ($iChildIdx >= $iReplaceIdx && $iChildIdx < ($iReplaceIdx + $iReplaceTotal))
{
$self->build($oChild, $oParent, $strPath, $strPathPrefix);
}
$iChildIdx++;
}
}
# Check for pre-execute statements
elsif ($strName eq 'execute')
{
if ($self->{oManifest}->{bPre} && $oNode->paramGet('pre', false, 'n') eq 'y')
{
# Add to pre-execute list
my $strHost = $self->variableReplace($oParent->paramGet('host'));
push(@{$self->{preExecute}{$strHost}}, $oNode);
# Skip this command so it doesn't get executed twice
$oNode->paramSet('skip', 'y')
}
}
# Iterate all text nodes
if (defined($oNode->textGet(false)))
{
foreach my $oChild ($oNode->textGet()->nodeList(undef, false))
{
if (ref(\$oChild) ne "SCALAR")
{
$self->build($oChild, $oNode, $strPath, $strPathPrefix);
}
}
}
# Iterate all non-text nodes
foreach my $oChild ($oNode->nodeList(undef, false))
{
if (ref(\$oChild) ne "SCALAR")
{
$self->build($oChild, $oNode, $strPath, $strPathPrefix);
# If the child should be logged then log the parent as well so the hierarchy is complete
if ($oChild->nameGet() eq 'section' && $oChild->paramGet('log', false, false))
{
$oNode->paramSet('log', true);
}
}
}
}
####################################################################################################################################
# required
#
# Build a list of required sections
####################################################################################################################################
sub required
{
my $self = shift;
my $strPath = shift;
my $bDepend = shift;
# If node is not found that means the path is invalid
my $oNode = ${$self->{oSection}}{$strPath};
if (!defined($oNode))
{
confess &log(ERROR, "invalid path ${strPath}");
}
# Only add sections that are listed dependencies
if (!defined($bDepend) || $bDepend)
{
# Match section and all child sections
foreach my $strChildPath (sort(keys(%{$self->{oSection}})))
{
if ($strChildPath =~ /^$strPath$/ || $strChildPath =~ /^$strPath\/.*$/)
{
if (!defined(${$self->{oSectionRequired}}{$strChildPath}))
{
my @stryChildPath = split('/', $strChildPath);
&log(INFO, (' ' x (scalar(@stryChildPath) - 2)) . " require section: ${strChildPath}");
${$self->{oSectionRequired}}{$strChildPath} = true;
}
}
}
}
# Get the path of the current section's parent
my $strParentPath = $oNode->paramGet('path-parent', false);
if ($oNode->paramTest('depend'))
{
foreach my $strDepend (split(',', $oNode->paramGet('depend')))
{
if ($strDepend !~ /^\//)
{
if (!defined($strParentPath))
{
$strDepend = "/${strDepend}";
}
else
{
$strDepend = "${strParentPath}/${strDepend}";
}
}
$self->required($strDepend, true);
}
}
elsif (defined($strParentPath))
{
$self->required($strParentPath, false);
}
}
####################################################################################################################################
# isRequired
#
# Is it required to execute the section statements?
####################################################################################################################################
sub isRequired
{
my $self = shift;
my $oSection = shift;
if (!defined($self->{oSectionRequired}))
{
return true;
}
my $strPath = $oSection->paramGet('path');
defined(${$self->{oSectionRequired}}{$strPath}) ? true : false;
}
####################################################################################################################################
# processTag
####################################################################################################################################
sub processTag
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processTag', \@_,
{name => 'oTag', trace => true}
);
my $strBuffer = "";
my $strType = $self->{strType};
my $strTag = $oTag->nameGet();
if (!defined($strTag))
{
require Data::Dumper;
confess Dumper($oTag);
}
if ($strTag eq 'link')
{
my $strUrl = $oTag->paramGet('url', false);
if (!defined($strUrl))
{
my $strPage = $self->variableReplace($oTag->paramGet('page', false));
# If this is a page URL
if (defined($strPage))
{
# If the page wasn't rendered then point at the website
if (!defined($self->{oManifest}->renderOutGet($strType, $strPage, true)))
{
$strUrl = '{[backrest-url-base]}/' . $oTag->paramGet('page') . '.html';
}
# Else point locally
else
{
if ($strType eq 'html' || $strType eq 'markdown')
{
$strUrl =
$oTag->paramGet('page', false) . '.' .
($strType eq 'html' ? $strType : '.md');
}
else
{
confess &log(ERROR, "page links not supported for type ${strType}, value '" . $oTag->valueGet() . "'");
}
}
}
else
{
my $strSection = $oTag->paramGet('section');
my $oSection = ${$self->{oSection}}{$strSection};
if (!defined($oSection))
{
confess &log(ERROR, "section link '${strSection}' does not exist");
}
if (!defined($strSection))
{
confess &log(ERROR, "link with value '" . $oTag->valueGet() . "' must defined url, page, or section");
}
if ($strType eq 'html')
{
$strUrl = '#' . substr($strSection, 1);
}
elsif ($strType eq 'latex')
{
$strUrl = $strSection;
}
else
{
$strUrl = lc($self->processText($oSection->nodeGet('title')->textGet()));
$strUrl =~ s/[^\w\- ]//g;
$strUrl =~ s/ /-/g;
$strUrl = '#' . $strUrl;
}
}
}
if ($strType eq 'html')
{
$strBuffer = '' . $oTag->valueGet() . ' ';
}
elsif ($strType eq 'markdown')
{
$strBuffer = '[' . $oTag->valueGet() . '](' . $strUrl . ')';
}
elsif ($strType eq 'latex')
{
if ($oTag->paramTest('url'))
{
$strBuffer = "\\href{$strUrl}{" . $oTag->valueGet() . "}";
}
else
{
$strBuffer = "\\hyperref[$strUrl]{" . $oTag->valueGet() . "}";
}
}
else
{
confess "'link' tag not valid for type ${strType}";
}
}
else
{
my $strStart = $$oRenderTag{$strType}{$strTag}[0];
my $strStop = $$oRenderTag{$strType}{$strTag}[1];
if (!defined($strStart) || !defined($strStop))
{
confess &log(ERROR, "invalid type ${strType} or tag ${strTag}");
}
$strBuffer .= $strStart;
# Admonitions in the reference materials are tags of the text element rather than field elements of the document so special
# handling is required
if ($strTag eq 'admonition')
{
$strBuffer .= $self->processAdmonitionStart($oTag);
}
if ($strTag eq 'p' || $strTag eq 'title' || $strTag eq 'li' || $strTag eq 'code-block' || $strTag eq 'summary'
|| $strTag eq 'admonition')
{
$strBuffer .= $self->processText($oTag);
}
elsif (defined($oTag->valueGet()))
{
$strBuffer .= $oTag->valueGet();
}
else
{
foreach my $oSubTag ($oTag->nodeList(undef, false))
{
$strBuffer .= $self->processTag($oSubTag);
}
}
if ($strTag eq 'admonition')
{
$strBuffer .= $self->processAdmonitionEnd($oTag);
}
$strBuffer .= $strStop;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processAdmonitionStart
####################################################################################################################################
sub processAdmonitionStart
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processAdmonitionStart', \@_,
{name => 'oTag', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
# Note that any changes to the way the HTML, markdown or latex display tags may also need to be made here
if ($strType eq 'html')
{
my $strType = $oTag->paramGet('type');
$strBuffer = '' . uc($strType) . ':
' .
'';
}
elsif ($strType eq 'text' || $strType eq 'markdown')
{
$strBuffer = uc($oTag->paramGet('type')) . ": ";
}
elsif ($strType eq 'latex')
{
$strBuffer = uc($oTag->paramGet('type')) . ": }";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processAdmonitionEnd
####################################################################################################################################
sub processAdmonitionEnd
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processAdmonitionEnd', \@_,
{name => 'oTag', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
# Note that any changes to the way the HTML, markdown or latex display tags may also need to be made here
if ($strType eq 'html')
{
$strBuffer = '
';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processText
####################################################################################################################################
sub processText
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oText
) =
logDebugParam
(
__PACKAGE__ . '->processText', \@_,
{name => 'oText', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
foreach my $oNode ($oText->nodeList(undef, false))
{
if (ref(\$oNode) eq "SCALAR")
{
if ($oNode =~ /\"/)
{
confess &log(ERROR, "unable to process quotes in string (use instead):\n${oNode}");
}
$strBuffer .= $oNode;
}
else
{
$strBuffer .= $self->processTag($oNode);
}
}
#
# if ($strType eq 'html')
# {
# # $strBuffer =~ s/^\s+|\s+$//g;
#
# $strBuffer =~ s/\n/\\n/g;
# }
# if ($strType eq 'markdown')
# {
# $strBuffer =~ s/^\s+|\s+$//g;
$strBuffer =~ s/ +/ /g;
$strBuffer =~ s/^ //smg;
# }
if ($strType eq 'latex')
{
$strBuffer =~ s/\&mdash\;/---/g;
$strBuffer =~ s/\<\;/\\=/\$\\geq\$/g;
# $strBuffer =~ s/\_/\\_/g;
# If not a code-block, which is to be taken AS IS, then escape special characters in latex
if ($oText->nameGet() ne 'code-block')
{
# If the previous character is not already a slash (e.g. not already escaped) then insert a slash
$strBuffer =~ s/(?nameGet() eq 'list-item')
{
$strBuffer =~ s/\[/\{\[/g;
$strBuffer =~ s/\]/\]\}/g;
}
$strBuffer =~ s/\©\;/{\\textcopyright}/g;
$strBuffer =~ s/\&trade\;/{\\texttrademark}/g;
$strBuffer =~ s/\®\;/{\\textregistered}/g;
$strBuffer =~ s/\&rarr\;/{\\textrightarrow}/g;
# Escape all ampersands after making any other conversions above
$strBuffer =~ s/(?\=/g;
}
$strBuffer = $self->variableReplace($strBuffer);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Custom/ 0000775 0000000 0000000 00000000000 13625315071 0022120 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Custom/DocCustomRelease.pm 0000664 0000000 0000000 00000065274 13625315071 0025675 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC RELEASE MODULE
####################################################################################################################################
package BackRestDoc::Custom::DocCustomRelease;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestBuild::Config::Data;
use BackRestDoc::Common::DocRender;
####################################################################################################################################
# XML node constants
####################################################################################################################################
use constant XML_PARAM_ID => 'id';
use constant XML_CONTRIBUTOR_LIST => 'contributor-list';
use constant XML_CONTRIBUTOR => 'contributor';
use constant XML_CONTRIBUTOR_NAME_DISPLAY => 'contributor-name-display';
use constant XML_RELEASE_CORE_LIST => 'release-core-list';
use constant XML_RELEASE_DOC_LIST => 'release-doc-list';
use constant XML_RELEASE_TEST_LIST => 'release-test-list';
use constant XML_RELEASE_BUG_LIST => 'release-bug-list';
use constant XML_RELEASE_DEVELOPMENT_LIST => 'release-development-list';
use constant XML_RELEASE_FEATURE_LIST => 'release-feature-list';
use constant XML_RELEASE_IMPROVEMENT_LIST => 'release-improvement-list';
use constant XML_RELEASE_ITEM_CONTRIBUTOR_LIST => 'release-item-contributor-list';
use constant XML_RELEASE_ITEM_CONTRIBUTOR => 'release-item-contributor';
use constant XML_RELEASE_ITEM_IDEATOR => 'release-item-ideator';
use constant XML_RELEASE_ITEM_REVIEWER => 'release-item-reviewer';
####################################################################################################################################
# Contributor text constants
####################################################################################################################################
use constant TEXT_CONTRIBUTED => 'Contributed';
use constant TEXT_FIXED => 'Fixed';
use constant TEXT_FOUND => 'Reported';
use constant TEXT_REVIEWED => 'Reviewed';
use constant TEXT_SUGGESTED => 'Suggested';
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oDoc},
$self->{bDev},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oDoc'},
{name => 'bDev', required => false, default => false},
);
# Get contributor list
foreach my $oContributor ($self->{oDoc}->nodeGet(XML_CONTRIBUTOR_LIST)->nodeList(XML_CONTRIBUTOR))
{
my $strContributorId = $oContributor->paramGet(XML_PARAM_ID);
if (!defined($self->{hContributor}))
{
$self->{hContributor} = {};
$self->{strContributorDefault} = $strContributorId;
}
${$self->{hContributor}}{$strContributorId}{name} = $oContributor->fieldGet(XML_CONTRIBUTOR_NAME_DISPLAY);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# currentStableVersion
#
# Return the current stable version.
####################################################################################################################################
sub currentStableVersion
{
my $self = shift;
my $oDoc = $self->{oDoc};
foreach my $oRelease ($oDoc->nodeGet('release-list')->nodeList('release'))
{
my $strVersion = $oRelease->paramGet('version');
if ($strVersion !~ /dev$/)
{
return $strVersion;
}
}
confess &log(ERROR, "unable to find non-development version");
}
####################################################################################################################################
# releaseLast
#
# Get the last release.
####################################################################################################################################
sub releaseLast
{
my $self = shift;
my $oDoc = $self->{oDoc};
foreach my $oRelease ($oDoc->nodeGet('release-list')->nodeList('release'))
{
return $oRelease;
}
}
####################################################################################################################################
# contributorTextGet
#
# Get a list of contributors for an item in text format.
####################################################################################################################################
sub contributorTextGet
{
my $self = shift;
my $oReleaseItem = shift;
my $strItemType = shift;
my $strContributorText;
my $hItemContributorType = {};
# Create a the list of contributors
foreach my $strContributorType (XML_RELEASE_ITEM_IDEATOR, XML_RELEASE_ITEM_CONTRIBUTOR, XML_RELEASE_ITEM_REVIEWER)
{
my $stryItemContributor = [];
if ($oReleaseItem->nodeTest(XML_RELEASE_ITEM_CONTRIBUTOR_LIST))
{
foreach my $oContributor ($oReleaseItem->nodeGet(XML_RELEASE_ITEM_CONTRIBUTOR_LIST)->
nodeList($strContributorType, false))
{
push @{$stryItemContributor}, $oContributor->paramGet(XML_PARAM_ID);
}
}
if (@$stryItemContributor == 0 && $strContributorType eq XML_RELEASE_ITEM_CONTRIBUTOR)
{
push @{$stryItemContributor}, $self->{strContributorDefault}
}
$$hItemContributorType{$strContributorType} = $stryItemContributor;
}
# Error if a reviewer is also a contributor
foreach my $strReviewer (@{$$hItemContributorType{&XML_RELEASE_ITEM_REVIEWER}})
{
foreach my $strContributor (@{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}})
{
if ($strReviewer eq $strContributor)
{
confess &log(ERROR, "${strReviewer} cannot be both a contributor and a reviewer");
}
}
}
# Error if the ideator list is the same as the contributor list
if (join(',', @{$$hItemContributorType{&XML_RELEASE_ITEM_IDEATOR}}) eq
join(',', @{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}}))
{
confess &log(ERROR, 'cannot have same contributor and ideator list: ' .
join(', ', @{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}}));
}
# Remove the default user if they are the only one in a group (to prevent the entire page from being splattered with one name)
foreach my $strContributorType (XML_RELEASE_ITEM_IDEATOR, XML_RELEASE_ITEM_CONTRIBUTOR, XML_RELEASE_ITEM_REVIEWER)
{
if (@{$$hItemContributorType{$strContributorType}} == 1 &&
@{$$hItemContributorType{$strContributorType}}[0] eq $self->{strContributorDefault})
{
$$hItemContributorType{$strContributorType} = [];
}
}
# Render the string
foreach my $strContributorType (XML_RELEASE_ITEM_CONTRIBUTOR, XML_RELEASE_ITEM_REVIEWER, XML_RELEASE_ITEM_IDEATOR)
{
my $stryItemContributor = $$hItemContributorType{$strContributorType};
my $strContributorTypeText;
foreach my $strContributor (@{$stryItemContributor})
{
my $hContributor = ${$self->{hContributor}}{$strContributor};
if (!defined($hContributor))
{
confess &log(ERROR, "contributor ${strContributor} does not exist");
}
$strContributorTypeText .= (defined($strContributorTypeText) ? ', ' : '') . $$hContributor{name};
}
if (defined($strContributorTypeText))
{
$strContributorTypeText = ' by ' . $strContributorTypeText . '.';
if ($strContributorType eq XML_RELEASE_ITEM_CONTRIBUTOR)
{
$strContributorTypeText = ($strItemType eq 'bug' ? TEXT_FIXED : TEXT_CONTRIBUTED) . $strContributorTypeText;
}
elsif ($strContributorType eq XML_RELEASE_ITEM_IDEATOR)
{
$strContributorTypeText = ($strItemType eq 'bug' ? TEXT_FOUND : TEXT_SUGGESTED) . $strContributorTypeText;
}
elsif ($strContributorType eq XML_RELEASE_ITEM_REVIEWER)
{
$strContributorTypeText = TEXT_REVIEWED . $strContributorTypeText;
}
$strContributorText .= (defined($strContributorText) ? ' ' : '') . $strContributorTypeText;
}
}
return $strContributorText;
}
####################################################################################################################################
# Find a commit by subject prefix. Error if the prefix appears more than once.
####################################################################################################################################
sub commitFindSubject
{
my $self = shift;
my $rhyCommit = shift;
my $strSubjectPrefix = shift;
my $bRegExp = shift;
$bRegExp = defined($bRegExp) ? $bRegExp : true;
my $rhResult = undef;
foreach my $rhCommit (@{$rhyCommit})
{
if (($bRegExp && $rhCommit->{subject} =~ /^$strSubjectPrefix/) ||
(!$bRegExp && length($rhCommit->{subject}) >= length($strSubjectPrefix) &&
substr($rhCommit->{subject}, 0, length($strSubjectPrefix)) eq $strSubjectPrefix))
{
if (defined($rhResult))
{
confess &log(ERROR, "subject prefix '${strSubjectPrefix}' already found in commit " . $rhCommit->{commit});
}
$rhResult = $rhCommit;
}
}
return $rhResult;
}
####################################################################################################################################
# Throw an error that includes a list of release commits
####################################################################################################################################
sub commitError
{
my $self = shift;
my $strMessage = shift;
my $rstryCommitRemaining = shift;
my $rhyCommit = shift;
my $strList;
foreach my $strCommit (@{$rstryCommitRemaining})
{
$strList .=
(defined($strList) ? "\n" : '') .
substr($rhyCommit->{$strCommit}{date}, 0, length($rhyCommit->{$strCommit}{date}) - 15) . " $strCommit: " .
$rhyCommit->{$strCommit}{subject};
}
confess &log(ERROR, "${strMessage}:\n${strList}");
}
####################################################################################################################################
# docGet
#
# Get the xml for release.
####################################################################################################################################
sub docGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->docGet');
# Load the git history
my $oStorageDoc = new pgBackRestTest::Common::Storage(
dirname(abs_path($0)), new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
my @hyGitLog = @{(JSON::PP->new()->allow_nonref())->decode(${$oStorageDoc->get("resource/git-history.cache")})};
# Get renderer
my $oRender = new BackRestDoc::Common::DocRender('text');
$oRender->tagSet('backrest', PROJECT_NAME);
# Create the doc
my $oDoc = new BackRestDoc::Common::Doc();
$oDoc->paramSet('title', $self->{oDoc}->paramGet('title'));
$oDoc->paramSet('toc-number', $self->{oDoc}->paramGet('toc-number'));
# Set the description for use as a meta tag
$oDoc->fieldSet('description', $self->{oDoc}->fieldGet('description'));
# Add the introduction
my $oIntroSectionDoc = $oDoc->nodeAdd('section', undef, {id => 'introduction'});
$oIntroSectionDoc->nodeAdd('title')->textSet('Introduction');
$oIntroSectionDoc->textSet($self->{oDoc}->nodeGet('intro')->textGet());
# Add each release section
my $oSection;
my $iDevReleaseTotal = 0;
my $iCurrentReleaseTotal = 0;
my $iStableReleaseTotal = 0;
my $iUnsupportedReleaseTotal = 0;
my @oyRelease = $self->{oDoc}->nodeGet('release-list')->nodeList('release');
for (my $iReleaseIdx = 0; $iReleaseIdx < @oyRelease; $iReleaseIdx++)
{
my $oRelease = $oyRelease[$iReleaseIdx];
# Get the release version and dev flag
my $strVersion = $oRelease->paramGet('version');
my $bReleaseDev = $strVersion =~ /dev$/ ? true : false;
# Get a list of commits that apply to this release
my @rhyReleaseCommit;
my $rhReleaseCommitRemaining;
my @stryReleaseCommitRemaining;
my $bReleaseCheckCommit = false;
if ($strVersion ge '2.01')
{
# Should commits in the release be checked?
$bReleaseCheckCommit = !$bReleaseDev ? true : false;
# Get the begin commit
my $rhReleaseCommitBegin = $self->commitFindSubject(\@hyGitLog, "Begin v${strVersion} development\\.");
my $strReleaseCommitBegin = defined($rhReleaseCommitBegin) ? $rhReleaseCommitBegin->{commit} : undef;
# Get the end commit of the last release
my $strReleaseLastVersion = $oyRelease[$iReleaseIdx + 1]->paramGet('version');
my $rhReleaseLastCommitEnd = $self->commitFindSubject(\@hyGitLog, "v${strReleaseLastVersion}\\: .+");
if (!defined($rhReleaseLastCommitEnd))
{
confess &log(ERROR, "release ${strReleaseLastVersion} must have an end commit");
}
my $strReleaseLastCommitEnd = $rhReleaseLastCommitEnd->{commit};
# Get the end commit
my $rhReleaseCommitEnd = $self->commitFindSubject(\@hyGitLog, "v${strVersion}\\: .+");
my $strReleaseCommitEnd = defined($rhReleaseCommitEnd) ? $rhReleaseCommitEnd->{commit} : undef;
if ($bReleaseCheckCommit && !defined($rhReleaseCommitEnd) && $iReleaseIdx != 0)
{
confess &log(ERROR, "release ${strVersion} must have an end commit");
}
# Make a list of commits for this release
while ($hyGitLog[0]->{commit} ne $strReleaseLastCommitEnd)
{
# Don't add begin/end commits to the list since they are already accounted for
if ((defined($strReleaseCommitEnd) && $hyGitLog[0]->{commit} eq $strReleaseCommitEnd) ||
(defined($strReleaseCommitBegin) && $hyGitLog[0]->{commit} eq $strReleaseCommitBegin))
{
shift(@hyGitLog);
}
# Else add the commit to this releases' list
else
{
push(@stryReleaseCommitRemaining, $hyGitLog[0]->{commit});
push(@rhyReleaseCommit, $hyGitLog[0]);
$rhReleaseCommitRemaining->{$hyGitLog[0]->{commit}}{date} = $hyGitLog[0]->{date};
$rhReleaseCommitRemaining->{$hyGitLog[0]->{commit}}{subject} = $hyGitLog[0]->{subject};
shift(@hyGitLog);
}
}
# At least one commit is required for non-dev releases
if ($bReleaseCheckCommit && @stryReleaseCommitRemaining == 0)
{
confess &log(ERROR, "no commits found for release ${strVersion}");
}
}
# Display versions in TOC?
my $bTOC = true;
# Create a release section
if ($bReleaseDev)
{
if ($iDevReleaseTotal > 1)
{
confess &log(ERROR, 'only one development release is allowed');
}
$oSection = $oDoc->nodeAdd('section', undef, {id => 'development', if => "'{[dev]}' eq 'y'"});
$oSection->nodeAdd('title')->textSet("Development Notes");
$iDevReleaseTotal++;
}
elsif ($iCurrentReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'current'});
$oSection->nodeAdd('title')->textSet("Current Stable Release");
$iCurrentReleaseTotal++;
}
elsif ($strVersion ge '1.00')
{
if ($iStableReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'supported'});
$oSection->nodeAdd('title')->textSet("Stable Releases");
}
$iStableReleaseTotal++;
$bTOC = false;
}
else
{
if ($iUnsupportedReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'unsupported'});
$oSection->nodeAdd('title')->textSet("Pre-Stable Releases");
}
$iUnsupportedReleaseTotal++;
$bTOC = false;
}
# Format the date
my $strDate = $oRelease->paramGet('date');
my $strDateOut = "";
my @stryMonth = ('January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December');
if ($strDate =~ /^X/)
{
$strDateOut .= 'No Release Date Set';
}
else
{
if ($strDate !~ /^(XXXX-XX-XX)|([0-9]{4}-[0-9]{2}-[0-9]{2})$/)
{
confess &log(ASSERT, "invalid date ${strDate} for release {$strVersion}");
}
$strDateOut .= 'Released ' . $stryMonth[(substr($strDate, 5, 2) - 1)] . ' ' .
(substr($strDate, 8, 2) + 0) . ', ' . substr($strDate, 0, 4);
}
# Add section and titles
my $oReleaseSection = $oSection->nodeAdd('section', undef, {id => $strVersion, toc => !$bTOC ? 'n' : undef});
$oReleaseSection->paramSet(XML_SECTION_PARAM_ANCHOR, XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT);
$oReleaseSection->nodeAdd('title')->textSet(
"v${strVersion} " . ($bReleaseDev ? '' : 'Release ') . 'Notes');
$oReleaseSection->nodeAdd('subtitle')->textSet($oRelease->paramGet('title'));
$oReleaseSection->nodeAdd('subsubtitle')->textSet($strDateOut);
# Add release sections
my $bAdditionalNotes = false;
my $bReleaseNote = false;
my $hSectionType =
{
&XML_RELEASE_CORE_LIST => {title => 'Core', type => 'core'},
&XML_RELEASE_DOC_LIST => {title => 'Documentation', type => 'doc'},
&XML_RELEASE_TEST_LIST => {title => 'Test Suite', type => 'test'},
};
foreach my $strSectionType (XML_RELEASE_CORE_LIST, XML_RELEASE_DOC_LIST, XML_RELEASE_TEST_LIST)
{
if ($oRelease->nodeTest($strSectionType))
{
# Add release item types
my $hItemType =
{
&XML_RELEASE_BUG_LIST => {title => 'Bug Fixes', type => 'bug'},
&XML_RELEASE_FEATURE_LIST => {title => 'Features', type => 'feature'},
&XML_RELEASE_IMPROVEMENT_LIST => {title => 'Improvements', type => 'improvement'},
&XML_RELEASE_DEVELOPMENT_LIST => {title => 'Development', type => 'development'},
};
foreach my $strItemType (
XML_RELEASE_BUG_LIST, XML_RELEASE_FEATURE_LIST, XML_RELEASE_IMPROVEMENT_LIST, XML_RELEASE_DEVELOPMENT_LIST)
{
next if (!$self->{bDev} && $strItemType eq XML_RELEASE_DEVELOPMENT_LIST);
if ($oRelease->nodeGet($strSectionType)->nodeTest($strItemType))
{
if ($strSectionType ne XML_RELEASE_CORE_LIST && !$bAdditionalNotes)
{
$oReleaseSection->nodeAdd('subtitle')->textSet('Additional Notes');
$bAdditionalNotes = true;
}
# Add release note if present
if (!$bReleaseNote && $oRelease->nodeGet($strSectionType)->nodeTest('p'))
{
$oReleaseSection->nodeAdd('p')->textSet($oRelease->nodeGet($strSectionType)->nodeGet('p')->textGet());
$bReleaseNote = true;
}
my $strTypeText =
($strSectionType eq XML_RELEASE_CORE_LIST ? '' : $$hSectionType{$strSectionType}{title}) . ' ' .
$$hItemType{$strItemType}{title} . ':';
$oReleaseSection->
nodeAdd('p')->textSet(
{name => 'text', children=> [{name => 'b', value => $strTypeText}]});
my $oList = $oReleaseSection->nodeAdd('list');
# Add release items
foreach my $oReleaseFeature ($oRelease->nodeGet($strSectionType)->
nodeGet($strItemType)->nodeList('release-item'))
{
my @rhyReleaseItemP = $oReleaseFeature->nodeList('p');
my $oReleaseItemText = $rhyReleaseItemP[0]->textGet();
# Check release item commits
if ($bReleaseCheckCommit && $strItemType ne XML_RELEASE_DEVELOPMENT_LIST)
{
my @oyCommit = $oReleaseFeature->nodeList('commit', false);
# If no commits found then try to use the description as the commit subject
if (@oyCommit == 0)
{
my $strSubject = $oRender->processText($oReleaseItemText);
my $rhCommit = $self->commitFindSubject(\@rhyReleaseCommit, $strSubject, false);
if (!defined($rhCommit))
{
$self->commitError(
"unable to find commit or no subject match for release ${strVersion} item" .
" '${strSubject}'",
\@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
my $strCommit = $rhCommit->{commit};
@stryReleaseCommitRemaining = grep(!/$strCommit/, @stryReleaseCommitRemaining);
}
}
# Check the rest of the commits to ensure they exist
foreach my $oCommit (@oyCommit)
{
my $strSubject = $oCommit->paramGet('subject');
my $rhCommit = $self->commitFindSubject(\@rhyReleaseCommit, $strSubject, false);
if (defined($rhCommit))
{
my $strCommit = $rhCommit->{commit};
@stryReleaseCommitRemaining = grep(!/$strCommit/, @stryReleaseCommitRemaining);
}
else
{
$self->commitError(
"unable to find release ${strVersion} commit subject '${strSubject}' in list",
\@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
}
}
}
# Append the rest of the text
if (@rhyReleaseItemP > 1)
{
shift(@rhyReleaseItemP);
push(@{$oReleaseItemText->{oDoc}{children}}, ' ');
foreach my $rhReleaseItemP (@rhyReleaseItemP)
{
push(@{$oReleaseItemText->{oDoc}{children}}, @{$rhReleaseItemP->textGet()->{oDoc}{children}});
}
}
# Append contributor info
my $strContributorText = $self->contributorTextGet($oReleaseFeature, $$hItemType{$strItemType}{type});
if (defined($strContributorText))
{
push(@{$oReleaseItemText->{oDoc}{children}}, ' (');
push(@{$oReleaseItemText->{oDoc}{children}},
{name => 'i', value => $strContributorText});
push(@{$oReleaseItemText->{oDoc}{children}}, ')');
}
# Add the list item
$oList->nodeAdd('list-item')->textSet($oReleaseItemText);
}
}
}
}
}
# Error if there are commits left over
# if ($bReleaseCheckCommit && @stryReleaseCommitRemaining != 0)
# {
# $self->commitError(
# "unassigned commits for release ${strVersion}", \@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
# }
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc}
);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Html/ 0000775 0000000 0000000 00000000000 13625315071 0021552 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Html/DocHtmlBuilder.pm 0000664 0000000 0000000 00000022667 13625315071 0024766 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML BUILDER MODULE
####################################################################################################################################
package BackRestDoc::Html::DocHtmlBuilder;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use BackRestDoc::Html::DocHtmlElement;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strName},
$self->{strTitle},
$self->{strFavicon},
$self->{strLogo},
$self->{strDescription},
$self->{bPretty},
$self->{bCompact},
$self->{strCss},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strName'},
{name => 'strTitle'},
{name => 'strFavicon', required => false},
{name => 'strLogo', required => false},
{name => 'strDescription', required => false},
{name => 'bPretty', default => false},
{name => 'bCompact', default => false},
{name => 'strCss', required => false},
);
$self->{oBody} = new BackRestDoc::Html::DocHtmlElement(HTML_BODY);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# indent
#
# Indent html
####################################################################################################################################
sub indent
{
my $self = shift;
my $iDepth = shift;
return $self->{bPretty} ? (' ' x $iDepth) : '';
}
####################################################################################################################################
# lf
#
# Add a linefeed.
####################################################################################################################################
sub lf
{
my $self = shift;
return $self->{bPretty} ? "\n" : '';
}
####################################################################################################################################
# bodyGet
#
# Get the body element.
####################################################################################################################################
sub bodyGet
{
my $self = shift;
return $self->{oBody};
}
####################################################################################################################################
# htmlRender
#
# Render each html element.
####################################################################################################################################
sub htmlRender
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my (
$strOperation,
$oElement,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->htmlRender', \@_,
{name => 'oElement', trace => true},
{name => 'iDepth', trace => true}
);
# Build the header
my $strHtml =
$self->indent($iDepth) . "<$oElement->{strType}" .
(defined($oElement->{strClass}) ? " class=\"$oElement->{strClass}\"": '') .
(defined($oElement->{strRef}) ? " href=\"$oElement->{strRef}\"": '') .
(defined($oElement->{strId}) ? " id=\"$oElement->{strId}\"": '') .
(defined($oElement->{strExtra}) ? " $oElement->{strExtra}": '') . '>';
if (defined($oElement->{strContent}))
{
if (!defined($oElement->{bPre}) || !$oElement->{bPre})
{
$oElement->{strContent} =~ s/\n/\' . $self->escape($self->{strTitle}) . ' ' . $self->lf() .
$self->indent(1) . "${strHostName} ⇒ " .
$self->processText($oChild->nodeGet('title')->textGet())});
$oExecuteBodyElement = $oSectionBodyExecute->addNew(HTML_DIV, "execute-body");
}
foreach my $oExecute ($oChild->nodeList('execute'))
{
my $bExeShow = !$oExecute->paramTest('show', 'n');
my $bExeExpectedError = defined($oExecute->paramGet('err-expect', false));
my ($strCommand, $strOutput) = $self->execute(
$oSection, $strHostName, $oExecute, {iIndent => $iDepth + 3, bShow => $bShow && $bExeShow});
if ($bShow && $bExeShow)
{
# Add continuation chars and proper spacing
$strCommand =~ s/\n/\n /smg;
$oExecuteBodyElement->
addNew(HTML_PRE, "execute-body-cmd",
{strContent => $strCommand, bPre => true});
my $strHighLight = $self->{oManifest}->variableReplace($oExecute->fieldGet('exe-highlight', false));
my $bHighLightFound = false;
if (defined($strOutput))
{
my $bHighLightOld;
my $strHighLightOutput;
if ($oExecute->fieldTest('exe-highlight-type', 'error'))
{
$bExeExpectedError = true;
}
foreach my $strLine (split("\n", $strOutput))
{
my $bHighLight = defined($strHighLight) && $strLine =~ /$strHighLight/;
if (defined($bHighLightOld) && $bHighLight != $bHighLightOld)
{
$oExecuteBodyElement->
addNew(HTML_PRE, 'execute-body-output' .
($bHighLightOld ? '-highlight' . ($bExeExpectedError ? '-error' : '') : ''),
{strContent => $strHighLightOutput, bPre => true});
undef($strHighLightOutput);
}
$strHighLightOutput .= (defined($strHighLightOutput) ? "\n" : '') . $strLine;
$bHighLightOld = $bHighLight;
$bHighLightFound = $bHighLightFound ? true : $bHighLight ? true : false;
}
if (defined($bHighLightOld))
{
$oExecuteBodyElement->
addNew(HTML_PRE, 'execute-body-output' .
($bHighLightOld ? '-highlight' . ($bExeExpectedError ? '-error' : '') : ''),
{strContent => $strHighLightOutput, bPre => true});
}
$bFirst = true;
}
if ($self->{bExe} && $self->isRequired($oSection) && defined($strHighLight) && !$bHighLightFound)
{
confess &log(ERROR, "unable to find a match for highlight: ${strHighLight}");
}
}
$bFirst = false;
}
}
# Add code block
elsif ($oChild->nameGet() eq 'code-block')
{
my $strValue = $oChild->valueGet();
# Trim linefeeds from the beginning and all whitespace from the end
$strValue =~ s/^\n+|\s+$//g;
# Find the line with the fewest leading spaces
my $iSpaceMin = undef;
foreach my $strLine (split("\n", $strValue))
{
$strLine =~ s/\s+$//;
my $iSpaceMinTemp = length($strLine) - length(trim($strLine));
if (!defined($iSpaceMin) || $iSpaceMinTemp < $iSpaceMin)
{
$iSpaceMin = $iSpaceMinTemp;
}
}
# Replace the leading spaces
$strValue =~ s/^( ){$iSpaceMin}//smg;
$oSectionBodyElement->addNew(
HTML_PRE, 'code-block', {strContent => $strValue, bPre => true});
}
# Add table
elsif ($oChild->nameGet() eq 'table')
{
my $oTableTitle;
if ($oChild->nodeTest('title'))
{
$oTableTitle = $oChild->nodeGet('title');
}
my $oTableElement = $oSectionBodyElement->addNew(HTML_TABLE, 'table');
my @oyColumn;
# If there is a title element then add it as the caption for the table
if (defined($oTableTitle))
{
# Print the label (e.g. Table 1:) in front of the title if one exists
my $strTableTitle = $oTableTitle->paramTest('label') ?
($oTableTitle->paramGet('label') . ': '. $self->processText($oTableTitle->textGet())) :
$self->processText($oTableTitle->textGet());
$oTableElement->addNew(HTML_TABLE_CAPTION, 'table-caption', {strContent => $strTableTitle});
}
# Build the header
if ($oChild->nodeTest('table-header'))
{
my $oHeader = $oChild->nodeGet('table-header');
@oyColumn = $oHeader->nodeList('table-column');
my $oHeaderRowElement = $oTableElement->addNew(HTML_TR, 'table-header-row');
foreach my $oColumn (@oyColumn)
{
# Each column can have different alignment properties - if not set, then default to align left
my $strAlign = $oColumn->paramGet("align", false, 'left');
my $bFill = $oColumn->paramTest('fill', 'y');
$oHeaderRowElement->addNew(
HTML_TH,
"table-header-${strAlign}" . ($bFill ? " table-header-fill" : ""),
{strContent => $self->processText($oColumn->textGet())});
}
}
# Build the rows
foreach my $oRow ($oChild->nodeGet('table-data')->nodeList('table-row'))
{
my $oRowElement = $oTableElement->addNew(HTML_TR, 'table-row');
my @oRowCellList = $oRow->nodeList('table-cell');
for (my $iRowCellIdx = 0; $iRowCellIdx < @oRowCellList; $iRowCellIdx++)
{
my $oRowCell = $oRowCellList[$iRowCellIdx];
# If a header row was defined, then get the column alignment, else default to left
my $strAlign = @oyColumn > 0 ? $oyColumn[$iRowCellIdx]->paramGet("align", false, 'left') : 'left';
$oRowElement->addNew(
HTML_TD, "table-data-${strAlign}", {strContent => $self->processText($oRowCell->textGet())});
}
}
}
# Add descriptive text
elsif ($oChild->nameGet() eq 'p')
{
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oChild->textGet())});
}
# Add option descriptive text
elsif ($oChild->nameGet() eq 'option-description')
{
my $strOption = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strOption} option in sections - try adding option?");
}
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oDescription)});
}
# Add cmd descriptive text
elsif ($oChild->nameGet() eq 'cmd-description')
{
my $strCommand = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strCommand} command in sections - try adding command?");
}
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oDescription)});
}
# Add/remove backrest config options
elsif ($oChild->nameGet() eq 'backrest-config')
{
my $oConfigElement = $self->backrestConfigProcess($oSection, $oChild, $iDepth + 3);
if (defined($oConfigElement))
{
$oSectionBodyElement->add($oConfigElement);
}
}
# Add/remove postgres config options
elsif ($oChild->nameGet() eq 'postgres-config')
{
my $oConfigElement = $self->postgresConfigProcess($oSection, $oChild, $iDepth + 3);
if (defined($oConfigElement))
{
$oSectionBodyElement->add($oConfigElement);
}
}
# Add a list
elsif ($oChild->nameGet() eq 'list')
{
my $oList = $oSectionBodyElement->addNew(HTML_UL, 'list-unordered');
foreach my $oListItem ($oChild->nodeList())
{
$oList->addNew(HTML_LI, 'list-unordered', {strContent => $self->processText($oListItem->textGet())});
}
}
# Add a subtitle
elsif ($oChild->nameGet() eq 'subtitle')
{
$oSectionBodyElement->
addNew(HTML_DIV, "section${iDepth}-subtitle",
{strContent => $self->processText($oChild->textGet())});
}
# Add a subsubtitle
elsif ($oChild->nameGet() eq 'subsubtitle')
{
$oSectionBodyElement->
addNew(HTML_DIV, "section${iDepth}-subsubtitle",
{strContent => $self->processText($oChild->textGet())});
}
# Add a subsection
elsif ($oChild->nameGet() eq 'section')
{
my ($oChildSectionElement, $oChildSectionTocElement) =
$self->sectionProcess($oChild, $strAnchor, "${strSectionNo}.${iSectionNo}", $iDepth + 1);
$oSectionBodyElement->add($oChildSectionElement);
if (defined($oChildSectionTocElement))
{
$oSectionTocElement->add($oChildSectionTocElement);
}
$iSectionNo++;
}
# Add an admonition (e.g. NOTE, WARNING, etc)
elsif ($oChild->nameGet() eq 'admonition')
{
my $oAdmonition = $oSectionBodyElement->addNew(HTML_DIV, 'admonition');
$oAdmonition->addNew(HTML_DIV, $oChild->paramGet('type'), {strContent => uc($oChild->paramGet('type')) . ": "});
$oAdmonition->addNew(HTML_DIV, $oChild->paramGet('type') . '-text',
{strContent => $self->processText($oChild->textGet())});
}
# Check if the child can be processed by a parent
else
{
$self->sectionChildProcess($oSection, $oChild, $iDepth + 1);
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oSectionElement', value => $oSectionElement, trace => true},
{name => 'oSectionTocElement', value => $oSection->paramTest('toc', 'n') ? undef : $oSectionTocElement, trace => true}
);
}
####################################################################################################################################
# backrestConfigProcess
####################################################################################################################################
sub backrestConfigProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->backrestConfigProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Generate the config
my $oConfigElement;
my ($strFile, $strConfig, $bShow) = $self->backrestConfig($oSection, $oConfig, $iDepth);
if ($bShow)
{
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# Render the config
$oConfigElement = new BackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
$oConfigElement->
addNew(HTML_DIV, "config-title",
{strContent => "${strHostName} :${strFile} " .
" ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-title",
# {strContent => "${strFile}:"});
$oConfigBodyElement->
addNew(HTML_DIV, "config-body-output",
{strContent => $strConfig});
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oConfigElement', value => $oConfigElement, trace => true}
);
}
####################################################################################################################################
# postgresConfigProcess
####################################################################################################################################
sub postgresConfigProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->postgresConfigProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Generate the config
my $oConfigElement;
my ($strFile, $strConfig, $bShow) = $self->postgresConfig($oSection, $oConfig, $iDepth);
if ($bShow)
{
# Render the config
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
$oConfigElement = new BackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
$oConfigElement->
addNew(HTML_DIV, "config-title",
{strContent => "${strHostName} :${strFile} " .
" ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-title",
# {strContent => "append to ${strFile}:"});
$oConfigBodyElement->
addNew(HTML_DIV, "config-body-output",
{strContent => defined($strConfig) ? $strConfig : ''});
$oConfig->fieldSet('actual-config', $strConfig);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oConfigElement', value => $oConfigElement, trace => true}
);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Html/DocHtmlSite.pm 0000664 0000000 0000000 00000013012 13625315071 0024264 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML SITE MODULE
####################################################################################################################################
package BackRestDoc::Html::DocHtmlSite;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRest::Common::Exception;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestTest::Common::ExecuteTest;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
use BackRestDoc::Html::DocHtmlPage;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strHtmlPath},
$self->{strCssFile},
$self->{strFaviconFile},
$self->{strProjectLogoFile},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strHtmlPath'},
{name => 'strCssFile'},
{name => 'strFaviconFile', required => false},
{name => 'strProjectLogoFile', required => false},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Get render options
my $oRender = $self->{oManifest}->renderGet(RENDER_TYPE_HTML);
my $bMenu = $$oRender{&RENDER_MENU};
my $bPretty = $$oRender{&RENDER_PRETTY};
my $bCompact = $$oRender{&RENDER_COMPACT};
if (!$bCompact)
{
# Copy the css file
my $strCssFileDestination = "$self->{strHtmlPath}/default.css";
copy($self->{strCssFile}, $strCssFileDestination)
or confess &log(ERROR, "unable to copy $self->{strCssFile} to ${strCssFileDestination}");
# Copy the favicon file
if (defined($self->{strFaviconFile}))
{
my $strFaviconFileDestination = "$self->{strHtmlPath}/" . $self->{oManifest}->variableGet('project-favicon');
copy($self->{strFaviconFile}, $strFaviconFileDestination)
or confess &log(ERROR, "unable to copy $self->{strFaviconFile} to ${strFaviconFileDestination}");
}
# Copy the project logo file
if (defined($self->{strProjectLogoFile}))
{
my $strProjectLogoFileDestination = "$self->{strHtmlPath}/" . $self->{oManifest}->variableGet('project-logo');
copy($self->{strProjectLogoFile}, $strProjectLogoFileDestination)
or confess &log(ERROR, "unable to copy $self->{strProjectLogoFile} to ${strProjectLogoFileDestination}");
}
}
foreach my $strPageId ($self->{oManifest}->renderOutList(RENDER_TYPE_HTML))
{
&log(INFO, " render out: ${strPageId}");
my $strHtml;
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
eval
{
$strHtml = $self->{oManifest}->variableReplace(
new BackRestDoc::Html::DocHtmlPage(
$self->{oManifest}, $strPageId, $bMenu, $self->{bExe}, $bCompact,
${$self->{oManifest}->storage()->get($self->{strCssFile})}, $bPretty)->process());
return true;
}
or do
{
my $oException = $@;
if (exceptionCode($oException) == ERROR_FILE_INVALID)
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
$self->{oManifest}->cacheReset($$oRenderOut{source});
$strHtml = $self->{oManifest}->variableReplace(
new BackRestDoc::Html::DocHtmlPage(
$self->{oManifest}, $strPageId, $bMenu, $self->{bExe}, $bCompact,
${$self->{oManifest}->storage()->get($self->{strCssFile})}, $bPretty)->process());
}
else
{
confess $oException;
}
};
# Save the html page
my $strFile = "$self->{strHtmlPath}/" . (defined($$oRenderOut{file}) ? $$oRenderOut{file} : "${strPageId}.html");
$self->{oManifest}->storage()->put($strFile, $strHtml);
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Latex/ 0000775 0000000 0000000 00000000000 13625315071 0021723 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Latex/DocLatex.pm 0000664 0000000 0000000 00000013642 13625315071 0023772 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC LATEX MODULE
####################################################################################################################################
package BackRestDoc::Latex::DocLatex;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname basename);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRest::Common::Exception;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestTest::Common::ExecuteTest;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
use BackRestDoc::Latex::DocLatexSection;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strLatexPath},
$self->{strPreambleFile},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strLatexPath'},
{name => 'strPreambleFile'},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
my $oRender = $self->{oManifest}->renderGet(RENDER_TYPE_PDF);
my $strLogo = $self->{oManifest}->variableGet('pdf-resource-logo');
if (!defined($strLogo))
{
$strLogo = 'blank.eps';
}
my ($strExt) = $strLogo =~ /(\.[^.]+)$/;
my $strLogoPath = defined($self->{oManifest}->variableGet('pdf-resource-path')) ?
$self->{oManifest}->variableGet('pdf-resource-path') :
"$self->{oManifest}{strDocPath}/resource/latex/";
# Copy the logo
copy($strLogoPath . $strLogo, "$self->{strLatexPath}/logo$strExt")
or confess &log(ERROR, "unable to copy logo");
my $strLatex = $self->{oManifest}->variableReplace(
${$self->{oManifest}->storage()->get($self->{strPreambleFile})}, 'latex') . "\n";
# ??? Temp hack for underscores in filename
$strLatex =~ s/pgaudit\\\_doc/pgaudit\_doc/g;
# Process the sources in the order listed in the manifest.xml
foreach my $strPageId (@{${$self->{oManifest}->renderGet(RENDER_TYPE_PDF)}{stryOrder}})
{
&log(INFO, " render out: ${strPageId}");
eval
{
my $oDocLatexSection =
new BackRestDoc::Latex::DocLatexSection($self->{oManifest}, $strPageId, $self->{bExe});
# Save the html page
$strLatex .= $oDocLatexSection->process();
return true;
}
or do
{
my $oException = $EVAL_ERROR;
if (exceptionCode($oException) == ERROR_FILE_INVALID)
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
$self->{oManifest}->cacheReset($$oRenderOut{source});
my $oDocLatexSection =
new BackRestDoc::Latex::DocLatexSection($self->{oManifest}, $strPageId, $self->{bExe});
# Save the html page
$strLatex .= $oDocLatexSection->process();
}
else
{
confess $oException;
}
};
}
$strLatex .= "\n% " . ('-' x 130) . "\n% End document\n% " . ('-' x 130) . "\n\\end{document}\n";
# Get base name of output file to use for processing
(my $strLatexFileBase = basename($$oRender{file})) =~ s/\.[^.]+$//;
$strLatexFileBase = $self->{oManifest}->variableReplace($strLatexFileBase);
# Name of latex file to use for output and processing
my $strLatexFileName = $self->{oManifest}->variableReplace("$self->{strLatexPath}/" . $strLatexFileBase . '.tex');
# Output latex and build PDF
$self->{oManifest}->storage()->put($strLatexFileName, $strLatex);
executeTest("pdflatex -output-directory=$self->{strLatexPath} -shell-escape $strLatexFileName",
{bSuppressStdErr => true});
executeTest("pdflatex -output-directory=$self->{strLatexPath} -shell-escape $strLatexFileName",
{bSuppressStdErr => true});
# Determine path of output file
my $strLatexOutputName = $oRender->{file};
if ($strLatexOutputName !~ /^\//)
{
$strLatexOutputName = abs_path($self->{strLatexPath} . "/" . $oRender->{file});
}
# Copy pdf file if is is not already in the correct place
if ($strLatexOutputName ne "$self->{strLatexPath}/" . $strLatexFileBase . '.pdf')
{
copy("$self->{strLatexPath}/" . $strLatexFileBase . '.pdf', $strLatexOutputName)
or confess &log(ERROR, "unable to copy pdf to " . $strLatexOutputName);
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Latex/DocLatexSection.pm 0000664 0000000 0000000 00000037325 13625315071 0025323 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC LATEX SECTION MODULE
####################################################################################################################################
package BackRestDoc::Latex::DocLatexSection;
use parent 'BackRestDoc::Common::DocExecute';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new('latex', $oManifest, $strRenderOutKey, $bExe);
bless $self, $class;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Working variables
my $oPage = $self->{oDoc};
my $strLatex;
# Initialize page
my $strTitle = $oPage->paramGet('title');
my $strSubTitle = $oPage->paramGet('subtitle', false);
# Render sections
foreach my $oSection ($oPage->nodeList('section'))
{
$strLatex .= (defined($strLatex) ? "\n" : '') . $self->sectionProcess($oSection, undef, 1);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strHtml', value => $strLatex, trace => true}
);
}
####################################################################################################################################
# sectionProcess
####################################################################################################################################
sub sectionProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$strSection,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionRender', \@_,
{name => 'oSection'},
{name => 'strSection', required => false},
{name => 'iDepth'}
);
if ($oSection->paramGet('log'))
{
&log(INFO, (' ' x ($iDepth + 1)) . 'process section: ' . $oSection->paramGet('path'));
}
# Create section type
my $strSectionTitle = $self->processText($oSection->nodeGet('title')->textGet());
$strSection .= (defined($strSection) ? ', ' : '') . "'${strSectionTitle}' " . ('Sub' x ($iDepth - 1)) . "Section";
# Create section comment
my $strLatex =
"% ${strSection}\n% " . ('-' x 130) . "\n";
# Exclude from table of contents if requested
if ($iDepth <= 3 && $oSection->paramTest('toc', 'n'))
{
$strLatex .= '\\addtocontents{toc}{\\protect\\setcounter{tocdepth}{' . ($iDepth - 1) . "}}\n";
}
# Create section name
$strLatex .= '\\';
if ($iDepth <= 3)
{
$strLatex .= ($iDepth > 1 ? ('sub' x ($iDepth - 1)) : '') . "section";
}
elsif ($iDepth == 4)
{
$strLatex .= 'paragraph';
}
else
{
confess &log(ASSERT, "section depth of ${iDepth} exceeds maximum");
}
$strLatex .= "\{${strSectionTitle}\}\\label{" . $oSection->paramGet('path', false) . "}\n";
# Reset table of contents numbering if the section was excluded
if ($iDepth <= 3 && $oSection->paramTest('toc', 'n'))
{
$strLatex .= '\\addtocontents{toc}{\\protect\\setcounter{tocdepth}{' . $iDepth . "}}\n";
}
foreach my $oChild ($oSection->nodeList())
{
&log(DEBUG, (' ' x ($iDepth + 2)) . 'process child ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'execute-list')
{
my $bShow = $oChild->paramTest('show', 'n') ? false : true;
my $strHostName = $self->{oManifest}->variableReplace($oChild->paramGet('host'));
if ($bShow)
{
$strLatex .=
"\n\\begin\{lstlisting\}[title=\{\\textnormal{\\textbf\{${strHostName}}} --- " .
$self->processText($oChild->nodeGet('title')->textGet()) . "}]\n";
}
foreach my $oExecute ($oChild->nodeList('execute'))
{
my $bExeShow = !$oExecute->paramTest('show', 'n');
my ($strCommand, $strOutput) = $self->execute(
$oSection, $self->{oManifest}->variableReplace($oChild->paramGet('host')), $oExecute,
{iIndent => $iDepth + 3, bShow => $bShow && $bExeShow});
if ($bShow && $bExeShow)
{
$strLatex .= "${strCommand}\n";
if (defined($strOutput))
{
$strLatex .= "\nOutput:\n\n${strOutput}\n";
}
}
}
if ($bShow)
{
$strLatex .=
"\\end{lstlisting}\n";
}
}
# Add code block
elsif ($oChild->nameGet() eq 'code-block')
{
my $strTitle = $self->{oManifest}->variableReplace($oChild->paramGet("title", false), 'latex');
if (defined($strTitle) && $strTitle eq '')
{
undef($strTitle)
}
# Begin the code listing
if (!defined($strTitle))
{
$strLatex .=
"\\vspace{.75em}\n";
}
$strLatex .=
"\\begin\{lstlisting\}";
# Add the title if one is provided
if (defined($strTitle))
{
$strLatex .= "[title=\{${strTitle}:\}]";
}
# End the code listing
$strLatex .=
"\n" .
trim($oChild->valueGet()) . "\n" .
"\\end{lstlisting}\n";
}
# Add table
elsif ($oChild->nameGet() eq 'table')
{
my $oHeader;
my @oyColumn;
if ($oChild->nodeTest('table-header'))
{
$oHeader = $oChild->nodeGet('table-header');
@oyColumn = $oHeader->nodeList('table-column');
}
my $strWidth =
'{' . (defined($oHeader) && $oHeader->paramTest('width') ? ($oHeader->paramGet('width') / 100) .
'\textwidth' : '\textwidth') . '}';
# Build the table
$strLatex .= "\\vspace{1em}\\newline\n\\begin{table}\n\\begin{tabularx}${strWidth}{|";
# Build the table header
foreach my $oColumn (@oyColumn)
{
my $strAlignCode;
my $strAlign = $oColumn->paramGet("align", false);
# If fill is specified then use X or the custom designed alignments in the preamble to fill and justify the columns.
if ($oColumn->paramTest('fill') && $oColumn->paramGet('fill', false) eq 'y')
{
if (!defined($strAlign) || $strAlign eq 'left')
{
$strAlignCode = 'X';
}
elsif ($strAlign eq 'right')
{
$strAlignCode = 'R';
}
elsif ($strAlign eq 'center')
{
$strAlignCode = 'C';
}
else
{
confess &log(ERROR, "align '${strAlign}' not valid when fill=y");
}
}
else
{
if (!defined($strAlign) || $strAlign eq 'left')
{
$strAlignCode = 'l';
}
elsif ($strAlign eq 'center')
{
$strAlignCode = 'c';
}
elsif ($strAlign eq 'right')
{
$strAlignCode = 'r';
}
else
{
confess &log(ERROR, "align '${strAlign}' not valid");
}
}
# $strLatex .= 'p{' . $oColumn->paramGet("width") . '} | ';
$strLatex .= $strAlignCode . ' | ';
}
# If table-header not provided then default the column alignment and fill by using the number of columns in the 1st row
if (!defined($oHeader))
{
my @oyRow = $oChild->nodeGet('table-data')->nodeList('table-row');
foreach my $oRowCell ($oyRow[0]->nodeList('table-cell'))
{
$strLatex .= 'X|';
}
}
$strLatex .= "}\n";
my $strLine;
if (defined($oHeader))
{
$strLatex .= "\\hline";
$strLatex .= "\\rowcolor{ltgray}\n";
foreach my $oColumn (@oyColumn)
{
$strLine .= (defined($strLine) ? ' & ' : '') . '\textbf{' . $self->processText($oColumn->textGet()) . '}';
}
$strLatex .= "${strLine}\\\\";
}
# Build the rows
foreach my $oRow ($oChild->nodeGet('table-data')->nodeList('table-row'))
{
$strLatex .= "\\hline\n";
undef($strLine);
foreach my $oRowCell ($oRow->nodeList('table-cell'))
{
$strLine .= (defined($strLine) ? ' & ' : '') . $self->processText($oRowCell->textGet());
}
$strLatex .= "${strLine}\\\\";
}
$strLatex .= "\\hline\n\\end{tabularx}\n";
# If there is a title for the table, add it. Ignore the label since LaTex will automatically generate numbered labels.
# e.g. Table 1:
if ($oChild->nodeGet("title", false))
{
$strLatex .= "\\caption{" . $self->processText($oChild->nodeGet("title")->textGet()) . "}\n";
}
$strLatex .= "\\end{table}\n";
}
# Add descriptive text
elsif ($oChild->nameGet() eq 'p')
{
$strLatex .= "\n" . $self->processText($oChild->textGet()) . "\n";
}
# Add option descriptive text
elsif ($oChild->nameGet() eq 'option-description')
{
my $strOption = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strOption} option in sections - try adding option?");
}
$strLatex .= "\n" . $self->processText($oDescription) . "\n";
}
# Add cmd descriptive text
elsif ($oChild->nameGet() eq 'cmd-description')
{
my $strCommand = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strCommand} command in sections - try adding command?");
}
$strLatex .= "\n" . $self->processText($oDescription) . "\n";
}
# Add a list
elsif ($oChild->nameGet() eq 'list')
{
$strLatex .= "\n\\begin{itemize}";
foreach my $oListItem ($oChild->nodeList())
{
$strLatex .= "\n \\item " . $self->processText($oListItem->textGet());
}
$strLatex .= "\n\\end{itemize}";
}
# Add/remove config options
elsif ($oChild->nameGet() eq 'backrest-config' || $oChild->nameGet() eq 'postgres-config')
{
$strLatex .= $self->configProcess($oSection, $oChild, $iDepth + 3);
}
# Add a subsection
elsif ($oChild->nameGet() eq 'section')
{
$strLatex .= "\n" . $self->sectionProcess($oChild, $strSection, $iDepth + 1);
}
# Add an admonition (e.g. NOTE, WARNING, etc)
elsif ($oChild->nameGet() eq 'admonition')
{
$strLatex .= "\n\\begin{leftbar}";
$strLatex .= "\n\\textit{\\textbf{" . uc($oChild->paramGet('type')) . ": }";
$strLatex .= $self->processText($oChild->textGet()) . "}";
$strLatex .= "\n\\end{leftbar}\n";
}
# Check if the child can be processed by a parent
else
{
$self->sectionChildProcess($oSection, $oChild, $iDepth + 1);
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strSection', value => $strLatex, trace => true}
);
}
####################################################################################################################################
# configProcess
####################################################################################################################################
sub configProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->configProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $strLatex = '';
my $strFile;
my $strConfig;
my $bShow = true;
# Generate the config
if ($oConfig->nameGet() eq 'backrest-config')
{
($strFile, $strConfig, $bShow) = $self->backrestConfig($oSection, $oConfig, $iDepth);
}
else
{
($strFile, $strConfig, $bShow) = $self->postgresConfig($oSection, $oConfig, $iDepth);
}
if ($bShow)
{
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# Replace _ in filename
$strFile = $self->variableReplace($strFile);
# Render the config
$strLatex =
"\n\\begin\{lstlisting\}[title=\{\\textnormal{\\textbf\{${strHostName}}}:\\textnormal{\\texttt\{${strFile}}} --- " .
$self->processText($oConfig->nodeGet('title')->textGet()) . "}]\n" .
(defined($strConfig) ? $strConfig : '') .
"\\end{lstlisting}\n";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strConfig', value => $strLatex, trace => true}
);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Markdown/ 0000775 0000000 0000000 00000000000 13625315071 0022430 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/lib/BackRestDoc/Markdown/DocMarkdown.pm 0000664 0000000 0000000 00000005772 13625315071 0025211 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MARKDOWN MODULE
####################################################################################################################################
package BackRestDoc::Markdown::DocMarkdown;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestTest::Common::ExecuteTest;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
use BackRestDoc::Markdown::DocMarkdownRender;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strMarkdownPath},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strMarkdownPath'},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
foreach my $strRenderOutId ($self->{oManifest}->renderOutList(RENDER_TYPE_MARKDOWN))
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_MARKDOWN, $strRenderOutId);
my $strFile = "$self->{strMarkdownPath}/" . (defined($$oRenderOut{file}) ? $$oRenderOut{file} : "${strRenderOutId}.md");
&log(INFO, " render out: ${strRenderOutId}");
# Save the html page
$self->{oManifest}->storage()->put(
$strFile, $self->{oManifest}->variableReplace((new BackRestDoc::Markdown::DocMarkdownRender($self->{oManifest},
$strRenderOutId, $self->{bExe}))->process()));
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.24/doc/lib/BackRestDoc/Markdown/DocMarkdownRender.pm 0000664 0000000 0000000 00000047300 13625315071 0026342 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MARKDOWN RENDER MODULE
####################################################################################################################################
package BackRestDoc::Markdown::DocMarkdownRender;
use parent 'BackRestDoc::Common::DocExecute';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use Storable qw(dclone);
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new(RENDER_TYPE_MARKDOWN, $oManifest, $strRenderOutKey, $bExe);
bless $self, $class;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Working variables
my $oPage = $self->{oDoc};
# Initialize page
my $strMarkdown = "# " . $oPage->paramGet('title');
if (defined($oPage->paramGet('subtitle', false)))
{
$strMarkdown .= ' ${strHostName} :${strFile} " .
# " ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
#
# my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
# #
# # $oConfigBodyElement->
# # addNew(HTML_DIV, "config-body-title",
# # {strContent => "${strFile}:"});
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-output",
# {strContent => $strConfig});
# }
#
# # Return from function and log return values if any
# return logDebugReturn
# (
# $strOperation,
# {name => 'oConfigElement', value => $oConfigElement, trace => true}
# );
}
####################################################################################################################################
# postgresConfigProcess
####################################################################################################################################
sub postgresConfigProcess
{
my $self = shift;
# # Assign function parameters, defaults, and log debug info
# my
# (
# $strOperation,
# $oSection,
# $oConfig,
# $iDepth
# ) =
# logDebugParam
# (
# __PACKAGE__ . '->postgresConfigProcess', \@_,
# {name => 'oSection'},
# {name => 'oConfig'},
# {name => 'iDepth'}
# );
#
# # Generate the config
# my $oConfigElement;
# my ($strFile, $strConfig, $bShow) = $self->postgresConfig($oSection, $oConfig, $iDepth);
#
# if ($bShow)
# {
# # Render the config
# my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# $oConfigElement = new BackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
#
# $oConfigElement->
# addNew(HTML_DIV, "config-title",
# {strContent => "${strHostName} :${strFile} " .
# " ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
#
# my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
#
# # $oConfigBodyElement->
# # addNew(HTML_DIV, "config-body-title",
# # {strContent => "append to ${strFile}:"});
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-output",
# {strContent => defined($strConfig) ? $strConfig : ''});
#
# $oConfig->fieldSet('actual-config', $strConfig);
# }
#
# # Return from function and log return values if any
# return logDebugReturn
# (
# $strOperation,
# {name => 'oConfigElement', value => $oConfigElement, trace => true}
# );
}
1;
pgbackrest-release-2.24/doc/manifest.xml 0000664 0000000 0000000 00000012565 13625315071 0020315 0 ustar 00root root 0000000 0000000
pgBackRest
Reliable PostgreSQL Backup & Restore
use pgBackRest::Version; PROJECT_VERSION
use BackRestDoc::Custom::DocCustomRelease;
(new BackRestDoc::Custom::DocCustomRelease(
new BackRestDoc::Common::Doc("{[doc-path]}/xml/release.xml")))->currentStableVersion();
pgbackrest
/
PostgreSQL
-
logo.png
favicon.png
n
n
n
use Time::Local;
use BackRestDoc::Custom::DocCustomRelease;
my ($second, $minute , $hour, $mday, $month, $year) = localtime();
$year += 1900;
if ('{[release-date-static]}' eq 'y')
{
my $strDate = (new BackRestDoc::Custom::DocCustomRelease(
new BackRestDoc::Common::Doc("{[doc-path]}/xml/release.xml")))->releaseLast()->paramGet('date');
if ($strDate eq 'XXXX-XX-XX')
{
confess &log(ERROR, 'not possible to use static release dates on a dev build');
}
else
{
($year, $month, $mday) = split(/[\s.\-]+/, $strDate);
$month -= 1;
}
}
my @stryMonth = ('January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December');
$stryMonth[$month] . ' ' . $mday . ', ' . $year;
'Copyright © 2015' . '-' . substr('{[release-date]}', length('{[release-date]}') - 4) .
', The PostgreSQL Global Development Group, <a href="{[github-url-license]}">MIT License</a>. Updated ' .
'{[release-date]}';
{[doc-path]}/output/latex/logo
{[project]} User Guide
Open Source PostgreSQL Backup and Restore Utility
Version {[version]}
Crunchy Data Solutions, Inc.
cds-logo.eps
{[pdf-title1]}\\{[pdf-title3]}
\ \\-\ \thepage\ -
{[pdf-organization]}\\\today
CrunchyBackRest-UserGuide-{[version]}
pgbackrest-release-2.24/doc/release.pl 0000775 0000000 0000000 00000032423 13625315071 0017740 0 ustar 00root root 0000000 0000000 #!/usr/bin/perl
####################################################################################################################################
# release.pl - PgBackRest Release Manager
####################################################################################################################################
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
$SIG{__DIE__} = sub { Carp::confess @_ };
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Getopt::Long qw(GetOptions);
use Pod::Usage qw(pod2usage);
use Storable;
use lib dirname($0) . '/lib';
use lib dirname(dirname($0)) . '/build/lib';
use lib dirname(dirname($0)) . '/lib';
use lib dirname(dirname($0)) . '/test/lib';
use BackRestDoc::Common::Doc;
use BackRestDoc::Common::DocConfig;
use BackRestDoc::Common::DocManifest;
use BackRestDoc::Common::DocRender;
use BackRestDoc::Html::DocHtmlSite;
use BackRestDoc::Latex::DocLatex;
use BackRestDoc::Markdown::DocMarkdown;
use pgBackRest::Common::Exception;
use pgBackRest::Common::Log;
use pgBackRest::Common::String;
use pgBackRest::Version;
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestTest::Common::Storage;
use pgBackRestTest::Common::StoragePosix;
use pgBackRestTest::Common::VmTest;
####################################################################################################################################
# Usage
####################################################################################################################################
=head1 NAME
release.pl - pgBackRest Release Manager
=head1 SYNOPSIS
release.pl [options]
General Options:
--help Display usage and exit
--version Display pgBackRest version
--quiet Sets log level to ERROR
--log-level Log level for execution (e.g. ERROR, WARN, INFO, DEBUG)
Release Options:
--build Build the cache before release (should be included in the release commit)
--deploy Deploy documentation to website (can be done as docs are updated)
--no-gen Don't auto-generate
--vm vm to build documentation for
=cut
####################################################################################################################################
# Load command line parameters and config (see usage above for details)
####################################################################################################################################
my $bHelp = false;
my $bVersion = false;
my $bQuiet = false;
my $strLogLevel = 'info';
my $bBuild = false;
my $bDeploy = false;
my $bNoGen = false;
my $strVm = undef;
GetOptions ('help' => \$bHelp,
'version' => \$bVersion,
'quiet' => \$bQuiet,
'log-level=s' => \$strLogLevel,
'build' => \$bBuild,
'deploy' => \$bDeploy,
'no-gen' => \$bNoGen,
'vm=s' => \$strVm)
or pod2usage(2);
####################################################################################################################################
# Run in eval block to catch errors
####################################################################################################################################
eval
{
# Display version and exit if requested
if ($bHelp || $bVersion)
{
print PROJECT_NAME . ' ' . PROJECT_VERSION . " Release Manager\n";
if ($bHelp)
{
print "\n";
pod2usage();
}
exit 0;
}
# If neither build nor deploy is requested then error
if (!$bBuild && !$bDeploy)
{
confess &log(ERROR, 'neither --build nor --deploy requested, nothing to do');
}
# Set console log level
if ($bQuiet)
{
$strLogLevel = 'error';
}
logLevelSet(undef, uc($strLogLevel), OFF);
# Set the paths
my $strDocPath = dirname(abs_path($0));
my $strDocHtml = "${strDocPath}/output/html";
my $strDocExe = "${strDocPath}/doc.pl";
my $strTestExe = dirname($strDocPath) . "/test/test.pl";
my $oStorageDoc = new pgBackRestTest::Common::Storage(
$strDocPath, new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
# Determine if this is a dev release
my $bDev = PROJECT_VERSION =~ /dev$/;
my $strVersion = $bDev ? 'dev' : PROJECT_VERSION;
if ($bBuild)
{
if (!$bNoGen)
{
# Update git history
my $strGitCommand =
'git -C ' . $strDocPath .
' log --pretty=format:\'{^^^^commit^^^^:^^^^%H^^^^,^^^^date^^^^:^^^^%ci^^^^,^^^^subject^^^^:^^^^%s^^^^,^^^^body^^^^:^^^^%b^^^^},\'';
my $strGitLog = qx($strGitCommand);
$strGitLog =~ s/\^\^\^\^\}\,\n/\#\#\#\#/mg;
$strGitLog =~ s/\\/\\\\/g;
$strGitLog =~ s/\n/\\n/mg;
$strGitLog =~ s/\r/\\r/mg;
$strGitLog =~ s/\t/\\t/mg;
$strGitLog =~ s/\"/\\\"/g;
$strGitLog =~ s/\^\^\^\^/\"/g;
$strGitLog =~ s/\#\#\#\#/\"\}\,\n/mg;
$strGitLog = '[' . substr($strGitLog, 0, length($strGitLog) - 1) . ']';
my @hyGitLog = @{(JSON::PP->new()->allow_nonref())->decode($strGitLog)};
# Load prior history
my @hyGitLogPrior = @{(JSON::PP->new()->allow_nonref())->decode(
${$oStorageDoc->get("${strDocPath}/resource/git-history.cache")})};
# Add new commits
for (my $iGitLogIdx = @hyGitLog - 1; $iGitLogIdx >= 0; $iGitLogIdx--)
{
my $rhGitLog = $hyGitLog[$iGitLogIdx];
my $bFound = false;
foreach my $rhGitLogPrior (@hyGitLogPrior)
{
if ($rhGitLog->{commit} eq $rhGitLogPrior->{commit})
{
$bFound = true;
}
}
next if $bFound;
$rhGitLog->{body} = trim($rhGitLog->{body});
if ($rhGitLog->{body} eq '')
{
delete($rhGitLog->{body});
}
unshift(@hyGitLogPrior, $rhGitLog);
}
# Write git log
$strGitLog = undef;
foreach my $rhGitLog (@hyGitLogPrior)
{
$strGitLog .=
(defined($strGitLog) ? ",\n" : '') .
" {\n" .
' "commit": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{commit})) . ",\n" .
' "date": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{date})) . ",\n" .
' "subject": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{subject}));
# Skip the body if it is empty or a release (since we already have the release note content)
if ($rhGitLog->{subject} !~ /^v[0-9]{1,2}\.[0-9]{1,2}\: /g && defined($rhGitLog->{body}))
{
$strGitLog .=
",\n" .
' "body": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{body}));
}
$strGitLog .=
"\n" .
" }";
}
$oStorageDoc->put("${strDocPath}/resource/git-history.cache", "[\n${strGitLog}\n]\n");
# Generate coverage summary
&log(INFO, "Generate Coverage Summary");
executeTest(
"${strTestExe} --no-package --no-valgrind --no-optimize --vm-max=3 --coverage-summary",
{bShowOutputAsync => true});
}
# Remove permanent cache file
$oStorageDoc->remove("${strDocPath}/resource/exe.cache", {bIgnoreMissing => true});
# Remove all docker containers to get consistent IP address assignments
executeTest('docker rm -f $(docker ps -a -q)', {bSuppressError => true});
# Generate deployment docs for RHEL/Centos 7
if (!defined($strVm) || $strVm eq VM_CO7)
{
&log(INFO, "Generate RHEL/CentOS 7 documentation");
executeTest("${strDocExe} --deploy --key-var=os-type=centos7 --out=pdf", {bShowOutputAsync => true});
if (!defined($strVm))
{
executeTest("${strDocExe} --deploy --cache-only --key-var=os-type=centos7 --out=pdf");
}
}
# Generate deployment docs for RHEL/Centos 6
if (!defined($strVm) || $strVm eq VM_CO6)
{
&log(INFO, "Generate RHEL/CentOS 6 documentation");
executeTest("${strDocExe} --deploy --key-var=os-type=centos6 --out=html", {bShowOutputAsync => true});
if (!defined($strVm))
{
executeTest("${strDocExe} --deploy --cache-only --key-var=os-type=centos6 --out=html");
}
}
# Generate deployment docs for Debian
if (!defined($strVm) || $strVm eq VM_U18)
{
&log(INFO, "Generate Debian/Ubuntu documentation");
executeTest("${strDocExe} --deploy --out=man --out=html --out=markdown", {bShowOutputAsync => true});
}
# Generate a full copy of the docs for review
if (!defined($strVm))
{
&log(INFO, "Generate full documentation for review");
executeTest(
"${strDocExe} --deploy --cache-only --key-var=os-type=centos7 --out=html --var=project-url-root=index.html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos7.html");
executeTest(
"${strDocExe} --deploy --out-preserve --cache-only --key-var=os-type=centos6 --out=html" .
" --var=project-url-root=index.html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos6.html");
executeTest(
"${strDocExe} --deploy --out-preserve --cache-only --out=man --out=html --var=project-url-root=index.html");
}
}
if ($bDeploy)
{
my $strDeployPath = "${strDocPath}/site";
# Generate docs for the website history
&log(INFO, 'Generate website ' . ($bDev ? 'dev' : 'history') . ' documentation');
my $strDocExeVersion =
${strDocExe} . ($bDev ? ' --dev' : ' --deploy --cache-only') . ' --var=project-url-root=index.html --out=html';
executeTest("${strDocExeVersion} --key-var=os-type=centos7");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos7.html");
executeTest("${strDocExeVersion} --out-preserve --key-var=os-type=centos6");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos6.html");
$oStorageDoc->remove("$strDocHtml/release.html");
executeTest("${strDocExeVersion} --out-preserve --exclude=release");
# Deploy to repository
&log(INFO, '...Deploy to repository');
executeTest("rm -rf ${strDeployPath}/prior/${strVersion}");
executeTest("mkdir ${strDeployPath}/prior/${strVersion}");
executeTest("cp ${strDocHtml}/* ${strDeployPath}/prior/${strVersion}");
# Generate docs for the main website
if (!$bDev)
{
&log(INFO, "Generate website documentation");
executeTest("${strDocExe} --deploy --cache-only --key-var=os-type=centos7 --out=html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos7.html");
executeTest("${strDocExe} --deploy --out-preserve --cache-only --key-var=os-type=centos6 --out=html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-centos6.html");
executeTest("${strDocExe} --deploy --out-preserve --cache-only --out=html");
# Deploy to repository
&log(INFO, '...Deploy to repository');
executeTest("rm -rf ${strDeployPath}/dev");
executeTest("find ${strDeployPath} -maxdepth 1 -type f -exec rm {} +");
executeTest("cp ${strDocHtml}/* ${strDeployPath}");
executeTest("cp ${strDocPath}/../README.md ${strDeployPath}");
executeTest("cp ${strDocPath}/../LICENSE ${strDeployPath}");
}
# Update permissions
executeTest("find ${strDeployPath} -type d -exec chmod 750 {} +");
executeTest("find ${strDeployPath} -type f -exec chmod 640 {} +");
}
# Exit with success
exit 0;
}
####################################################################################################################################
# Check for errors
####################################################################################################################################
or do
{
# If a backrest exception then return the code
exit $EVAL_ERROR->code() if (isException(\$EVAL_ERROR));
# Else output the unhandled error
print $EVAL_ERROR;
exit ERROR_UNHANDLED;
};
# It shouldn't be possible to get here
&log(ASSERT, 'execution reached invalid location in ' . __FILE__ . ', line ' . __LINE__);
exit ERROR_ASSERT;
pgbackrest-release-2.24/doc/resource/ 0000775 0000000 0000000 00000000000 13625315071 0017603 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/resource/exe.cache 0000664 0000000 0000000 00002316402 13625315071 0021361 0 ustar 00root root 0000000 0000000 {
"default" : {
"all" : {
"user-guide" : [
{
"key" : {
"id" : "s3",
"image" : "minio/minio:RELEASE.2019-10-12T01-39-57Z",
"name" : "s3-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/s3-server.crt:/root/.minio/certs/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/s3-server.key:/root/.minio/certs/private.key:ro -e MINIO_REGION=us-east-1 -e MINIO_DOMAIN=s3.us-east-1.amazonaws.com -e MINIO_BROWSER=off -e MINIO_ACCESS_KEY=accessKey1 -e MINIO_SECRET_KEY=verySecretKey1",
"os" : "debian",
"param" : "server /data --address :443",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.2"
}
},
{
"key" : {
"id" : "build",
"image" : "pgbackrest/doc:debian",
"name" : "build",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.3"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/libc /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/src /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown -R vagrant /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get update"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install make gcc libpq-dev libssl-dev libxml2-dev pkg-config"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cd /build/pgbackrest-release-2.24/src && ./configure && make"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg1",
"image" : "pgbackrest/doc:debian",
"name" : "pg-primary",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.4"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - General help",
"",
"Usage:",
" pgbackrest [options] [command]",
"",
"Commands:",
" archive-get Get a WAL segment from the archive.",
" archive-push Push a WAL segment to the archive.",
" backup Backup a database cluster.",
" check Check the configuration.",
" expire Expire backups that exceed retention.",
" help Get help.",
" info Retrieve information about backups.",
" restore Restore a database cluster.",
" stanza-create Create the required stanza data.",
" stanza-delete Delete a stanza.",
" stanza-upgrade Upgrade a stanza.",
" start Allow pgBackRest processes to run.",
" stop Stop pgBackRest processes from running.",
" version Get version.",
"",
"Use 'pgbackrest help [command]' for more information."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/lib/postgresql/10/bin/initdb \\",
" -D /var/lib/postgresql/10/demo -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 10 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Configuring already existing cluster (configuration: /etc/postgresql/10/demo, data: /var/lib/postgresql/10/demo, owner: 106:110)",
"Ver Cluster Port Status Owner Data directory Log file",
"10 demo 5432 down postgres /var/lib/postgresql/10/demo /var/log/postgresql/postgresql-10-demo.log"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/10/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"listen_addresses" : {
"value" : "'*'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/10/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_line_prefix" : {
"value" : "''"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'",
"log_line_prefix = ''"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/10/demo"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c ' \\",
" export PGBACKREST_LOG_PATH=/path/set/by/env && \\",
" pgbackrest --log-level-console=error help backup log-path'"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"current\\: \\/path\\/set\\/by\\/env"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - 'backup' command - 'log-path' option help",
"",
"Path where log files are stored.",
"",
"The log path provides a location for pgBackRest to store log files. Note that",
"if log-level-file=off then no log path is required.",
"",
"current: /path/set/by/env",
"default: /var/log/pgbackrest"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/10/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo restart"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global:archive-push" : {
"compress-level" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-cipher-pass" : {
"value" : "zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO"
},
"repo1-cipher-type" : {
"value" : "aes-256-cbc"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" successfully archived to "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo/10-1/0000000100000000/000000010000000000000001-86f2b0d2e919b044ef617e80e57a95019dccc01e.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000010000000000000002, lsn = 0/2000028",
" [filtered 941 lines of output]",
"P01 INFO: backup file /var/lib/postgresql/10/demo/base/1/12822 (0B, 100%)",
"P01 INFO: backup file /var/lib/postgresql/10/demo/base/1/12817 (0B, 100%)",
"P00 INFO: full backup size = 22.4MB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000002, lsn = 0/2000130",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155549F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"diff backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
"P01 INFO: backup file /var/lib/postgresql/10/demo/global/pg_control (8KB, 99%) checksum 28592b892362c9851a4ca4881f030e03feee6b83",
"P01 INFO: backup file /var/lib/postgresql/10/demo/pg_logical/replorigin_checkpoint (8B, 100%) checksum 347fc8f2df71bd4436e38bd1516ccd7ea0d46532",
"P00 INFO: diff backup size = 8KB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000003, lsn = 0/30000F8",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"(full|incr|diff) backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (10-1): 000000010000000000000002/000000010000000000000003",
"",
" full backup: 20200225-155549F",
" timestamp start/stop: 2020-02-25 15:55:49 / 2020-02-25 15:56:01",
" wal start/stop: 000000010000000000000002 / 000000010000000000000002",
" database size: 22.4MB, backup size: 22.4MB",
" repository size: 2.7MB, repository backup size: 2.7MB",
"",
" diff backup: 20200225-155549F_20200225-155603D",
" timestamp start/stop: 2020-02-25 15:56:03 / 2020-02-25 15:56:05",
" wal start/stop: 000000010000000000000003 / 000000010000000000000003",
" database size: 22.4MB, backup size: 8.2KB",
" repository size: 2.7MB, repository backup size: 496B",
" backup reference list: 20200225-155549F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm /var/lib/postgresql/10/demo/global/pg_control"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"could not find the database system"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Error: /usr/lib/postgresql/10/bin/pg_ctl /usr/lib/postgresql/10/bin/pg_ctl start -D /var/lib/postgresql/10/demo -l /var/log/postgresql/postgresql-10-demo.log -s -o -c config_file=\"/etc/postgresql/10/demo/postgresql.conf\" exited with status 1: ",
"postgres: could not find the database system",
"Expected to find it in the directory \"/var/lib/postgresql/10/demo\",",
"but could not open file \"/var/lib/postgresql/10/demo/global/pg_control\": No such file or directory",
"Examine the log output."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/postgresql/10/demo -mindepth 1 -delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the next regular checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --type=incr",
"P00 INFO: last backup label = 20200225-155549F_20200225-155603D, version = 2.24",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000006, lsn = 0/6000028",
"P00 WARN: a timeline switch has occurred since the 20200225-155549F_20200225-155603D backup, enabling delta checksum",
" [filtered 9 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the requested immediate checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast --type=incr",
"P00 INFO: last backup label = 20200225-155549F_20200225-155624I, version = 2.24",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000007, lsn = 0/7000028",
"P01 INFO: backup file /var/lib/postgresql/10/demo/global/pg_control (8KB, 99%) checksum 5d12210792bcebed4a77029dc6e109c6ff359f28",
" [filtered 9 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p /var/lib/postgresql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cp -r /pgbackrest/doc/example/* \\",
" /var/lib/postgresql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- An example of monitoring pgBackRest from within PostgreSQL",
"--",
"-- Use copy to export data from the pgBackRest info command into the jsonb",
"-- type so it can be queried directly by PostgreSQL.",
"",
"-- Create monitor schema",
"create schema monitor;",
"",
"-- Get pgBackRest info in JSON format",
"create function monitor.pgbackrest_info()",
" returns jsonb AS $$",
"declare",
" data jsonb;",
"begin",
" -- Create a temp table to hold the JSON data",
" create temp table temp_pgbackrest_data (data jsonb);",
"",
" -- Copy data into the table directly from the pgBackRest info command",
" copy temp_pgbackrest_data (data)",
" from program",
" 'pgbackrest --output=json info' (format text);",
"",
" select temp_pgbackrest_data.data",
" into data",
" from temp_pgbackrest_data;",
"",
" drop table temp_pgbackrest_data;",
"",
" return data;",
"end $$ language plpgsql;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- Get last successful backup for each stanza",
"--",
"-- Requires the monitor.pgbackrest_info function.",
"with stanza as",
"(",
" select data->'name' as name,",
" data->'backup'->(",
" jsonb_array_length(data->'backup') - 1) as last_backup,",
" data->'archive'->(",
" jsonb_array_length(data->'archive') - 1) as current_archive",
" from jsonb_array_elements(monitor.pgbackrest_info()) as data",
")",
"select name,",
" to_timestamp(",
" (last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,",
" current_archive->>'max' as last_archived_wal",
" from stanza;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" name | last_successful_backup | last_archived_wal ",
"--------+------------------------+--------------------------",
" \"demo\" | 2020-02-25 15:56:31+00 | 000000020000000000000007",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install jq"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --output=json --stanza=demo info | \\",
" jq '.[0] | .backup[-1] | .timestamp.stop'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"1582646191"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --output=json --stanza=demo info | \\",
" jq '.[0] | .archive[-1] | .max'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"\"000000020000000000000007\""
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-155549F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 952 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-155549F, archiveId = 10-1, start = 000000010000000000000002",
"P00 DETAIL: no archive to remove, archiveId = 10-1",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155642F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire full backup set\\: 20200225-155549F|archive retention on backup 20200225-155642F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 951 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire full backup set: 20200225-155549F, 20200225-155549F_20200225-155603D, 20200225-155549F_20200225-155624I, 20200225-155549F_20200225-155629I",
"P00 INFO: remove expired backup 20200225-155549F_20200225-155629I",
"P00 INFO: remove expired backup 20200225-155549F_20200225-155624I",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "1"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=1",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155658F_20200225-155716D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire diff backup set: 20200225-155658F_20200225-155716D"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 12 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=1 --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire diff backup set: 20200225-155658F_20200225-155716D, 20200225-155658F_20200225-155718I",
"P00 INFO: remove expired backup 20200225-155658F_20200225-155718I",
"P00 INFO: remove expired backup 20200225-155658F_20200225-155716D"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155658F_20200225-155721D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal(); \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"new backup label"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 9 lines of output]",
"P00 INFO: backup stop archive = 000000020000000000000011, lsn = 0/110000F8",
"P00 INFO: check archive for segment(s) 000000020000000000000011:000000020000000000000011",
"P00 INFO: new backup label = 20200225-155658F_20200225-155727D",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155658F_20200225-155727D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=detail \\",
" --repo1-retention-archive-type=diff --repo1-retention-archive=1 expire"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-155658F_20200225-155721D|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-archive=1 --repo1-retention-archive-type=diff --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-155642F, archiveId = 10-1, start = 000000020000000000000009, stop = 000000020000000000000009",
"P00 DETAIL: archive retention on backup 20200225-155658F, archiveId = 10-1, start = 00000002000000000000000A, stop = 00000002000000000000000A",
"P00 DETAIL: archive retention on backup 20200225-155658F_20200225-155721D, archiveId = 10-1, start = 00000002000000000000000E, stop = 00000002000000000000000E",
"P00 DETAIL: archive retention on backup 20200225-155658F_20200225-155727D, archiveId = 10-1, start = 000000020000000000000011",
"P00 DETAIL: remove archive: archiveId = 10-1, start = 00000002000000000000000B, stop = 00000002000000000000000D",
"P00 DETAIL: remove archive: archiveId = 10-1, start = 00000002000000000000000F, stop = 000000020000000000000010",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --log-level-console=detail restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"demo\\/PG_VERSION - exists and matches backup|remove invalid files|rename global\\/pg_control"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 DETAIL: check '/var/lib/postgresql/10/demo' exists",
"P00 DETAIL: remove 'global/pg_control' so cluster will not start if restore does not complete",
"P00 INFO: remove invalid files/links/paths from '/var/lib/postgresql/10/demo'",
"P00 DETAIL: remove invalid file '/var/lib/postgresql/10/demo/backup_label.old'",
"P00 DETAIL: remove invalid file '/var/lib/postgresql/10/demo/base/1/pg_internal.init'",
" [filtered 755 lines of output]",
"P01 DETAIL: restore file /var/lib/postgresql/10/demo/base/12979/PG_VERSION - exists and matches backup (3B, 99%) checksum 4143d3a341877154d6e95211464e1df1015b74bd",
"P01 DETAIL: restore file /var/lib/postgresql/10/demo/base/1/PG_VERSION - exists and matches backup (3B, 99%) checksum 4143d3a341877154d6e95211464e1df1015b74bd",
"P01 DETAIL: restore file /var/lib/postgresql/10/demo/PG_VERSION - exists and matches backup (3B, 100%) checksum 4143d3a341877154d6e95211464e1df1015b74bd",
"P01 DETAIL: restore file /var/lib/postgresql/10/demo/global/6100_vm - exists and is zero size (0B, 100%)",
"P01 DETAIL: restore file /var/lib/postgresql/10/demo/global/6100 - exists and is zero size (0B, 100%)",
" [filtered 232 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test2;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test1_table (id int); \\",
" insert into test1_table (id) values (1);\" test1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test2_table (id int); \\",
" insert into test2_table (id) values (2);\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select oid from pg_database where datname = 'test1'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/postgresql/10/demo/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"7.5M\t/var/lib/postgresql/10/demo/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155658F_20200225-155740I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --set=20200225-155658F_20200225-155740I info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"database list"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
" repository size: 4.4MB, repository backup size: 1.8MB",
" backup reference list: 20200225-155658F, 20200225-155658F_20200225-155727D",
" database list: postgres (12980), test1 (24576), test2 (24577)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --db-include=test2 restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test2_table;\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" id ",
"----",
" 2",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test1_table;\" test1"
],
"err-expect" : "2",
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"relation mapping file.*contains invalid data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"psql: FATAL: relation mapping file \"base/24576/pg_filenode.map\" contains invalid data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/postgresql/10/demo/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"176K\t/var/lib/postgresql/10/demo/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"drop database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"DROP DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select oid, datname from pg_database order by oid;\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"test2"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" oid | datname ",
"-------+-----------",
" 1 | template1",
" 12979 | template0",
" 12980 | postgres",
" 24577 | test2",
"(4 rows)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" create table important_table (message text); \\",
" insert into important_table values ('Important Data'); \\",
" commit; \\",
" select * from important_table;\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select current_timestamp\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2020-02-25 15:58:14.809656+00"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:58:14.809656+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-10-demo.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/10/demo/recovery.conf"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery_target_time"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:58:17",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"recovery_target_time = '2020-02-25 15:58:14.809656+00'",
"recovery_target_action = 'promote'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-10-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"LOG: listening on Unix socket \"/var/run/postgresql/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2020-02-25 15:58:07 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:58:14.809656+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"000000040000000000000016\" from archive",
" [filtered 2 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: restored log file \"000000040000000000000017\" from archive",
"LOG: recovery stopping before commit of transaction 564, time 2020-02-25 15:58:15.132145+00",
"LOG: redo done at 0/170207C8",
"LOG: last completed transaction was at log time 2020-02-25 15:58:13.968068+00",
"LOG: selected new timeline ID: 5",
"LOG: archive recovery complete",
" [filtered 3 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-155658F_20200225-155826I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"20200225-155658F_20200225-155826I"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (10-1): 000000020000000000000009/000000050000000000000018",
"",
" full backup: 20200225-155642F",
" timestamp start/stop: 2020-02-25 15:56:42 / 2020-02-25 15:56:56",
" wal start/stop: 000000020000000000000009 / 000000020000000000000009",
" database size: 22.4MB, backup size: 22.4MB",
" repository size: 2.7MB, repository backup size: 2.7MB",
"",
" full backup: 20200225-155658F",
" timestamp start/stop: 2020-02-25 15:56:58 / 2020-02-25 15:57:13",
" wal start/stop: 00000002000000000000000A / 00000002000000000000000A",
" database size: 22.4MB, backup size: 22.4MB",
" repository size: 2.7MB, repository backup size: 2.7MB",
"",
" diff backup: 20200225-155658F_20200225-155727D",
" timestamp start/stop: 2020-02-25 15:57:27 / 2020-02-25 15:57:29",
" wal start/stop: 000000020000000000000011 / 000000020000000000000011",
" database size: 22.4MB, backup size: 96.2KB",
" repository size: 2.7MB, repository backup size: 11.9KB",
" backup reference list: 20200225-155658F",
"",
" incr backup: 20200225-155658F_20200225-155740I",
" timestamp start/stop: 2020-02-25 15:57:40 / 2020-02-25 15:57:50",
" wal start/stop: 000000030000000000000013 / 000000030000000000000013",
" database size: 37.0MB, backup size: 15.0MB",
" repository size: 4.4MB, repository backup size: 1.8MB",
" backup reference list: 20200225-155658F, 20200225-155658F_20200225-155727D",
"",
" diff backup: 20200225-155658F_20200225-155807D",
" timestamp start/stop: 2020-02-25 15:58:07 / 2020-02-25 15:58:12",
" wal start/stop: 000000040000000000000016 / 000000040000000000000016",
" database size: 29.7MB, backup size: 7.8MB",
" repository size: 3.5MB, repository backup size: 948.8KB",
" backup reference list: 20200225-155658F",
"",
" incr backup: 20200225-155658F_20200225-155826I",
" timestamp start/stop: 2020-02-25 15:58:26 / 2020-02-25 15:58:28",
" wal start/stop: 000000050000000000000018 / 000000050000000000000018",
" database size: 29.7MB, backup size: 2MB",
" repository size: 3.5MB, repository backup size: 218.2KB",
" backup reference list: 20200225-155658F, 20200225-155658F_20200225-155807D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --set=20200225-155658F_20200225-155826I \\",
" --type=time \"--target=2020-02-25 15:58:14.809656+00\" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-10-demo.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: select * from important_table",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-10-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"starting point-in-time recovery|consistent recovery state reached"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"LOG: listening on Unix socket \"/var/run/postgresql/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2020-02-25 15:58:27 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:58:14.809656+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"000000050000000000000018\" from archive",
"LOG: redo starts at 0/18000028",
"LOG: consistent recovery state reached at 0/180000F8",
"LOG: database system is ready to accept read only connections",
"LOG: redo done at 0/180000F8",
" [filtered 8 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:58:14.809656+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-10-demo.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-10-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"LOG: listening on Unix socket \"/var/run/postgresql/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2020-02-25 15:58:07 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:58:14.809656+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"000000040000000000000016\" from archive",
" [filtered 2 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: restored log file \"000000040000000000000017\" from archive",
"LOG: recovery stopping before commit of transaction 564, time 2020-02-25 15:58:15.132145+00",
"LOG: redo done at 0/170207C8",
"LOG: last completed transaction was at log time 2020-02-25 15:58:13.968068+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"00000006.history\" from archive",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.2 demo-bucket.s3.us-east-1.amazonaws.com s3.us-east-1.amazonaws.com\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc config host add demo https://172.17.0.2 accessKey1 verySecretKey1 --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc mb demo/demo-bucket --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"process-max" : {
"value" : "4"
},
"repo1-path" : {
"value" : "/demo-repo"
},
"repo1-s3-bucket" : {
"value" : "demo-bucket"
},
"repo1-s3-endpoint" : {
"value" : "s3.us-east-1.amazonaws.com"
},
"repo1-s3-key" : {
"value" : "accessKey1"
},
"repo1-s3-key-secret" : {
"value" : "verySecretKey1"
},
"repo1-s3-region" : {
"value" : "us-east-1"
},
"repo1-type" : {
"value" : "s3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"process-max=4",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/demo-repo",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo1-s3-bucket=demo-bucket",
"repo1-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo1-s3-key=accessKey1",
"repo1-s3-key-secret=verySecretKey1",
"repo1-s3-region=us-east-1",
"repo1-type=s3",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 12, retries 0, closes 0",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=4 --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000070000000000000018, lsn = 0/18000028",
" [filtered 1238 lines of output]",
"P04 INFO: backup file /var/lib/postgresql/10/demo/base/1/12822 (0B, 100%)",
"P01 INFO: backup file /var/lib/postgresql/10/demo/base/1/12817 (0B, 100%)",
"P00 INFO: full backup size = 29.7MB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000070000000000000018, lsn = 0/18000130",
" [filtered 7 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stop"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stop command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: stop command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-delete"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-delete command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 15, retries 0, closes 0",
"P00 INFO: stanza-delete command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "repo1",
"image" : "pgbackrest/doc:debian",
"name" : "repository",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.5"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo adduser --disabled-password --gecos \"\" pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 /home/pgbackrest/.ssh"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh-keygen -f /home/pgbackrest/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-primary cat /var/lib/postgresql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/postgresql/.ssh/authorized_keys"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-primary"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-host" : {
"value" : "pg-primary"
},
"pg1-path" : {
"value" : "/var/lib/postgresql/10/demo"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-retention-full" : {
"value" : "2"
},
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/10/demo"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
},
"reset" : true
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo stanza-create"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: no prior backup exists, incr backup has been changed to full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"process-max" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"timestamp start/stop"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: none",
"",
" db (current)",
" wal archive min/max (10-1): 00000008000000000000001E/000000080000000000000020",
"",
" full backup: 20200225-160013F",
" timestamp start/stop: 2020-02-25 16:00:13 / 2020-02-25 16:00:31",
" wal start/stop: 00000008000000000000001E / 00000008000000000000001E",
" database size: 29.7MB, backup size: 29.7MB",
" repository size: 3.5MB, repository backup size: 3.5MB",
"",
" full backup: 20200225-160034F",
" timestamp start/stop: 2020-02-25 16:00:34 / 2020-02-25 16:00:43",
" wal start/stop: 000000080000000000000020 / 000000080000000000000020",
" database size: 29.7MB, backup size: 29.7MB",
" repository size: 3.5MB, repository backup size: 3.5MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for all stanzas"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for all stanzas",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: stop file already exists for all stanzas"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for stanza demo"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for stanza demo",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg2",
"image" : "pgbackrest/doc:debian",
"name" : "pg-standby",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.6"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-standby cat /var/lib/postgresql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/postgresql/.ssh/authorized_keys"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-standby"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/10/demo"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 10 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/10/demo/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 16:01:23",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/10/demo/postgresql.conf",
"host" : "pg-standby",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"hot_standby" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-10-demo.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-10-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"entering standby mode|database system is ready to accept read only connections"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 3 lines of output]",
"LOG: listening on Unix socket \"/var/run/postgresql/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2020-02-25 16:00:34 UTC",
"LOG: entering standby mode",
"LOG: restored log file \"00000008.history\" from archive",
"LOG: restored log file \"000000080000000000000020\" from archive",
"LOG: redo starts at 0/20000028",
"LOG: consistent recovery state reached at 0/200000F8",
"LOG: database system is ready to accept read only connections",
"LOG: incomplete startup packet"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table replicated_table (message text); \\",
" insert into replicated_table values ('Important Data'); \\",
" commit; \\",
" select * from replicated_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from replicated_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"replicated_table\" does not exist",
"LINE 1: select * from replicated_table;",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select *, current_timestamp from pg_switch_wal()\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" pg_switch_wal | current_timestamp ",
"---------------+-------------------------------",
" 0/2102A938 | 2020-02-25 16:01:36.869657+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from replicated_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 16:01:40.525786+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"because this is a standby"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-host=repository --stanza=demo",
"P00 INFO: switch wal not performed because this is a standby",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create user replicator password 'jw8s0F4' replication\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"host replication replicator 172.17.0.6/32 md5\" \\",
" >> /etc/postgresql/10/demo/pg_hba.conf'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo reload"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"recovery-option" : {
"value" : "primary_conninfo=host=172.17.0.4 port=5432 user=replicator"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"172.17.0.4:*:replication:replicator:jw8s0F4\" \\",
" >> /var/lib/postgresql/.pgpass'"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres chmod 600 /var/lib/postgresql/.pgpass"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/10/demo/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 16:01:47",
"primary_conninfo = 'host=172.17.0.4 port=5432 user=replicator'",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-10-demo.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-10-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"started streaming WAL from primary"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"LOG: restored log file \"000000080000000000000021\" from archive",
"LOG: incomplete startup packet",
"LOG: started streaming WAL from primary at 0/22000000 on timeline 8"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table stream_table (message text); \\",
" insert into stream_table values ('Important Data'); \\",
" commit; \\",
" select *, current_timestamp from stream_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 16:01:55.684577+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from stream_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 16:01:57.266311+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/10/demo",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'bogus'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo restart"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm -f /var/log/pgbackrest/demo-archive-push-async.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"WAL segment"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --repo1-host=repository --stanza=demo",
"P00 INFO: WAL segment 000000080000000000000027 successfully archived to '/var/lib/pgbackrest/archive/demo/10-1/0000000800000000/000000080000000000000027-0367ae95fe48f02a5b536afacec69d1b672ab230.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-push-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" WAL file\\(s\\) to archive|pushed WAL file \\'0000000"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/postgresql/10/demo/pg_wal] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000080000000000000022",
"P01 DETAIL: pushed WAL file '000000080000000000000022' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/postgresql/10/demo/pg_wal] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 4 WAL file(s) to archive: 000000080000000000000023...000000080000000000000026",
"P02 DETAIL: pushed WAL file '000000080000000000000024' to the archive",
"P01 DETAIL: pushed WAL file '000000080000000000000023' to the archive",
"P02 DETAIL: pushed WAL file '000000080000000000000025' to the archive",
"P01 DETAIL: pushed WAL file '000000080000000000000026' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/postgresql/10/demo/pg_wal] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000080000000000000027",
"P01 DETAIL: pushed WAL file '000000080000000000000027' to the archive",
"P00 INFO: archive-push:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 5"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-get-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"found [0-F]{24} in the archive"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000020, 000000080000000000000021, 000000080000000000000022, 000000080000000000000023, 000000080000000000000024, 000000080000000000000025, 000000080000000000000026, 000000080000000000000027] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000020...000000080000000000000027",
"P01 DETAIL: found 000000080000000000000020 in the archive",
"P02 DETAIL: found 000000080000000000000021 in the archive",
"P01 DETAIL: unable to find 000000080000000000000022 in the archive",
"P02 DETAIL: unable to find 000000080000000000000023 in the archive",
" [filtered 27 lines of output]",
"P02 DETAIL: unable to find 000000080000000000000028 in the archive",
"P02 DETAIL: unable to find 000000080000000000000029 in the archive",
"P01 DETAIL: found 000000080000000000000022 in the archive",
"P00 INFO: archive-get:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000023, 000000080000000000000024, 000000080000000000000025, 000000080000000000000026, 000000080000000000000027, 000000080000000000000028, 000000080000000000000029, 00000008000000000000002A] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/10/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000023...00000008000000000000002A",
"P01 DETAIL: found 000000080000000000000023 in the archive",
"P02 DETAIL: found 000000080000000000000024 in the archive",
"P01 DETAIL: found 000000080000000000000025 in the archive",
"P02 DETAIL: found 000000080000000000000026 in the archive",
"P02 DETAIL: unable to find 000000080000000000000028 in the archive",
"P02 DETAIL: unable to find 000000080000000000000029 in the archive",
"P02 DETAIL: unable to find 00000008000000000000002A in the archive",
"P01 DETAIL: found 000000080000000000000027 in the archive",
"P00 INFO: archive-get:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'jw8s0F4'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg2-host" : {
"value" : "pg-standby"
},
"pg2-path" : {
"value" : "/var/lib/postgresql/10/demo"
}
},
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/10/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/10/demo",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup file pg-primary|replay on the standby"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000080000000000000029, lsn = 0/29000028",
"P00 INFO: wait for replay on the standby to reach 0/29000028",
"P00 INFO: replay on the standby reached 0/29000028",
"P03 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/1249 (392KB, 17%) checksum 3fcdb0e05aebadae41a7f3868917b90d4417c844",
"P02 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/2608 (440KB, 36%) checksum c0742ac8a69475332c28dc67a9b212db71c5b3dd",
" [filtered 10 lines of output]",
"P04 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/2610 (32KB, 89%) checksum 7603ed0e5a6bb83b9074dae862dd91610da0e06f",
"P02 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/2610_fsm (24KB, 90%) checksum 858e0b8e72c2f8ebade7eed2d1ce3325a477f45f",
"P01 INFO: backup file pg-primary:/var/lib/postgresql/10/demo/global/pg_control (8KB, 91%) checksum ddebcfd6ce498d773c55dadc51ed677a1a3142c4",
"P03 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/2608_fsm (24KB, 92%) checksum cd7a43a3002f7c1f37464acea2b21d11be4495b3",
"P04 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/1249_fsm (24KB, 93%) checksum bf905a0ae44b097e629f75f9cb02b81314726de9",
"P02 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/global/2677 (16KB, 94%) checksum c92d4c082e665ff6560ae42fe8a8ee062c128365",
"P01 INFO: backup file pg-primary:/var/lib/postgresql/10/demo/pg_logical/replorigin_checkpoint (8B, 94%) checksum 347fc8f2df71bd4436e38bd1516ccd7ea0d46532",
"P03 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/global/2676 (16KB, 94%) checksum 2cf37ba2bde4c603ae6c00a9fb09034111ad50f9",
"P04 INFO: backup file pg-standby:/var/lib/postgresql/10/demo/base/12980/2703 (16KB, 95%) checksum 6feb117dd4da6bea940206db8b3b3766486cde01",
" [filtered 1235 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 10 demo stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/lib/postgresql/11/bin/initdb \\",
" -D /var/lib/postgresql/11/demo -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 11 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'cd /var/lib/postgresql && \\",
" /usr/lib/postgresql/11/bin/pg_upgrade \\",
" --old-bindir=/usr/lib/postgresql/10/bin \\",
" --new-bindir=/usr/lib/postgresql/11/bin \\",
" --old-datadir=/var/lib/postgresql/10/demo \\",
" --new-datadir=/var/lib/postgresql/11/demo \\",
" --old-options=\" -c config_file=/etc/postgresql/10/demo/postgresql.conf\" \\",
" --new-options=\" -c config_file=/etc/postgresql/11/demo/postgresql.conf\"'"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Upgrade Complete"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 68 lines of output]",
"Creating script to delete old cluster ok",
"",
"Upgrade Complete",
"----------------",
"Optimizer statistics are not transferred by pg_upgrade so,",
" [filtered 4 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/11/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"listen_addresses" : {
"value" : "'*'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"port" : {
"value" : "5432"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"port = 5432",
"wal_level = replica"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/11/demo"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/11/demo",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/11/demo"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/11/demo",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/11/demo"
},
"pg2-path" : {
"value" : "/var/lib/postgresql/11/demo"
}
},
"global" : {
"backup-standby" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/11/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/11/demo",
"",
"[global]",
"backup-standby=n",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp /etc/postgresql/10/demo/pg_hba.conf \\",
" /etc/postgresql/11/demo/pg_hba.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --no-online \\",
" --log-level-console=info stanza-upgrade"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-upgrade command begin 2.24: --no-backup-standby --log-level-console=info --log-level-stderr=off --no-log-timestamp --no-online --pg1-host=pg-primary --pg2-host=pg-standby --pg1-path=/var/lib/postgresql/11/demo --pg2-path=/var/lib/postgresql/11/demo --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-upgrade command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 11 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pg_lsclusters"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Ver Cluster Port Status Owner Data directory Log file",
"10 demo 5432 down postgres /var/lib/postgresql/10/demo /var/log/postgresql/postgresql-10-demo.log",
"11 demo 5432 online postgres /var/lib/postgresql/11/demo /var/log/postgresql/postgresql-11-demo.log"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_dropcluster 10 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_dropcluster 10 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 11 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-2: [DbConnectError] raised from remote-0 protocol on 'pg-standby': unable to connect to 'dbname='postgres' port=5432': could not connect to server: No such file or directory",
" \tIs the server running locally and accepting",
" \tconnections on Unix domain socket \"/var/run/postgresql/.s.PGSQL.5432\"?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/postgresql/11/demo/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"hot_standby = on"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 11 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/11/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/11/demo",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
}
]
}
},
"{\"os-type\":\"centos6\"}" : {
"all" : {
"user-guide" : [
{
"key" : {
"id" : "s3",
"image" : "minio/minio:RELEASE.2019-10-12T01-39-57Z",
"name" : "s3-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/s3-server.crt:/root/.minio/certs/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/s3-server.key:/root/.minio/certs/private.key:ro -e MINIO_REGION=us-east-1 -e MINIO_DOMAIN=s3.us-east-1.amazonaws.com -e MINIO_BROWSER=off -e MINIO_ACCESS_KEY=accessKey1 -e MINIO_SECRET_KEY=verySecretKey1",
"os" : "centos6",
"param" : "server /data --address :443",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.2"
}
},
{
"key" : {
"id" : "build",
"image" : "pgbackrest/doc:centos6",
"name" : "build",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos6",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.3"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/libc /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/src /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown -R vagrant /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install make gcc postgresql-devel openssl-devel libxml2-devel"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cd /build/pgbackrest-release-2.24/src && ./configure && make"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg1",
"image" : "pgbackrest/doc:centos6",
"name" : "pg-primary",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos6",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.4"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - General help",
"",
"Usage:",
" pgbackrest [options] [command]",
"",
"Commands:",
" archive-get Get a WAL segment from the archive.",
" archive-push Push a WAL segment to the archive.",
" backup Backup a database cluster.",
" check Check the configuration.",
" expire Expire backups that exceed retention.",
" help Get help.",
" info Retrieve information about backups.",
" restore Restore a database cluster.",
" stanza-create Create the required stanza data.",
" stanza-delete Delete a stanza.",
" stanza-upgrade Upgrade a stanza.",
" start Allow pgBackRest processes to run.",
" stop Stop pgBackRest processes from running.",
" version Get version.",
"",
"Use 'pgbackrest help [command]' for more information."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-9.5/bin/initdb \\",
" -D /var/lib/pgsql/9.5/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"listen_addresses" : {
"value" : "'*'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_line_prefix" : {
"value" : "''"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'",
"log_line_prefix = ''"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_filename" : {
"value" : "'postgresql.log'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.5/data"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c ' \\",
" export PGBACKREST_LOG_PATH=/path/set/by/env && \\",
" pgbackrest --log-level-console=error help backup log-path'"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"current\\: \\/path\\/set\\/by\\/env"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - 'backup' command - 'log-path' option help",
"",
"Path where log files are stored.",
"",
"The log path provides a location for pgBackRest to store log files. Note that",
"if log-level-file=off then no log path is required.",
"",
"current: /path/set/by/env",
"default: /var/log/pgbackrest"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "hot_standby"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = hot_standby"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 restart"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global:archive-push" : {
"compress-level" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-cipher-pass" : {
"value" : "zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO"
},
"repo1-cipher-type" : {
"value" : "aes-256-cbc"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" successfully archived to "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo/9.5-1/0000000100000000/000000010000000000000001-8a394fef522ddcc42a883f8de6b533d68e00723e.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000010000000000000003, lsn = 0/3000028",
" [filtered 851 lines of output]",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/base/1/12216 (0B, 100%)",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/base/1/12211 (0B, 100%)",
"P00 INFO: full backup size = 20.6MB",
"P00 INFO: execute exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000003, lsn = 0/30000F8",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154519F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"diff backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 5 lines of output]",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/pg_log/postgresql.log (1KB, 97%) checksum c9bf49a78acefecc21fdb3125d648135afda96b1",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/backup_label (246B, 100%) checksum 7cf47658fa1a5aebdcf85dd89dcdf5d8cd9dbad9",
"P00 INFO: diff backup size = 9.3KB",
"P00 INFO: execute exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000005, lsn = 0/50000F8",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"(full|incr|diff) backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (9.5-1): 000000010000000000000003/000000010000000000000005",
"",
" full backup: 20200225-154519F",
" timestamp start/stop: 2020-02-25 15:45:19 / 2020-02-25 15:45:33",
" wal start/stop: 000000010000000000000003 / 000000010000000000000003",
" database size: 20.6MB, backup size: 20.6MB",
" repository size: 2.4MB, repository backup size: 2.4MB",
"",
" diff backup: 20200225-154519F_20200225-154535D",
" timestamp start/stop: 2020-02-25 15:45:35 / 2020-02-25 15:45:37",
" wal start/stop: 000000010000000000000005 / 000000010000000000000005",
" database size: 20.6MB, backup size: 9.3KB",
" repository size: 2.4MB, repository backup size: 768B",
" backup reference list: 20200225-154519F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm /var/lib/pgsql/9.5/data/global/pg_control"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -f /var/lib/pgsql/9.5/pgstartup.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"err-expect" : "1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cat /var/lib/pgsql/9.5/pgstartup.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"could not find the database system"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"postmaster: could not find the database system",
"Expected to find it in the directory \"/var/lib/pgsql/9.5/data\",",
"but could not open file \"/var/lib/pgsql/9.5/data/global/pg_control\": No such file or directory"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/pgsql/9.5/data -mindepth 1 -delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the next regular checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --type=incr",
"P00 INFO: last backup label = 20200225-154519F_20200225-154535D, version = 2.24",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000007, lsn = 0/7000028",
"P00 WARN: a timeline switch has occurred since the 20200225-154519F_20200225-154535D backup, enabling delta checksum",
" [filtered 11 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the requested immediate checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast --type=incr",
"P00 INFO: last backup label = 20200225-154519F_20200225-154602I, version = 2.24",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000008, lsn = 0/8000028",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/global/pg_control (8KB, 79%) checksum 0718999129d91209cea3045c0199c3af9d471e11",
" [filtered 10 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 550 /var/lib/pgbackrest/backup/demo/"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"err-expect" : "47",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"ERROR:"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000002000000000000000A, lsn = 0/A000028",
"P00 ERROR: [047]: unable to create path '/var/lib/pgbackrest/backup/demo/20200225-154519F_20200225-154613I': [13] Permission denied",
"P00 INFO: backup command end: aborted with exception [047]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest/backup/demo/"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"err-expect" : "57",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"ERROR:"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast --type=incr",
"P00 INFO: last backup label = 20200225-154519F_20200225-154607I, version = 2.24",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 ERROR: [057]: unable to execute query 'select lsn::text as lsn,",
" pg_catalog.pg_xlogfile_name(lsn)::text as wal_segment_name",
" from pg_catalog.pg_start_backup('pgBackRest backup started at ' || current_timestamp, true) as lsn': ERROR: a backup is already in progress",
" HINT: Run pg_stop_backup() and try again.",
"P00 INFO: backup command end: aborted with exception [057]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"stop-auto" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"stop-auto=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"cluster is already in backup mode|backup begins after the requested immediate checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast --stop-auto --type=incr",
"P00 INFO: last backup label = 20200225-154519F_20200225-154607I, version = 2.24",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 WARN: the cluster is already in backup mode but no pgBackRest backup process is running. pg_stop_backup() will be called so a new backup can be started.",
"P00 INFO: backup start archive = 00000002000000000000000B, lsn = 0/B000028",
"P01 INFO: backup file /var/lib/pgsql/9.5/data/global/pg_control (8KB, 74%) checksum bab5686d045121450597ddb1f070df310d770d0d",
" [filtered 10 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cp -r /pgbackrest/doc/example/* \\",
" /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- An example of monitoring pgBackRest from within PostgreSQL",
"--",
"-- Use copy to export data from the pgBackRest info command into the jsonb",
"-- type so it can be queried directly by PostgreSQL.",
"",
"-- Create monitor schema",
"create schema monitor;",
"",
"-- Get pgBackRest info in JSON format",
"create function monitor.pgbackrest_info()",
" returns jsonb AS $$",
"declare",
" data jsonb;",
"begin",
" -- Create a temp table to hold the JSON data",
" create temp table temp_pgbackrest_data (data jsonb);",
"",
" -- Copy data into the table directly from the pgBackRest info command",
" copy temp_pgbackrest_data (data)",
" from program",
" 'pgbackrest --output=json info' (format text);",
"",
" select temp_pgbackrest_data.data",
" into data",
" from temp_pgbackrest_data;",
"",
" drop table temp_pgbackrest_data;",
"",
" return data;",
"end $$ language plpgsql;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- Get last successful backup for each stanza",
"--",
"-- Requires the monitor.pgbackrest_info function.",
"with stanza as",
"(",
" select data->'name' as name,",
" data->'backup'->(",
" jsonb_array_length(data->'backup') - 1) as last_backup,",
" data->'archive'->(",
" jsonb_array_length(data->'archive') - 1) as current_archive",
" from jsonb_array_elements(monitor.pgbackrest_info()) as data",
")",
"select name,",
" to_timestamp(",
" (last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,",
" current_archive->>'max' as last_archived_wal",
" from stanza;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" name | last_successful_backup | last_archived_wal ",
"--------+------------------------+--------------------------",
" \"demo\" | 2020-02-25 15:46:22+00 | 00000002000000000000000B",
"(1 row)"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"stop-auto=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-154519F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 861 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-154519F, archiveId = 9.5-1, start = 000000010000000000000003",
"P00 DETAIL: no archive to remove, archiveId = 9.5-1",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154627F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire full backup set\\: 20200225-154519F|archive retention on backup 20200225-154627F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 861 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire full backup set: 20200225-154519F, 20200225-154519F_20200225-154535D, 20200225-154519F_20200225-154602I, 20200225-154519F_20200225-154607I, 20200225-154519F_20200225-154618I",
"P00 INFO: remove expired backup 20200225-154519F_20200225-154618I",
"P00 INFO: remove expired backup 20200225-154519F_20200225-154607I",
" [filtered 3 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "1"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=1",
"repo1-retention-full=2",
"start-fast=y",
"stop-auto=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154644F_20200225-154704D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire diff backup set: 20200225-154644F_20200225-154704D"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 13 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=1 --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire diff backup set: 20200225-154644F_20200225-154704D, 20200225-154644F_20200225-154710I",
"P00 INFO: remove expired backup 20200225-154644F_20200225-154710I",
"P00 INFO: remove expired backup 20200225-154644F_20200225-154704D"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"start-fast=y",
"stop-auto=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154644F_20200225-154714D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_xlog();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"new backup label"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 10 lines of output]",
"P00 INFO: backup stop archive = 000000020000000000000015, lsn = 0/150000F8",
"P00 INFO: check archive for segment(s) 000000020000000000000015:000000020000000000000015",
"P00 INFO: new backup label = 20200225-154644F_20200225-154720D",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154644F_20200225-154720D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=detail \\",
" --repo1-retention-archive-type=diff --repo1-retention-archive=1 expire"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-154644F_20200225-154714D|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-archive=1 --repo1-retention-archive-type=diff --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-154627F, archiveId = 9.5-1, start = 00000002000000000000000D, stop = 00000002000000000000000D",
"P00 DETAIL: archive retention on backup 20200225-154644F, archiveId = 9.5-1, start = 00000002000000000000000E, stop = 00000002000000000000000E",
"P00 DETAIL: archive retention on backup 20200225-154644F_20200225-154714D, archiveId = 9.5-1, start = 000000020000000000000012, stop = 000000020000000000000012",
"P00 DETAIL: archive retention on backup 20200225-154644F_20200225-154720D, archiveId = 9.5-1, start = 000000020000000000000015",
"P00 DETAIL: remove archive: archiveId = 9.5-1, start = 00000002000000000000000F, stop = 000000020000000000000011",
"P00 DETAIL: remove archive: archiveId = 9.5-1, start = 000000020000000000000013, stop = 000000020000000000000014",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --log-level-console=detail restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"demo\\/PG_VERSION - exists and matches backup|remove invalid files|rename global\\/pg_control"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 DETAIL: check '/var/lib/pgsql/9.5/data' exists",
"P00 DETAIL: remove 'global/pg_control' so cluster will not start if restore does not complete",
"P00 INFO: remove invalid files/links/paths from '/var/lib/pgsql/9.5/data'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/9.5/data/backup_label.old'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/9.5/data/base/12378/pg_internal.init'",
" [filtered 901 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test2;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test1_table (id int); \\",
" insert into test1_table (id) values (1);\" test1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test2_table (id int); \\",
" insert into test2_table (id) values (2);\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select oid from pg_database where datname = 'test1'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/9.5/data/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"6.9M\t/var/lib/pgsql/9.5/data/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154644F_20200225-154736I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --set=20200225-154644F_20200225-154736I info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"database list"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
" repository size: 4MB, repository backup size: 1.6MB",
" backup reference list: 20200225-154644F, 20200225-154644F_20200225-154720D",
" database list: postgres (12378), test1 (24576), test2 (24577)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --db-include=test2 restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test2_table;\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" id ",
"----",
" 2",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test1_table;\" test1"
],
"err-expect" : "2",
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"relation mapping file.*contains invalid data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"psql: FATAL: relation mapping file \"base/24576/pg_filenode.map\" contains invalid data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/9.5/data/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"152K\t/var/lib/pgsql/9.5/data/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"drop database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"DROP DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select oid, datname from pg_database order by oid;\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"test2"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" oid | datname ",
"-------+-----------",
" 1 | template1",
" 12373 | template0",
" 12378 | postgres",
" 24577 | test2",
"(4 rows)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" create table important_table (message text); \\",
" insert into important_table values ('Important Data'); \\",
" commit; \\",
" select * from important_table;\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select current_timestamp\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2020-02-25 15:48:11.850936+00"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:48:11.850936+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/recovery.conf"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery_target_time"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:48:15",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"recovery_target_time = '2020-02-25 15:48:11.850936+00'",
"recovery_target_action = 'promote'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:48:03 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:48:11.850936+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"00000004000000000000001A\" from archive",
"LOG: redo starts at 0/1A000028",
"LOG: consistent recovery state reached at 0/1A0000F8",
"LOG: restored log file \"00000004000000000000001B\" from archive",
"LOG: recovery stopping before commit of transaction 630, time 2020-02-25 15:48:12.640266+00",
"LOG: redo done at 0/1B01B9C0",
"LOG: last completed transaction was at log time 2020-02-25 15:48:10.074278+00",
"LOG: selected new timeline ID: 5",
"LOG: archive recovery complete",
" [filtered 4 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-154644F_20200225-154824I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"20200225-154644F_20200225-154824I"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (9.5-1): 00000002000000000000000D/00000005000000000000001C",
"",
" full backup: 20200225-154627F",
" timestamp start/stop: 2020-02-25 15:46:27 / 2020-02-25 15:46:42",
" wal start/stop: 00000002000000000000000D / 00000002000000000000000D",
" database size: 20.6MB, backup size: 20.6MB",
" repository size: 2.4MB, repository backup size: 2.4MB",
"",
" full backup: 20200225-154644F",
" timestamp start/stop: 2020-02-25 15:46:44 / 2020-02-25 15:47:00",
" wal start/stop: 00000002000000000000000E / 00000002000000000000000E",
" database size: 20.6MB, backup size: 20.6MB",
" repository size: 2.4MB, repository backup size: 2.4MB",
"",
" diff backup: 20200225-154644F_20200225-154720D",
" timestamp start/stop: 2020-02-25 15:47:20 / 2020-02-25 15:47:23",
" wal start/stop: 000000020000000000000015 / 000000020000000000000015",
" database size: 20.6MB, backup size: 116.4KB",
" repository size: 2.4MB, repository backup size: 12.6KB",
" backup reference list: 20200225-154644F",
"",
" incr backup: 20200225-154644F_20200225-154736I",
" timestamp start/stop: 2020-02-25 15:47:36 / 2020-02-25 15:47:45",
" wal start/stop: 000000030000000000000017 / 000000030000000000000017",
" database size: 33.9MB, backup size: 13.4MB",
" repository size: 4MB, repository backup size: 1.6MB",
" backup reference list: 20200225-154644F, 20200225-154644F_20200225-154720D",
"",
" diff backup: 20200225-154644F_20200225-154802D",
" timestamp start/stop: 2020-02-25 15:48:02 / 2020-02-25 15:48:09",
" wal start/stop: 00000004000000000000001A / 00000004000000000000001A",
" database size: 27.3MB, backup size: 6.9MB",
" repository size: 3.2MB, repository backup size: 831.5KB",
" backup reference list: 20200225-154644F",
"",
" incr backup: 20200225-154644F_20200225-154824I",
" timestamp start/stop: 2020-02-25 15:48:24 / 2020-02-25 15:48:27",
" wal start/stop: 00000005000000000000001C / 00000005000000000000001C",
" database size: 27.3MB, backup size: 2.0MB",
" repository size: 3.2MB, repository backup size: 210KB",
" backup reference list: 20200225-154644F, 20200225-154644F_20200225-154802D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --set=20200225-154644F_20200225-154824I \\",
" --type=time \"--target=2020-02-25 15:48:11.850936+00\" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: select * from important_table",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"starting point-in-time recovery|consistent recovery state reached"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:48:24 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:48:11.850936+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"00000005000000000000001C\" from archive",
"LOG: redo starts at 0/1C000028",
"LOG: consistent recovery state reached at 0/1C0000F8",
"LOG: redo done at 0/1C0000F8",
"LOG: restored log file \"00000005000000000000001C\" from archive",
" [filtered 8 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:48:11.850936+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:48:03 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:48:11.850936+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"00000004000000000000001A\" from archive",
"LOG: redo starts at 0/1A000028",
"LOG: consistent recovery state reached at 0/1A0000F8",
"LOG: restored log file \"00000004000000000000001B\" from archive",
"LOG: recovery stopping before commit of transaction 630, time 2020-02-25 15:48:12.640266+00",
"LOG: redo done at 0/1B01B9C0",
"LOG: last completed transaction was at log time 2020-02-25 15:48:10.074278+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"00000006.history\" from archive",
" [filtered 6 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.2 demo-bucket.s3.us-east-1.amazonaws.com s3.us-east-1.amazonaws.com\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc config host add demo https://172.17.0.2 accessKey1 verySecretKey1 --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc mb demo/demo-bucket --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"process-max" : {
"value" : "4"
},
"repo1-path" : {
"value" : "/demo-repo"
},
"repo1-s3-bucket" : {
"value" : "demo-bucket"
},
"repo1-s3-endpoint" : {
"value" : "s3.us-east-1.amazonaws.com"
},
"repo1-s3-key" : {
"value" : "accessKey1"
},
"repo1-s3-key-secret" : {
"value" : "verySecretKey1"
},
"repo1-s3-region" : {
"value" : "us-east-1"
},
"repo1-type" : {
"value" : "s3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"process-max=4",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/demo-repo",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo1-s3-bucket=demo-bucket",
"repo1-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo1-s3-key=accessKey1",
"repo1-s3-key-secret=verySecretKey1",
"repo1-s3-region=us-east-1",
"repo1-type=s3",
"start-fast=y",
"stop-auto=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 12, retries 0, closes 0",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --process-max=4 --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo --start-fast --stop-auto",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000007000000000000001C, lsn = 0/1C000028",
" [filtered 1119 lines of output]",
"P03 INFO: backup file /var/lib/pgsql/9.5/data/base/1/12216 (0B, 100%)",
"P04 INFO: backup file /var/lib/pgsql/9.5/data/base/1/12211 (0B, 100%)",
"P00 INFO: full backup size = 27.3MB",
"P00 INFO: execute exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 00000007000000000000001C, lsn = 0/1C000130",
" [filtered 7 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stop"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stop command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: stop command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-delete"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-delete command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 15, retries 0, closes 0",
"P00 INFO: stanza-delete command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "repo1",
"image" : "pgbackrest/doc:centos6",
"name" : "repository",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos6",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.5"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo groupadd pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo adduser -gpgbackrest -n pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 /home/pgbackrest/.ssh"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh-keygen -f /home/pgbackrest/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/pgsql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/pgsql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-primary cat /var/lib/pgsql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/pgsql/.ssh/authorized_keys"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-primary"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-host" : {
"value" : "pg-primary"
},
"pg1-path" : {
"value" : "/var/lib/pgsql/9.5/data"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-retention-full" : {
"value" : "2"
},
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.5/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
},
"reset" : true
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo stanza-create"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: no prior backup exists, incr backup has been changed to full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"process-max" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"timestamp start/stop"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: none",
"",
" db (current)",
" wal archive min/max (9.5-1): 000000080000000000000022/000000080000000000000024",
"",
" full backup: 20200225-155011F",
" timestamp start/stop: 2020-02-25 15:50:11 / 2020-02-25 15:50:28",
" wal start/stop: 000000080000000000000022 / 000000080000000000000022",
" database size: 27.3MB, backup size: 27.3MB",
" repository size: 3.2MB, repository backup size: 3.2MB",
"",
" full backup: 20200225-155033F",
" timestamp start/stop: 2020-02-25 15:50:33 / 2020-02-25 15:50:41",
" wal start/stop: 000000080000000000000024 / 000000080000000000000024",
" database size: 27.3MB, backup size: 27.3MB",
" repository size: 3.2MB, repository backup size: 3.2MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for all stanzas"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for all stanzas",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: stop file already exists for all stanzas"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for stanza demo"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for stanza demo",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg2",
"image" : "pgbackrest/doc:centos6",
"name" : "pg-standby",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos6",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.6"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/pgsql/.ssh"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/pgsql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-standby cat /var/lib/pgsql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/pgsql/.ssh/authorized_keys"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-standby"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.5/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /var/lib/pgsql/9.5/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:51:20",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"hot_standby" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "hot_standby"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = hot_standby"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"entering standby mode|database system is ready to accept read only connections"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:50:34 UTC",
"LOG: entering standby mode",
"LOG: restored log file \"00000008.history\" from archive",
"LOG: restored log file \"000000080000000000000024\" from archive",
"LOG: redo starts at 0/24000028",
"LOG: consistent recovery state reached at 0/240000F8",
"LOG: database system is ready to accept read only connections"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table replicated_table (message text); \\",
" insert into replicated_table values ('Important Data'); \\",
" commit; \\",
" select * from replicated_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from replicated_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"replicated_table\" does not exist",
"LINE 1: select * from replicated_table;",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select *, current_timestamp from pg_switch_xlog()\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" pg_switch_xlog | now ",
"----------------+-----------------------------",
" 0/2501F408 | 2020-02-25 15:51:31.9521+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from replicated_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+------------------------------",
" Important Data | 2020-02-25 15:51:37.96339+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"because this is a standby"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-host=repository --stanza=demo",
"P00 INFO: switch wal not performed because this is a standby",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create user replicator password 'jw8s0F4' replication\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"host replication replicator 172.17.0.6/32 md5\" \\",
" >> /var/lib/pgsql/9.5/data/pg_hba.conf'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 reload"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"recovery-option" : {
"value" : "primary_conninfo=host=172.17.0.4 port=5432 user=replicator"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"172.17.0.4:*:replication:replicator:jw8s0F4\" \\",
" >> /var/lib/pgsql/.pgpass'"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres chmod 600 /var/lib/pgsql/.pgpass"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:51:49",
"primary_conninfo = 'host=172.17.0.4 port=5432 user=replicator'",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.5/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = hot_standby"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.5/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"started streaming WAL from primary"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: restored log file \"000000080000000000000025\" from archive",
"LOG: started streaming WAL from primary at 0/26000000 on timeline 8"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table stream_table (message text); \\",
" insert into stream_table values ('Important Data'); \\",
" commit; \\",
" select *, current_timestamp from stream_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 15:51:59.787809+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from stream_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 15:52:00.623478+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.5/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'bogus'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 restart"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm -f /var/log/pgbackrest/demo-archive-push-async.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"WAL segment"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --repo1-host=repository --stanza=demo",
"P00 INFO: WAL segment 00000008000000000000002B successfully archived to '/var/lib/pgbackrest/archive/demo/9.5-1/0000000800000000/00000008000000000000002B-9636ca085633a772706fc2ec7584a49091a44934.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-push-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" WAL file\\(s\\) to archive|pushed WAL file \\'0000000"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/pgsql/9.5/data/pg_xlog] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000080000000000000026",
"P01 DETAIL: pushed WAL file '000000080000000000000026' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/pgsql/9.5/data/pg_xlog] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 5 WAL file(s) to archive: 000000080000000000000027...00000008000000000000002B",
"P01 DETAIL: pushed WAL file '000000080000000000000027' to the archive",
"P02 DETAIL: pushed WAL file '000000080000000000000028' to the archive",
"P01 DETAIL: pushed WAL file '000000080000000000000029' to the archive",
"P02 DETAIL: pushed WAL file '00000008000000000000002A' to the archive",
"P01 DETAIL: pushed WAL file '00000008000000000000002B' to the archive",
"P00 INFO: archive-push:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 5"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-get-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"found [0-F]{24} in the archive"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000024, 000000080000000000000025, 000000080000000000000026, 000000080000000000000027, 000000080000000000000028, 000000080000000000000029, 00000008000000000000002A, 00000008000000000000002B] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000024...00000008000000000000002B",
"P01 DETAIL: found 000000080000000000000024 in the archive",
"P02 DETAIL: found 000000080000000000000025 in the archive",
"P01 DETAIL: unable to find 000000080000000000000026 in the archive",
"P02 DETAIL: unable to find 000000080000000000000027 in the archive",
" [filtered 20 lines of output]",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000026, 000000080000000000000027, 000000080000000000000028, 000000080000000000000029, 00000008000000000000002A, 00000008000000000000002B, 00000008000000000000002C, 00000008000000000000002D] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.5/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000026...00000008000000000000002D",
"P01 DETAIL: found 000000080000000000000026 in the archive",
"P02 DETAIL: found 000000080000000000000027 in the archive",
"P01 DETAIL: found 000000080000000000000028 in the archive",
"P02 DETAIL: found 000000080000000000000029 in the archive",
"P01 DETAIL: found 00000008000000000000002A in the archive",
"P02 DETAIL: found 00000008000000000000002B in the archive",
"P01 DETAIL: unable to find 00000008000000000000002C in the archive",
"P02 DETAIL: unable to find 00000008000000000000002D in the archive",
" [filtered 13 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'jw8s0F4'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg2-host" : {
"value" : "pg-standby"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/9.5/data"
}
},
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.5/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/9.5/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup file pg-primary|replay on the standby"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000008000000000000002D, lsn = 0/2D000028",
"P00 INFO: wait for replay on the standby to reach 0/2D000028",
"P00 INFO: replay on the standby reached 0/2D000028",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.5/data/global/pg_control (8KB, 0%) checksum 29e0bf6a5e893e652573cd5bc3ef180ee72f5987",
"P02 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2608 (432KB, 20%) checksum 72dae3e124342546f590f36a56f1233c198190c7",
"P03 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2674 (360KB, 37%) checksum 7cd230de39562539e6e87b09e4bdeaa66534702f",
"P04 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/1249 (360KB, 53%) checksum 318644cbbe1b3d8ac9af7658843aed4b733fe397",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.5/data/pg_log/postgresql.log (7.7KB, 54%) checksum 79715a4135445e15ca87a29bb1f47f3a80ccbe67",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.5/data/pg_hba.conf (4.2KB, 54%) checksum 1c0bca2f7f44d354aaaefb2c21fd1290b7379690",
"P02 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2673 (312KB, 68%) checksum 27282dbbccf37a93c7a466d805bb11cf4ca60dd7",
"P03 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2658 (112KB, 74%) checksum 7716a0b4bcc3d6e4b28bd1e3a6b5ad45791762cc",
"P04 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/1259 (104KB, 78%) checksum aaadf29afc16da7f91f642605303a6503caf651c",
"P02 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2659 (72KB, 82%) checksum 6876f068e02a729fdebd23559aaead569f5824e3",
"P03 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/1247 (72KB, 85%) checksum c9a46ac0b81e6b32ccb7e317ce968ed30d0b4ca2",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.5/data/backup_label (247B, 85%) checksum ffd7c14e443b18c1fe3c0dc0b4dee231651d3161",
"P04 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2704 (40KB, 87%) checksum 9953ec811bf244ff8413ffe6ca68291e00452e81",
"P02 INFO: backup file pg-standby:/var/lib/pgsql/9.5/data/base/12378/2663 (40KB, 89%) checksum 459a32b66ab3efa8b524bcf58e836e5a41c6c9b6",
" [filtered 1122 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.5 stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-9.6/bin/initdb \\",
" -D /var/lib/pgsql/9.6/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'cd /var/lib/pgsql && \\",
" /usr/pgsql-9.6/bin/pg_upgrade \\",
" --old-bindir=/usr/pgsql-9.5/bin \\",
" --new-bindir=/usr/pgsql-9.6/bin \\",
" --old-datadir=/var/lib/pgsql/9.5/data \\",
" --new-datadir=/var/lib/pgsql/9.6/data \\",
" --old-options=\" -c config_file=/var/lib/pgsql/9.5/data/postgresql.conf\" \\",
" --new-options=\" -c config_file=/var/lib/pgsql/9.6/data/postgresql.conf\"'"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Upgrade Complete"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 69 lines of output]",
"Creating script to delete old cluster ok",
"",
"Upgrade Complete",
"----------------",
"Optimizer statistics are not transferred by pg_upgrade so,",
" [filtered 4 lines of output]"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"listen_addresses" : {
"value" : "'*'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"port" : {
"value" : "5432"
},
"wal_level" : {
"value" : "hot_standby"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"port = 5432",
"wal_level = hot_standby"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"backup-standby" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.6/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"backup-standby=n",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp /var/lib/pgsql/9.5/data/pg_hba.conf \\",
" /var/lib/pgsql/9.6/data/pg_hba.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --no-online \\",
" --log-level-console=info stanza-upgrade"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-upgrade command begin 2.24: --no-backup-standby --log-level-console=info --log-level-stderr=off --no-log-timestamp --no-online --pg1-host=pg-primary --pg2-host=pg-standby --pg1-path=/var/lib/pgsql/9.6/data --pg2-path=/var/lib/pgsql/9.6/data --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-upgrade command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.6 start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Starting postgresql-9.6 service: [ OK ]\r"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres service postgresql-9.6 status"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"postgresql-9.6 (pid 4828) is running..."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/9.5/data"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/9.5/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /usr/pgsql-9.6/bin"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-2: [DbConnectError] raised from remote-0 protocol on 'pg-standby': unable to connect to 'dbname='postgres' port=5432': could not connect to server: No such file or directory",
" \tIs the server running locally and accepting",
" \tconnections on Unix domain socket \"/var/run/postgresql/.s.PGSQL.5432\"?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"hot_standby = on"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo service postgresql-9.6 start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.6/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
}
]
}
},
"{\"os-type\":\"centos7\"}" : {
"all" : {
"user-guide" : [
{
"key" : {
"id" : "s3",
"image" : "minio/minio:RELEASE.2019-10-12T01-39-57Z",
"name" : "s3-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/s3-server.crt:/root/.minio/certs/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/s3-server.key:/root/.minio/certs/private.key:ro -e MINIO_REGION=us-east-1 -e MINIO_DOMAIN=s3.us-east-1.amazonaws.com -e MINIO_BROWSER=off -e MINIO_ACCESS_KEY=accessKey1 -e MINIO_SECRET_KEY=verySecretKey1",
"os" : "centos7",
"param" : "server /data --address :443",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.2"
}
},
{
"key" : {
"id" : "build",
"image" : "pgbackrest/doc:centos7",
"name" : "build",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos7",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.3"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/libc /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/src /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown -R vagrant /build/pgbackrest-release-2.24"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install make gcc postgresql-devel openssl-devel libxml2-devel"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cd /build/pgbackrest-release-2.24/src && ./configure && make"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg1",
"image" : "pgbackrest/doc:centos7",
"name" : "pg-primary",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos7",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.4"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - General help",
"",
"Usage:",
" pgbackrest [options] [command]",
"",
"Commands:",
" archive-get Get a WAL segment from the archive.",
" archive-push Push a WAL segment to the archive.",
" backup Backup a database cluster.",
" check Check the configuration.",
" expire Expire backups that exceed retention.",
" help Get help.",
" info Retrieve information about backups.",
" restore Restore a database cluster.",
" stanza-create Create the required stanza data.",
" stanza-delete Delete a stanza.",
" stanza-upgrade Upgrade a stanza.",
" start Allow pgBackRest processes to run.",
" stop Stop pgBackRest processes from running.",
" version Get version.",
"",
"Use 'pgbackrest help [command]' for more information."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-9.6/bin/initdb \\",
" -D /var/lib/pgsql/9.6/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"listen_addresses" : {
"value" : "'*'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_line_prefix" : {
"value" : "''"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'",
"log_line_prefix = ''"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_filename" : {
"value" : "'postgresql.log'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"listen_addresses = '*'",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c ' \\",
" export PGBACKREST_LOG_PATH=/path/set/by/env && \\",
" pgbackrest --log-level-console=error help backup log-path'"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"current\\: \\/path\\/set\\/by\\/env"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.24 - 'backup' command - 'log-path' option help",
"",
"Path where log files are stored.",
"",
"The log path provides a location for pgBackRest to store log files. Note that",
"if log-level-file=off then no log path is required.",
"",
"current: /path/set/by/env",
"default: /var/log/pgbackrest"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl restart postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global:archive-push" : {
"compress-level" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-cipher-pass" : {
"value" : "zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO"
},
"repo1-cipher-type" : {
"value" : "aes-256-cbc"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" successfully archived to "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo/9.6-1/0000000100000000/000000010000000000000001-678199a8e30e3fa81c013c5737328a1e10fdf26e.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000010000000000000002, lsn = 0/2000028",
" [filtered 864 lines of output]",
"P01 INFO: backup file /var/lib/pgsql/9.6/data/base/1/12312 (0B, 100%)",
"P01 INFO: backup file /var/lib/pgsql/9.6/data/base/1/12307 (0B, 100%)",
"P00 INFO: full backup size = 20.9MB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000002, lsn = 0/2000130",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153556F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"diff backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 3 lines of output]",
"P00 INFO: backup start archive = 000000010000000000000003, lsn = 0/3000028",
"P01 INFO: backup file /var/lib/pgsql/9.6/data/global/pg_control (8KB, 100%) checksum bbdf90b3c6c64dbeff949e642a47b7f2fc18848c",
"P00 INFO: diff backup size = 8KB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000010000000000000003, lsn = 0/30000F8",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"(full|incr|diff) backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (9.6-1): 000000010000000000000002/000000010000000000000003",
"",
" full backup: 20200225-153556F",
" timestamp start/stop: 2020-02-25 15:35:56 / 2020-02-25 15:36:08",
" wal start/stop: 000000010000000000000002 / 000000010000000000000002",
" database size: 20.9MB, backup size: 20.9MB",
" repository size: 2.5MB, repository backup size: 2.5MB",
"",
" diff backup: 20200225-153556F_20200225-153610D",
" timestamp start/stop: 2020-02-25 15:36:10 / 2020-02-25 15:36:12",
" wal start/stop: 000000010000000000000003 / 000000010000000000000003",
" database size: 20.9MB, backup size: 8.2KB",
" repository size: 2.5MB, repository backup size: 400B",
" backup reference list: 20200225-153556F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm /var/lib/pgsql/9.6/data/global/pg_control"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"err-expect" : "1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl status postgresql-9.6.service"
],
"err-expect" : "3",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Failed to start PostgreSQL"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"Feb 25 15:36:15 pg-primary postmaster[829]: but could not open file \"/var/lib/pgsql/9.6/data/global/pg_control\": No such file or directory",
"Feb 25 15:36:15 pg-primary systemd[1]: postgresql-9.6.service: main process exited, code=exited, status=2/INVALIDARGUMENT",
"Feb 25 15:36:15 pg-primary systemd[1]: Failed to start PostgreSQL 9.6 database server.",
"Feb 25 15:36:15 pg-primary systemd[1]: Unit postgresql-9.6.service entered failed state.",
"Feb 25 15:36:15 pg-primary systemd[1]: postgresql-9.6.service failed."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/pgsql/9.6/data -mindepth 1 -delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the next regular checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --type=incr",
"P00 INFO: last backup label = 20200225-153556F_20200225-153610D, version = 2.24",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the next regular checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000005, lsn = 0/5000028",
"P00 WARN: a timeline switch has occurred since the 20200225-153556F_20200225-153610D backup, enabling delta checksum",
" [filtered 10 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup begins after the requested immediate checkpoint completes"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast --type=incr",
"P00 INFO: last backup label = 20200225-153556F_20200225-153632I, version = 2.24",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000020000000000000006, lsn = 0/6000028",
"P01 INFO: backup file /var/lib/pgsql/9.6/data/global/pg_control (8KB, 100%) checksum f71be2d014c28811235dcd9706bc60bda08a685d",
" [filtered 8 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cp -r /pgbackrest/doc/example/* \\",
" /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- An example of monitoring pgBackRest from within PostgreSQL",
"--",
"-- Use copy to export data from the pgBackRest info command into the jsonb",
"-- type so it can be queried directly by PostgreSQL.",
"",
"-- Create monitor schema",
"create schema monitor;",
"",
"-- Get pgBackRest info in JSON format",
"create function monitor.pgbackrest_info()",
" returns jsonb AS $$",
"declare",
" data jsonb;",
"begin",
" -- Create a temp table to hold the JSON data",
" create temp table temp_pgbackrest_data (data jsonb);",
"",
" -- Copy data into the table directly from the pgBackRest info command",
" copy temp_pgbackrest_data (data)",
" from program",
" 'pgbackrest --output=json info' (format text);",
"",
" select temp_pgbackrest_data.data",
" into data",
" from temp_pgbackrest_data;",
"",
" drop table temp_pgbackrest_data;",
"",
" return data;",
"end $$ language plpgsql;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- Get last successful backup for each stanza",
"--",
"-- Requires the monitor.pgbackrest_info function.",
"with stanza as",
"(",
" select data->'name' as name,",
" data->'backup'->(",
" jsonb_array_length(data->'backup') - 1) as last_backup,",
" data->'archive'->(",
" jsonb_array_length(data->'archive') - 1) as current_archive",
" from jsonb_array_elements(monitor.pgbackrest_info()) as data",
")",
"select name,",
" to_timestamp(",
" (last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,",
" current_archive->>'max' as last_archived_wal",
" from stanza;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" name | last_successful_backup | last_archived_wal ",
"--------+------------------------+--------------------------",
" \"demo\" | 2020-02-25 15:36:41+00 | 000000020000000000000006",
"(1 row)"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-153556F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 875 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-153556F, archiveId = 9.6-1, start = 000000010000000000000002",
"P00 DETAIL: no archive to remove, archiveId = 9.6-1",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153647F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire full backup set\\: 20200225-153556F|archive retention on backup 20200225-153647F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 874 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire full backup set: 20200225-153556F, 20200225-153556F_20200225-153610D, 20200225-153556F_20200225-153632I, 20200225-153556F_20200225-153639I",
"P00 INFO: remove expired backup 20200225-153556F_20200225-153639I",
"P00 INFO: remove expired backup 20200225-153556F_20200225-153632I",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "1"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=1",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153703F_20200225-153722D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire diff backup set: 20200225-153703F_20200225-153722D"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=1 --repo1-retention-full=2 --stanza=demo",
"P00 INFO: expire diff backup set: 20200225-153703F_20200225-153722D, 20200225-153703F_20200225-153727I",
"P00 INFO: remove expired backup 20200225-153703F_20200225-153727I",
"P00 INFO: remove expired backup 20200225-153703F_20200225-153722D"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153703F_20200225-153731D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_xlog();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"new backup label"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 9 lines of output]",
"P00 INFO: backup stop archive = 00000002000000000000000F, lsn = 0/F0000F8",
"P00 INFO: check archive for segment(s) 00000002000000000000000F:00000002000000000000000F",
"P00 INFO: new backup label = 20200225-153703F_20200225-153737D",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153703F_20200225-153737D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=detail \\",
" --repo1-retention-archive-type=diff --repo1-retention-archive=1 expire"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20200225-153703F_20200225-153731D|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: expire command begin 2.24: --log-level-console=detail --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-archive=1 --repo1-retention-archive-type=diff --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: archive retention on backup 20200225-153647F, archiveId = 9.6-1, start = 000000020000000000000008, stop = 000000020000000000000008",
"P00 DETAIL: archive retention on backup 20200225-153703F, archiveId = 9.6-1, start = 000000020000000000000009, stop = 000000020000000000000009",
"P00 DETAIL: archive retention on backup 20200225-153703F_20200225-153731D, archiveId = 9.6-1, start = 00000002000000000000000C, stop = 00000002000000000000000C",
"P00 DETAIL: archive retention on backup 20200225-153703F_20200225-153737D, archiveId = 9.6-1, start = 00000002000000000000000F",
"P00 DETAIL: remove archive: archiveId = 9.6-1, start = 00000002000000000000000A, stop = 00000002000000000000000B",
"P00 DETAIL: remove archive: archiveId = 9.6-1, start = 00000002000000000000000D, stop = 00000002000000000000000E",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --log-level-console=detail restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"demo\\/PG_VERSION - exists and matches backup|remove invalid files|rename global\\/pg_control"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 DETAIL: check '/var/lib/pgsql/9.6/data' exists",
"P00 DETAIL: remove 'global/pg_control' so cluster will not start if restore does not complete",
"P00 INFO: remove invalid files/links/paths from '/var/lib/pgsql/9.6/data'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/9.6/data/backup_label.old'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/9.6/data/base/12470/pg_internal.init'",
" [filtered 914 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test2;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test1_table (id int); \\",
" insert into test1_table (id) values (1);\" test1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test2_table (id int); \\",
" insert into test2_table (id) values (2);\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select oid from pg_database where datname = 'test1'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/9.6/data/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"7.0M\t/var/lib/pgsql/9.6/data/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153703F_20200225-153751I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --set=20200225-153703F_20200225-153751I info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"database list"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
" repository size: 4MB, repository backup size: 1.6MB",
" backup reference list: 20200225-153703F, 20200225-153703F_20200225-153737D",
" database list: postgres (12470), test1 (24576), test2 (24577)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --db-include=test2 restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test2_table;\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" id ",
"----",
" 2",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test1_table;\" test1"
],
"err-expect" : "2",
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"relation mapping file.*contains invalid data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"psql: FATAL: relation mapping file \"base/24576/pg_filenode.map\" contains invalid data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/9.6/data/base/24576"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"152K\t/var/lib/pgsql/9.6/data/base/24576"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"drop database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"DROP DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select oid, datname from pg_database order by oid;\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"test2"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" oid | datname ",
"-------+-----------",
" 1 | template1",
" 12469 | template0",
" 12470 | postgres",
" 24577 | test2",
"(4 rows)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" create table important_table (message text); \\",
" insert into important_table values ('Important Data'); \\",
" commit; \\",
" select * from important_table;\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select current_timestamp\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2020-02-25 15:38:19.667152+00"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:38:19.667152+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/recovery.conf"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery_target_time"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:38:22",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"recovery_target_time = '2020-02-25 15:38:19.667152+00'",
"recovery_target_action = 'promote'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:38:12 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:38:19.667152+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"000000040000000000000014\" from archive",
"LOG: redo starts at 0/14000028",
"LOG: consistent recovery state reached at 0/140000F8",
"LOG: restored log file \"000000040000000000000015\" from archive",
"LOG: recovery stopping before commit of transaction 639, time 2020-02-25 15:38:20.508039+00",
"LOG: redo done at 0/15020E68",
"LOG: last completed transaction was at log time 2020-02-25 15:38:19.356847+00",
"LOG: selected new timeline ID: 5",
"LOG: archive recovery complete",
" [filtered 3 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20200225-153703F_20200225-153830I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"20200225-153703F_20200225-153830I"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (9.6-1): 000000020000000000000008/000000050000000000000016",
"",
" full backup: 20200225-153647F",
" timestamp start/stop: 2020-02-25 15:36:47 / 2020-02-25 15:37:01",
" wal start/stop: 000000020000000000000008 / 000000020000000000000008",
" database size: 20.9MB, backup size: 20.9MB",
" repository size: 2.5MB, repository backup size: 2.5MB",
"",
" full backup: 20200225-153703F",
" timestamp start/stop: 2020-02-25 15:37:03 / 2020-02-25 15:37:18",
" wal start/stop: 000000020000000000000009 / 000000020000000000000009",
" database size: 20.9MB, backup size: 20.9MB",
" repository size: 2.5MB, repository backup size: 2.5MB",
"",
" diff backup: 20200225-153703F_20200225-153737D",
" timestamp start/stop: 2020-02-25 15:37:37 / 2020-02-25 15:37:40",
" wal start/stop: 00000002000000000000000F / 00000002000000000000000F",
" database size: 20.9MB, backup size: 97.6KB",
" repository size: 2.5MB, repository backup size: 11.8KB",
" backup reference list: 20200225-153703F",
"",
" incr backup: 20200225-153703F_20200225-153751I",
" timestamp start/stop: 2020-02-25 15:37:51 / 2020-02-25 15:37:59",
" wal start/stop: 000000030000000000000011 / 000000030000000000000011",
" database size: 34.5MB, backup size: 13.7MB",
" repository size: 4MB, repository backup size: 1.6MB",
" backup reference list: 20200225-153703F, 20200225-153703F_20200225-153737D",
"",
" diff backup: 20200225-153703F_20200225-153812D",
" timestamp start/stop: 2020-02-25 15:38:12 / 2020-02-25 15:38:18",
" wal start/stop: 000000040000000000000014 / 000000040000000000000014",
" database size: 27.8MB, backup size: 7.0MB",
" repository size: 3.3MB, repository backup size: 846.9KB",
" backup reference list: 20200225-153703F",
"",
" incr backup: 20200225-153703F_20200225-153830I",
" timestamp start/stop: 2020-02-25 15:38:30 / 2020-02-25 15:38:33",
" wal start/stop: 000000050000000000000016 / 000000050000000000000016",
" database size: 27.7MB, backup size: 2MB",
" repository size: 3.3MB, repository backup size: 211.4KB",
" backup reference list: 20200225-153703F, 20200225-153703F_20200225-153812D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --set=20200225-153703F_20200225-153830I \\",
" --type=time \"--target=2020-02-25 15:38:19.667152+00\" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: select * from important_table",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"starting point-in-time recovery|consistent recovery state reached"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:38:30 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:38:19.667152+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"000000050000000000000016\" from archive",
"LOG: redo starts at 0/16000028",
"LOG: consistent recovery state reached at 0/160000F8",
"LOG: redo done at 0/160000F8",
"LOG: restored log file \"000000050000000000000016\" from archive",
" [filtered 7 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2020-02-25 15:38:19.667152+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:38:12 UTC",
"LOG: starting point-in-time recovery to 2020-02-25 15:38:19.667152+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"000000040000000000000014\" from archive",
"LOG: redo starts at 0/14000028",
"LOG: consistent recovery state reached at 0/140000F8",
"LOG: restored log file \"000000040000000000000015\" from archive",
"LOG: recovery stopping before commit of transaction 639, time 2020-02-25 15:38:20.508039+00",
"LOG: redo done at 0/15020E68",
"LOG: last completed transaction was at log time 2020-02-25 15:38:19.356847+00",
"LOG: restored log file \"00000005.history\" from archive",
"LOG: restored log file \"00000006.history\" from archive",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.2 demo-bucket.s3.us-east-1.amazonaws.com s3.us-east-1.amazonaws.com\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc config host add demo https://172.17.0.2 accessKey1 verySecretKey1 --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc mb demo/demo-bucket --insecure"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"process-max" : {
"value" : "4"
},
"repo1-path" : {
"value" : "/demo-repo"
},
"repo1-s3-bucket" : {
"value" : "demo-bucket"
},
"repo1-s3-endpoint" : {
"value" : "s3.us-east-1.amazonaws.com"
},
"repo1-s3-key" : {
"value" : "accessKey1"
},
"repo1-s3-key-secret" : {
"value" : "verySecretKey1"
},
"repo1-s3-region" : {
"value" : "us-east-1"
},
"repo1-type" : {
"value" : "s3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"process-max=4",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/demo-repo",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo1-s3-bucket=demo-bucket",
"repo1-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo1-s3-key=accessKey1",
"repo1-s3-key-secret=verySecretKey1",
"repo1-s3-region=us-east-1",
"repo1-type=s3",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 12, retries 0, closes 0",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=4 --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000070000000000000016, lsn = 0/16000028",
" [filtered 1136 lines of output]",
"P02 INFO: backup file /var/lib/pgsql/9.6/data/base/1/12312 (0B, 100%)",
"P03 INFO: backup file /var/lib/pgsql/9.6/data/base/1/12307 (0B, 100%)",
"P00 INFO: full backup size = 27.8MB",
"P00 INFO: execute non-exclusive pg_stop_backup() and wait for all WAL segments to archive",
"P00 INFO: backup stop archive = 000000070000000000000016, lsn = 0/160000F8",
" [filtered 7 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stop"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stop command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: stop command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-delete"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-delete command begin 2.24: --log-level-console=info --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/demo-repo --repo1-s3-bucket=demo-bucket --repo1-s3-endpoint=s3.us-east-1.amazonaws.com --repo1-s3-key= --repo1-s3-key-secret= --repo1-s3-region=us-east-1 --repo1-type=s3 --stanza=demo",
"P00 INFO: http statistics: objects 2, sessions 2, requests 15, retries 0, closes 0",
"P00 INFO: stanza-delete command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "repo1",
"image" : "pgbackrest/doc:centos7",
"name" : "repository",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos7",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.5"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo groupadd pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo adduser -gpgbackrest -n pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 /home/pgbackrest/.ssh"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh-keygen -f /home/pgbackrest/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/pgsql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/pgsql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-primary cat /var/lib/pgsql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/pgsql/.ssh/authorized_keys"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-primary"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-host" : {
"value" : "pg-primary"
},
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-retention-full" : {
"value" : "2"
},
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
},
"reset" : true
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo stanza-create"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: no prior backup exists, incr backup has been changed to full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"process-max" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"timestamp start/stop"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: none",
"",
" db (current)",
" wal archive min/max (9.6-1): 00000008000000000000001E/000000080000000000000020",
"",
" full backup: 20200225-154011F",
" timestamp start/stop: 2020-02-25 15:40:11 / 2020-02-25 15:40:28",
" wal start/stop: 00000008000000000000001E / 00000008000000000000001E",
" database size: 27.8MB, backup size: 27.8MB",
" repository size: 3.3MB, repository backup size: 3.3MB",
"",
" full backup: 20200225-154033F",
" timestamp start/stop: 2020-02-25 15:40:33 / 2020-02-25 15:40:41",
" wal start/stop: 000000080000000000000020 / 000000080000000000000020",
" database size: 27.8MB, backup size: 27.8MB",
" repository size: 3.3MB, repository backup size: 3.3MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for all stanzas"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for all stanzas",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: stop file already exists for all stanzas"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for stanza demo"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-1: [StopError] raised from remote-0 protocol on 'pg-primary': stop file exists for stanza demo",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg2",
"image" : "pgbackrest/doc:centos7",
"name" : "pg-standby",
"option" : "-v /sys/fs/cgroup:/sys/fs/cgroup:rw -v /tmp/$(mktemp -d):/run",
"os" : "centos7",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.6"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest-release-2.24/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/pgsql/.ssh"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/pgsql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-standby cat /var/lib/pgsql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/pgsql/.ssh/authorized_keys"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-standby"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-level-stderr" : {
"value" : "off"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /var/lib/pgsql/9.6/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:41:21",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"hot_standby" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"entering standby mode|database system is ready to accept read only connections"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"LOG: database system was interrupted; last known up at 2020-02-25 15:40:33 UTC",
"LOG: entering standby mode",
"LOG: restored log file \"00000008.history\" from archive",
"LOG: restored log file \"000000080000000000000020\" from archive",
"LOG: redo starts at 0/20000028",
"LOG: consistent recovery state reached at 0/200000F8",
"LOG: database system is ready to accept read only connections"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table replicated_table (message text); \\",
" insert into replicated_table values ('Important Data'); \\",
" commit; \\",
" select * from replicated_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from replicated_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"replicated_table\" does not exist",
"LINE 1: select * from replicated_table;",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select *, current_timestamp from pg_switch_xlog()\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" pg_switch_xlog | now ",
"----------------+-------------------------------",
" 0/21022420 | 2020-02-25 15:41:32.487458+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from replicated_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 15:41:37.390425+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"because this is a standby"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-host=repository --stanza=demo",
"P00 INFO: switch wal not performed because this is a standby",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create user replicator password 'jw8s0F4' replication\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"host replication replicator 172.17.0.6/32 md5\" \\",
" >> /var/lib/pgsql/9.6/data/pg_hba.conf'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl reload postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"recovery-option" : {
"value" : "primary_conninfo=host=172.17.0.4 port=5432 user=replicator"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"172.17.0.4:*:replication:replicator:jw8s0F4\" \\",
" >> /var/lib/pgsql/.pgpass'"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres chmod 600 /var/lib/pgsql/.pgpass"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/recovery.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Recovery settings generated by pgBackRest restore on 2020-02-25 15:41:46",
"primary_conninfo = 'host=172.17.0.4 port=5432 user=replicator'",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"standby_mode = 'on'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/9.6/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-9.6.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/9.6/data/pg_log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"started streaming WAL from primary"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: restored log file \"000000080000000000000021\" from archive",
"LOG: started streaming WAL from primary at 0/22000000 on timeline 8"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table stream_table (message text); \\",
" insert into stream_table values ('Important Data'); \\",
" commit; \\",
" select *, current_timestamp from stream_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 15:41:55.734509+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from stream_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | now ",
"----------------+-------------------------------",
" Important Data | 2020-02-25 15:41:56.057408+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/9.6/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'bogus'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl restart postgresql-9.6.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm -f /var/log/pgbackrest/demo-archive-push-async.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_xlog();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"WAL segment"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.24: --log-level-console=info --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --repo1-host=repository --stanza=demo",
"P00 INFO: WAL segment 000000080000000000000027 successfully archived to '/var/lib/pgbackrest/archive/demo/9.6-1/0000000800000000/000000080000000000000027-a4ce3409ea94461233ca162f90c90373a13c779e.gz'",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-push-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" WAL file\\(s\\) to archive|pushed WAL file \\'0000000"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/pgsql/9.6/data/pg_xlog] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000080000000000000022",
"P01 DETAIL: pushed WAL file '000000080000000000000022' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/pgsql/9.6/data/pg_xlog] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 4 WAL file(s) to archive: 000000080000000000000023...000000080000000000000026",
"P01 DETAIL: pushed WAL file '000000080000000000000023' to the archive",
"P02 DETAIL: pushed WAL file '000000080000000000000024' to the archive",
"P01 DETAIL: pushed WAL file '000000080000000000000025' to the archive",
"P02 DETAIL: pushed WAL file '000000080000000000000026' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.24: [/var/lib/pgsql/9.6/data/pg_xlog] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000080000000000000027",
"P01 DETAIL: pushed WAL file '000000080000000000000027' to the archive",
"P00 INFO: archive-push:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 5"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-get-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"found [0-F]{24} in the archive"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000020, 000000080000000000000021, 000000080000000000000022, 000000080000000000000023, 000000080000000000000024, 000000080000000000000025, 000000080000000000000026, 000000080000000000000027] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000020...000000080000000000000027",
"P01 DETAIL: found 000000080000000000000020 in the archive",
"P02 DETAIL: found 000000080000000000000021 in the archive",
"P01 DETAIL: unable to find 000000080000000000000022 in the archive",
"P02 DETAIL: unable to find 000000080000000000000023 in the archive",
" [filtered 20 lines of output]",
"P00 INFO: archive-get:async command begin 2.24: [000000080000000000000022, 000000080000000000000023, 000000080000000000000024, 000000080000000000000025, 000000080000000000000026, 000000080000000000000027, 000000080000000000000028, 000000080000000000000029] --archive-async --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/9.6/data --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000080000000000000022...000000080000000000000029",
"P01 DETAIL: found 000000080000000000000022 in the archive",
"P02 DETAIL: found 000000080000000000000023 in the archive",
"P01 DETAIL: found 000000080000000000000024 in the archive",
"P02 DETAIL: found 000000080000000000000025 in the archive",
"P02 DETAIL: found 000000080000000000000027 in the archive",
"P01 DETAIL: found 000000080000000000000026 in the archive",
"P02 DETAIL: unable to find 000000080000000000000028 in the archive",
"P01 DETAIL: unable to find 000000080000000000000029 in the archive",
" [filtered 13 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'jw8s0F4'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg2-host" : {
"value" : "pg-standby"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/9.6/data"
}
},
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/9.6/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/9.6/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup file pg-primary|replay on the standby"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute non-exclusive pg_start_backup(): backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000080000000000000029, lsn = 0/29000028",
"P00 INFO: wait for replay on the standby to reach 0/29000028",
"P00 INFO: replay on the standby reached 0/29000028",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.6/data/global/pg_control (8KB, 0%) checksum 2831c718044f9ff77c5ef60e836e54cfdec25cf9",
"P03 INFO: backup file pg-standby:/var/lib/pgsql/9.6/data/base/12470/1249 (360KB, 16%) checksum e64455dffd947fbad2c3352083297f920bc636f0",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.6/data/pg_log/postgresql.log (5.6KB, 17%) checksum 411f258ac84adb8894d18692f64c86992d00e7cd",
"P04 INFO: backup file pg-standby:/var/lib/pgsql/9.6/data/base/12470/2674 (336KB, 32%) checksum 9102a9480c5215a5f000cb8822a162c157f5728d",
"P01 INFO: backup file pg-primary:/var/lib/pgsql/9.6/data/pg_hba.conf (4.2KB, 32%) checksum 1c0bca2f7f44d354aaaefb2c21fd1290b7379690",
"P02 INFO: backup file pg-standby:/var/lib/pgsql/9.6/data/base/12470/2608 (440KB, 53%) checksum 95161c399653da9d9b9f2f847e8c1e4841e0f9db",
"P03 INFO: backup file pg-standby:/var/lib/pgsql/9.6/data/base/12470/2673 (312KB, 67%) checksum 94ddf3bc4f2b740e0afef3e00d7c897f50e9511a",
" [filtered 1147 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-9.6.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-10/bin/initdb \\",
" -D /var/lib/pgsql/10/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'cd /var/lib/pgsql && \\",
" /usr/pgsql-10/bin/pg_upgrade \\",
" --old-bindir=/usr/pgsql-9.6/bin \\",
" --new-bindir=/usr/pgsql-10/bin \\",
" --old-datadir=/var/lib/pgsql/9.6/data \\",
" --new-datadir=/var/lib/pgsql/10/data \\",
" --old-options=\" -c config_file=/var/lib/pgsql/9.6/data/postgresql.conf\" \\",
" --new-options=\" -c config_file=/var/lib/pgsql/10/data/postgresql.conf\"'"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Upgrade Complete"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 70 lines of output]",
"Checking for hash indexes ok",
"",
"Upgrade Complete",
"----------------",
"Optimizer statistics are not transferred by pg_upgrade so,",
" [filtered 4 lines of output]"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/10/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"listen_addresses" : {
"value" : "'*'"
},
"log_line_prefix" : {
"value" : "''"
},
"max_wal_senders" : {
"value" : "3"
},
"port" : {
"value" : "5432"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"listen_addresses = '*'",
"log_line_prefix = ''",
"max_wal_senders = 3",
"port = 5432",
"wal_level = replica"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/10/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/10/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/10/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/10/data",
"recovery-option=primary_conninfo=host=172.17.0.4 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/10/data"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/10/data"
}
},
"global" : {
"backup-standby" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/10/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/10/data",
"",
"[global]",
"backup-standby=n",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp /var/lib/pgsql/9.6/data/pg_hba.conf \\",
" /var/lib/pgsql/10/data/pg_hba.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --no-online \\",
" --log-level-console=info stanza-upgrade"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-upgrade command begin 2.24: --no-backup-standby --log-level-console=info --log-level-stderr=off --no-log-timestamp --no-online --pg1-host=pg-primary --pg2-host=pg-standby --pg1-path=/var/lib/pgsql/10/data --pg2-path=/var/lib/pgsql/10/data --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-upgrade command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-10.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres systemctl status postgresql-10.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"â— postgresql-10.service - PostgreSQL 10 database server",
" Loaded: loaded (/usr/lib/systemd/system/postgresql-10.service; disabled; vendor preset: disabled)",
" Active: active (running) since Tue 2020-02-25 15:42:41 UTC; 319ms ago",
" Docs: https://www.postgresql.org/docs/10/static/",
" Process: 3908 ExecStartPre=/usr/pgsql-10/bin/postgresql-10-check-db-dir ${PGDATA} (code=exited, status=0/SUCCESS)",
" Main PID: 3913 (postmaster)",
" CGroup: /docker/b9730c0e198a0e8fd60e4ea9210e4b0f9c665267969d8a6b1af5d389c3275476/system.slice/postgresql-10.service",
" ├─3913 /usr/pgsql-10/bin/postmaster -D /var/lib/pgsql/10/data/",
" ├─3914 postgres: logger process ",
" ├─3916 postgres: checkpointer process ",
" ├─3917 postgres: writer process ",
" ├─3918 postgres: wal writer process ",
" ├─3919 postgres: autovacuum launcher process ",
" ├─3920 postgres: archiver process ",
" ├─3921 postgres: stats collector process ",
" └─3922 postgres: bgworker: logical replication launcher "
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/9.6/data"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/9.6/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /usr/pgsql-10/bin"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg-2: [DbConnectError] raised from remote-0 protocol on 'pg-standby': unable to connect to 'dbname='postgres' port=5432': could not connect to server: No such file or directory",
" \tIs the server running locally and accepting",
" \tconnections on Unix domain socket \"/var/run/postgresql/.s.PGSQL.5432\"?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/10/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"hot_standby = on"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-10.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/pgsql/10/data",
"pg2-host=pg-standby",
"pg2-path=/var/lib/pgsql/10/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
}
]
}
}
}
pgbackrest-release-2.24/doc/resource/fake-cert/ 0000775 0000000 0000000 00000000000 13625315071 0021444 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/resource/fake-cert/.gitignore 0000664 0000000 0000000 00000000014 13625315071 0023427 0 ustar 00root root 0000000 0000000 *.csr
*.srl
pgbackrest-release-2.24/doc/resource/fake-cert/README.md 0000664 0000000 0000000 00000002067 13625315071 0022730 0 ustar 00root root 0000000 0000000 # pgBackRest Documentation Certificates
The certificates in this directory are used for documentation generation only and should not be used for actual services.
## pgBackRest CA
Generate a CA that will be used to sign documentation certificates. It can be installed in the documentation containers to make certificates signed by it valid.
```
cd [pgbackrest-root]/doc/resource/fake-cert
openssl ecparam -genkey -name prime256v1 | openssl ec -out ca.key
openssl req -new -x509 -extensions v3_ca -key ca.key -out ca.crt -days 99999 \
-subj "/C=US/ST=All/L=All/O=pgBackRest/CN=pgbackrest.org"
```
## S3 Certificate
Mimic an S3 certificate for the `us-east-1`/`us-east-2` region to generate S3 documentation.
```
cd [pgbackrest-root]/doc/resource/fake-cert
openssl ecparam -genkey -name prime256v1 | openssl ec -out s3-server.key
openssl req -new -sha256 -nodes -out s3-server.csr -key s3-server.key -config s3.cnf
openssl x509 -req -in s3-server.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-out s3-server.crt -days 99999 -extensions v3_req -extfile s3.cnf
```
pgbackrest-release-2.24/doc/resource/fake-cert/ca.crt 0000664 0000000 0000000 00000001351 13625315071 0022541 0 ustar 00root root 0000000 0000000 -----BEGIN CERTIFICATE-----
MIIB+jCCAaCgAwIBAgIJAJDUUhiBUbmEMAoGCCqGSM49BAMCMFcxCzAJBgNVBAYT
AlVTMQwwCgYDVQQIDANBbGwxDDAKBgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNr
UmVzdDEXMBUGA1UEAwwOcGdiYWNrcmVzdC5vcmcwIBcNMTkwNTI3MDAxOTU5WhgP
MjI5MzAzMTAwMDE5NTlaMFcxCzAJBgNVBAYTAlVTMQwwCgYDVQQIDANBbGwxDDAK
BgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNrUmVzdDEXMBUGA1UEAwwOcGdiYWNr
cmVzdC5vcmcwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAAQYHUcSknRDL+fgFJZI
IC73Ju75yA0203IxPO35i8mVb9CcWVhEgHmS+cQ6SfY6GC7V61VB7gwzQ+XESi2p
ndhJo1MwUTAdBgNVHQ4EFgQUYMbKIlTUE6gklw8KcSC6fnlOitwwHwYDVR0jBBgw
FoAUYMbKIlTUE6gklw8KcSC6fnlOitwwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjO
PQQDAgNIADBFAiEA1Bzy17/6jQimg3ROZTrVGkRtAuzTtjgDParHFrIhSDoCIH43
OeOUaPVb0rXGPLu9rFpjPOmtFSW3lf4skheJMKyN
-----END CERTIFICATE-----
pgbackrest-release-2.24/doc/resource/fake-cert/ca.key 0000664 0000000 0000000 00000000343 13625315071 0022541 0 ustar 00root root 0000000 0000000 -----BEGIN EC PRIVATE KEY-----
MHcCAQEEIB5f3SxfiZ92GMpuqpfTiPO3xaVOnxRh6qVAoRtu7NOZoAoGCCqGSM49
AwEHoUQDQgAEGB1HEpJ0Qy/n4BSWSCAu9ybu+cgNNtNyMTzt+YvJlW/QnFlYRIB5
kvnEOkn2Ohgu1etVQe4MM0PlxEotqZ3YSQ==
-----END EC PRIVATE KEY-----
pgbackrest-release-2.24/doc/resource/fake-cert/s3-server.crt 0000664 0000000 0000000 00000001610 13625315071 0024005 0 ustar 00root root 0000000 0000000 -----BEGIN CERTIFICATE-----
MIICbTCCAhOgAwIBAgIJAODTXyGnxWtVMAoGCCqGSM49BAMCMFcxCzAJBgNVBAYT
AlVTMQwwCgYDVQQIDANBbGwxDDAKBgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNr
UmVzdDEXMBUGA1UEAwwOcGdiYWNrcmVzdC5vcmcwIBcNMTkwNTI3MDIwODEwWhgP
MjI5MzAzMTAwMjA4MTBaMIGBMQswCQYDVQQGEwJVUzEMMAoGA1UECAwDQWxsMQww
CgYDVQQHDANBbGwxEzARBgNVBAoMCnBnQmFja1Jlc3QxHDAaBgNVBAsME1VuaXQg
VGVzdGluZyBEb21haW4xIzAhBgNVBAMMGnMzLnVzLWVhc3QtMS5hbWF6b25hd3Mu
Y29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEEe2dO1v1gE0Qj4H407i0K8tN
kASkveckACPFzXs2i/++rZY4bwUub08JcMRv0WWwnRzOoumsN26Ge454vTbjoqOB
mjCBlzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIF4DB9BgNVHREEdjB0ghpzMy51cy1l
YXN0LTEuYW1hem9uYXdzLmNvbYIcKi5zMy51cy1lYXN0LTEuYW1hem9uYXdzLmNv
bYIaczMudXMtZWFzdC0yLmFtYXpvbmF3cy5jb22CHCouczMudXMtZWFzdC0yLmFt
YXpvbmF3cy5jb20wCgYIKoZIzj0EAwIDSAAwRQIgLiE7LuK6O/bKo70XPUi6xoDE
ew+EHO31klTOeWiS6oMCIQCHMEqSAcDF/gnG/UXnp2viHOFjnY+NZgQo76l+/2mE
iQ==
-----END CERTIFICATE-----
pgbackrest-release-2.24/doc/resource/fake-cert/s3-server.key 0000664 0000000 0000000 00000000343 13625315071 0024007 0 ustar 00root root 0000000 0000000 -----BEGIN EC PRIVATE KEY-----
MHcCAQEEIBhweMaCuhrRJy6hLV9X7QRCorDdyiUvSWEySHXZJM4DoAoGCCqGSM49
AwEHoUQDQgAEEe2dO1v1gE0Qj4H407i0K8tNkASkveckACPFzXs2i/++rZY4bwUu
b08JcMRv0WWwnRzOoumsN26Ge454vTbjog==
-----END EC PRIVATE KEY-----
pgbackrest-release-2.24/doc/resource/fake-cert/s3.cnf 0000664 0000000 0000000 00000000750 13625315071 0022463 0 ustar 00root root 0000000 0000000 [req]
default_bits = 4096
prompt = no
default_md = sha256
req_extensions = v3_req
distinguished_name = dn
[ dn ]
C=US
ST=All
L=All
O=pgBackRest
OU=Unit Testing Domain
CN = s3.us-east-1.amazonaws.com
[ v3_req ]
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
[ alt_names ]
DNS.1 = s3.us-east-1.amazonaws.com
DNS.2 = *.s3.us-east-1.amazonaws.com
DNS.3 = s3.us-east-2.amazonaws.com
DNS.4 = *.s3.us-east-2.amazonaws.com
pgbackrest-release-2.24/doc/resource/git-history.cache 0000664 0000000 0000000 00002651221 13625315071 0023063 0 ustar 00root root 0000000 0000000 [
{
"commit": "ace41d57d1a76d031350f3ba458ba1d1e393866d",
"date": "2020-02-25 09:34:27 -0500",
"subject": "Clarify that gzip is always used to compress history files."
},
{
"commit": "cc743f2e04db05cc3277e43023ebd8e2007ef4ed",
"date": "2020-02-21 11:51:39 -0500",
"subject": "Skip pg_internal.init temp file during backup.",
"body": "If PostgreSQL crashes it can leave behind a pg_internal.init temp file with the pid as the extension, as discussed in https://www.postgresql.org/message-id/flat/20200131045352.GB2631%40paquier.xyz#7700b9481ef5b0dd5f09cc410b4750f6. On restart this file is not cleaned up so it can persist for the lifetime of the cluster or until another process with the same id happens to write pg_internal.init.\n\nThis is arguably a bug in PostgreSQL, but in any case it makes sense not to backup this file."
},
{
"commit": "48d0f77fe3e6edf7347b49d9e8c67052db00355b",
"date": "2020-02-21 11:31:31 -0500",
"subject": "Remove dead LibC macros.",
"body": "These macros were made obsolete when code was removed from LibC after the C migration was completed."
},
{
"commit": "dfc5f6723379526fd3c5fe5de61a37793e2cced8",
"date": "2020-02-17 17:12:22 -0600",
"subject": "Fix typo."
},
{
"commit": "ea0af890d82b2b335cc4d9a9dcc29d440a583706",
"date": "2020-02-12 17:27:44 -0700",
"subject": "Reclassify release note to documentation improvement."
},
{
"commit": "c6b89d74ec5a21fc644f8f5106ee42def1135c98",
"date": "2020-02-12 17:20:21 -0700",
"subject": "Add reviewer."
},
{
"commit": "6353e9428df1d241b97d02c843f1a737e7c36c85",
"date": "2020-02-12 17:18:48 -0700",
"subject": "Error when archive-get/archive-push/restore are not run on a PostgreSQL host.",
"body": "This error was lost during the migration to C. The error that occurred instead (generally an SSH auth error) was hard to debug.\n\nRestore the original behavior by throwing an error immediately if pg1-host is configured for any of these commands. reset-pg1-host can be used to suppress the error when required."
},
{
"commit": "dac8119bf11e74b7d393b601bcfbe447a80e85e4",
"date": "2020-02-12 15:47:07 -0700",
"subject": "Add pgIsLocalVerify().",
"body": "This functionality is required in commands other than restore, so centralize it."
},
{
"commit": "e2c304d4738144f1c5c72d43d70ec5c9e67d052b",
"date": "2020-02-12 12:17:23 -0700",
"subject": "Prevent defunct processes in asynchronous archive commands.",
"body": "The main improvement is a double-fork to prevent zombie processes if the parent process exits after the (child) async process. This is a real possibility since the parent process sticks around to monitor the results of the async process.\n\nIn the first fork, ignore SIGCHLD in the very unlikely case that the async process exits before the first fork. This is probably only possible if the async process exits immediately, perhaps due to a chdir() failure. Set SIGCHLD back to default in the async process so waitpid() will work as expected.\n\nAlso update the comment on chdir() to more accurately reflect what is happening.\n\nFinally, add a test in certain debug builds to ensure the first fork exits very quickly. This only works when valgrind is not in use because valgrind makes forking so slow that it is hard to tell if the async process performed work or not (in the case that the second fork goes missing and the async process is a direct child)."
},
{
"commit": "1fa3ae2fcd5b90a6f2a4e5dc83b3580297e83c1b",
"date": "2020-02-11 19:54:17 -0700",
"subject": "Prevent lock-bot from marking locked issues as \"resolved\".",
"body": "This is certainly not true in all cases, e.g. an issue may be closed if it is added to the backlog."
},
{
"commit": "1be9e6854e8ab4bc21d693371a09290a6c3d5db6",
"date": "2020-02-11 19:52:23 -0700",
"subject": "Prevent lock-bot from adding comments to locked issues.",
"body": "This will hopefully prevent users from getting notifications when an issue is locked."
},
{
"commit": "43936c58a894187b41501ba5acaf16e92842c261",
"date": "2020-02-11 19:44:06 -0700",
"subject": "Fix resume when the resumable backup was created by Perl.",
"body": "In this case the resumable backup should be ignored, but the C code was not able to load the partial manifest written by Perl since the format differs slightly. Add validations to catch this case and continue gracefully."
},
{
"commit": "44adf21c834ca8624b47dc6dbc2794bc429463ad",
"date": "2020-02-10 21:30:43 -0700",
"subject": "Consolidate archive async exec code.",
"body": "Move duplicated code to the common module. This will reduce copy and paste between the get and push modules when changes are made."
},
{
"commit": "0eaedc9a6ae98eaf4e733a3f63cb462a5ebcfa05",
"date": "2020-02-10 19:17:11 -0700",
"subject": "Improve async archive error file removal.",
"body": "2a06df93 removed the error file so an old error would not be reported before the async process had a chance to try again. However, if the async process was already running this might lead to a timeout error before reporting the correct error.\n\nInstead, remove the error files once we know that the async process will start, i.e. after the archive lock has been acquired.\n\nThis effectively reverts 2a06df93."
},
{
"commit": "8cfbc294fcc066fce594c09649865f3d88bb2364",
"date": "2020-02-10 18:48:47 -0700",
"subject": "Fix incorrect error code."
},
{
"commit": "1ce71b1e9b5e0613182d64673e9f730efd0e8176",
"date": "2020-02-10 17:44:39 -0700",
"subject": "Add missing linefeed."
},
{
"commit": "71b4cc56cbcf20ce6a39e2155e0d9da11c83aaf8",
"date": "2020-02-06 21:11:15 -0800",
"subject": "Rename confessOnError to throwOnError.",
"body": "Confess is awfully Perl-ish and was likely copied verbatim during the migration. Rename to what we do now, i.e. throw."
},
{
"commit": "2a06df93f379bdc28a6c5084d204cb1e5391dbb3",
"date": "2020-02-06 20:59:04 -0800",
"subject": "Remove async archive error file when not throwing an error.",
"body": "This ensures that the error will not be thrown before the async process has a chance to retry."
},
{
"commit": "3721e57a0ec709326c28eb6d31f9b4fe9e3fd7b5",
"date": "2020-02-06 18:28:54 -0800",
"subject": "Clarify why some recovery options are not commented out for PG >= 12."
},
{
"commit": "efff54490f456b653e51abb05507b0917792376e",
"date": "2020-02-04 21:19:21 -0800",
"subject": "Fix release note typo."
},
{
"commit": "296aec03be7c924f2689e091e667e80daf06e6f7",
"date": "2020-01-31 07:50:03 -0700",
"subject": "Update contributor name."
},
{
"commit": "0f8ec3e478cc17243bc3f043a13f5da73f98de66",
"date": "2020-01-30 14:51:26 -0700",
"subject": "Read HTTP content to eof when size/encoding not specified.",
"body": "Generally, the content-size or content-encoding headers will be used to specify how much content should be expected.\n\nThere is a special case where the server sends 'Connection:close' without the content headers and the content may be read up until eof.\n\nThis appears to be an atypical usage but it is required by the specification."
},
{
"commit": "856980ae99efe088e0cf10588c2a18cd78ff32e6",
"date": "2020-01-30 14:38:05 -0700",
"subject": "Auto-select backup set on restore when time target is specified.",
"body": "Auto-selection is performed only when --set is not specified. If a backup set for the given target time cannot not be found, the latest (default) backup set will be used.\n\nCurrently a limited number of date formats are recognized and timezone names are not allowed, only timezone offsets."
},
{
"commit": "f46d1fa74c4c0cef7a0ac00f3e43ebeecdc1315e",
"date": "2020-01-30 11:28:30 -0700",
"subject": "Add timezone calculations to time module.",
"body": "Add tzPartsValid() and tzOffsetSecond() to calculate timezone offsets from user provided values.\n\nUpdate epochFromParts() to accept a timezone offset in seconds."
},
{
"commit": "dbaa5e3473ebfb4651e879edaab6817fdd79092a",
"date": "2020-01-29 08:21:36 -0700",
"subject": "Add linefeeds to function declarations."
},
{
"commit": "80687cbe740ad786a15db5e76777f24fd7cb8c69",
"date": "2020-01-28 10:19:58 -0700",
"subject": "Free TLS connection in common/io-http test.",
"body": "The test that checks for no output from the server was leaving a connection open which valgrind was complaining about.\n\nWait on the server long enough to cause the error on the client then close the connection to free the memory."
},
{
"commit": "846efaa40f2a04273a61057a3684973098deb690",
"date": "2020-01-28 07:36:20 -0700",
"subject": "Revert 'Add lib path for libpq in case it is in a non-standard location.`",
"body": "Putting this before AC_CHECK_LIB breaks on many systems because the location of pg_config is not yet known."
},
{
"commit": "324f7cebe04e97a9ec34e325f6fbd927f77edb2c",
"date": "2020-01-27 17:50:07 -0700",
"subject": "Designated initializer cleanup.",
"body": "Cleanup designated initializers created in b134175f by moving struct members in or out for clarity."
},
{
"commit": "24d2494c8209079d0288784de38e9045d5c6cb95",
"date": "2020-01-27 11:25:24 -0700",
"subject": "Fix incomplete comment."
},
{
"commit": "0a845214a1d306d16dce5618f2f998f8f6e6778d",
"date": "2020-01-26 23:10:29 -0700",
"subject": "Fix typo."
},
{
"commit": "697150eaf875742a4522e2ed8c00dfaf0489c4ac",
"date": "2020-01-26 23:07:07 -0700",
"subject": "Add more validations to the manifest on backup.",
"body": "Validate that checksums exist for zero size files. This means that the checksums for zero size files are explicitly set by backup even though they'll always be the same. Also validate that zero length files have the correct checksum.\n\nValidate that repo size is > 0 if size is > 0. No matter what compression type is used a non-zero amount of data cannot be stored in zero bytes."
},
{
"commit": "bb45a80d46b738a9b6672fc77158585395b04473",
"date": "2020-01-26 22:47:53 -0700",
"subject": "Begin v2.24 development."
},
{
"commit": "2358d3448507f5dc4fd50edf65172285bca69c4b",
"date": "2020-01-26 22:38:21 -0700",
"subject": "v2.23: Bug Fix"
},
{
"commit": "7ab07dc580989452d807332bc91d26a42e5a0d3a",
"date": "2020-01-26 21:58:59 -0700",
"subject": "Validate checksums are set in the manifest on backup/restore.",
"body": "This is a modest start but it addresses the specific issue that was caused by the bug fixed in 45ec694a. This validation will produce an immediate error rather than erroring out partway through the restore.\n\nMore validations are planned but this is the most important one and seems safest for this release."
},
{
"commit": "45ec694af22dda84b124f0df242bbcfdd28726d1",
"date": "2020-01-26 13:19:13 -0700",
"subject": "Fix missing files corrupting the manifest.",
"body": "If a file was removed by PostgreSQL during the backup (or was missing from the standby) then the next file might not be copied and updated in the manifest. If this happened then the backup would error when restored.\n\nThe issue was that removing files from the manifest invalidated the pointers stored in the processing queues. When a file was removed, all the pointers shifted to the next file in the list, causing a file to be unprocessed. Since the unprocessed file was still in the manifest it would be saved with no checksum, causing a failure on restore.\n\nWhen process-max was > 1 then the bug would often not express since the file had already been pulled from the queue and updates to the manifest are done by name rather than by pointer."
},
{
"commit": "9b47ff2746b74bf41d20fa43d6ed2697b0a99087",
"date": "2020-01-26 12:29:53 -0700",
"subject": "Sort last processing queue on backup from standby.",
"body": "The last queue was not being sorted when a primary queue was added first.\n\nThis did not affect the backup or integrity but could lead to slightly lower performance since large files were not always copied first."
},
{
"commit": "0444d3741423004e0f94116b528d94090c1e4303",
"date": "2020-01-24 10:43:47 -0700",
"subject": "Remove obsolete include to ../libc."
},
{
"commit": "b1c5885017c035320804c5d16ed57b149a33ab10",
"date": "2020-01-24 10:40:42 -0700",
"subject": "Add lib path for libpq in case it is in a non-standard location."
},
{
"commit": "90abc3cf170a3d5da8bbc5307cf5032d6af5ed6c",
"date": "2020-01-24 10:08:05 -0700",
"subject": "Use pkg-config instead of xml2-config for libxml2 build options.",
"body": "pkg-config is a generic way to get build options rather than relying on a package-specific utility.\n\nXML2_CONFIG can be used to override this utility for systems that do not ship pkg-config."
},
{
"commit": "b134175fc7a98836f49f20d552f7c31138b66b1b",
"date": "2020-01-23 14:15:58 -0700",
"subject": "Use designated initializers to initialize structs.",
"body": "Previously memNew() used memset() to initialize all struct members to 0, NULL, false, etc. While this appears to work in practice, it is a violation of the C specification. For instance, NULL == 0 must be true but neither NULL nor 0 must be represented with all zero bits.\n\nInstead use designated initializers to initialize structs. These guarantee that struct members will be properly initialized even if they are not specified in the initializer. Note that due to a quirk in the C99 specification at least one member must be explicitly initialized even if it needs to be the default value.\n\nSince pre-zeroed memory is no longer required, adjust memAllocInternal()/memReallocInternal() to return raw memory and update dependent functions accordingly. All instances of memset() have been removed except in debug/test code where needed.\n\nAdd memNewPtrArray() to allocate an array of pointers and automatically set all pointers to NULL.\n\nRename memGrowRaw() to the more logical memResize()."
},
{
"commit": "cf2024beafba82b3899d9c46c7ea64716835a292",
"date": "2020-01-21 18:47:14 -0700",
"subject": "Add XML2_CONFIG environment variable to configure.",
"body": "This allows the default 'xml2-config' to be replaced with, e.g. 'pkg-config libxml-2.0', for libxml2 configuration."
},
{
"commit": "600a51815feacb149add2bb777d6a3b4d284c8aa",
"date": "2020-01-21 18:42:22 -0700",
"subject": "Set client_encoding to UTF8 on PostgreSQL connect.",
"body": "This is the only non-ASCII character encoding we have tested so make sure that's all we get from PostgreSQL."
},
{
"commit": "1706c599bd1c4d1eeac5bf44d1811e0259809027",
"date": "2020-01-21 18:37:43 -0700",
"subject": "Set encoding to UTF8 for Debian documentation containers.",
"body": "This allows testing multi-byte encodings in PostgreSQL."
},
{
"commit": "382ddfd79dfec12f4cdf821f36a47dd404a51356",
"date": "2020-01-21 16:43:44 -0700",
"subject": "Begin v2.23 development."
},
{
"commit": "bae6e1c9e3a035f3793739ef1b469015777aa70b",
"date": "2020-01-21 16:12:33 -0700",
"subject": "v2.22: Bug Fix"
},
{
"commit": "94842ccecee642cc58f6c177c19e642d86a8d997",
"date": "2020-01-21 11:59:25 -0700",
"subject": "Fix comment."
},
{
"commit": "03d434c7e112eb3a8649e9c11149e08929f9651b",
"date": "2020-01-21 11:57:59 -0700",
"subject": "Remove RHEL package patch now that it has been merged upstream.",
"body": "Also revert 731ffcfb and update ContainerTest.pm for upstream changes."
},
{
"commit": "b89e6b7f69677fdaff3bb1ed5e908c843f72a4b5",
"date": "2020-01-21 10:29:46 -0700",
"subject": "Fix error in timeline conversion.",
"body": "The timeline is required to verify WAL segments in the archive after a backup. The conversion was performed base 10 instead of 16, which led to errors when the timeline was ≥ 0xA."
},
{
"commit": "c2da9aa907802a59a0c6fd5c111a1dbe7ea16c76",
"date": "2020-01-19 14:54:38 -0700",
"subject": "Fix invalid bufSize().",
"body": "bufUsed() should be used here to avoid a possible segfault or xml parse error when bufSize() > bufUsed()."
},
{
"commit": "c630bda1c184d475155220884f8a25fa4b788aaf",
"date": "2020-01-19 10:37:08 -0700",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "d9efbc3698f92b874abb6eff3298c44fd35b0d5c",
"date": "2020-01-18 10:46:48 -0700",
"subject": "Add UTF8 strings to manifest and restore tests.",
"body": "The most likely place to get UTF8 characters is in database names so make sure UTF8 works in the places where database names are processed."
},
{
"commit": "19c39fe1e262dd7c259e9f1e68d0695c43afefe3",
"date": "2020-01-17 22:54:19 -0700",
"subject": "Fix redundancy in comment."
},
{
"commit": "ec173f12fb9c26553b2021473dd62d73a006835a",
"date": "2020-01-17 13:29:49 -0700",
"subject": "Add MEM_CONTEXT_PRIOR() block and update current call sites.",
"body": "This macro block encapsulates the common pattern of switching to the prior (formerly called old) mem context to return results from a function.\n\nAlso rename MEM_CONTEXT_OLD() to memContextPrior(). This violates our convention of macros being in all caps but memContextPrior() will become a function very soon so this will reduce churn."
},
{
"commit": "b5fa9951e36641d0ad751f0c89751e84b5b1df0d",
"date": "2020-01-17 13:08:47 -0700",
"subject": "Use MEM_CONTEXT_BEGIN() block in varFree().",
"body": "We probably arrived at this unusual construction because of the complexity of getting the mem context. Whether or not this is a good way to store the mem context, it still makes sense to use the standard pattern for switching mem contexts."
},
{
"commit": "c6d6b7dbefb62578be64133e36836fc936945555",
"date": "2020-01-17 11:58:41 -0700",
"subject": "Use MEM_CONTEXT_NEW_BEGIN() block instead of memContextNew().",
"body": "A few places were using just memContextNew(), probably because they did not immediately need to create anything in the new context, but it's better if we use the same pattern everywhere, even if it results in a few extra mem context switches."
},
{
"commit": "d3be1e41a4cdb5b7bbc40d73de8f185b22a97efd",
"date": "2020-01-16 16:23:40 -0700",
"subject": "Add braces and spaces for clarity.",
"body": "This should make it a little easier to see how the TRY macros work together."
},
{
"commit": "254f79803fca8cd591849b77d1266c79580ab08c",
"date": "2020-01-16 16:20:59 -0700",
"subject": "Use MEM_CONTEXT_BEGIN() block instead of memContextSwitch().",
"body": "This is the standard pattern but was missed here."
},
{
"commit": "8068a610d566cf9b5bcc79a3602a3a8442192bad",
"date": "2020-01-16 16:19:45 -0700",
"subject": "Use MEM_CONTEXT_NEW_BEGIN() block.",
"body": "This pattern makes more sense. The prior code was probably copy-pasted from code with slightly different requirements."
},
{
"commit": "4274fcbf6f99f6d8414d2ba095809341bcf56797",
"date": "2020-01-16 14:42:01 -0700",
"subject": "Add missing semicolon.",
"body": "This worked when the FUNCTION_TEST_RETURN_VOID() macro expanded to nothing because of the final semicolon. If the FUNCTION_TEST_RETURN_VOID() macro expanded to something then there was one semicolon too few."
},
{
"commit": "731ffcfb3d77e6a9d17091f9819cf3e21e25d951",
"date": "2020-01-16 14:29:04 -0700",
"subject": "Disable RHEL package builds since upstream is broken."
},
{
"commit": "e81629b4420759f80bd18017ee47b89942c90090",
"date": "2020-01-15 13:53:30 -0700",
"subject": "Reclassify Perl and LibC code as test/harness.",
"body": "These were still being included in the core totals but they are no longer used by core."
},
{
"commit": "193b78e150919470b33f3941be03f0ef589a3e79",
"date": "2020-01-15 13:40:17 -0700",
"subject": "Remove -s from make instructions.",
"body": "It's a good option but not required so let the user make the choice.\n\nAlso combine configure and make into a single line."
},
{
"commit": "9414ad2300f5ab87000da333fbbfa58228dae0c4",
"date": "2020-01-15 13:29:52 -0700",
"subject": "Begin v2.22 development."
},
{
"commit": "2c0ba0820d3e4adea31ef6b8ee201be653ef9579",
"date": "2020-01-15 13:21:52 -0700",
"subject": "v2.21: C Migration Complete"
},
{
"commit": "8d3710b2fe94c90783374d19a435bded1903fe1b",
"date": "2020-01-15 12:24:58 -0700",
"subject": "Fix options being ignored by asynchronous commands.",
"body": "The local, remote, archive-get-async, and archive-push-async commands were used to run functionality that was not directly available to the user. Unfortunately that meant they would not pick up options from the command that the user expected, e.g. backup, archive-get, etc.\n\nRemove the internal commands and add roles which allow pgBackRest to determine what functionality is required without implementing special commands. This way the options are loaded from the expected command section.\n\nSince remote is no longer a specific command with its own options, more manipulation is required when calling remote. This might be something we can improve in the config system but it may be worth leaving as is because it is a one-off, for now at least."
},
{
"commit": "c43ec9d38c7cd543d7a832f1e362705658ca5c12",
"date": "2020-01-15 08:19:32 -0700",
"subject": "Fix function return logging type.",
"body": "This was working because the stack was being cleaned up by a try block at the call site."
},
{
"commit": "f8a29c266e1e9b6e207fdd74478e3aca9b728cb9",
"date": "2020-01-13 20:36:42 -0700",
"subject": "Clarify comment."
},
{
"commit": "a7738ebba3cfd3a732c5de997a113746136133af",
"date": "2020-01-13 13:21:28 -0700",
"subject": "Update comments in command/remote module."
},
{
"commit": "a969a860abea7384572a1244913bcfbd8851545d",
"date": "2020-01-13 11:13:37 -0700",
"subject": "Fix misaligned braces."
},
{
"commit": "fe263e87b1822b051ccea3fc0a8fea64f944dd7b",
"date": "2020-01-12 11:31:06 -0700",
"subject": "Allow path-style URIs in S3 driver.",
"body": "Although path-style URIs have been deprecated by AWS, they may still be used with products like Minio because no additional DNS configuration is required.\n\nPath-style URIs must be explicitly enabled since it is not clear how they can be auto-detected reliably. More importantly, faulty detection could cause regressions in current installations."
},
{
"commit": "069345d33959eb7b2ff0f4ae2b2ec65023ac7186",
"date": "2020-01-12 11:00:10 -0700",
"subject": "Add string constants."
},
{
"commit": "3f89ecf8d9b848c2ca063581bc75064d9d353255",
"date": "2020-01-10 09:39:33 -0700",
"subject": "Add time to storage ls JSON output.",
"body": "Time is supported in all drivers with the update to S3 at 61538f93, so it is now possible to add time to the ls command and have it work on all repo types."
},
{
"commit": "0fe7bb2ec4d6ba10af8f2a6fd736e2c4cbdb2af2",
"date": "2020-01-09 12:20:13 -0700",
"subject": "Improve code that updates/removes pg options passed to a remote.",
"body": "The prior code was updating/removing hard-coded options but new options are added all the time and there was no indication that this code needed to be updated. For example, dc1e7ca2 added the pg-user option but this code was not updated.\n\nInstead find the options to update/remove dynamically. The new code uses prefixes, which is not perfect, but the patterns for pg options are pretty well established and this seems safer than the existing code."
},
{
"commit": "4c8653fc8bc6e8b3070c59ba12af4e5f2131c21c",
"date": "2020-01-09 11:56:03 -0700",
"subject": "Update inaccurate comments."
},
{
"commit": "2e11389ed4db29d530ec8e480134c44eab9a5896",
"date": "2020-01-09 11:52:51 -0700",
"subject": "Fix comment typo."
},
{
"commit": "0c5c78e5e16b10f79dcfa023c6276a65ad87481d",
"date": "2020-01-09 09:23:15 -0700",
"subject": "Make quoting in cfgExeParam() optional.",
"body": "Parameter lists that are passed directly to exec*() do not need quoting when spaces are present. Worse, the quotes will not be stripped and the option value will be garbled.\n\nUnfortunately this still does not fix all issues with quoting since we don't know how it might need to be escaped to work with SSH command configuration. The answer seems to be to pass the options in the protocol layer but that's beyond the scope of this commit."
},
{
"commit": "7de5ce23ad387602125f478ceec2c834703080d5",
"date": "2020-01-08 18:59:02 -0700",
"subject": "Add internal remote-type option.",
"body": "This option was overloaded on the general type option but it makes sense to split this out since the meaning is pretty different.\n\nRename the values to conform to current standards, i.e. pg and repo, now that the Perl code won't care anymore."
},
{
"commit": "7a1871c341c2ae530927bcf018792733530fc417",
"date": "2020-01-08 09:54:44 -0700",
"subject": "Fix test log message to match pg-version parameter name.",
"body": "It was confusing that this part of the log message did not match the parameter name, which made reproducing test failures from CI a little harder."
},
{
"commit": "8e1f78b4c82d3b4f7ecbdb053df1c8fd46bf3c1e",
"date": "2020-01-07 12:20:51 -0700",
"subject": "Remove obsolete Perl code missed in f0ef73db."
},
{
"commit": "a84ae6be04fc21c52c04284004836292089fa0e1",
"date": "2020-01-06 16:16:48 -0700",
"subject": "Fix comment typos."
},
{
"commit": "61538f932c58c3bb0afad5b6c16cf997604e3606",
"date": "2020-01-06 15:53:53 -0700",
"subject": "Parse dates in storageS3InfoList() and storageS3Info().",
"body": "Previously dates were not being filled by these functions which was fine since dates were not used.\n\nWe plan to use dates for the ls command plus it makes sense for the driver to be complete since it will be used as an example."
},
{
"commit": "d2fb4f977ceba499f134ad363ea3170f0d9ef5b9",
"date": "2020-01-06 15:24:49 -0700",
"subject": "Add httpLastModifiedToTime() to parse HTTP last-modified header."
},
{
"commit": "a08298ce1b9ee96a9f84b613848327f7f60eb063",
"date": "2020-01-06 15:18:52 -0700",
"subject": "Add basic time management functions.",
"body": "These are similar to what mktime() and strptime() do but they ignore the local system timezone which saves having to munge the TZ env variable to do time conversions."
},
{
"commit": "fc47907fe32560e8d3086287023d6f727027a0a1",
"date": "2020-01-03 09:32:52 -0700",
"subject": "Update LICENSE.txt for 2020."
},
{
"commit": "011bcb48697ddb56fe1396502a36254718f74dfa",
"date": "2019-12-29 21:22:18 -0700",
"subject": "Remove command option from Perl db application name.",
"body": "The command option will be removed from the C code so it needs to be removed here as well.\n\nThis code is now used only for testing so it's not important that it be so precise."
},
{
"commit": "33e328abbf5992caccc15ff42ca2dca14502c983",
"date": "2019-12-28 18:30:32 -0700",
"subject": "Remove unused LibC code.",
"body": "The code was made obsolete by the migration to C."
},
{
"commit": "e72a9dd0d2b6aad58a5d845112631253382e20e2",
"date": "2019-12-28 13:37:03 -0700",
"subject": "Add error parameter to cfgCommandId().",
"body": "This allows commands to be checked for validity without generating an error."
},
{
"commit": "d28837a300d4b585792c049dce25fd73387408b3",
"date": "2019-12-28 13:31:59 -0700",
"subject": "Remove obsolete function declaration."
},
{
"commit": "d41eea685a732fa80d99d0af0fc52746e13d1152",
"date": "2019-12-26 18:08:27 -0700",
"subject": "Change meaning of TEST_RESULT_STR() macro.",
"body": "This macro was created before the String object existed so subsequent usage with String always included a lot of strPtr() wrapping.\n\nTEST_RESULT_STR_Z() had already been introduced but a wholesale replacement of TEST_RESULT_STR() was not done since the priority was on the C migration.\n\nUpdate all calls to (old) TEST_RESULT_STR() with one of the following variants: (new) TEST_RESULT_STR(), TEST_RESULT_STR_Z(), TEST_RESULT_Z(), TEST_RESULT_Z_STR()."
},
{
"commit": "02d3918b3233276651fff443b7fcee3f325cf263",
"date": "2019-12-19 19:37:55 -0500",
"subject": "Remove duplicate header and extra linefeed."
},
{
"commit": "74c3842595f49b81be341faf56f2343e9a5c60c8",
"date": "2019-12-19 16:25:46 -0500",
"subject": "Remove errant tabs and fix spacing."
},
{
"commit": "7dfea6b71728bc4985021ce8eb993c1376344581",
"date": "2019-12-19 16:20:11 -0500",
"subject": "Remove errant tab."
},
{
"commit": "dc1e7ca22dbdae2556513468433b0591d7cf5a44",
"date": "2019-12-19 11:26:38 -0500",
"subject": "Add pg-user option.",
"body": "Specifies the database user name when connecting to PostgreSQL.\n\nIf not specified pgBackRest will connect with the local OS user or PGUSER, which was the previous behavior."
},
{
"commit": "9452084dd174925c554273eb2f8b224c89069123",
"date": "2019-12-17 23:32:39 -0500",
"subject": "Fix misspellings of libpq."
},
{
"commit": "63a855e2f7108f54100b973e23e4bcf3005a1647",
"date": "2019-12-17 23:26:52 -0500",
"subject": "Fix misaligned continuation character."
},
{
"commit": "2f7e139534de54fb19fa46edf7eeb7ecf00d8284",
"date": "2019-12-17 22:35:30 -0500",
"subject": "Error if option prefix and index total are not both defined.",
"body": "They are both required for indexed options."
},
{
"commit": "d780d084b7b4ad0950bd35b905c778c3a47e8860",
"date": "2019-12-17 21:56:02 -0500",
"subject": "Add comments about increasing Vagrantfile disk size."
},
{
"commit": "d89d9f1c52b9fc7bf4827d1b367da6e8520a79d2",
"date": "2019-12-17 21:47:19 -0500",
"subject": "Skip vagrant disksize option if no plugin.",
"body": "Previously, `vagrant up` would bail if no `vagrant-disksize` plugin was\ninstalled. This option is just a nice-to-have, so skip it rather than\nbailing."
},
{
"commit": "ac35dcac39699b5ecae5f3d178cb837bac1446dc",
"date": "2019-12-17 21:28:40 -0500",
"subject": "Add note about symlink required for contributing documentation to build."
},
{
"commit": "3394a5017091e57b0adc296b43ac00010a223c3d",
"date": "2019-12-17 21:25:54 -0500",
"subject": "Remove unused Perl library missed in f0ef73db."
},
{
"commit": "620386f034fd97371c467bda4dc0d90f423bf663",
"date": "2019-12-17 20:14:45 -0500",
"subject": "Remove integration tests that are now covered in the unit tests.",
"body": "Most of these tests are just checking that errors are thrown when required. These are well covered in various unit tests.\n\nThe \"cannot resume\" tests are also well covered in the backup unit tests.\n\nFinally, config warnings are well covered in the config unit tests.\n\nThere is more to be done here, but this accounts for the low-hanging fruit."
},
{
"commit": "977ec2e307c5487df9ed6fadebd486a92c75f269",
"date": "2019-12-17 15:23:07 -0500",
"subject": "Integration test improvements for disk and memory efficiency.",
"body": "Set log-level-file=off when more that one test will run. In this case is it impossible to see the logs anyway since they will be automatically cleaned up after the test. This improves performance pretty dramatically since trace-level logging is expensive. If a singe integration test is run then log-level-file is trace by default but can be changed with the --log-level-test-file option.\n\nReduce buffer-size to 64k to save memory during testing and allow more processes to run in parallel.\n\nUpdate log replacement rules so that these options can change without affecting expect logs."
},
{
"commit": "ccea30b8d8970acf9c1826c5c988d819aabf2d0f",
"date": "2019-12-14 10:20:23 -0500",
"subject": "Increase memory in ramdisk for Travis CI testing.",
"body": "The co6 tests were occasionally running out of space so bump up the size of the ramdisk a bit to hopefully prevent this.\n\nA longer term solution would be to disable the trace-level file logs when running on Travis CI since they seem to be using most of the space."
},
{
"commit": "6bd280f7bd667305317a7c825d913dac9719c475",
"date": "2019-12-14 09:53:50 -0500",
"subject": "Don't warn when stop-auto is enabled on PostgreSQL >= 9.6.",
"body": "PostgreSQL >= 9.6 uses non-exclusive backup which has implicit stop-auto since the backup will stop when the connection is terminated.\n\nThe warning was made more verbose in 1f2ce45e but this now seems like a bad idea since there are likely users with mixed version environments where stop-auto is enabled globally. There's no reason to fill their logs with warnings over a harmless option. If anything we should warn when stop-auto is explicitly set to false but this doesn't seem very important either.\n\nRevert to the prior behavior, which is to warn and reset when stop-auto is enabled on PostgreSQL < 9.3."
},
{
"commit": "03849840b813fdfdc2e00874fa8e3bbe9ac95338",
"date": "2019-12-13 21:33:13 -0500",
"subject": "Fix handling of \\ in filenames.",
"body": "\\ was not being properly escaped when calculating the manifest checksum which prevented the manifest from loading.\n\nUse jsonFromStr() to properly quote and escape \\.\n\nSince instances of \\ in cluster filenames should be rare to nonexistent this does not seem likely to be a serious problem in the field."
},
{
"commit": "f0ef73db7009cd6e08740d270a6ee7565efc9f8c",
"date": "2019-12-13 17:55:41 -0500",
"subject": "pgBackRest is now pure C.",
"body": "Remove embedded Perl from the distributed binary. This includes code, configure, Makefile, and packages. The distributed binary is now pure C.\n\nRemove storagePathEnforceSet() from the C Storage object which allowed Perl to write outside of the storage base directory. Update mock/all and real/all integration tests to use storageLocal() where they were violating this rule.\n\nRemove \"c\" option that allowed the remote to tell if it was being called from C or Perl.\n\nCode to convert options to JSON for passing to Perl (perl/config.c) has been moved to LibC since it is still required for Perl integration tests.\n\nUpdate build and installation instructions in the user guide.\n\nRemove all Perl unit tests.\n\nRemove obsolete Perl code. In particular this included all the Perl protocol code which required modifications to the Perl storage, manifest, and db objects that are still required for integration testing but only run locally. Any remaining Perl code is required for testing, documentation, or code generation.\n\nRename perlReq to binReq in define.yaml to indicate that the binary is required for a test. This had been the actual meaning for quite some time but the key was never renamed."
},
{
"commit": "1f2ce45e6b613edfb628ac40fd2369c9455692ba",
"date": "2019-12-13 17:14:26 -0500",
"subject": "The backup command is implemented entirely in C.",
"body": "For the most part this is a direct migration of the Perl code into C except as noted below.\n\nA backup can now be initiated from a linked directory. The link will not be stored in the manifest or recreated on restore. If a link or directory does not already exist in the restore location then a directory will be created.\n\nThe logic for creating backup labels has been improved and it should no longer be possible to get a backup label earlier than the latest backup even with timezone changes or clock skew. This has never been an issue in the field that we know of, but we found it in testing.\n\nFor online backups all times are fetched from the PostgreSQL primary host (before only copy start was). This doesn't affect backup integrity but it does prevent clock skew between hosts affecting backup duration reporting.\n\nArchive copy now works as expected when the archive and backup have different compression settings, i.e. when one is compressed and the other is not. This was a long-standing bug in the Perl code.\n\nResume will now work even if hardlink settings have been changed."
},
{
"commit": "e206093beb43981f11b532f05897c383f93d8f63",
"date": "2019-12-12 18:52:16 -0500",
"subject": "Allow end anchor to be excluded in backupRegExp().",
"body": "This is useful for matching files in the backup history directory which have characters after the backup label."
},
{
"commit": "8acfb6adf410571464c956ad161ad3df227b73a5",
"date": "2019-12-12 16:43:34 -0500",
"subject": "Add pgLsnRangeToWalSegmentList() to convert lsn range to wal segments."
},
{
"commit": "81295fd3889ce05829b6443aa29032ccffdfef3e",
"date": "2019-12-12 16:28:26 -0500",
"subject": "Move not found error into walSegmentFind().",
"body": "This error is also needed in backup so move it here to centralize it."
},
{
"commit": "1378d9c58b05f2f45352df155463ab8cd55276a6",
"date": "2019-12-12 16:21:51 -0500",
"subject": "Fix bad arithmetic in pgLsnToWalSegment().",
"body": "/ takes precedence over & but the appropriate parens were not provided.\n\nBy some bad luck the tests worked either way, so add a new test that only works the correct way to prevent a regression."
},
{
"commit": "676be2c77390587bb36c9d88bcf1a54d333ee0f3",
"date": "2019-12-12 16:11:09 -0500",
"subject": "Add pgWalPath() to return version-specific WAL path.",
"body": "Also update the manifest module to use the new function."
},
{
"commit": "94cb9540f1c94746d78ae4efb16246b26daf79a0",
"date": "2019-12-12 09:05:10 -0500",
"subject": "Begin v2.21 development."
},
{
"commit": "39fc2b7ad68d97cf5f23757e8a341428935621f4",
"date": "2019-12-12 08:20:21 -0500",
"subject": "v2.20: Bug Fixes"
},
{
"commit": "b031dbbcf8fa83ef60cfabc20fbf16046904f9aa",
"date": "2019-12-11 22:11:04 -0500",
"subject": "Allow timezones to be explicitly set for testing.",
"body": "The TZ environment variable was not reliably pushed down to the test processes.\n\nInstead pass TZ via a command line parameter and set explicitly in the test process."
},
{
"commit": "db5175915a0dc09b7591d71886ee8ce3bf5a12c3",
"date": "2019-12-11 21:51:32 -0500",
"subject": "Use localtime() to format time_t in cvtTimeToZ().",
"body": "Using gmtime() produced output skewed by the local timezone.\n\nSince this function is currently only used for debug logging this is not a live bug in the field."
},
{
"commit": "811ecd758d9e2ca12966995ec6cfc1e4ff8c0cfd",
"date": "2019-12-11 14:57:32 -0500",
"subject": "Make type in comment more specific."
},
{
"commit": "0194a9867182435c7a181be6466ca2b91f05801d",
"date": "2019-12-11 14:36:39 -0500",
"subject": "Fix archive-push/archive-get when PGDATA is symlinked.",
"body": "Commit 7168e074 tried to use cwd() as PGDATA but this would disagree with the path configured in pgBackRest if PGDATA was symlinked.\n\nIf cwd() does not match the pgBackRest path then chdir() to the path and make sure the next cwd() matches the result from the first call."
},
{
"commit": "8c840c28a65dae3cca581691e88e51839cd64bca",
"date": "2019-12-11 08:48:46 -0500",
"subject": "Fix segfault on unexpected EOF in gzip decompression.",
"body": "If the compressed stream terminated early then the decompression process would get a flush request (NULL input buffer) since the filter was not marked as done. This could happen on a zero-length or truncated (i.e. invalid) compressed file.\n\nChange the existing assertion to an error to catch this condition in production gracefully."
},
{
"commit": "c933f12f9c39d7c076f84252c081c3430be72e55",
"date": "2019-12-10 13:28:15 -0500",
"subject": "Remove obsolete --perl-option option.",
"body": "This option was used when Perl was executed instead of being embedded.\n\nIt has been obsolete for a long time so remove it."
},
{
"commit": "d0ba8ff58c46c15facb4dba19eab8db83835b07c",
"date": "2019-12-10 13:16:47 -0500",
"subject": "Remove test point infrastructure.",
"body": "82df7e6f and 9856fef5 updated tests that used test points in preparation for the feature not being available in the C code.\n\nSince tests points are no longer used remove the infrastructure.\n\nAlso remove one stray --test option in mock/all that was essentially a noop but no longer works now that the option has been removed."
},
{
"commit": "d7d663c2b93fd6a3bdfb1c6a4bd1feae0cd8cc63",
"date": "2019-12-10 13:02:36 -0500",
"subject": "Make buildPutDiffers() work with empty files.",
"body": "If the file was empty the timestamp was updated. If the file is empty and there is no content then file should not be saved."
},
{
"commit": "800d2972b00bb381c92cdadead9a1c04141853be",
"date": "2019-12-09 18:28:20 -0500",
"subject": "Remove stray uint type.",
"body": "This was probably copied from an example but some compilers don't like it."
},
{
"commit": "471d54a738887dd5c99afced36420cf6fb5c631b",
"date": "2019-12-09 17:55:20 -0500",
"subject": "Add stringz module to define some commonly used strings.",
"body": "This module will eventually contain various useful zero-terminated string functions.\n\nFor now, using NULL_Z instead of strPtr(NULL_STR) avoids a strict aliasing warning on RHEL 6. This is likely a compiler issue, but adding these constants seems like a good idea anyway and we are not going to get a fix in a gcc that old."
},
{
"commit": "ca33545630a073579ef763294d897dd06820f5a5",
"date": "2019-12-09 14:06:32 -0500",
"subject": "Remove redundant test and move another test."
},
{
"commit": "61ad3a44c9e562a306064770428726a5664056e9",
"date": "2019-12-09 09:12:34 -0500",
"subject": "Note that next repo format should use UTC for backup labels."
},
{
"commit": "d3132dae26ad40c2a47db62d4cc5f4502465d7c6",
"date": "2019-12-08 18:43:47 -0500",
"subject": "Add functions for building new manifests.",
"body": "New manifests are built before a backup is performed."
},
{
"commit": "2cfde18755f305008af134ac833aca6989321ca7",
"date": "2019-12-08 14:19:47 -0500",
"subject": "Add pgLsnFromStr(), pgLsnToStr(), and pgLsnToWalSegment()."
},
{
"commit": "f517b141fb065efd21878fc774f51b52c014d887",
"date": "2019-12-08 14:15:23 -0500",
"subject": "Update pq harness to play nicely with variable LSNs."
},
{
"commit": "d2587250da82a90257534268e2175bfcfd3e15ac",
"date": "2019-12-07 18:44:06 -0500",
"subject": "Add backup functions to Db object.",
"body": "These functions implement the database backup functionality for all supported versions."
},
{
"commit": "8766326da812f6aae00bdbfef4b1382805de8c3e",
"date": "2019-12-07 17:48:53 -0500",
"subject": "Add protocolRemoteFree() to shutdown a specific remote.",
"body": "Sometimes it is useful to shutdown remotes that are no longer needed instead of waiting for them to be shutdown at program exit."
},
{
"commit": "5175d52e9466c339f5a4cd5c7d7e8724c3bbb2e3",
"date": "2019-12-07 17:42:42 -0500",
"subject": "Add constant for pg_tblspc path."
},
{
"commit": "78b1e05b7e6f8d09a424a2e8864e317d63c474f3",
"date": "2019-12-07 17:39:25 -0500",
"subject": "Remove unused Perl module."
},
{
"commit": "35a262951a1ed74431cdfa92c36ee2c9ae867c1a",
"date": "2019-12-07 17:33:34 -0500",
"subject": "Pq test harness usability and error reporting improvements.",
"body": "Pq script errors are now printed in test output in case they are being masked by a later error.\n\nOnce a script error occurs, the same error will be thrown forever rather than throwing a new error on the next item in the script.\n\nHRNPQ_MACRO_CLOSE() is not required in scripts unless harnessPqScriptStrictSet(true) is called. Most higher-level tests should not need to run in strict mode.\n\nThe command/check test seems to require strict mode but there's no apparent reason why it should. This would be a good thing to look into at some point."
},
{
"commit": "d6479ddd0efda9bb442f4bbfe937daa0ab46ac72",
"date": "2019-12-07 17:15:20 -0500",
"subject": "Add log replacements to help test non-deterministic log output.",
"body": "Some log output (e.g. time) is hard to test because the values can change between tests.\n\nAdd expressions to replace substrings in the log with predictable values to simplify testing.\n\nThis is similar to the log replacement facility available for Perl expect log testing."
},
{
"commit": "e4716ee036e8a4417f6dcb8d108c0d7b9e3f2b7d",
"date": "2019-12-07 17:02:41 -0500",
"subject": "Improve diff output in tests.",
"body": "Always compare expected vs actual (in that order) and give a hint in the error message to indicate what should be added and what removed."
},
{
"commit": "8c47ee296a1f311682b46b3f1de98d4eb7dcaf6a",
"date": "2019-12-07 16:55:50 -0500",
"subject": "Improve storage harness test callback.",
"body": "Add ability to omit the root (i.e. dot) path and get real size of compressed files."
},
{
"commit": "1b3770e248f4a5b59ba16f6a4c6cba7cf23de883",
"date": "2019-12-07 09:48:33 -0500",
"subject": "Recopy during backup when resumed file is missing or corrupt.",
"body": "A recopy would occur if the size or checksum was invalid but on error the backup would terminate.\n\nInstead, recopy the resumed file on any error. If the error is systemic (e.g. network failure) then it should show up again during the recopy."
},
{
"commit": "d3f717c89208ef132e75b634ad2e91efbda25a04",
"date": "2019-12-07 09:26:51 -0500",
"subject": "Storage hardlink and symlink features require path feature.",
"body": "Since there is only one driver that supports (or is likely to support) links (Posix), require the path feature to make logic in the code simpler.\n\nThe checks are added just in case another driver supports links."
},
{
"commit": "e632c605250438a9e06f133b55c88e578ea709cd",
"date": "2019-12-06 11:48:41 -0500",
"subject": "Fix backup labels in mock/all resume integration tests.",
"body": "These were not getting updated to match the directory name when the manifests were copied.\n\nThe Perl code didn't care but the C code expects labels to be set correctly."
},
{
"commit": "5395aa0c92febadbf0c71f93799877cfe7268b6b",
"date": "2019-12-05 22:34:38 -0500",
"subject": "Allocate one extra process for backup from standby.",
"body": "The connection to the primary is process-max + 1 so make space for it."
},
{
"commit": "b2d82bd2484dbe3dee12479efb6e9aceba5aac57",
"date": "2019-12-04 19:43:26 -0500",
"subject": "Add functions to get the substring found by regExpMatch().",
"body": "For now this is only used in testing but there are places where it could be useful in the core code.\n\nEven if that turns out not to be true, it doesn't seem worth implementing a new version in testing just to capture a few values that we already have."
},
{
"commit": "053af2f54db0eaaaca3ac67cbdd68ba1b701048a",
"date": "2019-12-04 19:31:39 -0500",
"subject": "Add asserts to ensure hostId > 0.",
"body": "hostId is 1-based (e.g. pg1-*) so it should always be > 0."
},
{
"commit": "d1f49825b11ba88ac2024734c4c8a1c961f05854",
"date": "2019-12-02 11:54:45 -0500",
"subject": "Add missing header."
},
{
"commit": "8dfe0e48e25725978738ecb3fec24e5ce2e9076b",
"date": "2019-12-02 10:49:25 -0500",
"subject": "Use more general error code when tablespace linked into PGDATA.",
"body": "The specific error code was not that useful since we also test the error message which contains details of the link error."
},
{
"commit": "33a63aae503adf8d7f3f4430ee6478b845d38e2c",
"date": "2019-12-02 07:39:42 -0500",
"subject": "Add flag to dbGet() to require a standby.",
"body": "This is needed from backup from standby functionality."
},
{
"commit": "28116918ff3a00b133d74d524df452e29398082d",
"date": "2019-12-02 07:35:36 -0500",
"subject": "Error in remote command when stop file exists.",
"body": "This duplicates the Perl functionality."
},
{
"commit": "fc291b6f28753329afdd7b65b115f90d31569df1",
"date": "2019-12-01 17:47:47 -0500",
"subject": "Reduce the scope of mock/all exclusion tests.",
"body": "Run exclusions only on the tests where they will have an effect to reduce churn in the expect logs when they change."
},
{
"commit": "d15ed338217667f0bd7ffff3eb9f5e24052477fd",
"date": "2019-12-01 16:32:21 -0500",
"subject": "Make MCV return false when a boolean tie.",
"body": "This is to maintain compatibility with the older Perl code that returned the lowest sorted order item in a tie.\n\nFor other datatypes the C code returns the same value, often enough at least to not cause churn in the expect tests."
},
{
"commit": "ab0974cc8ea0cff70a9f680ff8e1dc10b1ba3c48",
"date": "2019-12-01 16:30:44 -0500",
"subject": "Add PostgreSQL version where backup from standby is supported."
},
{
"commit": "218698088f0e4d5a978b8f4c8df6b114980889b9",
"date": "2019-12-01 16:28:33 -0500",
"subject": "Add PostgreSQL file and path names used for building manifests."
},
{
"commit": "56ee321a9565e7c1e076c58744e0cfc408801e28",
"date": "2019-12-01 15:49:34 -0500",
"subject": "Add pgLsnName() and pgXactPath()."
},
{
"commit": "bc83354fb53a1ba8a86366478c5be871775dd04a",
"date": "2019-11-29 11:29:16 -0500",
"subject": "Add storage feature flags.",
"body": "Even though storagePathSync() is a noop when path sync is not supported, it is useful to know in advance if the function will do anything so add the storageFeaturePathSync flag.\n\nThe storageFeatureSymLink and storageFeatureHardLink flags are currently informational only since links are not yet implemented in the storage interface."
},
{
"commit": "0933aeb1ad954f8c7b2ed6d4e160d7e132ada8b7",
"date": "2019-11-29 10:56:13 -0500",
"subject": "Remove unused reference to use pgBackRest::Backup::File."
},
{
"commit": "50eb062e0e7a6aac326e411ed28e0c8aa397bf01",
"date": "2019-11-28 09:34:19 -0500",
"subject": "Fix reference list when backup.info is reconstructed in expire command.",
"body": "Adding a manifest to backup.info was migrated to C in 4e4d1f41 but deduplication of the references was missed leading to a reference for every file being added to backup.info.\n\nSince the backup command is still using the Perl version of reconstruct this issue will not express unless 1) there is a backup missing from backup.info and 2) the expire command is run directly instead of running after backup as usual.\n\nThis unlikely combination of events means this is probably not a problem in the field."
},
{
"commit": "686b6f91da4cfdbc8708b0f08ced460c10e4326c",
"date": "2019-11-28 08:27:21 -0500",
"subject": "Set archive-check option in manifest correctly when offline.",
"body": "Archive check does not run when in offline backup mode but the option was set to true in the manifest. It's harmless since these options are informational only but it could cause confusion when debugging."
},
{
"commit": "5506e5de27b1a61015f6e18d5582ca81f696e30f",
"date": "2019-11-27 15:09:07 -0500",
"subject": "Remove obsolete call to perlExec() for stand-alone expire command.",
"body": "This was missed in ecae5e34."
},
{
"commit": "4683557c54d2f2511fd754ae7c0c5e34ac1e5ba4",
"date": "2019-11-26 17:22:30 -0500",
"subject": "Remove unused reference to pgBackRest::Db."
},
{
"commit": "158e439689c8247ba2e53da4bfe65934e391b690",
"date": "2019-11-26 17:16:45 -0500",
"subject": "Remove obsolete Perl archive code.",
"body": "This should have been removed in a1c13a50 but was missed."
},
{
"commit": "82df7e6f3bf53409b3c3a15eff7bbc33c13197f8",
"date": "2019-11-26 11:32:12 -0500",
"subject": "Update integration tests in real/all that use test points.",
"body": "Test points are not supported by the new C code so these will be replaced with unit tests.\n\nThe fact that the tests still pass even when the changes aren't made mid-backup (except application_name) shows how weak they were in the first place.\n\nEven so, this does represent a regression in (soon to be be removed) Perl coverage."
},
{
"commit": "b145c72b5c27ad299ad1fa7dcd84f45fb0797e0f",
"date": "2019-11-25 08:51:28 -0500",
"subject": "Update missing manifest warning in BackupInfo.",
"body": "This brings the Perl message in line with C to reduce expect log churn."
},
{
"commit": "8800f32ad9b6b9b1351afd4280cc8dfe1ada2d92",
"date": "2019-11-25 08:35:26 -0500",
"subject": "Remove exclusions once they have been tested in mock/all.",
"body": "The exclusions no longer have any effect after a restore and just add noise to the expect log."
},
{
"commit": "9856fef5861fbf054007233f78582d3584c03565",
"date": "2019-11-25 07:48:52 -0500",
"subject": "Update integration tests in mock/all that use test points.",
"body": "Test points will not be available in the C code so update these tests as best as possible without using them.\n\nThis represents a loss of coverage for the Perl code (soon to be removed) which will be made up in the C code with unit tests."
},
{
"commit": "3cd45a7411ce67630915c89cf5c69a37265d0e07",
"date": "2019-11-25 07:45:58 -0500",
"subject": "Remove start/stop --force integration tests in mock/all.",
"body": "These tests require test points which are not being implemented in the C code.\n\nThis functionality is fully tested in the command/control unit tests so integration tests are no longer required."
},
{
"commit": "01aefc563dbabc7c7b1b7dbed27716692898597f",
"date": "2019-11-25 07:37:09 -0500",
"subject": "Update Perl page checksum expression.",
"body": "This expression determines which files contain page checksums but it was also including the directory above the relation directories. In a real PostgreSQL installation this not a problem because these directories don't contain any files.\n\nHowever, our tests place a file in `base` which the Perl code thought should have page checksums while the new C code says no.\n\nUpdate the expression to document the change and avoid churn in the expect logs later."
},
{
"commit": "18e43c5955217838ad55e68e176b83a9187533ec",
"date": "2019-11-24 09:24:52 -0500",
"subject": "Fix comment typo."
},
{
"commit": "cace54151f3dc9f686b99923f1dbd1c010ab84f4",
"date": "2019-11-23 10:32:57 -0500",
"subject": "Add hostId to protocolLocalGet().",
"body": "Previously this function was only creating locals that talked to the repository. Backup will need to be able to talk to multiple PostgreSQL hosts."
},
{
"commit": "ab65ffdfacf47b6d182cbf6461d49a76c0cc8b00",
"date": "2019-11-23 10:22:11 -0500",
"subject": "Add protocolStorageType*() to manage protocol storage types.",
"body": "Abstract the string representation of storage types that are passed over the protocol layer."
},
{
"commit": "a4b9440d354c3cf95f7ca3aa68dc691c10c65e21",
"date": "2019-11-22 19:25:49 -0500",
"subject": "Only install specific lcov version when required.",
"body": "Installing lcov 1.14 everywhere turned out to be a problem just as using 1.13 on Ubuntu 19.04 was.\n\nSince we primarily use Ubuntu 18.04 for coverage testing and reporting, we definitely want to make sure that works. So, revert to using the default packaged lcov except when specified otherwise in VmTest.pm.\n\nPostgreSQL minor version releases are also included since all containers have been rebuilt."
},
{
"commit": "52a3ba6b6f25443b5ed456969b794f63a809a606",
"date": "2019-11-22 15:18:56 -0500",
"subject": "Revert \"Forbid % character in parameters.\"",
"body": "The issue \"fixed\" in f01aa586 was caused by treating all strings as format strings while logging, which was fixed in 0c05df45.\n\nRevert because there no longer seems a reason for the extra logic, and it was only partially applied, i.e. not to env vars, command-line options, or config options."
},
{
"commit": "381aecae4eeb15c538318e95c3101fa07a6712d4",
"date": "2019-11-22 14:30:56 -0500",
"subject": "Fix walPath() when CWD is / and path is relative.",
"body": "The function would return a // prefix in this case, which works fine but looks odd while debugging."
},
{
"commit": "0c05df458287c77df1188a68bbd74e145ed0f059",
"date": "2019-11-22 13:33:26 -0500",
"subject": "Add _FMT() logging macro variants.",
"body": "Using the same macros for formatted and unformatted logging had several disadvantages.\n\nFirst, the compiler was unable to verify the format string against the parameters.\n\nSecond, legitimate % characters in messages were being interpreted as format characters with garbage output ensuing.\n\nAdd _FMT() variants and update all call sites to use the correct variant."
},
{
"commit": "99edcca55b3b8b1d144bdeb32c4d98c8ee13bf34",
"date": "2019-11-22 09:18:24 -0500",
"subject": "Add missing linefeeds."
},
{
"commit": "29ab06cf133b6a3d18d7bc39507f92a45927b2e8",
"date": "2019-11-21 17:30:18 -0500",
"subject": "Add missing static keyword."
},
{
"commit": "f01aa5861d341a19d85ddf3d7307c250994fecd4",
"date": "2019-11-21 17:28:03 -0500",
"subject": "Forbid % character in parameters.",
"body": "This character causes problems in C and in the shell if we try to output it in an error message.\n\nForbid it completely and spell it out in error messages to avoid strange effects.\n\nThere is likely a better way deal with the issue but this will do for now."
},
{
"commit": "6be9c7b63a61464d60d15133662eb44776401b1d",
"date": "2019-11-21 17:20:42 -0500",
"subject": "Don't log secrets in cipherBlock module.",
"body": "In practice there are lots of ways secrets can be leaked (e.g. info load, protocol) but at least remove this instance."
},
{
"commit": "c524ec4f95462bfbc1484e139d754280ec05e94c",
"date": "2019-11-21 16:06:27 -0500",
"subject": "Remove obsolete integration tests from mock/all.",
"body": "The protocol timeout tests have been superceded by unit tests.\n\nThe TEST_BACKUP_RESUME test point was incorrectly included into a number of tests, probably a copy pasto. It didn't hurt anything but it did add 200ms to each test where it appeared.\n\nCatalog and control version tests were redundant. The database version and system id tests covered the important code paths and the C code gets these values from a lookup table.\n\nFinally, fix an incomplete update to the backup.info file while munging for tests."
},
{
"commit": "53cd530bbf3921c9500963d12393344425574d08",
"date": "2019-11-21 12:09:24 -0500",
"subject": "Safely initialize manifest object.",
"body": "Using a designated initializer is safer than zeroing the struct. It is also better for debugging because Valgrind should be able to detect access to areas that are not initialized due to alignment."
},
{
"commit": "270f9496e432109b243e8db5d497805f72c56d91",
"date": "2019-11-21 12:08:32 -0500",
"subject": "Add manifestMove()."
},
{
"commit": "c5a6631d2791ca5ae69a6178fac758b6c96f9781",
"date": "2019-11-21 11:44:40 -0500",
"subject": "Rearrange manifest module.",
"body": "Put functions with related functions, move getters above the helper functions, and rename manifestPgPath() to manifestPathPg()."
},
{
"commit": "9f71a019c815af58bdd10ca2ceaaf6f1506fb560",
"date": "2019-11-21 10:55:03 -0500",
"subject": "Allow storageInfo() to operate outside the base storage path.",
"body": "It is occasionally useful to get information about a file outside of the base storage path. storageLocal() can be used in some cases but when the storage is remote is doesn't seem worth creating a separate storage object for adhoc info requests.\n\nstorageInfo() is a read-only operation so this seems pretty safe. The noPathEnforce parameter will make auditing exceptions easy."
},
{
"commit": "d3b1897625c5b200724fb087cedd975fce07672f",
"date": "2019-11-21 10:34:32 -0500",
"subject": "Allow adhoc enforcement in storagePath().",
"body": "The ability to disable enforcement (i.e., the requested absolute path is within the storage path) globally will be removed after the Perl migration.\n\nThe feature will still be needed occasionally so allow it in an adhoc fashion."
},
{
"commit": "e1dad720a126e2145718ccc78614727fa67cd619",
"date": "2019-11-21 10:21:35 -0500",
"subject": "Rename storagePath() to storageP() in places where it was missed.",
"body": "Correct this since it will be enforced in a subsequent patch."
},
{
"commit": "cef9f0f37f33fe46ffcb229535a82479700b8de2",
"date": "2019-11-21 09:40:15 -0500",
"subject": "Process . in strPathAbsolute().",
"body": "A . in a link will always lead to an error since the destination will be inside PGDATA. However, it is accepted symlink syntax so it's better to resolve it and get the correct error message.\n\nAlso, we may have other uses for this function in the future."
},
{
"commit": "a6fc0bf2ca778844448885192f11d17bf933b551",
"date": "2019-11-21 08:15:37 -0500",
"subject": "Add contributor."
},
{
"commit": "3d2c0b0f3bcd4fbae0409a374f13d1aebb3bba81",
"date": "2019-11-20 14:24:58 -0500",
"subject": "Fix inverted page checksum load/save.",
"body": "This was not caught before because the on-disk format was correct even though the representation in memory was inverted."
},
{
"commit": "63c4c148361c75ec53d2d6b53a3ec69389b925c3",
"date": "2019-11-19 20:52:01 -0500",
"subject": "Fix lcov build in Vagrantfile.",
"body": "-q was being instead of -s for silent mode which caused the build to fail."
},
{
"commit": "5f034714453f28a04d8e48828e8ee53a61401c4e",
"date": "2019-11-19 15:56:13 -0500",
"subject": "Remove --force option from stanza-create documentation.",
"body": "This should have been removed when the support for the option was removed in c7333190.\n\nThe option cannot be removed entirely because we don't want to error in the case where --force was specified but the stanza is valid."
},
{
"commit": "c5ee56a724fe6c49b7e3496090ff1bf6d73e33f8",
"date": "2019-11-19 10:34:14 -0500",
"subject": "Markdown update missed in 1db9e3b1."
},
{
"commit": "20162ed3feec8d3de5de8e2cca7bb065a47bcc67",
"date": "2019-11-19 10:32:18 -0500",
"subject": "Fix typo."
},
{
"commit": "74317f0ab6024d6c3a2f9635677f26489786e166",
"date": "2019-11-17 17:35:03 -0500",
"subject": "Use variable parameter macros to make the storage interface tidier.",
"body": "Many functions don't take optional parameters, so tacking the struct onto the end was pretty burdensome.\n\nAdd macros to get the interface under a variety of circumstances to make this practical."
},
{
"commit": "1db9e3b144d886ec4159176312345d154b7178b8",
"date": "2019-11-17 15:10:40 -0500",
"subject": "Remove *MP() macros variants.",
"body": "Adding a dummy column which is always set by the P() macro allows a single macro to be used for parameters or no parameters without violating C's prohibition on the {} initializer.\n\n-Wmissing-field-initializers remains disabled because it still gives wildly different results between versions of gcc."
},
{
"commit": "5c65d88f6254176c257f0bf58ca5c9f59bb99177",
"date": "2019-11-17 14:17:03 -0500",
"subject": "Use structs to pass optional parameters to storage drivers.",
"body": "New optional parameters can be added without breaking the interface and this reduces noise in the function prototypes."
},
{
"commit": "09e129886e10a036e75493d55625f01c34e15d85",
"date": "2019-11-16 17:47:42 -0500",
"subject": "Add storageInfoList() support to remote storage driver."
},
{
"commit": "26e1da82e7970ac03b8300da5f55ed7da1c2ab96",
"date": "2019-11-16 17:32:49 -0500",
"subject": "Allow zero-length substrings to be extracted from the end of a string.",
"body": "The previous assert was a bit overzealous and did not allow this case. It's not very common but still occasionally useful."
},
{
"commit": "8a3de1e05a427bf40b7742ac476c01ef219f6b46",
"date": "2019-11-16 17:30:08 -0500",
"subject": "Add storageInfo() support to remote storage driver."
},
{
"commit": "8d6a8c3bf0401705578d05902f8e7f871f3ab266",
"date": "2019-11-16 17:12:16 -0500",
"subject": "Store base path for remote storage locally.",
"body": "It wasn't practical for the main process to be ignorant of the remote path, and in any case knowing the path makes debugging easier.\n\nPull the remote path when connecting and pass the result of local storagePath() to the remote when making calls."
},
{
"commit": "6827a13f3a4b1943769601acf34676bd1f689b4b",
"date": "2019-11-16 17:05:34 -0500",
"subject": "Add facility for reading and writing adhoc protocol output.",
"body": "Pushing output through a JSON blob is not practical if the output is extremely large, e.g. a backup manifest with 100K+ files.\n\nAdd read/write routines so that output can be returned in chunks but errors will still be detected."
},
{
"commit": "90e19d99bab6b448484865cb6b46fb786352009c",
"date": "2019-11-16 09:38:42 -0500",
"subject": "Add mock module to CentOS6/7 Travis CI testing.",
"body": "This was dropped at some point but is important for integration coverage."
},
{
"commit": "c8db11e65bed37ec18d83b527c895b8b86c9f11b",
"date": "2019-11-15 17:50:12 -0500",
"subject": "Add user-id/group-id to hrnReplaceKey()."
},
{
"commit": "53a2d04ab0e0c6d3ef75afcef1663492d9db98e7",
"date": "2019-11-15 17:48:25 -0500",
"subject": "Allow \"null\" in jsonToStr()."
},
{
"commit": "64ddc163c95b6bc87a7589462b1b16ca70cb08bc",
"date": "2019-11-15 10:50:17 -0500",
"subject": "Allow cipherPassSub() to be set in Info without the constructor.",
"body": "This value is not always known when the object is created so allow it to be set later."
},
{
"commit": "48e8942e86b1471568116dc7fe604878ca9afd70",
"date": "2019-11-15 08:53:15 -0500",
"subject": "Allow trailing / for relative paths in strPathAbsolute().",
"body": "The trailing / does nothing but is nevertheless valid syntax."
},
{
"commit": "83ab272171887092df85704e27ddfec22c9f335f",
"date": "2019-11-14 16:50:58 -0500",
"subject": "Update varNew*() calls to Variant constant macros.",
"body": "The constants created by the macros are faster and use less memory."
},
{
"commit": "3b879c2cb3cfdbcd03dad1d6cc898052f8d8863d",
"date": "2019-11-14 16:48:41 -0500",
"subject": "Filter logged command options based on the command definition.",
"body": "Previously, options were being filtered based on what was currently valid. For chained commands (e.g. backup then expire) some options may be valid for the first command but not the second.\n\nFilter based on the command definition rather than what is currently valid to avoid logging options that are not valid for subsequent commands. This reduces the number of options logged and will hopefully help avoid confusion and expect log churn."
},
{
"commit": "c5b76d213bc24d703e7b973df171a2b01595dabc",
"date": "2019-11-12 17:05:09 -0500",
"subject": "Modify InfoBackupData struct to use time_t for backup start/stop times.",
"body": "The uint64_t types worked but were not consistent with how timestamps are handled in other parts of the code."
},
{
"commit": "6f65dde8d39436a31f90030e9b3cef5cf10d04e3",
"date": "2019-11-12 15:56:28 -0500",
"subject": "Begin v2.20 development."
},
{
"commit": "2d10293d041cbbc72e4a2bac32401f6f384ecb1a",
"date": "2019-11-12 15:51:28 -0500",
"subject": "v2.19: C Migrations and Bug Fixes"
},
{
"commit": "a44c5d0315e49c42eb908a4ed0605bee0c509f6d",
"date": "2019-11-12 13:12:07 -0500",
"subject": "Add Strings for STORAGE_REPO_ARCHIVE and STORAGE_REPO_BACKUP.",
"body": "These constants are used often enough that they deserve to have String constants rather than repeatedly calling STRDEF()."
},
{
"commit": "10c8eeaf6c0413da265047aeb02a047209ef9d69",
"date": "2019-11-08 18:58:45 -0500",
"subject": "Fix handling of repeated HTTP headers.",
"body": "When HTTP headers are repeated they should be considered equivalent to a single comma-separated header rather than generating an error, which was the prior behavior."
},
{
"commit": "43171786336733d8e1efe672b801236fd3e2d829",
"date": "2019-11-08 17:56:34 -0500",
"subject": "Update MinIO to newest release.",
"body": "We had some problems with newer versions so had held off on updating. Those problems appear to have been resolved.\n\nIn addition, the --compat flag is no longer required. Prior versions of MinIO required all parts of a multi-part upload (except the last) to be of equal size. The --compat flag was introduced to restore the default S3 behavior. Now --compat is only required when ETag is being used for MD5 verification, which we don't do."
},
{
"commit": "edcc7306a39852ddff507d384555230001442bf4",
"date": "2019-11-08 09:46:00 -0500",
"subject": "Add TIME parameter debug type.",
"body": "Previously we were using int64_t to debug time_t but this may not be right depending on how the compiler represents time_t, e.g. it could be a float.\n\nSince a mismatch would have caused a compiler error we are not worried that this has actually happened, and anyway the worst case is that the debug log would be wonky.\n\nThe primary benefit, aside from correctness, is that it makes choosing a parameter debug type for time_t obvious."
},
{
"commit": "eca00e0be00bcd692b10de1b89a700f6525d51a7",
"date": "2019-11-07 13:11:01 -0500",
"subject": "Add building a development environment to contributing documentation.",
"body": "This documentation shows how to build a development environment on Ubuntu 19.04 and should work for other Debian-based distros.\n\nNote that this document is not included in automated testing due to some unresolved issues with Docker in Docker on Travis CI. We'll address this in the future when we add contributing documentation to the website."
},
{
"commit": "8b682b75d2ade2e52c75b417fad2eb61150616d1",
"date": "2019-11-02 10:35:48 +0100",
"subject": "Allow mock integration tests for all VM types.",
"body": "Previously the mock integration tests would be skipped for VMs other than the standard four used in CI. Now VMs outside the standard four will run the same tests as VM4 (currently U18)."
},
{
"commit": "b3e5d88304860fbcb566059d08cbf85e2c3cd95a",
"date": "2019-11-02 09:59:39 +0100",
"subject": "Add markdown renderer for execute-list block."
},
{
"commit": "7168e0744018d7d27668d59bfe9b6deafe923efa",
"date": "2019-10-30 14:55:25 +0100",
"subject": "Use getcwd() to construct path when WAL path is relative.",
"body": "Using pg1-path, as we were doing previously, could lead to WAL being copied to/from unexpected places. PostgreSQL sets the current working directory to PGDATA so we can use that to resolve relative paths."
},
{
"commit": "e06db21e35f701b62c625b9f25436459b8fd5c26",
"date": "2019-10-17 14:00:18 +0200",
"subject": "Error when specified vm is invalid."
},
{
"commit": "a52faf83a502427a7079ec2bae0593b318c2594c",
"date": "2019-10-17 11:56:45 +0200",
"subject": "Disable code generation on dry-run."
},
{
"commit": "fa6a54bb4503efdc8e02a98089a935b6d52a3797",
"date": "2019-10-16 17:05:24 +0200",
"subject": "Update last tests that required sudo.",
"body": "All tests should now run in a sudo-less environment."
},
{
"commit": "48bd9e22f124163aa61574027476af8b3737dc39",
"date": "2019-10-16 15:48:33 +0200",
"subject": "C test harness refactor.",
"body": "Consolidate setting configuration into hrnInit() and rename other functions for consistency.\n\nSplit out internal functions into a new header."
},
{
"commit": "b4aeb217e665a166cb75577e07f80b01bc0345d1",
"date": "2019-10-15 17:19:42 +0200",
"subject": "Allow parameters to be passed to travis.pl.",
"body": "This makes configuring tests easier.\n\nAlso add a parameter for tests that require sudo. This should be retired at some point but some tests still require it."
},
{
"commit": "f3b2189659a7f0e8e660c1be42175f0ff82cffb0",
"date": "2019-10-15 13:27:03 +0200",
"subject": "Remove package build sudo into the container.",
"body": "By running this in the container we no longer need sudo on the host system for package builds."
},
{
"commit": "67dde73727d2b30ce3f329054398a1f516a65899",
"date": "2019-10-14 11:51:14 +0200",
"subject": "Run tests in tmpfs.",
"body": "This will likely improve performance, but it also makes the filesystem consistent between platforms.\n\nA number of tests were failing on shiftfs, which was the default for arm64 on Travis."
},
{
"commit": "b1dc5a6d269b858960061e59f3885303d2417051",
"date": "2019-10-13 14:02:52 -0400",
"subject": "Add disk/mem info for Travis.",
"body": "This is helpful for determining the virtual machine resources."
},
{
"commit": "64c6102a1536ba94f4957fe950038f31525748b5",
"date": "2019-10-12 14:47:01 -0400",
"subject": "Update packages required for Travis-CI builds.",
"body": "These packages are expected on the arm64 build even though we are using the same os image as amd64. It appears the arm64 image is slimmer."
},
{
"commit": "35eef2b8676115036b9d68b14223629dd1e1b773",
"date": "2019-10-12 14:16:22 -0400",
"subject": "Use a lower user id for posix storage tests.",
"body": "arm64 was not happy with the old user id, so use something smaller."
},
{
"commit": "827e95944a2f13301fa14af5a8f11324e17a1cd9",
"date": "2019-10-12 13:52:45 -0400",
"subject": "Use < 0 and > 0 for strCmp() tests.",
"body": "Using -1 and 1 was a bit sloppy since the spec only guarantees that the values will be < 0 and > 0.\n\nFound on arm64 where the values were -64 and 64."
},
{
"commit": "a2fa1d04b0cbd6dbedaa2447273371c20bd46e56",
"date": "2019-10-12 11:26:13 -0400",
"subject": "Update container images to PostgreSQL 12 GA."
},
{
"commit": "397a41e0f9f82987952912b8127a5e6929e29752",
"date": "2019-10-12 11:24:55 -0400",
"subject": "Add Ubuntu 19.04 container definition."
},
{
"commit": "93656db186e6da286bd704dc65235fcc209bb19d",
"date": "2019-10-12 11:24:21 -0400",
"subject": "Update lcov to 1.14.",
"body": "1.13 is not compatible with gcc 8 which is what ships with newer distributions. Build from source to get a more recent version.\n\n1.13 is not compatible with gcc 9 so we'll need to address that at a later date."
},
{
"commit": "11c7c8fabb1e3eb9dadce2231fbb9cb3d76d553f",
"date": "2019-10-12 09:45:18 -0400",
"subject": "Remove pgbackrest test user.",
"body": "This user was created before we tested in containers to ensure isolation between the pg and repo hosts which were then just directories. The downside is that this resulted in a lot of sudos to set the pgbackrest user and to remove files which did not belong to the main test user.\n\nContainers provide isolation without needing separate users so we can now safely remove the pgbackrest user. This allows us to remove most sudos, except where they are explicitly needed in tests.\n\nWhile we're at it, remove the code that installed the Perl C library (which also required sudo) and simply add the build path to @INC instead."
},
{
"commit": "6f0e7f00af3e83d071713a671a6f155cd1fa3b88",
"date": "2019-10-12 09:26:19 -0400",
"subject": "Fix recovery test failing in PostgreSQL 12.0.",
"body": "This test was not creating recovery.signal when testing with --type=preserve. The preserve recovery type only keeps existing files and does not create any.\n\nRC1 was just ignoring recovery.signal and going right into recovery. Weirdly, 12.0 used restore_command to do crash recovery which made the problem harder to diagnose, but this has now been fixed in PostgreSQL and should be released in 12.1."
},
{
"commit": "59a4a0c1b1726812126a13e57bee29689b0a8fdc",
"date": "2019-10-11 13:14:47 -0400",
"subject": "Add a warning about jq rounding numbers to the documentation."
},
{
"commit": "db1dc4f275667903f560c140c2c61cce7f9b4020",
"date": "2019-10-11 13:03:52 -0400",
"subject": "Remove pretty-printing from jsonFromKv() and jsonFromVar().",
"body": "Now that pretty-printing has been removed from the info command it no longer has a purpose, so remove it."
},
{
"commit": "d90b2724f883686afdae386c1350abfdcfb0d5fa",
"date": "2019-10-11 12:56:03 -0400",
"subject": "JSON output from the info command is no longer pretty-printed.",
"body": "Monitoring systems can more easily ingest the JSON without linefeeds.\n\nExternal tools such as jq can be used to pretty-print if desired."
},
{
"commit": "29725805668656a920283401ef144a98cee2c5f9",
"date": "2019-10-11 12:38:03 -0400",
"subject": "Remove info expect tests from mock/all and mock/stanza.",
"body": "These tests are redundant now that we have full coverage in the unit tests are are not worth maintaining anymore."
},
{
"commit": "e4408c7dd390b13bb022b29e8f0b151fa0526362",
"date": "2019-10-11 12:28:47 -0400",
"subject": "Refactor --pre option in documentation.",
"body": "Mark all pre commands as skip so they won't be run again after the container is built.\n\nEnsure that pre commands added to the container are run as the container user if they are not intended to run as root."
},
{
"commit": "642ce003c8e8f59ec67d3bda4c18decb4aa21ae2",
"date": "2019-10-11 11:32:51 -0400",
"subject": "Don't autogenerate embedded libc code by default.",
"body": "This is only needed when new code is added to the Perl C library, which is becoming rare as the migration progresses.\n\nAlso, the code will vary slightly based on the Perl version used for generation so for normal users it is just noise."
},
{
"commit": "bcd3e4953aa1c8e8ccfadd141f38473b2ecbaff6",
"date": "2019-10-10 22:10:20 -0400",
"subject": "Make perl/exec test container required.",
"body": "This test fails in some cases when --vm=none but it's not worth investigating since this code will be going away soon."
},
{
"commit": "e3d87ebace36984728ae571a77ca1e11ae383d5b",
"date": "2019-10-10 19:43:42 -0400",
"subject": "Fix mismatched timezone in expect test.",
"body": "Also run the --vm-none tests in a non-UTC timezone to prevent regressions."
},
{
"commit": "6db4e59a6631eb47758fd0dff772e2ca086e924b",
"date": "2019-10-10 16:13:43 -0400",
"subject": "Allow tests that use ports to run in parallel.",
"body": "Set the test index in the C unit test code so it can assign port numbers that won't conflict between tests."
},
{
"commit": "13fcbb24e940084710acc13627515522215369dc",
"date": "2019-10-10 15:09:11 -0400",
"subject": "Fix container test path being used when --vm=none."
},
{
"commit": "e732720d855cffa0e4bb80997529254323fd7767",
"date": "2019-10-10 11:28:37 -0400",
"subject": "Disable docker service for --vm=none test.",
"body": "Starting this service wastes time and this will help catch any regressions where containers are being built when they should not be."
},
{
"commit": "9a3ba649e111f3529bb6fe09238d9fcb81454487",
"date": "2019-10-10 11:25:59 -0400",
"subject": "Remove code to generate .travis.yml.",
"body": "Most of the logic has been moved to test/travis.pl so there wasn't much purpose to this code anymore."
},
{
"commit": "696e6a7c444ba0ec3a28f8762b6a7266751faa0f",
"date": "2019-10-10 11:21:09 -0400",
"subject": "Don't require sudo to run tests with --vm=none.",
"body": "Run these tests without sudo privileges on Travis to prevent regressions."
},
{
"commit": "50d1d0a4e8f232842a27c4998cb6af3f1d906bf3",
"date": "2019-10-10 09:28:50 -0400",
"subject": "Move release note to correct section."
},
{
"commit": "47e0ba2502e5c3e8eb088ffcbd774144741b599b",
"date": "2019-10-10 09:27:46 -0400",
"subject": "Fix remote timeout in delta restore.",
"body": "When performing a delta restore on a largely unchanged cluster the remote could timeout if no files were fetched from the repository within protocol-timeout.\n\nAdd keep-alives to prevent remote timeout."
},
{
"commit": "82baf1e521e2a1ed7b27403478aa4a1dc4a6afcc",
"date": "2019-10-10 08:33:40 -0400",
"subject": "Fix typo."
},
{
"commit": "7f369006b5c812d0d3e05f4735d03623c3873b45",
"date": "2019-10-09 15:03:03 -0400",
"subject": "Add gcc 9 support.",
"body": "A number of tests have been updated and Fedora 30 has been added to the test suite so the unit tests can run on gcc 9.\n\nStop running unit tests on co6/7 since we appear to have ample unit test coverage."
},
{
"commit": "528f4c4347d89a0c05b0a9521e8ef91432616b0c",
"date": "2019-10-09 14:38:24 -0400",
"subject": "Remove dependency on aws cli for testing.",
"body": "This tool was only being used it a few places but was a pretty large dependency.\n\nRework the forceStorageMove() code using our storage layer and replace one aws cli cp with a storage put.\n\nAlso, remove the Dockerfile that was once used to build the Scality S3 test container."
},
{
"commit": "ac870b42de5a51436a4a08c6ad405ac4f1dd0763",
"date": "2019-10-09 08:43:30 -0400",
"subject": "Refactor error logic to make sure Db object gets freed immediately.",
"body": "Because db can be reset to NULL on an error in the try block we need nested try blocks to ensure that db is non-NULL and can be freed on an error after being created.\n\nThis is not a production issue because the db will be freed when the temp mem context is freed, but it does affect reproducibility in the tests and is a bit tidier."
},
{
"commit": "61c4f64895497da4cbe1e9225f274d255dd5133e",
"date": "2019-10-08 18:56:55 -0400",
"subject": "Be smarter about which packages are loaded for testing.",
"body": "Now that our tests are more diversified it makes sense to load only the packages that are needed for each test.\n\nMove the package loads from .travis.yaml to test/travis.pl where we have more control over what is loaded."
},
{
"commit": "a1c13a50dd0886076a1f32e58901eec271d9ec9a",
"date": "2019-10-08 18:04:09 -0400",
"subject": "The check command is implemented entirely in C.",
"body": "Note that building the manifest on each host has been temporarily removed.\n\nThis feature will likely be brought back as a non-default option (after the manifest code has been fully migrated to C) since it can be fairly expensive."
},
{
"commit": "ecae5e34e5063838bb55d55b1752c6b2eaaaa75b",
"date": "2019-10-08 17:30:33 -0400",
"subject": "Update expire command to use C backup.info reconstruct.",
"body": "This was still being done in Perl until the C Manifest object was available."
},
{
"commit": "4e4d1f414a153232079f2e2e9ce203ffc5a2362c",
"date": "2019-10-08 16:04:27 -0400",
"subject": "Add infoBackupLoadFileReconstruct() to InfoBackup object.",
"body": "Check the backup.info file against the backup path. Add any backups that are missing and remove any backups that no longer exist.\n\nIt's important to run this before backup or expire to be sure we are using the most up-to-date list of backups."
},
{
"commit": "b2825b82c7b8cf140969dd4e9fd04552e921bbfc",
"date": "2019-10-08 15:47:47 -0400",
"subject": "Add missing header file."
},
{
"commit": "6d8d0eeba71fa7cd00af6e40c0adf74638a371bd",
"date": "2019-10-08 15:37:08 -0400",
"subject": "Add pgBackRest version to Info and Manifest objects.",
"body": "This was not being exposed previously because it is primarily informational, but now it is needed to reconstruct the backup.info file."
},
{
"commit": "38b72eded4b0f295ed1f30f849f0a99f69e396d2",
"date": "2019-10-08 15:27:17 -0400",
"subject": "Document how to contribute to pgBackRest.",
"body": "There's a lot more to be done here, but this is a good start."
},
{
"commit": "a4152a0ea1dc5c28515aedf9690cab22765076cb",
"date": "2019-10-08 12:29:42 -0400",
"subject": "Update release instructions with a reminder to install latex.",
"body": "Latex is no longer installed by default in the Vagrantfile."
},
{
"commit": "45881c74aeff4bb25559ec0254fa7fc1960d9cab",
"date": "2019-10-08 12:06:30 -0400",
"subject": "Allow most unit tests to run outside of a container.",
"body": "Three major changes were required to get this working:\n\n1) Provide the path to pgbackrest in the build directory when running outside a container. Tests in a container will continue to install and run against /usr/bin/pgbackrest.\n\n1) Set a per-test lock path so tests don't conflict on the default /tmp/pgbackrest path. Also set a per-test log-path while we are at it.\n\n2) Use localhost instead of a custom host for TLS test connections. Tests in containers will continue to update /etc/hosts and use the custom host.\n\nAdd infrastructure and update harnessCfgLoad*() to get the correct exe and paths loaded for testing.\n\nSince new tests are required to verify that running outside a container works, also rework the tests in Travis CI to provide coverage within a reasonable amount of time. Mainly, break up to doc tests by VM and run an abbreviated unit test suite on co6 and co7."
},
{
"commit": "77b0c6c993a0e6ff45a6a99f343c3709a016d152",
"date": "2019-10-08 10:35:47 -0400",
"subject": "Add missing spaces."
},
{
"commit": "5394893e33a844991a913e3b3c8874b435ac88d1",
"date": "2019-10-03 11:14:22 -0400",
"subject": "Remove pgPath parameter from pgControlFromFile().",
"body": "In practice this function is always used with storagePg*() so pgPath is known."
},
{
"commit": "887ec97e0743f758a0a2d2222cd1553b91f0908d",
"date": "2019-10-03 06:58:52 -0400",
"subject": "Document maximum version for auto-stop option."
},
{
"commit": "008ec6b05c631adf08cba312d6bab972f02881ef",
"date": "2019-10-01 17:04:26 -0400",
"subject": "Begin v2.19 development."
},
{
"commit": "4629237d6a308a250cd52fff49693cd0a1069253",
"date": "2019-10-01 16:02:07 -0400",
"subject": "v2.18: PostgreSQL 12 Support"
},
{
"commit": "29e132f5e928298e9be135d76674f2016b122029",
"date": "2019-10-01 13:20:43 -0400",
"subject": "PostgreSQL 12 support.",
"body": "Recovery settings are now written into postgresql.auto.conf instead of recovery.conf. Existing recovery_target* settings will be commented out to help avoid conflicts.\n\nA comment is added before recovery settings to identify them as written by pgBackRest since it is unclear how, in general, old settings will be removed.\n\nrecovery.signal and standby.signal are automatically created based on the recovery settings."
},
{
"commit": "6be7e6fde54f2dc3edbed802efc3f5cb1e050fd2",
"date": "2019-10-01 10:25:08 -0400",
"subject": "Fix misplaced String declarations."
},
{
"commit": "309ae66e2fbd128b54f0859b231c14f6ab1518c4",
"date": "2019-10-01 08:47:56 -0400",
"subject": "Remove unneeded static declarations and use sizeof() where appropriate."
},
{
"commit": "f96c54c4ba0e526cda4cf9bed5cc1231b1d819b5",
"date": "2019-09-30 12:39:38 -0400",
"subject": "Add info command set option for detailed text output.",
"body": "The additional details include databases that can be used for selective restore and a list of tablespaces and symlinks with their default destinations.\n\nThis information is not included in the JSON output because it requires reading the manifest which is too IO intensive to do for all manifests. We plan to include this information for JSON in a future release."
},
{
"commit": "33ec5a3aacdfe0dd258463c0cbcd43f0d155152e",
"date": "2019-09-29 09:05:55 -0400",
"subject": "Sort lists where it might help performance.",
"body": "Most of these lists should be quite small with the exception of the list in get.c, but it doesn't cost much to sort them and may help in corner cases we have not thought of."
},
{
"commit": "a58635ac0285fbb3178329bdc222221fe7160380",
"date": "2019-09-28 14:24:27 -0400",
"subject": "Move C performance tests out of unit tests.",
"body": "Performance tests were being done in unit tests until there was a better place to put them.\n\nNow there is, so move them there."
},
{
"commit": "f1ba428fb037eac7b6c6ea5b9f617d1ad4579026",
"date": "2019-09-28 14:02:12 -0400",
"subject": "Add performance test capability in C with scaling.",
"body": "Scaling allows the starting values to be increased from the command-line without code changes.\n\nAlso suppress valgrind and assertions when running performance testing. Optimization is left at -O0 because we should not be depending on compiler optimizations to make our code performant, and it makes profiling more informative."
},
{
"commit": "004ff99a2d918fa3a5079ce9d7ff2f5b120176e3",
"date": "2019-09-28 13:17:21 -0400",
"subject": "Identify Perl performance test by appending -perl.",
"body": "This is intended to differentiate the upcoming C performance tests from the Perl performance tests that will eventually be migrated."
},
{
"commit": "cb62bebadf62613b770f79cd4fd43e20ec7db10c",
"date": "2019-09-28 10:08:20 -0400",
"subject": "Use bsearch() on sorted lists rather than an iterative method.",
"body": "bsearch() is far more efficient than an iterative approach except in the most trivial cases.\n\nFor now insert will reset the sort order to none and the list will need to be resorted before bsearch() can be used. This is necessary because item pointers are not stable after a sort, i.e. they can move around. Until lists are stable it's not a good idea to surprise the caller by mixing up their pointers on insert."
},
{
"commit": "d3d2a7cd8606be9696957eb052ca6569db1a8167",
"date": "2019-09-28 09:57:06 -0400",
"subject": "Add line number and fix spacing in TEST_LOG*() macros."
},
{
"commit": "afc483ef86aefe2cf8f057b6159af2c54f77c28b",
"date": "2019-09-27 13:37:59 -0400",
"subject": "Clarify which timeline should be used for timeline integration test."
},
{
"commit": "0a4122c77dc2e3fb866b95be73c2831530b2def1",
"date": "2019-09-27 13:34:59 -0400",
"subject": "Add reviewer."
},
{
"commit": "6355451870c90be346a378ef8b301f182c635edb",
"date": "2019-09-27 13:33:14 -0400",
"subject": "Fix old option name in documentation."
},
{
"commit": "d82102d6ef5445e5c96e47a095210f36a618b800",
"date": "2019-09-27 13:04:36 -0400",
"subject": "Add explicit promotes to recovery integration tests.",
"body": "PostgreSQL 12 will shutdown in these cases which seems to be the correct action (according to the documentation) when hot_standby = off, but older versions are promoting instead. Set target_action explicitly so all versions will behave the same way.\n\nThis does beg the question of whether the PostgreSQL 12 behavior is wrong (though it matches the docs) or the previous versions are."
},
{
"commit": "833d0da0d96036ada9e2397e2b1484d2032c25fa",
"date": "2019-09-27 12:29:33 -0400",
"subject": "Store recovery file name in integration when testing preserve recovery.",
"body": "This makes the test a little more maintainable and is friendly with the changes needed for PostgreSQL 12."
},
{
"commit": "80eb561cafc1af645e689cca865158e4336c143d",
"date": "2019-09-27 09:45:11 -0400",
"subject": "Add missing PostgreSQL 11 control/WAL versions in Perl tests.",
"body": "These values don't seem to be used for testing but better to be tidy."
},
{
"commit": "d6a6d93a041af1b8e333d8e9b68b151ae43e564d",
"date": "2019-09-27 09:35:59 -0400",
"subject": "Add PostgreSQL 12 to u18 container.",
"body": "This does not add PostgresQL 12 support; it simply adds PostgreSQL 12 to the u18 container for development and testing."
},
{
"commit": "03a7bda511b293cf40fd8324951ace1252d40ac2",
"date": "2019-09-27 09:19:12 -0400",
"subject": "Refactor recovery file generation.",
"body": "Separate the generation of recovery values and formatting them into recovery.conf format. This is generally a good idea, but also makes the code ready to deal with a different recovery file in PostgreSQL 12.\n\nAlso move the recovery file logic out of cmdRestore() into restoreRecoveryWrite()."
},
{
"commit": "cf1e96e827d154a62c0b52ff5531dd687695bf73",
"date": "2019-09-27 08:50:33 -0400",
"subject": "Refactor handling of ignored files in restore delta cleanup.",
"body": "Replace the boolean logic with a simple list that will be checked to see if the file should be ignored."
},
{
"commit": "c41fb575fbef7b4ce9714986b08f48d32b719862",
"date": "2019-09-26 17:39:45 -0400",
"subject": "Add standby restore type.",
"body": "This restore type automatically adds standby_mode=on to recovery.conf.\n\nThis could be accomplished previously by setting --recovery-option=standby_mode=on but PostgreSQL 12 requires standby mode to be enabled by a special file named standby.signal.\n\nThe new restore type allows us to maintain a common interface between PostgreSQL versions."
},
{
"commit": "89793368196e4073ca7137f2bf21edb385fb9ef6",
"date": "2019-09-26 16:02:39 -0400",
"subject": "Comment out unprivileged user documentation.",
"body": "We haven't had the time to complete this documentation and it has suffered bit rot.\n\nThis prevents us from building the docs on PostgreSQL >= 11 so just comment it all out until it can be updated."
},
{
"commit": "451ae397bec3f3bc070c4db674cc5df61bd63498",
"date": "2019-09-26 07:52:02 -0400",
"subject": "The restore command is implemented entirely in C.",
"body": "For the most part this is a direct migration of the Perl code into C.\n\nThere is one important behavioral change with regard to how file permissions are handled. The Perl code tried to set ownership as it was in the manifest even when running as an unprivileged user. This usually just led to errors and frustration.\n\nThe C code works like this:\n\nIf a restore is run as a non-root user (the typical scenario) then all files restored will belong to the user/group executing pgBackRest. If existing files are not owned by the executing user/group then an error will result if the ownership cannot be updated to the executing user/group. In that case the file ownership will need to be updated by a privileged user before the restore can be retried.\n\nIf a restore is run as the root user then pgBackRest will attempt to recreate the ownership recorded in the manifest when the backup was made. Only user/group names are stored in the manifest so the same names must exist on the restore host for this to work. If the user/group name cannot be found locally then the user/group of the PostgreSQL data directory will be used and finally root if the data directory user/group cannot be mapped to a name."
},
{
"commit": "92e48c856ac87838c479c2a454fe007cf026d4bd",
"date": "2019-09-26 07:27:07 -0400",
"subject": "Add missing asserts."
},
{
"commit": "f2781bdad4bbe2afba4a0eda7df90753c63ccf03",
"date": "2019-09-25 16:38:13 -0400",
"subject": "Allow documentation to be built without encryption.",
"body": "This is mainly useful for testing, where an encrypted repo is a real nuisance."
},
{
"commit": "e968acbdd74db8f78f718cbe5bd6358107bcf822",
"date": "2019-09-24 16:55:11 -0400",
"subject": "Fix outdated comment.",
"body": "This was probably missed when a new test was added and the timeline was updated."
},
{
"commit": "6af64df9b6519897a55a733583ee40a571a51ee6",
"date": "2019-09-23 19:26:24 -0400",
"subject": "Thoughts on repository version 6."
},
{
"commit": "71349c89aecdb3b158d1638d0310cdba6c96362a",
"date": "2019-09-23 17:56:17 -0400",
"subject": "Add TEST_TITLE() macro.",
"body": "This macro displays a title for each test. A test frequently has multiple parts and it was hard to tell which subparts went together. We used ad hoc indentation to do this.\n\nAnything that is a not a title is automatically indented so manually indenting is not longer needed. This should make the tests and the test output easier to read."
},
{
"commit": "2fd2fe509f3039ef28766b865f3b66cc524dee04",
"date": "2019-09-23 17:20:47 -0400",
"subject": "Add TEST_RESULT_LOG*() and TEST_SYSTEM*() macros.",
"body": "These macros encapsulate the functionality provided by direct calls to harnessLogResult() and system(). They both have _FMT() variants.\n\nThe primary advantage is that {[path]}, {[user]}, and {[group]} will be replaced with the test path, user, and group respectively. This saves a log of strNewFmt() calls and makes the tests less noisy."
},
{
"commit": "d3a7055ee5d290da0196ba266051846c107ddede",
"date": "2019-09-23 15:15:04 -0400",
"subject": "Only enable test.pl --debug-test-trace option when --debug also enabled.",
"body": "The other way makes no sense and leads to compile errors since --debug-test-trace requires some code that is only enabled by --debug."
},
{
"commit": "072aeb810932605bb5e2b8ef64288f24913ddd04",
"date": "2019-09-23 15:10:31 -0400",
"subject": "Add LFs to storage list tests.",
"body": "This makes the diffs easier to read when testing."
},
{
"commit": "c969137021da5dc03e5f95d36080f4e4fd08522b",
"date": "2019-09-23 13:50:46 -0400",
"subject": "Migrate backup manifest load/save to C.",
"body": "The backup manifest stores a complete list of all files, links, and paths in a backup along with metadata such as checksums, sizes,\ntimestamps, etc. A list of databases is also included for selective restore.\n\nThe purpose of the manifest is to allow the restore command to confidently reconstruct the PostgreSQL data directory and ensure that\nnothing is missing or corrupt. It is also useful for reporting, e.g. size of backup, backup time, etc.\n\nFor now, migrate enough functionality to implement the restore command."
},
{
"commit": "5b64c93e8b1de010176b8d3927f80cc8039f4dbc",
"date": "2019-09-20 17:50:49 -0400",
"subject": "Add local option for cfgExecParam().",
"body": "cfgExecParam() was originally written to provide options for remote processes. Remotes processes do not have access to the local config so it was necessary to pass every non-default option.\n\nLocal processes on the other hand, e.g. archive-get, archive-get-async, archive-push-async, and local, do have access to the local config and therefore don't need every parameter to be passed on the command-line. The previous way was not wrong, but it was overly verbose and did not align with the way Perl had worked.\n\nUpdate cfgExecParam() to accept a local option which excludes options from the command line which can be read from local configs."
},
{
"commit": "3f18040aab5707c9be9b51fe37f3464d222fceb5",
"date": "2019-09-20 08:13:36 -0400",
"subject": "Rename MANIFEST_FILE to BACKUP_MANIFEST_FILE.",
"body": "This is a bit more descriptive and avoids a naming conflict in the new C manifest code."
},
{
"commit": "174cb7b3af6b40d171186060509252c256208cd6",
"date": "2019-09-19 22:42:28 -0400",
"subject": "Add strPathAbsolute() and strLstRemoveIdx().",
"body": "strPathAbsolute() generates an absolute path from an absolute base path and an absolute/relative path.\n\nstrLstRemoveIdx() is a support function based on lstRemoveIdx()."
},
{
"commit": "9421493d09033efda2d5e2cc6eb60d13491beca3",
"date": "2019-09-19 22:34:12 -0400",
"subject": "Allow resets when generating local/remote command options.",
"body": "Somehow this was left out of the original implementation, but it is particularly important for certain types of restores."
},
{
"commit": "e24b2e3f4dcb0a288b4e742fd0b198b768d6320a",
"date": "2019-09-18 22:23:04 -0400",
"subject": "Only test timestamps for files.",
"body": "In general we don't care about path and link times since they are easily recreated when restoring.\n\nSo, outside of storageInfo() we don't need to bother testing them."
},
{
"commit": "54638e87042b2315f24abef2d7f8c5610c53762e",
"date": "2019-09-18 22:17:22 -0400",
"subject": "Add strLstRemove().",
"body": "Allow a string to be removed from a StringList using the underlying lstRemove()."
},
{
"commit": "a6a42b18a9c28b1410df803d7073340b2d7d52c6",
"date": "2019-09-18 22:09:49 -0400",
"subject": "Use switch instead of if else tree in jsonFromKvInternal().",
"body": "This is more efficient but more importantly it is easier to read."
},
{
"commit": "60d93df503c234730109c87114068dde4203804e",
"date": "2019-09-18 07:15:16 -0400",
"subject": "Use a callback to feed jobs to ProtocolParallel.",
"body": "Loading jobs in advance uses a lot of memory in the case that there are millions of jobs to be performed. We haven't seen this yet, but with backup and restore on the horizon it will become the norm.\n\nInstead, use a callback so that jobs are only created as they are needed and can be freed as soon as they are completed."
},
{
"commit": "ce1c7b02520f2e37dfcfb283471fb4ec263b5d50",
"date": "2019-09-17 21:04:38 -0400",
"subject": "Ignore write errors when the ls command is writing to stdout.",
"body": "It's possible (even likely) that the ls output is being piped to something like head which will exit when it gets what it needs and leave us writing to a broken pipe.\n\nIt would be better to just ignore the broken pipe error but currently we don't store system error codes."
},
{
"commit": "8675699d08b91c57294becfcf27dbf7ddb594c46",
"date": "2019-09-16 14:09:53 -0400",
"subject": "Add FAQ for time-based Point-in-Time Recovery."
},
{
"commit": "49b421d372144df726d71552850e55cee298a566",
"date": "2019-09-16 13:56:25 -0400",
"subject": "Add documentation clarifications regarding standby repositories.",
"body": "Clarify that placing the repository on a standby is not a robust configuration and recommend against it."
},
{
"commit": "09ef03b7ef69d2760756146cad86b784b0b5d7c3",
"date": "2019-09-15 08:27:38 -0400",
"subject": "Add FAQ regarding backup-standby."
},
{
"commit": "f9c8bd31de89cc1140fe37e3996672bbb1c99934",
"date": "2019-09-14 14:10:04 -0400",
"subject": "Add required FreeBSD header."
},
{
"commit": "56bf9d0566bbb9708d1687e9d2e59be306e32dda",
"date": "2019-09-14 12:21:08 -0400",
"subject": "Update HINT messages to conform to new standard detailed in CODING.md."
},
{
"commit": "c5f496b903ab9a4fa545d5f1a0a8dae9ec5c49af",
"date": "2019-09-14 11:56:29 -0400",
"subject": "Rename parameter processId to processIdx in harnessFork.h for clarity."
},
{
"commit": "f57e119b25d73a4b33aa83b5484898c5d7e84dfb",
"date": "2019-09-13 12:28:39 -0400",
"subject": "Document the relationship between db-timeout and protocol-timeout."
},
{
"commit": "15d04ca19c0bd1aafe9d4389e8429bcc392e842d",
"date": "2019-09-12 16:29:50 -0400",
"subject": "Add recursion and json output to the ls command.",
"body": "These features finally make the ls command practical.\n\nCurrently the JSON contains only name, type, and size. We may add more fields in the future, but these seem like the minimum needed to be useful."
},
{
"commit": "e45baa1830ac5251fc4284d094c3e12920e50862",
"date": "2019-09-12 16:03:05 -0400",
"subject": "Add sorting, filters, and recursion to storageInfoList().",
"body": "These are needed for the ls command and are also useful for testing."
},
{
"commit": "92365fb801543f8d6d52037b1936b3cd42512238",
"date": "2019-09-12 15:55:18 -0400",
"subject": "Disable missing-field-initializers warnings in unit testing.",
"body": "This warning gives very unpredictable results between compiler versions and seems unrealistic since most of our structs are zeroed for initialization.\n\nThis warning has been disabled in the Makefile for a long time."
},
{
"commit": "f809d2f008a4d8d769b72a68ffff9ef75ab9de22",
"date": "2019-09-12 15:16:42 -0400",
"subject": "Ignore apt-get update errors in Travis CI.",
"body": "Broken vendor packages have been causing builds to break due to an error on apt-get update.\n\nIgnore errors and proceed directory to apt-get install. It's possible that we'll try to reference an expired package version and get an error anyway, but that seems better than a guaranteed hard error."
},
{
"commit": "506c10f7f270806aca8acecaa303bf4458463720",
"date": "2019-09-12 12:04:25 -0400",
"subject": "Sort and find improvements to List and StringList objects.",
"body": "Push the responsibility for sort and find down to the List object by introducing a general comparator function that can be used for both sorting and finding.\n\nUpdate insert and add functions to return the item added rather than the list. This is more useful in the core code, though numerous updates to the tests were required."
},
{
"commit": "e4a071ce033ae53dafb35eb9ccd4daba1030064c",
"date": "2019-09-12 10:56:45 -0400",
"subject": "Add missing header in common/user module."
},
{
"commit": "b53305cc361e9978807d506e3e8ec13b3ae93511",
"date": "2019-09-12 08:17:07 -0400",
"subject": "Update incorrect pipelining references to connection reuse.",
"body": "Connection reuse and pipelining are not the same thing and should not have been conflated.\n\nUpdate comments and release notes to reflect the correct usage."
},
{
"commit": "dca5b63f970be8a13cd11222f4b5a9d4ca71261e",
"date": "2019-09-10 13:06:44 -0400",
"subject": "Move documentation job first for Travis CI.",
"body": "Since this job has been running long recently this should improved overall performance when multiple commits are queued up."
},
{
"commit": "f4f21d0df7217bcb583189d0fc4ecaac3faed146",
"date": "2019-09-10 13:02:05 -0400",
"subject": "Add groupIdFromName() and userIdFromName() to user module.",
"body": "Update StorageWritePosix to use the new functions.\n\nA side effect is that storageWritePosixOpen() will no longer error when the user/group name does not exist. It will simply retain the original user/group, i.e. the user that executed the restore.\n\nIn general this is a feature since completing a restore is more important than setting permissions exactly from the source host. However, some notification of this omission to the user would be beneficial."
},
{
"commit": "f8d0574759340f0260f06e377da412041987f582",
"date": "2019-09-10 12:29:36 -0400",
"subject": "Increase process timeout and emit occasional warnings.",
"body": "Travis will timeout after 10 minutes with no output. Emit a warning every 5 minutes to keep Travis alive and increase the total timeout to 20 minutes.\n\nDocumentation builds have been timing out a lot recently so hopefully this will help."
},
{
"commit": "e043c6b1bc388422aee9255077544c3644b8f69d",
"date": "2019-09-09 07:37:57 -0400",
"subject": "Update comment missed in d957acb3."
},
{
"commit": "1049632873d5a70cda90e5c4ed87312bfe4810d6",
"date": "2019-09-08 20:11:51 -0400",
"subject": "Add user module for managing system users/groups.",
"body": "Centralize the management of users and groups.\n\nAlso update Posix storage driver where users/groups were already in use."
},
{
"commit": "d957acb36b6b50c6166d9a68b03f239cdc508fa7",
"date": "2019-09-08 06:53:23 -0400",
"subject": "Add function to generate PostgreSQL tablespace identifier.",
"body": "In PostgreSQL >= 9.0 each tablespace data is stored in a specially named directory so different major versions can share the same tablespace path."
},
{
"commit": "051128ed9ee0ebc63fb35e69818c6213397a053f",
"date": "2019-09-08 06:47:52 -0400",
"subject": "Add test macro for comparing String to zero-terminated strings.",
"body": "This macro avoids the need to wrap the first parameter in strPtr() and should improve readability."
},
{
"commit": "0a96764cb8daa615121069e840268e216d1983ff",
"date": "2019-09-07 18:04:39 -0400",
"subject": "Remove most references to PostgreSQL control and catalog versions.",
"body": "The control and catalog versions were stored a variety of places in the optimistic hope that they would be useful. In fact they never were.\n\nWe can't remove them from the backup.info and backup.manifest files due to backwards compatibility concerns, but we can at least avoid loading and storing them in C structures.\n\nAdd functions to the PostgreSQL interface which will return the control and catalog versions for any supported version of PostgreSQL to allow backwards compatibility for backup.info and backup.manifest. These functions will be useful in other ways, e.g. generating the tablespace identifier in PostgreSQL >= 9.0."
},
{
"commit": "843a602080e13ea0f205720892f7bfee58e075fb",
"date": "2019-09-07 15:41:55 -0400",
"subject": "Add user/group id to storageInfo().",
"body": "This is required for some operations on Posix storage."
},
{
"commit": "1c7c1042b4509ff3ad42dad240d895617f01d644",
"date": "2019-09-07 12:32:25 -0400",
"subject": "Remove extraneous semicolons and add spaces."
},
{
"commit": "2eb1d1fee315e1e757856d3d88eb74b8434dad74",
"date": "2019-09-06 16:50:57 -0400",
"subject": "Rename lstRemove() to lstRemoveIdx().",
"body": "This works better with the names of upcoming functions and seems sensible even in isolation."
},
{
"commit": "dde0c2b0c9c9743a863b6064e7dbb69de26fa364",
"date": "2019-09-06 16:43:53 -0400",
"subject": "Rename INFO_MANIFEST_FILE to MANIFEST_FILE.",
"body": "This was missed in 5c314df0 when the module was renamed."
},
{
"commit": "4d84820021ad2a96922c87263d9200aace42358f",
"date": "2019-09-06 13:48:28 -0400",
"subject": "Improve performance of info file load/save.",
"body": "Info files required three copies in memory to be loaded (the original string, an ini representation, and the final info object). Not only was this memory inefficient but the Ini object does sequential scans when searching for keys making large files very slow to load.\n\nThis has not been an issue since archive.info and backup.info are very small, but it becomes a big deal when loading manifests with hundreds of thousands of files.\n\nInstead of holding copies of the data in memory, use a callback to deliver the ini data directly to the object when loading. Use a similar method for save to avoid having an intermediate copy. Save is a bit complex because sections/keys must be written in alpha order or older versions of pgBackRest will not calculate the correct checksum.\n\nAlso move the load retry logic to helper functions rather than embedding it in the Info object. This allows for more flexibility in loading and ensures that stack traces will be available when developing unit tests."
},
{
"commit": "7334f30c350b5275106b9acf28b60d999287d800",
"date": "2019-09-06 13:35:28 -0400",
"subject": "Add helper function for adding CipherBlock filters to groups."
},
{
"commit": "5c314df098ee2295af400fb0b6b4f0cccd96fb69",
"date": "2019-09-05 19:53:00 -0400",
"subject": "Rename infoManifest module to manifest.",
"body": "The manifest is not an info file so if anything it should be called backupManifest. But that seems too long for such a commonly used object so manifest seems better.\n\nNote that unlike Perl there is no storage manifest method so this stands as the only manifest in the C code, as befits its importance."
},
{
"commit": "8df7d68c8dca2c61b665bbbd1f26800c0dca3ae8",
"date": "2019-09-03 18:28:53 -0400",
"subject": "Fix sudo missed in \"Build pgBackRest as an unprivileged user\".",
"body": "286a106a updated the documentation to build pgBackRest as an unprivileged user, but the wget command was missed. This command is not actually run, just displayed, because the release is not yet available when the documentation is built.\n\nUpdate the wget command to run as the local user."
},
{
"commit": "005684bf1f55206f122e1d0fcb4164cc84875ff5",
"date": "2019-09-03 17:53:50 -0400",
"subject": "Begin v2.18 development."
},
{
"commit": "ce2bf2999892f689001b084af4d5feb63dc9b402",
"date": "2019-09-03 16:39:32 -0400",
"subject": "v2.17: C Migrations and Bug Fixes"
},
{
"commit": "0b5720c642c040e16373f72a9058df094d05ca10",
"date": "2019-09-03 14:34:49 -0400",
"subject": "Fix yum.p.o package being installed when custom package specified.",
"body": "The {[os-type-is-centos]} expression was missing parens which meant \"and\" expressions built on it would always evaluate true if the os-type was centos6."
},
{
"commit": "7d8068f27b6b695f9616fd985517692236dda47d",
"date": "2019-09-03 12:30:45 -0400",
"subject": "Don't decode manifest data when it is generated on a remote.",
"body": "Decoding a manifest from the JSON provided by C to the hash required by Perl is an expensive process. If manifest() was called on a remote it was being decoded into a hash and then immediately re-encoded into JSON for transmission over the protocol layer.\n\nInstead, provide a function for the remote to get the raw JSON which can be transmitted as is and decoded in the calling process instead.\n\nThis makes remote manifest calls as fast as they were before 2.16, but local calls must still pay the decoding penalty and are therefore slower. This will continue to be true until the Perl storage interface is retired at the end of the C migration.\n\nNote that for reasonable numbers of tables there is no detectable difference. The case in question involved 250K tables with a 10 minute decode time (which was being doubled) on a fast workstation."
},
{
"commit": "1e55b876206c73d0ce32424814d100ef82d8da05",
"date": "2019-09-03 07:49:04 -0400",
"subject": "Add more commonly-used buffer constants."
},
{
"commit": "7ade3fc1c31f09425547d1869e82863582b1b137",
"date": "2019-09-02 21:09:43 -0400",
"subject": "Move constants from the infoManifest module to the infoBackup module.",
"body": "These constants should be kept separate because the implementation of any info file might change in the future and only the interface should be expected to remain consistent.\n\nIn any case, infoBackup requires Variant constants while infoManifest uses String constants so they are not shareable. Modern compilers should combine the underlying const char * constants."
},
{
"commit": "3a28b68b8bde996252ad8941107744c74a062453",
"date": "2019-09-02 19:06:12 -0400",
"subject": "Disable S3 and encryption on u18 integration tests for mock/all/1.",
"body": "This test is commonly used for sanity checking but the combination of S3 and encryption makes it hard to use and encourages temporary changes to make it usable.\n\nAcknowledge this and disable S3 and encryption for this test and move them to mock/all/2."
},
{
"commit": "05abab5e72e2e4d5d394b79533621dcf06d1f324",
"date": "2019-08-30 14:36:02 -0400",
"subject": "Add OBJECT_DEFINE_MOVE() macro.",
"body": "The object *Move() functions are very repetitive so replace them with a macro that works similarly to OBJECT_DEFINE_FREE()."
},
{
"commit": "d1675b7e914a3e25a3d6cff2c73f36f69ec9f729",
"date": "2019-08-28 10:46:54 -0400",
"subject": "Add ioReadLineParam() to allow return on eof.",
"body": "ioReadLine() errors on eof because it has previously been used only for protocol reads.\n\nReturning on eof is handy for reading lines from files where eof is not considered an error."
},
{
"commit": "a605117a2329965d65f985b4b8e991a5267416c2",
"date": "2019-08-28 10:36:21 -0400",
"subject": "Add required header.",
"body": "Apparently this header is already included everywhere convert.h is included."
},
{
"commit": "8074ca6a2613f6b9310654b5e0f5c468ae7821e8",
"date": "2019-08-26 12:30:22 -0400",
"subject": "Fix typos in variable names."
},
{
"commit": "4a88791a0af78ba6f5496ec4e4351e9726662546",
"date": "2019-08-26 12:29:43 -0400",
"subject": "Fix typos in the release notes."
},
{
"commit": "545ccfa8786b631476c232a1d78791687e638432",
"date": "2019-08-26 12:26:00 -0400",
"subject": "Fix typos in the documentation."
},
{
"commit": "08bac74d38b126515e2620cdf129cd4cbd53f6e8",
"date": "2019-08-26 12:20:51 -0400",
"subject": "Fix typo in stack trace message."
},
{
"commit": "c2771e5469ecd94899243e86668a4bcc0d2c65f5",
"date": "2019-08-26 12:05:36 -0400",
"subject": "Fix comment typos.",
"body": "This includes some variable names in tests which don't seem important enough for their own commits."
},
{
"commit": "22aa532be1be83c5b1df8db5fa85047e1255a789",
"date": "2019-08-26 11:37:21 -0400",
"subject": "Add storage tests for files beginning with dots.",
"body": "Prevent a regression of the issue fixed in f88012ce by adding some tests."
},
{
"commit": "8c9df8c290f760b6a1f8a6a0acb6b4d9b8fa4056",
"date": "2019-08-26 11:35:35 -0400",
"subject": "Fix typo in httpClientReponseHeader() function name."
},
{
"commit": "d1cc22f886a865d5b7e0c3e699e4fbe89c11aade",
"date": "2019-08-26 11:25:14 -0400",
"subject": "Fix typo in CFGDEFDATA_OPTION_OPTIONAL_COMMAND_OVERRIDE macro name."
},
{
"commit": "01c2669b9764491ec3ca96ffd0de6676bef9e5dc",
"date": "2019-08-23 07:47:54 -0400",
"subject": "Fix exclusions for special files.",
"body": "Prior to 2.16 the Perl manifest code would skip any file that began with a dot. This was not intentional but it allowed PostgreSQL socket files to be located in the data directory. The new C code in 2.16 did not have this unintentional exclusion so socket files in the data directory caused errors.\n\nWorse, the file type error was being thrown before the exclusion check so there was really no way around the issue except to move the socket files out of the data directory.\n\nSpecial file types (e.g. socket, pipe) will now be automatically skipped and a warning logged to notify the user of the exclusion. The warning can be suppressed with an explicit --exclude."
},
{
"commit": "2862f480cd1712ee9c188c28d79f2f9ed1bb9c6b",
"date": "2019-08-23 07:24:25 -0400",
"subject": "Add special file type to storageInfo().",
"body": "There's not much we can do with special files, but higher level logic can at least exclude them gracefully rather than throwing a hard error."
},
{
"commit": "04e4fde5733bbe885ef94098f0114a3a160a88e5",
"date": "2019-08-22 10:28:08 -0400",
"subject": "Remove unneeded strFree() in storagePosixInfoListEntry().",
"body": "This strFree() was the primary culprit in the performance issue fixed in 9eaeb33c.\n\nSince the parent mem context is now freed regularly, this strFree() performs better, but still adds time so removing it seems best."
},
{
"commit": "f88012cef3acc29fb5311c73ea1a84c1409d88ee",
"date": "2019-08-22 10:18:34 -0400",
"subject": "Fix regexp to ignore ./.. directories in the Posix driver.",
"body": "In versions <= 2.15 the old regexp caused any file or directory beginning with . to be ignored during a backup. This has caused behavioral differences in 2.16 because the new C code correctly excludes ./.. directories.\n\nThis Perl code is only used for testing now, but it should still match the output of the C functions."
},
{
"commit": "c002a2ce2fb7a1bc4bbeaa5dee2f3e7d719ccc24",
"date": "2019-08-21 19:45:48 -0400",
"subject": "Move info file checksum to the end of the file.",
"body": "Putting the checksum at the beginning of the file made it impossible to stream the file out when saving. The entire file had to be held in memory while it was checksummed so the checksum could be written at the beginning.\n\nInstead place the checksum at the end. This does not break the existing Perl or C code since the read is not order dependent.\n\nThere are no plans to improve the Perl code to take advantage of this change, but it will make the C implementation more efficient."
},
{
"commit": "c733319063bbc9d67ba99b96c178f1d9f863b8fe",
"date": "2019-08-21 16:26:28 -0400",
"subject": "The stanza-create/update/delete commands are implemented entirely in C."
},
{
"commit": "53f27da3a6d770608de6aa6059c40526b83b31dd",
"date": "2019-08-21 15:41:52 -0400",
"subject": "Add checkDbConfig() to compare pgBackRest/PostgreSQL configs.",
"body": "Checking the PostgreSQL-reported path and version against the pgBackRest configuration helps ensure that pgBackRest is operating against the correct cluster.\n\nIn Perl this functionality was in the Db object, but check seems like a better place for it in C."
},
{
"commit": "8b93fdf3493d96fcbbc127604b502d246928ec8e",
"date": "2019-08-21 15:26:52 -0400",
"subject": "Add storagePg*() variants to get storage for a specified host id.",
"body": "Previously the host id to use was pulled from the host-id option or defaulted to 1.\n\nThe stanza, check, and backup commands will all need the ability to address a specified pg host, so add functions to make that possible."
},
{
"commit": "fa640f22add9af88c2ddd584812d8fde93c8f8c5",
"date": "2019-08-21 15:12:00 -0400",
"subject": "Allow Info* objects to be created from scratch in C.",
"body": "Previously, info files (e.g. archive.info, backup.info) were created in Perl and only loaded in C.\n\nThe upcoming stanza commands in C need to create these files so refactor the Info* objects to allow new, empty objects to be created. Also, add functions needed to initialize each Info* object to a valid state."
},
{
"commit": "aa6f7eb862f71bf0b8f64d3c5e3d67903b048214",
"date": "2019-08-21 14:14:30 -0400",
"subject": "Fix comment indents."
},
{
"commit": "71d96531f8b581d460ff24a229b676607fc8992b",
"date": "2019-08-21 12:10:09 -0400",
"subject": "Fix comment typo."
},
{
"commit": "c4533765fb5cd4b72f9fcb27f53db2a30165b9b2",
"date": "2019-08-21 11:59:51 -0400",
"subject": "Add Db object getters missed in e4901d50.",
"body": "dbOpen() loaded the version and data directory but there was no way to get the data externally."
},
{
"commit": "27e823581201374df831abc4cf299ce4da29b910",
"date": "2019-08-21 11:41:36 -0400",
"subject": "Add repoIsLocalVerify() to verify repository locality.",
"body": "Some commands can only be run on a host where the repository is local. This function centralizes the check and error."
},
{
"commit": "6a09d9294d0ef13158fbc96c9d38a28ac7a6f150",
"date": "2019-08-21 11:29:30 -0400",
"subject": "Require storage when calling pgControlFromFile().",
"body": "Previously storageLocal() was being used internally but loading pg_control from remote storage is often required.\n\nAlso, storagePg() is more appropriate than storageLocal() for all current usage."
},
{
"commit": "286a106ae4932ae8213d62528de934afa99c246e",
"date": "2019-08-20 09:46:29 -0400",
"subject": "Build pgBackRest as an unprivileged user.",
"body": "pgBackRest was being built by root in the documentation which is definitely not best practice.\n\nInstead build as the unprivileged default container user. Sudo privileges are still required to install."
},
{
"commit": "6b5366a663f8c408e56bb2f8e5b27821898a91cc",
"date": "2019-08-19 21:57:14 -0400",
"subject": "Remove Perl info command invocation missed in 205525b6."
},
{
"commit": "f6aef6e466ccba368fb53cc00450b501f35782fc",
"date": "2019-08-19 21:45:54 -0400",
"subject": "Properly reset conflicting pg-* options for the remote protocol.",
"body": "The pg1-socket-path and pg1-port options were not being reset when options from a higher index were being pushed down for processing by a remote. Since remotes only talk to one cluster they always use the options in index 1. This requires moving options from the original index to 1 before starting the remote. All options already set on index 1 must be removed if they are not being overwritten."
},
{
"commit": "9eaeb33c882b79a1cade3ce65b5d1b51b6978b05",
"date": "2019-08-19 21:36:01 -0400",
"subject": "Improve slow manifest build for very large quantities of tables/segments.",
"body": "storagePosixInfoList() processed each directory in a single memory context. If the directory contained hundreds of thousands of files processing became very slow due to the number of allocations.\n\nInstead, reset the memory context every thousand files to minimize the number of allocations active at once, improving both speed and memory consumption."
},
{
"commit": "d411321d28d2c94f3376b82984981624fe30e287",
"date": "2019-08-19 21:16:10 -0400",
"subject": "Add reset to temp memory contexts to save memory and processing time.",
"body": "Processing large datasets in a memory context can lead to high memory usage and long allocation times. Add a new MEM_CONTEXT_TEMP_RESET_BEGIN() macro that allows temp allocations to be automatically freed after N iterations."
},
{
"commit": "7d97d49f41e961dcaa0d54b56538d3c5a0b8f6ce",
"date": "2019-08-18 20:46:34 -0400",
"subject": "Add MostCommonValue object.",
"body": "Calculate the most common value in a list of variants. If there is a tie then the first value passed to mcvUpdate() wins.\n\nmcvResult() can be called multiple times because it does not end processing, but there is a cost to calculating the result each time\nsince it is not stored."
},
{
"commit": "8aa1e552b00cb3a9cf5665812e6de782f0805675",
"date": "2019-08-18 20:09:44 -0400",
"subject": "Add backup type conversion functions.",
"body": "Convert back and forth between the string and enum representations of backup types."
},
{
"commit": "3df075bf4022e84f0238591b18bc5e866d6a2aa8",
"date": "2019-08-18 15:29:18 -0400",
"subject": "Fix test writing \"null\" into manifest files.",
"body": "\"null\" is not allowed in the manifest format (null values should be missing instead) but Perl was treating the invalid values written by this test as if they were missing.\n\nUpdate the test code to remove the values rather than setting them to \"null\"."
},
{
"commit": "8edc57b5819a41d43524452de378ec409d05f4d9",
"date": "2019-08-18 15:19:10 -0400",
"subject": "Remove RHEL package patch merged to upstream."
},
{
"commit": "0da3352d59c3d985d6fad7b08d28446900932857",
"date": "2019-08-17 17:52:00 -0400",
"subject": "Add cvtZToMode() replacement missed in 969e5817."
},
{
"commit": "d0dee2e26027f866c282050457d61d6907f3263f",
"date": "2019-08-17 17:47:13 -0400",
"subject": "Add bool rendering to jsonFromVar()."
},
{
"commit": "8fc1d3883b2d96d4f518ff2bfa810b082cc48b38",
"date": "2019-08-17 17:43:56 -0400",
"subject": "Fix expire not immediately writing into separate file after backup.",
"body": "Logging stayed in the backup log until the Perl code started. Fix this so it logs to the correct file and will still work after the Perl code is removed."
},
{
"commit": "41b6795a374391d66dcfb2df0521f1d7acf84b3e",
"date": "2019-08-17 14:15:37 -0400",
"subject": "Create log directories/files with 0750/0640 mode.",
"body": "The log directories/files were being created with a mix of modes depending on whether they were created in C or Perl. In particular, the C code was creating log files with the execute bit set for the user and group which was just odd.\n\nStandardize on 750/640 for both code paths."
},
{
"commit": "bc5385142c75f5fa390531a8ff1bd660dd1380ef",
"date": "2019-08-09 15:18:42 -0400",
"subject": "Change comment for searchability."
},
{
"commit": "382ed9282504b2adced37275937d2414632bb968",
"date": "2019-08-09 15:17:18 -0400",
"subject": "The start/stop commands are implemented entirely in C.",
"body": "The Perl versions remain because they are still being used by the Perl stanza commands. Once the stanza commands are migrated they can be removed."
},
{
"commit": "fe196cb0dffacb5d2d1488e3b592cc8ba3f39a5e",
"date": "2019-08-09 14:52:26 -0400",
"subject": "Update RHEL patch for upstream changes.",
"body": "This isn't correct, but we can't test anything else if the package doesn't build."
},
{
"commit": "0e7134d114af1767addce36a3857ea3fd38abc5f",
"date": "2019-08-08 18:50:54 -0400",
"subject": "Constify some globals."
},
{
"commit": "e9517dcec05c75a03fa73029250de4f5b21fdfd3",
"date": "2019-08-08 18:47:02 -0400",
"subject": "Add hash constants for zero-length data.",
"body": "No need to calculate a hash when the data length is known to be zero. Use one of these constants instead."
},
{
"commit": "56c24b7669f1e636a8221106547469065eb7d161",
"date": "2019-08-08 16:20:51 -0400",
"subject": "Fix typo in parameter logging."
},
{
"commit": "1076b142e38a4960af1157bd117fa2aacee7d8e6",
"date": "2019-08-08 16:15:42 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "969e5817c5d29890cbe12fa95422cd8703abf8d9",
"date": "2019-08-08 11:59:39 -0400",
"subject": "Add cvtZToMode().",
"body": "The companion function to cvtModeToZ()."
},
{
"commit": "1f93e147fa8563028db8b58621db4a1a12387c87",
"date": "2019-08-08 11:41:49 -0400",
"subject": "Add kvGetDefault() to KeyValue object.",
"body": "Return the default only if the key is not found, not when the value is NULL."
},
{
"commit": "289b47902ba1f49a1baea9fdce53eec52d5358bb",
"date": "2019-08-08 10:50:25 -0400",
"subject": "Allow NULLs in strEq().",
"body": "Bring this function more in line with the way varEq() works. NULL == NULL but NULL != NOT NULL."
},
{
"commit": "feec674b6ff88bdfa62b20dd706d724c79ca1bcd",
"date": "2019-08-08 06:48:25 -0400",
"subject": "Add constant for lock file extension."
},
{
"commit": "efc62c90573bd7a0595d81bcf8a261f732fa1fa9",
"date": "2019-08-05 12:32:06 -0400",
"subject": "Begin v2.17 development."
},
{
"commit": "9e730c1bd61b00fa506ea443cdd6161e88ed31ae",
"date": "2019-08-05 12:03:04 -0400",
"subject": "v2.16: C Migrations and Bug Fixes"
},
{
"commit": "3d3003e9ca6dd449ea16c6812d1cabc392c9d294",
"date": "2019-08-01 20:35:01 -0400",
"subject": "The check command is implemented partly in C.",
"body": "Implement switch WAL and archive check in C but leave the rest in Perl for now.\n\nThe main idea was to have some real integration tests for the new database code so the rest of the migration can wait."
},
{
"commit": "e4901d50d5e99168f7962b93f7a327e45f7b7fed",
"date": "2019-08-01 15:38:27 -0400",
"subject": "Add Db object to encapsulate PostgreSQL queries and commands.",
"body": "Migrate functionality from the Perl Db module to C. For now this is just enough to implement the WAL switch check.\n\nAdd the dbGet() helper function to get Db objects easily.\n\nCreate macros in harnessPq to make writing pq scripts easier by grouping commonly used functions together."
},
{
"commit": "f9e1f3a79823ee1bd6656e4f7a8fb23e735b8ccf",
"date": "2019-08-01 14:28:30 -0400",
"subject": "Retry S3 RequestTimeTooSkewed errors instead of immediately terminating.",
"body": "The cause of this error seems to be that a failed request takes so long that a subsequent retry at the http level uses outdated headers.\n\nWe're not sure if pgBackRest it to blame here (in one case a kernel downgrade fixed it, in another case an incorrect network driver was the problem) so add retries to hopefully deal with the issue if it is not too persistent. If SSL_write() has long delays before reporting an error then this will obviously affect backup performance."
},
{
"commit": "2eb3c9f95f6e57072b65da81cb07a1268ebbf38e",
"date": "2019-08-01 09:58:24 -0400",
"subject": "Improve error handling for SSL_write().",
"body": "Error codes were not being caught for SSL_write() so it was hard to see exactly what was happening in error cases. Report errors to aid in debugging.\n\nAlso add a retry for SSL_ERROR_WANT_READ. Even though we have not been able to reproduce this case it is required by SSL_write() so go ahead and implement it."
},
{
"commit": "89c67287bcb8bc7884b5dd37703b0d7786c68b95",
"date": "2019-07-31 20:44:49 -0400",
"subject": "Improve multi-host handling in protocol helper.",
"body": "Multiple PostgreSQL hosts were supported via the host-id option but there are cases where it is useful to be able to directly specify the host id required, e.g. to iterate through pg* hosts when looking for candidate primaries and standbys during backup."
},
{
"commit": "893ae24284e506c551fbc28bec8719881a856e2a",
"date": "2019-07-31 19:58:57 -0400",
"subject": "Add timeout to walSegmentFind().",
"body": "Keep trying to locate the WAL segment until timeout. This is useful for the check and backup commands which must wait for segments to arrive in the archive."
},
{
"commit": "03b28da1cac8f39c7f57d2c15a83ad667a51b997",
"date": "2019-07-31 11:35:58 -0400",
"subject": "Rename control/control module to control/common.",
"body": "This is more consistent with how other common modules are named."
},
{
"commit": "a04baa1bdc07f85041bfaf910f122b7ae278d6aa",
"date": "2019-07-30 11:42:56 -0400",
"subject": "Fix incorrect comment (obviously pasted from S3 code)."
},
{
"commit": "3d892cfb75c3303b0b592d4481d415d25c3f0df9",
"date": "2019-07-30 11:39:01 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "88c1929ec5a41915753e3d3078bdaae62d14bf0f",
"date": "2019-07-26 08:37:58 -0400",
"subject": "Don't pass local config* options to the remote.",
"body": "The remotes have their own config options (repo-host-config, etc.) so don't pass the local config* options.\n\nThis was a regression from the behavior of the Perl code and while there have been no field reports it caused breakage on test systems with multiple configurations."
},
{
"commit": "f8b0676fd6edbe915bc23d2f082b4862004ca151",
"date": "2019-07-25 20:15:06 -0400",
"subject": "Allow modules to be included for testing without requiring coverage.",
"body": "Sometimes it is useful to get at the internals of a module that is not being tested for coverage in order to provide coverage for another module that is being tested. The include directive allows this.\n\nUpdate modules that had previously been added to coverage that only need to be included."
},
{
"commit": "554d98746a96d5a93e3449d62c81c9b7a7c84e9d",
"date": "2019-07-25 17:36:51 -0400",
"subject": "Add repo-s3-port option for setting a non-standard S3 service port.",
"body": "If this option is set then ports appended to repo-s3-endpoint or repo-s3-host will be ignored.\n\nSetting this option explicitly may be the only way to use a bare ipv6 address with S3 (since multiple colons confuse the parser) but we plan to improve this in the future."
},
{
"commit": "d8ca0e5c5bc2af6b85b20f48b40b83762d415b7a",
"date": "2019-07-25 17:05:39 -0400",
"subject": "Add Perl interface to C PgQuery object.",
"body": "This validates that all current queries work with the new interface and removes the dependency on DBD::Pg."
},
{
"commit": "415542b4a3589ff7b25dbd97d1041a9b1ff87815",
"date": "2019-07-25 14:50:02 -0400",
"subject": "Add PostgreSQL query client.",
"body": "This direct interface to libpq allows simple queries to be run against PostgreSQL and supports timeouts.\n\nTesting is performed using a shim that can use scripted responses to test all aspects of the client code. The shim will be very useful for testing backup scenarios on complex topologies."
},
{
"commit": "59f135340d4f76c522c8b24ecb23d56b57b2b0f8",
"date": "2019-07-25 14:34:16 -0400",
"subject": "The local command for backup is implemented entirely in C.",
"body": "The local process is now entirely migrated to C. Since all major I/O operations are performed in the local process, the vast majority of I/O is now performed in C."
},
{
"commit": "54ec8f151e4164c3f363f417bece7c4b1533dfd6",
"date": "2019-07-24 19:45:35 -0400",
"subject": "Add int rendering to jsonFromVar()."
},
{
"commit": "615735e7eed32c429a13559584a7268e4dbff3fc",
"date": "2019-07-24 06:52:49 -0400",
"subject": "Add new types to JSON render.",
"body": "Add bool, array, and int64 as valid array subtypes.\n\nPretty print for the array subtype is not correct but is currently not in use (this can be seen at line 328 in typeJsonTest.c)."
},
{
"commit": "62f0c7fb37e160d4a8a2dbe410fe8a569bc4ba38",
"date": "2019-07-22 13:09:51 -0400",
"subject": "Add lock bot configuration.",
"body": "Lock closed issues after ninety days to prevent posting on old issues."
},
{
"commit": "38ba458616f450232dc1090306e651561c9b3076",
"date": "2019-07-18 08:42:42 -0400",
"subject": "Add IoSink filter.",
"body": "Discard all data passed to the filter. Useful for calculating size/checksum on a remote system when no data needs to be returned.\n\nUpdate ioReadDrain() to automatically use the IoSink filter."
},
{
"commit": "d1dd6add4853a77d2ebbf27c326bbb4670b78955",
"date": "2019-07-17 16:55:21 -0400",
"subject": "Remove never-used infoBackupCheckPg() function.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "3bdba4933d45451a3fa6f5dafcb79fd976bffef6",
"date": "2019-07-17 16:49:42 -0400",
"subject": "Fix incorrect handling of transfer-encoding response to HEAD request.",
"body": "The HTTP server can use either content-length or transfer-encoding to indicate that there is content in the response. HEAD requests do not include content but return all the same headers as GET. In the HEAD case we were ignoring content-length but not transfer-encoding which led to unexpected eof errors on AWS S3. Our test server, minio, uses content-length so this was not caught in integration testing.\n\nIgnore all content for HEAD requests (no matter how it is reported) and add a unit test for transfer-encoding to prevent a regression."
},
{
"commit": "6f981c53bb63d3a644a8573cb9edb162c443d03b",
"date": "2019-07-17 15:44:55 -0400",
"subject": "Remove obsolete ignoreMissing parameter.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "7662d32e6020148d822fd5080f2a5ebda7ebe103",
"date": "2019-07-17 15:42:37 -0400",
"subject": "Fix comment typos and clarify HEAD response behavior."
},
{
"commit": "eee67db4d611bb18950daf7bddb84217b010d767",
"date": "2019-07-17 14:09:50 -0400",
"subject": "Allow pg storage to be remote.",
"body": "None of the currently migrated commands needed remote pg storage but now backup, check, stanza-* will need it."
},
{
"commit": "30f55a3c2a139ffd59547fd8e422c3fae3feecd3",
"date": "2019-07-15 17:36:24 -0400",
"subject": "Add compressed storage feature.",
"body": "This feature denotes storage that can compress files so that they take up less space than what was written. Currently this includes the Posix and CIFS drivers. The stored size of the file will be rechecked after write to determine if the reported size is different. This check would be wasted on object stores such as S3, and they might not report the file as existing immediately after write.\n\nAlso add tests to each storage driver to check features."
},
{
"commit": "3e1062825dde7cab506225a3b0658552b44de7ce",
"date": "2019-07-15 16:49:46 -0400",
"subject": "Allow multiple filters to be pushed to the remote and return results.",
"body": "Previously only a single filter could be pushed to the remote since order was not being maintained. Now the filters are strictly ordered.\n\nResults are returned from the remote and set in the local IoFilterGroup so they can be retrieved.\n\nExpand remote filter support to include all filters."
},
{
"commit": "d5654375a5152764f76335eb5265eb994d1df6bd",
"date": "2019-07-15 08:44:41 -0400",
"subject": "Add ioReadDrain().",
"body": "Read all data from an IoRead object and discard it. This is handy for calculating size, hash, etc. when the output is not needed.\n\nUpdate code where a loop was used before."
},
{
"commit": "cdb75ac8b38810e2e7c6f5d0161443650f94bb31",
"date": "2019-07-15 07:13:36 -0400",
"subject": "Add constants for path and archive.info/backup.info combinations.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "ede7df9fb1d937f228e982d987d306345007dfe0",
"date": "2019-07-14 15:53:31 -0400",
"subject": "Allow NULL in JSON list."
},
{
"commit": "c836c483dc7198a685991753300bae49d3caa73c",
"date": "2019-07-14 15:42:55 -0400",
"subject": "Add lstClear() to List object."
},
{
"commit": "e10577d0b0c8054a08513b069e2f2647ddd51fb7",
"date": "2019-07-11 09:13:56 -0400",
"subject": "Fix incorrect offline upper bound for ignoring page checksum errors.",
"body": "For offline backups the upper bound was being set to 0x0000FFFF0000FFFF rather than UINT64_MAX. This meant that page checksum errors might be ignored for databases with a lot of past WAL in offline mode.\n\nOnline mode is not affected since the upper bound is retrieved from pg_start_backup()."
},
{
"commit": "2fd0ebb78aabe882d4b080d4014d7ecabbded3da",
"date": "2019-07-10 15:08:35 -0400",
"subject": "Fix links broken by non-standard version.",
"body": "Using version 2.15.1 fixed the duplicate tarball problem but broke the auto-generated links. Fix them manually since this should not be a common problem."
},
{
"commit": "6a89c1526e1ecc2940ed2bf42258ceb9ef85f0e0",
"date": "2019-07-10 12:04:25 -0400",
"subject": "Revert a2dcdc07.",
"body": "It is simpler to implement the required logic in stanza-delete rather than add complexity to this function."
},
{
"commit": "04646599a776348914b3e9bb9b707d2845540aac",
"date": "2019-07-10 06:17:33 -0400",
"subject": "Remove extraneous test macro."
},
{
"commit": "4e7db608dc6488feb99e5f2707f06e3ca39d78e8",
"date": "2019-07-10 06:11:21 -0400",
"subject": "Clarify that return statements are not removed in production builds."
},
{
"commit": "a22a6dc08c25a2af9ac9a6f2331144f2bae8dcbe",
"date": "2019-07-10 06:06:07 -0400",
"subject": "Update contributor name."
},
{
"commit": "a2dcdc0711a8dfb7d562b2ee0a8586de9676669f",
"date": "2019-07-09 16:41:58 -0400",
"subject": "Update lockStopTest() to optionally return a result rather than error.",
"body": "Some commands (e.g. stanza-delete) would prefer to throw a customized error."
},
{
"commit": "27b3246e852e98902f21589f5cdfece9ebb27b39",
"date": "2019-07-08 08:29:25 -0400",
"subject": "Exclude more build files from rsync between tests.",
"body": "Files (especially build.auto.h) were being removed and forcing a full build between separate invocations of test.pl.\n\nThis affected ad-hoc testing at the command-line, not a full test run in CI."
},
{
"commit": "5e1ed2e8a52c2c4d2151ef17496f0847cd9ae939",
"date": "2019-07-05 18:34:15 -0400",
"subject": "Remove clang static analysis.",
"body": "This analysis never produced anything but false positives (var might be NULL) but took over a minute per test run and added 600MB to the test container."
},
{
"commit": "488fb672948c07abfd7e38604eacbd0f82610b1a",
"date": "2019-07-05 17:25:01 -0400",
"subject": "Force PostgreSQL versions to string for newer versions of JSON:PP.",
"body": "Since 2.91 JSON::PP has a bias for saving variables that look like numbers as numbers even if they were declared as strings.\n\nForce versions to strings where needed by appending ''.\n\nUpdate the json-pp-perl package on Ubuntu 18.04 to 2.97 to provide test coverage."
},
{
"commit": "9836578520e3fb5c038230ebfb123001a7eb32fa",
"date": "2019-07-05 16:55:17 -0400",
"subject": "Remove perl critic and coverage.",
"body": "No new Perl code is being developed, so these tools are just taking up time and making migrations to newer platforms harder. There are only a few Perl tests remaining with full coverage so the coverage tool does not warn of loss of coverage in most cases.\n\nRemove both tools and associated libraries."
},
{
"commit": "fc2101352206a87f8471fd37455d9cd990fce95d",
"date": "2019-07-05 16:25:28 -0400",
"subject": "Fix scoping violations exposed by optimizations in gcc 9.",
"body": "gcc < 9 makes all compound literals function scope, even though the C spec requires them to be invalid outside the current scope. Since the compiler and valgrind were not enforcing this we had a few violations which caused problems in gcc >= 9.\n\nEven though we are not quite ready to support gcc 9 officially, fix the scoping violations that currently exist in the codebase."
},
{
"commit": "1708f1d1514b3f2afb69664317df705a1fccfaf7",
"date": "2019-07-02 22:20:35 -0400",
"subject": "Use minio for integration testing.",
"body": "ScalityS3 has not received any maintenance in years and is slow to start which is bad for testing. Replace it with minio which starts quickly and ships as a single executable or a tiny container.\n\nMinio has stricter limits on allowable characters but should still provide enough coverage to show that our encoding is working correctly.\n\nThis commit also includes the upgrade to openssl 1.1.1 in the Ubuntu 18.04 container."
},
{
"commit": "b9b21315ead6610bb41ee19794763555a7265261",
"date": "2019-07-02 22:09:12 -0400",
"subject": "Updates for openssl 1.1.1.",
"body": "Some HTTP error tests were failing after the upgrade to openssl 1.1.1, though the rest of the unit and integration tests worked fine. This seemed to be related to the very small messages used in the error testing, but it pointed to an issue with the code not being fully compliant, made worse by auto-retry being enabled by default.\n\nDisable auto-retry and implement better error handling to bring the code in line with openssl recommendations.\n\nThere's no evidence this is a problem in the field, but having all the tests pass seems like a good idea and the new code is certainly more robust.\n\nCoverage will be complete in the next commit when openssl 1.1.1 is introduced."
},
{
"commit": "c55009d0f9ebfea746ab270be167dc2d78976ce9",
"date": "2019-06-27 14:39:11 -0400",
"subject": "Community yum package can be installed with --var=package=yum.",
"body": "Like apt, the community yum package can now be installed instead of a user-specified package."
},
{
"commit": "b0728c33dbd7c99a7b785c152f20d5cdfa902bff",
"date": "2019-06-27 14:30:20 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "020101b30bfe9f2d34b878fcd51fad932781d9f8",
"date": "2019-06-27 09:38:40 -0400",
"subject": "Update release notes to explicitly select release commit when tagging."
},
{
"commit": "33e3d316d63a41cd64d217abe30786cfb48bf09e",
"date": "2019-06-26 19:52:04 -0400",
"subject": "Reverse loop in infoPgSave() to be consistent with infoPgNewLoad().",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "4bffa0c5bb7d551c60b8d8bcff9a3bbe6e02eddd",
"date": "2019-06-26 15:02:30 -0400",
"subject": "Add test function to create the S3 bucket instead of using aws cli.",
"body": "Eventually the idea is to remove the dependency on aws cli since Python is a big install."
},
{
"commit": "4815752ccc46ff742f67b369bc75ad3efcf11204",
"date": "2019-06-26 08:24:58 -0400",
"subject": "Add Perl interface to C storage layer.",
"body": "Maintaining the storage layer/drivers in two languages is burdensome. Since the integration tests require the Perl storage layer/drivers we'll need them even after the core code is migrated to C. Create an interface layer so the Perl code can be removed and new storage drivers/features introduced without adding Perl equivalents.\n\nThe goal is to move the integration tests to C so this interface will eventually be removed. That being the case, the interface was designed for maximum compatibility to ease the transition. The result looks a bit hacky but we'll improve it as needed until it can be retired."
},
{
"commit": "bd6c0941e9e3aa2dab84f7404da1f9dc60cd693b",
"date": "2019-06-25 17:27:19 -0400",
"subject": "Fix missing dash in site name.",
"body": "Without this the project name and tagline just run together."
},
{
"commit": "466602387bc279aa44a811dc2948b893e4127b2c",
"date": "2019-06-25 08:42:20 -0400",
"subject": "Begin v2.16 development."
},
{
"commit": "6650d8144cba46f93ad75c11ad98d87c57d2ea7f",
"date": "2019-06-25 08:29:06 -0400",
"subject": "v2.15: C Implementation of Expire"
},
{
"commit": "51fcaee43edf022aea0f94b76d254f2de8b6e1d1",
"date": "2019-06-25 07:58:38 -0400",
"subject": "Add host-repo-path variable internal replacement.",
"body": "This variable needs to be replaced right before being used without being added to the cache since the host repo path will vary from system to system.\n\nThis is frankly a bit of a hack to get the documentation to build in the Debian packages for the upcoming release. We'll need to come up with something more flexible going forward."
},
{
"commit": "5cbe2dee855577ccd14051cad35f30376db21d50",
"date": "2019-06-25 07:36:16 -0400",
"subject": "Add compress-level-network option to ls command.",
"body": "039e515a added a dependency on compress-level-network but the ls command did not get updated."
},
{
"commit": "d7f12f268a370e388c6a6375666831ecd8fad72c",
"date": "2019-06-24 19:27:13 -0400",
"subject": "Redact secure options in the help command.",
"body": "Secure options could show up in the help as \"current\". While the user must have permissions to see the source of the options (e.g. environment, config file) it's still not a good idea to display them in an unexpected context.\n\nInstead show secure options as in the help command."
},
{
"commit": "c22e10e4a938b444ac7912efc3b751829401360f",
"date": "2019-06-24 15:42:33 -0400",
"subject": "Honor configure --prefix option.",
"body": "The --prefix option was entirely ignored and DESTDIR was a combination of DESTDIR and bindir.\n\nBring both in line with recommendations for autoconf and make as specified in https://www.gnu.org/software/make/manual/html_node/Directory-Variables.html and https://www.gnu.org/prep/standards/html_node/DESTDIR.html."
},
{
"commit": "b498188f01f8d2ccd4d0ce2cce3af2e5069d9ac3",
"date": "2019-06-24 11:59:44 -0400",
"subject": "Error on db history mismatch when expiring.",
"body": "Amend commit 434cd832 to error when the db history in archive.info and backup.info do not match.\n\nThe Perl code would attempt to reconcile the history by matching on system id and version but we are not planning to migrate that code to C. It's possible that there are users with mismatches but if so they should have been getting errors from info for the last six months. It's easy enough to manually fix these files if there are any mismatches in the field."
},
{
"commit": "039e515a319216035187c89efccf97143d4cac03",
"date": "2019-06-24 10:20:47 -0400",
"subject": "Allow protocol compression when read/writing remote files.",
"body": "If the file is compressible (i.e. not encrypted or already compressed) it can be marked as such in storageNewRead()/storageNewWrite(). If the file is being read from/written to a remote it will be compressed in transit using gzip.\n\nSimplify filter group handling by having the IoRead/IoWrite objects create the filter group automatically. This removes the need for a lot of NULL checking and has a negligible effect on performance since a filter group needs to be created eventually unless the source file is missing.\n\nAllow filters to be created using a VariantList so filter parameters can be passed to the remote."
},
{
"commit": "62715ebf2d8b0585c35cd2ee14d6aabf9cc0f1f8",
"date": "2019-06-19 17:49:38 -0400",
"subject": "Fix archive retention expiring too aggressively.",
"body": "The problem expressed when repo1-archive-retention-type was set to diff. In this case repo1-archive-retention ended up being effectively equal to one, which meant PITR recovery was only possible from the last backup. WAL required for consistency was still preserved for all backups.\n\nThis issue is not present in the C migration committed at 434cd832, which was written before this bug was reported. Even so, we wanted to note this issue in the release notes in case any other users have been affected.\n\nFixed by Cynthia Shang.\nReported by Mohamad El-Rifai."
},
{
"commit": "a7d64bab7abe56132ad1c83eb6bfcca1166e0000",
"date": "2019-06-18 19:02:09 -0400",
"subject": "Add FAQ on where to find old Debian/Ubuntu packages."
},
{
"commit": "e2d791394a3577aac53a21e3141e4e337ac8edf0",
"date": "2019-06-18 18:42:47 -0400",
"subject": "Add FAQ to the documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "434cd832855e4e189403962753fd8771e29880a4",
"date": "2019-06-18 15:19:20 -0400",
"subject": "The expire command is implemented entirely in C.",
"body": "This implementation duplicates the functionality of the Perl code but does so with different logic and includes full unit tests.\n\nAlong the way at least one bug was fixed, see issue #748."
},
{
"commit": "f88bee7b3321a2c79f0317913ba1e83a56d19c7d",
"date": "2019-06-18 10:13:28 -0400",
"subject": "TLS/HTTP statistics log replacements.",
"body": "These statistics can change with any code update so they cause a lot of churn in the expect logs."
},
{
"commit": "0efdf2576f02b1768fb8805b27571e403ac3cb52",
"date": "2019-06-18 07:35:34 -0400",
"subject": "Remove hard-coded PostgreSQL user so $PGUSER works.",
"body": "The PostgreSQL user was hard-coded to the OS user which libpq will automatically use if $PGUSER is not set, so this code was redundant and prevented $PGUSER from working when set."
},
{
"commit": "593446718a8997bfd674cf5e54230290cb5bcdea",
"date": "2019-06-18 06:45:47 -0400",
"subject": "Add S3 info type missed in 7f2f5354.",
"body": "File is the only type possible in S3."
},
{
"commit": "0a96a2895d7a1e4c5eec402d3742f1d1e25cc126",
"date": "2019-06-17 09:16:44 -0400",
"subject": "Add storage layer for tests and documentation.",
"body": "The tests and documentation have been using the core storage layer but soon that will depend entirely on the C library, creating a bootstrap problem (i.e. the storage layer will be needed to build the C library).\n\nCreate a simplified Posix storage layer to be used by documentation and the parts of the test code that build and execute the actual tests. The actual tests will still use the core storage driver so they can interact with any type of storage."
},
{
"commit": "ceafd8e19d416106f50c4ff440bf1cf7fcb5553f",
"date": "2019-06-17 07:52:03 -0400",
"subject": "Migrate page checksum filter to C.",
"body": "This filter exactly mimics the behavior of the Perl filter so is a drop-in replacement.\n\nThe filter is not integrated yet since it requires the Perl-to-C storage layer interface coming in a future commit."
},
{
"commit": "892f35a7283462fae0bc3077aeb23c9624a50dea",
"date": "2019-06-17 07:42:12 -0400",
"subject": "Add new types to JSON render.",
"body": "Still not a complete list, but we are getting there."
},
{
"commit": "c64c9c05905d435cd650195ed9470355a4d2be2f",
"date": "2019-06-17 06:59:06 -0400",
"subject": "Add backup management functions to InfoBackup.",
"body": "Allow current backups to be listed and deleted.\n\nAlso expose some constants required by expire and stanza-* commands."
},
{
"commit": "44bafc127d9d4e38478aa44d0adc0f34695c6640",
"date": "2019-06-17 06:47:15 -0400",
"subject": "Rename info*New() functions to info*NewLoad().",
"body": "These names more accurately reflect what the functions do and follow the convention started in Info and InfoPg.\n\nAlso remove the ignoreMissing parameter since it was never used."
},
{
"commit": "f05fbc54a8f00a56937439fb88eafe8e239781e8",
"date": "2019-06-14 08:04:28 -0400",
"subject": "Fix filters not processing when there is no input.",
"body": "Some filters (e.g. encryption and compression) produce output even if there is no input. Since the filter group was marked as \"done\" initially, processing would not run when there was zero input and that resulted in zero output.\n\nAll filters start not done so start the filter group the same way."
},
{
"commit": "9ba95e993ba3dbf73f8967a875608980e6380633",
"date": "2019-06-13 17:58:33 -0400",
"subject": "Use retries to wait for test S3 server to start.",
"body": "The prior method of tailing the docker log no longer seems reliable. Instead, keep retrying the make bucket command until it works and show the error if it times out."
},
{
"commit": "b9233f7412e44c8daf41db05bd9699fa088ece5d",
"date": "2019-06-13 12:44:40 -0400",
"subject": "Create filter group in read/write object's memory context.",
"body": "The filter group was being created in the parent context so it would go away if the parent context was freed."
},
{
"commit": "20be5c9bf39d606b8586ffcf575a7443c6375479",
"date": "2019-06-13 12:35:13 -0400",
"subject": "Remove extra spaces."
},
{
"commit": "fdd375b63d3962845efbb38a7020d852143b97fd",
"date": "2019-06-11 16:26:32 -0400",
"subject": "Integrate S3 storage driver with HTTP client cache.",
"body": "This allows copying from one S3 object to another. We generally try to avoid doing this but there are a few cases where it is needed and the tests do it quite a bit.\n\nOne thing to look out for here is that reads require the http client to be explicitly released by calling httpClientDone(). This means than clients could grow if they are not released properly. The http statistics will hopefully alert us if this is happening."
},
{
"commit": "ced42d6511e9b5735a2281dd0e1faec41870fd37",
"date": "2019-06-11 10:48:22 -0400",
"subject": "Add HTTP client cache.",
"body": "This cache manages multiple http clients and returns one to the caller that is not busy. It is the responsibility of the caller to indicate when they are done with a client. If returnContent is set then the client will automatically be marked done.\n\nAlso add special handing for HEAD requests to recognize that content-length is informational only and no content is expected."
},
{
"commit": "6e809e578fbd24269205de25cc6e9c84cefc5647",
"date": "2019-06-11 10:34:42 -0400",
"subject": "Add tag to specify minio version to use for documentation build.",
"body": "The new minio major release broke the build. We'll need to figure that out but for now use the last major version, which is known to work."
},
{
"commit": "7f2f535460e3499c1811b5beca9130f84b78c982",
"date": "2019-06-10 16:09:38 -0400",
"subject": "Add info() and infoList() to S3 driver.",
"body": "These should be the last functions required to complete the implementation of the S3 driver."
},
{
"commit": "9d1b03781f9fe88b868cdfaf4808d84ad1f072fb",
"date": "2019-06-10 15:52:51 -0400",
"subject": "Revert removal of aws cli in 3e1b06ac.",
"body": "This is required for integration tests to create buckets."
},
{
"commit": "456391f67c220647e130fdc7a7fc805b075cfd87",
"date": "2019-06-10 12:23:04 -0400",
"subject": "Create general-purpose S3 list function.",
"body": "There are already two functions which need file lists and more on the way, so create a general-purpose function to reduce code duplication."
},
{
"commit": "fb8bd095ca93e2bf77eaec0f7573f961f691c3ab",
"date": "2019-06-10 10:37:20 -0400",
"subject": "Add missing const qualifiers."
},
{
"commit": "78b333790c69aca991f740a9ea6b1982fb70c3d6",
"date": "2019-06-07 10:35:44 -0400",
"subject": "Return IoRead/IoWrite from io*FilterGroupSet()",
"body": "This makes is possible to chain functions more effectively."
},
{
"commit": "e701e8fd846539ec20f2a9be90b0590ceb6a7be6",
"date": "2019-06-05 11:50:49 -0400",
"subject": "Expose storage type.",
"body": "Code calling the storage should be driver agnostic but knowing the storage type can be useful for debugging and error reporting."
},
{
"commit": "6ff3325c7744a8f6f0e1e965fa673040a2f40a71",
"date": "2019-06-05 11:43:17 -0400",
"subject": "Enforce requiring repo-cipher-pass at config parse time.",
"body": "This was not enforced at parse time because repo1-cipher-type could be passed on the command-line even in cases where encryption was not needed by the subprocess.\n\nFilter repo-cipher-type so it is never passed on the command line. If the subprocess does not have access to the passphrase then knowing the encryption type is useless anyway."
},
{
"commit": "d7bd0c58cdd9a434aa5893db16e6bcf8425e26b9",
"date": "2019-06-05 07:27:24 -0400",
"subject": "Use wal_level=replica in the documentation for PostgreSQL >= 9.6.",
"body": "The documentation was using wal_level=hot_standby which is a deprecated setting.\n\nAlso remove the reference to wal_level=archive since it is no longer supported and is not recommended for older versions."
},
{
"commit": "aca11b2fa19337f934fc095e33f014d5e6df71f3",
"date": "2019-06-04 17:40:27 -0400",
"subject": "Add String to types supported by JSON list render.",
"body": "All types should be supported eventually but for now this answers the need."
},
{
"commit": "0ab6f3bb87005d5a5d102156730b1e3099894189",
"date": "2019-06-04 13:38:05 -0400",
"subject": "Fix incorrect error type on missing path."
},
{
"commit": "4b91259de8d7feec6d33d154032169aa32c879e3",
"date": "2019-06-04 12:56:04 -0400",
"subject": "Make working with filter groups less restrictive.",
"body": "Filter groups could not be manipulated once they had been assigned to an IO object. Now they can be freely manipulated up to the time the IO object is opened.\n\nAlso, move the filter group into the IO object's context so they don't need to be tracked separately."
},
{
"commit": "92e04ea9f4e0eb3f6cd88a72497a026cbd348280",
"date": "2019-06-04 10:34:19 -0400",
"subject": "Remove per-stanza repo cache clear during testing.",
"body": "This was not being used and is not supported by the equivalent C code."
},
{
"commit": "44eb21ea935fdaa4e96d4637c7b62cb5a73d3e77",
"date": "2019-06-04 10:05:27 -0400",
"subject": "Use HEAD to check if a file exists on S3.",
"body": "The previous implementation searched for the file in a list which worked but was not optimal. For arbitrary bucket structures it would also produce a false negative if a match was not found in the first 1000 entries. This was not an issue for our repo structure since the max hits on exists calls is two but it seems worth fixing to avoid future complications."
},
{
"commit": "15b8e3b6af7327179d8bdd2e0c6833ed28005b0b",
"date": "2019-06-04 09:39:08 -0400",
"subject": "Make C S3 requests use the same host logic as Perl.",
"body": "The C code was passing the host (if specified) with the request which could force the server into path-style URLs, which are not supported.\n\nInstead, use the Perl logic of always passing bucket.endpoint in the request no matter what host is used for the HTTPS connection.\n\nIt's an open question whether we should support path-style URLs but since we don't it's useless to tell the server otherwise. Note that Amazon S3 has deprecated path-style URLs and they are no longer supported on newly created buckets."
},
{
"commit": "5f92c36b30072edb71b12f79163c37c67d9806bc",
"date": "2019-06-04 08:04:33 -0400",
"subject": "Fix erroneous parameter name.",
"body": "The exists() function only checks for files so the parameter name should reflect that."
},
{
"commit": "0945d9666b5af1a5893ba0b4537e9cd1f72be478",
"date": "2019-06-01 11:09:01 -0400",
"subject": "Bring back PATH_PAX for platforms that don't define it.",
"body": "This define was replaced in 8c712d89 with limits.h but that caused an issue with the hurd-i386 build for Debian which apparently does not define this value."
},
{
"commit": "a207af79215d05539825c484dbfa9aa2a26cf7d0",
"date": "2019-06-01 09:44:40 -0400",
"subject": "Fix mismatched log/test macros."
},
{
"commit": "12bca3c43eb2ee0df80ef5e10850657b52fb680b",
"date": "2019-06-01 09:28:31 -0400",
"subject": "Add CPPFLAGS to compile rules.",
"body": "This should silence the last of the Debian package warnings."
},
{
"commit": "388ba0458c37ab4e8b82df0c0fa2b6a4d7462ecb",
"date": "2019-05-31 18:37:31 -0400",
"subject": "Fix build.flags being removed on each build.",
"body": "This was being removed by rsync which forced a full build even when a partial should have been fine. Rewrite the file after the rsync so it is preserved."
},
{
"commit": "6cba50c3f23a7a7822ae0fd03ff3b5a3f6d8a32a",
"date": "2019-05-31 18:32:40 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "3a5fd7b28a79c1564ddd2b5bad36d4d4be358453",
"date": "2019-05-30 11:19:59 -0400",
"subject": "Fix typo in macro name."
},
{
"commit": "a2ec1253e97805e2a3b990d8bc23c98ab8013d09",
"date": "2019-05-30 10:44:35 -0400",
"subject": "Add code classification exclusion missed in 3e1b06ac."
},
{
"commit": "64260b2e9878944116dc78812a3a21633c5f3d15",
"date": "2019-05-29 08:38:45 -0400",
"subject": "Build all docs with S3 using --var=s3-all=y",
"body": "Force repo-type=s3 for all tests. This is not currently the default for any OS builds."
},
{
"commit": "404284b90ff0f67fe29fa5a7b2831ebf51d459aa",
"date": "2019-05-28 12:18:05 -0400",
"subject": "Add internal flag for commands.",
"body": "Allow commands to be skipped by default in the command help but still work if help is requested for the command directly. There may be other uses for the flag in the future.\n\nUpdate help for ls now that it is exposed."
},
{
"commit": "20e5b92f366848ec1464e2272c6af2c29ac7b36d",
"date": "2019-05-28 10:03:48 -0400",
"subject": "Add ls command.",
"body": "Allows listing repo paths/files from the command-line, to be used primarily for testing and debugging.\n\nThis command is internal-only so the interface may change at any time without notice."
},
{
"commit": "3b3327eae6dd14f67f1002f094bd33ab7785f765",
"date": "2019-05-28 09:50:59 -0400",
"subject": "Move tls/http statistics output to command/command.",
"body": "This module already has the filtering required to keep these messages from being displayed by default for commands that output to stdout (e.g. info)."
},
{
"commit": "3e1b06acaa84399abcfaa8c684f437b63aa38de5",
"date": "2019-05-27 07:37:20 -0400",
"subject": "Use minio as local S3 emulator in documentation.",
"body": "The documentation was relying on a ScalityS3 container built for testing which wasn't very transparent. Instead, use the stock minio container and configure it in the documentation.\n\nAlso, install certificates and CA so that TLS verification can be enabled."
},
{
"commit": "a474ba54c5c9c7bdba6ffa3e92671bb9565889f6",
"date": "2019-05-26 12:41:15 -0400",
"subject": "Refactoring path support in the storage module.",
"body": "Not all storage types support paths as a physical thing that must be created/destroyed. Add a feature to determine which drivers use paths and simplify the driver API as much as possible given that knowledge and by implementing as much path logic as possible in the Storage object.\n\nRemove the ignoreMissing parameter from pathSync() since it is not used and makes little sense.\n\nCreate a standard list of error messages for the drivers to use and apply them where the code was modified -- there is plenty of work still to be done here."
},
{
"commit": "38f28bd52081405321939fec66046bd9ada35c23",
"date": "2019-05-26 12:32:49 -0400",
"subject": "Log TLS and HTTP statistics on exit.",
"body": "These stats measure how efficiently TLS and HTTP are reusing connections."
},
{
"commit": "819eda0818669ea9cc45bcd65c57e3b4c7d29129",
"date": "2019-05-26 12:29:29 -0400",
"subject": "Set log level of protocol processing functions to debug.",
"body": "Setting these to trace effectively made debug level useless in local/remote processes since all debug messages were demoted to trace when called from these functions."
},
{
"commit": "d12d94c53c466eb808459b98669a877c19b5716b",
"date": "2019-05-24 18:09:16 -0400",
"subject": "Make info(), pathCreate() and pathSync() optional for storage drivers.",
"body": "These functions are not required for repository storage so make them optional and error if they are not implemented for non-repository storage, .e.g. pg or spool.\n\nThe goal is to simplify the drivers (e.g. S3) that are intended only for repository storage."
},
{
"commit": "39645fc1a99540063399a7a3b86177a330bd743c",
"date": "2019-05-24 14:33:47 -0400",
"subject": "Add pathRemove() and remove() to S3 storage.",
"body": "These functions will be needed for the expire command."
},
{
"commit": "6c385dfa7a7f489159c06c5a31fd3cd7c77c39a8",
"date": "2019-05-24 13:56:38 -0400",
"subject": "Add function to determine if HTTP response code is OK.",
"body": "OK responses are a range rather than a single value, so simplify the check with a function."
},
{
"commit": "96770c529be4df408b9d1fc39fc5157e90555375",
"date": "2019-05-24 13:12:56 -0400",
"subject": "storageList() returns an empty list by default for missing paths.",
"body": "The prior behavior was to return NULL so the caller would know the path was missing, but this is rarely useful, complicates the calling code, and increases the chance of segfaults.\n\nThe .nullOnMissing param has been added to enable the prior behavior."
},
{
"commit": "707e4a29f04a733cff868f37b90f8bf83a02394c",
"date": "2019-05-24 11:09:43 -0400",
"subject": "Notify compiler that cryptoErrorCode() does not return."
},
{
"commit": "01f3024b5c0a83819d58ee6ccc2edb5109277aaa",
"date": "2019-05-24 11:06:11 -0400",
"subject": "Add missing const qualifier."
},
{
"commit": "39cb6248314e21530924886e6e669ac395daeeb1",
"date": "2019-05-24 07:45:03 -0400",
"subject": "Add missing menus to the new user guides.",
"body": "Since the CentOS 6/7 user guides were generated as a single page they did not get menus. Generate the entire site for each user guide so menus are included."
},
{
"commit": "04f8b4ea52f89d1542b25d2fb0ba28a43ddaba6d",
"date": "2019-05-24 07:41:55 -0400",
"subject": "Use git url for website clone."
},
{
"commit": "ec9622cde883c649c1346cbc0b9057e7f3fcb787",
"date": "2019-05-22 18:54:49 -0400",
"subject": "Use the git log to ease release note management.",
"body": "The release notes are generally a direct reflection of the git log. So, ease the burden of maintaining the release notes by using the git log to determine what needs to be added.\n\nCurrently only non-dev items are required to be matched to a git commit but the goal is to account for all commits.\n\nThe git history cache is generated from the git log but can be modified to correct typos and match the release notes as they evolve. The commit hash is used to identify commits that have already been added to the cache.\n\nThere's plenty more to do here. For instance, links to the commits for each release item should be added to the release notes."
},
{
"commit": "86482c7db943375d48fcee0e243ca96bdf50d35c",
"date": "2019-05-22 18:23:44 -0400",
"subject": "Reduce log level for all expect tests to detail.",
"body": "The C code is designed to be efficient rather than deterministic at the debug log level. As we move more testing from integration to unit tests it makes less sense to try and maintain the expect logs at this log level.\n\nMost of the expect logs have already been moved to detail level but mock/all still had tests at debug level. Change the logging defaults in the config file and remove as many references to log-level-console as possible."
},
{
"commit": "e4cc008b982d47ac526962e310c18626e2aefbc2",
"date": "2019-05-22 11:31:38 -0400",
"subject": "Remove duplicated hint.",
"body": "At some point this hint got added to the underlying code so it is no longer needed here."
},
{
"commit": "ff9c1bed5de380a6e7df1cbc6870b972d93b3dc4",
"date": "2019-05-22 11:24:18 -0400",
"subject": "Save cipher-pass key/value missed in f492f057.",
"body": "This value is required when encryption is enabled.\n\nIn passing simplify the expression used to skip the checksum when calculating the checksum."
},
{
"commit": "3da60f4b5ee8ed663fc5e8d8968709dbaadee1f6",
"date": "2019-05-22 11:10:43 -0400",
"subject": "Don't escape / when rendering JSON.",
"body": "/ is escaped in the spec but the Perl renderer we use does not escape it which leads to checksum mismatches between the two sets of code.\n\nThis particular escape seems to be a more recent addition to the spec and is targeted toward embedding JSON in JavaScript.\n\n\\/ is still allowed when parsing JSON."
},
{
"commit": "664054fea94186374dcae84e31e0cd7329c279d0",
"date": "2019-05-22 06:55:31 -0400",
"subject": "Remove RHEL package patch merged to upstream."
},
{
"commit": "e1cce9c6147446c026f528cc4afe518de0bcb87f",
"date": "2019-05-21 14:07:35 -0400",
"subject": "Remove extraneous parens."
},
{
"commit": "936b8a289c4884dd22f7ff0d3d624d6e70980512",
"date": "2019-05-21 10:37:30 -0400",
"subject": "Allow separate paragraphs in release items.",
"body": "The first paragraph should match the first line of the commit message as closely as possible. The following paragraphs add more information.\n\nRelease items have been updated back to 2.01."
},
{
"commit": "e3fe3434b4428398ffbee5359f0e0cdec8e55bcb",
"date": "2019-05-21 10:14:41 -0400",
"subject": "Rename repo-s3-verify-ssl option to repo-s3-verify-tls.",
"body": "The new name is preferred because pgBackRest does not support any SSL protocol versions (they are all considered to be insecure).\n\nThe old name will continue to be accepted."
},
{
"commit": "1bc84c647490d6cf78975b5dde5b1937016d24c6",
"date": "2019-05-20 17:07:37 -0400",
"subject": "The local command for restore is implemented entirely in C.",
"body": "This is just the part of restore run by the local helper processes, not the entire command.\n\nEven so, various optimizations in the code (like connection reuse and optimizations for zero-length files) should make the restore command faster on object stores."
},
{
"commit": "a839830333490555800377ea095d756765f476e4",
"date": "2019-05-20 16:19:14 -0400",
"subject": "Add most unimplemented functions to the remote storage driver.",
"body": "Add pathCreate(), pathRemove(), pathSync(), and remove() to the driver."
},
{
"commit": "bbf2e0d5b0876d3663cc69d10925c6e0d08cd729",
"date": "2019-05-20 12:24:43 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "a9f589b87a09bd37ad903b5c37bcd3000d47840d",
"date": "2019-05-20 12:23:40 -0400",
"subject": "Begin v2.15 development."
},
{
"commit": "0f685a33a02adde45792711b957a75391fc5f34e",
"date": "2019-05-20 11:51:58 -0400",
"subject": "v2.14: Bug Fix and Improvements"
},
{
"commit": "51d67ce1ba932476b2349dbe611f77ab4f15213d",
"date": "2019-05-16 09:59:34 -0400",
"subject": "Update contributor name."
},
{
"commit": "2b75f57232e3d2c983e0a703b6807dadd0b4c0e6",
"date": "2019-05-16 09:56:48 -0400",
"subject": "Add linefeeds for clarity."
},
{
"commit": "19d8358cba0064392cd519e7bce66bb3dcce3dc9",
"date": "2019-05-16 09:53:55 -0400",
"subject": "Update mock/expire module test matrix so expect tests output.",
"body": "Also add an error message to prevent regression."
},
{
"commit": "c51274d1b6a85aeb8ecf1dfffcdc68a503ac3de9",
"date": "2019-05-16 08:32:02 -0400",
"subject": "Add user guides for CentOS/RHEL 6/7.",
"body": "It would be better if the documentation could be generated on multiple operating systems all in one go, but the doc system currently does not allow vars to be changed once they are set.\n\nThe solution is to run the docs for each required OS and stitch the documentation together. It's not pretty but it works and the automation in release.pl should at least make it easy to use."
},
{
"commit": "bc7b42e71811e1b3231c1386496efbdf8338e086",
"date": "2019-05-16 07:35:45 -0400",
"subject": "Restore index menu url default lost in b85e51d6.",
"body": "The url for the menu item referring to the index (i.e. site root page) should use {[project-url-root]}.\n\nThis allows the url to be set to different values depending on the location of the index."
},
{
"commit": "a4561dc0879fd1fb383ecbeafa6936729a515190",
"date": "2019-05-16 07:29:17 -0400",
"subject": "Add --out-preserve to preserve contents of output path.",
"body": "Useful for building a single set of documentation over multiple doc.pl runs."
},
{
"commit": "bc30027d730e4ce7090919406eb0d7f5c7f7e51e",
"date": "2019-05-16 07:04:28 -0400",
"subject": "Fix typo in doc.pl command-line help."
},
{
"commit": "18d4cb574180d279dbbdabd8b87b9dab43115659",
"date": "2019-05-15 13:14:58 -0400",
"subject": "Bypass database checks when stanza-delete issued with force.",
"body": "Previously it was not possible to delete a stanza if the PostgreSQL server could not be contacted."
},
{
"commit": "5c1d4bcd0d41590e722f2d184cf64a62b740625c",
"date": "2019-05-15 13:04:56 -0400",
"subject": "Automate coverage summary report generation.",
"body": "This report replaces the lcov report that was generated manually for each release.\n\nThe lcov report was overly verbose just to say that we have virtually 100% coverage."
},
{
"commit": "5bba72b87445f3edd2c7a2e636ffcb46cac5d9dd",
"date": "2019-05-15 12:55:08 -0400",
"subject": "Remove -Wswitch-enum compiler option.",
"body": "The -Wswitch option included in -Wall provides the same level of coverage and allows enum options to be grouped into default."
},
{
"commit": "53f6232264f27a029d3f6261c75a16585ade1951",
"date": "2019-05-14 10:35:39 -0400",
"subject": "Improve coverage in config/parse module."
},
{
"commit": "1e5ab69cada2862cbc458ae322bdc166c244f0f8",
"date": "2019-05-13 19:10:24 -0400",
"subject": "Improve coverage in config/config module."
},
{
"commit": "57281d479296627e30cccd00c089f3fb40a076ca",
"date": "2019-05-13 18:05:54 -0400",
"subject": "Add MAX_ASSIGN() macro.",
"body": "This improves coverage in cases where the compared values may be always ascending or descending."
},
{
"commit": "15a33bf74be84bda822e96c91e37479419b451a9",
"date": "2019-05-13 17:10:41 -0400",
"subject": "Error on multiple option alternate names and simplify help command.",
"body": "There are currently no options with multiple alternate (deprecated) names so the code to render them in the help command could not be covered.\n\nRemove the uncovered code and add an error when multiple alternate names are configured. It's not clear that the current code was handling this correctly, so it will need to be reviewed if it comes up again."
},
{
"commit": "2d2bec842a2c424d5a36c98dc3a465da1696caf4",
"date": "2019-05-13 13:36:24 -0400",
"subject": "Improve coverage in perl/exec module."
},
{
"commit": "431532574b1e2e59979bd6cf3c333979d0817ad2",
"date": "2019-05-13 07:51:11 -0400",
"subject": "Add testUser() and testGroup().",
"body": "Retrieve the name of the current user/group used for testing."
},
{
"commit": "31d0fe5f50a1a061c3ffbf7d194fafffee6a34b7",
"date": "2019-05-11 18:20:57 -0400",
"subject": "Improve log performance, simplify macros, rename logWill() to logAny().",
"body": "Pre-calculate the value used by logAny() to improve performance and make it more likely to be inlined.\n\nMove IF_LOG_ANY() into LOG_INTERNAL() to simplify the macros and improve performance of LOG() and LOG_PID(). If the message has no chance of being logged there's no reason to call logInternal().\n\nRename logWill() to logAny() because it seems more intuitive."
},
{
"commit": "87f36e814ea95696870711018c050725e8e7269f",
"date": "2019-05-11 14:51:51 -0400",
"subject": "Improve macros and coverage rules that were hiding missing coverage.",
"body": "The branch coverage exclusion rules were overly broad and included functions that ended in a capital letter, which disabled all coverage for the statement. Improve matching so that all characters in the name must be upper-case for a match.\n\nSome macros with internal branches accepted parameters that might contain conditionals. This made it impossible to tell which branches belonged to which, and in any case an overzealous exclusion rule was ignoring all branches in such cases. Add the DEBUG_COVERAGE flag to build a modified version of the macros without any internal branches to be used for coverage testing. In most cases, the branches were optimizations (like checking logWill()) that improve production performance but are not needed for testing. In other cases, a parameter needed to be added to the underlying function to handle the branch during coverage testing.\n\nAlso tweak the coverage rules so that macros without conditionals are automatically excluded from branch coverage as long as they are not themselves a parameter.\n\nFinally, update tests and code where missing coverage was exposed by these changes. Some code was updated to remove existing coverage exclusions when it was a simple change."
},
{
"commit": "f819a32cdf94bc799a4902ab6aaa559cd11d4ef8",
"date": "2019-05-11 07:57:49 -0400",
"subject": "Improve efficiency of FUNCTION_LOG*() macros.",
"body": "Call stackTraceTestStop()/stackTraceTestStart() once per block instead of with every param call. This was done to be cautious but is not necessary and slows down development.\n\nThese functions were never built into production so had no impact there."
},
{
"commit": "7e2f6a6a4365b48fc89672b5d7de4c1d8937caa6",
"date": "2019-05-09 12:28:39 -0400",
"subject": "Clarify that sort order must be ascending."
},
{
"commit": "f0f105ddeca7b3434d9c3bb78e25247b3c6b7584",
"date": "2019-05-09 12:10:46 -0400",
"subject": "Improve filter's notion of \"done\" to optimize filter processing.",
"body": "Filters had different ideas about what \"done\" meant and this added complication to the group filter processing. For example, gzip decompression would detect end of stream and mark the filter as done before it had been flushed.\n\nImprove the IoFilter interface to give a consistent definition of done across all filters, i.e. no filter can be done until it has started flushing no matter what the underlying driver reports. This removes quite a bit of tricky logic in the processing loop which tried to determine when a filter was \"really\" done.\n\nAlso improve management of the input buffers by pointing directly to the prior output buffer (or the caller's input) to eliminate loops that set/cleared these buffers."
},
{
"commit": "d5fac35fe3efe79f2b39a0e1b5ad3bb1cb1dd173",
"date": "2019-05-09 09:53:24 -0400",
"subject": "Improve zero-length content handling in HttpClient object.",
"body": "If content was zero-length then the IO object was not created. This put the burden on the caller to test that the IO object existed before checking eof.\n\nInstead, create an IO object even if it will immediately return eof. This has little cost and makes the calling code simpler.\n\nAlso add an explicit test for zero-length files in S3 and a few assertions."
},
{
"commit": "15531151d7b3c07f51c442cb8951a5781bcc39d4",
"date": "2019-05-09 08:55:48 -0400",
"subject": "Add --c option to request a C remote.",
"body": "The rules for when a C remote is required are getting complicated and will get worse when restoreFile() is migrated.\n\nInstead, set the --c option when a C remote is required. This option will be removed when the remote is entirely implemented in C."
},
{
"commit": "c99c7c458b0a04d1f1a637be70bb4f8e8011feb0",
"date": "2019-05-09 08:28:58 -0400",
"subject": "Add pathExists() to Storage object.",
"body": "The S3 driver did not get an implementation since S3 has a weak notion of paths, and it is not currently required."
},
{
"commit": "cb00030ee38148a99df9d5ddcaef64252b0b50c9",
"date": "2019-05-08 18:58:07 -0400",
"subject": "Remove dead code missed in 1b486847.",
"body": "This commit removed all Perl references to spool storage but some stuff was left behind."
},
{
"commit": "f1eea2312104ce7fa87119d6ef50a554b154e954",
"date": "2019-05-03 18:52:54 -0400",
"subject": "Add macros for object free functions.",
"body": "Most of the *Free() functions are pretty generic so add macros to make creating them as easy as possible.\n\nCreate a distinction between *Free() functions that the caller uses to free memory and callbacks that free third-party resources. There are a number of cases where a driver needs to free resources but does not need a normal *Free() because it is handled by the interface.\n\nAdd common/object.h for macros that make object maintenance easier. This pattern can also be used for many more object functions."
},
{
"commit": "7ae96949f18af90a9b07f1dd712f939ca7a1ec41",
"date": "2019-05-03 18:09:58 -0400",
"subject": "Various MemContext callback improvements.",
"body": "Rename memContextCallback() to memContextCallbackSet() to be more consistent with other parts of the code.\n\nFree all context memory when an exception is thrown from a callback. Previously only the child contexts would be freed and this resulted in some allocations being lost. In practice this is probably not a big deal since the process will likely terminate shortly, but there may well be cases where that is not true."
},
{
"commit": "4a20d44c6b118143f1c1607bacac0d4e268f6ffe",
"date": "2019-05-03 17:49:57 -0400",
"subject": "Add common/macro.h for general-purpose macros.",
"body": "Add GLUE() macro which is useful for creating identifiers.\n\nMove MACRO_TO_STR() here and rename it STRINGIFY(). This appears to be the standard name for this type of macro and it is also an awesome name."
},
{
"commit": "32ca27a20b13941cfab27672d6f383a0ba44fa20",
"date": "2019-05-03 15:46:15 -0400",
"subject": "Simplify storage object names.",
"body": "Remove \"File\" and \"Driver\" from object names so they are shorter and easier to keep consistent.\n\nAlso remove the \"driver\" directory so storage implementations are visible directly under \"storage\"."
},
{
"commit": "8c712d89ebe10e3d318952a0b4db8cd09f8a580c",
"date": "2019-05-02 17:52:24 -0400",
"subject": "Improve type safety of interfaces and drivers.",
"body": "The function pointer casting used when creating drivers made changing interfaces difficult and led to slightly divergent driver implementations. Unit testing caught production-level errors but there were a lot of small issues and the process was harder than it should have been.\n\nUse void pointers instead so that no casts are required. Introduce the THIS_VOID and THIS() macros to make dealing with void pointers a little safer.\n\nSince we don't want to expose void pointers in header files, driver functions have been removed from the headers and the various driver objects return their interface type. This cuts down on accessor methods and the vast majority of those functions were not being used. Move functions that are still required to .intern.h.\n\nRemove the special \"C\" crypto functions that were used in libc and instead use the standard interface."
},
{
"commit": "28359eea83206f6eeddd3fbc91a52cd42399e529",
"date": "2019-05-02 16:33:23 -0400",
"subject": "Update code count rules missed in 027c2638."
},
{
"commit": "0c816f94814767dd96040aa2cb299dfa169d59e5",
"date": "2019-05-02 15:19:26 -0400",
"subject": "Update comments for storageExists() and driver functions."
},
{
"commit": "498017bcf02560e101703e89b1119d0b48944835",
"date": "2019-05-02 12:43:09 -0400",
"subject": "Various Buffer improvements.",
"body": "Add bufDup() and bufNewUsedC().\n\nArrange bufNewC() params to match bufNewUsedC() since they have always seemed backward.\n\nFix bufHex() to only render the used portion of the buffer and fix some places where used was not being set correctly.\n\nUse a union to make macro assignments for all legal values without casting. This is much more likely to catch bad assignments."
},
{
"commit": "59234f249e73a4038ee1ba5d2e80f8acc11640ce",
"date": "2019-04-29 18:36:57 -0400",
"subject": "Use THROW_ON_SYS_ERROR*() to improve code coverage.",
"body": "There is only one instance in the core code where this helps. It is mostly helpful in the tests.\n\nThere is an argument to be made that only THROW_SYS_ERROR*() variants should be used in the core code to improve test coverage. If so, that will be the subject of a future commit."
},
{
"commit": "683b096e187605c5cf16a727cd2c413540e4d150",
"date": "2019-04-29 18:03:32 -0400",
"subject": "Don't append strerror() to error message when errno is 0.",
"body": "Some functions (e.g. getpwnam()/getgrnam()) will return an error but not set errno. In this case there's no use in appending strerror(), which will be \"Success\". This is confusing since an error has just been reported.\n\nAt least in the examples above, an error with no errno set just means \"missing\" and our current error message already conveys that."
},
{
"commit": "6ad44db9a0a30ad933a6ca8012de52558b7b9c02",
"date": "2019-04-29 17:30:06 -0400",
"subject": "Merge duplicated contributor."
},
{
"commit": "518bba1ed950633746f33474cbfa90f76324e345",
"date": "2019-04-29 17:22:01 -0400",
"subject": "Add missing assert."
},
{
"commit": "af33126cb68915db9644ca941fc2490d09107b0c",
"date": "2019-04-29 17:17:14 -0400",
"subject": "Allow StorageFileWrite to set user, group, and modification time.",
"body": "The S3 driver will throw an error if these options are set since they are not supported."
},
{
"commit": "d0c296bd5b67966fd35fd9f70c25788dd6de0c34",
"date": "2019-04-29 16:10:27 -0400",
"subject": "Fix segfault when process-max > 8 for archive-push/archive-get.",
"body": "The remote list was at most 9 (based on pg[1-8]-* max index) so anything over 8 wrote into unallocated memory.\n\nThe remote for the main process is (currently) stored in position zero so do the same for remotes started from locals, since there should only be one. The main process will need to start more remotes in the future which is why there is extra space."
},
{
"commit": "c935b1c9e83d6f14644de3aa5f36011234e69423",
"date": "2019-04-29 15:20:54 -0400",
"subject": "Add missing httpUriEncode() in S3 request.",
"body": "This was not a live bug since the files currently handled by C can't have special characters in them."
},
{
"commit": "62b48d8a5a9bb7aa962e96566073dd58cfdb4436",
"date": "2019-04-29 15:14:10 -0400",
"subject": "Allow storageInfo() to follow links.",
"body": "This allows info to be retrieved from linked files/paths in a single step."
},
{
"commit": "60edadf71dbbe6c82c5a83bcebee36a16b42ed88",
"date": "2019-04-29 14:54:49 -0400",
"subject": "Expose handle (file descriptor) from IoWrite when applicable.",
"body": "This is a followup to dee90d3e which exposed file handles for IoRead.\n\nAlso expose handle for StorageDriverPosixFileRead missed in dee90d3e."
},
{
"commit": "e2141cc05faa4032f7da55afacc57bf17ce11838",
"date": "2019-04-29 14:23:37 -0400",
"subject": "Add missing space."
},
{
"commit": "027c2638719dffa9ba99250085c403e89a2a8a9a",
"date": "2019-04-26 08:08:23 -0400",
"subject": "Add configure script for improved multi-platform support.",
"body": "Use autoconf to provide a basic configure script. WITH_BACKTRACE is yet to be migrated to configure and the unit tests still use a custom Makefile.\n\nEach C file must include \"build.auto.conf\" before all other includes and defines. This is enforced by test.pl for includes, but it won't detect incorrect define ordering.\n\nUpdate packages to call configure and use standard flags to pass options."
},
{
"commit": "3505559a808855600016dc73c5aec3843e51bfaf",
"date": "2019-04-24 13:23:32 -0400",
"subject": "Update test containers with PostgreSQL minor releases and liblz4.",
"body": "Update RHEL repos that have changed upstream. Remove PostgreSQL 9.3 since the RHEL6/7 packages have disappeared.\n\nRemove PostgreSQL versions from U12 that are still getting minor updates so the container does not need to be rebuilt.\n\nLZ4 is included for future development, but this seems like a good time to add it to the containers."
},
{
"commit": "1ae8a6a71665c12bec6e20741df29ba4792bf8f8",
"date": "2019-04-23 20:52:03 -0400",
"subject": "Add build-max option to set max build processes.",
"body": "Currently this controls make processes via -j."
},
{
"commit": "c11c936366fd93a6cdb143d7d93a1d8f249ee9c2",
"date": "2019-04-23 20:19:31 -0400",
"subject": "Reduce ScalityS3 processes since only two are needed."
},
{
"commit": "52b0b81976df5583ebe12189d8697dd66d23e84b",
"date": "2019-04-23 19:33:55 -0400",
"subject": "Add storageInfoList() to get detailed info about all entries in a path.",
"body": "The function provides all the file/path/link information required to build a backup manifest.\n\nAlso update storageInfo() to provide the same information for a single file."
},
{
"commit": "f492f0571b145d499f4ff9017219794a5a3c7a1b",
"date": "2019-04-23 17:08:34 -0400",
"subject": "Add *Save() functions to most Info objects.",
"body": "At the same time change the way that load constructors work (and are named) so that Ini objects do not persist after the constructors complete.\n\ninfoArchiveSave() is excluded from this commit since it is just a trivial call to infoPgSave() and won't be required soon."
},
{
"commit": "f41112a4634421071d80686ae19042c652576cb3",
"date": "2019-04-23 14:02:30 -0400",
"subject": "Add harnessInfoChecksum/Z() to ease creation of test info files."
},
{
"commit": "aebac47cd5fa21f6e62ee3dce3ef13abf59ca61f",
"date": "2019-04-23 13:58:19 -0400",
"subject": "Extern infoHash() so it can be used by other modules.",
"body": "This is currently needed only for testing, but there's no reason not to expose the function to everyone."
},
{
"commit": "cddb0c05b444aaed388e53e0cd0b02148307ca87",
"date": "2019-04-23 13:03:22 -0400",
"subject": "Add iniSave() and iniMove() to Ini object.",
"body": "iniSave() sorts alphabetically to maintain compatibility with the expect tests, but we plan to change this behavior when the migration is complete."
},
{
"commit": "c650134a0414c154eb21609b363aeceafbfdda60",
"date": "2019-04-22 18:46:29 -0400",
"subject": "Add ioWriteStr() and ioWriteStrLine().",
"body": "These function names make it clearer what is being written.\n\nThe old ioWriteLine() has been repurposed to write buffers."
},
{
"commit": "81f652137c8f3179aad24d3283a4141b0075ae66",
"date": "2019-04-22 18:41:01 -0400",
"subject": "Add separate functions to encode/decode each JSON type.",
"body": "In most cases the JSON type is known so this is more efficient than converting to Variant first, both in terms of memory and time.\n\nAlso rename some of the existing functions for consistency."
},
{
"commit": "f100ea0ff44e173299e8f691115b9e7ce68d422b",
"date": "2019-04-22 17:52:23 -0400",
"subject": "Add constant for maximum buffer sizes required by cvt*() functions.",
"body": "Also update Variant to use cvt*() in all cases. Variant was written before these functions were available and not all cases were updated."
},
{
"commit": "f5739051eba3dae6cbee6d1fc0f72c36705c3be1",
"date": "2019-04-22 17:17:56 -0400",
"subject": "Add true and false String constants."
},
{
"commit": "47491e3c47e84be17263ce3b897ab3fcd8879a3f",
"date": "2019-04-22 16:04:04 -0400",
"subject": "varNewKv() accepts a KeyValue object rather than creating one.",
"body": "This allows for more flexibility about when the Variant is created."
},
{
"commit": "fdf19e5ab68c64f6c063c265bd3ddc5b39b56620",
"date": "2019-04-22 09:00:50 -0400",
"subject": "Refactor Ini interface to expose String values instead of Variant.",
"body": "Variants were being used to expose String and StringList types but this can be done more simply with an additional method.\n\nUsing only strings also allows for a more efficient implementation down the road."
},
{
"commit": "cc39bddc15b7cb5bba5dd8443325ee199e8aa12b",
"date": "2019-04-22 08:47:32 -0400",
"subject": "Refactor main() as a switch() statement.",
"body": "This makes it clearer what has been migrated and where the new C implementations should go."
},
{
"commit": "38286272596d7b53b88c3f4f081d6c7dfc9360d8",
"date": "2019-04-21 14:59:32 -0400",
"subject": "Fix missing const."
},
{
"commit": "e7255be108b6b85bb736934b19abdef32cbd39e8",
"date": "2019-04-20 11:25:04 -0400",
"subject": "Only process next filter in IoFilterGroup when input buffer is full or flushing.",
"body": "This greatly reduces calls to filter processing, which is a performance benefit, but also makes the trace logs smaller and easier to read.\n\nHowever, this means that ioWriteFlush() will no longer work with filters since a full flush of IoFilterGroup would require an expensive reset. Currently ioWriteFlush() is not used in this scenario so for now just add an assert to ensure it stays that way."
},
{
"commit": "e513c52c0973772465a81a5db2ba18d0f956d686",
"date": "2019-04-20 08:16:17 -0400",
"subject": "Add macros to create constant Buffer objects.",
"body": "These are more efficient than creating buffers in place when needed.\n\nAfter replacement discovered that bufNewStr() and BufNewZ() were not being used in the core code so removed them. This required using the macros in tests which is not the usual pattern."
},
{
"commit": "c9168028c6c43d535a5663cb17ce93945951cb7e",
"date": "2019-04-19 14:38:11 -0400",
"subject": "Improve performance of non-blocking reads by using maximum buffer size.",
"body": "Since the introduction of blocking read drivers (e.g. IoHandleRead, TlsClient) the non-blocking drivers have used the same rules for determining maximum buffer size, i.e. read only as much as requested. This is necessary so the blocking drivers don't get stuck waiting for data that might not be coming.\n\nInstead mark blocking drivers so IoRead knows how much buffer to allow for the read. The non-blocking drivers can now request the maximum number of bytes allowed by buffer-size."
},
{
"commit": "0c866f52c69ee2bd6af20e67af78bad94c4048af",
"date": "2019-04-19 11:40:39 -0400",
"subject": "Update code to use new unsigned int Variant type and config methods."
},
{
"commit": "9f0829cbf2fcd9be869cac21fbf974fd7ecce019",
"date": "2019-04-19 11:29:08 -0400",
"subject": "Add cfgOptionUInt() and cfgOptionUInt64().",
"body": "These are better than casting from cfgOptionInt() since bounds checking is performed."
},
{
"commit": "1adcbc5c913bddac3a2078b2c5b7329617fa504c",
"date": "2019-04-19 11:22:43 -0400",
"subject": "Add unsigned int Variant type.",
"body": "This is better than using (unsigned int)varUInt64() because bounds checking is performed."
},
{
"commit": "c45ae5f221ba9cc5e65f585920cc1ea23e3dd293",
"date": "2019-04-19 08:41:17 -0400",
"subject": "Begin v2.14 development."
},
{
"commit": "41f3874822faf3f859f46867c0fe965f7156b123",
"date": "2019-04-18 21:26:02 -0400",
"subject": "v2.13: Bug Fixes"
},
{
"commit": "7390952d8e99649077a6d4b577a483e6c38a3ecd",
"date": "2019-04-18 21:24:10 -0400",
"subject": "Harden IO filters against zero input and optimize zero output case.",
"body": "Add production checks to ensure no filter gets a zero-size input buffer.\n\nAlso, optimize the case where a filter returns no output. There's no sense in running downstream filters if they have no new input."
},
{
"commit": "2d73de1d360e0b7bc66b4db9e6b3a0e441927230",
"date": "2019-04-18 21:21:35 -0400",
"subject": "Fix zero-length reads causing problems for IO filters that did not expect them.",
"body": "The IoRead object was passing zero-length buffers into the filter processing code but not all the filters were happy about getting them.\n\nIn particular, the gzip compression filter failed if it was given no input directly after it had flushed all of its buffers. This made the problem rather intermittent even though a zero-length buffer was being passed to the filter at the end of every file. It also explains why tweaking compress-level or buffer-size allowed the file to go through.\n\nSince this error was happening after all processing had completed, there does not appear to be any risk that successfully processed files were corrupted."
},
{
"commit": "670fa88a98c7e12c4e2e948d92476918d3048f7e",
"date": "2019-04-18 13:21:24 -0400",
"subject": "Add CHECK() macro for production assertions.",
"body": "CHECK() works just like ASSERT() but is kept in production builds."
},
{
"commit": "b258aec0adcf6fdaf7a2494c66f1540aa720e345",
"date": "2019-04-18 13:19:05 -0400",
"subject": "Move lockRelease() to the end of exitSafe().",
"body": "Releasing the lock too early was allowing other async processes to sneak in and start running before the current process was completely shut down.\n\nThe only symptom seems to have been mixed up log messages so not a very serious issue."
},
{
"commit": "b960919cf7322f03ee4f9681f0cb06da6b4c52de",
"date": "2019-04-18 10:36:21 -0400",
"subject": "Fix reliability of error reporting from local/remote processes.",
"body": "Asserts were only only reported on stderr rather than being returned through the protocol layer. This did not appear to be very reliable.\n\nInstead, report the assert through the protocol layer like any other error. Add a stack trace if an assert error or debug logging is enabled."
},
{
"commit": "281d2848b92bf7dba36018127cb9238662d7875b",
"date": "2019-04-17 18:39:35 -0400",
"subject": "Option to build documentation from current apt.postgres.org packages.",
"body": "This is useful for testing any issue currently being seen in the field.\n\nWe'll also need to add a \"yum\" option at some point."
},
{
"commit": "0d4ba3a39f10667bb0234a94850548ab2dd7ab2d",
"date": "2019-04-17 18:18:55 -0400",
"subject": "Fix Posix/CIFS error messages reporting the wrong filename on write/sync/close.",
"body": "The reported file name was the destination file, not the temp file that is written to during atomic write operations."
},
{
"commit": "4c13955c05662c2df3fb13cfc1d5538c2a0010a0",
"date": "2019-04-17 08:04:22 -0400",
"subject": "Add macros to create constant Variant types.",
"body": "These work almost exactly like the String constant macros. However, a struct per variant type was required which meant custom constructors and destructors for each type.\n\nPropagate the variant constants out into the codebase wherever they are useful."
},
{
"commit": "2dac4b598620693d1d564c0ecb2c124693357d6f",
"date": "2019-04-16 13:39:58 -0400",
"subject": "Add STR() macro to create constant String objects from runtime strings.",
"body": "The STRING_CONST() macro worked fine for constants but was not able to constify strings created at runtime.\n\nAdd the STR() macro to do this by using strlen() to get the size.\n\nAlso rename STRING_CONST() to STRDEF() for brevity and to match the other macro name."
},
{
"commit": "a029eba8d56dc2167814669bc8c5ba12f2eaab80",
"date": "2019-04-16 13:18:30 -0400",
"subject": "Use a macro instead of a nested struct to create common String variables.",
"body": "This makes the code a bit less obfuscated while still ensuring that these variables will be common to both String structures."
},
{
"commit": "a7281878ac8e058b528e49f80a525c09f62a39ed",
"date": "2019-04-15 08:29:25 -0400",
"subject": "Migrate backupRegExp() to C.",
"body": "Removed the \"anchor\" parameter because it was never used in any calls in the Perl code so it was just a dead parameter that always defaulted to true."
},
{
"commit": "39ed4f763b923905b651938b7fe65c48e099b880",
"date": "2019-04-12 18:13:01 -0400",
"subject": "Various comment and assert fixes in the info modules."
},
{
"commit": "65a26ac4ba111c1e7e4bfd6c0a0bf1d84afd66e8",
"date": "2019-04-12 18:10:39 -0400",
"subject": "Convert commented cipherPass params to test params.",
"body": "This param will show up in stack traces for test builds, but not production."
},
{
"commit": "c5157c03345eaf4b8e9e7e06190d75021e9d8e39",
"date": "2019-04-12 09:03:34 -0400",
"subject": "Automatically generate constants for command and option names.",
"body": "These constants are easier than using cfgOptionName() and cfgCommandName() and lead to cleaner code and simpler to construct messages.\n\nString versions are provided. Eventually all the strings will be used in the config structures, but for now they are useful to avoid wrapping with strNew()."
},
{
"commit": "867690c08d5710d0cab27a9ee5ba879f7216abda",
"date": "2019-04-12 08:33:10 -0400",
"subject": "Begin v2.13 development.",
"body": "Also update CentOS packages so documentation builds."
},
{
"commit": "4e57b689165cffd8c686f0f36d0c5dccb553b3e1",
"date": "2019-04-11 09:14:22 -0400",
"subject": "v2.12: C Implementation of Archive Push"
},
{
"commit": "df12cbb1625ed61c74d43ae3a308445f943b0570",
"date": "2019-04-10 17:48:34 -0400",
"subject": "Fix C code to recognize host:port option format like Perl does.",
"body": "This was not an intentional feature in Perl, but it works, so it makes sense to implement the same syntax in C.\n\nThis is a break from other places where a -port option is explicitly supplied, so it may make sense to support both styles going forward. This commit does not address that, however."
},
{
"commit": "3aa521fed0838021209b4be36849feb2c7e40a2e",
"date": "2019-04-10 13:37:24 -0400",
"subject": "Fix compile flag accidentally removed in 5ee8388f."
},
{
"commit": "25cea0bd0a22de2f83a2ded786e2facc86ff4b10",
"date": "2019-04-09 11:08:27 -0400",
"subject": "Add process id to C archive-get and archive-push logging.",
"body": "This was missed in the original migration. There was no functional issue, but logging the process ids is useful for debugging."
},
{
"commit": "8c202c77dac74d919962f69acb279b583b4272ff",
"date": "2019-04-09 11:01:35 -0400",
"subject": "Add process id to ProtocolParallelJob.",
"body": "This exposes the process that performed to job to the caller for logging purposes."
},
{
"commit": "4ace7edbd9e849d5a7a5d8b20e08c0c3e2098a02",
"date": "2019-04-09 10:54:36 -0400",
"subject": "Allow process id in C logging",
"body": "The default process id in C logging has always been zero. This should have been updated when multi-processing was introduced in C, but it was missed."
},
{
"commit": "6099729e922893312e001a3394db43d0c2b341ad",
"date": "2019-04-08 19:38:06 -0400",
"subject": "Improve error message when an S3 bucket name contains dots.",
"body": "The Perl lib we have been using for TLS allows dots in wildcards, but this is forbidden by RFC-2818. The new TLS implementation in C forbids this pattern, just as PostgreSQL and curl do.\n\nHowever, this does present a problem for users who have been using bucket names with dots in older versions of pgBackRest. Since this limitation exists for security reasons there appears to be no option but to take a hard line and do our best to notify the user of the issue as clearly as possible."
},
{
"commit": "21c83eea59f5fb4d3c366a1e9782d26356801675",
"date": "2019-04-08 17:21:20 -0400",
"subject": "Fix issues when log-level-file=off is set for the archive-get command.",
"body": "This problem was not specific to archive-get, but that was the only place it was expressing in the last release. The new archive-push was also affected.\n\nThe issue was with daemon processes that had closed all their file descriptors. When exec'ing and setting up pipes to communicate with a child process the dup2() function created file descriptors that overlapped with the first descriptor (stdout) that was being duped into. This descriptor was subsequently closed and wackiness ensued.\n\nIf logging was enabled (the default) that increased all the file descriptors by one and everything worked.\n\nFix this by checking if the file descriptor to be closed is the same one being dup'd into. This solution may not be generally applicable but it works fine in this case."
},
{
"commit": "8ac422dca95c8761fc57450ed74061ff286ff0c3",
"date": "2019-04-07 21:09:29 -0400",
"subject": "Close log file before exec().",
"body": "The log file should be closed before exec() so the child process does not retain a reference to it."
},
{
"commit": "ade20e5c657f1a05bbe00c1f693346bfadd8b795",
"date": "2019-04-07 19:11:20 -0400",
"subject": "Fix typo in error message."
},
{
"commit": "9f3425f6dd2892721935103ff3f75555b7408dd5",
"date": "2019-04-07 18:47:04 -0400",
"subject": "Skip coverage for macros with numbers in their name.",
"body": "This was an oversight in the old regular expression."
},
{
"commit": "c72a94cfec64096d0f18fa1385b1347918be4fdb",
"date": "2019-04-07 18:20:03 -0400",
"subject": "Increase process-max limit to 999.",
"body": "Recent hardware has outstripped the old default so increase it to something that should last for a while."
},
{
"commit": "9a7eab9428b8ce34b31b878bd5e6af4f842ce8d7",
"date": "2019-04-07 18:12:07 -0400",
"subject": "Allow three-digits process IDs in logging.",
"body": "This is required to support process-max > 99 or else there will be formatting/alignment issues in the logs."
},
{
"commit": "2a85df95c121528d826e30526a2fd251638624e7",
"date": "2019-04-03 17:48:45 +0100",
"subject": "Add assert missed in 1b486847.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1e5f2713b2936bd3252e0081a979a9d84eba19d0",
"date": "2019-04-03 16:40:19 +0100",
"subject": "Add memContextSwitch() missed in 5bdaa35f.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "5504f286eb6765d3131f2ff99cb2b464a02c4589",
"date": "2019-04-03 12:32:56 +0100",
"subject": "Add test and asserts missed in abba2bd1.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "be58b8fee799d29cc5f1df0147bce59b09982208",
"date": "2019-04-03 12:04:44 +0100",
"subject": "Add assert missed in 1b486847.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "e97b8241a59f4dd56ea374b00b3fb9905a1febc3",
"date": "2019-04-03 11:40:12 +0100",
"subject": "Clarify that S3-compatible object stores are supported.",
"body": "The documentation mentioned Amazon S3 frequently but failed to mention that other S3-compatible object stores are also supported.\n\nTone down the specific mentions of Amazon S3 and replace them with \"S3-compatible object store\" when appropriate."
},
{
"commit": "4c63279a19a6baa1f6854eee59cc804f6f89cb23",
"date": "2019-04-02 13:50:02 +0100",
"subject": "Add forkSafe() to handle fork errors.",
"body": "fork() rarely fails but we should definitely detect when it does so."
},
{
"commit": "1b48684713220b3436b24b266e543196824e974f",
"date": "2019-03-29 13:26:33 +0000",
"subject": "The archive-push command is implemented entirely in C.",
"body": "This new implementation should behave exactly like the old Perl code with the exception of updated log messages.\n\nRemove as much of the Perl code as possible without breaking other commands."
},
{
"commit": "251dbede8ff8a7206986106b8df8b08257cd7ebd",
"date": "2019-03-27 21:14:06 +0000",
"subject": "Add locking capability to the remote command.",
"body": "When a repository server is configured, commands that modify the repository acquire a remote lock as well as a local lock for extra protection against multiple writers.\n\nInstead of the custom logic used in Perl, make remote locking part of the command configuration.\n\nThis also means that the C remote needs the stanza since it is used to construct the lock name. We may need to revisit this at a later date."
},
{
"commit": "7db8cedd68477dd511bb8bdf8b94b2d2925470dd",
"date": "2019-03-27 20:59:28 +0000",
"subject": "Add protocolKeepAlive() to send noops to all remotes.",
"body": "While the local processes are doing their jobs the remote connection from the main process may timeout.\n\nSend occasional noops to ensure that doesn't happen."
},
{
"commit": "f8cbf5d78cbacfef253f8e75983e403e10049df0",
"date": "2019-03-27 20:52:23 +0000",
"subject": "Add TEST_64BIT() macro to detect 64-bit platforms.",
"body": "This may not be the best way to detect 64-bit platforms but it seems to be working fine so far.\n\nCreate a macro to make it clearer what is being done and to make it easier to change the implementation."
},
{
"commit": "1fa103a4d23742af0fb16214a74b974cbe875724",
"date": "2019-03-27 18:14:00 +0200",
"subject": "Fix missing semicolon in code example."
},
{
"commit": "3181cd0ab8f09cbeca87d97e670e0901feb412a3",
"date": "2019-03-26 18:46:44 +0200",
"subject": "Set WAL long header flag in test function missed in e938a892.",
"body": "This was missed because the unit tests were reusing a buffer without resetting it to zero, so this flag ended up still set when the test function was called.\n\nThis was not a live issue since it only expressed in tests and this code is not used in master yet."
},
{
"commit": "7364d859da8b4ee67e4b0d76e9c0d08a15fa546d",
"date": "2019-03-26 16:00:15 +0200",
"subject": "Add missing parens."
},
{
"commit": "5ee8388f482adc52129a9960bdb077e8c054edb0",
"date": "2019-03-26 08:20:55 +0200",
"subject": "Build test harness with the same warnings as code being tested.",
"body": "The test harness was not being built with warnings which caused some wackiness with an improperly structured switch. Just use the same warnings as the code being tested.\n\nAlso enable warnings on code that is not directly being tested since other code modules are frequently modified during testing."
},
{
"commit": "f709334851cfbe254ce9f13266adba4504e9af64",
"date": "2019-03-25 23:59:56 +0200",
"subject": "Fix comment content and formatting."
},
{
"commit": "abba2bd13269b3d51802cb7bfba18a0abae47342",
"date": "2019-03-25 20:35:20 +0400",
"subject": "Add strLstMergeAnti() for merge anti-joins.",
"body": "We deal with some pretty big lists in archive-push so a nested-loop anti-join looked like it would not be efficient enough.\n\nThis merge anti-join should do the trick even though both lists must be sorted first."
},
{
"commit": "538e2c7474394f1f24bb0899bc7d85bf7c68bd5a",
"date": "2019-03-25 09:45:36 +0400",
"subject": "Add storagePg()/storagePgWrite() to storage helper.",
"body": "Add read/write storage helper functions for the PostgreSQL data directory."
},
{
"commit": "444b4f86403088f24883ffe0b940a6402159bfc0",
"date": "2019-03-25 09:17:15 +0400",
"subject": "Allow warnings to be written by archiveAsyncStatusOkWrite().",
"body": "Migrate this feature to the C code since archive-push will need it."
},
{
"commit": "8820d695747b40b73ead6d32a408e7d2804bd192",
"date": "2019-03-25 08:12:38 +0400",
"subject": "Use a single file to handle global errors in async archiving.",
"body": "The prior behavior on a global error (i.e. not file specific) was to write an individual error file for each WAL file being processed. On retry each of these error files would be removed, and if the error was persistent, they would then be recreated. In a busy environment this could mean tens or hundreds of thousands of files.\n\nAnother issue was that the error files could not be written until a list of WAL files to process had been generated. This was easy enough for archive-get but archive-push requires more processing and any errors that happened when generating the list would only be reported in the pgBackRest log rather than the PostgreSQL log.\n\nInstead write a global.error file that applies to any WAL file that does not have an explicit ok or error file. This reduces churn and allows more errors to be reported directly to PostgreSQL."
},
{
"commit": "1f6f3f673e49a2dff4dff465d183a2f6928138e6",
"date": "2019-03-24 18:29:20 +0400",
"subject": "Update default WAL segment size comment."
},
{
"commit": "1fff60ad2ad56f303080af666ed76e82dbb171b7",
"date": "2019-03-24 14:34:45 +0400",
"subject": "Remove unused infoArchiveCheckPg() function.",
"body": "The idea was to use this function for archive-push, but in the end archive-push required two very different versions of the function."
},
{
"commit": "8560db5c42fdc07de44b86daf76ad195282f67d7",
"date": "2019-03-24 13:54:05 +0400",
"subject": "Add constants for .ok/.error status extensions."
},
{
"commit": "7cf7373761cb83253a502e8d0af4f925c86a7944",
"date": "2019-03-21 21:11:36 +0400",
"subject": "Refactor PostgreSQL interface to remove most code duplication.",
"body": "Having a copy per version worked well until it was time to add new features or modify existing functions. Then it was necessary to modify every version and try to keep them all in sync.\n\nConsolidate all the PostgreSQL types into a single file using #if for type versions. Many types do not change or change infrequently so this cuts down on duplication. In addition, it is far easier to see what has changed when a new version is added.\n\nUse macros to write the interface functions. There is still duplication here since some changes require a new copy of the macro, but it is far less than before."
},
{
"commit": "e938a89250bd6a6512d4d6b5217a9750c848ca49",
"date": "2019-03-19 19:44:06 +0400",
"subject": "Add WAL info to PostgreSQL interface.",
"body": "This allows the WAL header to be read for any supported version on PostgreSQL."
},
{
"commit": "1c9645d4166165f70bf837b7d053415d78a216f2",
"date": "2019-03-19 19:20:38 +0400",
"subject": "Add missing static keyword."
},
{
"commit": "5c732e992904bc7f3201c119787d84cf05a8997d",
"date": "2019-03-18 22:10:25 +0400",
"subject": "Remove redundant documentation from PostgreSQL interface files and clarify ambiguous function names.",
"body": "Move the documentation to postgres/interface.c so it can be updated without having to update N source files.\n\nThe \"is\" function was not very specific so rename to \"controlIs\"."
},
{
"commit": "e26d510d0c1d8157ef5d9149bed9c2902ec29ba2",
"date": "2019-03-17 22:11:35 +0400",
"subject": "Use restore command for remote performances tests.",
"body": "Since archive-push is being moved to C, the Perl remote will no longer work with that command.\n\nEventually this module will need to be rewritten in C, but for now just use the restore command which is planned to be migrated last."
},
{
"commit": "856a369b863fb134ec249b7036eea70ba56d89ac",
"date": "2019-03-17 22:00:54 +0400",
"subject": "Add file write to the S3 storage driver.",
"body": "Now that repositories are writable the storage drivers that don't yet support file writes need to be updated to do so.\n\nNote that the part size for multi-part upload has not been defined as a proper constant. This will become an option in the near future so it doesn't seem worth creating a constant that we might then forget to remove."
},
{
"commit": "7193738288e7c25bba526f5133fad9d4cf70d4c0",
"date": "2019-03-17 21:38:07 +0400",
"subject": "Add document creation to XML objects.",
"body": "The xml objects only exposed read methods of the underlying libxml2.\n\nThis worked for S3 commands that only received data but to send data we need to be able to create XML documents from scratch.\n\nAdd the ability to create empty documents and add nodes and contents."
},
{
"commit": "fc974626cd060271c39480ea5ac960b8db903699",
"date": "2019-03-17 08:35:40 +0400",
"subject": "Add a note regarding verifying checkpoint against replay position."
},
{
"commit": "8ebc6d6c34e7ccc7e4d07f1321fd4b1dce1579c7",
"date": "2019-03-16 21:50:19 +0400",
"subject": "Add file write to the remote storage driver.",
"body": "Now that repositories are writable the storage drivers that don't yet support file writes need to be updated to do so."
},
{
"commit": "2d386cd26672ed6c1ff2ca20465b7c7505cf9de6",
"date": "2019-03-16 16:14:10 +0400",
"subject": "Move WAL path prefix logic into walPath().",
"body": "This logic is used by both archive-push and archive-get."
},
{
"commit": "12273a10346a5520ce556a19df7b0cd4f9be74be",
"date": "2019-03-16 15:48:50 +0400",
"subject": "Add storageRepoWrite() to storage helper.",
"body": "Writable repos are allowed with the addition of the CIFS driver, so add a helper function."
},
{
"commit": "66c2f4cd2e43f05d65e06f3c89094fbdf702d60d",
"date": "2019-03-16 15:27:38 +0400",
"subject": "Make notion of current PostgreSQL info ID in C align with Perl.",
"body": "The C code was assuming that the current PostgreSQL version in archive.info/backup.info was the most recent item in the history, but this is not always the case with some stanza-upgrade scenarios. If a cluster is restored from before the upgrade and stanza-upgrade is run again, it will revert db-id to the original history item.\n\nInstead, load db-id from the db section explicitly as the Perl code does.\n\nThis did not affect archive-get since it does a reverse scan through the history versions and does not rely on the current version."
},
{
"commit": "b2b2cf0511b326c695e825bee0c5f5faf648224c",
"date": "2019-03-16 15:00:02 +0400",
"subject": "Fix issues with remote/local command logging options.",
"body": "Logging was being enable on local/remote processes even if --log-subprocess was not specified, so fix that.\n\nAlso, make sure that stderr is enabled at error level as it was on Perl. This helps expose error information for debugging.\n\nFor remotes, suppress log and lock paths since these are not applicable on remote hosts. These options should be set in the local config if they need to be overridden."
},
{
"commit": "d377e926c806faa8d61744e27eacfa7bf610c445",
"date": "2019-03-16 13:07:43 +0400",
"subject": "httpClientRequest() accepts a body parameter.",
"body": "None of our C HTTP requests have needed to output a body, but they will with the migration of archive-push.\n\nAlso, add constants that are useful when POSTing/PUTing data."
},
{
"commit": "078df66e2c66ea992c423ffc92a789a4f036b622",
"date": "2019-03-16 12:51:37 +0400",
"subject": "Add httpHeaderDup().",
"body": "Allow duplication of headers and updating of redactions."
},
{
"commit": "be670e25450a174f6652850af765805de1139263",
"date": "2019-03-16 12:32:54 +0400",
"subject": "Add hash size constants and extern hash type constant.",
"body": "The size constants are convenient for creating data structures of the proper size.\n\nThe hash type constant must be extern'd so that results can be pulled from a filter."
},
{
"commit": "76560b3cf0959c11b92e3b98c640f5e6070b1e7a",
"date": "2019-03-16 12:26:25 +0400",
"subject": "Add missing const to cryptoHashOne() and cryptoHashOneStr()."
},
{
"commit": "0eb4c2c8291ed0dc5c211594b5e85e1b31a9d84d",
"date": "2019-03-16 12:21:16 +0400",
"subject": "Fix incorrect buffer size used in cryptoHashOne().",
"body": "This was missing when bufUsed() was introduced.\n\nIt is not currently a live issue, but becomes a problem in the new archive-push code where the entire buffer is not always used."
},
{
"commit": "9c1549585e0d8a4613954bbfc194dd0dc0a537a8",
"date": "2019-03-15 22:18:56 +0400",
"subject": "Add command for removing all Docker containers to the Vagrantfile."
},
{
"commit": "b68d1d60a1532e9d1ef2703b043d538643d6f8cc",
"date": "2019-03-15 22:16:50 +0400",
"subject": "Add cvtSSizeToZ() and debug macros."
},
{
"commit": "d16bff64cdcb5be6c6ac3b8f31d394c2393b7649",
"date": "2019-03-15 10:30:48 +0400",
"subject": "Add missing log param and assert."
},
{
"commit": "a6e219bc8bf1f6d93a24ba120fa9614d7b667ce3",
"date": "2019-03-15 10:25:24 +0400",
"subject": "Improve comment, remove duplicated header and extraneous braces."
},
{
"commit": "5554377632807a3e778273b9882a191e8a6edae6",
"date": "2019-03-15 10:20:52 +0400",
"subject": "Make strLstDup() null-tolerant.",
"body": "Duping a NULL StringList without checking if it is NULL is a useful capability."
},
{
"commit": "9382283586da4794d3585dbf6680c3a2f3d10a33",
"date": "2019-03-14 13:48:33 +0400",
"subject": "Fix issues when a path option is / terminated.",
"body": "This condition was not being properly checked for in the C code and it caused problems in the info command, at the very least.\n\nInstead of applying a local fix, introduce a new path option type that will rigorously check the format of any incoming paths."
},
{
"commit": "b8ebea6b1c3cf2a26c44f04c7552c66fd9acb44a",
"date": "2019-03-14 13:38:55 +0400",
"subject": "Add separate archive-push-async command.",
"body": "This command was previously forked off from the archive-push command which required a bit of artificial option and log manipulation.\n\nA separate command is easier to test and will work on platforms that don't have fork(), e.g. Windows."
},
{
"commit": "982b47c5ecec475703860f52a0eabe7d501a96e2",
"date": "2019-03-14 13:28:33 +0400",
"subject": "Add CIFS storage driver.",
"body": "This driver borrows heavily from the Posix driver.\n\nAt this point the only difference is that CIFS does not allow explicit directory fsyncs so they need to be suppressed. At some point the CIFS diver will also omit link support.\n\nWith the addition of this driver repository storage is now writable."
},
{
"commit": "941dbb47313b25339d438e7a57975bcd88c65168",
"date": "2019-03-14 13:02:19 +0400",
"subject": "Remove package patch merged to upstream."
},
{
"commit": "cf5a5b7b9a97fb5907990812745d42ec4e3de7fb",
"date": "2019-03-11 10:43:35 +0200",
"subject": "Begin v2.12 development."
},
{
"commit": "68d20edea6cbfc7b8b6db69633e08ac473821547",
"date": "2019-03-10 18:56:00 +0200",
"subject": "v2.11: C Implementation of Archive Get"
},
{
"commit": "2ef5ad70a29b36db570f8f50a2ba821fc4ee02ff",
"date": "2019-03-10 13:27:30 +0200",
"subject": "Move crypto module to common/crypto.",
"body": "It makes sense for the crypto code to be in common since it is not pgBackRest-specific.\n\nAlso combine the crypto tests into a single module."
},
{
"commit": "95597be81e7450fdbb88a6c17b549e9eb750d5dd",
"date": "2019-03-10 13:11:20 +0200",
"subject": "Move compress module to common/compress.",
"body": "It makes sense for the compression code to be in common since it is not pgBackRest-specific."
},
{
"commit": "2f63babe9dfa6f49d5fbc9a6e039e1a1dfa5054d",
"date": "2019-03-10 11:55:01 +0200",
"subject": "Move help/help test module to command/help."
},
{
"commit": "e4e2606fce1ef28e82f359581e1a90be6d10414c",
"date": "2019-03-10 11:03:52 +0200",
"subject": "Add additional options to backup.manifest for debugging purposes.",
"body": "Add the buffer-size, compress-level, compress-level-network, and process-max options to the backup:option section in backup.manifest to aid in debugging.\n\nIt may also make sense to propagate these options up to backup.info so they can be displayed in the info command, but for now this is deemed sufficient."
},
{
"commit": "21f56f64ebe0af34b61793efad1730707a8e9f39",
"date": "2019-03-10 10:38:12 +0200",
"subject": "Add hints when unable to find a WAL segment in the archive.",
"body": "When this error happens in the context of a backup it can be a bit mystifying as to why the backup is failing. Add some hints to get the user started.\n\nThese hints will appear any time a WAL segment can't be found, which makes the hint about the check command redundant when the user is actually running the check command, but it doesn't seem worth trying to exclude the hint in that case."
},
{
"commit": "bc9fb0f59ae4d9cc843fa8ac2d9d434cf850910d",
"date": "2019-03-10 09:16:25 +0200",
"subject": "Add note for CSTD settings on BSD variants.",
"body": "Suggested by ucando, jungle-boogie, Luca Ferrari."
},
{
"commit": "786e77a9feb0ec3133d7f1ab7efe0037816a1382",
"date": "2019-03-09 11:40:55 +0200",
"subject": "Make DESTDIR fully-configurable in the Makefile.",
"body": "DESTDIR always had /usr/bin appended which was a problem systems that don't use /usr/bin as the install location for binaries.\n\nInstead, use the value of DESTDIR exactly and update the Debian packages accordingly."
},
{
"commit": "60fe5b7365c9eaaa03e954cac7dec14777aa2461",
"date": "2019-03-09 11:03:47 +0200",
"subject": "Error when parameters are passed to a command that does not accept parameters.",
"body": "This behavior allowed a command like this to run without error:\n\npgbackrest backup --stanza=db full\n\nEven though it actually performed an incremental backup in most circumstances because the `full` parameter was ignored.\n\nInstead, output an error and exit."
},
{
"commit": "cad6fedb7ba2877f7ea1b2e23415c42b6bda3483",
"date": "2019-03-07 15:54:59 +0200",
"subject": "Prevent option warning from being output when running help command.",
"body": "This warning was being output when getting help if retention was not set:\n\nWARN: option repo1-retention-full is not set, the repository may run out of space\n\nSuppress this when getting help since the warning will display by default on a system that is not completely configured."
},
{
"commit": "3d7edc4ca4db2f75a33d43ffc5131a6a20086507",
"date": "2019-03-07 14:08:35 +0200",
"subject": "Add clean and uninstall targets to Makefile.",
"body": "Contributed by Luca Ferrari."
},
{
"commit": "d441061168ec56d22082a6ff54e5f1fb02cc8eae",
"date": "2019-03-02 15:01:02 +0200",
"subject": "Create test matrix for mock/all to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "f7d1d4400f1edcdd3216dfa5c9d1e306946c36a2",
"date": "2019-03-01 19:04:26 +0200",
"subject": "Create test matrix for mock/expire to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests."
},
{
"commit": "91622942c2e465cb46571343d0e40f8b7cef8742",
"date": "2019-03-01 17:12:41 +0200",
"subject": "Create test matrix for mock/archive-stop to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "c307d9fdf9439661d2a94f215bbc7b1ef714e34f",
"date": "2019-03-01 15:58:52 +0200",
"subject": "Don't make a copy of the context name in the MemContext module.",
"body": "This is very inefficient in terms of memory and time and dynamic context names were never utilized.\n\nJust require that context names be valid for the life of the context.\n\nIn practice they are all static strings."
},
{
"commit": "90709dfd213b1eb1dab3daff0101768f61be4b5f",
"date": "2019-03-01 14:57:01 +0200",
"subject": "Improve performance of context and memory allocations in MemContext module.",
"body": "Allocations required a sequential scan through the allocation list for both contexts and memory. This was very inefficient since for the most part individual memory allocations are seldom freed directly, rather they are freed when their context is freed.\n\nFor both types of allocations track an index for the lowest free position. After an allocation of the free position, a sequential search will be required for the next allocation but this is still far better than doing a scan for every allocation.\n\nWith a moderately-sized dataset (500 history entries in backup.info), there is a 237X performance improvement when combined with the f74e88bb refactor.\n\nBefore:\n\n % cumulative self\n time seconds seconds name\n 65.11 331.37 331.37 memContextAlloc\n 16.19 413.78 82.40 memContextCurrent\n 14.74 488.81 75.03 memContextTop\n 2.65 502.29 13.48 memContextNewIndex\n 1.18 508.31 6.02 memFind\n\nAfter:\n\n % cumulative self\n time seconds seconds name\n 94.69 2.14 2.14 memFind\n\nFinding memory allocations in order to free or resize them is the next bottleneck, but this does not seem to be a major issue presently."
},
{
"commit": "f74e88bba9c7a7912f0b1fc322823f1b527042f8",
"date": "2019-03-01 13:33:58 +0200",
"subject": "Use contextTop/contextCurrent instead of memContextTop()/memContextCurrent() in MemContext module.",
"body": "Using the functions internally is great for abstraction but not so great for performance on non-optimized builds.\n\nAlso, the functions end up prominent in any profiled build."
},
{
"commit": "6ce3310f8a2900d1af717da8d4c3345a9016933b",
"date": "2019-03-01 09:10:14 +0200",
"subject": "Update default documentation version to PostgreSQL 10.",
"body": "Also update CentOS 6 and 7 versions to PostgreSQL 9.5 and 9.6 respectively."
},
{
"commit": "409360924151a561dd5dc122dbcd9173a4e6c950",
"date": "2019-03-01 09:00:51 +0200",
"subject": "Documentation builds on PostgreSQL 9.4-10.",
"body": "More than likely 9.2-11 will work as well, but this has not been tested.\n\nHowever, 11 needs work on the group permissions introduced in that version."
},
{
"commit": "cb3b4fa24bbe271a517b50a3522bc5075d8fe6c7",
"date": "2019-02-28 14:33:29 +0200",
"subject": "Enable socket keep-alive on older Perl versions.",
"body": "The prior method depended on IO:Socket:SSL to push the keep-alive options down to the socket but it only worked for recent versions of the module.\n\nInstead, create the socket directly using IO::Socket::IP if available or IO:Socket:INET as a fallback. The keep-alive option is set directly on the socket before it is passed to IO:Socket:SSL."
},
{
"commit": "0913523096cf9178ffa46595171dc16ab815148b",
"date": "2019-02-28 09:51:19 +0200",
"subject": "Cleanup local/remote protocol interaction from 9367cc46.",
"body": "The command option was not being set correctly when a remote was started from a local. It was being set as 'local' rather than the command that the local was running as.\n\nAlso automatically select the remote protocol id based on whether it is started from a local (use the local protocol id) or from the main process (use 0).\n\nThese were not live issues but could cause strange behaviors as new features are added that might be hard to diagnose."
},
{
"commit": "db4b447be89878496f0a50905b2f51c1306b9de5",
"date": "2019-02-27 23:03:02 +0200",
"subject": "The archive-get command is implemented entirely in C.",
"body": "This new implementation should behave exactly like the old Perl code with the exception of a few updated log messages.\n\nRemove as much of the Perl code as possible without breaking other commands."
},
{
"commit": "9367cc461cda63698caa04ddb262405eef05890d",
"date": "2019-02-27 22:34:21 +0200",
"subject": "Migrate local command to C.",
"body": "The C local is only used for C commands in the main process.\n\nSome tweaking of the existing protocolGet() command was required. Originally the idea was to share the function for local and remote requests but the differences (as in Perl) were too great to make that practical."
},
{
"commit": "35abd4cd9517c4acf02d98bf386e1ef2ed2e8485",
"date": "2019-02-27 21:10:52 +0200",
"subject": "Add ProtocolParallel* objects for parallelizing commands.",
"body": "Allows commands to be easily parallelized if the jobs are broken up into discrete, non-overlapping chunks."
},
{
"commit": "35acfae7c2328a70f978973aa1c7ed91af750d88",
"date": "2019-02-27 19:48:30 +0200",
"subject": "Add ProtocolCommand object.",
"body": "This formalizes the creation of protocol commands, which was previously done by creating KeyValue objects manually."
},
{
"commit": "dee90d3e606262fe99dcc099867a96039540a1c2",
"date": "2019-02-27 18:11:09 +0200",
"subject": "Expose handle (file descriptor) from IoRead when applicable.",
"body": "Some IO objects have file descriptors which can be useful for monitoring with select().\n\nIt might also be useful to expose handles for write objects but there is currently no use case."
},
{
"commit": "b1957b07f351a93fa64658f8c898420b4bbe68f5",
"date": "2019-02-27 18:10:18 +0200",
"subject": "Improve null-handling of varToLog()."
},
{
"commit": "ea2aef1d0ceff366b75f663281df511b8169eadd",
"date": "2019-02-27 18:09:21 +0200",
"subject": "Add lstRemove() to List object.",
"body": "Because it is sometimes useful to remove items from a list."
},
{
"commit": "4be271ea2a1a7bed4e5165f10a8e62a19b4e7dc9",
"date": "2019-02-27 18:07:16 +0200",
"subject": "Improve fork harness to allow multiple children and setup pipes automatically.",
"body": "There was a lot of extra boilerplate involved in setting up pipes so that is now automated.\n\nIn some cases testing with multiple children is useful so allow that as well."
},
{
"commit": "18b62a4220acabc4ba0018ed884e20f695304aed",
"date": "2019-02-27 17:09:19 +0200",
"subject": "Only run test-level stack trace by default for unit-tested modules.",
"body": "This amends 70c30dfb which disabled test tracing in general.\n\nInstead, only enable test tracing by default for modules that are being unit tested. This saves lots of time but still ensures that test tracing is working and helps with debugging in unit tests.\n\nAlso rename the option to --debug-test-trace for a clarity."
},
{
"commit": "3a05359087560248dc0bc7d1ce35516c6a5d622f",
"date": "2019-02-24 07:42:41 +0200",
"subject": "Create test matrix for mock/stanza to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "6d3e18b181d08f4e1ed64c097346a3532e6005af",
"date": "2019-02-24 06:55:59 +0200",
"subject": "Reduce expect log level in mock/stanza tests.",
"body": "The expect tests were originally a rough-and-ready type of unit test so monitoring changes in the expect log helped us detect changes in behavior.\n\nNow the stanza code is heavily unit-tested so the detailed logs mainly cause churn and don't have any measurable benefit.\n\nReduce the log level to DETAIL to make the logs less verbose and volatile, yet still check user-facing log messages."
},
{
"commit": "2f081f3ec7a0c9bb664eb5a426ec21859bb48722",
"date": "2019-02-23 18:51:52 +0200",
"subject": "Rename test modules for consistency.",
"body": "The conventions for command and info tests have shifted in the C modules, though not even all the C modules got the message."
},
{
"commit": "d489eb87f7f7da58dd02812e5088f507e1cab491",
"date": "2019-02-23 15:59:39 +0200",
"subject": "Create test matrix for mock/archive to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "4a7588e604d3b39858f09e8c879e973bd4432ded",
"date": "2019-02-23 15:13:23 +0200",
"subject": "Create aliases for test VMs ordered by age.",
"body": "This will allow for smarter allocation of tests in the next commit."
},
{
"commit": "59d7958914d2965d0690ebd579541c21a40ad201",
"date": "2019-02-23 15:05:06 +0200",
"subject": "Reduce expect log level in mock/archive tests.",
"body": "The expect tests were originally a rough-and-ready type of unit test so monitoring changes in the expect log helped us detect changes in behavior.\n\nNow the archive code is heavily unit-tested so the detailed logs mainly cause churn and don't have any measurable benefit.\n\nReduce the log level to DETAIL to make the logs less verbose and volatile, yet still check user-facing log messages."
},
{
"commit": "a9cbf23f4cacb18d85e7a6f02cff198790a9e21f",
"date": "2019-02-23 07:28:27 +0200",
"subject": "Improve error when hostname cannot be found in a certificate.",
"body": "Update error message with the hostname and more detail about what went wrong. Hopefully this will help in diagnosing certificate/hostname issues."
},
{
"commit": "1f66bda02ec9ae92403af2feeaf61505b3482932",
"date": "2019-02-22 12:02:26 +0200",
"subject": "Fix non-compliant JSON for options passed from C to Perl.",
"body": "We have been using a hacked-up JSON generator to pass options from C to Perl since the C binary was introduced. This generator was not very compliant which led to issues with \\n, \", etc. inside strings.\n\nWe have a fully-compliant JSON generator now so use that instead."
},
{
"commit": "70c30dfb619a3ec2ea7d465d5b8e2014518b723d",
"date": "2019-02-22 11:40:30 +0200",
"subject": "Disable test-level stack trace by default.",
"body": "Detailed stack traces for low-level functions (e.g. strCat, bufMove) can be very useful for debugging but leaving them on for all tests has become quite burdensome in terms of time. Complex operations like generating JSON on a large KevValue can lead to timeouts even with generous values.\n\nAdd a new param, --debug-trace, to enable test-level stack trace, but leave it off by default."
},
{
"commit": "ae86e6d5b2f6f86bc3ec1a4b1378d9b49e89799e",
"date": "2019-02-22 11:31:37 +0200",
"subject": "Add missing ToLog() coverage to String, List, and PgControl.",
"body": "Missing coverage is exposed in the next commit which disables test tracing by default."
},
{
"commit": "a7c8906581e8fc875c3cac99153aacb323de034f",
"date": "2019-02-21 18:49:02 +0200",
"subject": "Fix incorrect tags."
},
{
"commit": "e14c0eeb65a998a419e5a2e6c0ce833e8d7d03dc",
"date": "2019-02-21 16:20:46 +0200",
"subject": "Use driver for remote protocol introduced in da628be8.",
"body": "The remote protocol was calling into the Storage object but this required some translation which will get more awkward as time goes by.\n\nInstead, call directly into the local driver so the communication is directly driver to driver. This still requires resolving the path and may eventually have more duplication with the Storage object methods but it seems the right thing to do."
},
{
"commit": "b1eb8af7d5093a26a2e221a428540e5e7b356eed",
"date": "2019-02-21 15:40:21 +0200",
"subject": "Resolve storage path expressions before passing to remote.",
"body": "Expressions such as require a stanza name in order to be resolved correctly. However, if the stanza name is passed to the remote then that remote will only work correctly for that one stanza.\n\nInstead, resolved the expressions locally but still pass a relative path to the remote. That way, a storage path that is only configured on the remote does not need to be known locally."
},
{
"commit": "b4d4680f8c3126d1c2016d30aa2a1b77aac085c0",
"date": "2019-02-21 14:40:35 +0200",
"subject": "Allow cfgExecParam() to exclude options.",
"body": "It is useful to be able to exclude an option even if it is shared by both commands."
},
{
"commit": "be6a3f131e746304c6a30c39fcab4fe4b44dcb7f",
"date": "2019-02-21 14:26:06 +0200",
"subject": "Improve null-handling of strToLog().",
"body": "NULL was returning {\"(null)\"} which was comprehensible but not very pretty. Instead return null on NULL."
},
{
"commit": "1fd89f05afd8d8614d7b38a006eda4418f6324ce",
"date": "2019-02-21 14:16:17 +0200",
"subject": "Add kvKeyExists() to KeyValue object.",
"body": "Check if a key exists even if the value is NULL, which is the same result for a missing key."
},
{
"commit": "80df1114bdc97a930421f491bb7f41d9aeab6069",
"date": "2019-02-21 12:09:12 +0200",
"subject": "Fix info command missing WAL min/max when stanza specified.",
"body": "This issue was a result of STORAGE_REPO_PATH prepending an extra stanza when the stanza was specified on the command line.\n\nThe tests missed this because by some strange coincidence the WAL dirs were empty for each test that specified a stanza. Add new tests to prevent a regression.\n\nFixed by Stefan Fercot."
},
{
"commit": "1519f5b04540d5a431044f83a45b604ad8757397",
"date": "2019-02-21 11:40:30 +0200",
"subject": "Add storageHelperFree() to storage helper.",
"body": "Free all cached objects in the storage helper, especially the stanza name.\n\nThis clears the storage environment for tests that switch stanza names or go from a stanza name to no stanza name or vice versa. This is only useful for testing right now, but may be used in the future for commands than act on multiple stanzas."
},
{
"commit": "b0b5989acae29b962b9101719459234968a8e6c1",
"date": "2019-02-20 22:57:18 +0200",
"subject": "Migrate remote archive-get command to C.",
"body": "All required protocol commands are implemented so this is mostly a matter of enabling the feature and updating expect logs."
},
{
"commit": "6866ff031a6a48d6cd966f5df78bcbc2c84a3890",
"date": "2019-02-20 22:43:02 +0200",
"subject": "Add exists() to remote storage."
},
{
"commit": "71bc5697b1a35c8460af7885b888b1d43bd994b1",
"date": "2019-02-20 22:23:19 +0200",
"subject": "Increase per-call stack trace size to 4096.",
"body": "This was previously 256, which was too small to log protocol parameters. Not only did this truncate important debug information but varying path lengths caused spurious differences in the expect logs."
},
{
"commit": "73be64ce49aaff9d94f70c47590476c404365ce4",
"date": "2019-02-20 15:52:07 +0200",
"subject": "Add separate archive-get-async command.",
"body": "This command was previously forked off from the archive-get command which required a bit of artificial option and log manipulation.\n\nA separate command is easier to test and will work on platforms that don't have fork(), e.g. Windows."
},
{
"commit": "e48b406cdc3c73056137d6767a7f70e08bee9806",
"date": "2019-02-20 15:48:14 +0200",
"subject": "Add instructions for building the coverage report.",
"body": "These are intended to be temporary until a fully automated report is developed.\n\nSince we don't know when that will happen, at least make it easier to generate the current report."
},
{
"commit": "da628be8a8045e73b621fb229ac149b545008327",
"date": "2019-02-19 20:57:38 +0200",
"subject": "Migrate remote command to C.",
"body": "Prior to this the Perl remote was used to satisfy C requests. This worked fine but since the remote needed to be migrated to C anyway there was no reason to wait.\n\nAdd the ProtocolServer object and tweak ProtocolClient to work with it. It was also necessary to add a mechanism to get option values from the remote so that encryption settings could be read and used in the storage object.\n\nUpdate the remote storage objects to comply with the protocol changes and add the storage protocol handler.\n\nIdeally this commit would have been broken up into smaller chunks but there are cross-dependencies in the protocol layer and it didn't seem worth the extra effort."
},
{
"commit": "d211c2b8b51ae5b796bbb581d21a4a406e3ed972",
"date": "2019-02-15 11:52:39 +0200",
"subject": "Fix possible truncated WAL segments when an error occurs mid-write.",
"body": "The file write object destructors called close() and finalized the file even if it was not completely written. This was an issue in both the C and Perl code.\n\nRewrite the destructors to simply free resources (like file handles) rather than calling the close() method. This leaves the temp file in place for filesystems that use temp files.\n\nAdd unit tests to prevent regression."
},
{
"commit": "2cd204f38037f1465c84bb4e6b55893204ee8f93",
"date": "2019-02-12 14:59:51 +0200",
"subject": "Change execRead() to return a size_t.",
"body": "execRead() should be returning a size_t, not a void. Thankfully, this isn't actually used and therefore shouldn't be an issue, but we should fix it anyway."
},
{
"commit": "a5f6f801d7651606363715471dcb958e3339414c",
"date": "2019-02-12 14:11:16 +0200",
"subject": "Begin v2.11 development."
},
{
"commit": "35903b94d9f2de14fb116c4b15649466eff78ef2",
"date": "2019-02-09 19:52:31 +0200",
"subject": "v2.10: Bug Fixes"
},
{
"commit": "51971617a82a3f58efe33dff8386bc94fe1ac628",
"date": "2019-02-09 19:01:16 +0200",
"subject": "Fix year on 2.09 release.",
"body": "Reported by Achilleas Mantzios."
},
{
"commit": "057e2e27822ffd053f735762e1441fccea24c5ed",
"date": "2019-02-09 18:57:30 +0200",
"subject": "Add unimplemented S3 driver method required for archive-get.",
"body": "This was not being caught because the integration tests for S3 were running remotely and going through the Perl code rather than the new C code.\n\nImplement the exists method for the S3 driver and add tests to prevent a regression."
},
{
"commit": "6e88f93991171632f33fd1b12fc1090d4a9f02a5",
"date": "2019-02-05 18:55:07 +0200",
"subject": "Fix check for improperly configured pg-path.",
"body": "The check to verify that pg-path and data_directory are equal was not working because pg-path was getting overwritten with data_directory before validation took place."
},
{
"commit": "be8f31a9524f7b6c47e52a01f89aaf9f0a65ddc2",
"date": "2019-02-05 15:34:18 +0200",
"subject": "JSON improvements.",
"body": "Optimize the parser implementation and make the renderer more null tolerant.\n\nAlso make some string and variant constructors null tolerant."
},
{
"commit": "b3d1a2a8023adc6d1e35221dc6c3789a1b772c5c",
"date": "2019-02-02 15:18:10 +0200",
"subject": "FIx typos and missing debug param."
},
{
"commit": "b29a8dd9c541b755381f2e103abbe0b05fc65190",
"date": "2019-02-02 15:03:19 +0200",
"subject": "Automatically adjust db-timeout when protocol-timeout is smaller.",
"body": "This already worked in reverse, but this case is needed when a command that only uses protocol-timeout (e.g. info) calls a remote process where protocol-timeout and db-timeout can be set. If protocol-timeout was set to less than the default db-timeout then an error resulted."
},
{
"commit": "abc613b454f8f1aa9da5e842c5da822d26504163",
"date": "2019-02-02 14:50:24 +0200",
"subject": "Begin v2.10 development."
},
{
"commit": "a89a3761191444ef28b22434f94bc42fd84b83ee",
"date": "2019-01-30 22:37:35 +0200",
"subject": "v2.09: Minor Improvements and Bug Fixes"
},
{
"commit": "02dff53d45b3db2daf69ee45ac694696dc051cc3",
"date": "2019-01-30 22:02:42 +0200",
"subject": "Add openssl-devel install to documentation build in 711b3e67."
},
{
"commit": "fb342c312591d2980bbbd490a04fb26967d04fb1",
"date": "2019-01-30 21:11:52 +0200",
"subject": "Add latex install to documentation build in 711b3e67."
},
{
"commit": "aa3e5b8c72a75a4f5fea93b543a8fbedcd713f02",
"date": "2019-01-30 17:03:17 +0200",
"subject": "Allow primary gid for the test user to be different from uid.",
"body": "Apparently up until now they have always been the same, which is pretty typical. However, if they were not then ContainerTest.pm was not happy."
},
{
"commit": "711b3e67cbfc7b404ffe2ce196ffb42159c95040",
"date": "2019-01-30 16:53:59 +0200",
"subject": "Add examples for building a documentation host."
},
{
"commit": "dada50ee26e3891ebfca73e12a8f14080cc8ad7e",
"date": "2019-01-30 13:39:22 +0200",
"subject": "Fix hard-coded repository path.",
"body": "This prevented packages from being passed to the documentation unless they were in the /backrest directory on the host.\n\nAlso make the local path /pgbackrest instead of the deprecated /backrest."
},
{
"commit": "8634eb8c43c8666634fe64a49a39c6384caee64d",
"date": "2019-01-29 12:08:14 +0200",
"subject": "Include Posix-compliant header for fd_set.",
"body": "Similar to f3ae3c4f, add Posix-compliant header to make FreeBSD happy."
},
{
"commit": "b5a103f2df4999219ef509356ba2c46c292ecccb",
"date": "2019-01-28 22:33:29 +0200",
"subject": "Improve P/PP type macro handling.",
"body": "Rather than create _P/_PP variants for every type that needs to pass/return pointers, create FUNCTION_*_P/PP() macros that will properly pass or return any single/double pointer types.\n\nThere remain a few unresolved edge cases such as CHARPY but this handles the majority of types well."
},
{
"commit": "8b2a344cfecc2438aafeba7f1c1b7b0572973562",
"date": "2019-01-28 15:06:28 +0200",
"subject": "Remove unused type parameter from FUNCTION_TEST_RETURN().",
"body": "This parameter was always useless but commit 7333b630 removed all references to it so remove the parameter at all call sites as well.\n\nThe original intention was probably to allow logging of TEST return values but that never happened."
},
{
"commit": "7333b6302fb26191a322cc1513fd85c76b066346",
"date": "2019-01-28 09:44:10 +0200",
"subject": "Improve CONST type macro handling.",
"body": "Rather than create a CONST_ variant for every type that needs to be returned const, create a FUNCTION_LOG_RETURN_CONST() macro that will return any type as const."
},
{
"commit": "d29aa6128681a3912c1c48ed71cdad9395d0d347",
"date": "2019-01-27 11:50:09 +0200",
"subject": "Allocate extra space for concatenations in the String object.",
"body": "The string object was reallocating memory with every concatenation which is not very efficient. This is especially true for JSON rendering which does a lot of concatenations.\n\nInstead allocate a pool of extra memory on the first concatenation (50% of size) to be used for future concatenations and reallocate when needed.\n\nAlso add a 1GB size limit to ensure that there are no overflows."
},
{
"commit": "82c2d615b3ecdb851029ad691f5a8061f949535b",
"date": "2019-01-27 11:34:12 +0200",
"subject": "Move MACRO_TO_STR() to common/debug.h.",
"body": "This macro is handy for constructing static message strings so move it where the core code can see it."
},
{
"commit": "4027123ef19629ff1d5638a75677fa81b3831d03",
"date": "2019-01-27 08:01:17 +0200",
"subject": "Update contributor name."
},
{
"commit": "8f6d324b2c2576456bd0ba7f691297df1f5aba1e",
"date": "2019-01-26 16:59:54 +0200",
"subject": "Fix issue with multiple async status files causing a hard error.",
"body": "Multiple status files were being created by asynchronous archiving if a high-level error occurred after one or more WAL segments had already been transferred successfully. Error files were being written for every file in the queue regardless of whether it had already succeeded. To fix this, add an option to skip writing error files when an ok file already exists.\n\nThere are other situations where both files might exist (various fsync and filesystem error scenarios) so it seems best to retry in the case that multiple status files are found rather than throwing a hard error (which then means that archiving is completely stuck). In the case of multiple status files, a warning will be logged to alert the user that something unusual is happening and the command will be retried."
},
{
"commit": "f3ae3c4f9d0dd63c583ab27ef1f6aa869db12a3a",
"date": "2019-01-26 13:48:46 +0200",
"subject": "Include Posix-compliant header for strcasecmp().",
"body": "gcc has apparently merged this function in string.h but Posix specifies that it should be in strings.h. FreeBSD at at least is sticking to the standard.\n\nIn the long run it might be better to implement our own strcasecmp() function but for now just add the header."
},
{
"commit": "1401c023f0cfdd0266144bdd8b181e8194bbd91e",
"date": "2019-01-26 12:02:48 +0200",
"subject": "Fix release note typo."
},
{
"commit": "053972bfe01948a463fed56b11e3522b3b10457f",
"date": "2019-01-26 12:01:18 +0200",
"subject": "Update address lookup in C TLS client to use modern methods.",
"body": "The implementation using gethostbyname() was only intended to be used during prototyping but was forgotten when the code was finalized.\n\nReplace it with gettaddrinfo() which is more modern and supports IPv6."
},
{
"commit": "4d1060ea6bdf60d8e9fc7ca372386f53461ed6d1",
"date": "2019-01-26 10:39:51 +0200",
"subject": "Replace FileOpenError with HostConnectError in TlsClient.",
"body": "HostConnectError is more appropriate in this context."
},
{
"commit": "33d39d248c5ae6fab6b4bb7564ca85b18786332c",
"date": "2019-01-24 16:45:28 +0200",
"subject": "Allow if condition in documentation lists and list items."
},
{
"commit": "bec52b6f41a6101ab1357fb5b65ce36faefee9e4",
"date": "2019-01-24 11:11:12 +0200",
"subject": "Allow if in manifest variables.",
"body": "The code supported this feature but the manifest DTD did now allow it."
},
{
"commit": "db08656537b22c39e5278f9f2770b816278e771a",
"date": "2019-01-21 17:41:59 +0200",
"subject": "Rename FUNCTION_DEBUG_* and consolidate ASSERT_* macros for consistency.",
"body": "Rename FUNCTION_DEBUG_* macros to FUNCTION_LOG_* to more accurately reflect what they do. Further rename FUNCTION_DEBUG_RESULT* macros to FUNCTION_LOG_RETURN* to make it clearer that they return from the function as well as logging. Leave FUNCTION_TEST_* macros as they are.\n\nConsolidate the various ASSERT* macros into a single ASSERT macro that is always compiled out of production builds. It was difficult to figure out when an assert would be checked with all the different types in play. When ASSERTs are compiled in they will always be checked regardless of the log level -- tying these two concepts together was not a good idea."
},
{
"commit": "d245f8eb425322f0efcd05ab4c12b3b45cc87138",
"date": "2019-01-21 13:51:45 +0200",
"subject": "The info command is implemented entirely in C.",
"body": "The C info code has already been committed but this commit wires it into main.\n\nAlso remove the info Perl code and tests since they are no longer called."
},
{
"commit": "f79af47bd4ffff693e1a882955323fe73972eeb6",
"date": "2019-01-19 20:44:40 +0200",
"subject": "Increase timeout in storage/s3 module to improve reliability."
},
{
"commit": "e57f1b529327ebeca41405b6b57602013de9d625",
"date": "2019-01-19 12:57:40 +0200",
"subject": "Fix escaping in JSON string parser."
},
{
"commit": "7355248d6b2b1db0a7ca997db0dc2943331325a0",
"date": "2019-01-18 22:04:37 +0200",
"subject": "Add remote storage objects.",
"body": "This is a partial implementation of remote storage with just enough functionality to get the info command working. The client is written in C but the server is still in Perl, which limits progress until a C server is written."
},
{
"commit": "88201f37a3b7156dcf6f4aaa659136215485c40d",
"date": "2019-01-18 21:32:51 +0200",
"subject": "Add ProtocolClient object and helper functions.",
"body": "This is a complete protocol client implementation in C.\n\nCurrently there is no C server implementation so the C client is talking to a Perl server. This won't work very long, though, as the protocol format, even though in JSON, has a lot of language-specific structure. While it would be possible to maintain compatibility between C and Perl it's probably not worth the effort in the long run.\n\nJust as in Perl there are helper functions to make constructing protocol objects easier. Currently only repository remotes are supported."
},
{
"commit": "0986db630cf3c931ccb135a86e60ee098fdc2dec",
"date": "2019-01-18 13:15:43 +0200",
"subject": "Fix comment typo."
},
{
"commit": "9cac403f610ff3fd4a176b9cf5a7c0543bdd892c",
"date": "2019-01-18 11:45:40 +0200",
"subject": "Add Exec object.",
"body": "Executes a child process and allows the calling process to communicate with it using read/write io.\n\nThis object is specially tailored to implement the protocol layer and may or may not be generally applicable to general purpose\nexecution."
},
{
"commit": "797f8098d1383d05960566174859f75d4e835613",
"date": "2019-01-18 11:14:44 +0200",
"subject": "Add ioReadBuf() to easily read into a buffer.",
"body": "Moves some boilerplate into a function and makes it easier to get coverage in cases where a single buffer read captures all the data."
},
{
"commit": "06d41b4dc0f84f756b57d44cc2e2ceb6b5aec493",
"date": "2019-01-17 22:29:19 +0200",
"subject": "Add cfgExecParam() to generate parameters for executing commands.",
"body": "Parameters for the local/remote commands are based on parameters that are passed to the current command.\n\nGenerate parameters for the new command based on the intersection of parameters between the current command and the command to be executed."
},
{
"commit": "ecd56105e688e74ad71f8a1fc0fc3e785989abe5",
"date": "2019-01-17 22:08:31 +0200",
"subject": "Add IoHandleRead and IoHandleWrite objects.",
"body": "General i/o objects for reading and writing file descriptors, in particular those that can block. In other words, these are not generally to be used with file descriptors for actual files, but rather pipes, sockets, etc."
},
{
"commit": "bf0c41d9d6d5fd53cc4bf190b0c577f506323b5b",
"date": "2019-01-16 22:23:25 +0200",
"subject": "Add const VariantList * debug type."
},
{
"commit": "7d4bbf290cf33de06fca9854f21ec9690cfd51bb",
"date": "2019-01-16 22:16:50 +0200",
"subject": "Fix difference in cipher type reporting missed in 8304d452.",
"body": "The C code can't get the cipher type from the storage object because the C storage object does not have encryption baked in like the Perl code does.\n\nInstead, check backup.info to see if encryption is enabled. This will need to rethought if another cipher type is added but for now it works fine."
},
{
"commit": "e68d1e73042342c4cea0881e216e6979a3bcb140",
"date": "2019-01-16 19:23:10 +0200",
"subject": "Simplify info command text message when no stanzas are present.",
"body": "Replace the repository path with just \"the repository\". The path is not important in this context and it is clearer to state where the stanzas are missing from."
},
{
"commit": "ef9dc89e080d7b364a00fec138d1961c703dd02a",
"date": "2019-01-16 18:49:12 +0200",
"subject": "Update Storage::Local->list() to accept an undefined path.",
"body": "The Perl code has a tendency to generate absolute paths even when they are not needed. This change helps the C and Perl storage work together via the protocol layer."
},
{
"commit": "b4146b6bff99c8d82445bfda96b237ef0cff3050",
"date": "2019-01-16 18:45:19 +0200",
"subject": "Update Perl repo rules to work when stanza is not specified.",
"body": "The C storage object strives to use rules whenever possible instead of generating absolute paths. This change helps the C and Perl storage work together via the protocol layer."
},
{
"commit": "0014e159443354a46197e58f0631d7363d038cde",
"date": "2019-01-16 18:34:50 +0200",
"subject": "Fix escaping in JSON string renderer."
},
{
"commit": "49bd8e0e3e6e2c7f5e840c613919e55ee0074414",
"date": "2019-01-16 12:04:35 +0200",
"subject": "Fix missing linefeed and param debug."
},
{
"commit": "c0a904853664396d3ee9ffd5599634f489d924a1",
"date": "2019-01-16 09:11:01 +0200",
"subject": "Fix null output in JSON renderer.",
"body": "In some cases nulls were being rendered as \"(null)\" because no special logic existed to handle them."
},
{
"commit": "ec26a0594e2f1da3f2f0041ceef606f70eaeef5e",
"date": "2019-01-16 09:05:13 +0200",
"subject": "Allow string Variant objects to contain null.",
"body": "This is more useful than the variant itself being null as it saves conditionals when creating."
},
{
"commit": "1b334da87ffcddc5393fa0f900ec8c0395155aa7",
"date": "2019-01-14 22:02:23 +0200",
"subject": "Add kvMove() and varLstMove().",
"body": "Allow these objects to be moved to another mem context."
},
{
"commit": "aab9e38b9a070e8707c0a316784b456ecaeba64e",
"date": "2019-01-14 21:34:22 +0200",
"subject": "Return UnknownError from errorTypeFromCode() for invalid error codes.",
"body": "The prior behavior was to throw an exception but this was not very helpful when something unexpected happened. Better to at least emit the error message even if the error code is not very helpful."
},
{
"commit": "2b02d37602e3bfc451d598032d0e3793a06e8673",
"date": "2019-01-14 21:21:37 +0200",
"subject": "Allow empty arrays in JSON parser."
},
{
"commit": "8304d452b3683d5d1d59cf7a6cc14801ddc35efd",
"date": "2019-01-13 22:44:58 +0200",
"subject": "Make the C version of the info command conform to the Perl version.",
"body": "There were some small differences in ordering and how the C version handled missing directories. It may be that the C version is more consistent, but for now it is more important to be compatible with the Perl version.\n\nThese differences were missed because the C info command was not wired into main.c so it was not being tested in regression. This commit does not fix the wiring issue because there will likely be a release soon and it is too big a change to put in at the last moment."
},
{
"commit": "f314a1f8aa101b5f73cbb0902af7ebed9804a143",
"date": "2019-01-13 22:22:15 +0200",
"subject": "Improve accuracy of strSizeFormat().",
"body": "Casting to int caused large values to be slightly inaccurate so cast to uint64_t instead.\n\nAlso, use multiplication where possible since the compiler should precompute multiplied values."
},
{
"commit": "cebcb3f027d2a95f5b350df113efef78d449c72f",
"date": "2019-01-10 09:49:28 +0200",
"subject": "Null-terminate list returned by strLstPtr().",
"body": "The null-terminator is required by many C functions that accept a string list so just add it in all cases rather than making it optional."
},
{
"commit": "f8a9fc203909696293e57d84bc8f6d83d737097b",
"date": "2019-01-09 19:20:38 +0200",
"subject": "Fix typos in monitoring examples."
},
{
"commit": "ade2c3102d7459d274f0988d7d3cc2de49c7c9b4",
"date": "2019-01-06 17:42:44 +0200",
"subject": "Ignore SIGPIPE signals and check EPIPE result instead.",
"body": "SIGPIPE immediately terminates the process but we would rather catch the EPIPE error and gracefully shutdown.\n\nIgnore SIGPIPE and throw the EPIPE error via normal error handling."
},
{
"commit": "7272d6e2475f7fe8dd327206591b83cf4b9f498b",
"date": "2019-01-06 17:28:17 +0200",
"subject": "Add _DARWIN_C_SOURCE flag to Makefile for MacOS builds.",
"body": "For some reason adding -D_POSIX_C_SOURCE=200112L caused MacOS builds to stop working. Combining both flags seems to work fine for all tested systems."
},
{
"commit": "9560baf659cafec2614e90ce72d988635cb945c1",
"date": "2019-01-06 15:52:59 +0200",
"subject": "Move C module include in test.c above headers included for testing.",
"body": "Including the C module after the headers required for testing meant that if headers were missing from the C module they were not caught while directly testing the C module.\n\nThe missing headers were caught in general testing, but it is frustrating to get an error in a module that has already passed while testing another module or running CI.\n\nMove the C module include to the very top so missing headers cause immediate failures."
},
{
"commit": "0e0000f59c571a3889927288a536c8e220f97fac",
"date": "2019-01-06 15:27:30 +0200",
"subject": "Add debug macros and extra space missed in 256b727a."
},
{
"commit": "1de22cac2b0d2f9bddc794693dd2b97e61efdf85",
"date": "2019-01-06 14:37:39 +0200",
"subject": "Rename common/io/handle module to common/io/handleWrite.",
"body": "ioHandleWriteOneStr() will become a helper function for the IoHandleWrite object."
},
{
"commit": "f52e0187e61b6f74c66573580523018509541f98",
"date": "2019-01-05 18:10:30 +0200",
"subject": "Fix object struct comment to be conforming."
},
{
"commit": "842147321ff39a523608e281ade7ccb5fcad7bba",
"date": "2019-01-05 14:43:40 +0200",
"subject": "Fix typo in error message."
},
{
"commit": "59d7352f31a646c2f2491aacb922116caf125c50",
"date": "2019-01-05 14:38:31 +0200",
"subject": "Command-line help update missed in 200fd3aa."
},
{
"commit": "200fd3aa05174e109488f533d57db503d18ce25a",
"date": "2019-01-04 12:25:58 +0200",
"subject": "Clarify that encryption is always performed client-side.",
"body": "Suggested by Bruce Burdick."
},
{
"commit": "50717aa846a41852179feaa69b35a924bffc66c6",
"date": "2019-01-04 11:00:59 +0200",
"subject": "Begin v2.09 development."
},
{
"commit": "db24ff8df4b2c2de133461df3ab4f28167516dbf",
"date": "2019-01-02 22:04:47 +0200",
"subject": "v2.08: Minor Improvements and Bug Fixes"
},
{
"commit": "98ba7ece23637ead3b6a458372f32517aef0c20f",
"date": "2019-01-01 18:46:27 +0200",
"subject": "Update LICENSE.txt for 2019."
},
{
"commit": "26c888873e3c0956ec1e4a160715433ae3dd9eaf",
"date": "2019-01-01 18:14:43 +0200",
"subject": "Merge common/typeVariantListTest module into common/typeVariantTest.",
"body": "These modules are closely related so it makes sense for them to be merged."
},
{
"commit": "07b9176f257148d02c479207180c6af536ad43e1",
"date": "2019-01-01 18:05:13 +0200",
"subject": "Merge common/typeStringListTest module into common/typeStringTest.",
"body": "These modules are closely related so it makes sense for them to be merged."
},
{
"commit": "493fb78787b0929831899d333484140bfc636a89",
"date": "2019-01-01 17:31:23 +0200",
"subject": "Add strLstInsert() and strLstInsertZ() to StringList object.",
"body": "Use lstInsert() to implement insertions into any position in a StringList."
},
{
"commit": "cc6376fdb6bb3bff8ce0b432e23b1fa4ed13a210",
"date": "2018-12-31 09:19:38 +0200",
"subject": "Modify general document elements to allow any child element.",
"body": "This allows for nesting of elements such as and ."
},
{
"commit": "2b7440ddf313e6dbf8b53443a26cdf211161ad26",
"date": "2018-12-31 08:51:00 +0200",
"subject": "Allow custom logo for PDF documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "72865ca33ba383fba54da8db0bb8595890a12a3e",
"date": "2018-12-30 16:40:20 +0200",
"subject": "Add admonitions to documentation renderers.",
"body": "Admonitions call out places where the user should take special care.\n\nSupport added for HTML, PDF, Markdown and help text renderers. XML files have been updated accordingly."
},
{
"commit": "3dc327fd05882b2dc27e77a7922f5c275a7e2b25",
"date": "2018-12-20 23:20:54 +0200",
"subject": "Add optional table captions.",
"body": "All renderers now support table captions, when requested."
},
{
"commit": "8cf8d29f124723d717fa809168c6ea587bd5d592",
"date": "2018-12-19 19:13:26 +0200",
"subject": "Escape special characters in latex when not in a code block.",
"body": "A number of common characters are not allowed in latex without being escaped.\n\nAlso convert some HTML-specific codes that are used in the documentation."
},
{
"commit": "23b583336f3095b3e64d6068199b5c449dc776ac",
"date": "2018-12-18 22:12:59 +0200",
"subject": "Set TCP keepalives on S3 connections.",
"body": "Keepalives may help in situations where RST packets are being blocked by a firewall or otherwise do not arrive.\n\nThe C code uses select on all reads so it should never block, but add keepalives just in case."
},
{
"commit": "96028073cb45fffc5df0d510f3dd143ca10d7d62",
"date": "2018-12-18 22:02:23 +0200",
"subject": "Add HTML table rendering and update PDF/Markdown renderers to support header-less tables.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "b85e51d6d545df61cf22501c1db09371219a83da",
"date": "2018-12-14 18:46:12 -0500",
"subject": "Base menu ordering on natural ordering in the manifest.",
"body": "Menu ordering was alphabetical which is not ideal for a user interface."
},
{
"commit": "35bbb5bd6881e3f405cbd99c3992c32aa5c6d69f",
"date": "2018-12-14 18:25:31 -0500",
"subject": "Reorder info command text output so most recent backup is output last.",
"body": "After a stanza-upgrade backups for the old cluster are displayed until they expire. Cluster info was output newest to oldest which meant after an upgrade the most recent backup would no longer be output last.\n\nUpdate the text output ordering so the most recent backup is always output last."
},
{
"commit": "205525b60780587366b9786750535a55977f0221",
"date": "2018-12-13 16:22:34 -0500",
"subject": "Migrate local info command to C.",
"body": "The info command will only be executed in C if the repository is local, i.e. not located on a remote repository host. S3 is considered \"local\" in this case.\n\nThis is a direct migration from Perl to integrate as seamlessly with the remaining Perl code as possible. It should not be possible to determine if the C version is running unless debug-level logging is enabled."
},
{
"commit": "e6ef40e8a327d94e5111d21dd056eefbe5d19a86",
"date": "2018-12-13 15:46:18 -0500",
"subject": "Add infoBackup object to encapsulate the backup.info file.",
"body": "The infoBackup object is the counterpart to the infoArchive object which encapsulates the archive.info file.\n\nCurrently the object is read-only, i.e. it is not possible to create a new or modify an existing backup.info file.\n\nThere a number of constants that will also be used in the infoManifest object so go ahead and create a module to contain them so they don't need to be moved later."
},
{
"commit": "56d466ce4b39173c777e70e16914a0a76a400dfb",
"date": "2018-12-13 15:20:57 -0500",
"subject": "Add null support to jsonToKv().",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "d6dfbfd2f3cc2c838d6c1d28ba96076efa9364a6",
"date": "2018-12-12 14:35:44 -0500",
"subject": "Add zlib1g-dev to Debian builds.",
"body": "Not all debian-based distros were getting this installed."
},
{
"commit": "df947cfcb22928ac4487c74483a49075e35ea15d",
"date": "2018-12-12 13:52:23 -0500",
"subject": "Add documentation for building the documentation.",
"body": "A basic primer for building the documentation. Lots that could be added, but it's a start."
},
{
"commit": "fdc76742c8e98e630fa4219ba8e9aad79c882e40",
"date": "2018-12-12 13:48:31 -0500",
"subject": "Use absolute paths so that ./doc.pl runs.",
"body": "The relative paths used would not correctly find required libraries and DTD files."
},
{
"commit": "ee04ebe3142b0f170ef6662db3b6be3e2ba2e32e",
"date": "2018-12-12 11:15:09 -0500",
"subject": "Fix Centos/RHEL 7 documentation builds.",
"body": "This was caused by a new container version that was released around December 5th. The new version explicitly denies user logons by leaving /var/run/nologin in place after boot.\n\nThe solution is to enable the service that is responsible for removing this file on a successful boot."
},
{
"commit": "2f15a90d18e0cdc0d91e9915b400acfc78ccaf26",
"date": "2018-12-10 18:45:57 -0500",
"subject": "Add infoArchiveIdHistoryMatch() to the InfoArchive object.",
"body": "Match a PostgreSQL system identifier and version to a pgBackRest archive id."
},
{
"commit": "f0417ee524d1759b1aa5949abcae4769741ce550",
"date": "2018-12-10 18:31:49 -0500",
"subject": "Use cast to make for loop more readable in InfoPg module.",
"body": "The previous way worked but was a head-scratcher when reading the code. This cast hopefully makes it a bit more obvious what is going on."
},
{
"commit": "2514d08d0dc6d28a59bd884a751b734c70e2c0c0",
"date": "2018-12-10 18:15:06 -0500",
"subject": "Remove #define statements in the InfoPg module to conform with newly-adopted coding standards.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "fe152b8f29ff794cd6108c8295e35c44fe37c847",
"date": "2018-12-10 18:08:26 -0500",
"subject": "Rename constants in Info module for consistency.",
"body": "INFO is generally used as the prefix for info file constants so rename these accordingly.\n\nAlso follow newly-adopted coding standards for when #define is required for a static String constant."
},
{
"commit": "e3435ec386c19fc7a6f08b9d08d4cee4bf8e36f4",
"date": "2018-12-10 17:35:31 -0500",
"subject": "Add path expression for repository backup to the storage helper.",
"body": "This is the counterpart to the archive path expression and constructs paths into the backup part of the repository."
},
{
"commit": "4f539db8d9c666fa5a9c4e020e387a3b26886b83",
"date": "2018-12-10 17:01:33 -0500",
"subject": "Allow NULL stanza in storage helper.",
"body": "Some commands (e.g. info) do not take a stanza or the stanza is optional. In that case it is the job of the command to construct the repository path with a stanza as needed.\n\nUpdate helper functions to omit the stanza from the constructed path when it is NULL."
},
{
"commit": "cbf514e191783937de63b5a276fcefc426e6f430",
"date": "2018-12-10 16:32:41 -0500",
"subject": "Improve info error messages introduced in 74b72df9.",
"body": "- Add detail to errors when info files are loaded with incorrect encryption settings.\n- Throw FileMissingError rather than FileOpenError when both copies of the info file are missing.\n- If one file is present (but errors) and the other is missing, then return the error for the file that was present."
},
{
"commit": "80a3e215213090878e1519f4f4866de2ff6ee67a",
"date": "2018-12-10 16:11:51 -0500",
"subject": "Add strSizeFormat() to String object.",
"body": "Converts sizes in bytes to a more human-readable form, .e.g. 1KB, 1.1GB."
},
{
"commit": "947fa6fc2b086f0c2fad602b9921861c0bd18fd3",
"date": "2018-12-10 15:43:52 -0500",
"subject": "Fix comment typo.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1c5f8f45b68ad87553c2219ffb8e0da0314ad920",
"date": "2018-12-07 12:32:10 -0500",
"subject": "Add configuration to the standby so it works as a primary when promoted.",
"body": "This code was generated during testing and it seemed a good idea to keep it. It is only a partial solution since the primary also needs additional configuration to be able to fail back and forth."
},
{
"commit": "495391c7430ee8f4aafc006f6cea829e6a3ca981",
"date": "2018-12-07 12:19:28 -0500",
"subject": "Pick pg_switch_wal()/pg_switch_xlog() based on PostgreSQL version.",
"body": "One step in making the documentation build for all versions that we support."
},
{
"commit": "e6abdfb5b864b6526e0e5cb147911bd8ff5c8e15",
"date": "2018-12-07 07:41:26 -0500",
"subject": "Add error message when current user uid/gid does not map to a name.",
"body": "This condition resulted in a nasty stack trace dump when the undefined value was used later on."
},
{
"commit": "ac84ffb90156585c3f7a84ed757bc2603da13f31",
"date": "2018-12-06 11:57:30 -0500",
"subject": "Clarify that storageExists() is only valid for files.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "a72759eb5bad455fc1cca5e1e073628643d6dc0b",
"date": "2018-12-06 11:53:38 -0500",
"subject": "Add comments on String and Variant usage regarding memory contexts.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "11181e69b818452a0b01d388ca5ce0879e6c3a3d",
"date": "2018-12-06 09:04:01 -0500",
"subject": "Disable Centos/RHEL 7 documentation builds.",
"body": "These were introduced in 33fa2ede and ran for a day or so before they started failing consistently on CI. Local builds work fine.\n\nDisable them to free the pipeline for further commits while we determine the issue."
},
{
"commit": "e73416e9e39118a3eb7a10d4d3f434ef7cc1c4ba",
"date": "2018-12-05 17:56:47 -0500",
"subject": "Change file ownership only when required.",
"body": "Previously chown() would be called even when no ownership changes were required.\n\nIn most cases changes are not required and it seems better to perform an extra stat() rather than an extra chown().\n\nAlso add unit tests for owner() since there weren't any."
},
{
"commit": "e96986a4e1e7aa5302686f559ca2848e1518669f",
"date": "2018-12-05 16:21:45 -0500",
"subject": "Error when --target-action=shutdown specified for PostgreSQL < 9.5.",
"body": "This equaled \"promote\" on unsupported versions which qualifies as a surprising behavior."
},
{
"commit": "5b52f020212d75b4f1001727e1a0d8acbae0fe60",
"date": "2018-12-05 15:58:45 -0500",
"subject": "Clarify when target-action is effective and PostgreSQL version support.",
"body": "Suggested by Keith Fiske."
},
{
"commit": "a0ecf53ead32070045119e8a129d0d07da3662fa",
"date": "2018-12-05 13:07:55 -0500",
"subject": "Fix documentation typo."
},
{
"commit": "bf873be4aa2688416ec63c8920144a847df142f7",
"date": "2018-12-05 12:51:13 -0500",
"subject": "Redact authentication header when throwing S3 errors.",
"body": "The authentication header contains the access key (not the secret key) so don't include it in errors that can be seen at any log level."
},
{
"commit": "cc6447356ef436582fdd3501311cb8da0f4f0342",
"date": "2018-12-05 09:15:45 -0500",
"subject": "Fix test binary name for gprof.",
"body": "This got missed in 1f8931f7 when the test binary was renamed.\n\nAlso output call graph along with the flat report. The flat report is generally most useful but it doesn't hurt to have both."
},
{
"commit": "33fa2ede7d106db6bf95712747bd0a8ed52f1be5",
"date": "2018-12-05 07:12:28 -0500",
"subject": "Add Centos/RHEL 7 option to documentation build.",
"body": "Centos/RHEL 7 builds can be specified with --var=os-type=centos7.\n\nAlso added to the documentation release and CI builds."
},
{
"commit": "baeff9e4f04c7f86f9cbe84efaf4dc66b3a4add4",
"date": "2018-12-04 17:33:56 -0500",
"subject": "Create common if expressions for testing os-type.",
"body": "These expressions simplify os-type testing. This will be especially true as more OS types are added."
},
{
"commit": "9e217d02564d30bcdcb865f87323221aa2969169",
"date": "2018-12-04 13:17:55 -0500",
"subject": "Documentation may be built with user-specified packages.",
"body": "By default the documentation builds pgBackRest from source, but the documentation is also a good way to smoke-test packages.\n\nAllow a package file to be specified by passing --var=package=/path/to/package.ext. This works for Debian and CentOS 6 builds."
},
{
"commit": "0db030fa63b74fb6e0a8ad58f1417e39cd1eac9e",
"date": "2018-12-04 11:46:25 -0500",
"subject": "Add coding standards for String constants."
},
{
"commit": "14190f9e6c290383676a4332ff5c71e9cc83c66a",
"date": "2018-12-03 12:41:53 -0500",
"subject": "Update URL for Docker install.",
"body": "As usual the old URL started providing a broken version of Docker rather than producing a clear error message. This happens once a year or so."
},
{
"commit": "17e611cb883b6086a802c2adfbda384817feaa09",
"date": "2018-12-01 12:40:01 -0500",
"subject": "Replace keywords with more flexible if statements.",
"body": "Keywords were extremely limited and prevented us from generating multi-version documentation and other improvements.\n\nReplace keywords with an if statement that can evaluate a Perl expression with variable replacement.\n\nSince keywords were used to generate cache keys, add a --key-var parameter to identify which variables should make up the key."
},
{
"commit": "47490ba9600c25f75a9d833d9a42da3633257751",
"date": "2018-11-30 18:47:42 -0500",
"subject": "Fix comment typo.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "977506b44615cc9d9d9c581ffd0fd407b7d174d8",
"date": "2018-11-30 11:15:52 -0500",
"subject": "Clarify that region/endpoint must be configured correctly for the bucket.",
"body": "Suggested by Pritam Barhate."
},
{
"commit": "64b97fd7ca3410cd6bca3c01bc438bb104191f78",
"date": "2018-11-30 10:55:29 -0500",
"subject": "Correct archive-get-queue-max to be size type.",
"body": "This somehow was not configured as a size option when it was added. It worked, but queue sizes could not be specified in shorthand, e.g. 128GB.\n\nThis is not a breaking change because currently configured integer values will be read as bytes."
},
{
"commit": "1ad67644dade53595e2f210d0f75cc247b3ea2a5",
"date": "2018-11-30 10:38:02 -0500",
"subject": "Remove request for S3 object info directly after putting it.",
"body": "After a file is copied during backup the size is requested from the storage in case it differs from what was written so that repo-size can be reported accurately. This is useful for situations where compression is being done by the filesystem (e.g. ZFS) and what is stored can differ in size from what was written.\n\nIn S3 the reported size will always be exactly what was written so there is no need to check the size and doing so immediately can cause problems because the new file might not appear in list commands. This has not been observed on S3 (though it seems to be possible) but it has been reported on the Swift S3 gateway.\n\nAdd a driver capability to determine if size needs to be called after a file is written and if not then simply use the number of bytes written for repo-size."
},
{
"commit": "5d3c8e47f14c9f497866a899bed7d6e25f0fb67f",
"date": "2018-11-29 14:45:15 -0500",
"subject": "Pre-build containers for any execute elements marked pre.",
"body": "This allows the documentation to be built more quickly and offline during development when --pre is specified on the command line.\n\nEach host gets a pre-built container with all the execute elements marked pre. As long as the pre elements do not change the container will not need to be rebuilt.\n\nThe feature should not be used for CI builds as it may hide errors in the documentation."
},
{
"commit": "74b72df9dbfbfb00d5b729cb83bef35e77fd73c6",
"date": "2018-11-28 18:41:21 -0500",
"subject": "Improve error message when info files are missing/corrupt.",
"body": "The previous error message only showed the last error. In addition, some errors were missed (such as directory permission errors) that could prevent the copy from being checked.\n\nShow both errors below a generic \"unable to load\" error. Details are now given explaining exactly why the primary and copy failed.\n\nPreviously if one file could not be loaded a warning would be output. This has been removed because it is not clear what the user should do in this case. Should they do a stanza-create --force? Maybe the best idea is to automatically repair the corrupt file, but on the other hand that might just spread corruption if pgBackRest makes the wrong choice."
},
{
"commit": "47687dd13a24a49409f07b99141b508739228791",
"date": "2018-11-28 18:10:54 -0500",
"subject": "Add xmlNodeAttribute() to XmlNode object.",
"body": "Retrieves a node attribute unless it is the root node."
},
{
"commit": "7c2fcb63e4ab62e880ebca935fb67e25fa03d5b3",
"date": "2018-11-28 14:56:26 -0500",
"subject": "Enable encryption for archive-get command in C.",
"body": "The decryption filter was added in archiveGetFile() and archiveGetCheck() was modified to return the WAL decryption key stored in archive.info. The rest was plumbing.\n\nThe mock/archive/1 integration test added encryption to provide coverage for the new code paths while mock/archive/2 dropped encryption to provide coverage for the existing code paths. This caused some churn in the expect logs but there was no change in behavior."
},
{
"commit": "6c23830991558d74ecade1d510fbd50acf5b0f18",
"date": "2018-11-28 14:41:10 -0500",
"subject": "Add encryption capability to Info* objects.",
"body": "Info objects can be stored encrypted and loaded with a cipher type and passphrase."
},
{
"commit": "410a04a58ee59de3055483a2f971c2e42015267e",
"date": "2018-11-28 14:20:12 -0500",
"subject": "Allow arbitrary InOut filters to be chained in IoFilterGroup.",
"body": "If InOut filters were placed next to each other then the second filter would never get a NULL input signaling it to flush. This arrangement only worked if the second filter had some other indication that it should flush, such as a decompression filter where the flush is indicated in the input stream.\n\nThis is not a live issue because currently no InOut filters are chained together."
},
{
"commit": "838cfa44b76ed885f030ebf75649df7eaace6593",
"date": "2018-11-28 14:02:14 -0500",
"subject": "Allow arbitrary multiplier and flush character in IoTestFilterMultiply.",
"body": "This allows for more complex test filter chains.\n\nRename from IoTestFilterDouble to reflect the new functionality."
},
{
"commit": "3e254f4cff349f2de95b557b77e3bb0baa1450c9",
"date": "2018-11-28 12:42:36 -0500",
"subject": "Add IoFilter interface to CipherBlock object.",
"body": "This allows CipherBlock to be used as a filter in an IoFilterGroup. The C-style functions used by Perl are now deprecated and should not be used for any new code.\n\nAlso add functions to convert between cipher names and CipherType."
},
{
"commit": "c3a84ccae08cf7506f26a000344ea1ba2517f9a8",
"date": "2018-11-28 12:03:27 -0500",
"subject": "Merge cipher.h into crypto.h.",
"body": "There is not enough in cipher.h to make it worth having a separate header."
},
{
"commit": "7df7cf6e6d1e04fef41ba37cb13020ada6bf4b22",
"date": "2018-11-27 22:49:24 -0500",
"subject": "Rename cipherBlock*() functions to cipherBlock*C().",
"body": "Some of the old names conflict with the new functions that must be created to implement the filter. Rename these to cipherBlock*C() to indicate that they take C-style parameters.\n\nThese functions are only used by the Perl LibC code and will be removed or refactored eventually."
},
{
"commit": "fea27dbd7eb4ea72a8c792628bba6ed849f68c08",
"date": "2018-11-27 22:02:08 -0500",
"subject": "Return IoFilterGroup * from ioFilterGroupAdd().",
"body": "This allows filters adds to be chained."
},
{
"commit": "56ce98b2f0710b77e9df720722d200add670238e",
"date": "2018-11-25 10:06:31 -0500",
"subject": "Explicitly compile with Posix 2001 standard.",
"body": "This standard was being selectively applied in modules that needed it.\n\nInstead, apply the standard to all compilation for consistency."
},
{
"commit": "315aa2c4512c2789889d68d1253366c5c75d405b",
"date": "2018-11-25 08:39:41 -0500",
"subject": "Conditional compilation of Perl logic in exit.c.",
"body": "This file is the only one to contain Perl logic outside of the perl module. Make the Perl logic conditional to improve reusability."
},
{
"commit": "78fe642eaeae4f7f73796fdc45b5c2a81e9f3e9f",
"date": "2018-11-24 20:31:35 -0500",
"subject": "Remove extraneous use/include statements.",
"body": "Use conditional loading to make docs work in the absence of LibC.\n\nSomehow this also required a use statement to be added. Perl, go figure."
},
{
"commit": "801e2a5a2ce14f6ef447526c646f0c641c94efa2",
"date": "2018-11-24 19:05:03 -0500",
"subject": "Rename PGBACKREST/BACKREST constants to PROJECT.",
"body": "This brings consistency between the C and Perl constants and allows for easier code reuse."
},
{
"commit": "7a1a68883546bbfa0b24fc65054b0a7bf4f09b66",
"date": "2018-11-24 09:12:44 -0500",
"subject": "Add EOF detection to content read in HttpClient.",
"body": "If the connection closed before all content was sent httpClientRead() would get stuck in an infinite loop waiting for it to arrive.\n\nEOF should never be reached during content read so immediately error if EOF is detected."
},
{
"commit": "f4a1751abc9b42d03e0d041fa386a879beb3ee5b",
"date": "2018-11-23 16:02:33 -0500",
"subject": "Improve JSON to Variant conversion and add Variant to JSON conversion.",
"body": "Add boolean and one-dimensional list types to jsonToKv().\n\nAdd varToJson() and kvToJson() to convert Variants and KeyValues to JSON."
},
{
"commit": "e641c130d30706755775ee328637e3be9d6dba55",
"date": "2018-11-23 12:19:56 -0500",
"subject": "Fix release note typo."
},
{
"commit": "beae37533041e63a71b33757e4df933e197e575f",
"date": "2018-11-23 12:18:07 -0500",
"subject": "Enable S3 storage for archive-get command in C.",
"body": "The only change required was to remove the filter that prevented S3 storage from being used. The archive-get command did not require any modification which demonstrates that the storage interface is working as intended.\n\nThe mock/archive/3 integration test was modified to run S3 storage locally to provide coverage for the new code paths while mock/stanza/3 was modified to run S3 storage remotely to provide coverage for the existing code paths. This caused some churn in the expect logs but there was no change in behavior."
},
{
"commit": "b5690e21a4ad453f004087adf434adf13d109a8c",
"date": "2018-11-23 12:01:36 -0500",
"subject": "Allow I/O read interface to explicitly request blocking reads.",
"body": "TlsClient introduced a non-blocking read which is required to read protocol messages that are linefeed-terminated rather than a known size. However, in many cases the expected number of bytes is known in advance so in that case it is more efficient to have tlsClientRead() block until all the bytes are read.\n\nAdd block parameter to all read functions and use it when a blocking read is required. For most read functions this is a noop, i.e. if the read function never blocks then it can ignore the parameter.\n\nIn passing, set the log level of storageNew*() functions to debug to expose more high-level I/O operations."
},
{
"commit": "256b727a3d13b680ab2a4c7b3669649c857d1daf",
"date": "2018-11-21 19:32:49 -0500",
"subject": "Add S3 storage driver.",
"body": "Only the storageNewRead() and storageList() functions are currently implemented, but this is enough to enable S3 for the archive-get command."
},
{
"commit": "72252ed2a102bf9c43d45500de1a29834d36721c",
"date": "2018-11-21 19:11:45 -0500",
"subject": "Add HttpClient object.",
"body": "A robust HTTP client with connection reuse and automatic retries.\n\nUsing a single object to make multiple requests is more efficient because connections are reused whenever possible. Requests are automatically retried when the connection has been closed by the server. Any 5xx response is also retried.\n\nOnly the HTTPS protocol is currently supported."
},
{
"commit": "1dd06a6e460049ff888e152f33697b1e49046c30",
"date": "2018-11-21 18:43:25 -0500",
"subject": "Add TlsClient object.",
"body": "A simple, secure TLS client intended to allow access to services that are exposed via HTTPS. We call it TLS instead of SSL because SSL methods are disabled so only TLS connections are allowed.\n\nThis object is intended to be used for multiple TLS connections against a service so tlsClientOpen() can be called each time a new connection is needed. By default, an open connection will be reused so the user must be prepared to retry their transaction on a read/write error if the server closes the connection before it can be reused. If this behavior is not desirable then tlsClientClose() may be used to ensure that the next call to tlsClientOpen() will create a new TLS session.\n\nNote that tlsClientRead() is non-blocking unless there are *zero* bytes to be read from the session in which case it will raise an error after the defined timeout. In any case the tlsClientRead()/tlsClientWrite()/tlsClientEof() functions should not generally be called directly. Instead use the read/write interfaces available from tlsClientIoRead()/tlsClientIoWrite()."
},
{
"commit": "ac426bc456425d68e33a7facc8393f26b9d17bb1",
"date": "2018-11-21 18:13:37 -0500",
"subject": "New test containers with static test certificates.",
"body": "Test certificates were generated dynamically but there are advantages to using static certificates. For example, it possible to use the same certificate between container versions. Mostly, it is easier to document the certificates if they are not buried deep in the container code.\n\nThe new test certificates are initially intended to be used with the C unit tests but they will eventually be used for integration tests as well.\n\nTwo new certificates have been defined. See test/certificate/README.md for details.\n\nThe old dynamic certificates will be retained until they are replaced."
},
{
"commit": "53e3651ccaaaa1652f53903534974377a2808aec",
"date": "2018-11-21 08:30:14 -0500",
"subject": "Remove embedded semicolon from String constant macros.",
"body": "The embedded semicolon led to inconsistent semicolons when using the macro and is not our general convention.\n\nRemove embedded semicolons from the macros and add semicolons in usage where they were not present."
},
{
"commit": "bc25db5667b3b05ba47c547591717ee9627f650c",
"date": "2018-11-20 20:40:11 -0500",
"subject": "Add interface objects for libxml2.",
"body": "Add XmlDocument, XmlNode, and XmlNodeList objects as a thin interface layer on libxml2.\n\nThis interface is not intended to be comprehensive. Only a few libxml2 capabilities are exposed but more can be added as needed."
},
{
"commit": "6680130c6f5553e6d0c587dccc57b4a8508c4ab1",
"date": "2018-11-20 19:24:53 -0500",
"subject": "Require S3 key options except for local/remote commands.",
"body": "S3 key options (repo1-s3-key/repo1-s3-key-secret) were not required which meant that users got an ugly assertion when they were missing rather than a tidy configuration error.\n\nOnly the local/remote commands need them to be optional. This is because local/remote commands get all their options from the command line but secrets cannot be passed on the command line. Instead, secrets are passed to the local/remote commands via the protocol for any operation that needs them.\n\nThe configuration system allows required to be set per command so use that to improve the error messages while not breaking the local/remote commands."
},
{
"commit": "f743d4e92418d73717225599e3dbd03a4af7dec9",
"date": "2018-11-20 15:48:56 -0500",
"subject": "Add testRepoPath() to let C unit tests know where the code repository is located.",
"body": "This allows a C unit test to access data in the code repository that might be useful for testing.\n\nAdd testRepoPathSet() to set the repository path.\n\nIn passing remove extra whitespace in the TEST_RESULT_VOID() macro."
},
{
"commit": "b0659278cc7ab45519d791c10edbb494024f5148",
"date": "2018-11-16 17:22:22 -0500",
"subject": "Add ServiceError for errors from a service that can be retried.",
"body": "An example is HTTP 5xx errors which should mostly be retried."
},
{
"commit": "3aa4fda573d95839d617c65880a240d4093951b7",
"date": "2018-11-16 16:17:24 -0500",
"subject": "Add missing LOG_DEBUG() macro."
},
{
"commit": "d0e553e4c2a024be44a92dfa5eb0ce77330bcef7",
"date": "2018-11-16 16:05:06 -0500",
"subject": "Reduce debug level for infoIni() to test.",
"body": "Getters should generally not be logging at debug or trace level since it clutters the log.\n\nIn passing move the destructor to the end of the file."
},
{
"commit": "6532912d51050df4587ec54eee567e37fcb8b74e",
"date": "2018-11-16 10:04:14 -0500",
"subject": "Begin v2.08 development."
},
{
"commit": "04d9e4d5a88512707c350e3885e359d53c3ca36b",
"date": "2018-11-16 09:50:50 -0500",
"subject": "v2.07: Automatic Backup Checksum Delta"
},
{
"commit": "332a68ea8d713f24d1db08e20d5b95bcf32cc74e",
"date": "2018-11-16 08:48:02 -0500",
"subject": "Fix incorrect config constant introduced in 5e3b7cbe.",
"body": "This commit introduced PGBACKREST_CONFIG_ORIG_PATH_FILE_STR as a String constant for PGBACKREST_CONFIG_ORIG_PATH_FILE but failed to get the value correct.\n\nAlso, no test was added for PGBACKREST_CONFIG_ORIG_PATH_FILE_STR to prevent regressions as there is for PGBACKREST_CONFIG_ORIG_PATH_FILE."
},
{
"commit": "75f6e45de26cf4ab087dc791f2aa177553584472",
"date": "2018-11-15 16:31:46 -0500",
"subject": "Add \\n, \\r, and 0 String constants."
},
{
"commit": "b6f7cbc31531b6e88a89ecfe9c8d3ebc1e682d2e",
"date": "2018-11-15 16:25:46 -0500",
"subject": "Add destructors to IoRead and IoWrite objects.",
"body": "These interfaces previously used the memory context of the object they were associated with and did not have their own destructors.\n\nThere are times when it is useful to free the interface without also freeing the underlying object so give IoRead and IoWrite their own memory contexts and destructors.\n\nIn passing fix a comment type in bufferRead.c."
},
{
"commit": "480e1da7986a278a3b5c8aca965e539d383da9cc",
"date": "2018-11-14 08:53:42 -0500",
"subject": "Add ioWriteFlush() to flush pending output.",
"body": "By default the IoWrite object does not write until the output buffer is full but this is a problem for protocol messages that must be sent in order to get a response.\n\nioWriteFlush() is not called internally by IoWrite but can be used at any time to immediately write all bytes from the output buffer without closing the IoWrite object."
},
{
"commit": "7918629f5931b2eeca316d8b37191718db4650f4",
"date": "2018-11-14 08:16:53 -0500",
"subject": "Modify value of PERL_EMBED_ERROR macro.",
"body": "Remove !!! which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "504e7d77faeecd213df99ec320246e10a526f9ad",
"date": "2018-11-14 08:13:01 -0500",
"subject": "Add comment regarding vars being required in blocks.",
"body": "Documentation block syntax requires that at least one var be specified.\n\nThis limitation should be removed but for now add a comment to describe why a bogus var is defined."
},
{
"commit": "14d2f8b86c4fd3755af6cd9f5210cf1e34e8d090",
"date": "2018-11-14 08:11:11 -0500",
"subject": "Reword misleading message in stack trace when parameter buffer is full.",
"body": "The prior message stated that there had been a buffer overrun which is not true since the code prevents that.\n\nIn fact, this message means the parameter buffer filled while building the parameter list. Rather than display a partial list we output this message instead.\n\nAlso remove !!! which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "8c7e97a369a145f2d71856f2ff2ed734452a9040",
"date": "2018-11-14 08:08:26 -0500",
"subject": "Clarify comment about main.c being excluded from unit testing.",
"body": "Also remove !!! which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "73102034913ec2e3ca1b1cc485f8ce04820bba27",
"date": "2018-11-14 07:42:28 -0500",
"subject": "Remove obsolete comments."
},
{
"commit": "a0b2af567a8b6893c6e9b7f3b9a73acd4496332e",
"date": "2018-11-13 20:58:32 -0500",
"subject": "Add TEST_LOG() and TEST_LOG_FMT() macros.",
"body": "These macros provide a convenient way to output debug information in tests.\n\nThey are not intended to be left in test code when it is committed to master."
},
{
"commit": "a582ad837f9ada7b924d6c0a23580f88c495ce2e",
"date": "2018-11-13 20:43:08 -0500",
"subject": "Add logging macros for TimeMSec type."
},
{
"commit": "acb579c4698f856e4c1ceedca751aaeadc9d2d3f",
"date": "2018-11-13 10:37:58 -0500",
"subject": "Tighten limits on code coverage context selection.",
"body": "If the last } of a function was marked as uncovered then the context selection would overrun into the next function.\n\nStart checking context on the current line to prevent this. Make the same change for start context even though it doesn't seem to have an issue."
},
{
"commit": "086bc35ddc71b008a5d20f8e5e3d0305508dfdf5",
"date": "2018-11-12 21:18:53 -0500",
"subject": "Make ioReadLine() read less aggressively.",
"body": "ioReadLine() calls ioRead(), which aggressively tries to fill the output buffer, but this doesn't play well with blocking reads.\n\nGive ioReadLine() an option that tells it to read only what is available. That doesn't mean the function will never block but at least it won't do so by reading too far."
},
{
"commit": "bc810e5a87176ee68491e79473325a8a411a34c9",
"date": "2018-11-12 20:44:56 -0500",
"subject": "Remove error suppression for pgBackRest make.",
"body": "This looks like a copy-pasto because make works just fine without it."
},
{
"commit": "a2672557f80da95d6103d49e307321568285e5d6",
"date": "2018-11-12 20:00:57 -0500",
"subject": "Allow storage path and file mode to be 0.",
"body": "Not all storage drivers support Posix-style permissions, e.g. S3."
},
{
"commit": "7107cc68d23f344e7b13206eaec506a039a00350",
"date": "2018-11-12 18:11:16 -0500",
"subject": "Expand context shown in coverage and update colors.",
"body": "Too few lines were shown for coverage context so show the entire function if it has any missing coverage.\n\nUpdate colors to work with light and dark browser modes."
},
{
"commit": "0ba2292a29fcef873991098cc48b488580fbb713",
"date": "2018-11-12 14:23:42 -0500",
"subject": "Add EMPTY_STR to String object."
},
{
"commit": "aff9693e640c8a0b76e46f31d4fa569fd7d63289",
"date": "2018-11-12 14:13:55 -0500",
"subject": "Add strEmpty() to String object.",
"body": "strEmpty() is more concise and explanatory than strSize() == 0."
},
{
"commit": "38c5f657704c4c6899a0bf86bbce5fd332d97971",
"date": "2018-11-11 18:12:43 -0500",
"subject": "Use THROW_ON_SYS_ERROR macro to improve fork code coverage.",
"body": "Lack of code coverage in this module is just noise since these functions cannot generally be made to fail.\n\nAny failures are fatal."
},
{
"commit": "72ea47bfb341ff78f2582607e27e7b7df2ac25f8",
"date": "2018-11-11 18:07:56 -0500",
"subject": "Add KernelError to report miscellaneous kernel errors."
},
{
"commit": "257df96b12f38cba45751449dcd64ca712dd96c2",
"date": "2018-11-11 18:06:09 -0500",
"subject": "Add THROW*_ON_SYS_ERROR* macros to test and throw system errors.",
"body": "These macros check the error result internally and are appropriate for system calls that won't return errors and so break coverage."
},
{
"commit": "22ecbc153a447b4f635fad2ab71fdd92ed8294bc",
"date": "2018-11-11 17:32:42 -0500",
"subject": "New, concise coverage report for C.",
"body": "The report HTML generated by lcov is overly verbose and cumbersome to navigate. Since we maintain 100% coverage it's far more interesting to look at what is not covered than what is.\n\nThe new report presents all missing coverage on a single page and excludes code that is covered for brevity."
},
{
"commit": "3cd43fd60cd46430f86084f37b6ed874124e2848",
"date": "2018-11-11 16:34:15 -0500",
"subject": "Add new HTML tags and strExtra to DocHtmlElement.",
"body": "Add HTML tags for table elements.\n\nThe strExtra parameter allows adhoc tags to be added to an element for features that can't be implemented with CSS, e.g. colspan."
},
{
"commit": "5e3b7cbe6ee7a409ad6e311668eb764fee82939c",
"date": "2018-11-10 18:32:49 -0500",
"subject": "Apply String constant macros where appropriate.",
"body": "This may not be all the places where the macros can be useful but it's a good start."
},
{
"commit": "8f857a975e22d6a7c0e99a494169f24ed50b6c06",
"date": "2018-11-10 09:37:12 -0500",
"subject": "Add constant macros to String object.",
"body": "There are many places (and the number is growing) where a zero-terminated string constant must be transformed into a String object to be usable. This pattern wastes time and memory, especially since the created string is generally used in a read-only fashion.\n\nDefine macros to create constant String objects that are initialized at compile time rather than at run time."
},
{
"commit": "df200bee2acf614edf9d008cccde67f02d89f103",
"date": "2018-11-09 16:50:22 -0500",
"subject": "Add regExpPrefix() to aid in static prefix searches.",
"body": "The storageList() command accepts a regular expression as a filter. This works fine for local filesystems where it is relatively cheap to get a complete list of files and filter them in code. However, for remote filesystems like S3 it can be expensive to fetch a complete list of files only to discard the bulk of them locally.\n\nS3 does not filter on regular expressions but it can accept a static prefix so this function extracts a prefix from a regular expression when possible.\n\nEven a few characters can drastically reduce the amount of data that must be fetched remotely so the function does not try to be too clever. It requires a ^ anchor and stops scanning when the first special character is found."
},
{
"commit": "8c504bd2f9e6c14f134b6115f469ec3fe064cb73",
"date": "2018-11-09 10:37:59 -0500",
"subject": "Improve alignment of expected vs. got error test results.",
"body": "It is easier to compare the error messages when they start at the same column."
},
{
"commit": "b5a3c8c84b789558d11d67199fbcc4029721d939",
"date": "2018-11-09 09:54:55 -0500",
"subject": "Add strCatChr() to String object."
},
{
"commit": "3e695af9614e61f72e9f0d7c3dc729cc5a27f3eb",
"date": "2018-11-08 21:41:41 -0500",
"subject": "New test containers.",
"body": "* Add libxml2 library needed for S3 development.\n* Minor version updates for PostgreSQL.\n* Remove PostgreSQL 11 beta/rc repository."
},
{
"commit": "7cf1f42c5c65deed8ad0bdb86a33d273438fe9a0",
"date": "2018-11-08 19:50:31 -0500",
"subject": "Add time since the beginning of the run to each test statement.",
"body": "Output the time in seconds of each test statement since the start of the test run.\n\nThis helps find individual tests that are running slowly."
},
{
"commit": "2150a26424cacc80ded57697b67af1e3c2a47211",
"date": "2018-11-08 18:03:18 -0500",
"subject": "Storage interface methods no longer declare the driver as const.",
"body": "This works for the Posix driver but is bad for more dynamic drivers (e.g. S3) that need write access to the driver object."
},
{
"commit": "12b3be1d8ed38beea67c4d4de582af9039c5bd4b",
"date": "2018-11-08 16:48:33 -0500",
"subject": "Limit usable Buffer size without changing allocated size.",
"body": "Allow buffers to report a lower size than their allocated size. This means a larger buffer can be used to do the work of a smaller buffer without having to create a new buffer and concatenate.\n\nThis is useful for blocking I/O where the buffer may be too large for the amount of data that is available to read."
},
{
"commit": "edb2c6eb26ca77eb3e3e05c006f3036dee2865b7",
"date": "2018-11-08 08:37:57 -0500",
"subject": "Construct Wait object in milliseconds instead of fractional seconds.",
"body": "The Wait object accepted a double in the constructor for wait time but used TimeMSec internally. This was done for compatibility with the Perl code.\n\nInstead, use TimeMSec in the Wait constructor and make changes as needed to calling code.\n\nNote that Perl still uses a double for its Wait object so translation is needed in some places. There are no plans to update the Perl code as it will become obsolete."
},
{
"commit": "a9feaba9e521e39928ff5fdbc025eeff8fc17646",
"date": "2018-11-07 08:51:32 -0500",
"subject": "Add memContextCallbackClear() to prevent double free() calls.",
"body": "If an object free() method was called manually when a callback was set then the callback would call free() again. This meant that each free() method had to protect against a subsequent call.\n\nInstead, clear the callback (if present) before calling memContextFree(). This is faster (since there is no unnecessary callback) and removes the need for semaphores to protect against a double free()."
},
{
"commit": "48d2795f312224f03dc88e99434865540ca71c7e",
"date": "2018-11-06 20:04:16 -0500",
"subject": "Merge crypto/random module into crypto/crypto.",
"body": "There wasn't enough code to justify a separate module/test and it seems to fit just fine in crypto/crypto."
},
{
"commit": "8efa5e6a6af848a2a9d3e4c3260084d259949ee5",
"date": "2018-11-06 19:38:38 -0500",
"subject": "Rename CipherError to CryptoError.",
"body": "This aligns with the general renaming from cipher to crypto."
},
{
"commit": "2cb312ef5aa9f57da607229f9fe22ce5d7aa0352",
"date": "2018-11-06 19:16:00 -0500",
"subject": "Add cryptoError() and update crypto code to use it.",
"body": "This adds detail to error messages when available and improves code coverage."
},
{
"commit": "bef31f1802f231ce7b6ab06371148b74eb9eb6ab",
"date": "2018-11-06 18:32:44 -0500",
"subject": "Add base variants to all integer to string conversion functions.",
"body": "Previously these functions were fixed at base 10 conversion. Add variants that can convert from any base."
},
{
"commit": "7de9584435839f8e7b20e8f336820b84a70cafd8",
"date": "2018-11-04 08:39:48 -0500",
"subject": "Ignore deleted files in rsync to test/repo.",
"body": "Deleted files are showing up in git ls-files (added 57d78092) but they don't actually exist on disk.\n\nIf there is someway to exclude deleted files from ls-files then I can't find it, so just tell rsync to ignore missing files."
},
{
"commit": "57d780929741e3d09f60b252a26ad12fb645254e",
"date": "2018-11-03 19:52:46 -0400",
"subject": "Improve efficiency of code generation.",
"body": "Code generation saved files even when they had not changed, which often caused code generation cascades. So, don't save files unless they have changed.\n\nUse rsync to determine which files have changed since the last test run. The manifest of changed files is saved and not removed until all code generation and builds have completed. If an error occurs the work will be redone on the next run.\n\nThe eventual goal is to do all the builds from the test/repo directory created by rsync but for now it is only used to track changes."
},
{
"commit": "1f8931f73274163f27ba38aea378ea50488ba557",
"date": "2018-11-03 16:34:04 -0400",
"subject": "Improve single test run performance.",
"body": "Improve on 7794ab50 by including the build flag files directly into the Makefile as dependencies (even though they are not includes). This simplifies some of the rsync logic and allows make to do what it does best.\n\nAlso split build flag files into test, harness, and build to reduce rebuilds. Test flags are used to build test.c, harness flags are used to build the rest of the files in the test harness, and build flags are used for the files that are not directly involved in testing."
},
{
"commit": "7794ab50dc839088fc1e1137edaaf65354faa76a",
"date": "2018-11-02 11:56:13 -0400",
"subject": "Preserve contents of C unit test build directory between test.pl executions.",
"body": "The contents were already preserved between tests in a single test.pl run but for a separate execution the entire project had to be built from scratch, which was getting slower as we added code.\n\nSave the important build flags in a file so the new execution knows whether the build contents can be reused."
},
{
"commit": "1a98bd41b48b2619b318639faeeb688481dbc07e",
"date": "2018-11-02 08:37:27 -0400",
"subject": "Mount tmpfs in Vagrantfile instead test.pl.",
"body": "Mounting/unmounting tmpfs on /home/[user]/test takes time, forces at least 3GB of memory to be available for tests, and makes it harder to preserve data between tests.\n\nInstead, move mounting of tmpfs to the Vagrantfile and add it to fstab so it survives reboots."
},
{
"commit": "34c63276cd26cd5310169343bb8e17e323feef95",
"date": "2018-11-01 11:31:25 -0400",
"subject": "Automatically enable backup checksum delta when anomalies (e.g. timeline switch) are detected.",
"body": "There are a number of cases where a checksum delta is more appropriate than the default time-based delta:\n\n* Timeline has switched since the prior backup\n* File timestamp is older than recorded in the prior backup\n* File size changed but timestamp did not\n* File timestamp is in the future compared to the start of the backup\n* Online option has changed since the prior backup\n\nA practical example is that checksum delta will be enabled after a failover to standby due to the timeline switch. In this case, timestamps can't be trusted and our recommendation has been to run a full backup, which can impact the retention schedule and requires manual intervention.\n\nNow, a checksum delta will be performed if the backup type is incr/diff. This means more CPU will be used during the backup but the backup size will be smaller and the retention schedule will not be impacted."
},
{
"commit": "cca7a4ffd477871d5eab323f1a5f621fbe48a568",
"date": "2018-10-30 16:45:42 -0400",
"subject": "Retry all S3 5xx errors rather than just 500 internal errors.",
"body": "We were already retrying 500 errors but 503 (rate-limiting) errors were not being retried and would cause an instant failure which aborted the command.\n\nThere are only two 5xx errors currently implemented by S3 but instead of adding 503 simply retry all 5xx errors. This is consistent with the http definition of this error class, \"the server failed to fulfill an apparently valid request.\""
},
{
"commit": "286f7e501154a05d147d146d25e3dd0ea0d49d5c",
"date": "2018-10-27 20:00:00 +0100",
"subject": "Fix static WAL segment size used to determine if archive-push-queue-max has been exceeded.",
"body": "This calculation was missed when the WAL segment size was made dynamic in preparation for PostgreSQL 11.\n\nFix the calculation by checking the actual WAL file sizes instead of using an estimate based on WAL segment size. This is more accurate because it takes into account .history and .backup files, which are smaller. Since the calculation is done in the async process the additional processing time should not adversely affect performance.\n\nRemove the PG_WAL_SIZE constant and instead use local constants where the old value is still required. This is only the case for some tests and PostgreSQL 8.3 which does not provide a way to get the WAL segment size from pg_control."
},
{
"commit": "41b00dc204a04a87b337aa5bebe7cfd4032d5eae",
"date": "2018-10-27 16:57:57 +0100",
"subject": "Fix issue with archive-push-queue-max not being honored on connection error.",
"body": "If an error occurred while acquiring a lock on a remote server the error would be reported correctly, but the queue max detection code was not reached. The tests failed to detect this because they fixed the connection before queue max, allowing the ccde to be reached.\n\nMove the queue max code before the lock so it will run even when remote connections are not working. This means that no attempt will be made to transfer WAL once queue max has been exceeded, but it makes it much more likely that the code will be reach without error.\n\nUpdate tests to continue errors up to the point where queue max is exceeded."
},
{
"commit": "03b9db9aa2e84bf6b23af8331712d1480520ca19",
"date": "2018-10-25 14:58:25 +0100",
"subject": "Fix error after log file open failure when processing should continue.",
"body": "The C code was warning on failure and continuing but the Perl logging code was never updated with the same feature.\n\nRather than add the feature to Perl, just disable file logging if the log file cannot be opened. Log files are always opened by C first, so this will eliminate the error in Perl."
},
{
"commit": "d301720c58145910189829e8b2ceacccd3543c1e",
"date": "2018-10-25 10:48:37 +0100",
"subject": "Change infoArchiveCheckPg() to display the PostgreSQL version as a string in errors.",
"body": "Previously an integer representation (e.g. 90400) would be displayed which is correct but not as friendly to the user."
},
{
"commit": "5590bfa84c0a91d1e93ed03441e12c4dab1078c5",
"date": "2018-10-19 18:31:05 +0200",
"subject": "Add tests for InfoPg history fixes introduced in 070455ce.",
"body": "The existing tests were not adequate to ensure the history was being added in the correct order when some entries were loaded from a file and others added with infoPgAdd()."
},
{
"commit": "070455ce44504c63a5bf2f70093c64ed278fa12e",
"date": "2018-10-19 12:31:56 +0200",
"subject": "Correct current history item in InfoPg to always be in position 0.",
"body": "The InfoPg object was partially modified in 960ad732 to place the current history item in position 0, but infoPgDataCurrent() didn't get updated correctly.\n\nRemove this->indexCurrent and make the current position always equal 0. Use the new lstInsert() function when adding new history items via infoPgAdd(), but continue to use lstAdd() when loading from a file for efficiency.\n\nThis does not appear to be a live bug because infoPgDataCurrent() and infoPgAdd() are not yet used in any production code. The archive-get command is the only C code using InfoPG and it always looks at the entire list of items rather than just the current item."
},
{
"commit": "f345db3f7ca15480c5aa70d015150b399f3ce33a",
"date": "2018-10-19 11:52:17 +0200",
"subject": "Add lstInsert() to List object.",
"body": "Add general purpose insert function and make lstAdd() a special insert case."
},
{
"commit": "09a1ad2c10fa17e165b88731322f4dcf8de73ecc",
"date": "2018-10-19 10:51:33 +0200",
"subject": "Correct cfgDefDataFind() to use UINTP instead of VOIDPP.",
"body": "Also add the UINTP macro."
},
{
"commit": "06d68eada00e6ec57c662aa9ad2bacdc86eb5861",
"date": "2018-10-16 17:21:01 +0100",
"subject": "Begin v2.07 development."
},
{
"commit": "904550c97f674d3f576d3113756f2b5c89b55ddf",
"date": "2018-10-16 14:56:51 +0100",
"subject": "v2.06: Checksum Delta Backup and PostgreSQL 11 Support"
},
{
"commit": "2c272c220b39739ff324305593034487df81b466",
"date": "2018-10-15 23:23:49 +0100",
"subject": "PostgreSQL 11 support.",
"body": "PostgreSQL 11 RC1 support was tested in 9ae3d8c46 when the u18 container was rebuilt. Nothing substantive changed after RC1 so pgBackRest is ready for PostgreSQL 11 GA."
},
{
"commit": "9ae3d8c46ac10273ca53c942410f768e27395230",
"date": "2018-10-15 23:13:08 +0100",
"subject": "Install nodejs from deb.nodesource.com.",
"body": "The standard npm packages on Ubuntu 18.04 suddenly required libssl1.0 which broke the pgbackrest package builds. Installing nodejs from deb.nodesource.com seems to work fine with standard libssl.\n\nThis package is required by ScalityS3 which is used for local S3 testing."
},
{
"commit": "98ff8ccc59fa1e344426f3084e0a37498e56ce12",
"date": "2018-10-09 15:08:49 +0100",
"subject": "Improve documentation in filter.h and filter.internal.h.",
"body": "When the filter interface internals were split out into a new header file the documentation was not moved as it should have been. Additionally some functions which should have been moved were left behind.\n\nMove the documentation and functions to filter.internal.h and add more documentation. Filters are a tricky subject so the more documentation the better.\n\nAlso add documentation for the user-facing filter functions in filter.h."
},
{
"commit": "68110d04b24dc633e5b5b6869924dd36a2307135",
"date": "2018-10-07 17:50:10 +0100",
"subject": "Add ioReadLine()/ioWriteLine() to IoRead/IoWrite objects.",
"body": "Allow a single linefeed-terminated line to be read or written. This is useful for various protocol implementations, including HTTP and pgBackRest's protocol.\n\nOn read the maximum line size is limited to buffer-size to prevent runaway memory usage in case a linefeed is not found. This seems fine for HTTP but we may need to revisit this decision when implementing the pgBackRest protocol. Another option would be to increase the minimum buffer size (currently 16KB)."
},
{
"commit": "db8dce7adcf277a021ad8766ab91e86fad913eff",
"date": "2018-10-02 17:54:43 +0100",
"subject": "Disable flapping archive/get unit on CentOS 6.",
"body": "This test has been flapping since 9b9396c7. It seems to be some kind of timing issue since all integration tests pass and this unit passes on all other VMs. It only happens on Travis and is not reproducible in any development environment that we have tried.\n\nFor now, disable the test since the constant flapping is causing major delays in testing and quite a bit of time has been spent trying to identify the root cause. We are actively developing these tests and hope the issue will be identified during the course of normal development.\n\nA number of improvements were made to the tests while searching for this issue. While none of them helped, it makes sense to keep the improvements."
},
{
"commit": "ed5d7a53de7cd952825e824ae507e275c4648e18",
"date": "2018-09-30 12:27:05 +0100",
"subject": "Add .gitignore to C src directory.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "3be9f2dee79c02e728e2339dd047d6990ec215c5",
"date": "2018-09-30 11:45:37 +0100",
"subject": "Avoid calling strlen() twice in bufNewZ()."
},
{
"commit": "5404628148a3039f3933607c7f63cb4620f71761",
"date": "2018-09-27 17:48:40 +0100",
"subject": "Fix incorrect error message for duplicate options in configuration files.",
"body": "Duplicating a non-multi-value option was not throwing the correct message when the option was a boolean.\n\nThe reason was that the option was being validated as a boolean before the multi-value check was being done. The validation code assumed it was operating on a string but was instead operating on a string list causing an assertion to fail.\n\nSince it's not safe to do the multi-value check so late, move it up to the command-line and configuration file parse phases instead."
},
{
"commit": "be2271f6d312e6497e98df2c792d2455afb461eb",
"date": "2018-09-27 17:24:06 +0100",
"subject": "Add cfgDefOptionMulti() to identify multi-value options.",
"body": "Previously this was done in two separate places by checking if an option was type hash or list.\n\nBad enough that it was in two places, but an upcoming bug fix will add another instance so make it a function."
},
{
"commit": "e66e68e324fb8381e0592a419b3aafdf70703b56",
"date": "2018-09-27 09:20:47 +0100",
"subject": "Add cryptoHmacOne() for HMAC support.",
"body": "There doesn't seem to be any need to implement this as a filter since current use cases (S3 authentication) work on small datasets.\n\nSo, use the single function method provided by OpenSSL for simplicity."
},
{
"commit": "6470f03fa28a72c9603d4d913ce58c7223b6cc0b",
"date": "2018-09-26 22:36:42 +0100",
"subject": "Comment fixes."
},
{
"commit": "bcca625062b4ee8394f933218e890238a75e9419",
"date": "2018-09-26 22:33:48 +0100",
"subject": "Add bufHex()to Buffer object.",
"body": "A general-purpose function for converting buffers to hex strings."
},
{
"commit": "51484a008f1172b51c2296974de7bfcd37ab24b8",
"date": "2018-09-26 18:46:52 +0100",
"subject": "Add bufNewZ() to Buffer object.",
"body": "This constructor creates a Buffer object directly from a zero-terminated string. The old way was to create a String object first, then convert that to a Buffer using bufNewStr().\n\nUpdated in all places that used the old pattern."
},
{
"commit": "d038b9a029f0c981e32a94b8b8632c356ffec7ac",
"date": "2018-09-25 10:24:42 +0100",
"subject": "Support configurable WAL segment size.",
"body": "PostgreSQL 11 introduces configurable WAL segment sizes, from 1MB to 1GB.\n\nThere are two areas that needed to be updated to support this: building the archive-get queue and checking that WAL has been archived after a backup. Both operations require the WAL segment size to properly build a list.\n\nChecking the archive after a backup is still implemented in Perl and has an active database connection, so just get the WAL segment size from the database.\n\nThe archive-get command does not have a connection to the database, so get the WAL segment size from pg_control instead. This requires a deeper inspection of pg_control than has been done in the past, so it seemed best to copy the relevant data structures from each version of PostgreSQL and build a generic interface layer to address them. While this approach is a bit verbose, it has the advantage of being relatively simple, and can easily be updated for new versions of PostgreSQL.\n\nSince the integration tests generate pg_control files for testing, teach Perl how to generate files with the correct offsets for both 32-bit and 64-bit architectures."
},
{
"commit": "c0b0b4e541fc7cc5077e7f6b9fa646e7654ca9a4",
"date": "2018-09-21 13:25:27 -0400",
"subject": "PostgreSQL 11 Beta 4 support.",
"body": "Catalog version changed for this release, so update it.\n\nAlso update and upload a new container with beta 4 installed."
},
{
"commit": "d513a46e6d9d34a28dd4b99636d6ea11d3e0dff4",
"date": "2018-09-19 18:26:12 -0400",
"subject": "Update introduction to be pithy."
},
{
"commit": "50266cc26c2c76fd155779e85c82dbed58cc2d84",
"date": "2018-09-19 16:41:20 -0400",
"subject": "Use command in authorized_hosts to improve SSH security.",
"body": "Unsecured, passwordless SSH can be a scary thing. If an attacker gains access to one system they can easily hop to other systems.\n\nAdd documentation on how to use the command parameter in authorized_keys to limit ssh to running a single command, pgbackrest. There is more that could be done for security but this likely addresses most needs.\n\nAlso change references to \"trusted ssh\" to \"passwordless ssh\" since this seems more correct."
},
{
"commit": "880fbb5e578c387e52f83c8eca1040b42f4e21a8",
"date": "2018-09-19 11:12:45 -0400",
"subject": "Add checksum delta for incremental backups.",
"body": "Use checksums rather than timestamps to determine if files have changed. This is useful in cases where the timestamps may not be trustworthy, e.g. when performing an incremental after failing over to a standby.\n\nIf checksum delta is enabled then checksums will be used for verification of resumed backups, even if they are full. Resumes have always used checksums to verify the files in the repository, enabling delta performs checksums on the database files as well.\n\nNote that the user must manually enable this feature in cases were it would be useful or just keep in enabled all the time. A future commit will address automatically enabling the feature in cases where it seems likely to be useful."
},
{
"commit": "bf0691576a56df0d662488cee19d21e924a3cecb",
"date": "2018-09-18 13:29:05 -0400",
"subject": "Allow delta option to be specified in the pgBackRest configuration file.",
"body": "This option was previously allowed on the command-line only for no particular reason that we could determine.\n\nBeing able to specify it in the config file seems like a good idea and won't change current usage."
},
{
"commit": "b6b2c915b24fdcfb64e1fe6a0c8a796da50c9fe4",
"date": "2018-09-18 11:39:48 -0400",
"subject": "Allow hashSize() to run on remote storage.",
"body": "Apparently we never needed to run this function remotely.\n\nIt will be needed by the backup checksum delta feature, so implement it now."
},
{
"commit": "052e483057e4ee55d29c229c39b92c90a9cee0af",
"date": "2018-09-18 10:18:39 -0400",
"subject": "Restore bIgnoreMissing flag in backupFile() lost in storage refactor.",
"body": "The test to make sure that some files (e.g. pg_control) do not get removed during the backup was lost during the storage refactor committed at de7fc37f.\n\nThis did not impact the integrity of the backups, but bring it back since it is a nice sanity check."
},
{
"commit": "03003562d86f7fdbab21cad9f7a7ee56c3070f93",
"date": "2018-09-17 11:45:41 -0400",
"subject": "Merge all posix storage tests into a single unit.",
"body": "As we add storage drivers it's important to keep the tests for each completely separate. Rather than have three tests for each driver, standardize on having a single test unit for each driver."
},
{
"commit": "e55d73304102145c46c32f25dbe103cd4c750d37",
"date": "2018-09-17 11:38:10 -0400",
"subject": "Add -ftree-coalesce-vars option to unit test compilation.",
"body": "This is a workaround for inefficient handling of many setjmps in gcc >= 4.9. Setjmp is used in all error handling, but in the unit tests each test macro contains an error handling block so they add up pretty quickly for large unit tests.\n\nEnabling -ftree-coalesce-vars in affected versions reduces build time and memory requirements by nearly an order of magnitude. Even so, compiles are much slower than gcc <= 4.8.\n\nWe submitted a bug for this at: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87316\nWhich was marked as a duplicate of: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=63155"
},
{
"commit": "b5f749b21cbf51e3ba9f3bc2129c337cb6ebec92",
"date": "2018-09-16 18:41:30 -0400",
"subject": "Add CIFS driver to storage helper for read-only repositories.",
"body": "For read-only repositories the Posix and CIFS drivers behave exactly the same. Since that's all we support in C right now it's valid to treat them as the same thing. An assertion has been added to remind us to add the CIFS driver before allowing the repository to be writable.\n\nMostly we want to make sure that the C code does not blow up when the repository type is CIFS."
},
{
"commit": "a6c346cb04d8977d37e52072488d89a7fb3a89b6",
"date": "2018-09-16 17:26:04 -0400",
"subject": "Clear test directory between test runs.",
"body": "Previously it was the responsibility of the individual tests to clean up after themselves. Now the test harness now does the cleanup automatically.\n\nThis means that some paths/files need to be recreated with each run but that doesn't happen very often.\n\nAn attempt has been made to remove all redundant cleanup code but it's hard to know if everything has been caught. No issues will be caused by anything that was missed, but they will continue to chew up time in the tests."
},
{
"commit": "4119ce208d1d6de2b096d0465721e93dcb981d3f",
"date": "2018-09-16 15:58:46 -0400",
"subject": "Move test expect log out of the regular test directory.",
"body": "Storing the expect log (created by common/harnessLog) in the regular test directory was not ideal. It showed up in tests and made it difficult to clear the test directory between each run.\n\nMove the expect log to a purpose-built directory one level up so it does not interfere with regular testing."
},
{
"commit": "8852622fa241836b0a6c5c08d755f2c3d990427d",
"date": "2018-09-16 15:53:19 -0400",
"subject": "Fix missing test caused by a misplaced YAML tag."
},
{
"commit": "c47fc28c8b9cba4fba60f206ec029773f60171af",
"date": "2018-09-16 14:15:21 -0400",
"subject": "Make comment blocks consistent across all tests."
},
{
"commit": "84ab787b1a7f8ca42d9b2be72a730ace852667a1",
"date": "2018-09-16 14:12:53 -0400",
"subject": "Merge protocol storage helper into storage helper.",
"body": "These are separated the same way in the Perl code where the remote storage driver is located in the Protocol module. However, in the C code the intention is to implement the remote storage driver as a regular driver in the storage layer rather than making a special case out of it.\n\nSo, merge the storage helpers. This also has the benefit of making the code a bit simpler.\n\nAlso separate storageSpool() and storageSpoolWrite() to make it clearer which operations require write access and to maintain consistency with the other storage helper functions."
},
{
"commit": "3014b05dabaa66fbb3ccfba89c79cca49905a695",
"date": "2018-09-16 13:41:49 -0400",
"subject": "Fix buffer underrun in configuration test harness.",
"body": "If the total bytes read from the expect log file was 0 then the last byte of whatever was in memory before harnessLogBuffer would be set to 0.\n\nOn 32-bit systems this expressed as the high order byte of a pointer being cleared and wackiness (in the form of segfaults) ensued."
},
{
"commit": "0c02481d6e5cb7c85cd7caf770d06820137f27b4",
"date": "2018-09-15 21:07:00 -0400",
"subject": "Update all interfaces to use variable parameter constructors.",
"body": "Fixed parameter constructors made adding new interface functions a burden, so we switched to using structs to define interfaces in the storage module at c49eaec7.\n\nWhile propagating this pattern to the IO interfaces it became obvious that the existing variable parameter function pattern (begun in the storage module) was more succinct and consistent with the existing code.\n\nSo, use variable parameter functions to define all interfaces. This assumes that the non-interface parameters will be fixed, which seems reasonable for low-level code."
},
{
"commit": "f0ed89f21fe2ae6278e64395f4191519807e529b",
"date": "2018-09-15 13:27:06 -0400",
"subject": "Allow C or Perl coverage to run on more than one VM.",
"body": "C or Perl coverage tests can now be run on any VM provided a recent enough version of Devel::Cover or lcov is available.\n\nFor now, leave u18 as the only VM to run coverage tests due to some issues with older versions of lcov."
},
{
"commit": "31cdd9d20b114f5c71c585a6effc4e71fae0d9c2",
"date": "2018-09-15 08:23:55 -0400",
"subject": "Remove compiler warnings that are not valid for u16."
},
{
"commit": "c49eaec776014806af194e7a2d9e88691f361f99",
"date": "2018-09-14 16:08:33 -0400",
"subject": "Full abstraction of storage driver interface.",
"body": "The external storage interfaces (Storage, StorageFileRead, etc.) have been stable for a while, but internally they were calling the posix driver functions directly.\n\nCreate driver interfaces for storage, fileRead, and fileWrite and remove all references to the posix driver outside storage/driver/posix (with the exception of a direct call to pathRemove() in Perl LibC).\n\nPosix is still the only available driver so more adjustment may be needed, but this should represent the bulk of the changes."
},
{
"commit": "aeb1fa3dfbf4a4b7384f8f2bc5a18a23e741396e",
"date": "2018-09-13 19:12:40 -0400",
"subject": "Don't perform valgrind when requested.",
"body": "The --no-valgrind flag was not being honored. It's not clear if this flag ever worked, but it does now."
},
{
"commit": "fd14ceb3995fca731141f09f7c940819138c63a2",
"date": "2018-09-13 18:58:22 -0400",
"subject": "Rename posix driver files/functions for consistency.",
"body": "The posix driver was developed over time and the naming is not very consistent.\n\nRename the files and functions to work well with other drivers and generally favor longer names since the driver functions are seldom (eventually never) used outside the driver itself."
},
{
"commit": "ab1762663cdcc3564113c5524dc384991228c0a4",
"date": "2018-09-13 17:53:48 -0400",
"subject": "Don't use negations in objects below Storage.",
"body": "The Storage object represents some some optional parameters as negated if the default is true. This allows sensible defaults without having to specify most optional parameters.\n\nHowever, there's no need to propagate this down to functions that require all parameters to be passed -- it makes the code and logging more confusing. Rename the parameters and update logic to remove negations."
},
{
"commit": "1fb9fe7026f355f86c44fac375a370458c10fc99",
"date": "2018-09-12 18:14:23 -0400",
"subject": "Update comments missed in 5aa458ff."
},
{
"commit": "5aa458ffaecc42cbf6ee37ee4f985d255e31443e",
"date": "2018-09-11 18:32:56 -0400",
"subject": "Simplify debug logging by allowing log functions to return String objects.",
"body": "Previously, debug log functions had to handle NULLs and truncate output to the available buffer size. This was verbose for both coding and testing.\n\nInstead, create a function/macro combination that allows log functions to return a simple String object. The wrapper function takes care of the memory context, handles NULLs, and truncates the log string based on the available buffer size."
},
{
"commit": "9b9396c7b7745cc4c765285e24ed131e7f72f343",
"date": "2018-09-11 15:42:31 -0400",
"subject": "Migrate local, unencrypted, non-S3 archive-get command to C.",
"body": "The archive-get command will only be executed in C if the repository is local, unencrypted, and type posix or cifs. Admittedly a limited use case, but this is just the first step in migrating the archive-get command entirely into C.\n\nThis is a direct migration from the Perl code (including messages) to integrate as seamlessly with the remaining Perl code as possible. It should not be possible to determine if the C version is running unless debug-level logging is enabled."
},
{
"commit": "787e7c295ff64b7f862693784fa901d8b046a3d4",
"date": "2018-09-11 14:43:16 -0400",
"subject": "Change locking around async process forking to be more test friendly.",
"body": "The lock is now released before the fork and reacquired after the fork so the parent process no longer needs to worry about clearing the lock.\n\nThis is the same locking mechanism that will be used once archive-get-async is exec'd as a separate command, so introduce it now to simplify testing."
},
{
"commit": "9e574a37dc4a5c03155a00673a944c2da0a51528",
"date": "2018-09-11 12:30:48 -0400",
"subject": "Make archive-get info messages consistent between C and Perl implementations.",
"body": "The info messages were spread around and logged differently based on the execution path and in some cases logged nothing at all.\n\nTemporarily track the async server status with a flag so that info messages are not output in the async process. The async process will be refactored as a separate command to be exec'd in a future commit."
},
{
"commit": "6c1d48b0186f4df40787349d37b35d822e043289",
"date": "2018-09-11 10:55:55 -0400",
"subject": "Command-line help update missed in cabb3f857."
},
{
"commit": "cabb3f8577d6de2a6fec7b6e78e68671fc39a65b",
"date": "2018-09-10 13:33:39 -0400",
"subject": "List allowable values for the buffer-size option in the configuration reference.",
"body": "Contributed by Cynthia Shang.\nSuggested by Stéphane Schildknecht."
},
{
"commit": "e351b8c67ca16f4210449c9d51916db1b3ad2416",
"date": "2018-09-10 13:09:45 -0400",
"subject": "Improve info command to display the stanza cipher type.",
"body": "Contributed by Cynthia Shang.\nSuggested by Douglas J Hunley."
},
{
"commit": "c688bc86276fcc43bf53747ebbf3259bb8d5a62b",
"date": "2018-09-10 10:54:34 -0400",
"subject": "Improve support for special characters in filenames.",
"body": "% characters caused issues in backup/restore due to filenames being appended directly into a format string.\n\nReserved XML characters (<>&') caused issues in the S3 driver due to improper escaping.\n\nAdd a file with all common special characters to regression testing."
},
{
"commit": "80ef6fce7529c5f9b8309ac0b8451ddce2a08e2b",
"date": "2018-09-10 10:47:00 -0400",
"subject": "Fix missing URI encoding in S3 driver.",
"body": "File names with uncommon characters (e.g. @) caused authentication failures due to S3 encoding them correctly while the S3 driver did not."
},
{
"commit": "f7fc8422f780d18d045f42124dc40aa0920fe416",
"date": "2018-09-07 16:50:01 -0700",
"subject": "Make Valgrind return an error even when a non-fatal issue is detected.",
"body": "By default Valgrind does not exit with an error code when a non-fatal error is detected, e.g. unfreed memory. Use the --error-exitcode option to enabled this behavior.\n\nUpdate some minor issues discovered in the tests as a result. Luckily, no issues were missed in the core code."
},
{
"commit": "faaa9a91fda78f8e38d0a479675f08a5b17a7302",
"date": "2018-09-07 08:03:56 -0700",
"subject": "Fix typo in unit test error messages, EXECTED => EXPECTED."
},
{
"commit": "6e9b6fdca919b9f6fe2bfdb88447ee1f4f7abea7",
"date": "2018-09-07 08:03:05 -0700",
"subject": "Migrate control functions to detect stop files to C from Perl.",
"body": "Basic functions to detect the presence of stanza or all stop files and error when they are present.\n\nThe functionality to detect stop files without error was not migrated. This functionality is only used by stanza-delete and will be migrated with that command."
},
{
"commit": "5bdaa35fa5fea30bf7cdf10a5077cb3b661aa3db",
"date": "2018-09-07 08:00:18 -0700",
"subject": "Migrate walIsPartial(), walIsSegment(), and walSegmentFind() from Perl to C.",
"body": "Also refactor regular expression defines to make them more reusable."
},
{
"commit": "96600760930d1713645ffab211d98d2314818432",
"date": "2018-09-07 07:58:08 -0700",
"subject": "Add helper for repository storage.",
"body": "Implement rules for generating paths within the archive part of the repository. Add a helper function, storageRepo(), to create the repository storage based on configuration settings.\n\nThe repository storage helper is located in the protocol module because it will support remote file systems in the future, just as the Perl version does.\n\nAlso, improve the existing helper functions a bit using string functions that were not available when they were written."
},
{
"commit": "960ad73298fa9c3b9ea60b24428a10ede9a58828",
"date": "2018-09-06 10:12:14 -0700",
"subject": "Info objects now parse JSON and use specified storage.",
"body": "Use JSON code now that it is available and remove temporary hacks used to get things working initially.\n\nUse passed storage objects rather than using storageLocal(). All storage objects in C are still local but this won't always be the case.\n\nAlso, move Postgres version conversion functions to postgres/info.c since they have no dependency on the info objects and will likely be useful elsewhere."
},
{
"commit": "de1b74da0cf9c4f182e3a4cde52d0b5163111a44",
"date": "2018-09-06 09:35:34 -0700",
"subject": "Move encryption in mock/archive tests to remote tests.",
"body": "The new archive-get C code can't run (yet) when encryption is enabled. Therefore move the encryption tests so we can test the new C code. We'll move it back when encryption is enabled in C.\n\nAlso, push one WAL segment with compression to test decompression in the C code."
},
{
"commit": "6361a061812b20efeb89db110ebd592a0d52404f",
"date": "2018-09-04 21:46:41 -0400",
"subject": "Fix incorrectly reported error return in info logging.",
"body": "A return code of 1 from the archive-get was being logged as an error message at info level but otherwise worked correctly.\n\nAlso improve info messages when an archive segment is or is not found."
},
{
"commit": "800afeef70464da57af023614b1dfeecce5e112c",
"date": "2018-09-04 17:47:23 -0400",
"subject": "Posix file functions now differentiate between open and missing errors.",
"body": "The Perl functions do so and the integration tests rely on checking for these errors. This has been exposed as more functionality is moved into C.\n\nPassing the errors types is now a bit complicated so instead use a flag to determine which errors to throw."
},
{
"commit": "375ff9f9d283842da3620f22c9c5bdb61249ae9e",
"date": "2018-08-31 16:06:40 -0400",
"subject": "Ignore all files in a linked tablespace directory except the subdirectory for the current version of PostgreSQL.",
"body": "Previously an error would be generated if other files were present and not owned by the PostgreSQL user. This hasn't been a big deal in practice but it could cause issues.\n\nAlso add tests to make sure the same logic applies with links to files, i.e. all other files in the directory should be ignored. This was actually working correctly, but there were no tests for it before."
},
{
"commit": "41746b53cd91c0d7203d855f9186c685ea59af47",
"date": "2018-08-31 14:24:36 -0400",
"subject": "Begin v2.06 development."
},
{
"commit": "bc7462d86d3529712cf7c196a04f7d6f8dd8ee34",
"date": "2018-08-31 13:19:43 -0400",
"subject": "v2.05: Environment Variable Options and Exclude Temporary/Unlogged Relations"
},
{
"commit": "d41570c37a2820380fa1708f31ed21c09e4065f8",
"date": "2018-08-31 11:31:13 -0400",
"subject": "Improve log file names for remote processes started by locals.",
"body": "The log-subprocess feature added in 22765670 failed to take into account the naming for remote processes spawned by local processes. Not only was the local command used for the naming of log files but the process id was not pass through. This meant every remote log was named \"[stanza]-local-remote-000\" which is confusing and meant multiple processes were writing to the same log.\n\nInstead, pass the real command and process id to the remote. This required a minor change in locking to ignore locks if process id is greater than 0 since remotes started by locals never lock."
},
{
"commit": "c2d0a21d63a3c76bf513ac79c622e694ca9dfe1d",
"date": "2018-08-30 18:44:40 -0400",
"subject": "Allow secrets to be passed via environment variables.",
"body": "When environment variables were added in d0b9f986 they were classified as cfgSourceParam, but one of the restrictions on this type is that they can't pass secrets because they might be exposed in the process list.\n\nThe solution is to reclassify environment variables as cfgSourceConfig. This allows them to handle secrets because they will not pass values to subprocesses as parameters. Instead, each subprocess is expected to check the environment directly during configuration parsing.\n\nIn passing, move the error about secrets being passed on the command-line up to command-line parsing and make the error more generic with respect to the configuration file now that multiple configuration files are allowed."
},
{
"commit": "70514061fdca620ba99dd0e36bb99dccbca43e1d",
"date": "2018-08-30 16:27:36 -0400",
"subject": "Fix issue where relative links in $PGDATA could be stored in the backup with the wrong path.",
"body": "Relative link paths were being combined with the paths of previous links (relative or absolute) due to the $strPath variable being modified in the current iteration rather than simply being passed to the next level of recursion.\n\nThis issue did not affect absolute links and relative tablespace links were caught by other checks, though the error was confusing."
},
{
"commit": "1631f8b3cebbe761f5eb71c9b7203664f2ae5005",
"date": "2018-08-29 16:45:58 -0500",
"subject": "Embedded documentation update missed in c6384904."
},
{
"commit": "c6384904512363baaa8c6dbec42799c0ddb1d4db",
"date": "2018-08-28 16:49:29 -0400",
"subject": "Documentation updates for exclude feature based on review.",
"body": "Reviewed by Cynthia Shang."
},
{
"commit": "14cde54b37bec6ac831a2ddc870531bd61b034dd",
"date": "2018-08-28 16:27:10 -0400",
"subject": "Limit manifest build recursion (i.e. links followed) to sixteen levels to detect link loops."
},
{
"commit": "a6cecf7d5ef722bc962a1e6a3808dce3424ca710",
"date": "2018-08-28 16:22:30 -0400",
"subject": "Prevent manifest from being built more than once."
},
{
"commit": "4498f726a59132421f8a1530783f8bb6cc8905c3",
"date": "2018-08-28 16:04:53 -0400",
"subject": "Improve asynchronous archive-get/archive-push performance by directly checking status files.",
"body": "Prior to this commit, an expression was used to search the spool directory for ok/error files for a specific WAL segment. This involved setting up a regular expression and using opendir/readdir.\n\nInstead, directly probe for the status files, checking directly if a '.ok' or '.error' file exists, avoiding the regular expression and eliminating the directory scan.\n\nOnly the two files now probed for could have ever matched the regular expression which had been provided and it's unlikely that many more additional files will be added, so this is a good improvement, and optimization, with little downside."
},
{
"commit": "bef58a79743d3273d14de221e26291a5d90409b3",
"date": "2018-08-27 15:51:05 -0400",
"subject": "Allow arbitrary directories and/or files to be excluded from a backup.",
"body": "Misuse of this feature can lead to inconsistent backups so read the --exclude documentation carefully before using."
},
{
"commit": "77dca5b96817d0e0d49e34fb7d8e0944e60f71a8",
"date": "2018-08-24 19:31:45 -0400",
"subject": "Allow command/option constants to autonumber in both C and Perl to reduce churn when a new command/option is added."
},
{
"commit": "4c3cf435c036037ff32b7a76e53753e765358173",
"date": "2018-08-24 17:08:00 -0400",
"subject": "Add cvtZToUInt() to convert string to unsigned int."
},
{
"commit": "eb30d88b6a6048353b269d590c43fad9e6233a25",
"date": "2018-08-24 16:50:33 -0400",
"subject": "Allow zero-size files in backup manifest to reference a prior manifest regardless of timestamp delta.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0ed37ab9e73fb59a5558b39bb292e0eb4f331ec9",
"date": "2018-08-24 12:13:10 -0400",
"subject": "Update Archive::Info->archiveIdList() to return a valid error code instead of unknown."
},
{
"commit": "22765670270067c5102a2ab9b3277d4cbc86c6af",
"date": "2018-08-22 20:05:49 -0400",
"subject": "Add log-subprocess option to allow file logging for local and remote subprocesses."
},
{
"commit": "512da125ad7314d2d58931186316423f039c8c35",
"date": "2018-08-22 19:03:13 -0400",
"subject": "Improve error reporting for TEST_ASSIGN() and TEST_RESULT_VOID() macros."
},
{
"commit": "ad989068d283a99a8aaf20be2eb0337a47bb8f73",
"date": "2018-08-22 16:45:25 -0400",
"subject": "Fix issue when a boolean option (e.g. delta) was specified more than once.",
"body": "Reported by Yogesh Sharma."
},
{
"commit": "8a8738308c08ec9ac7a12b08f2ab7358dc4aa3af",
"date": "2018-08-22 14:48:37 -0400",
"subject": "Enable -Wvla."
},
{
"commit": "de5614db6b027900ef48f4ade456643cfecad79c",
"date": "2018-08-15 14:05:39 -0400",
"subject": "PostgreSQL 11 Beta 3 support."
},
{
"commit": "d0b9f986a0eb30c550b2dc9031ad10dda941a26c",
"date": "2018-08-15 10:52:53 -0400",
"subject": "Allow any option to be set in an environment variable.",
"body": "This includes options that previously could only be specified on the command line, e.g. stanza."
},
{
"commit": "4a822d3032389543d2bb53018cff9062155cd3f9",
"date": "2018-08-15 10:32:18 -0400",
"subject": "Correct OptionInvalidError to OptionInvalidValueError in boolean option parsing."
},
{
"commit": "238e5dae3c12ff37b3873e5db5a9c1cff3bed64f",
"date": "2018-08-14 17:17:14 -0400",
"subject": "Allow resolve array from cd5df357 to autosize to detect short arrays in testing."
},
{
"commit": "cb4b715533c1a566add50cb3e245cd2a65fba5fa",
"date": "2018-08-14 16:49:38 -0400",
"subject": "Add strReplaceChr() to String object."
},
{
"commit": "4a176681c3d7767c1f5cb98d1d5e46b7adb3f76b",
"date": "2018-08-14 16:18:17 -0400",
"subject": "Add cvtCharToZ() and macro for debugging char params."
},
{
"commit": "9e3273fdf91e31d6f13ecd12658fa624dfbf4f3d",
"date": "2018-08-14 16:08:58 -0400",
"subject": "Define cipher magic size with sizeof() rather than using a constant."
},
{
"commit": "6643afe9a86bf617d2e90687130248c4a6ee6c14",
"date": "2018-08-14 14:56:59 -0400",
"subject": "Add gzip compression/decompression filters for C."
},
{
"commit": "e3ff6b209d9cf50f88f51a70ac7247949b63ac55",
"date": "2018-08-14 14:21:53 -0400",
"subject": "Filters can now produce output that differs from input.",
"body": "This allows filters such as compression, encryption, etc. to be implemented."
},
{
"commit": "a45d1b4a60545940a6a5eac37cf16473b97d2c41",
"date": "2018-08-14 13:38:11 -0400",
"subject": "Update to command-line docs missed in 40924e8f."
},
{
"commit": "40924e8f5c84cfdac7eadde4b6cca092f3900430",
"date": "2018-08-13 07:47:26 -0400",
"subject": "Fix invalid log level in log-path option reference.",
"body": "Reported by Camilo Aguilar."
},
{
"commit": "343424009795014bce2474f46762d76cc9ec4ef7",
"date": "2018-08-12 19:24:21 -0400",
"subject": "Remove incompletely implemented online option from the check command.",
"body": "Offline operation runs counter to the purpose of this command, which is to check if archiving and backups are working correctly."
},
{
"commit": "cb6821e8533a9ff3c4e3727746bd1d259255d86a",
"date": "2018-08-12 18:19:34 -0400",
"subject": "Stop trying to arrange contributors in release.xml by last/first name.",
"body": "Contributor names have always been presented in the release notes exactly as given, but we tried to assign internal IDs based on last/first name which can be hard to determine and ultimately doesn't make sense.\n\nInspired by Christophe Pettus' PostgresOpen 2017 talk, \"Human Beings Do Not Have a Primary Key\"."
},
{
"commit": "cd5df3570b0fcd5011e2339b48a3359a1f2c54da",
"date": "2018-08-11 12:55:33 -0400",
"subject": "Validate configuration options in a single pass.",
"body": "By pre-calculating and storing the option dependencies in parse.auto.c validation can be completed in a single pass, which is both simpler and faster."
},
{
"commit": "f06bf9e8329fcb083271fab8d7aeccad1122a5b1",
"date": "2018-08-11 09:47:07 -0400",
"subject": "Improve error message when a command is missing the stanza option.",
"body": "Suggested by Sarah Conway."
},
{
"commit": "8ab2e72960de60557331fe7087015519a516f318",
"date": "2018-08-09 08:57:21 -0400",
"subject": "Migrate minimum set of code for reading archive.info files from Perl to C.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "7993f1a96620ac6c00ba961036ba5ff6abc58f22",
"date": "2018-08-09 08:06:23 -0400",
"subject": "Add basic C JSON parser."
},
{
"commit": "31167d8f987cf171bd655c5ccb1bebebac9d7997",
"date": "2018-08-05 08:35:18 -0400",
"subject": "Enable -Wduplicated-branches, and -Wduplicated-cond."
},
{
"commit": "14f21a8f6c0f1bec4c4af82af51235ddf8617beb",
"date": "2018-08-04 19:37:28 -0400",
"subject": "Enable -Wpointer-arith."
},
{
"commit": "429a356e3323acf99f3d73a527baf7aaa55a3b5b",
"date": "2018-08-03 19:19:14 -0400",
"subject": "Enable -Wstrict-prototypes and update all void functions to conform."
},
{
"commit": "bec4c176dc478d5eff855c18ba05d4a8301f0b22",
"date": "2018-07-30 18:53:34 -0400",
"subject": "Exclude temporary and unlogged relation (table/index) files from backup.",
"body": "Implemented using the same logic as the patches adding this feature to PostgreSQL, 8694cc96 and 920a5e50. Temporary relation exclusion is enabled in PostgreSQL ≥ 9.0. Unlogged relation exclusion is enabled in PostgreSQL ≥ 9.1, where the feature was introduced."
},
{
"commit": "ac16cb7ff16b58c9de4ba9c27d5322b69639594e",
"date": "2018-07-28 09:39:52 -0400",
"subject": "Add cvtBoolToConstZ() to simplify conversion of boolean to string."
},
{
"commit": "7a00bbebfafc94f17b7897b2074cfd079e6882b6",
"date": "2018-07-28 09:04:06 -0400",
"subject": "Do nothing in memContextMove() when the context is already in the specified parent."
},
{
"commit": "cb975a533095f863232843cac1b3831f24a8fe3c",
"date": "2018-07-28 08:43:58 -0400",
"subject": "Remove redundant lines from embedded Perl by combining blank lines."
},
{
"commit": "666537cbdee986ebdc323f6c9d412edf2a5c7145",
"date": "2018-07-28 08:13:30 -0400",
"subject": "Update code count for new file types and exclusions."
},
{
"commit": "01aea0c067c2e667c47346620c563218f4c0f568",
"date": "2018-07-24 21:08:27 -0400",
"subject": "Implement filters that do not modify the buffer.",
"body": "Update cryptoHash to use the new interface."
},
{
"commit": "8e1017c1622bed5ebddc910545cbcaf288dd2f2f",
"date": "2018-07-23 07:59:24 -0400",
"subject": "Move most host setup to containers defined in the documentation.",
"body": "This includes PostgreSQL installation which had previously been included in the documentation. This way produces faster builds and there is no need for us to document PostgreSQL installation."
},
{
"commit": "27238310322096a52f1babf478cd4fffb344d949",
"date": "2018-07-23 07:49:15 -0400",
"subject": "Allow containers to be defined in a document.",
"body": "The defined containers are built before the document build begins which allows them to be reused."
},
{
"commit": "ae72772e5b366f02f8a5026e3109cfd43aacb8f4",
"date": "2018-07-23 07:17:24 -0400",
"subject": "Fix typo in 18626306."
},
{
"commit": "1862630629bdf435a76575a31ed722cc351def11",
"date": "2018-07-21 17:02:42 -0400",
"subject": "Use pre-built images from Docker Hub when the container definition has not changed.",
"body": "Downloading an image is quite a bit faster than building a new image from scratch and saves minutes per test run in CI."
},
{
"commit": "8568622a6f5941cbe9e0ef40ea9f605b62675838",
"date": "2018-07-20 19:03:46 -0400",
"subject": "Add --log-level-test option.",
"body": "This allows setting the test log level independently from the general test harness setting, but current only works for the C tests. It is useful for seeing log output from functions on the console while a test is running."
},
{
"commit": "58e9f1e50cfbc2df22af17293fe8a298cac5513a",
"date": "2018-07-20 18:51:42 -0400",
"subject": "Refactor the common/log tests to not depend on common/harnessLog.",
"body": "common/harnessLog was not ideally suited for general testing and made all the tests quite awkward. Instead, move all code used to test the common/log module into the logTest module and repurpose common/harnessLog to do log expect testing for all other tests in a cleaner way.\n\nAdd a few exceptions for config testing since the log levels are reset by default in config/parse."
},
{
"commit": "1359e2908c777ef7b8cb128f7d7ede3b53bc2018",
"date": "2018-07-20 08:11:34 -0400",
"subject": "Fix issue where errors raised in C were not logged when called from Perl.",
"body": "pgBackRest properly terminated with the correct error code but lacked an error message to aid in debugging."
},
{
"commit": "d3cfeebdf91a559a0af80bba5fc424f4d091b944",
"date": "2018-07-20 08:03:44 -0400",
"subject": "Rename error-handling variables in Main.pm to conform to standard."
},
{
"commit": "fa53e2eddb95822553b6a860ef3e6d09fdb31f4a",
"date": "2018-07-20 07:15:28 -0400",
"subject": "Show exact log level required for stack trace param output instead of just \"debug\"."
},
{
"commit": "0ac176b722fe93301ec9f4d706698f0f01125666",
"date": "2018-07-19 16:04:20 -0400",
"subject": "Abstract IO layer out of the storage layer.",
"body": "This allows the routines to be used for IO objects that do not have a storage representation.\n\nImplement buffer read and write IO objects."
},
{
"commit": "5dc8a2ec08ee7569063915c7a1b3399ac1f2d16c",
"date": "2018-07-17 19:01:54 -0400",
"subject": "storageFileRead() accepts a buffer for output rather than creating one.",
"body": "This is more efficient overall and allows the caller to specify how many bytes will be read on each call. Reads are appended if the buffer already contains data but the buffer size will never increase.\n\nAllow Buffer object \"used size\" to be different than \"allocated size\". Add functions to manage used size and remaining size and update automatically when possible."
},
{
"commit": "0acf70541601d99795f6da06ebca030eff69cd46",
"date": "2018-07-16 17:25:15 -0400",
"subject": "Require PostgreSQL catalog version when instantiating a Manifest object (and not loading it from disk).",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "4e38cbaea9fdfbc8618971c5148ffd0a7e7ef4ab",
"date": "2018-07-12 15:28:46 -0400",
"subject": "Add iniSectionList() to Ini object and remove dead code.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0e6b927a172368a77473571d8c27265253894c0e",
"date": "2018-07-12 15:23:18 -0400",
"subject": "Add uint64 variant type and supporting conversion functions.",
"body": "Contributed by Cynthia Shang.\nReviewed by Stephen Frost."
},
{
"commit": "0e331b12ba0cf377e4292a89ae84de7bb74281d6",
"date": "2018-07-12 15:15:32 -0400",
"subject": "Improve performance of string to int conversion.",
"body": "Use strtoll() instead of sprintf() for conversion. Also use available integer min/max constants rather than hard-coded values.\n\nReviewed by Stephen Frost.\nSuggested by Stephen Frost."
},
{
"commit": "cf889790e60972adcacc6e21fa3853378676889a",
"date": "2018-07-10 15:39:03 -0400",
"subject": "Error if LibC build is performed outside the test environment.",
"body": "LibC is no longer required for production builds."
},
{
"commit": "b1bc53657d9e683f30bdfcce190da286a383328f",
"date": "2018-07-09 08:15:16 -0400",
"subject": "Begin v2.05 development."
},
{
"commit": "a8143ec1253f3d9187c053def0b8c515d4f13fd5",
"date": "2018-07-05 20:16:41 -0400",
"subject": "v2.04: Critical Bug Fix for Backup Resume"
},
{
"commit": "6f6dad6dd5fb0f2ba5824b1812e71abf047704a4",
"date": "2018-07-05 16:49:46 -0400",
"subject": "Remove call to lscpu which can vary widely by build host."
},
{
"commit": "22adb395db804e03646fc53d84b6e7935c38c46e",
"date": "2018-07-05 15:40:50 -0400",
"subject": "Add zero-length file to mock/all test."
},
{
"commit": "db17973cd0a8a5692e408621703fd83fbce40166",
"date": "2018-07-03 14:01:57 -0400",
"subject": "Fix critical bug in resume that resulted in inconsistent backups.",
"body": "A regression in v0.82 removed the timestamp comparison when deciding which files from the aborted backup to keep on resume. All resumed backups should be considered inconsistent. A resumed backup can be identified by checking the log for the message \"aborted backup of same type exists, will be cleaned to remove invalid files and resumed\"."
},
{
"commit": "3d07e01fe920bef0d4848ddd55560dc13e38ef85",
"date": "2018-07-01 20:02:37 -0400",
"subject": "Make ls ordering deterministic in mock/all test."
},
{
"commit": "1bd98b61df7aeaec25b6d6b5baa71f8a458784ee",
"date": "2018-07-01 08:17:27 -0400",
"subject": "Fix non-compliant ISO-8601 timestamp format in S3 authorization headers.",
"body": "AWS and some gateways were tolerant of space rather than zero-padded hours while others were not.\n\nFixed by Andrew Schwartz."
},
{
"commit": "7e65ddad34db74a14e54aab125f0e62596268f6e",
"date": "2018-06-30 14:55:25 -0400",
"subject": "PostgreSQL 11 Beta 2 support."
},
{
"commit": "7b0e65d48823e94a7a17ae377e54a898bb07d7fb",
"date": "2018-06-26 17:27:22 -0400",
"subject": "Improve the HTTP client to set content-length to 0 when not specified by the server.",
"body": "S3 (and gateways) always set content-length or transfer-encoding but HTTP 1.1 does not require it and proxies (e.g. HAProxy) may not include either."
},
{
"commit": "e8c68b9c6657d7fabfd70cbd8ad3778e123bcb41",
"date": "2018-06-26 16:56:05 -0400",
"subject": "Update parameters for VBoxService start."
},
{
"commit": "ead70e16bbead338b7ba14b4a03014187bb80c23",
"date": "2018-06-23 13:09:56 -0400",
"subject": "Add sample S3 policy to restrict bucket privileges.",
"body": "Suggested by Douglas J Hunley, Jason O'Donnell."
},
{
"commit": "aa41e00c9cdbb966a6cda088a21fb16c443163d4",
"date": "2018-06-21 11:39:37 -0400",
"subject": "Set search_path = 'pg_catalog' on PostgreSQL connections.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "7fee739710b052f41ff881b513ae376acb1e5c2a",
"date": "2018-06-20 18:26:53 -0400",
"subject": "Remove Debian package patch since it has been committed upstream."
},
{
"commit": "6084e9be04dd958f8ab8906c1af8e3ed1fca4994",
"date": "2018-06-16 13:07:01 -0400",
"subject": "Fix default location of pgbackrest.conf in option reference."
},
{
"commit": "1a0d56860059e7f9998e1faf5d384017ca1511ee",
"date": "2018-06-14 19:05:35 -0400",
"subject": "Preliminary documentation for PostgreSQL 11 unprivileged user backup."
},
{
"commit": "3793ae1e4f0a4deeb156fa3d0ace4ddab0b85804",
"date": "2018-06-14 17:59:10 -0400",
"subject": "Convert the not very portable uint type to unsigned int.",
"body": "Suggested by Devrim Gündüz."
},
{
"commit": "4e7692b74d229538fdde123a6020258a9ff5f8f3",
"date": "2018-06-14 17:44:44 -0400",
"subject": "Fix error in selective restore when only one user database exists in the cluster.",
"body": "Fixed by Cynthia Shang.\nReported by Nj Baliyan."
},
{
"commit": "fbd1da05230bb4790f143443dd515453fada0bba",
"date": "2018-06-13 13:43:17 -0400",
"subject": "Create a new section to describe building pgBackRest and build on a separate host."
},
{
"commit": "d55e609959547750116be2954f956e7e918013b5",
"date": "2018-06-12 13:43:15 -0400",
"subject": "Use a prebuilt s3 server container for documentation and tests."
},
{
"commit": "350b30fa4977e23b205e05b787d707eaceb5a67f",
"date": "2018-06-11 14:52:26 -0400",
"subject": "Move cryptographic hash functions to C using OpenSSL."
},
{
"commit": "064ec757e9da187ff4a6dad481dc32775454dee3",
"date": "2018-06-11 10:53:16 -0400",
"subject": "Rename cipher module to the more general crypto."
},
{
"commit": "835396751f220be3f8e46f344d4eadfd7b7305b3",
"date": "2018-06-10 14:13:56 -0400",
"subject": "Document generator improvements.",
"body": "* Build containers from scratch for more accurate testing.\n* Allow environment load to be skipped.\n* Allow bash wrapping to be skipped.\n* Allow forcing a command to run as a user without sudo."
},
{
"commit": "5c0099781d170409a0121355fb8b4917ca06ac0a",
"date": "2018-06-06 22:19:01 -0400",
"subject": "Update Debian package to add debug symbols to pgBackRest executable."
},
{
"commit": "a385cb520b02c8e216bde78de51e57c216534778",
"date": "2018-06-06 15:52:28 -0400",
"subject": "Update primary test environment (Vagrant and Docker) to Ubuntu 18.04."
},
{
"commit": "d309a85b51d732cb983ea781b69a9a1d2d4a1831",
"date": "2018-06-05 08:59:17 -0400",
"subject": "PostgreSQL 11 Beta 1 support."
},
{
"commit": "e57840d739e12aec86fb4772044e0d722f1d9dd6",
"date": "2018-05-25 13:42:09 -0400",
"subject": "Document generator improvements.",
"body": "* Allow parameters to be passed when a container is created.\n* Allow /etc/hosts update to be skipped (for containers without bash)."
},
{
"commit": "40093f160cf891c9bb522f4da1f0414aeacbc3e5",
"date": "2018-05-24 14:01:24 -0400",
"subject": "Improve efficiency of C library builds now that they are used only for testing."
},
{
"commit": "915b09635a5300f1cb45506c5237c3b883b5a85a",
"date": "2018-05-24 11:00:47 -0400",
"subject": "Remove RHEL package patch since it has been committed upstream."
},
{
"commit": "8eb9921c7ca3d3aaacf1894756be02cbe7d17e18",
"date": "2018-05-23 14:57:08 -0400",
"subject": "Auto-generate Makefile with dependencies."
},
{
"commit": "2f6017511fda3c6aeb67c3daafcc6c1dc35b2dd4",
"date": "2018-05-23 09:45:08 -0400",
"subject": "Split log levels into separate header file.",
"body": "Many modules that use debug.h do not need to do logging so this reduces dependencies for those modules."
},
{
"commit": "dfa92b359deddb37b10db5e1bac47750d8d1011c",
"date": "2018-05-23 09:10:14 -0400",
"subject": "Begin v2.04 development."
},
{
"commit": "f7123c1bbf239814b33ddc97e53b472cf0e69d16",
"date": "2018-05-22 19:53:25 -0400",
"subject": "v2.03: Single Executable to Deploy"
},
{
"commit": "4c7408ea52af7f8faec5244c65a55440643616eb",
"date": "2018-05-22 12:53:08 -0400",
"subject": "Embed exported C functions and Perl modules directly into the pgBackRest executable."
},
{
"commit": "ada5c5c0d96e63f9f13009b6b0818457b49c6591",
"date": "2018-05-21 10:46:45 -0400",
"subject": "Fix archive write lock being taken for the synchronous archive-get command.",
"body": "Reported by Uspen."
},
{
"commit": "e69d5fbf624bbab45dcc820798284244fecd18c3",
"date": "2018-05-21 08:06:31 -0400",
"subject": "Fix potential buffer overrun in error message handling.",
"body": "Reported by Lætitia."
},
{
"commit": "72a9684d4e9dc15f7252b259dafb35a310fe2cd6",
"date": "2018-05-18 12:03:39 -0400",
"subject": "Print total runtime in milliseconds at command end."
},
{
"commit": "52bc07323407668f49282d011b710f85fc9b11b6",
"date": "2018-05-18 11:57:32 -0400",
"subject": "Add stack trace macros to all functions.",
"body": "Low-level functions only include stack trace in test builds while higher-level functions ship with stack trace built-in. Stack traces include all parameters passed to the function but production builds only create the parameter list when the log level is set high enough, i.e. debug or trace depending on the function."
},
{
"commit": "abb9651f4c58446bbcf3f2013d075157a20beed5",
"date": "2018-05-18 06:45:14 -0400",
"subject": "Test harness improvements.",
"body": "* Allow more than one test to provide coverage for the same module.\n* Add option to disable valgrind.\n* Add option to disabled coverage.\n* Add option to disable debug build.\n* Add option to disable compiler optimization.\n* Add --dev-test mode."
},
{
"commit": "bce3d0fe1c96c0204fffd38145e4ddd56362a837",
"date": "2018-05-17 17:09:06 -0400",
"subject": "Build libc using links rather than referencing the C files in src directly.",
"body": "The C library builds with different options which should not be reused for the C binary or vice versa."
},
{
"commit": "91be372e6ac1601249df05e334ee93ba5540633c",
"date": "2018-05-11 11:24:38 -0400",
"subject": "Set log-timestamp=n for integration tests.",
"body": "This means less filtering of logs needs to be done and new timestamps can be added without adding new filters."
},
{
"commit": "a1be8e16cdfd364591c3a7104b1cc30084b13a08",
"date": "2018-05-11 10:39:36 -0400",
"subject": "Update SSL error message test on CentOS 7."
},
{
"commit": "4b4af1cbfc0859a3db2981229e864853a38722bb",
"date": "2018-05-09 11:14:35 -0400",
"subject": "Use time_t instead of __time_t for better portability.",
"body": "Suggested by Nick Floersch."
},
{
"commit": "a9069f3fd3236d020c589265117817d3fddc6a5d",
"date": "2018-05-09 10:50:05 -0400",
"subject": "Begin v2.03 development."
},
{
"commit": "ee8aafb3cadd77682c97bcc74adb457e0723ebee",
"date": "2018-05-06 19:53:42 -0400",
"subject": "v2.02: Parallel Asynchronous Archive Get and Configuration Includes"
},
{
"commit": "4d6a51ac47e168811531cb4d388f0dde2b89cbcd",
"date": "2018-05-06 08:56:42 -0400",
"subject": "Add HARNESS_FORK for tests that require fork().",
"body": "A standard pattern for tests makes fork() easier to use and should help prevent some common mistakes."
},
{
"commit": "790f7c73128a4b3f0f98600aa7475d88f774fd1b",
"date": "2018-05-05 11:50:11 -0400",
"subject": "Enforce full branch coverage in C code."
},
{
"commit": "0a860e0b6049bd6922a1583ede6748b46cfb9d23",
"date": "2018-05-05 09:38:09 -0400",
"subject": "Full branch coverage for command/help/help, common/error, common/ini, and common/log modules."
},
{
"commit": "90aadc6534be12e8a49d4da5ff231a1f439e378c",
"date": "2018-05-04 12:49:25 -0400",
"subject": "Full branch coverage for config module."
},
{
"commit": "6c3b40152fa88e101564867ed55338bb63eff626",
"date": "2018-05-04 09:21:32 -0400",
"subject": "Improve module branch coverage.",
"body": "Add full branch coverage for cipher/block, command/command, common/wait, and postgres/pageChecksum modules."
},
{
"commit": "c3a8fbe706ed31e2414fa454d6090d0346f34f4a",
"date": "2018-05-03 11:24:29 -0400",
"subject": "Add _FMT variants for all THROW macros so format types are checked by the compiler."
},
{
"commit": "6a40c916d4307c2de79de250ed444237d47e6b7a",
"date": "2018-05-02 14:06:40 -0400",
"subject": "Add repo-s3-token option to allow temporary credentials tokens to be configured.",
"body": "pgBackRest currently has no way to request new credentials so the entire command (e.g. backup, restore) must complete before the credentials expire."
},
{
"commit": "5e090ba30501b76717dcb034420aba06847955f2",
"date": "2018-05-02 12:19:54 -0400",
"subject": "Fix failure in manifest build when two or more files in PGDATA are linked to the same directory.",
"body": "Reported by Vitaliy Kukharik."
},
{
"commit": "6a01db2b3297fc103577b8bd25da011f09fc8a17",
"date": "2018-05-02 12:06:12 -0400",
"subject": "Fix delta restore failing when a linked file is missing."
},
{
"commit": "9d9fad88a25b0f4bafcae1f2e9b1cf81d00b8d9e",
"date": "2018-05-02 07:31:44 -0400",
"subject": "Add example of command section usage to archiving configuration.",
"body": "Suggested by Christophe Courtois."
},
{
"commit": "fd1984239e5d60293b86419d77bcb1c990dbbc7e",
"date": "2018-05-01 14:07:08 -0400",
"subject": "Fix rendering of key/value and list options in help.",
"body": "Reported by Clinton Adams."
},
{
"commit": "1a1ed8d6b9973e069325b1dee7b54c9bbc2740d1",
"date": "2018-05-01 13:20:48 -0400",
"subject": "Update help test to use restore command to provide better coverage."
},
{
"commit": "8dbbf2de929813d5ed2068c13b8cc5b3c3cfafc2",
"date": "2018-05-01 12:37:06 -0400",
"subject": "Fix archive-copy throwing \"path not found\" error for incr/diff backups.",
"body": "Reported by yummyliu, Vitaliy Kukharik."
},
{
"commit": "71ba08f579be228a8975c0a59bd485e5c11bebe5",
"date": "2018-05-01 11:05:37 -0400",
"subject": "Make backup/restore path sync more efficient.",
"body": "Remove recursive path sync functionality since it is no longer used."
},
{
"commit": "54dd6f3ed4fcfeabe0254fdb9d88f560efd5f8ca",
"date": "2018-04-30 17:27:39 -0400",
"subject": "Add asynchronous, parallel archive-get.",
"body": "This feature maintains a queue of WAL segments to help reduce latency when PostgreSQL requests a WAL segment with restore_command."
},
{
"commit": "c48b0a2a1e40764a33b42485a7edf21a544b0db1",
"date": "2018-04-30 08:13:56 -0400",
"subject": "Update docs with 32-bit support and caveats.",
"body": "32-bit support was added in v1.26."
},
{
"commit": "321a28f6b0c6c522b8b8120e9fccfec09de4c6f4",
"date": "2018-04-29 11:47:50 -0400",
"subject": "Add walSegmentNext() and walSegmentRange()."
},
{
"commit": "be02c6750376e9a0312b7c707c5c96025eb1cfa6",
"date": "2018-04-29 11:20:51 -0400",
"subject": "Add pgControlInfo() to read pg_control and determine the PostgreSQL version."
},
{
"commit": "8c6e2bdbc7ac2b0e887d9d30931a532141974821",
"date": "2018-04-29 11:02:21 -0400",
"subject": "Add storageInfo() and track size in read objects."
},
{
"commit": "d74c167420b1c2eba74b29cf13b87f1143951b19",
"date": "2018-04-29 10:41:05 -0400",
"subject": "Add bufNewC() and only reallocate buffer when the size has changed."
},
{
"commit": "d44848baa0cc6583208d1d5ddb2db8cf69b866f3",
"date": "2018-04-29 10:32:46 -0400",
"subject": "Add strLstExists(), strLstExistsZ(), strSub(), and strSubN() to String and StringList objects."
},
{
"commit": "89d3476e325a94cb75457354e26b1ab4f5bcc8b0",
"date": "2018-04-29 10:16:59 -0400",
"subject": "Refactor archive common functions in preparation for parallel async archive-get."
},
{
"commit": "721432f6ae55c2a06d645629703c5103f8d89190",
"date": "2018-04-25 15:46:05 -0400",
"subject": "Update the archive-push-queue-max, manifest-save-threshold, and buffer-size options to accept values in KB, MB, GB, TB, or PB where the multiplier is a power of 1024.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "8eabc52f3b5872c898cc14b2691a01a2559ad6bd",
"date": "2018-04-25 15:16:42 -0400",
"subject": "Add strUpper, strLower, strChr, and strTrunc to String object.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "88a633da17d53261e0131e2d77209f22403112d6",
"date": "2018-04-24 09:12:25 -0400",
"subject": "Divide tests into three types (unit, integration, performance).",
"body": "Many options that were set per test can instead be inferred from the types, i.e. container, c, expect, and individual.\n\nAlso finish renaming Perl unit tests with the -perl suffix."
},
{
"commit": "bb8c315cadc6329a03cd975a6c865b1ce29d751c",
"date": "2018-04-23 17:26:27 -0400",
"subject": "Storage object improvements.",
"body": "* Add storageCopy(), storageMove(), and storagePathSync().\n* Separate StorageFile object into separate read and write objects.\n* Abstract out Posix file read/write objects."
},
{
"commit": "02cc8ccbd45221ef03f30cd6b068fc7675011592",
"date": "2018-04-23 10:24:04 -0400",
"subject": "Add THROWP_* macro variants for error handling.",
"body": "These macros allow an ErrorType pointer to be passed and are required for functions that may return different errors based on a parameter."
},
{
"commit": "18882cb8822ab8af04ff57853c2bc35145cb7b65",
"date": "2018-04-23 10:19:45 -0400",
"subject": "Add bufEq and bufCat to Buffer object."
},
{
"commit": "f146502eae44d7366d79f3d73f695209d3189040",
"date": "2018-04-23 10:10:55 -0400",
"subject": "Add TEST_ERROR_FMT macro to simplify testing of formatted error messages."
},
{
"commit": "27aa5f756e32e8e1713588695b86451fde2e5b02",
"date": "2018-04-19 11:09:39 -0400",
"subject": "Add support for additional pgBackRest configuration files.",
"body": "Configuration files are loaded from the directory specified by the --config-include-path option.\n\nAdd --config-path option for overriding the default base path of the --config and --config-include-path option."
},
{
"commit": "79b7552940971ab73cc63676655c6614fd535e21",
"date": "2018-04-18 19:37:35 -0400",
"subject": "Rename archive-queue-max option to archive-push-queue-max.",
"body": "This avoids confusion with the archive-get-queue-max option. The old option name will continue to be accepted."
},
{
"commit": "ab26c765d454cd8f757ccc7ada593746dbddae0d",
"date": "2018-04-18 18:57:45 -0400",
"subject": "Don't copy CFGDEF_NAME_ALT or CFGDEF_INHERIT when processing config option inheritance."
},
{
"commit": "ea4046a607cddef588b5eb061f1df1e602a497bf",
"date": "2018-04-18 18:47:43 -0400",
"subject": "Try tweaking time sync settings to prevent clock drift rather than restarting VBoxService on every test run."
},
{
"commit": "b3e668421b03b2869c0dac1be6f22a9faf753341",
"date": "2018-04-17 20:25:42 -0400",
"subject": "Fix document update missed in e9790fd3."
},
{
"commit": "0381945caa198f833adde7806af2368c2627678a",
"date": "2018-04-17 18:47:14 -0400",
"subject": "Show command parameters as well as command options in initial info log message."
},
{
"commit": "e9790fd3b13f87a7f4726471019ead36d5b7b08d",
"date": "2018-04-17 17:38:25 -0400",
"subject": "Update out-of-date description for the spool-path option."
},
{
"commit": "cf0ec44ededb357c4fe2783814a2575119a4c498",
"date": "2018-04-17 12:03:03 -0400",
"subject": "Rename Perl tests so they don't conflict with their C counterparts."
},
{
"commit": "dce11ce3cf0473b127e56c21436dd4c4159d8646",
"date": "2018-04-16 15:52:17 -0400",
"subject": "Generate code counts for all source files.",
"body": "The source files are also classified by type and purpose."
},
{
"commit": "3e229774840f82e4488d0077b07ae80971f7c385",
"date": "2018-04-16 15:25:50 -0400",
"subject": "Use pip 9.03 in test VMs.",
"body": "pip 10 drops support for Python 2.6 which is still used by the older test VMs."
},
{
"commit": "2a4ff2f904b411f623239f02f54cdb2622017298",
"date": "2018-04-13 16:05:52 -0400",
"subject": "Split cfgLoad() into multiple functions to make testing easier.",
"body": "Mainly this helps with unit tests that need to do log expect testing. Add harnessCfgLoad() test function, which allows a new config to be loaded for unit testing without resetting log functions, opening a log file, or taking locks."
},
{
"commit": "49fc737cd0fc053339f26b4e3b01d2b598124bb4",
"date": "2018-04-13 14:31:33 -0400",
"subject": "Add monitoring examples using PostgreSQL and jq.",
"body": "Suggested by Stephen Frost, Brian Faherty."
},
{
"commit": "d924f3d50a1be296a65096b0b1014ade14c2dd59",
"date": "2018-04-13 12:00:22 -0400",
"subject": "Add logic to find the real oid of the test1 database during restore testing."
},
{
"commit": "f0250dab4b7fba2eda57fc0a483352f7cd70d0ab",
"date": "2018-04-12 20:42:26 -0400",
"subject": "Move async forking and more error handling to C.",
"body": "The Perl process was exiting directly when called but that interfered with proper locking for the forked async process. Now Perl returns results to the C process which handles all errors, including signals."
},
{
"commit": "6fd0c3dcaa68e168b05364c699f6c1a6f87f1de0",
"date": "2018-04-11 09:36:12 -0400",
"subject": "Improved lock implementation written in C.",
"body": "Now only two types of locks can be taken: archive and backup. Most commands use one or the other but the stanza-* commands acquire both locks. This provides better protection than the old command-based locking scheme."
},
{
"commit": "4744eb93878da6b7aa2173be16928b081c865b1d",
"date": "2018-04-11 08:21:09 -0400",
"subject": "Add storagePathRemove() and use it in the Perl Posix driver.",
"body": "This implementation should be faster because it does not stat each file. It simply assumes that most directory entries are files so attempts an unlink() first. If the entry is reported by error codes to be a directory then it attempts an rmdir()."
},
{
"commit": "c9ce20d41a0c6edc3087511eaff5e0a80e95c8da",
"date": "2018-04-09 16:46:36 -0400",
"subject": "Skip version checks when testing in --dev mode."
},
{
"commit": "3bcf637aeeebfeb135e693fb0191dbb2c70f9420",
"date": "2018-04-08 12:57:02 -0400",
"subject": "Move archive-stop and expire tests to the mock module.",
"body": "These are mock integration tests so they should be grouped with the other mock integration tests."
},
{
"commit": "3b661f4ad550cfce993afc5d767ed7f2ac4cea81",
"date": "2018-04-08 12:16:32 -0400",
"subject": "Move help/version integration tests to mock/all.",
"body": "Help and version are covered by unit tests, so we really just to need to make sure there is output when called from the command line."
},
{
"commit": "741acfd7799b7b1b2afe850ccf078cf84a421353",
"date": "2018-04-08 10:19:24 -0400",
"subject": "Move test definitions to test/define.yaml.",
"body": "The location is better because it is no longer buried in the Perl test libs. Also, the data can be easily accessed from C."
},
{
"commit": "b77b4250964ca47ac622c83ae72bfc9d453ea5d7",
"date": "2018-04-07 19:44:00 -0400",
"subject": "Allow -DDEBUG_UNIT to be suppressed to test how debug macros behave."
},
{
"commit": "82751b3b511e9a55724d3836b2454df8c97d8a25",
"date": "2018-04-07 13:12:35 -0400",
"subject": "Split debug and assert code into separate headers.",
"body": "Assert can be used earlier because it only depends on the error-handler and not logging."
},
{
"commit": "e00f2dd4ad574c7680bce2126df4d320c9c8d6ac",
"date": "2018-04-06 21:46:45 -0400",
"subject": "More C type cleanup.",
"body": "* Remove typec.h entirely.\n* Order all typdefs above local includes."
},
{
"commit": "f3b56cf8f328dc68dc4c978f0d82d3f5efbbe939",
"date": "2018-04-06 17:04:52 -0400",
"subject": "Allow MemContext objects to be copied to a new parent.",
"body": "This makes it easier to create objects and then copy them to another context when they are complete without having to worry about freeing them on error. Update List, StringList, and Buffer to allow moves. Update Ini and Storage to take advantage of moves."
},
{
"commit": "b9f636cab470165ff0d69baa54efa5f8b2a79d43",
"date": "2018-04-05 22:38:11 -0400",
"subject": "Cleanup C types.",
"body": "* Remove pgBackRest defined types included with the C types.\n* Remove redefinition of standard C types."
},
{
"commit": "bd25248df02d4a21315e73c1a4dc28fe8458fe97",
"date": "2018-04-05 14:48:16 -0400",
"subject": "Abstract Posix storage driver code into a separate module."
},
{
"commit": "348278bb68ea4cebc3140404729f12fc63d6071d",
"date": "2018-04-03 21:30:15 -0400",
"subject": "Make backup directory sync more efficient.",
"body": "Scanning the entire backup directory can be very expensive if there are a lot of small tables. The backup manifest contains the backup directory list so use it to perform syncs instead of scanning the backup directory."
},
{
"commit": "0dce8ba2fa096faafa3871517458bfe6d742350f",
"date": "2018-04-03 20:54:18 -0400",
"subject": "Make backup.history sync more efficient.",
"body": "Only the backup.history/[year] directory was being synced, so check if the backup.history is newly created and sync it as well."
},
{
"commit": "58902722477518d7daa202241772bf499ea136a3",
"date": "2018-04-03 18:12:03 -0400",
"subject": "Fix directory syncs running recursively when only the specified directory should be synced.",
"body": "Reported by Craig A. James."
},
{
"commit": "46b6be6d7269ae35ff633736c4c5ddcde313d0d2",
"date": "2018-04-03 13:35:56 -0400",
"subject": "Fix header exclusion defines that do not match the general pattern."
},
{
"commit": "93fdb98d1500ca72a1d3355ed0c7ff23e27e074c",
"date": "2018-04-03 12:25:21 -0400",
"subject": "Storage object improvements.",
"body": "* Convert all functions to variadic functions.\n* Enforce read-only storage.\n* Add storageLocalWrite() helper function. Add storageExists(), storagePathCreate(), storageRemove(), and storageStat().\n* Add StorageFile object and storageOpenRead()/storageOpenWrite()."
},
{
"commit": "90f980fe91b8dff96523a8089613b31b4485b923",
"date": "2018-03-30 21:33:30 -0400",
"subject": "Remove documentation describing info --output=json as experimental."
},
{
"commit": "635caff573315d5fe0dd267f968a4c40c98d524f",
"date": "2018-03-30 19:10:34 -0400",
"subject": "Add ASSERT() that is preserved in production builds."
},
{
"commit": "a8721ffe118e0c6ae93f6bc45c6bb79aaf78b440",
"date": "2018-03-27 22:48:22 -0400",
"subject": "Improve logic for smart builds to include version changes."
},
{
"commit": "5518a2ac51be91f71bfed0e27eba5e8bb6e465d2",
"date": "2018-03-27 20:40:33 -0400",
"subject": "Full branch coverage for storage/storage module."
},
{
"commit": "c1ab7b3c98c0a21b2b1b78ef3e64dfd891f68a11",
"date": "2018-03-25 11:39:24 -0400",
"subject": "Start work on C handle io object and use it to output help."
},
{
"commit": "9001b9b9576cb2d852984214e8bdd3b583dc552f",
"date": "2018-03-24 14:11:29 -0400",
"subject": "Replace THROW_ON_SYS_ERROR() with THROW_SYS_ERROR().",
"body": "The former macro was hiding missing branch coverage for critical error handling."
},
{
"commit": "c7a6e9d2f2b58ca7832c58c3e25c65c1d03079e3",
"date": "2018-03-23 16:08:32 -0400",
"subject": "Document build improvements.",
"body": "* Perform apt-get update to ensure packages are up to date before installing.\n* Add -p to the repository mkdir so it won't fail if the directory already exists, handy for testing packages."
},
{
"commit": "dabf727d91704dac6bfd59019d112857cbf963f3",
"date": "2018-03-21 16:08:08 -0400",
"subject": "Include VM type in gcov path to avoid conflicts between VMs with different architectures."
},
{
"commit": "c6457b070f5bdf26bb9146004e5ba2116b161df7",
"date": "2018-03-21 13:46:08 -0400",
"subject": "Full branch coverage for config/parse module."
},
{
"commit": "b234f43c9d8e6abde99947c64e0776e0054091c8",
"date": "2018-03-21 09:18:48 -0400",
"subject": "Refactor usec to msec in common/time.c.",
"body": "The implementation provides usec resolution but this is not needed in practice and it makes the interface more complicated due to the extra zeros."
},
{
"commit": "31830bdc55bd603e90a13b54b81b919526cf03a5",
"date": "2018-03-20 16:08:52 -0400",
"subject": "Full branch coverage for all common/type modules."
},
{
"commit": "a2030da20048845c879c45279e839c9109a92418",
"date": "2018-03-20 16:01:38 -0400",
"subject": "Specify prefix for lcov output.",
"body": "This prevents pages from moving around depending on the subtest."
},
{
"commit": "f4ed36d128ba7bda602f0c6451325ce377f422b4",
"date": "2018-03-20 10:17:53 -0400",
"subject": "Add switch() to lcov branch exclusions.",
"body": "lcov requires default to show complete coverage but --Wswitch-enum enforces all enum values be present so no default is needed.\n\nAdd documentation for each branch exclusion."
},
{
"commit": "d34142dee82e41f983517a181f721d6009d70a81",
"date": "2018-03-20 09:47:51 -0400",
"subject": "Update lcov settings.",
"body": "Mark any coverage less that 100% as yellow, less that 90% as red.\n\nAdd comments to config file and make genhtml use it as well as lcov."
},
{
"commit": "07f38f584a6014e10888fe0f8016febab79ce67b",
"date": "2018-03-19 23:33:28 -0400",
"subject": "Use lcov for C unit test coverage reporting.",
"body": "Switch from Devel::Cover because it would not report on branch coverage for reports converted from gcov.\n\nBranch coverage is not complete, so for the time being errors will only be generated when statement coverage is not complete. Coverage of unit tests is not displayed in the report unless they are incomplete for either statement or branch coverage."
},
{
"commit": "2a3d6ecde8a86154cfaba067dfcbe459ef2aa8e1",
"date": "2018-03-19 21:49:41 -0400",
"subject": "v2.01: Minor Bug Fixes and Improvements"
},
{
"commit": "45c6a0e864189a309ad3e5c0f643b46dd50fb303",
"date": "2018-03-19 21:03:42 -0400",
"subject": "Remove hard-coded release version from loadTest.c."
},
{
"commit": "5b0748cf93d49d52bf74290e05c208fc88017a26",
"date": "2018-03-19 20:25:55 -0400",
"subject": "Always autogenerate code if --smart is not specified."
},
{
"commit": "f0a4264f77a7d9cb1dc5434e3c76c8313c600c79",
"date": "2018-03-19 19:54:03 -0400",
"subject": "Fix manifest test in the check command when tablespaces are present.",
"body": "Fixed by Cynthia Shang.\nReported by Thomas Flatley."
},
{
"commit": "8e9e97728c5f58790ba91305f465b04d8a7a061a",
"date": "2018-03-19 17:38:44 -0400",
"subject": "Remove --smart from --expect tests.",
"body": "This ensures that new binaries are built before running the tests."
},
{
"commit": "2c1687721e57b1917dc3f3bed62aa01b59078f5c",
"date": "2018-03-19 13:08:42 -0400",
"subject": "Fix issue where specifying log-level-stderr > warn would cause a local/remote process to error on exit due to output found on stderr when none was expected.",
"body": "The max value for a local/remote process is now error since there's no reason for these processes to emit warnings."
},
{
"commit": "0c313713b1f40f09a970bee70e4e1ca3bcbbe082",
"date": "2018-03-18 13:32:19 -0400",
"subject": "Use clang for static code analysis.",
"body": "Nothing found except for some functions that should have been marked __noreturn__."
},
{
"commit": "f0451c1494d0886c8fc24734eb8f98d403ce91dc",
"date": "2018-03-15 13:53:03 -0400",
"subject": "Enable -Wformat=2 and -Wformat-nonliteral and silence new warnings."
},
{
"commit": "8a1ce42c30e7e9ac79b1f7b66aa870d84c7419de",
"date": "2018-03-15 12:02:09 -0400",
"subject": "Immediately error when a secure option (e.g. repo1-s3-key) is passed on the command line.",
"body": "Since pgBackRest would not pass secure options on to sub-processes an obscure error was thrown. The new error is much clearer and provides hints about how to fix the problem.\n\nUpdate command documentation to omit secure options that cannot be specified on the command-line."
},
{
"commit": "dd3ce7081070aca3a5c915af2a7e642c3ebece4b",
"date": "2018-03-15 11:09:46 -0400",
"subject": "Config test code writes secure options to a file instead of passing on the command-line."
},
{
"commit": "4fb75c9cc1c594d462adb31b8146e789ce639fb3",
"date": "2018-03-15 11:03:28 -0400",
"subject": "Improve conversion of C exceptions to Exception objects.",
"body": "Colons in the message would prevent all of the message from being loaded into the Exception object."
},
{
"commit": "599e291b366e0c0217c81fad44a3f7cdbd800d98",
"date": "2018-03-14 14:34:06 -0400",
"subject": "Check int size in common/type.h.",
"body": "This ensures that integers are at least 32-bits without having to run the test suite."
},
{
"commit": "e7fd94ee23f7b0b353f926c55086c9163f6f4881",
"date": "2018-03-14 11:10:46 -0400",
"subject": "Simplify table of contents on command page by only listing commands.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "4b6cd92a4ca8de743ddf3d62e71e548ead06644b",
"date": "2018-03-12 17:15:14 -0400",
"subject": "Improve debugging.",
"body": "* Replace remaining NDEBUG blocks with the more granular DEBUG_UNIT.\n* Remove some debug memset() calls in MemContext since valgrind is more useful for these checks."
},
{
"commit": "cced6ec03aa212310a940e643cc8f2b484d95a8c",
"date": "2018-03-12 14:31:22 -0400",
"subject": "Add ASSERT_DEBUG() macro for debugging.",
"body": "Replace all current assert() calls except in tests that can't use the debug code."
},
{
"commit": "dd31ae832d6d5278079d5e84c471b0258f51940b",
"date": "2018-03-12 11:25:20 -0400",
"subject": "Port most of Config::Config::configLoad() from Perl to C.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "03f1082e86ac82477f09f212332e9c82946d28ad",
"date": "2018-03-12 11:03:38 -0400",
"subject": "Improve logging.",
"body": "Move command begin to C except when it must be called after another command in Perl (e.g. expire after backup). Command begin logs correctly for complex data types like hash and list. Specify which commands will log to file immediately and set the default log level for log messages that are common to all commands. File logging is initiated from C."
},
{
"commit": "94494a632f0d217810a0cd0da462529c6c60b032",
"date": "2018-03-12 11:02:46 -0400",
"subject": "Update pip before installing awscli."
},
{
"commit": "f047cd0dfd3de01ff4ea678f394af8302e89e7c0",
"date": "2018-03-09 23:00:20 -0500",
"subject": "Improve code generation performance."
},
{
"commit": "b987f05f3529654515e5cddee4057fe5f83cfd20",
"date": "2018-03-09 21:24:30 -0500",
"subject": "Improve bin and libc build performance."
},
{
"commit": "c32ee346128182b9742417c27b0ae9c5bd768cb8",
"date": "2018-03-09 18:28:34 -0500",
"subject": "Build with -DNDEBUG by default but disable for testing."
},
{
"commit": "fbe4c40386d9b8666514703996b5734d2719b652",
"date": "2018-03-09 09:30:50 -0500",
"subject": "Move logic for setting Perl configuration defaults to C."
},
{
"commit": "919635b6f42eff1c1de0638626314caf4b0e2f2a",
"date": "2018-03-08 16:24:16 -0500",
"subject": "Set config before Main::main() call to avoid secrets being exposed in a stack trace."
},
{
"commit": "34898ce471214e234e14d9532bbb34b8095381cc",
"date": "2018-03-08 14:15:05 -0500",
"subject": "Error when multiple arguments are set in the config file for an option that does not accept multiple arguments.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "e331564c9025077a0f3922408a90d5f8f18baed1",
"date": "2018-03-08 12:36:55 -0500",
"subject": "Add new test for Common::Io::Process.",
"body": "Show that output on stderr will raise an exception on close() even if the exit code is 0."
},
{
"commit": "62a9bdbd4c25b9801bcc6a4892d442f38e6d4da5",
"date": "2018-03-08 10:43:09 -0500",
"subject": "Fix issue passing --no-config to embedded Perl.",
"body": "Reported by Ibrahim Edib Kokdemir."
},
{
"commit": "5e0ce3e996db90c44eba835093549f9634525f21",
"date": "2018-03-06 17:12:16 -0500",
"subject": "Fix --target-action and --recovery-option options being reported as invalid when restoring with --type=immediate.",
"body": "Reported by Brad Nicholson."
},
{
"commit": "4c8ed3530c05e2a88a1515a1cdd31ac3871b4bc2",
"date": "2018-03-06 14:20:12 -0500",
"subject": "Show index in examples for indexed options, i.e. repo-*, pg-*.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "45ffe37e4ff3fd955a10bad93c17f443793855b8",
"date": "2018-03-05 18:51:48 -0500",
"subject": "Add cfgOptionTest().",
"body": "Update cfgOption() calls that are better implemented as cfgOptionTest()."
},
{
"commit": "a50b1eb5be64c0ea68c468cbe0b793be93136c33",
"date": "2018-03-05 10:03:10 -0500",
"subject": "Remove references to the C library being optional."
},
{
"commit": "c07aa2ae1940f2c6cf0f7a2e701b20e2d0c32ff9",
"date": "2018-03-02 22:42:02 -0500",
"subject": "Improve code documentation in config module."
},
{
"commit": "406acf9cba16fc93fdcd7d6ee93483ef8ef5d073",
"date": "2018-03-02 12:07:12 -0500",
"subject": "Enable -Wconversion and silence new warnings."
},
{
"commit": "6ca6424fb1b32fb43eafc481d179508e958e5e7e",
"date": "2018-03-01 16:59:49 -0500",
"subject": "Remove extraneous sudo commands from src/Makefile.",
"body": "Contributed by Adrian Vondendriesch."
},
{
"commit": "af805af044317265a786214bed4c506977e934b4",
"date": "2018-03-01 16:59:13 -0500",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "5d1722b8ef7dd86ef717ce0425fb5b55d73f5f1d",
"date": "2018-03-01 13:32:51 -0500",
"subject": "Disable console display of coverage for C files.",
"body": "Devel::Cover does not handle it well."
},
{
"commit": "57d70a5649c2d4f0500c495d0fb065d1eda06e4b",
"date": "2018-03-01 13:31:03 -0500",
"subject": "Remove RHEL package patch since upstream has been updated."
},
{
"commit": "5b491b3035502819a31e1200636c8d2757a78a18",
"date": "2018-02-26 19:32:27 -0500",
"subject": "Add CentOS/RHEL package builds."
},
{
"commit": "f9c1a3b156a07ecfd4916fe0386f90022406d721",
"date": "2018-02-26 10:43:49 -0500",
"subject": "Enable -Wswitch-enum and silence new warnings."
},
{
"commit": "c8df690931561c4b172d2ea48e68a0597e0a272b",
"date": "2018-02-26 10:02:33 -0500",
"subject": "Fix incorrect enum types in config.c that throw warnings under clang.",
"body": "Found by Douglas J Hunley."
},
{
"commit": "09223a733dd8a4b9fc3deeec72ee5a168a9c625d",
"date": "2018-02-23 23:44:10 -0500",
"subject": "Remove github CNAME file."
},
{
"commit": "1f954b324ae8c2ae43af1da2a97090dde586fb8f",
"date": "2018-02-23 23:42:29 -0500",
"subject": "Update how versions are displayed in the documentation."
},
{
"commit": "13cdb75ac56609c6a1d2f7cb3c31c0f0b29ecc3b",
"date": "2018-02-23 22:38:45 -0500",
"subject": "v2.00: Performance Improvements for Archive Push"
},
{
"commit": "ed5876810d616a6dc59bddf722f74cccd9b8ddec",
"date": "2018-02-23 14:16:20 -0500",
"subject": "Fix missing variable replace for PDF code-block title.",
"body": "Found by Jason O'Donnell."
},
{
"commit": "2485fabbadf56aa51f821048e72550ddac026691",
"date": "2018-02-22 09:31:53 -0500",
"subject": "PDF rendering improvements.",
"body": "* Fill is now the default for table columns.\n* Column width is specified as a percentage rather that using latex-specific notation."
},
{
"commit": "d4418e7764bf6b3d3e8b6d2bc204cfd0e00bca13",
"date": "2018-02-21 18:15:40 -0500",
"subject": "Rename pg-primary and pg-standby variables to pg1 and pg2.",
"body": "It would be better if the hostnames were also pg1 and pg2 to illustrate that primaries and standbys can change hosts, but at this time the configuration ends up being confusing since pg1, pg2, etc. are also used in the option naming. So, for now leave the names as pg-primary and pg-standby to avoid confusion."
},
{
"commit": "5eb682a569cdc4f33ea053e3619163c98aefcdd1",
"date": "2018-02-21 18:10:53 -0500",
"subject": "Add id param for hosts created with host-add.",
"body": "The host-*-ip variable is created from the id param so the name param can be changed without affecting the host-*-ip variable. If id is not specified then it is copied from name."
},
{
"commit": "246d4415079550f4f1391c09ad874c2cf4e3fa37",
"date": "2018-02-21 15:30:35 -0500",
"subject": "More flexible replacements for PDF titles and footers."
},
{
"commit": "aed578a4bd201d16512b1adb87a327504a0c335c",
"date": "2018-02-21 15:26:30 -0500",
"subject": "Allow sections to be excluded from table of contents in PDF output."
},
{
"commit": "64a7196cb64d90fe8801f7be6c4c634ba17bf32a",
"date": "2018-02-19 15:07:24 -0500",
"subject": "Rename retention-* options to repo-retention-*."
},
{
"commit": "f75ba7db9426dd05dc868beb00528aae04ea3a4b",
"date": "2018-02-19 13:17:58 -0500",
"subject": "Update backup host to repository host in the documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "435240777766afc7effb81cdb5e6cf03fea6e0fa",
"date": "2018-02-19 10:12:51 -0500",
"subject": "Option rename cleanup based on review.",
"body": "* Remove --reset tags from v1 options.\n* Use constants for repo prefix.\n* Specify CFGDEF_INDEX_PG in option structure rather than adding in code.\n* Fix error message references to \"backup host\"."
},
{
"commit": "f981283b8dea28214072ace05b67acc27989c76f",
"date": "2018-02-18 15:45:32 -0500",
"subject": "Remove exit() calls from main() to make it cleaner and more testable."
},
{
"commit": "599e41a2514eda36c1cd7f2a69754a5f94c30dcd",
"date": "2018-02-18 14:54:32 -0500",
"subject": "Improve S3 delete performance.",
"body": "The constant S3_BATCH_MAX had been replaced with a hard-coded value of 2, probably during testing."
},
{
"commit": "90703257603f04446872b2b39eea26fec2c1b460",
"date": "2018-02-18 14:53:27 -0500",
"subject": "Improve performance of HTTPS client.",
"body": "Buffering now takes the pending bytes on the socket into account (when present) rather than relying entirely on select(). In some instances the final bytes would not be flushed until the connection was closed."
},
{
"commit": "27678f6188534d1233eeb9424a6fa590c79a5c9d",
"date": "2018-02-18 10:44:58 -0500",
"subject": "Clean up and document Makefile."
},
{
"commit": "3eed4bbb4390ecf8d7f2b9ad349a568bfa06a9c8",
"date": "2018-02-16 15:09:37 -0500",
"subject": "PDF rendering improvements.",
"body": "* Check both doc-path and bin-path for logo.\n* Allow PDF to be output to a location other than the output directory.\n* Use PDF-specific version variable for more flexible formatting."
},
{
"commit": "0e27060952b49254574d017346beb8f834afee4f",
"date": "2018-02-16 14:55:48 -0500",
"subject": "Add table render for Markdown format.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "ca52a0485e23da55bd0c15299a52303c6de439bb",
"date": "2018-02-16 14:46:02 -0500",
"subject": "Allow code blocks to have a type.",
"body": "Currently this is only rendered in Markdown."
},
{
"commit": "2dc0737e95efc858bcc7e4318b3003b3bd57f5ee",
"date": "2018-02-16 14:39:42 -0500",
"subject": "Improve section source feature to not require a title or content.",
"body": "The title will be pulled from the source document."
},
{
"commit": "1f62237684f78b0d13268f7be59776a9cbd7f5d6",
"date": "2018-02-14 19:52:46 -0500",
"subject": "Clarify that S3 buckets must be created by the user.",
"body": "Suggested by David Youatt."
},
{
"commit": "72cbb9a9d47ec7a2066fbe12bd75619f9f43e4f7",
"date": "2018-02-14 17:19:54 -0500",
"subject": "Call Perl with built-in interpreter instead of execvp().",
"body": "Exec'ing Perl worked fine but generated a very large command line in the process list and potentially exposed secrets."
},
{
"commit": "81952c41f4592aec05ecd60f8097f4f1fcb83437",
"date": "2018-02-14 17:13:18 -0500",
"subject": "Report coverage errors via the console.",
"body": "This helps with debugging coverage issues on remote services like Travis."
},
{
"commit": "5f2884cb296a2c71dd9d6432c2c387efc96ceeef",
"date": "2018-02-14 16:46:52 -0500",
"subject": "Suppress coverage failures for Archive/Push/Async on Travis.",
"body": "The coverage report shows some code as never being run -- but that makes no sense because the tests pass. This may be due to trying to combine the C and Perl coverage reports and overwriting some runs.\n\nSuppress for now with a plan to implement LCOV for the C unit tests."
},
{
"commit": "a907fd7d2d21f01714427d0c769e3973a99f1a45",
"date": "2018-02-14 10:33:21 -0500",
"subject": "Build C binary/library for C unit tests that require Perl."
},
{
"commit": "fda62dfc485d435b4996137844f029464e87222c",
"date": "2018-02-14 09:49:01 -0500",
"subject": "Move Perl option JSON generation to a new module.",
"body": "Linking exec.c into LibC will not be an option once the perl exec loads the Perl interpreter."
},
{
"commit": "68a83ea2dcdc168aedefc856acc2c261889613fa",
"date": "2018-02-14 09:21:55 -0500",
"subject": "Add missing const to strLstAdd()."
},
{
"commit": "5242e8eec59b0cb91437fad95289dcc8b5dc61a7",
"date": "2018-02-14 09:18:27 -0500",
"subject": "Generate suppressions when running Valgrind.",
"body": "This makes it easier to suppress errors that are only occurring on Travis."
},
{
"commit": "00e9aca872745d2552aa1b562c0dc034fe867356",
"date": "2018-02-13 15:58:14 -0500",
"subject": "Fixed issue where --reset-* was not passing the default value to Perl.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "213724907b5eb3acd5af158601d74913f30af67f",
"date": "2018-02-09 22:27:21 -0500",
"subject": "Add contributor."
},
{
"commit": "a3b80768bdaf627a2fa71c561ebc8c1962196580",
"date": "2018-02-09 15:56:22 -0500",
"subject": "Merge 1.28 release notes."
},
{
"commit": "ea296372d4c920bdcfde85e138719f20d881f16c",
"date": "2018-02-09 15:42:11 -0500",
"subject": "Add allow range to int/float options that did not already have one."
},
{
"commit": "7c58fe7451666778b71d3b934d35dc1550a36387",
"date": "2018-02-09 13:54:33 -0500",
"subject": "Use 64-bit integers for config options.",
"body": "In particular, archive-queue-max requires a greater range than is provided by a 32-bit integer."
},
{
"commit": "305a3e176185edaedec68be5824c950121297213",
"date": "2018-02-09 13:52:02 -0500",
"subject": "Add int64 variant type."
},
{
"commit": "1659598cfe957f06e74f1584591337674cb19e81",
"date": "2018-02-08 16:11:47 -0500",
"subject": "Create a master list of errors in build/error.yaml.",
"body": "The C and Perl errors lists are created automatically by Build.pm so they stay up to date."
},
{
"commit": "eba31fbfe5e58c66b776c2c09a6a53a533819c20",
"date": "2018-02-08 14:49:35 -0500",
"subject": "Update URL for Debian package repository."
},
{
"commit": "7d13087c4b0bf2f5e3ca08065edc04a83c37f1b4",
"date": "2018-02-06 11:26:06 -0500",
"subject": "Rename -no to -reset for non-boolean options."
},
{
"commit": "808b6000eb4434a66d1073d8b903b1236a082445",
"date": "2018-02-05 15:48:26 -0500",
"subject": "Fix some bugs in C config code:",
"body": "1) Error when the same option is defined multiple times in a section using alternate names.\n2) Fix logging of invalid command error.\n3) Warn when a stanza-only option is in a global section.\n\nAlso, make a note to add validation of section names to the check command.\n\nPer review by Cynthia Shang."
},
{
"commit": "d35757c05f1b4b30c57997c6221d888660a4ee52",
"date": "2018-02-05 15:19:28 -0500",
"subject": "Fix missing log-level-stderr option for stanza-* commands."
},
{
"commit": "2074e6fbf9a4c0b7b5a8759e9dd9be2a9bd46b41",
"date": "2018-02-05 12:41:42 -0500",
"subject": "Move log option update to after fork() in archive-push.",
"body": "The log-level-console option should not be changed in the parent process. Even though it is harmless at the moment, that may not always be true.\n\nPer review by Cynthia Shang."
},
{
"commit": "c3f47bf240cc2eaf4c6fa441c0c2d95979477379",
"date": "2018-02-05 12:32:30 -0500",
"subject": "Move config parsing out of Perl tests.",
"body": "cfgParseTest() is provided in the C library for parsing configs in unit tests."
},
{
"commit": "db21b7a360fdc3aea4a22480c634b8d6f2ee52eb",
"date": "2018-02-05 11:50:09 -0500",
"subject": "Cleanup usage of internal options.",
"body": "Apply internal to options that need to be read to determine locality but should not appear in the help."
},
{
"commit": "be900281003f67c549630186482242cc40f0685b",
"date": "2018-02-03 18:27:38 -0500",
"subject": "Rename db-* options to pg-* and backup-* options to repo-* to improve consistency.",
"body": "* repo-* options are now indexed although only one is allowed.\n* List deprecated option names in documentation and command-line help."
},
{
"commit": "dc73abdb6e9612f7af8e38408639be53daba0575",
"date": "2018-02-01 14:12:03 -0500",
"subject": "Improve stanza-create command so that it does not error when the stanza already exists.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "298b33988c34ac5777c8174435e20a863dd6f730",
"date": "2018-01-31 18:22:25 -0500",
"subject": "Fix non-compliant formatting for function declarations.",
"body": "Per review by Cynthia Shang."
},
{
"commit": "b4d434b41c8302e48cf2f2dcec8a465378507b73",
"date": "2018-01-31 17:34:27 -0500",
"subject": "Update stanza-create --force documentation to urge caution when using.",
"body": "Suggested by Jason O'Donnell."
},
{
"commit": "bacc08792dae400de652ce2f769aeeda73f0ef8e",
"date": "2018-01-30 16:49:47 -0500",
"subject": "Ensure latest db-id is selected on when matching archive.info to backup.info.",
"body": "This provides correct matching in the event there are system-id and db-version duplicates (e.g. after reverting a pg_upgrade).\n\nFixed by Cynthia Shang.\nReported by Adam K. Sumner."
},
{
"commit": "00f58ec8c0349e6941ae6fd0957f2c1196ce0cad",
"date": "2018-01-30 16:13:54 -0500",
"subject": "Fixed inability to restore a single database contained in a tablespace using --db-include.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "a91a648019bc8871c9e74868c59a933d74c3dc5c",
"date": "2018-01-28 21:37:09 -0500",
"subject": "Config parsing no longer implemented in Perl.",
"body": "Options are passed to Perl as JSON from the C process."
},
{
"commit": "f0ef1dee05266f7be1acd8943a3bcda11f0d2e59",
"date": "2018-01-26 16:41:17 -0500",
"subject": "Improve speed of C unit tests.",
"body": "Preserve object files between tests and use a Makefile to avoid rebuilding object files."
},
{
"commit": "b58a45e0676f9bc5b7e2e136cd338db572a6a604",
"date": "2018-01-23 13:34:24 -0500",
"subject": "Implement help command in C."
},
{
"commit": "404ec30d039866a83d7c0707aaab838ccffe433f",
"date": "2018-01-23 12:58:35 -0500",
"subject": "Move Perl help test to real module."
},
{
"commit": "3dd882a79eb26b443f74aa8c34328add10baf976",
"date": "2018-01-23 12:49:04 -0500",
"subject": "Add internal flag to config definition."
},
{
"commit": "41bd5e8148b307e8285fa855dc715b889d5a0617",
"date": "2018-01-23 12:40:02 -0500",
"subject": "Improve KeyValue object.",
"body": "Add kvGetList() to get a value as a list (of 1) even if it is a scalar."
},
{
"commit": "2afb73da1cac6447c01a042fe7105e9910f3b20e",
"date": "2018-01-23 12:17:30 -0500",
"subject": "Improve String, StringList, and List objects.",
"body": "* Add strCmp*() and strFirst*() to String.\n* Add strLstSort() and strLstNewSplitSize() to StringList.\n* Add strLstNewSplitZ() to StringList a update calls to strLstNewSplit() as needed.\n* Add lstSort to List."
},
{
"commit": "47c048b42a0cbf45d97da701521b8ddaeccfd2cf",
"date": "2018-01-18 08:56:03 -0500",
"subject": "Update LICENSE.txt for 2018."
},
{
"commit": "2cc9b2287bf4bf7bc0a4b98f274bb737e0d5e961",
"date": "2018-01-17 15:52:00 -0500",
"subject": "The archive-push command is now partially coded in C.",
"body": "This allows the PostgreSQL archive_command to run significantly faster when processing status messages from the asynchronous archive process."
},
{
"commit": "a4c058d070dfc6f6098fad051a14893ef449eae6",
"date": "2018-01-17 15:03:55 -0500",
"subject": "Add 30 second wait loop to lockAcquire() when fail on no lock enabled.",
"body": "This should help prevent processes that are shutting down from interfering with processes that are starting up."
},
{
"commit": "1f39a34abc65c43a0635403b246168acdef4dbbe",
"date": "2018-01-17 10:31:21 -0500",
"subject": "Move lock release later in exitSafe().",
"body": "This reduce the chance of a new process starting and acquiring a lock before the old process has exited."
},
{
"commit": "7c73f4f6c981e8a2806bbca3c035d7ba1e6c7713",
"date": "2018-01-17 09:15:51 -0500",
"subject": "Add command and exit modules."
},
{
"commit": "39cb971afb79b1368b9f1dd9185ad49fbb0de9c5",
"date": "2018-01-16 13:52:20 -0500",
"subject": "Add log module."
},
{
"commit": "eb452c8addb345c02246b8c97e088cca6c66c6d1",
"date": "2018-01-16 13:38:37 -0500",
"subject": "Improvements to Storage object.",
"body": "* storagePath() and storageList() commands\n* Helper functions for local and spool storag"
},
{
"commit": "8f81620b9f5a8de4f2d2ebb0a5ecc2fe49d26435",
"date": "2018-01-16 13:29:27 -0500",
"subject": "Improve error module.",
"body": "Add functions to convert error codes to C errors and handle system errors."
},
{
"commit": "bffc6c49b31a98fc5a6ae68b80db0251da6e9441",
"date": "2018-01-16 13:23:08 -0500",
"subject": "Add perl-bin option to specify the Perl binary location when /usr/bin/env perl won't work."
},
{
"commit": "d633417e5db447e3689097c1d31ad1356eb94745",
"date": "2018-01-16 13:05:00 -0500",
"subject": "Add Wait object and time module."
},
{
"commit": "721d1127a03b9fbd3fab04554c92f949954cf514",
"date": "2018-01-16 12:57:23 -0500",
"subject": "Add RegExp object."
},
{
"commit": "05c731692b93d171ffdd0e0e297c2274998bfc16",
"date": "2018-01-16 12:54:06 -0500",
"subject": "Add varStrForce() to Variant object."
},
{
"commit": "83ddd75d824fca293d88bb53f7349cf637926458",
"date": "2018-01-16 12:47:08 -0500",
"subject": "Improvements to String object.",
"body": "* Add strBeginsWith(), strEndsWith(), strEq(), and strBase().\n* Enable compiler type checking for strNewFmt() and strCatFmt().\n* Rename strNewSzN() to strNewN()."
},
{
"commit": "d992851456f4aef9a0218be0411f1d6815fb9be0",
"date": "2018-01-16 12:36:22 -0500",
"subject": "Rename Perl tests so they don't conflict with their C counterparts."
},
{
"commit": "0e9ba98a50159fc1f26792f9032603fae0aed24c",
"date": "2018-01-03 12:23:33 -0500",
"subject": "Add stanza-delete command to cleanup unused stanzas.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "526acca5bd7d86a7d8b34a1eb37ec3e49e042073",
"date": "2017-12-22 23:27:49 -0500",
"subject": "Config parsing implemented in C."
},
{
"commit": "d8c575801daf6d17e6cbf2daeb2d265c75199032",
"date": "2017-12-22 22:55:17 -0500",
"subject": "Add Ini object."
},
{
"commit": "69488ca8ff11f8256b89828e97f62c8b7039bd4f",
"date": "2017-12-22 22:36:01 -0500",
"subject": "Add Storage object."
},
{
"commit": "b2a64b1f43be7045ba904b156225496bc6dd405e",
"date": "2017-12-22 22:05:37 -0500",
"subject": "Add KeyValue object."
},
{
"commit": "2add6cef95beba05e9c2539d8831273a5b675163",
"date": "2017-12-22 21:50:27 -0500",
"subject": "Add Variant and VariantList objects."
},
{
"commit": "c4b30af64598579f87b0556d974264a9248e5e82",
"date": "2017-12-22 19:56:01 -0500",
"subject": "Add Buffer object."
},
{
"commit": "f89b027decd35c87ee9b531db1a2d0bf5c671802",
"date": "2017-12-22 19:30:15 -0500",
"subject": "Improve String and StringList modules."
},
{
"commit": "5667932063454d0a8851aa1f43b07933307de655",
"date": "2017-12-22 18:54:39 -0500",
"subject": "Improve MemContext module.",
"body": "Add temporary context blocks and refactor allocation arrays to include allocation size."
},
{
"commit": "5ea1263d8e4541405722a0064a133f71be8fedaf",
"date": "2017-12-22 18:36:36 -0500",
"subject": "Run valgrind on all C unit tests.",
"body": "Also refactor code to make valgrind happy."
},
{
"commit": "b00c6d86b3020bb2babdd6d1c77c7ffd61594862",
"date": "2017-12-19 20:27:31 -0500",
"subject": "Merge 1.27 release notes."
},
{
"commit": "70e38a2bd6cad0697128a637f471ec39f1d50c1b",
"date": "2017-12-19 19:14:16 -0500",
"subject": "Deploy historical documentation to prior rather than the root directory."
},
{
"commit": "9fe265d24c55caa4cc7f67cc65e3ee36cf35bd7d",
"date": "2017-12-19 17:03:17 -0500",
"subject": "No longer run master branch through CI.",
"body": "The integration branch will be run through CI and then pushed to master with github status checks."
},
{
"commit": "c34a76690fbceb8f7289c23206a9c9fcbe874c17",
"date": "2017-12-19 15:39:39 -0500",
"subject": "Fixed info command to eliminate \"db (prior)\" output if no backups or archives exist for a prior version of the cluster.",
"body": "Fixed by Cynthia Shang.\nReported by Stephen Frost."
},
{
"commit": "717a14754202b8662fbec5356ce825fd293bb6c8",
"date": "2017-12-18 18:55:15 -0500",
"subject": "Update command-line help from commits 58b08930 and 0bfda1a9."
},
{
"commit": "ef3ef85c33ac871a4910267b34757e8fcbb7e59c",
"date": "2017-12-18 18:51:19 -0500",
"subject": "Fixed an issue where WAL was not expired on PostgreSQL 10.",
"body": "This was caused by a faulty regex that expected all PostgreSQL major versions to be X.X."
},
{
"commit": "3cc367185e1a9bec69954895ecb6ae9d54c8d71f",
"date": "2017-12-15 11:12:37 -0500",
"subject": "Add documentation for command-line negation."
},
{
"commit": "41f5b2cec2e065b8a9ed9245c5338772ad7e77d8",
"date": "2017-12-14 15:44:06 -0500",
"subject": "All clusters in the documentation are initialized with checksums."
},
{
"commit": "e5511d0f82839cd8a13d938e4035ffada872067a",
"date": "2017-12-13 11:16:27 -0500",
"subject": "Improve check command to verify that the backup manifest can be built.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0bfda1a908edd1ca4990a330ba2dcec7260ccd02",
"date": "2017-12-11 07:48:30 -0500",
"subject": "Document the relationship between the archive-copy and archive-check options.",
"body": "Suggested by Markus Nullmeier."
},
{
"commit": "58b0893067fe33fbeb1e23eb96e080c2d5a9b8ba",
"date": "2017-12-11 07:31:30 -0500",
"subject": "Improve archive-copy reference documentation."
},
{
"commit": "99a072163192e7546632119df89511a173d9048e",
"date": "2017-12-05 15:23:32 -0500",
"subject": "Allow any non-boolean, non-command-line option to be negated.",
"body": "This allows specific options in pgbackrest.conf to be ignored (and set to default) which reduces the need to write new configuration files for specific needs.\n\nNote that boolean, non-command-line options are already negatable."
},
{
"commit": "c5fc88d34097ba03cd4fce3fbfce1f4c337b83e6",
"date": "2017-12-05 14:59:09 -0500",
"subject": "Fixed an issue that suppressed locality errors for backup and restore.",
"body": "When a backup host is present, backups should only be allowed on the backup host and restores should only be allowed on the database host unless an alternate configuration is created that ignores the remote host."
},
{
"commit": "5eb5d94d65ee159605273b57e504652c980c9cc7",
"date": "2017-12-05 14:46:52 -0500",
"subject": "Allow internal options that do not show up in the documentation.",
"body": "Used for test options initially but other use cases are on the horizon."
},
{
"commit": "8d4674031e63d7a3c0bfc07f2524551dcf1474de",
"date": "2017-12-05 10:09:07 -0500",
"subject": "More config parsing in C in preparation for all config parsing in C."
},
{
"commit": "4f1725dc3684233b444d6d0c0efe6bce6468a623",
"date": "2017-12-05 09:45:51 -0500",
"subject": "Replace cfgCommandTotal()/cfgOptionTotal() functions with constants.",
"body": "The constants are applicable in more cases and allow the compiler to optimize certain loops more efficiently."
},
{
"commit": "59fd92fdd5c39f0c48897513a2d01205efa278e4",
"date": "2017-12-03 17:08:49 -0500",
"subject": "Move restore test infrastructure to HostBackup.pm.",
"body": "Required to test restores on the backup server, a fairly common scenario.\n\nImprove the restore function to accept optional parameters rather than a long list of parameters. In passing, clean up extraneous use of strType and strComment variables."
},
{
"commit": "915ae5662abc9a0e31e03d56bf27b739ed8b263b",
"date": "2017-11-28 21:44:05 -0500",
"subject": "Implement version command in C."
},
{
"commit": "bd74711ceb1d3faf49f0349d4dbef4f4cd8434ba",
"date": "2017-11-28 11:44:24 -0500",
"subject": "Add unit tests for the Manifest module.",
"body": "Also minor changes to Manifest module, mostly for test reproducibility."
},
{
"commit": "4a0eb6863d3517151fdec6b450bac2fa2c7ddfb4",
"date": "2017-11-27 22:16:24 -0500",
"subject": "Sync time to prevent build failures when running on VirtualBox."
},
{
"commit": "332861c6c95966b38b457b785c2a8db39d205648",
"date": "2017-11-27 21:19:59 -0500",
"subject": "Only build C binary/library for Perl unit/integration tests."
},
{
"commit": "2ed426a70b5659cbf1628eb4aaf8c7994580ea63",
"date": "2017-11-27 20:43:44 -0500",
"subject": "Remove deprecated archive-max-mb option."
},
{
"commit": "c5ea53bcf9a07cd07bb077a5764b3cc164e8424b",
"date": "2017-11-27 16:02:49 -0500",
"subject": "Add coding standards document."
},
{
"commit": "74d6398ad2a893b1413c8202814c6284846087da",
"date": "2017-11-26 18:43:51 -0500",
"subject": "The pgbackrest executable is now a C binary instead of Perl.",
"body": "This allows certain time-critical commands (like async archive-push) to run more quickly."
},
{
"commit": "4d8ad4ac18498835107a26f1a442429ac9dcf50c",
"date": "2017-11-26 18:23:11 -0500",
"subject": "Add List and StringList objects to simplify list handling."
},
{
"commit": "1b3e8e0a5bd8a343a78ecfb51f78d22b405b9a9f",
"date": "2017-11-26 17:49:10 -0500",
"subject": "Add String object to simplify string handling."
},
{
"commit": "7cf955425ef998ba198f9668f69c2052c089dcd8",
"date": "2017-11-26 17:45:00 -0500",
"subject": "The C library is now required.",
"body": "This eliminates conditional loading and eases development of new library features."
},
{
"commit": "c164fc5fb906d73fcc4d5dcfd960d62caa57effb",
"date": "2017-11-26 12:22:50 -0500",
"subject": "Add memGrowRaw() to memory context module."
},
{
"commit": "c360ca5a08ecd812610a0a26414e650da6b4b50e",
"date": "2017-11-25 20:32:35 -0500",
"subject": "Split \"refactor\" sections into \"improvements\" and \"development\" in the release notes.",
"body": "Many development notes are not relevant to users and simply clutter the release notes, so they are no longer shown on the website."
},
{
"commit": "13893a97313757162e061b855bbd494abdbec8ce",
"date": "2017-11-21 19:52:56 -0500",
"subject": "Relax permissions set by release.pl."
},
{
"commit": "ba6b49ecb7226e5dab0990403afa6f8878048e35",
"date": "2017-11-21 18:31:54 -0500",
"subject": "v1.26: Repository Encryption"
},
{
"commit": "033dbcdc208657e3569c0197ec98e9ff1a052ff1",
"date": "2017-11-21 17:59:30 -0500",
"subject": "Update release.pl to push data to site repository."
},
{
"commit": "ac54aac448e1ed84f6d083fcf95158619d729be3",
"date": "2017-11-21 13:17:44 -0500",
"subject": "Fixed an issue passing parameters to remotes.",
"body": "When more than one db was specified the path, port, and socket path would for db1 were passed no matter which db was actually being addressed."
},
{
"commit": "c77fc1fa61582e1983324e7caa5b573fc0eae5e8",
"date": "2017-11-21 12:57:00 -0500",
"subject": "Refactor protocol param generation into a new function.",
"body": "This allows the code to be tested more precisely and doesn't require executing a remote process."
},
{
"commit": "062e714307de357ae49bcac8c48e397b1debfa0f",
"date": "2017-11-21 09:31:15 -0500",
"subject": "Disable gzip filter when --compress-level-network=0.",
"body": "The filter was used with compress level set to 0 which added overhead without any benefit."
},
{
"commit": "1da63aff07de90cd7734b5afd2674b1452c59cf3",
"date": "2017-11-20 12:46:35 -0500",
"subject": "Fixed an issue with invalid backup groups being set correctly on restore.",
"body": "If the backup cannot map a group to a name it stores the group in the manifest as false then uses either the owner of $PGDATA to set the group during restore or failing that the group of the current user. This logic was not working correctly because the selected group was overwriting the user on restore leaving the group undefined and the user incorrectly set to the group. (Reported by Jeff McCormick.)"
},
{
"commit": "8ccfaa9ad366802525cbf1053af2226f2789b493",
"date": "2017-11-20 09:05:55 -0500",
"subject": "Designate a single distro (Ubuntu 16.04) for C coverage testing",
"body": "Enable optimizations on the distros that don't do coverage testing."
},
{
"commit": "deae0b8cd7ec102babf584698b15e73a7822283c",
"date": "2017-11-20 08:58:47 -0500",
"subject": "Refactor C page checksum unit test to compile with -Wstrict-aliasing."
},
{
"commit": "5d741ea9a9993397bd7aa6602ff8562302d82c8e",
"date": "2017-11-19 16:46:31 -0500",
"subject": "Refactor C unit test macros so they compile with -Wstrict-aliasing."
},
{
"commit": "3b43047e0d40ea7e00049df77d20f26498c89be1",
"date": "2017-11-19 16:44:33 -0500",
"subject": "Disable -Wclobber compiler warning.",
"body": "...because it is mostly useless but keep the rest of of -Wextra."
},
{
"commit": "dc1a5c18acfef55f8d4cdfa21e9543975070b373",
"date": "2017-11-19 16:30:23 -0500",
"subject": "Wrap try in a do...while loop to make sure that no random else is attached to the main if block."
},
{
"commit": "9395ad7043d4d7ef8a687e0baa5d25e98d553112",
"date": "2017-11-18 22:49:43 -0500",
"subject": "Improve base64 implementation.",
"body": "Different encoded strings could be generated based on compiler optimizations. Even though decoding was still successful the encoded strings did not match the standard."
},
{
"commit": "500d6b4b66fab197ae39db2d3f79a3e7ef29f66c",
"date": "2017-11-18 20:14:14 -0500",
"subject": "Automated tests for 32-bit i386/i686 architecture."
},
{
"commit": "8a3425ec04fea8c0876df0420d5dd3e318812c4e",
"date": "2017-11-18 20:02:54 -0500",
"subject": "Automate generation of WAL and pg_control test files.",
"body": "The existing static files would not work with 32-bit or big-endian systems so create functions to generate these files dynamically rather than creating a bunch of new static files."
},
{
"commit": "b701cd5a5f43ffd5b39df5298bd66ea886dedbdd",
"date": "2017-11-18 19:53:41 -0500",
"subject": "Designate a single distro (Ubuntu 16.04) for Perl coverage testing.",
"body": "Running coverage testing on multiple distros takes time but doesn't add significant value. Also ensure that the distro designated to run coverage tests is one of the default test distros."
},
{
"commit": "6ef2167e972039e67668d7f7700aab505d0ea595",
"date": "2017-11-16 17:18:51 -0500",
"subject": "Fixed an issue retrieving WAL for old database versions.",
"body": "After a stanza-upgrade it should still be possible to restore backups from the previous version and perform recovery with archive-get. However, archive-get only checked the most recent db version/id and failed.\n\nAlso clean up some issues when the same db version/id appears multiple times in the history.\n\nFixed by Cynthia Shang.\nReported by Clinton Adams."
},
{
"commit": "550d4fb9c591a269253a675f6f3585a777ea9b33",
"date": "2017-11-16 16:53:49 -0500",
"subject": "Fix incorrect WAL offset for 32-bit architectures.",
"body": "Fixed by Javier Wilson."
},
{
"commit": "1cb11a582de59480af3a5f656dbb0ec3da14e854",
"date": "2017-11-15 13:17:57 -0500",
"subject": "Fix flapping protocol timeout test.",
"body": "It only matters that the correct error code is returned, so disable logging to prevent message ordering from failing the expect test."
},
{
"commit": "bc8543494a07ef126b0d223e7a90da22a26389e8",
"date": "2017-11-15 11:59:27 -0500",
"subject": "Add template to improve initial information gathered for issue submissions.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "22fe684b1fe213df6c9a74a7c0bec4aa6eed3837",
"date": "2017-11-14 17:16:39 -0500",
"subject": "Only check expect logs on CentOS 7.",
"body": "Variations in distros cause false negatives in tests but don't add much value."
},
{
"commit": "3ee269c0998ea3bbf96ccbcc04857ba6b9789146",
"date": "2017-11-14 17:07:22 -0500",
"subject": "Add encryption to features list."
},
{
"commit": "b8746f368dbd76eee19e4c3fecc6853696be1908",
"date": "2017-11-14 15:12:31 -0500",
"subject": "Inflate performance improvement for gzip filter and full unit test coverage."
},
{
"commit": "04e55fe71bea32b2666df59a9891362ea6717964",
"date": "2017-11-14 14:48:44 -0500",
"subject": "Fixed an issue that could cause copying large manifests to fail during restore.",
"body": "Reported by Craig A. James."
},
{
"commit": "cf7da546a3b7c1395faf2958f45572f82fe0127a",
"date": "2017-11-13 21:22:13 -0500",
"subject": "Simplify try..catch..finally names."
},
{
"commit": "bcdfc7d0b52dc92ae22aef1c93bbfda7e6fa24f3",
"date": "2017-11-06 22:55:34 -0500",
"subject": "Enable additional warnings for C builds."
},
{
"commit": "b03c26968a2817df33b60c8240cbe2c037281783",
"date": "2017-11-06 12:51:12 -0500",
"subject": "Repository encryption support.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "f07d2a3d0dbfa7ea510e41a9ea66265b46db1158",
"date": "2017-11-06 12:40:54 -0500",
"subject": "Add eof to S3 file driver (required for encryption support)."
},
{
"commit": "8d6a08a32b1221db5b6eae0db615731d19754bc8",
"date": "2017-11-03 13:57:58 -0400",
"subject": "Library code for repository encryption support."
},
{
"commit": "ac542788da8264e39b3f3d817535df918f65a342",
"date": "2017-11-02 08:14:13 -0400",
"subject": "Convert configuration definitions from auto-generated functions to auto-generated data structures."
},
{
"commit": "2be93036f1c8de73414650fd6c6710e2f2b9fc73",
"date": "2017-10-30 14:18:05 -0400",
"subject": "Clarify usage of the archive-timeout option.",
"body": "Also describe how it is distinct from the PostgreSQL archive_timeout setting."
},
{
"commit": "55f68ef0136362be1ee8dbe3dabd1b3132e485d1",
"date": "2017-10-30 10:58:04 -0400",
"subject": "Remove configurable option hints.",
"body": "db-path was the only option with a hint so the feature seemed wasteful. All missing stanza options now output the same hint without needing configuration."
},
{
"commit": "1ef27ec8c2273fce99685c9354a6778d14a54792",
"date": "2017-10-30 10:50:35 -0400",
"subject": "Add list type for options.",
"body": "The hash type was being used for lists with an additional flag (`value-hash`) to indicate that it was not really a hash."
},
{
"commit": "f57e376c4489cba94b5dba443e6421b085ef9ea4",
"date": "2017-10-30 09:29:46 -0400",
"subject": "Update Debian/Ubuntu containers to download lastest version of pip."
},
{
"commit": "85b35f30a4a4ea07e92ad5ded6ce73bc2937f0ef",
"date": "2017-10-24 17:36:21 -0400",
"subject": "v1.25: S3 Performance Improvements"
},
{
"commit": "8674a4f7aea3bea2db7e92be599c034170b81706",
"date": "2017-10-24 12:35:36 -0400",
"subject": "Allow functions with sensitive options to be logged at debug level with redactions.",
"body": "Previously, functions with sensitive options had to be logged at trace level to avoid exposing them. Trace level logging may still expose secrets so use with caution."
},
{
"commit": "b2cc65d886a5c1fe4845f655c53b0c809beefb72",
"date": "2017-10-24 10:35:42 -0400",
"subject": "Improve performance of test code.",
"body": "Wait when all tests have been assigned to reduce CPU load."
},
{
"commit": "d989cf8ac21e0978174cc94747965743f252a45d",
"date": "2017-10-22 19:07:17 -0400",
"subject": "Replace dynamically built class hierarchies in I/O layer with fixed parent() calls."
},
{
"commit": "d82fe88031a3c9ca88bd70652bc4f9fc0e12d4bf",
"date": "2017-10-22 18:05:46 -0400",
"subject": "Fix custom settings for compress-level option being ignored.",
"body": "Reported by Jens Wilke."
},
{
"commit": "3553ccae449b7b9ad71290234e55c57d9c9455a5",
"date": "2017-10-22 13:27:47 -0400",
"subject": "Add I/O performance tests."
},
{
"commit": "9b98c2e7d6492b626267ffa0c50c67922dd43bda",
"date": "2017-10-22 13:11:03 -0400",
"subject": "Run all tests on tempfs rather than local disk."
},
{
"commit": "e1cb9ae86a596d0c1e833ba60730e65805c4ef4f",
"date": "2017-10-21 14:40:14 -0400",
"subject": "Improve labeling for errors in helper processes."
},
{
"commit": "44c7c0475ad30873075751ea23083861fe53278a",
"date": "2017-10-21 14:11:33 -0400",
"subject": "Improve protocol error handling.",
"body": "In particular, \"stop\" errors are no longer reported as \"unexpected\"."
},
{
"commit": "1f120f3fce1f8f30739a0cc178e8eea2053fd2f2",
"date": "2017-10-20 14:10:16 -0400",
"subject": "Improve performance of list requests on S3.",
"body": "Any beginning literal portion of a filter expression is used to generate a search prefix which often helps keep the request small enough to avoid rate limiting."
},
{
"commit": "f4524aeaa92baf2cdae2125c87661036e2bdc0a0",
"date": "2017-10-18 11:14:26 -0400",
"subject": "Add base64 encode/decode."
},
{
"commit": "2d56de00fcb04f2f949c1855f68cbeee25cdee6f",
"date": "2017-10-18 08:42:32 -0400",
"subject": "Fix instances where database-id was not rendered as an integer in JSON info output.",
"body": "Fixed by Cynthia Shang.\nReported by Jason O'Donnell."
},
{
"commit": "b1efd598cfe82c02db1a5943cd900dfc4be28e05",
"date": "2017-10-16 18:21:47 -0400",
"subject": "Add PostgreSQL versions to Debian VMs for testing."
},
{
"commit": "c94e52f697cdae67c35fe8cb0f95088029231b95",
"date": "2017-10-16 14:34:44 -0400",
"subject": "Remove error when overlapping timelines are detected.",
"body": "Overlapping timelines are valid in many Point-in-Time-Recovery (PITR) scenarios."
},
{
"commit": "583a76f605cd49d03fe2fe4a756e7de08966a62d",
"date": "2017-10-16 11:25:49 -0400",
"subject": "Add C memory contexts."
},
{
"commit": "6f5186f9e620693815133dc1444c0b627a3ab6a1",
"date": "2017-10-16 11:13:51 -0400",
"subject": "Convert config tests into C unit tests."
},
{
"commit": "9d78948a14b20813201b5bf7f21e3525577aa7dc",
"date": "2017-10-16 11:03:06 -0400",
"subject": "Improvements to page checksum module and tests:",
"body": "* Page checksum module uses new C error handler.\n* Convert page checksum tests into C unit tests."
},
{
"commit": "80758f002311dd58497f95a5fd9a8f9de92920e8",
"date": "2017-10-16 10:54:35 -0400",
"subject": "Add test macros for C results and errors."
},
{
"commit": "904b83747cd8140aa64a0eb2ac598cc8c1cf310b",
"date": "2017-10-16 10:47:31 -0400",
"subject": "Perl error handler recognizes errors thrown from the C library."
},
{
"commit": "f1e739b4aa85f4b57613b8191e29c2abd303ed8e",
"date": "2017-10-16 10:09:56 -0400",
"subject": "Add C error handler.",
"body": "Basic try ... catch ... finally pattern to simplify error handling in C."
},
{
"commit": "10dfbd90b5c3af6ebb6c651760d2d62ced738b84",
"date": "2017-10-12 12:55:48 -0400",
"subject": "Add C unit test infrastructure."
},
{
"commit": "08d6f14603e7248dd7cc865129527963d9e3df49",
"date": "2017-10-10 18:21:44 -0400",
"subject": "Add LibC.template.pm to simplify LibC module generation."
},
{
"commit": "abea4d1fd5f8cd2a8e0c8625dbb3d700b5317cc7",
"date": "2017-10-05 12:33:13 -0400",
"subject": "Remove Debian test repo after PostgreSQL 10 release."
},
{
"commit": "d89b7d5862201051732274f622742888dbf09315",
"date": "2017-09-30 10:48:25 -0400",
"subject": "Warnings in C builds treated as errors."
},
{
"commit": "8efcc38304dae4e224ae1ac0211ed03691ae5c8a",
"date": "2017-09-30 10:44:03 -0400",
"subject": "Improvements in C codebase:",
"body": "* Update C naming conventions.\n* Use int datatype wherever possible.\n* Better separation of C source from Perl interface."
},
{
"commit": "d0bf946857d73dcca2ce2a7bf0b78fd8aee2a19b",
"date": "2017-09-28 19:06:41 -0400",
"subject": "v1.24: New Backup Exclusions"
},
{
"commit": "40a85e34f1b12620b5520f620779396b7ead525a",
"date": "2017-09-20 19:57:05 -0400",
"subject": "Improve C library smart build.",
"body": "Ignore changes outside of /lib/pgBackRest/Config."
},
{
"commit": "4d6c56b4d76572f5a45a45ca8f55ddc269d2d6d1",
"date": "2017-09-20 08:08:36 -0400",
"subject": "Open log file after async process is completely separated from the main process.",
"body": "This prevents the main process from also logging to the file."
},
{
"commit": "266c9ddcc12c377dd2b3d90b79468eaa6c22f101",
"date": "2017-09-19 10:14:18 -0400",
"subject": "Fixed an issue where some db-* options (e.g. db-port) were not being passed to remotes."
},
{
"commit": "c857015a38edd6db641987f8084930f59cfb9309",
"date": "2017-09-19 10:03:53 -0400",
"subject": "Fixed an issue where warnings were being emitted in place of lower priority log messages during backup from standby initialization."
},
{
"commit": "d36c52271f994fc6332c40c9a101f9451ccb7266",
"date": "2017-09-17 15:52:19 -0400",
"subject": "Break up LibC.xs into separate module files."
},
{
"commit": "20af8ecf505f3b8b490dfb76969d5e39dabf0362",
"date": "2017-09-17 14:49:23 -0400",
"subject": "Dynamically generate list of files for C library build."
},
{
"commit": "7c95a2f4de43905bc7b22afbc8d70432156bc033",
"date": "2017-09-08 21:50:00 -0700",
"subject": "Updates to installation documentation.",
"body": "* Add trusted SSH configuration.\n* Add full installation where required and remove doc containers that included parts of the installation."
},
{
"commit": "4bcef7020ee25104b687580a7089a06d4b597cf8",
"date": "2017-09-07 10:59:40 -0700",
"subject": "Rename master to primary in documentation to align with PostgreSQL convention."
},
{
"commit": "6343fdd5846ef05d9f4883d8ffd09e0b47f744ce",
"date": "2017-09-04 08:26:57 -0400",
"subject": "Additional backup exclusions.",
"body": "* Exclude contents of pg_snapshots, pg_serial, pg_notify, and pg_dynshmem from backup since they are rebuilt on startup.\n* Exclude pg_internal.init files from backup since they are rebuilt on startup."
},
{
"commit": "df1ec0aaeb02fb1359f5f893dad8af06c2e05eeb",
"date": "2017-09-03 17:42:00 -0400",
"subject": "v1.23: Multiple Standbys and PostgreSQL 10 Support"
},
{
"commit": "eea2ccc3ab52ee588d6f894d291931bd9aa52147",
"date": "2017-09-03 16:48:41 -0400",
"subject": "Add HTTP retries to harden against transient S3 network errors."
},
{
"commit": "80e5e8db01b97ad7878817152d2a9a933d59d415",
"date": "2017-09-01 19:16:57 -0400",
"subject": "Increase HTTP timeout for S3."
},
{
"commit": "75511d24813266b87a7b65e25141f2fd6b1dd78a",
"date": "2017-09-01 15:07:20 -0400",
"subject": "Allow content-length (in addition to chunked encoding) when reading XML data to improve compatibility with third-party S3 gateways.",
"body": "Suggested by Victor Gdalevich."
},
{
"commit": "fcb7c6fd1d0f37ed371079537b95899eaac44812",
"date": "2017-09-01 12:29:34 -0400",
"subject": "PostgreSQL 10 support."
},
{
"commit": "36e576b4839d5d9323597014d6f478def7308d9e",
"date": "2017-08-31 19:15:44 -0400",
"subject": "Up to seven standbys can be configured for backup from standby.`",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "206415d4c754053275666bfcc0eb138f39884c21",
"date": "2017-08-30 16:34:05 -0400",
"subject": "Fixed an issue that could cause compression to abort on growing files.",
"body": "Reported by Jesper St John, Aleksandr Rogozin."
},
{
"commit": "81ffd094455fb006993a3b9e65c801c127454dc7",
"date": "2017-08-30 08:41:46 -0400",
"subject": "Fixed an issue with keep-alives not being sent to the remote from the local process.",
"body": "Reported by William Cox."
},
{
"commit": "1e0ed074555df7d9079fdf52c4b6b5b049b6d155",
"date": "2017-08-25 16:47:47 -0400",
"subject": "Configuration rules are now pulled from the C library when present."
},
{
"commit": "8d3436bce775845d45eaf8b55e526ad784e54e0f",
"date": "2017-08-19 09:02:24 -0400",
"subject": "Merge release 2 container build changes."
},
{
"commit": "7dab459cacd9e1b5934294176e5929a86f7b48de",
"date": "2017-08-19 08:48:13 -0400",
"subject": "Simplified smart logic for C Library and package builds."
},
{
"commit": "1be69d5ac71db241f0c41bf28c4c36c5cc0b32c4",
"date": "2017-08-16 16:54:35 -0400",
"subject": "Fixed document generation to include section summaries on the Configuration page.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "1d2b08ce94d31e2d0a19cb7f489d73e2e04700d2",
"date": "2017-08-11 18:43:21 -0400",
"subject": "Move contributor list to the end of release.xml for convenience."
},
{
"commit": "4c2c612b6f68001b2cf0ccd29b02648f0f11ae8c",
"date": "2017-08-11 18:38:40 -0400",
"subject": "Ignore auto-generated C code created by release 2."
},
{
"commit": "4331e09376a124e597c4a0e8e4c9641239f8f64e",
"date": "2017-08-11 18:31:25 -0400",
"subject": "Drain stderr during test process execution as well as termination to prevent lockups if there is a lot of output."
},
{
"commit": "f8de73674c5e97bd7103a4892ce4d17cc12d1173",
"date": "2017-08-10 20:52:29 -0400",
"subject": "Updated Docker build in Vagrantfile."
},
{
"commit": "ac1574448e8b6e2a6b6c3690f3998aac35e4d40d",
"date": "2017-08-10 18:11:29 -0400",
"subject": "Changed log test order to ignore unimportant log errors while shutting down PostgreSQL."
},
{
"commit": "84caca0f341982d7d61d1c310faf5c6a3a601a48",
"date": "2017-08-09 11:50:02 -0400",
"subject": "v1.22: Fixed S3 Retry"
},
{
"commit": "61c38f58085ebe5ad769bf5937c41793deafc884",
"date": "2017-08-09 11:27:09 -0400",
"subject": "Fixed authentication issue in S3 retry."
},
{
"commit": "cbc026418cdc03bbe645a3c44ccf9e40435c62ca",
"date": "2017-08-08 18:09:07 -0400",
"subject": "v1.21: Improved Info Output and SSH Port Option"
},
{
"commit": "038d47bcc05d3de5b377c330576bcc76648ccb8b",
"date": "2017-08-08 17:15:01 -0400",
"subject": "Retry when S3 returns an internal error (500)."
},
{
"commit": "961f7033d1f82f279e02500506a255c58064fe55",
"date": "2017-08-08 16:26:44 -0400",
"subject": "Generate global fake cert in containers for testing."
},
{
"commit": "b6da509c9f909bcbd1c76b6b920b78e5945b9d1e",
"date": "2017-08-04 16:10:51 -0400",
"subject": "Consolidate stanza-create and stanza-upgrade tests into new stanza test.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "f9bdc092bac8cdfe1c7145c0adf1123ae2ea6dd1",
"date": "2017-08-04 16:03:55 -0400",
"subject": "Fixed an issue that could cause the empty archive directory for an old PostgreSQL version to be left behind after a stanza-upgrade.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "ce2b18c5b84c506606861010331965ad503af48a",
"date": "2017-08-01 10:34:53 -0400",
"subject": "Added --backup-ssh-port and --db-ssh-port options to support non-default SSH ports.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "fa992433da396f8fe3a3c49dfd539d4dd6c54ae1",
"date": "2017-07-27 11:31:42 -0400",
"subject": "Update CI code to prevent deprecated VM from being rewritten."
},
{
"commit": "cf3110b0d896c75db775f6b2296c704a54d61142",
"date": "2017-07-26 19:22:54 -0400",
"subject": "Use new Travis Trusty image."
},
{
"commit": "14d6974d1b54977ab678d0967c6fa8275b0959c7",
"date": "2017-07-26 13:40:09 -0400",
"subject": "Use Google DNS in test environment for consistency."
},
{
"commit": "97c4d9ec1874fa2acbb33d6442d62089be07786b",
"date": "2017-07-26 10:22:22 -0400",
"subject": "Reduce log verbosity in doc.pl.",
"body": "Reduce verbosity by only logging sections that contain an execute list directly or in a child section."
},
{
"commit": "df7d63368396c1030e178621136f0b304f970987",
"date": "2017-07-26 09:33:10 -0400",
"subject": "Improvements to command/command-line help:",
"body": "* Move repository options into a separate section in command/command-line help. (Suggested by Stephen Frost.)\n* Fix description of --online based on the command context.\n* Remove vestigial repository options from backup command."
},
{
"commit": "156fd4d54d2387767d298dd295518f847788f845",
"date": "2017-07-25 12:44:38 -0400",
"subject": "Add bIgnoreMissing parameter to Local->manifest()."
},
{
"commit": "49449feab3d13fa6aedd5271d60e55f3720e8f08",
"date": "2017-07-24 21:14:42 -0400",
"subject": "Add creation of /etc/pgbackrest.conf to manual installation instructions."
},
{
"commit": "cbb749e12a6c752d9172d7038f3f683c84d50d03",
"date": "2017-07-24 21:12:05 -0400",
"subject": "Debian/Ubuntu documentation now builds on Ubuntu 16."
},
{
"commit": "d5c1f02c7289284cb0cd7bd5c79e9e6a2dc8fb69",
"date": "2017-07-24 07:57:47 -0400",
"subject": "Include archive_status directory in online backups.",
"body": "The archive_status directory is now recreated on restore to support PostgreSQL 8.3 which does not recreate it automatically like more recent versions do.\n\nAlso fixed log checking after PostgreSQL shuts down to include FATAL messages and disallow immediate shutdowns which can throw FATAL errors in the log."
},
{
"commit": "cda3b9821b83b3cc96ad13b63483499ff5a52e42",
"date": "2017-07-21 17:32:41 -0400",
"subject": "Improved WAL data returned by info command.",
"body": "Modified the info command (both text and JSON output) to display the archive ID and minimum/maximum WAL currently present in the archive for the current and prior, if any, database cluster version."
},
{
"commit": "33d769e14786098b6fa02e666c624531dc7d5bea",
"date": "2017-06-27 22:42:31 -0400",
"subject": "v1.20: Critical 8.3/8.4 Bug Fix"
},
{
"commit": "884413b251935aa7c1f82758a34c37664c200b82",
"date": "2017-06-27 22:27:48 -0400",
"subject": "Remove mount and user from host cache-key because it can vary by system."
},
{
"commit": "7759a94fa2ac0af8ef037c466808685b091c2cc2",
"date": "2017-06-27 18:29:48 -0400",
"subject": "Add Debian 9 to test suite."
},
{
"commit": "9e9286ee205e7202bed7fc0d688e43949c3a687c",
"date": "2017-06-27 18:00:39 -0400",
"subject": "Add performance module and basic performance test for archive-push."
},
{
"commit": "9e248a66279eab87c18040917f5bdcd94075e6c2",
"date": "2017-06-27 17:54:30 -0400",
"subject": "Minor optimizations to package loads and ordering for archive-get and archive-push commands."
},
{
"commit": "f3b62d2d671592881f5e646b100604020fa52e70",
"date": "2017-06-27 17:07:12 -0400",
"subject": "Fixed misleading error message when a file was opened for write in a missing directory."
},
{
"commit": "2310e423e98259838826ccc8093e43668fab061a",
"date": "2017-06-27 16:47:40 -0400",
"subject": "Fixed an issue that prevented tablespaces from being backed up on PostgreSQL ≤ 8.4.",
"body": "The integration tests that were supposed to prevent this regression did not work as intended. They verified the contents of a table in the (supposedly) restored tablespace, deleted the table, and then deleted the tablespace. All of this was deemed sufficient to prove that the tablespace had been restored correctly and was valid.\n\nHowever, PostgreSQL will happily recreate a tablespace on the basis of a single full-page write, at least in the affected versions. Since writes to the test table were replayed from WAL with each recovery, all the tests passed even though the tablespace was missing after the restore.\n\nThe tests have been updated to include direct comparisons against the file system and a new table that is not replayed after a restore because it is created before the backup and never modified again.\n\nVersions ≥ 9.0 were not affected due to numerous synthetic integration tests that verify backups and restores file by file."
},
{
"commit": "fdabf33604cdc5f253187d559b3d4be52c2d843d",
"date": "2017-06-27 15:58:02 -0400",
"subject": "Revert removal of Ubuntu 12.04 and PostgreSQL 8.3."
},
{
"commit": "001cff9eb990cf246df42c7d06f5e377da313299",
"date": "2017-06-27 15:48:34 -0400",
"subject": "Automatically check that all supported PostgreSQL versions are being tested on a single default VM."
},
{
"commit": "7a1385cc2716de93b7f0388ea2017dfa1a8734a4",
"date": "2017-06-24 18:04:02 -0400",
"subject": "Add documentation builds to CI."
},
{
"commit": "7a9b1f69937f5866ab0bc888d700527fda460d47",
"date": "2017-06-24 10:59:00 -0400",
"subject": "Container build improvements:",
"body": "* More optimized container suite that greatly improves build time.\n* Added static Debian packages for Devel::Cover to reduce build time.\n* Add deprecated state for containers. Deprecated containers may only be used to build packages.\n* Remove Debian 8 from CI because it does not provide additional coverage over Ubuntu 14.04 and Ubuntu 16.04."
},
{
"commit": "53184a7b30c7b3000a4be8af90c9419b22fae3e2",
"date": "2017-06-23 10:30:22 -0400",
"subject": "Update CentOS 6 documentation to build on PostgreSQL 9.5."
},
{
"commit": "3d224ad8fa54f007032a5a2c6077c004c4d7c395",
"date": "2017-06-23 10:10:48 -0400",
"subject": "Improve S3 server implementation in documentation."
},
{
"commit": "eb4325fa9ac8b6e3da6344d561a861651a4b23f9",
"date": "2017-06-22 19:04:52 -0400",
"subject": "Remove exhaustive version list from Stable Releases TOC."
},
{
"commit": "a10a22127d025367655037c1ca9fee0dde248e3c",
"date": "2017-06-22 18:51:39 -0400",
"subject": "Consolidate archive-get test into new archive test."
},
{
"commit": "918c1c6f490d3097c46e27fa0226c3fa3b08ec9b",
"date": "2017-06-22 18:22:49 -0400",
"subject": "Add s3-repo-ca-path and s3-repo-ca-file options.",
"body": "The options accommodate systems where CAs are not automatically found by IO::Socket::SSL, i.e. RHEL7, or to load custom CAs."
},
{
"commit": "6327799c9ae828a56f7f8686d3e35da2441a6e15",
"date": "2017-06-22 18:13:59 -0400",
"subject": "Use old trusty image until new image works with RHEL6."
},
{
"commit": "a1a5d18aa436d50f3dff4e845bad51855168071b",
"date": "2017-06-22 14:44:21 -0400",
"subject": "Balance database versions between VMs to minimize test duration."
},
{
"commit": "d3054d919b6efc831c9a5a596496e0be80309bc7",
"date": "2017-06-22 12:57:10 -0400",
"subject": "Fixed missing flag in C library build.",
"body": "The missing flag resulted in a mismatched binary on 32-bit systems."
},
{
"commit": "f8849d735937c16211b0cc905de22088ae467ec6",
"date": "2017-06-22 12:37:21 -0400",
"subject": "Remove patch directory before Debian package builds.",
"body": "Patches should be merged into master before trying a new build after a release with patches."
},
{
"commit": "f596702c5badb5dbd3b15b6c4ee0e54444ab6e8c",
"date": "2017-06-21 20:46:49 -0400",
"subject": "Improve S3 error reporting."
},
{
"commit": "8b9965abcb30421157e11ecc5969bcffbbed93a5",
"date": "2017-06-21 19:21:16 -0400",
"subject": "Remove process-max option.",
"body": "Parallelism is now tested in a more targeted manner and the high level option is no longer needed."
},
{
"commit": "234869338913ab411baa33b58f28e8d460c74335",
"date": "2017-06-21 18:47:25 -0400",
"subject": "Reduce process redundancy in mock tests."
},
{
"commit": "cc0e3f843e0bf3c4982af6423d07f527cc8fd617",
"date": "2017-06-21 17:24:36 -0400",
"subject": "Remove support for PostgreSQL 8.3."
},
{
"commit": "73274fc608d7aa4c93af645a85bcbceb3f276847",
"date": "2017-06-21 17:02:01 -0400",
"subject": "Remove Ubuntu 12.04 from CI now that it is EOL (it can still be run manually)."
},
{
"commit": "c69baa2de1ed4d00a87f90634c347e730f3babc3",
"date": "2017-06-21 16:51:41 -0400",
"subject": "Install sudo in base containers rather than on demand."
},
{
"commit": "64ec7eb49077421f28dbd3cf889e68fc226a4f3d",
"date": "2017-06-21 16:07:13 -0400",
"subject": "Eliminate redundancy in real tests."
},
{
"commit": "edada218660a67bd4e87e8450e2491eb2bb47a5c",
"date": "2017-06-21 08:45:58 -0400",
"subject": "Rename archive-push unit test.",
"body": "This is part of the archive consolidation but is committed separately so that git will follow the rename."
},
{
"commit": "2337be863690c73fc2e141191a3167d959c35263",
"date": "2017-06-21 08:38:53 -0400",
"subject": "Consolidate archive-push tests into new archive test."
},
{
"commit": "11ee528e0e11a849612c67dcb297c35c29995c11",
"date": "2017-06-21 08:02:21 -0400",
"subject": "Rename Archive modules to remove redundancy."
},
{
"commit": "692b1e274adb9f1f23e3d29d127af521a53a27e9",
"date": "2017-06-19 18:55:00 -0400",
"subject": "Split full module into mock and real to allow better test combinations and save time in CI."
},
{
"commit": "f6d4457d58b3f752dadd14c9e341ff86910f72b3",
"date": "2017-06-15 15:32:10 -0400",
"subject": "Full/Synthetic test refactor.",
"body": "* Combine hardlink and non/compressed in synthetic tests to reduce test time and improve coverage.\n* Change log level of hardlink logging to detail.\n* Cast size in S3 manifest to integer."
},
{
"commit": "269ae4556d00da463d43ef95aaa461821e77f4f3",
"date": "2017-06-15 15:20:02 -0400",
"subject": "Fix timeouts in ExecuteTest to speed multi-process testing."
},
{
"commit": "6e29f616b347b66c62c36adf019a7a4d42e4bdac",
"date": "2017-06-15 15:12:28 -0400",
"subject": "Harden protocol handshake to handle race conditions."
},
{
"commit": "c10c5bb0ef1de519371e1bdae0b9da7cf8670c95",
"date": "2017-06-12 11:36:00 -0400",
"subject": "v1.19: S3 Support"
},
{
"commit": "051c961151e75114c59980e9feb883a8d58dc7b0",
"date": "2017-06-12 10:52:32 -0400",
"subject": "S3 repository support."
},
{
"commit": "de7fc37f88f670a1b4b4f95ff354384f37d983b1",
"date": "2017-06-09 17:51:41 -0400",
"subject": "Storage and IO layer refactor:",
"body": "Refactor storage layer to allow for new repository filesystems using drivers. (Reviewed by Cynthia Shang.)\nRefactor IO layer to allow for new compression formats, checksum types, and other capabilities using filters. (Reviewed by Cynthia Shang.)"
},
{
"commit": "7e982f05f564e560b6ca23f61365fc7f11a5da36",
"date": "2017-05-16 11:28:51 -0400",
"subject": "Fixed config warnings raised from a remote process causing errors in the master process.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "74053ed842a4f3c37ce3fa2c9b6e32b4f5aa36e6",
"date": "2017-05-16 11:15:31 -0400",
"subject": "Fixed missing sudo in installation section.",
"body": "Fixed by Lætitia."
},
{
"commit": "529674727148a7ec6d04ef6bd3ec86f69575f6f2",
"date": "2017-05-15 16:01:00 -0400",
"subject": "Move backup modules into Backup directory."
},
{
"commit": "2a23157bf2912bbcdbfe5350ca40ca398cc1001e",
"date": "2017-05-15 11:12:14 -0400",
"subject": "Move modules in Protocol directory in subdirectories."
},
{
"commit": "33c87b2a1ccbaf43f56765285ac4918f4b1cdf1c",
"date": "2017-05-15 10:24:46 -0400",
"subject": "Remove flapping protocol timeout test that will be replaced in the upcoming storage patch."
},
{
"commit": "c31da3f961b9494cb8f8f351d8a4cf7f22557062",
"date": "2017-05-12 16:43:04 -0400",
"subject": "Moved test and env modules to new directories to avoid namespace conflicts with common tests."
},
{
"commit": "4049d59c9e1c4abaa0d96ce0fc307139d1b32a64",
"date": "2017-05-12 16:27:06 -0400",
"subject": "Fixed issue with --dry-run requiring --vm-out to work properly."
},
{
"commit": "7d0c50fcd6dd6d7800b53ae2a1abf35f923ec7da",
"date": "2017-05-12 16:05:44 -0400",
"subject": "Fixed the backup command so the backup-standby option is reset (and the backup proceeds on the master) if the standby is not configured and/or reachable.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "5bf4f52e3d1ddb3cacb6821080b59e378baf4cb1",
"date": "2017-05-12 15:49:14 -0400",
"subject": "Fixed the info command so the WAL archive min/max displayed is for the current database version.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "64be6400fe1f6614c2788e7237e9f75e465fd95f",
"date": "2017-04-17 06:39:29 -0400",
"subject": "Changed invalid max-archive-mb option in configuration reference to archive-queue-max."
},
{
"commit": "979610a07d5c201e4e7f93f0540be2b19e4b33a5",
"date": "2017-04-13 20:10:28 -0400",
"subject": "Fixed an undefined variable when a module had no uncoverable code exceptions."
},
{
"commit": "77ef4fde20327a6615daaf096930de711fdb4ddf",
"date": "2017-04-13 07:42:45 -0400",
"subject": "Set --vm-max=2 for CI."
},
{
"commit": "76161bd8451e581a8f9aa11c1f37d14863585d29",
"date": "2017-04-12 19:17:39 -0400",
"subject": "v1.18: Stanza Upgrade, Refactoring, and Locking Improvements"
},
{
"commit": "5c635e0f0a1f5dc8ab8ef8c65204e81d3495afcb",
"date": "2017-04-12 18:36:33 -0400",
"subject": "Go back to using static user for documentation.",
"body": "Making this dynamic in commit 5d2e792 broke doc builds from cache. The long-term solution is to create a special user for doc builds but that’s beyond the scope of this release."
},
{
"commit": "f207dc71238097a0fded50cc87bb7ef2afb006de",
"date": "2017-04-12 12:41:34 -0400",
"subject": "Renumber return codes between 25 and 125 to avoid PostgreSQL interpreting some as fatal signal exceptions.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "f5f8d51366faae6ac31f355d021eaff67bef8f7f",
"date": "2017-04-12 09:53:07 -0400",
"subject": "Improved error message when the restore command detects the presence of postmaster.pid.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "b0119914d4633431b208a5a327a3758a06258087",
"date": "2017-04-12 09:22:51 -0400",
"subject": "Do not set timestamps of files in the backup directories to match timestamps in the cluster directory.",
"body": "This was originally done to enable backup resume, but that process is now implemented with checksums."
},
{
"commit": "fe02b40293fec08c819c5f41110203b8919fbae4",
"date": "2017-04-12 09:05:57 -0400",
"subject": "Backup and restore commands no longer copy via temp files.",
"body": "In both cases the files are checksummed on resume so there's no danger of partial copies."
},
{
"commit": "21a000d002bae2fa87cd09952740cbe14770aada",
"date": "2017-04-10 17:23:39 -0400",
"subject": "Silence some perl critic warnings.",
"body": "* Variables::RequireNegativeIndice\n* Variables::ProhibitUnusedVariables\n* Variables::ProhibitAugmentedAssignmentInDeclaration\n* Modules::ProhibitConditionalUseStatements"
},
{
"commit": "8546571461215eb65ffcff649c6baa17bc57d605",
"date": "2017-04-10 17:20:21 -0400",
"subject": "Ignore clock skew in container libc/package builds using make.",
"body": "It is common for containers to have clock skew so the build process takes care of this issue independently."
},
{
"commit": "b63ede5614fed0dce32449f1450b7a5627eeeb3d",
"date": "2017-04-10 13:53:19 -0400",
"subject": "Added ability to test warning messages.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "3d84f2ce5e02c5bd7f9bdcbb3b4579b146bf7ccf",
"date": "2017-04-10 13:24:45 -0400",
"subject": "Improvements to Ini.pm.",
"body": "* Refactor Ini.pm to facilitate testing.\n* Complete statement/branch coverage for Ini.pm.\n* Improved functions used to test/munge manifest and info files."
},
{
"commit": "367e06f4be9133f399d4b7380ace8c5ca087c4b6",
"date": "2017-04-10 12:31:30 -0400",
"subject": "Coverage testing always enabled on Debian-based containers.",
"body": "* Full coverage is verified when specified.\n* Modules marked with partial coverage will error if they are actually fully covered.\n* Simplified test representation is DefineTest.\n* Added new representation for queries in DefineTest and added API functions.\n* Update modules using DefineTest to use new API."
},
{
"commit": "eb4918d01881c20448e37da4d931d6e8a19f659a",
"date": "2017-04-07 10:31:49 -0400",
"subject": "Fixed locking bug and refactoring.",
"body": "* Fixed an issue where read-only operations that used local worker processes (i.e. restore) were creating write locks that could interfere with parallel archive-push. (Reported by Jens Wilke.)\n* Simplify locking scheme. Now, only the master process will hold write locks (archive-push, backup) and not all the local and remote worker processes as before."
},
{
"commit": "edfb0962b678a5ebb3021d37d487fafb843dbf2a",
"date": "2017-04-06 21:47:43 -0400",
"subject": "Update wording for release note sections."
},
{
"commit": "b620e6b282d3fc0bd1354b9490fbd84ee8d22d6e",
"date": "2017-04-06 19:36:37 -0400",
"subject": "Improvements and additional tests for stanza-upgrade.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0da216c034d484927fa8ad0845e08f25c5227b5a",
"date": "2017-04-05 10:50:32 -0400",
"subject": "Require description in every call to testResult() and make iWaitSeconds optional."
},
{
"commit": "c7b61a200258b2f10d1c62f2aedc7441e27bb6b1",
"date": "2017-04-05 10:16:16 -0400",
"subject": "Refactor backupLabel() and add unit tests."
},
{
"commit": "b2f43b56014f3d43404a17531887a09a78eb0db1",
"date": "2017-04-04 21:17:19 -0400",
"subject": "Allow functions to accept optional parameters as a hash.",
"body": "Refactor File->list() and fileList() to accept optional parameters."
},
{
"commit": "9eae36a7028a7c08869ec2e7c2f31f0aa49ecb4c",
"date": "2017-04-04 21:15:22 -0400",
"subject": "Fixed flapping archive stop tests."
},
{
"commit": "beead043ac1f988e3757dc8689638ee5d443d9f9",
"date": "2017-04-03 10:42:55 -0400",
"subject": "Added stanza-upgrade command.",
"body": "The stanza-upgrade command provides a mechanism for upgrading a stanza after upgrading to a new major version of PostgreSQL."
},
{
"commit": "af7e4f4b4b6070e566865872e5240b824a14983f",
"date": "2017-03-22 19:03:28 -0400",
"subject": "Added validation of pgbackrest.conf to display warnings if options are not valid or are not in the correct section.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "5d2e79242da79854ee922c1a84dec0e67d52f090",
"date": "2017-03-16 19:50:59 -0400",
"subject": "Fixed user change in docs missed in vagrant upgrade."
},
{
"commit": "cbd879a9830d2585b3df3209f59c4a9581a3c166",
"date": "2017-03-14 22:05:17 -0400",
"subject": "Updated vagrant to new version and image."
},
{
"commit": "cc9f8fc4b6cb9a2da5bd7419630c4f3eb1c71186",
"date": "2017-03-13 16:54:51 -0400",
"subject": "v1.17: Page Checksum Bug Fix"
},
{
"commit": "b0947fdaa8af9c434c85ff33b1140d8ca6d98cbb",
"date": "2017-03-13 15:50:13 -0400",
"subject": "Fixed an issue where newly initialized (but unused) pages would cause page checksum warnings.",
"body": "Reported by Stephen Frost."
},
{
"commit": "3cec6702e85e901ff3894e047cf5a461562b7b67",
"date": "2017-03-02 20:15:14 -0500",
"subject": "v1.16: Page Checksum Improvements, CI, and Package Testing"
},
{
"commit": "02730526fc1a157231293ae532882847f7015a46",
"date": "2017-03-02 13:50:29 -0500",
"subject": "Fixed an issue where databases created with a non-default tablespace would raise bogus warnings about pg_filenode.map and pg_internal.init not being page aligned.",
"body": "Reported by blogh."
},
{
"commit": "5957f8566f1f8cd90964423321660e457fab57b7",
"date": "2017-03-02 11:47:23 -0500",
"subject": "Archive test improvements:",
"body": "* Fixed flapping archive-stop test with testResult() retries.\n* Added final test of archive contents to archive-push test."
},
{
"commit": "5eb585c9bae50e02ac5d53d3e20d0b5083283ac9",
"date": "2017-03-01 14:38:05 -0500",
"subject": "Improved truncation when outputting errors logs in the ExecuteTest module."
},
{
"commit": "c2666cc7f365fbd294b36dbcf5b11676bbcbf0d1",
"date": "2017-03-01 14:15:46 -0500",
"subject": "Fixed an issue where tables over 1GB would report page checksum errors after the first segment.",
"body": "Reported by Stephen Frost."
},
{
"commit": "774b243719675a27e0d4f02369df7cb0bdac6524",
"date": "2017-03-01 12:22:47 -0500",
"subject": "Fixed dev version string in Debian changelog."
},
{
"commit": "2c48cf8d0d4a4049ffcb8e01549f080bccfcc037",
"date": "2017-03-01 09:36:33 -0500",
"subject": "Fixed Vagrantfile to match user/group changes made for Travis CI."
},
{
"commit": "8161ab1c505f811b8aeb8ca33a57133411c4b755",
"date": "2017-02-26 12:58:48 -0500",
"subject": "Temporarily disable flapping keep-alive test."
},
{
"commit": "abe0935ea51a78f182549a82b62ca3e1964fe877",
"date": "2017-02-26 12:53:41 -0500",
"subject": "Disable CI config writing with —no-ci-config."
},
{
"commit": "ac485cc3552f3b1e35baebaa0140236bf550c6a8",
"date": "2017-02-22 18:43:10 -0500",
"subject": "Change —retry default to 0."
},
{
"commit": "31d2d790bd070e2b58a192cb56f6b04cdd307a6f",
"date": "2017-02-21 22:10:02 -0500",
"subject": "Added --retry option."
},
{
"commit": "023578c008dec24000c268f29cda25dc2948a86a",
"date": "2017-02-21 14:22:03 -0500",
"subject": "Make package tests work with dev builds."
},
{
"commit": "0e9bc513c986140f9bc239dc4b1d3f54c46444a5",
"date": "2017-02-21 12:54:27 -0500",
"subject": "Suppress lint on all but the first test."
},
{
"commit": "14ca4dac6fe9ab594c0915486f88ff27f4a5dc7d",
"date": "2017-02-21 11:56:55 -0500",
"subject": "Improved the code and tests for fileManifest().",
"body": "Done to prevent a possible race condition when files are removed by the database while the manifest is being built."
},
{
"commit": "01312f6260e4f36541d90b5f62be1cbbe6847d13",
"date": "2017-02-21 11:47:45 -0500",
"subject": "Improved formatting of testResult() output."
},
{
"commit": "86fee3da18e2646705fdac8853ae4153689d6484",
"date": "2017-02-21 08:59:23 -0500",
"subject": "Continuous integration using travis-ci."
},
{
"commit": "56543f7a9916b554204572fb015a24a33c0f74f0",
"date": "2017-02-17 22:31:16 -0500",
"subject": "Added package builds to test suite and other improvements:",
"body": "* Automated builds of Debian packages for all supported distributions.\n* Added --dev option to aggregate commonly used dev options.\n* Added --no-package option to skip package builds.\n* C library and packages are built by default, added -smart option to rebuild only when file changes are detected.\n* The --libc-only option has been changed to --build-only now that packages builds have been added."
},
{
"commit": "ac7ff755b3533181f7f26a7140cbdefa1cb68442",
"date": "2017-02-16 17:18:48 -0500",
"subject": "Container executions now load the user's environment."
},
{
"commit": "2d7d9626bb60640a77ac71559f2a714a1aac8b94",
"date": "2017-02-13 20:00:30 -0500",
"subject": "v1.15: Refactoring and Bug Fixes"
},
{
"commit": "e2ac7e1ea624a1dd0e4c5ac214d3dfc1cdc266ab",
"date": "2017-02-13 19:59:14 -0500",
"subject": "Fixed a regression introduced in v1.13 that could cause backups to fail.",
"body": "This happened if files were removed (e.g. tables dropped) while the manifest was being built."
},
{
"commit": "845c6112bf592fb54b61156b47bbf2ebc5985f29",
"date": "2017-02-13 10:07:04 -0500",
"subject": "v1.14: Bug Fixes"
},
{
"commit": "a54018d573926d5d5718727a9f169ad7751577f4",
"date": "2017-02-13 10:03:02 -0500",
"subject": "Improved performance of wal archive min/max provided by the info command.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "adcc7cb9543714b420d429512f259d14ea265acf",
"date": "2017-02-13 09:58:50 -0500",
"subject": "Fixed a race condition in parallel archiving.",
"body": "Creation of new paths generated an error when multiple processes attempted to do so at the same time."
},
{
"commit": "bc2bb040c5bf75cb56ec3fa7a00a993d33371a99",
"date": "2017-02-13 09:57:10 -0500",
"subject": "Fixed an issue where an archive-push error would not be retried.",
"body": "It would instead return errors to PostgreSQL indefinitely (unless the .error file was manually deleted)."
},
{
"commit": "12041f73e2a4f4c91c068b7f43f7ff52f24c72f5",
"date": "2017-02-12 21:09:34 -0500",
"subject": "Fixed syntax from d68b48d that was not backwards compatible to Perl 5.10."
},
{
"commit": "d68b48d19b53727bafd55e97cde41db309763daa",
"date": "2017-02-11 10:26:54 -0500",
"subject": "Improved support for --require option and section depends now default to the previous section."
},
{
"commit": "498f52da094832d5ffe84ea0eed121acf46f360c",
"date": "2017-02-10 10:22:05 -0500",
"subject": "Improvements to documentation engine:",
"body": "* Documentation can now be built with reusable blocks to reduce duplication.\n* Added ability to pass options to containers within the documentation.\n* Add proper tag to slightly emphasize proper nouns."
},
{
"commit": "aab763d558b586f0ce4f77a8cc67c2c7e9db07eb",
"date": "2017-02-08 09:37:17 -0500",
"subject": "Additional notes on the async spool directory."
},
{
"commit": "b813bfaff68fa9d2e1271b3f6fcf61955e24de3e",
"date": "2017-02-08 08:41:43 -0500",
"subject": "Updated async archiving documentation.",
"body": "More accurately describe how the new method works and how it differs from the old method."
},
{
"commit": "41eba95155b1fab4c5f98dab3327c1563968fcab",
"date": "2017-02-05 20:23:03 -0500",
"subject": "v1.13: Parallel Archiving, Stanza Create, Improved Info and Check"
},
{
"commit": "0daeace1cd2e2ef55c3df3e43b4b622418fe625b",
"date": "2017-02-05 19:58:52 -0500",
"subject": "Fixed alignment issues with multiline logging."
},
{
"commit": "cded35791d160a6fc2f99daaaaabf0db21c9bb38",
"date": "2017-02-05 10:59:49 -0500",
"subject": "Added --log-timestamp option.",
"body": "Allow timestamps to be suppressed in logging. This is primarily used to avoid filters in the automated documentation."
},
{
"commit": "55feae645e92eda928ad0eb5be74431807f3c604",
"date": "2017-02-05 10:37:54 -0500",
"subject": "Log file banner is not output until the first log entry is written.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "2237c3fc1bafd620f5cafda4d38acbfc7b490aa5",
"date": "2017-02-05 10:35:53 -0500",
"subject": "Added documentation for parallel archive-push."
},
{
"commit": "8b5f37c2a87b221fe40f1883f6583ee31ad977d7",
"date": "2017-02-05 10:31:29 -0500",
"subject": "Added archive and backup WAL ranges to the info command."
},
{
"commit": "1666ee177f059c3566e531fa697cb229eb68c0c4",
"date": "2017-02-02 20:44:42 -0500",
"subject": "Fixed --no-online tests to suppress expected errors."
},
{
"commit": "efdf64506ae075cadc24de0805c8238478dfd28f",
"date": "2017-02-02 20:42:45 -0500",
"subject": "Remove remote lock requirements for the archive-get, restore, info, and check commands since they are read-only operations.",
"body": "Suggested by Michael Vitale."
},
{
"commit": "3e54aad88f473db619dc7546cf144c3987224943",
"date": "2017-01-31 10:38:45 -0500",
"subject": "Removed --lock option.",
"body": "This option was introduced before the lock directory could be located outside the repository and is now obsolete."
},
{
"commit": "7418559a6751959727836e462002a14c41461198",
"date": "2017-01-31 10:36:59 -0500",
"subject": "Fixed a spurious archive-get log message that indicated an exit code of 1 was an abnormal termination."
},
{
"commit": "9b92edddbe506c3ebaa6f970e62270facdcc5a27",
"date": "2017-01-30 17:06:35 -0500",
"subject": "Remove Intel-specific optimization from C library build flags.",
"body": "Contributed by Adrian Vondendriesch."
},
{
"commit": "eb1a1e53080375d947b94e58f917bc2816528264",
"date": "2017-01-30 16:22:12 -0500",
"subject": "Missed expect logs from commit 455c604."
},
{
"commit": "34e4cfaeec473ba1c90f8c203f82b1146510deee",
"date": "2017-01-30 15:48:10 -0500",
"subject": "Fixed minor typos."
},
{
"commit": "455c6048ee4794a2d334067e4651460b3ad2b416",
"date": "2017-01-30 14:00:40 -0500",
"subject": "C Library builds immune to clock differences between VM and host."
},
{
"commit": "6b99d770b5203680ac53813d9c3c73f476d895bb",
"date": "2017-01-30 13:59:00 -0500",
"subject": "Reduced the likelihood of torn pages causing a false positive in page checksums by filtering on start backup LSN."
},
{
"commit": "43ada9fb33b51479b959ea6a93fcb53fa0803e25",
"date": "2017-01-27 11:02:27 -0500",
"subject": "Improved, multi-process implementation of asynchronous archiving."
},
{
"commit": "2a9ba877e1dbce234f1b44d8f3163ce38f9c1781",
"date": "2017-01-27 10:06:16 -0500",
"subject": "Refactor process IO and process master/minion code out from the common protocol code."
},
{
"commit": "0163d3b3e02f22179f9854246e6f5009e8ff4e40",
"date": "2017-01-27 10:04:41 -0500",
"subject": "Allow empty files to be created with FileCommon::fileStringWrite() and use temp files to avoid partial reads."
},
{
"commit": "2553c7a9982f630226923ec14b0f56350607db44",
"date": "2017-01-27 10:02:00 -0500",
"subject": "Represent .gz extension with a constant."
},
{
"commit": "f3ccf3b897e9bab58e2ab1f15dabf54fef9b34db",
"date": "2017-01-27 09:56:26 -0500",
"subject": "Added Exception::exceptionCode() and Exception::exceptionMessage() to simplify error handling logic."
},
{
"commit": "6620594b7724f5950b20c1c103a2b0fee194e816",
"date": "2017-01-27 09:53:46 -0500",
"subject": "Various improvements in Lock.pm:",
"body": "* Allow for locks to be taken more than once in the same process without error.\n* Lock directories can be created when more than one directory level is required.\n* Clean up optionValid()/optionTest() logic in Lock.pm."
},
{
"commit": "18db178ac3a03540bcaf4bd5c23f6a34ab419f55",
"date": "2017-01-27 09:42:30 -0500",
"subject": "Various improvements to the test suite:",
"body": "* Allow logging to be suppressed via logDisable() and logEnable().\n* Added more flexibility in initializing and cleaning up after modules and tests.\n* testResult() suppresses logging and reports exceptions.\n* testException() allows messages to be matched with regular expressions.\n* Refactor name/locations of common modules that setup test environments."
},
{
"commit": "e876a222fcb68fb4a95455113d3378d5e6b81c7a",
"date": "2017-01-24 14:58:55 -0500",
"subject": "Fixed an issue where protocol mismatch errors did not output the expected value."
},
{
"commit": "b6fa146f9b1b9e622f456d73585423538c04ad17",
"date": "2017-01-22 19:29:56 -0500",
"subject": "Added warning to update pg_tablespace.spclocation when remapping tablespaces in PostgreSQL < 9.2.",
"body": "Contributed by blogh."
},
{
"commit": "7d1347cdec4f4c563d5a6fa0a1d66297a2742f0f",
"date": "2017-01-10 19:59:32 -0500",
"subject": "Split the archive-get and archive-push commands into separate modules."
},
{
"commit": "155c8081632d1081da8b7e94ebd3a7d422f0f280",
"date": "2017-01-10 19:54:51 -0500",
"subject": "Split the check command out of the Archive.pm module."
},
{
"commit": "b58045f5757b03a1e15e1955402917b9003c5692",
"date": "2017-01-10 19:51:20 -0500",
"subject": "Moved the Archive modules to the Archive directory."
},
{
"commit": "2ab63f27b23b8932e9685c5179284fddbb6cf49c",
"date": "2017-01-10 13:12:53 -0500",
"subject": "C Library builds only run when C library has actually changed."
},
{
"commit": "0b4055e588331ec70d789ced6e5685f54def197b",
"date": "2017-01-10 13:08:03 -0500",
"subject": "Moved File->manifest() into the FileCommon.pm module."
},
{
"commit": "0e4f51c27110f2d3eb6f3d1d15dc3f8ac4675e34",
"date": "2017-01-09 20:49:04 -0500",
"subject": "Added integration for testing coverage with Devel::Cover."
},
{
"commit": "39744a4f1dbbe4e593bebaa37a6be93dae0da214",
"date": "2017-01-05 15:19:56 -0500",
"subject": "Fixed an issue where a missing user/group on restore could cause an \"uninitialized value\" error in File->owner().",
"body": "Reported by Leonardo Avellar."
},
{
"commit": "4ff2714bf00063534ddf90d4995f9f1abcb60c99",
"date": "2017-01-04 18:39:50 -0500",
"subject": "Return proper error code when unable to convert a relative path to an absolute path.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "c8dfc673b87bc04f87e7e3c01f5e227a71f415d8",
"date": "2017-01-04 18:31:16 -0500",
"subject": "Moved tests into new modules to better reflect actual usage."
},
{
"commit": "e3d63c0252bfbd0cccb746d405c7e3cdeb8f75c1",
"date": "2017-01-04 18:29:13 -0500",
"subject": "Allow multiple --module, --test, and --run options to be used for test.pl."
},
{
"commit": "be337c951aee0121dc3d1a251bdb5218d72769a0",
"date": "2017-01-04 10:12:29 -0500",
"subject": "Improvements to stanza-create:",
"body": "* Force only required when a change is needed for backup.info or archive.info.\n* Identical files are not overwritten."
},
{
"commit": "b91ca113298104a3c718db93a1dad0fa7336c8c6",
"date": "2017-01-04 10:09:21 -0500",
"subject": "Added expect log expression to replace year subdirectories in backup.history."
},
{
"commit": "314ef2c8b317c7d56ae2770231e49748183fdd96",
"date": "2017-01-04 10:05:43 -0500",
"subject": "Update LICENSE.txt for 2017."
},
{
"commit": "d5ee7d3535ea3961db2cb73120ee94632463e737",
"date": "2016-12-23 16:50:02 -0500",
"subject": "Added documentation to the User Guide for the process-max option.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "83beab7ec368ffebb5d8526e06eb65a9abd568c2",
"date": "2016-12-23 11:43:26 -0500",
"subject": "Refactor File module to improve test coverage.",
"body": "Added unit tests for low-level functions in the BackupCommon module."
},
{
"commit": "5d3473b52dfe1f67d557d434a9ee373b6317dcfc",
"date": "2016-12-23 08:30:34 -0500",
"subject": "Refactor File module to improve test coverage."
},
{
"commit": "6b2666a9d7ee179e237a4ad34117024f2ed62f7f",
"date": "2016-12-23 08:22:59 -0500",
"subject": "Split test modules into separate files.",
"body": "Makes the code more maintainable. Tests are dynamically loaded by name rather than requiring an if-else block."
},
{
"commit": "56144c99c0570daf7f1dba85968b79cbc3a84b15",
"date": "2016-12-21 14:35:20 -0500",
"subject": "Improved check command to run on a standby.",
"body": "Only basic checks are done because pg_switch_xlog() cannot be executed on a replica."
},
{
"commit": "974a02dbe41372d28d2c234ebea8a8ac6352865a",
"date": "2016-12-20 16:52:20 -0500",
"subject": "Improved stanza-create command so that it can repair broken repositories in most cases and is robust enough to be made mandatory.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "aecc0f737e40dfb7304753e37612b11402e4c51c",
"date": "2016-12-19 14:40:22 -0500",
"subject": "Fixed a few directory syncs that were missed for the --repo-sync option."
},
{
"commit": "4e1b74688df11f31e2d5caf76bf7c1d53623ae45",
"date": "2016-12-13 08:22:36 -0500",
"subject": "Fixed const assignment giving compiler warning in C library.",
"body": "Fixed by Adrian Vondendriesch."
},
{
"commit": "8e3464da805fc0975b6cf25ecb9ba16146b45c9e",
"date": "2016-12-12 19:18:27 -0500",
"subject": "v1.12: Page Checksums, Configuration, and Bug Fixes"
},
{
"commit": "36a5349b1c6b6bcd513464029733b62fe4200759",
"date": "2016-12-12 18:54:07 -0500",
"subject": "Added the --checksum-page option.",
"body": "This option allows pgBackRest to validate page checksums in data files when checksums are enabled on PostgreSQL >= 9.3. Note that this functionality requires a C library which may not initially be available in OS packages. The option will automatically be enabled when the library is present and checksums are enabled on the cluster."
},
{
"commit": "6dd0829033fb600e0aa5d9c60d3315e65a6bb289",
"date": "2016-12-12 18:47:17 -0500",
"subject": "File copy protocol now accepts a function that can do additional processing on the copy buffers and return a result to the calling process."
},
{
"commit": "b4884e5a0bdb572aeb766f6d5f1be8b159de5ea7",
"date": "2016-12-10 14:05:28 -0500",
"subject": "Fixed an issue where the db-port option specified on the backup server would not be properly passed to the remote unless it was from the first configured database.",
"body": "Reported by Michael Vitale."
},
{
"commit": "1a5fa920e6baec14fc092d202839ab16d403b7fb",
"date": "2016-12-10 09:15:20 -0500",
"subject": "Improved parameter/result logging in debug/trace functions."
},
{
"commit": "e61ef6ebce004ebacf95796acae835845b25758e",
"date": "2016-12-10 09:13:55 -0500",
"subject": "Add more realistic data files to synthetic backup and restore tests."
},
{
"commit": "eff7b46eb1abb0d80de01730e6834f39f450f890",
"date": "2016-12-10 09:11:12 -0500",
"subject": "Various improvements to validation of backup and restore."
},
{
"commit": "b45e0d81898f21f8d65f029e382c3d202a3b0e7a",
"date": "2016-12-10 09:09:16 -0500",
"subject": "Fixed issues in the protocol layer when additional message fields were added."
},
{
"commit": "f818901c0e619b50afa50412d246d0b1771fac11",
"date": "2016-12-10 09:06:45 -0500",
"subject": "Added the --repo-sync option to allow directory syncs in the repository to be disabled.",
"body": "This is for file systems that do not support them, e.g. NTFS"
},
{
"commit": "36378c47bd3058b3986bf2913539724965c39e56",
"date": "2016-12-04 18:11:23 -0500",
"subject": "Added Retention to QuickStart section."
},
{
"commit": "896984848bf46f85893d4f05cf06534b4fe49327",
"date": "2016-12-04 17:51:00 -0500",
"subject": "Improved errors returned from child processes by removing redundant error level and code."
},
{
"commit": "817592837ce08d412dc97e3cfeb543590a83d04f",
"date": "2016-12-04 14:44:53 -0500",
"subject": "Added a predictable log entry to signal that a command has completed successfully.",
"body": "For example a backup ends successfully with: INFO: backup command end: completed successfully."
},
{
"commit": "f823a25ac20fac867038a4797d96c26e27f8388b",
"date": "2016-12-04 09:25:40 -0500",
"subject": "Fixed an issue where options that were invalid for the specified command could be provided on the command-line without generating an error.",
"body": "* The options were ignored and did not cause any change in behavior, but it did lead to some confusion. Invalid options will now generate an error.\n* Removed erroneous --no-config option in help test module.\n* Changed the --no-fork test option to --fork with negation to match all other boolean parameters."
},
{
"commit": "d18cd7ad0faa80c4ceacd708d0ae1e964f170a7a",
"date": "2016-12-03 18:01:17 -0500",
"subject": "Fixed an issue that prevented errors from being output to the console before the logging system was initialized.",
"body": "That is, while parsing options. Error codes were still being returned accurately so this would not have made a process look like it succeeded when it did not."
},
{
"commit": "2e01e6b9e1a9c598715f7ad86177930fb3963e56",
"date": "2016-12-03 17:34:51 -0500",
"subject": "Improved consistency and flexibility of the protocol layer by using JSON for all messages."
},
{
"commit": "b7f17382002046b7f52fdd874025428a649713a6",
"date": "2016-12-03 10:28:08 -0500",
"subject": "Code cleanup in preparation for improved stanza-create command.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "005fc08795c0bd299f999eff665b4eb4e789b2d2",
"date": "2016-12-03 10:23:26 -0500",
"subject": "Added the --repo-link option.",
"body": "Allow internal symlinks to be suppressed when the repository is located on a filesystem that does not support symlinks. This does not affect any pgBackRest functionality, but the convenience link latest will not be created and neither will internal tablespace symlinks, which will affect the ability to bring up clusters in-place manually using filesystem snapshots."
},
{
"commit": "6ae4d7de81cfdb8982f3bde0e920fb2a76250208",
"date": "2016-12-03 09:56:05 -0500",
"subject": "Fixed a bug where internal symlinks were not being created for tablespaces in the repository.",
"body": "This issue was only apparent when trying to bring up clusters in-place with filesystem snapshots and did not affect normal backup and restore."
},
{
"commit": "22cd29771fc87d98bc7269aad1e30b7c3d7de425",
"date": "2016-12-01 09:33:14 -0500",
"subject": "Update control and wal test files to 9.4 with matching system identifiers.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "a850335015207c95a05b4219997d025bcc854e1f",
"date": "2016-11-30 14:36:39 -0500",
"subject": "Simplified the result hash of File->manifest(), Db->tablespaceMapGet(), and Db->databaseMapGet()."
},
{
"commit": "09df07efb7496db9ac426da243acc636a628d2bb",
"date": "2016-11-30 14:23:05 -0500",
"subject": "For simplicity, the pg_control file is now copied with the rest of the files instead of by itself of at the end of the process.",
"body": "The backup command does not require this behavior and the restore copies to a temporary file which is renamed at the end of the restore."
},
{
"commit": "4e9f8da9a6c85b8f486d4207d637f9d0b14b3049",
"date": "2016-11-30 14:18:12 -0500",
"subject": "Improved IO->bufferRead to always return requested number of bytes until EOF."
},
{
"commit": "e951c4f9c267a7a860c22b29fc1208c3d96f7c89",
"date": "2016-11-30 14:15:11 -0500",
"subject": "Abstracted code to determine which database cluster is the master and which are standbys.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "d101e9c84e1e9bc7339a3d52a57964faf3aac51e",
"date": "2016-11-30 14:03:58 -0500",
"subject": "Improved exception handling in file unit tests."
},
{
"commit": "4df3eabf6d5acda7e7095933ea7f85ce9c618151",
"date": "2016-11-22 17:31:27 -0500",
"subject": "Builds in release.pl now remove all docker containers to get consistent IP address assignments."
},
{
"commit": "dbd16d25b97ba2d2cd86bcfb35e1ca41a2323c33",
"date": "2016-11-22 17:29:24 -0500",
"subject": "Fixed regression in section links introduced in v1.10.",
"body": "This was introduced in an effort to make the html output XHTML 1.0 STRICT compliant because the standard does not allow / characters in anchors.\n\nHowever, the / characters were changed to . in the anchors but not in the links. For now revert the anchors to / so further though can be given to this issue."
},
{
"commit": "c9b49b0d7e1f0cc612511c1691dcde89ec0cee92",
"date": "2016-11-17 16:35:11 -0500",
"subject": "Doc engine improvements.",
"body": "Bug Fixes:\n\n* Fixed and issue that suppressed exceptions in PDF builds.\n\nFeatures:\n\n* Allow a source to be included as a section so large documents can be broken up.\n* Added section link support to Markdown output.\n* Added list support to PDF output.\n* Added include option to explicitly build sources (complements the exclude option though both cannot be used in the same invocation).\n* Added keyword-add option to add keywords without overriding the default keyword.\n* Added debug option to doc.pl to easily add the debug keyword to documentation builds.\n* Added pre option to doc.pl to easily add the pre keyword to documentation builds.\n\nRefactoring:\n\n* Improvements to markdown rendering.\n* Remove code dependency on project variable, instead use title param."
},
{
"commit": "54b1a784b55fdee915b550e5151f20dabea4e67c",
"date": "2016-11-17 09:57:59 -0500",
"subject": "v1.11: Bug Fix for Asynchronous Archiving Efficiency"
},
{
"commit": "dbb9d80dab5a69130b34d1949a4aec889a49b758",
"date": "2016-11-17 09:39:21 -0500",
"subject": "Fixed an issue where asynchronous archiving was transferring one file per execution instead of transferring files in batches.",
"body": "This regression was introduced in v1.09 and affected efficiency only, all WAL segments were correctly archived in asynchronous mode."
},
{
"commit": "06cac30c33733d3894a3143a6866a9dbd3972199",
"date": "2016-11-08 10:47:47 +0000",
"subject": "v1.10: Stanza Creation and Minor Bug Fixes"
},
{
"commit": "9d9c438f59461e17383cd55dd067a467132ba2de",
"date": "2016-11-07 17:06:35 +0200",
"subject": "Doc engine improvements.",
"body": "Bug Fixes:\n\n* Fixed missing variable replacements.\n* Removed hard-coded host names from configuration file paths.\n\nDocumentation Features:\n\n* Allow command-line length to be configured using cmd-line-len param.\n* Added compact param to allow CSS to be embedded in HTML file.\n* Added pretty param to produce HTML with proper indenting.\n* Only generate HTML menu when required and don't require index page.\n* Assign numbers to sections by default.\n* VM mount points are now optional."
},
{
"commit": "dd621081b95e5dcf737807053346b7c89e9f962d",
"date": "2016-11-07 16:37:16 +0200",
"subject": "Fixed an issue where tablespace paths with the same prefix would cause an invalid link error.",
"body": "Reported by Nikhilchandra Kulkarni."
},
{
"commit": "21ca4127026e80f93664d78fcf1e81d8dda0d25d",
"date": "2016-11-05 19:22:30 +0200",
"subject": "Fixed an issue where a backup could error if no changes were made to a database between backups and only pg_control changed."
},
{
"commit": "f43e5bc52d31b6f1efe3b92b44752aa49ab1645a",
"date": "2016-11-04 13:56:26 +0200",
"subject": "Removed extraneous use lib directives from Perl modules.",
"body": "Suggested by Devrim Gündüz."
},
{
"commit": "171c5835bbed34e118e554a291849baa36ecfce0",
"date": "2016-11-03 17:48:59 +0200",
"subject": "Another expect log update for stanza-create feature."
},
{
"commit": "26f76762b5ca80bb2ff6c7c5c8e2da11f825420d",
"date": "2016-10-17 10:03:42 +0100",
"subject": "Expect log updates for stanza-create feature."
},
{
"commit": "8d1880ca4a15567778b1c295451b3bb62886cc7b",
"date": "2016-10-14 12:21:47 +0100",
"subject": "Added the stanza-create command to formalize creation of stanzas in the repository.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1e0ca3056a84abb07214b54ea2945fcdacd65000",
"date": "2016-10-10 17:35:58 -0400",
"subject": "v1.09: 9.6 Support, Configurability, and Bug Fixes"
},
{
"commit": "49a5e8a3f59716cf8f73b458f4cd0c5e47175e48",
"date": "2016-10-07 08:51:10 -0400",
"subject": "Fixed a remote timeout.",
"body": "The timeout occurred when a local process generated checksums (during resume or restore) but did not copy files, allowing the remote to go idle."
},
{
"commit": "41669a826ee48c7bbcd7a6c2ef849093d3287b6a",
"date": "2016-10-05 21:22:42 -0400",
"subject": "Added --dev option to doc.pl to easily add dev keyword to documentation builds."
},
{
"commit": "16d0e767ef40f22d83166c88bc7177ff01e7fb3c",
"date": "2016-10-05 21:15:10 -0400",
"subject": "Set application_name to \"pgBackRest [command]\" for database connections.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "0a4099fff87458265a5a14006967c48c3cf912bf",
"date": "2016-10-05 21:13:29 -0400",
"subject": "Clarified error message when unable to acquire pgBackRest advisory lock to make it clear that it is not a PostgreSQL backup lock.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "5dc801d59db9c8ce2f0872deb13b532b32af80ee",
"date": "2016-10-05 09:47:34 -0400",
"subject": "Fixed an issue where the async archiver would not be started if archive-push did not have enough space to queue a new WAL segment.",
"body": "This meant that the queue would never be cleared without manual intervention (such as calling archive-push directly). PostgreSQL now receives errors when there is not enough space to store new WAL segments but the async process will still be started so that space is eventually freed."
},
{
"commit": "2a18674111d8ee01e15960dd1fcd0da3282bb38c",
"date": "2016-10-05 09:09:30 -0400",
"subject": "Added the log-level-stderr option.",
"body": "Controls whether console log messages are sent to stderr or stdout. By default this is set to warn which represents a change in behavior from previous versions, even though it may be more intuitive. Setting log-level-stderr=off will preserve the old behavior."
},
{
"commit": "d81198e65e2cca8272d52cc586dcc76016b91f2d",
"date": "2016-10-05 08:55:54 -0400",
"subject": "Added the cmd-ssh to allow the ssh client to be specified.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "6f34fbc6957f16719749372d78c014abe9b8a5f7",
"date": "2016-10-03 09:15:29 -0400",
"subject": "Vagrant build improvements:",
"body": "* Minimize TeXLive package list to save time during VM builds.\n* General cleanup and added timestamps.\n* Pin to specific box version."
},
{
"commit": "07898d33e332aa892e406d2df729c5d900110d41",
"date": "2016-10-03 07:28:44 -0400",
"subject": "Fixes for archive checks added in 5d033d0:",
"body": "* Don't execute pg_is_in_recovery() on PostreSQL < 9.0.\n* Don't check archive_mode or archive_command on the standby."
},
{
"commit": "1491862716aeff6c3a9434b207dcdaf7962ce387",
"date": "2016-10-01 13:39:44 -0400",
"subject": "Regression tests can now be run as any properly-configured user, not just vagrant."
},
{
"commit": "198e498b41e85dfcd3698bfb5a79907f41ca5656",
"date": "2016-09-29 19:09:19 -0400",
"subject": "Non-exclusive backups will automatically be used on PostgreSQL 9.6.",
"body": "This feature carries over from 1.08 but has now been tested with the official 9.6 release."
},
{
"commit": "156859c5d519b5bb757412a805208b78a46d3832",
"date": "2016-09-29 19:07:46 -0400",
"subject": "Update CentOS/Debian package definitions."
},
{
"commit": "3e4ca153cea6750a3efbf1b1a319623afcfee86a",
"date": "2016-09-29 18:26:32 -0400",
"subject": "Fixed broken vm-max option in test.pl."
},
{
"commit": "5d033d028c54142c872ca4ce8cef6ac05e9ec55a",
"date": "2016-09-28 19:45:33 -0400",
"subject": "Archive validation improvements:",
"body": "* Fixed error message to properly display the archive command when an invalid archive command is detected.\n* Check that archive_mode is enabled when archive-check option enabled."
},
{
"commit": "48f968b344138f6309f1203f26ecce7198d453b0",
"date": "2016-09-28 12:29:29 -0400",
"subject": "Added archive-timeout option documentation to the user guide.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "76673a8e62636a1cbcd364b4252130b6b5a83bd0",
"date": "2016-09-27 18:01:38 -0400",
"subject": "Fixed the check command to prevent an error message from being logged if the backup directory does not exist.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "25f40f9b15f987989b8286da47c631d6e6246abf",
"date": "2016-09-17 11:53:28 -0400",
"subject": "Log improvements:",
"body": "* pgBackRest version number included in command start INFO log output.\n* Process ID logged for local process start/stop INFO log output.\n* Fixed missing expect output for help module."
},
{
"commit": "d98df8c8cff41970a5549328722d90cbc7f8f19d",
"date": "2016-09-14 17:36:43 -0500",
"subject": "v1.08: Bug Fixes and Log Improvements"
},
{
"commit": "69c6afb1dfa3c494f3fd8c3c5d98a8ab5e10a1e2",
"date": "2016-09-14 16:40:13 -0500",
"subject": "Cache file log output until the file is created to create a more complete log."
},
{
"commit": "f54145c0ccd4676eebd7184edee4746c02981bfe",
"date": "2016-09-14 16:37:07 -0500",
"subject": "Fixed timeout issues.",
"body": "* Fixed an issue where local processes were not disconnecting when complete and could later timeout. (Reported by Todd Vernick.)\n* Fixed an issue where the protocol layer could timeout while waiting for WAL segments to arrive in the archive. (Reported by Todd Vernick.)"
},
{
"commit": "e08b56a4e33436d8fdff11020897fc8f73bbaa57",
"date": "2016-09-14 16:30:57 -0500",
"subject": "Show Process ID in log output instead of filtering it out with the timestamp."
},
{
"commit": "f253a4d85ce47d5706123ce15c460e068e983595",
"date": "2016-09-08 17:29:26 -0400",
"subject": "Suppress \"dpkg-reconfigure: unable to re-open stdin: No file or directory\" warning in Vagrant VM build.",
"body": "Contributed by John Harvey."
},
{
"commit": "a8590c9aded9a6603eb0ed64ac1a5792f700e22e",
"date": "2016-09-07 08:29:21 -0400",
"subject": "v1.07: Thread to Process Conversion and Bug Fixes"
},
{
"commit": "d2add293c7959d8b1919520f98202f07a0c1cba0",
"date": "2016-09-07 08:07:37 -0400",
"subject": "Archive retention improvements:",
"body": "* Fixed an issue where retention-archive was not automatically being set when retention-archive-type=diff, resulting in a less aggressive than intended expiration of archive.\n* Additional warnings when archive retention settings may not have the intended effect or would allow indefinite retention.\n* Closed #235: \"Retention policy question\" by adding documentation for archive retention."
},
{
"commit": "0d5a1eaf9efc3e051221cc32b373139cc1a274a6",
"date": "2016-09-07 07:20:07 -0400",
"subject": "The archive-start and archive-stop settings are now filled in backup.manifest."
},
{
"commit": "cc9c8819eee1257b08f44eaf43597f5e97833932",
"date": "2016-09-06 14:01:39 -0400",
"subject": "Make uid/gid selection for containers dynamic."
},
{
"commit": "cedfcbd4be9be7c37d211731f1b10f5e0d50e25a",
"date": "2016-09-06 11:02:01 -0400",
"subject": "Update Vagrantfile:",
"body": "* Change box provider to bento (hoping for better stability with Docker).\n* Install texlive from Debian packages."
},
{
"commit": "dd8d7812170c4312654dd12d2c742c1963653a92",
"date": "2016-09-06 09:44:50 -0400",
"subject": "Safely check eval blocks and convert $@ to $EVAL_ERROR."
},
{
"commit": "a701309453a7df8f8808f6739e06e357ec0bf63f",
"date": "2016-09-06 09:35:02 -0400",
"subject": "Converted Perl threads to processes."
},
{
"commit": "4026ad649d4383c500bd40717e2fb177d01a7692",
"date": "2016-09-06 09:15:22 -0400",
"subject": "Refactor of protocol minions in preparation for the new local minion."
},
{
"commit": "f71073c11f413f99f35b3c253f35a0aaed34edfb",
"date": "2016-09-04 19:29:30 -0400",
"subject": "Improved temp file handling for archiving."
},
{
"commit": "56ee666e69302b291ec5cc7d04caa25c651d7bfb",
"date": "2016-09-04 09:27:56 -0400",
"subject": "Suppress TOC for unsupported versions of pgBackRest.",
"body": "The intent is to tidy the releases page and nobody should care much about the old, unsupported releases,"
},
{
"commit": "8f61473955e212b605088cfe387c625b40c9863c",
"date": "2016-09-04 09:25:20 -0400",
"subject": "Improve ASSERT error handling."
},
{
"commit": "f986e6ae33a5c87da7a8a5f5e5a11b8d4637a172",
"date": "2016-09-04 09:22:53 -0400",
"subject": "File module improvements.",
"body": "* Remove obsolete thread index variable from File() module.\n* Changed temporary file names to consistently use .pgbackrest.tmp."
},
{
"commit": "bcdb5cdac80372536539c46e12b3d1a5d244f5a9",
"date": "2016-09-04 09:19:44 -0400",
"subject": "Fixed a issue where tablespaces were copied from the master during standby backup."
},
{
"commit": "2feaaf225e2200fd92ad7d12a1281080cbb5603f",
"date": "2016-09-04 09:13:13 -0400",
"subject": "Exclude contents of $PGDATA/pg_replslot directory."
},
{
"commit": "316da4421ec0780963ab8a32d2fee141ff50122d",
"date": "2016-09-03 18:34:38 -0400",
"subject": "Experimental support for non-exclusive backups in PostgreSQL 9.6 rc1."
},
{
"commit": "634f5c6829ce0d4ece466ac2d4c29215b13d6f89",
"date": "2016-08-29 14:09:37 -0400",
"subject": "Closed #250: Fixed the check command so backup info is checked remotely and not just locally.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "f6c24039e1d360b9be9b39ed77488212167570b2",
"date": "2016-08-29 09:43:22 -0400",
"subject": "Fixed minor documentation reproducibility issues related to binary paths."
},
{
"commit": "be77136eaeca4d0943bd00280afcbe3f5a53a096",
"date": "2016-08-25 11:49:09 -0400",
"subject": "v1.06: Backup from Standby and Bug Fixes"
},
{
"commit": "c9bdf6a9ae2f2657ba06eb97a7fbaba38251ef1c",
"date": "2016-08-25 11:27:00 -0400",
"subject": "Fixed timeout issue.",
"body": "The protocol-timeout option was not automatically increased when the db-timeout option was increased."
},
{
"commit": "5ada189a92813a57b9050dec54ba3ddf69f68bf0",
"date": "2016-08-25 11:25:46 -0400",
"subject": "Backup from a standby cluster.",
"body": "A connection to the primary cluster is still required to start/stop the backup and copy files that are not replicated, but the vast majority of files are copied from the standby in order to reduce load on the master."
},
{
"commit": "ecf827579edc9dc620a27985c0bd75a1d8cb3d23",
"date": "2016-08-25 10:04:46 -0400",
"subject": "Improve host tag rendering."
},
{
"commit": "d0b6f78b20cb7c74b43717a97242fce7160d2604",
"date": "2016-08-24 12:39:27 -0400",
"subject": "More flexible configuration for databases",
"body": "Master and standby can both be configured on the backup server and pgBackRest will automatically determine which is the master. This means no configuration changes for backup are required after failing over from a master to standby when a separate backup server is used."
},
{
"commit": "cd6278e5af22119cb0c4e3714dc2a66d3cd219c0",
"date": "2016-08-24 12:27:48 -0400",
"subject": "Revert some backup exclusions until they have been tested more thoroughly."
},
{
"commit": "9c13ca1d091e38dddcd38656fc8af748e8c19675",
"date": "2016-08-24 12:01:08 -0400",
"subject": "mprove backup log messages to indicated which host the files are being copied from."
},
{
"commit": "f1412baccf9ab4b5015d839ae0b598d92dd32586",
"date": "2016-08-16 09:35:16 -0400",
"subject": "Exclude directories during backup that are cleaned, recreated, or zeroed by PostgreSQL at startup.",
"body": "These include (depending on the version where they were introduced): pgsql_tmp, pg_dynshmem, pg_notify, pg_replslot, pg_serial, pg_snapshots, pg_stat_tmp, pg_subtrans. The postgresql.auto.conf.tmp file is now excluded in addition to files that were already excluded: backup_label.old, postmaster.opts, postmaster.pid, recovery.conf, recovery.done."
},
{
"commit": "332055971e29beb031276d7ce32ad4827dabf6d2",
"date": "2016-08-15 20:54:17 -0400",
"subject": "Added hints to error message when relative paths are detected in archive-push or archive-get."
},
{
"commit": "b25f10949a016cc4dc6d2e3ca1c8a63f764059c9",
"date": "2016-08-15 20:15:17 -0400",
"subject": "Fixed #229: Check fails on target db host.",
"body": "Options that should not allow multiple values could be specified multiple times in pgbackrest.conf without an error being raised."
},
{
"commit": "88d9bd3d37475c907a4fffdbf907deafc0b44bc3",
"date": "2016-08-15 17:44:51 -0400",
"subject": "Improvements in Db module.",
"body": "* Separated out connect() function.\n* Allow executeSql() calls that do not return data.\n* Improve error handling."
},
{
"commit": "1e0f15f4253319ff141455a46d597d2f387c8ff1",
"date": "2016-08-15 17:23:37 -0400",
"subject": "Improve error message for links that reference links in manifest build."
},
{
"commit": "f9fa1270b24e2511717d4b4a3ddbee861bb32760",
"date": "2016-08-15 17:11:45 -0400",
"subject": "Fixed #236: Recursive user tablespace symlink.",
"body": "A tablespace link that referenced another link would not produce an error, but instead skip the tablespace entirely."
},
{
"commit": "35931305d71186935534b26d0b08c25946decd58",
"date": "2016-08-15 16:48:24 -0400",
"subject": "Update control version for PostgreSQL beta4."
},
{
"commit": "17b79d62799ac82876b71d79a57d5e5259a2431d",
"date": "2016-08-11 22:35:24 -0400",
"subject": "Database version refactoring.",
"body": "* Refactor db version constants into a separate module.\n* Update synthetic backup tests to PostgreSQL 9.4."
},
{
"commit": "bff262ac4791fae834f13ee4c422da8a4e7cdb1d",
"date": "2016-08-11 17:32:28 -0400",
"subject": "Removed all OP_* function constants that were used only for debugging, not in the protocol, and replaced with __PACKAGE__."
},
{
"commit": "9f19e13095628bf1b654db08ea3eec883c2cc5cd",
"date": "2016-08-09 10:06:21 -0400",
"subject": "v1.05: Bug Fix for Tablespace Link Checking"
},
{
"commit": "34afe5e85b682803dec846bfe480c82d3b3ca05c",
"date": "2016-08-09 09:05:27 -0400",
"subject": "Fixed issue with tablespace link checking.",
"body": "* Tablespace paths that had $PGDATA as a substring would be identified as a subdirectories of $PGDATA even when they were not.\n* Also hardened relative path checking a bit."
},
{
"commit": "af790be34f8cc58c39100f125cff6f539aa47946",
"date": "2016-08-02 12:55:09 -0400",
"subject": "Added documentation for scheduling backups with cron.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "730262678a2f250076c1b772cdc4a457dd6708f4",
"date": "2016-08-02 12:49:39 -0400",
"subject": "Improved rendering of spaces in code blocks."
},
{
"commit": "f0c97289215174cb95d3b4df89cbf9e13ca03243",
"date": "2016-08-02 11:38:12 -0400",
"subject": "Moved the backlog from the pgBackRest website to the GitHub repository wiki.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "277934447b0f4602260978ecb12d2e3d580632df",
"date": "2016-07-30 09:42:35 -0400",
"subject": "v1.04: Various Bug Fixes"
},
{
"commit": "f2b3dda647c9abc487a099876fa0b03f7cd4fa53",
"date": "2016-07-30 08:49:26 -0400",
"subject": "Fixed an issue where a remote could try to start its own remote.",
"body": "This is a better approach than 93320b8 (reverted in this commit) because it ensures that the remote type will be none so any functions that utilize optionRemoteTypeTest will work correctly.\n\nThis bug was only an issue when backup-host was not properly configured on the database host."
},
{
"commit": "94a4cb4123c9a300d66e1f34b666bba84f4d727b",
"date": "2016-07-30 08:43:38 -0400",
"subject": "Disable control master for older OS versions where it is less stable."
},
{
"commit": "1b6b26956ab2d0ee7957d48b148b080376c0a3fe",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Reduce the frequency that certain tests are run to save time in regression."
},
{
"commit": "ac23716d26aaa14470f1ff8307dfe6010e0c3c05",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Enhancements to the protocol layer for improved reliability and error handling."
},
{
"commit": "b44786321889a2f7599c505c9f7b1b3726810dff",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Exceptions are now passed back from threads as messages when possible rather than raised directly."
},
{
"commit": "93320b865e891701dea7383166f8bca6117d5efc",
"date": "2016-07-29 18:45:37 -0400",
"subject": "Fixed a issue where a remote could try to start its own remote."
},
{
"commit": "af5965a6ef9ebe76a1b5ff5c6a82fdaa5f4d3658",
"date": "2016-07-29 18:45:23 -0400",
"subject": "Fixed an invalid log call in lock routines."
},
{
"commit": "a3b8808f94cb8ca6931517002cf30c8b3987357b",
"date": "2016-07-29 18:44:53 -0400",
"subject": "Fixed an issue where the contents of pg_xlog were being copied if the directory was symlinked."
},
{
"commit": "ef33febfb73f449085d6f3da9b0bd6157560e52f",
"date": "2016-07-29 18:43:59 -0400",
"subject": "Temp files created during backup are now placed in the same directory as the target file."
},
{
"commit": "95bbc8ad544cac4a95a90f94de2ca8856811dc37",
"date": "2016-07-29 18:02:16 -0400",
"subject": "Fixed an issue where multi-threaded tests were not being run when requested."
},
{
"commit": "6e9d5f5bd31c835bf6aa7058c3c00a160d56b6c8",
"date": "2016-07-29 14:02:11 -0400",
"subject": "Fixed check command to throw an error when database version/id does not match that of the archive.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "f95d4af64a9e7cee15e190704fa9b4522f08e31e",
"date": "2016-07-26 18:50:58 -0400",
"subject": "Closed #220: Installation documentation misinformation.",
"body": "Updated information about package availability on supported platforms."
},
{
"commit": "ee80b7b255edeac3513781a6d77c84d916832baf",
"date": "2016-07-26 18:30:25 -0400",
"subject": "Added clarification on why the default for the backrest-user option is backrest."
},
{
"commit": "18447569906f915c7801e9ac07500e6d72c8482d",
"date": "2016-07-26 17:40:42 -0400",
"subject": "Closed #209: Don't use \"localtime\" for HTML-docs.",
"body": "HTML footer dates are statically created in English in order to be reproducible."
},
{
"commit": "273d1c08d8cae647afe1b228a865de9a92177cd1",
"date": "2016-07-26 16:57:38 -0400",
"subject": "Improved remote error messages to identify the host where the error was raised."
},
{
"commit": "bc5c04ffe71faed09519e0bfff1f9ef579fc5aae",
"date": "2016-07-26 16:39:01 -0400",
"subject": "Updated control/catalog/WAL versions for 9.6 beta3."
},
{
"commit": "b6ac6b0f1c0d011ada945d9d027c67923a98173b",
"date": "2016-07-26 16:28:43 -0400",
"subject": "Suppress banners on SSH protocol connections."
},
{
"commit": "f31ec20fcb249027a4aa455a9193eee40842497d",
"date": "2016-07-26 16:21:14 -0400",
"subject": "Reduce calls to protocolGet() in backup/restore."
},
{
"commit": "98a67792ecd02c05511de7ec9c1830a200326ea7",
"date": "2016-07-26 16:14:15 -0400",
"subject": "Output lock file name when a lock cannot be acquired to aid in debugging."
},
{
"commit": "d96b1a0dbc86fab538bf1be53825675774e9cbc9",
"date": "2016-07-26 16:12:38 -0400",
"subject": "All remote types now take locks.",
"body": "The exceptions date to when the test harness and pgBackRest were running in the same VM and no longer apply."
},
{
"commit": "095351f145003c62b24770e8a5ef96ec6125e624",
"date": "2016-07-26 16:08:05 -0400",
"subject": "Fixed #219: Unable to acquire restore lock.",
"body": "Fixed an issue an where an extraneous remote was created causing threaded backup/restore to possibly timeout and/or throw a lock conflict."
},
{
"commit": "5893c3cd2e7e6dd77283b17d59a5e72c34f6dec7",
"date": "2016-07-19 15:26:41 -0400",
"subject": "Fixed an issue where db-path was not required for the check command so an assert was thrown when it was missing rather than a polite error message.",
"body": "Reported by Michael Vitale."
},
{
"commit": "9ae6c01432ba66f5b2b743394af0ac00908a0ea9",
"date": "2016-07-19 15:22:20 -0400",
"subject": "Fixed a version checking issue in test.pl."
},
{
"commit": "6e528080650dda98109d2bc31c48197804a29eda",
"date": "2016-07-02 11:08:25 -0400",
"subject": "Added release.pl to make releases reproducible."
},
{
"commit": "1b62354dcb6cd815fc8a5b235b0aaf52eb85a692",
"date": "2016-07-02 10:22:52 -0400",
"subject": "v1.03: Check Command and Bug Fixes"
},
{
"commit": "186ca18659f42e1cc287f0737db0f2138fa3dc54",
"date": "2016-07-02 09:19:10 -0400",
"subject": "Update WAL/catalog versions for 9.5 beta 2."
},
{
"commit": "5df2eed72916bc68dbf2bb0d772b4a5e3fcfbe55",
"date": "2016-07-02 09:07:48 -0400",
"subject": "Order database versions during test.pl --vm-build."
},
{
"commit": "418039027b32c680680f83183dabb1f7e1adbcb4",
"date": "2016-07-02 09:02:55 -0400",
"subject": "Closed #213: Archive command should not be validate when archive-check=n"
},
{
"commit": "0f2eb424bb6d53f2c6619f70535706e649f7c9a9",
"date": "2016-07-02 08:59:11 -0400",
"subject": "Fix for container build in Vagrantfile."
},
{
"commit": "9f9396943f20e00157b53494bc074d355456b689",
"date": "2016-06-30 19:38:28 -0400",
"subject": "Added documentation for asynchronous archiving.",
"body": "Also removed some obsolete sections."
},
{
"commit": "304d890f6c0ead8d49cf8f31fcef9f918904896a",
"date": "2016-06-27 23:07:47 -0400",
"subject": "Release note edits."
},
{
"commit": "9516db4ad660a4be29fd43b34ab9e0ef848daaf8",
"date": "2016-06-27 20:37:25 -0400",
"subject": "Closed #209: Don't use \"localtime\" for HTML-docs.",
"body": "The release-date-static var has been added to allow the html footer to use the last release date instead of localtime()."
},
{
"commit": "cc2a8777d5efdaebfc17b053f747e8683a8ce3b1",
"date": "2016-06-26 21:01:20 -0400",
"subject": "User/group permissions improvements.",
"body": "Improved handling of users/groups captured during backup that do not exist on the restore host. Also explicitly handle the case where user/group is not mapped to a name."
},
{
"commit": "b571218930c4ef5578e2c42f73c3e24bcfaba216",
"date": "2016-06-26 20:53:45 -0400",
"subject": "Minor refactor of version variable to a constant.",
"body": "It had originally been designed to play nice with a specific packaging tool but that tool was never used."
},
{
"commit": "6ee485cc76ec05421ac4f45e50cd90911739163d",
"date": "2016-06-24 13:16:07 -0400",
"subject": "Added more keep-alives.",
"body": "Keep-alives were also missing from multi-threaded backup/restore and single-threaded restore."
},
{
"commit": "bd25223fd6167ef2e1cc4e9788de46371a647572",
"date": "2016-06-24 10:54:31 -0400",
"subject": "Rename test paths for clarity.",
"body": "This was worked out as part of the test suite refactor [c8f806a] but not committed with it because of the large number of expect logs changes involved. Keeping them separate made it easier to audit the changes in the refactor."
},
{
"commit": "c8f806a293813323affea96c73b1aa177a0ac15a",
"date": "2016-06-24 08:12:58 -0400",
"subject": "Major refactor of the test suite.",
"body": "* Make the code more modular and object-oriented.\n* Multiple Docker containers can now be created for a single test to simulate more realistic environments."
},
{
"commit": "23a39118301384d939f431a344a724c8fc39f5e0",
"date": "2016-06-24 08:06:20 -0400",
"subject": "Stop using pg_xlogfile_name().",
"body": "The pg_xlogfile_name() function is no longer used to construct WAL filenames from LSNs. While this function is convenient it is not available on a standby. Instead, the archive is searched for the LSN in order to find the timeline. If due to some misadventure the LSN appears on multiple timelines then an error will be thrown, whereas before this condition would have passed unnoticed."
},
{
"commit": "41b27c0456793694316daa882ffbd2209fd249c3",
"date": "2016-06-22 18:01:18 -0400",
"subject": "Protocol timeout option and keep-alive fixes.",
"body": "* Fixed an issue where keep-alives could be starved out by lots of small files during multi-threaded operation and were completely absent during single-threaded operation when resuming from a previous incomplete backup.\n\n* Added the protocol-timeout option. Previously protocol-timeout was set as db-timeout + 30 seconds.\n* Failure to shutdown remotes at the end of the backup no longer throws an exception. A warning is still generated that recommends a higher protocol-timeout."
},
{
"commit": "4cff5bb0e69f03f047f8e8fe96a9ea336d7b4f31",
"date": "2016-06-18 10:59:45 -0400",
"subject": "Fixed pgBackRest config sections being blank in the output when not loaded from cache."
},
{
"commit": "012405a33b01a3f215a0ee610a2648c5f5afb0f6",
"date": "2016-06-18 09:55:00 -0400",
"subject": "Closed #207: Expire fails with unhandled exception.",
"body": "* Fixed an issue where the expire command would refuse to run when explicitly called from the command line if the db-host option was set. This was not an issue when expire was run after a backup, which is the usual case.\n* Option handling is now far more strict. Previously it was possible for a command to use an option that was not explicitly assigned to it. This was especially true for the backup-host and db-host options which are used to determine locality."
},
{
"commit": "e988b96eceafd1619d2f8c51c94e38523a051f54",
"date": "2016-06-18 09:22:26 -0400",
"subject": "Fixed issue in doc info output with --require.",
"body": "Section names were being repeated in the info output when multiple --require options depended on the same sections."
},
{
"commit": "cb32a8ab1f1aa2f71070cfd61c70d7fb4933abb4",
"date": "2016-06-13 11:18:06 -0400",
"subject": "VM build improvements.",
"body": "* Properly set user env before calling test.pl --vm-build.\n* Remove squid proxy made obsolete by more efficient builds."
},
{
"commit": "7e45ed8366f8933a0e8f52b5777f6618d57766a2",
"date": "2016-06-12 09:13:46 -0400",
"subject": "Added check command.",
"body": "The check command validates that pgBackRest is configured correctly for archiving and backups."
},
{
"commit": "7c9eaf7210181ca806c1e8b477bc8a0df8d4af3a",
"date": "2016-06-12 09:01:56 -0400",
"subject": "Add cmd-description tag.",
"body": "Allow command summaries to be inserted anywhere in the documentation to avoid duplication."
},
{
"commit": "f1e92804cef8e2fa7f85d231aaf5d5710130bee9",
"date": "2016-06-12 09:00:16 -0400",
"subject": "Docker container improvements.",
"body": "* Containers now use a squid proxy for apt/yum to speed builds.\n* Obsolete containers are removed by the --vm-force option.\n* Greatly reduced the quantity of Docker containers built by default. Containers are only built for PostgreSQL versions specified in db-minimal and those required to build documentation. Additional containers can be built with --db-version=all or by specifying a version, e.g. --db-version=9.4."
},
{
"commit": "3d761b726aeb243ffda53e6c8d122aa9d323ac32",
"date": "2016-06-10 21:22:36 -0400",
"subject": "Update TeX Live to 2016 version."
},
{
"commit": "5660f69859f02be53b328f7b7773b651ba4e13c1",
"date": "2016-06-06 13:27:52 -0400",
"subject": "Fixed DTDs not being loaded from test.pl."
},
{
"commit": "3f7ca876c255f7e3af772cf374ba9bc44a2be701",
"date": "2016-06-04 12:24:31 -0400",
"subject": "PostgreSQL version is now a variable to allow multi-version documentation."
},
{
"commit": "bfed78ef42599ea5c7e883b16efef973ee84b23a",
"date": "2016-06-04 12:04:09 -0400",
"subject": "New, consolidated implementation for link rendering."
},
{
"commit": "1ddfb1e453aef26590b649c77330d5206978917d",
"date": "2016-06-04 11:40:33 -0400",
"subject": "Fixed pgBackRest-specific xml that was loaded for non-pgBackRest projects."
},
{
"commit": "8ddfab0cbc646bfd11fcee1b4a47d3a3b617ae7a",
"date": "2016-06-04 11:38:23 -0400",
"subject": "Fixed DTD search path.",
"body": "The search path that did not work properly when --doc-path was used."
},
{
"commit": "e796f563c4af7a265a1f8ecd94e7f3f795a78839",
"date": "2016-06-03 20:07:28 -0400",
"subject": "Add cmd-extra field.",
"body": "Allow hidden options to be added to a command. This allows certain commands (like apt-get) to be forced during the build without making that a part of the documentation."
},
{
"commit": "36cf0b18f5c7db870f8b0338ee43e84c32ad4661",
"date": "2016-06-03 18:59:12 -0400",
"subject": "Update installation documentation.",
"body": "* Recommended install location for pgBackRest modules is now /usr/share/perl5 since /usr/lib/perl5 has been removed from the search path in newer versions of Perl.\n\n* Added instructions for removing prior versions of pgBackRest."
},
{
"commit": "bfaee7380d6aa0a4a4573df2a6a28581537d169b",
"date": "2016-06-02 11:10:24 -0400",
"subject": "v1.02: Bug Fix for Perl 5.22"
},
{
"commit": "eaa981c5aae6b3d8a04fd2d518f180be0921ba4c",
"date": "2016-06-02 09:32:56 -0400",
"subject": "Added execution cache for document generation.",
"body": "Added an execution cache so that documentation can be generated without setting up the full container environment. This is useful for packaging, keeps the documentation consistent for a release, and speeds up generation when no changes are made in the execution list."
},
{
"commit": "df6086bd24ce9d9322e5c048e5337719e9a43a0a",
"date": "2016-06-02 09:25:12 -0400",
"subject": "Added a man page to document generation."
},
{
"commit": "9a9f26a96f0365b0223231f74426602edb5caad9",
"date": "2016-05-27 18:36:25 -0400",
"subject": "Some wordsmithing in the introduction."
},
{
"commit": "174b16165b2cd555fd63a6516520900089d643ab",
"date": "2016-05-26 16:57:35 -0400",
"subject": "Replaced overzealous perl -cW check.",
"body": "It failed on Perl 5.22 so replaced with with perl -cw."
},
{
"commit": "379ab1b3533c525d87b2dacd34ac7d3a9796305e",
"date": "2016-05-26 15:04:18 -0400",
"subject": "Improve log directory/file creation.",
"body": "Log directory create and file open now using FileCommon functions which produce more detailed error messages on failure."
},
{
"commit": "e4e885d602781afd42f78c74378af2e78e0a4d27",
"date": "2016-05-26 14:22:26 -0400",
"subject": "Add notes for Ubuntu 16.04 upgrade."
},
{
"commit": "cf344c144f6c12cca2950429ce61ae075f69d902",
"date": "2016-05-26 14:17:50 -0400",
"subject": "Fixed absolute paths that were used for the PDF logo."
},
{
"commit": "b19143b6eaf0a04f921c791a7e62e2aa4f367547",
"date": "2016-05-26 14:07:29 -0400",
"subject": "Fixed syntax in doc code that was not compatible with Perl 5.2X."
},
{
"commit": "28f1c927e715b55aa4b5dcba936a6f6c03d46ed5",
"date": "2016-05-26 14:03:32 -0400",
"subject": "Upgrade doc/test VM to Ubuntu 16.04.",
"body": "* This will help catch Perl errors in the doc code since it is not run across multiple OSs like the core and test code.\n* It is to be hoped that a newer kernel will make Docker more stable."
},
{
"commit": "3d437d9278488d25b30da828a173042774c0e009",
"date": "2016-05-26 11:23:52 -0400",
"subject": "Fix usage of sprintf() for Perl 5.22.",
"body": "Parameters not referenced in the format string are no longer allowed."
},
{
"commit": "b1c779e606bf6d7e1a30c338694ae628fbac853b",
"date": "2016-05-26 11:04:19 -0400",
"subject": "Next development cycle."
},
{
"commit": "bfec2d2f89a0e746d145bd896b8f9c4ba02dde9d",
"date": "2016-05-26 11:03:10 -0400",
"subject": "Fixed release version test when the current version is development."
},
{
"commit": "c8d68bcf2d33b206634d0d537ef6d4bfb84229ba",
"date": "2016-05-26 10:34:10 -0400",
"subject": "More detailed release notes.",
"body": "Release notes are now broken into sections so that bugs, features, and refactors are clearly delineated. An \"Additional Notes\" section has been added for changes to documentation and the test suite that do not affect the core code."
},
{
"commit": "0fb8bcbfb7107b83c345dac1858aab02eeeb4302",
"date": "2016-05-26 09:34:03 -0400",
"subject": "Lists can now be used outside of p and text tags.",
"body": "This allows for more flexible document structuring."
},
{
"commit": "5a85122841ff38bea5b7b3d02a5d8ace40a4e81f",
"date": "2016-05-26 09:20:55 -0400",
"subject": "Moved change log to website.",
"body": "The change log was the last piece of documentation to be rendered in Markdown only. Wrote a converter so the document can be output by the standard renderers. The change log will now be located on the website and has been renamed to \"Releases\"."
},
{
"commit": "e2094c3d312a69544cd144e4758508c7966075b8",
"date": "2016-05-26 09:09:42 -0400",
"subject": "Remove function constants and pass strings directly to logDebugParam().",
"body": "The function names were only used once so creating constants for them was wasteful."
},
{
"commit": "e7d4a25d6a5613b89e3186517f6d4888b3ed9faa",
"date": "2016-05-24 08:17:13 -0400",
"subject": "Added Ubuntu 16.04 and Debian 8 to regression tests.",
"body": "Also added some new fields to make container generation simpler for distros that share a common package base."
},
{
"commit": "f2a14a06e5a3b9b702cdbcf5f7cfdfb0acfa6e51",
"date": "2016-05-23 20:04:36 -0400",
"subject": "Moved version checking code so it doesn't run in containers.",
"body": "The required modules were not loaded so errors were occurring during regression tests."
},
{
"commit": "c604b6e657a0ff195d291d6b7f972ef02f508011",
"date": "2016-05-23 19:33:02 -0400",
"subject": "Test release version using change-log.xml instead of CHANGELOG.md.",
"body": "This is in preparation for moving the change log to the website and removing it from Github."
},
{
"commit": "3af48f1d7818287d9e4443748becc63b86958ab7",
"date": "2016-05-20 11:18:51 -0400",
"subject": "Initialize local variable variable immediately, per Perl Critic."
},
{
"commit": "c9632e987437031d40765019bd6ee279cb101197",
"date": "2016-05-19 17:10:34 -0400",
"subject": "Closed #195: Added type from source node in manifest.xml.",
"body": "This parameter `allows the doc code to determine if special handling is needed for the xml document."
},
{
"commit": "3a309256fa9547f8a26fe0563a873a5be1385c2f",
"date": "2016-05-19 10:25:04 -0400",
"subject": "Closed #193: Fix perl warnings in doc/ tree.",
"body": "Somewhere between perl 5.14 and 5.20, constructs like this:\n perl -e '$a = {}; keys $a'\nstarted to throw warnings:\n keys on reference is experimental at -e line 1.\n\nFix by adding a bunch of %{} and @{} casts."
},
{
"commit": "b710c016302d8d29c502aab5688197bf9a664131",
"date": "2016-05-17 01:04:01 -0400",
"subject": "v1.01: Enhanced Info, Selective Restore, and 9.6 Support"
},
{
"commit": "0451d3afddfd6af2b6d32c2aba898e13f4cd170a",
"date": "2016-05-16 17:59:26 -0400",
"subject": "Support for non-exclusive backups in PostgreSQL 9.6."
},
{
"commit": "28c5e54b09c5428c53f43a8e6b9b2c2ce727ad09",
"date": "2016-05-16 17:01:48 -0400",
"subject": "Added SEO and sharing features to the website.",
"body": "Descriptions wordsmithed (for better or worse) by committer."
},
{
"commit": "48eecc2c04d59f74755d7f4db2b73da8e9e29ce6",
"date": "2016-05-16 16:49:54 -0400",
"subject": "Added vim to test virtual machine."
},
{
"commit": "9b5a27f6578b7041d72f8527e71c35aa60c0e8ab",
"date": "2016-05-14 10:39:56 -0400",
"subject": "Add Manifest->addFile().",
"body": "Some files need to be added to the manifest after the initial build. This is currently done in only one place but usage will expand in the future so the functionality has been encapsulated in addFile()."
},
{
"commit": "77b01e980fc82d81585531bd688d8a32bed759d5",
"date": "2016-05-14 10:36:35 -0400",
"subject": "Make the initial capital for hints consistent.",
"body": "Some hints started with a capital letter and others did not. Make them all lower case for consistency."
},
{
"commit": "512d006346a06ef2eaf7af7ac2863a2c1a62f3de",
"date": "2016-05-14 10:33:12 -0400",
"subject": "Refactor database version identification for archive and backup commands.",
"body": "Added database version constants and changed version identification code to use hash tables instead of if-else. Propagated the db version constants to the rest of the code and in passing fixed some path/filename constants.\n\nAdded new regression tests to check that specific files are never copied."
},
{
"commit": "4d9920cc48d871035a9a601095c6700510dd5388",
"date": "2016-05-14 10:29:35 -0400",
"subject": "Fix null and linefeed handling in Db->executeSql().",
"body": "The join() used was not able to handle nulls and was replaced by a loop. An injudicious trim was removed when the source of extra linefeeds was determined to be an additional loop execution that was not handled correctly."
},
{
"commit": "0c320e7df77a63e3bbebf43dc931b5884531a772",
"date": "2016-05-11 09:21:39 -0400",
"subject": "Allow selective restore of databases from a cluster backup.",
"body": "This feature can result in major space and time savings when only specific databases are restored. Unrestored databases will not be accessible but must be manually dropped before they will be removed from the shared catalogue."
},
{
"commit": "e430f0a05439ff851d3c4fa8b5a19cd1c743b945",
"date": "2016-05-11 08:59:34 -0400",
"subject": "Added `--db-version=minimal` option as default.",
"body": "This change assigns each version of PostgreSQL to a specific OS version for testing to minimize the number of tests being run. In general, older versions of PostgreSQL are assigned to older OS versions.\n\nThe old behavior can be enabled with `--db-version=all`."
},
{
"commit": "a6a19e3735f5edfa449fe351372b9d4be625d03e",
"date": "2016-05-10 18:12:37 -0400",
"subject": "Test directories are now located on the host VM rather than in the Docker container.",
"body": "This change allows for easier testing since all files are local on the host VM and can be easily accessed without using `docker exec`. In addition, this change is required to allow multiple Docker containers per test case which is coming soon."
},
{
"commit": "60b901948af90126700685b5424f332a490d1ad1",
"date": "2016-05-06 10:25:46 -0400",
"subject": "Enhanced text output of info command to include timestamps, sizes, and the reference list for all backups."
},
{
"commit": "7b64843221277d4afb7a6a2c8ac4222faf7c551b",
"date": "2016-05-06 09:37:01 -0400",
"subject": "Added trim() to process id read from lock file.",
"body": "The prior way worked fine but added extraneous linefeeds to the log output."
},
{
"commit": "c477d6f8998f9e8fa8d7015b1c850e1332ab00cc",
"date": "2016-05-05 18:13:50 -0400",
"subject": "Next development cycle."
},
{
"commit": "6cd1c42ddc19f2511f159ea1ccdcc5469f728594",
"date": "2016-05-03 16:28:20 -0400",
"subject": "Add usage documentation for test.pl."
},
{
"commit": "7b030c5173b6d67c72b3efe54b3542ae3d694432",
"date": "2016-05-03 16:12:44 -0400",
"subject": "User Guide clarifications."
},
{
"commit": "afc8a76ee9ed26738f8b0777a14e5084e9087d20",
"date": "2016-04-25 16:33:08 -0400",
"subject": "Fixed typos in user guide."
},
{
"commit": "226d266d087b1d686e2171aa6f20ab216ef63e97",
"date": "2016-04-17 11:43:33 -0400",
"subject": "Added current stable release to documentation."
},
{
"commit": "0d34c34cea1d8cca005e659e03c1520792b5c6a1",
"date": "2016-04-17 11:27:19 -0400",
"subject": "Added feature backlog.",
"body": "This backlog is intended to hold long-lived feature requests that clutter up the issues area on Github."
},
{
"commit": "7bdfa7839a1fa260b857bcde9a7e91414d7196e6",
"date": "2016-04-17 09:32:03 -0400",
"subject": "Minor wording change: problems => challenges."
},
{
"commit": "7bd9b28ff4e5c296ff5c76b0259b40fe90c58b54",
"date": "2016-04-17 08:23:09 -0400",
"subject": "Expanded feature bullet points into a new section with detailed explanations.",
"body": "Copy editing by John Harvey (@crunchyjohn), Jason O'Donnell (@Dwaligon), and Stephen Frost (@sfrost)."
},
{
"commit": "ed20c2eda3790b6a327f05a1c08761cdec38f8eb",
"date": "2016-04-16 16:38:44 -0400",
"subject": "Close #172: Unable to unpack Int64 when running on 32-bit OS",
"body": "Added a note to documentation that only 64-bit distributions are supported. It seems unlikely that anybody would be running a production server on anything else these days so we'll wait for a field report before taking further action."
},
{
"commit": "dee3e86ff8444689f427147e9199070b8bb46ab3",
"date": "2016-04-16 11:55:23 -0400",
"subject": "README.md is now rendered by new Markdown code."
},
{
"commit": "ad8ad11e4f555fb5b50c963eb6a61eae642e6750",
"date": "2016-04-16 11:11:29 -0400",
"subject": "Update URLs for new Github org."
},
{
"commit": "9ab0dd80f70cc69a6edc9e61b6053752a789fde3",
"date": "2016-04-14 23:04:20 -0400",
"subject": "v1.00: New Repository Format and Configuration Scheme, Link Support"
},
{
"commit": "9457e15347b05b4565074a3455f9edc4d1edaae3",
"date": "2016-04-14 22:50:02 -0400",
"subject": "New manifest format.",
"body": "* All files and directories linked from PGDATA are now included in the backup. By default links will be restored directly into PGDATA as files or directories. The --link-all option can be used to restore all links to their original locations. The --link-map option can be used to remap a link to a new location.\n\n* Removed --tablespace option and replaced with --tablespace-map-all option which should more clearly indicate its function.\n\n* Added detail log level which will output more information than info without being as verbose as debug."
},
{
"commit": "9a7d8b26cceb435d69378dd4bdc4eab74af11167",
"date": "2016-04-14 13:50:58 -0400",
"subject": "Fixed some inaccurate statements in the user guide. Fixed typo in documentation code comments."
},
{
"commit": "18fd25233b1db7b3197f5d8dc537d239dcfc7aba",
"date": "2016-04-14 09:30:54 -0400",
"subject": "New simpler configuration and consistent project/exe/path naming.",
"body": "* The repo-path option now always refers to the repository where backups and archive are stored, whether local or remote, so the repo-remote-path option has been removed. The new spool-path option can be used to define a location for queueing WAL segments when archiving asynchronously. Otherwise, a local repository is no longer required.\n\n* Implemented a new config format which should be far simpler to use. See the User Guide and Configuration Reference for details but for a simple configuration all options can now be placed in the stanza section. Options that are shared between stanzas can be placed in the [global] section. More complex configurations can still make use of command sections though this should be a rare use case.\n\n* The default configuration filename is now pgbackrest.conf instead of pg_backrest.conf. This was done for consistency with other naming changes but also to prevent old config files from being loaded accidentally.\n\n* The default repository name was changed from /var/lib/backup to /var/lib/pgbackrest.\n\n* Lock files are now stored in /tmp/pgbackrest by default. These days /run/pgbackrest would be the preferred location but that would require init scripts which are not part of this release. The lock-path option can be used to configure the lock directory.\n\n* Log files are now stored in /var/log/pgbackrest by default and no longer have the date appended so they can be managed with logrotate. The log-path option can be used to configure the lock directory.\n\n* Executable filename changed from pg_backrest to pgbackrest."
},
{
"commit": "885797e4b58a675487a3531ba16908c1d1e9f970",
"date": "2016-04-13 19:09:35 -0400",
"subject": "Migrated many functions from File.pm to FileCommon.pm.",
"body": "This makes make the migrated file functions available to parts of the code that don't have access to a File object. They still exist as wrappers in the File object to support remote calls."
},
{
"commit": "be8487dbad8a52f8b1f5083e3d7e2e3e47140dce",
"date": "2016-04-13 19:05:31 -0400",
"subject": "Changed some TBD comments from urgent to whenever."
},
{
"commit": "723abadb750c78b661c9d29404455d4a95cfc7aa",
"date": "2016-04-13 18:55:34 -0400",
"subject": "Change spacing in expect logs to accommodate DETAIL level."
},
{
"commit": "64b2858bb50c6b5f5f3cc6934c6dab671c203bbe",
"date": "2016-04-13 18:47:29 -0400",
"subject": "Test VM build improvements.",
"body": "* Specific VMs can now be built by using --vm along with --vm-build.\n* Docker caching can be disabled with --vm-force.\n* ControlMaster is now used for al VMs to improve test speed."
},
{
"commit": "0e4fdda6d8f7da0b737f2ffd3f0d1ad9ec3a33ab",
"date": "2016-04-12 15:50:25 -0400",
"subject": "Improved error handling when remote closes unexpectedly.",
"body": "In conditions where an error is known to have occurred wait to try and capture the error in the first call that detects the error. Due to timing sometimes the error could be caught later, which worked, but it made the functionality inconsistent in testing."
},
{
"commit": "8adbcccd02d133f9650486019911f41afe80100d",
"date": "2016-04-06 10:00:11 -0400",
"subject": "Closed #184: Change test/log directory to test/expect.",
"body": "This should make it clearer that these are expect logs for regression testing."
},
{
"commit": "aacc369e4fc5ff40c8731f47303c547934315988",
"date": "2016-04-06 09:41:33 -0400",
"subject": "Next development cycle."
},
{
"commit": "5307c858a7007c9b17f63aaef0439ac951d8741a",
"date": "2016-04-06 09:14:06 -0400",
"subject": "v0.92: Command-line Repository Path Fix"
},
{
"commit": "1ce9961f8a65e0e127418905c54a11736e8b6ad3",
"date": "2016-04-06 08:57:46 -0400",
"subject": "Closed #183: Options --repo-path and --repo-remote-path ignored in archive-push.",
"body": "Fixed an issue where the master process was passing --repo-remote-path instead of --repo-path to the remote and causing the lock files to be created in the default repository directory (/var/lib/backup), generally ending in failure. This was only an issue when --repo-remote-path was defined on the command line rather than in pg_backrest.conf."
},
{
"commit": "1bbf3e6db4d4e1d43b03e75b3eb308565a700952",
"date": "2016-03-22 22:18:33 -0400",
"subject": "Fixed #181: Missing semicolon violates code style."
},
{
"commit": "1d4779cfe6645bcfe508cd117c3f77146164066f",
"date": "2016-03-22 10:23:20 -0400",
"subject": "Next development cycle."
},
{
"commit": "aea14c85531b564777e60ce4a6259a22413fae10",
"date": "2016-03-22 10:16:42 -0400",
"subject": "v0.91: Tablespace Bug Fix and Minor Enhancements"
},
{
"commit": "d4899141734a4ae1abe52721d7f32f2148e05579",
"date": "2016-03-22 09:57:39 -0400",
"subject": "Closed #180: Backup format regression in v0.90."
},
{
"commit": "c669dc01e957701161ea7a7ff15392157451d750",
"date": "2016-03-10 10:58:07 -0500",
"subject": "Fixed url references in latex documentation to use \\href instead of \\hyperref."
},
{
"commit": "87dd0a127ffc4a55aeefca16ebf740b0e12a1731",
"date": "2016-03-09 11:27:08 -0500",
"subject": "Clarification for delta restore documentation to indicate that files may be removed."
},
{
"commit": "004067a5fab8d7d91e24503cd560c319feccb08f",
"date": "2016-03-08 09:29:03 -0500",
"subject": "Correct retention-diff example value in documentation."
},
{
"commit": "0b317d9040d33c46f466155f9873757c11517884",
"date": "2016-02-27 10:11:58 -0500",
"subject": "Fix minor bug in protocol compression.",
"body": "This erroneous last caused a warning (which threw an error) and masked the error in decompression. It was found when accidentally attempting to decompress an already-decompressed file, so not a big deal in practice which is probably why it hug around for so long."
},
{
"commit": "d4c46acf489910ccf248f7e04438a8108647d03a",
"date": "2016-02-23 09:39:37 -0500",
"subject": "Working on #174: Get Perl Critic to pass on stern",
"body": "Added single exception for the violation of BuiltinFunctions::ProhibitStringyEval and removed from policy file."
},
{
"commit": "048571e23fc9e5b0756c0f19590fe4b74706a01e",
"date": "2016-02-23 09:25:22 -0500",
"subject": "Closed #173: Add static source code analysis",
"body": "Perl Critic added and passes on gentle. A policy file has been created with some permanent exceptions and a list of policies to be fixed in approximately the order they should be fixed in."
},
{
"commit": "d35ab82a83895049ea542b3a53b2e90f9428d176",
"date": "2016-02-19 19:32:02 -0500",
"subject": "Closed #167: Rename `--no-start-stop` option to `--no-online`."
},
{
"commit": "fb63a981cb89b7741120d87be78f7ffd38c4d5de",
"date": "2016-02-14 20:42:11 -0500",
"subject": "Closed #166: Copy global/pg_control last during backup."
},
{
"commit": "053f25d870836c001fd826927fa32b5d4ef97a58",
"date": "2016-02-11 21:42:27 -0500",
"subject": "Closed #170: Write .info and .manifest files to temp before moving to final location and syncing"
},
{
"commit": "17cbab524aa8e4ef541253aa5923afffb8f98820",
"date": "2016-02-11 21:40:43 -0500",
"subject": "Combine chmod commands in tests for efficiency."
},
{
"commit": "f360d5072e6a7ec29489a72732783153ba0c4a92",
"date": "2016-02-07 11:20:43 -0500",
"subject": "Next development cycle."
},
{
"commit": "631535ae4fc443102cac0f2da5bdc8fb2671468e",
"date": "2016-02-07 10:47:16 -0500",
"subject": "v0.90: 9.5 Support, Various Enhancements, and Minor Bug Fixes"
},
{
"commit": "de9b6d5133c5fbbb02cb0c8b7d4596843a2d3545",
"date": "2016-02-06 16:49:12 -0500",
"subject": "Closed #113: Better error message when repo does not exist."
},
{
"commit": "f8b47997a314ed6502b915a0514b20ac23598dab",
"date": "2016-02-05 23:03:29 -0500",
"subject": "Closed #127: More sanity checking for --delta restores",
"body": "Added checks for `--delta` and `--force` restore options to ensure that the destination is a valid $PGDATA directory. pgBackRest will check for the presence of `PG_VERSION` or `backup.manifest` (left over from an aborted restore). If neither is found then `--delta` and `--force` will be disabled but the restore will proceed unless there are files in the $PGDATA directory (or any tablespace directories) in which case the operation will be aborted."
},
{
"commit": "5c815e4fc0e2c8a9ea162963f32d5679d54fc852",
"date": "2016-02-02 14:33:15 -0500",
"subject": "Closed #58: Get catalog number for better tablespace copying",
"body": "When backing up and restoring tablespaces pgBackRest only operates on the subdirectory created for the version of PostgreSQL being run against. Since multiple versions can live in a tablespace (especially during a binary upgrade) this prevents too many files from being copied during a backup and other versions possibly being wiped out during a `--delta` restore. This only applies to PostgreSQL >= 9.0 -- before that only one PostgreSQL version could use a tablespace."
},
{
"commit": "24a1ad31d0dfcd8c72a71c589902446a9da75e11",
"date": "2016-02-02 11:57:46 -0500",
"subject": "Minor rewording in user guide."
},
{
"commit": "02405e851cc6f1941f0de8001cdf6829d6fa06c0",
"date": "2016-01-22 18:01:21 -0500",
"subject": "Closed #163: Document Generation Issue",
"body": "Fixed an issue where document generation failed because some OSs are not tolerant of having multiple installed versions of PostgreSQL. A separate VM is now created for each version. Also added a sleep after database starts during document generation to ensure the database is running before the next command runs."
},
{
"commit": "bacdd5583dc7dfc807c385789b26e346db6c219a",
"date": "2016-01-22 14:38:48 -0500",
"subject": "User guide highlighting fixes for #93."
},
{
"commit": "e42b8de618b0a8bd003d8b62eefadf7ed0aee34f",
"date": "2016-01-20 21:45:03 -0500",
"subject": "Updated Copyright for 2016."
},
{
"commit": "83b1a3cb4446fb59d1295706a547b41fc5bd84be",
"date": "2016-01-20 21:28:40 -0500",
"subject": "Closed #150: Fixed an issue where a temp WAL file left over after a well-timed system crash could cause the next `archive-push` to fail."
},
{
"commit": "747346db674705d7db15e8f9293016b00875b4d5",
"date": "2016-01-20 18:34:42 -0500",
"subject": "Closed #162: When restore `--set=latest` (the default) the actual backup restored will be output to the log."
},
{
"commit": "2d38876bc4676344936ad72d65d0f697c4e921c1",
"date": "2016-01-20 17:24:44 -0500",
"subject": "Closed #93: The `retention-archive` option can now be be safely set to less than backup retention (`retention-full` or `retention-diff`) without also specifying `archive-copy=n`. The WAL required to make the backups that fall outside of archive retention consistent will be preserved in the archive. However, in this case PITR will still not be possible for backups that fall outside of archive retention."
},
{
"commit": "904a8c956f53ae5f6832e6188a668d94a84220b9",
"date": "2016-01-19 07:39:29 -0500",
"subject": "Refactor of expiration to use backup.info for a list of what needs to be expired rather than looking at the backup directory."
},
{
"commit": "65cce69dcc7b03605ab46f0f542bc653ecb4154c",
"date": "2016-01-15 23:37:17 -0500",
"subject": "Closed #131: Offline backups make expire command fail."
},
{
"commit": "fce72615366dd5a78359bd05c0919210eb128019",
"date": "2016-01-15 23:22:30 -0500",
"subject": "Only allow --no-cleanup option when a single test is selected."
},
{
"commit": "4d12cc233e26e568fa8449691051b8f33b238873",
"date": "2016-01-15 20:31:29 -0500",
"subject": "Fix for typo in error message."
},
{
"commit": "e91e481f3dcdb5e03320663bfa732b3aef49b49e",
"date": "2016-01-15 07:07:00 -0500",
"subject": "Closed #19: The following tablespace checks have been added: paths or files in pg_tblspc, relative links in pg_tblspc, tablespaces in $PGDATA. All three will generate errors."
},
{
"commit": "67fb7a23bc2d448938c000ec7189cc1f9b979440",
"date": "2016-01-14 19:37:06 -0500",
"subject": "Master test log is output to file."
},
{
"commit": "65d0c7dc3bd60eb432dd4a582419c3c39866801a",
"date": "2016-01-13 22:48:35 -0500",
"subject": "Updated Crunchy URL."
},
{
"commit": "c2b1620c53555924dd4ef666db1a124702ebd5b1",
"date": "2016-01-13 22:43:26 -0500",
"subject": "Logging enhancements:",
"body": "1) Show log output realtime when --max-process=1 or only 1 test is being run.\n2) Dry run now shows test output when --vm-out is specified."
},
{
"commit": "a0a3d1e97e91ddb6ebbb2ac8ff3f2445f3c455f0",
"date": "2016-01-13 20:35:12 -0500",
"subject": "Closed #122: 9.5 Integration",
"body": "The archive_mode = always setting is not included but is covered by issue #125."
},
{
"commit": "c7502f341b4ffbe976ff08bf311f24d6d377a408",
"date": "2016-01-11 09:50:45 -0500",
"subject": "Generate an error when `archive-check=y` but `archive_command` does not execute `pg_backrest`."
},
{
"commit": "81a2fde21fc9fe98bb3473164b5ac4717bdb067b",
"date": "2016-01-10 21:07:07 -0500",
"subject": "Fixed typos in test documentation."
},
{
"commit": "0f88943b7b2e142d86d3a03755a41a1b31754338",
"date": "2016-01-10 19:30:51 -0500",
"subject": "Database versions are now run as separate tests."
},
{
"commit": "cd9fa6f028114f4e44068137a6d14bcd74d882d7",
"date": "2016-01-10 09:19:21 -0500",
"subject": "Updated test logs for partial WAL segment support."
},
{
"commit": "29102b2887dc6f0a1ad0603c48d14bc92e15fa8a",
"date": "2016-01-09 23:08:54 -0500",
"subject": "Added error when archive_mode=always is configured."
},
{
"commit": "7f0f8823df16f3bb4f68fbe7fca4da259ade6409",
"date": "2016-01-09 19:37:28 -0500",
"subject": "Added support for partial WAL segments."
},
{
"commit": "e72165a689889f87a863821f6d5edbada425feae",
"date": "2016-01-09 10:11:03 -0500",
"subject": "Provisional support for PostgreSQL 9.5. No support for `archive_mode = 'always'` or `.partial` WAL on a standby."
},
{
"commit": "c8f863fbabaf5060e6c8b837856363339740d346",
"date": "2016-01-09 08:21:53 -0500",
"subject": "Text execution improvements:",
"body": "1) Tests for all operating systems can now be run with a single command.\n2) Tests can be run in parallel with --process-max.\n3) Container generation now integrated into test.pl\n4) Some basic test documentation."
},
{
"commit": "4a384ffbdb3824b116fcf1db63920fc6eddd18ea",
"date": "2016-01-03 20:24:14 -0500",
"subject": "Added archive-check config test. Fixed capitalization error in optionboolSetTest()."
},
{
"commit": "6f6c796fbf9d4cdafcede1368b63904e9690f598",
"date": "2016-01-03 20:21:30 -0500",
"subject": "Fixed an issue where specifying --no-archive-check would throw a configuration error."
},
{
"commit": "7f630aec49eceada43d3c60f2a810cc3e5960a08",
"date": "2015-12-29 13:57:10 -0500",
"subject": "Switched to using docker for all unit tests as this allows for greater automation."
},
{
"commit": "91d1e940769cf81bd511745c9b303833d8940b66",
"date": "2015-12-24 12:49:47 -0500",
"subject": "Next development cycle."
},
{
"commit": "50a62fab6ded931efd9c87fe3767fd26f4f7318b",
"date": "2015-12-24 11:32:29 -0500",
"subject": "v0.89: Timeout Bug Fix and Restore Read-Only Repositories"
},
{
"commit": "ba098d7b91c189d8ee7f45a157ba8e5a243eb85b",
"date": "2015-12-24 10:32:25 -0500",
"subject": "Fixed an issue where longer-running backups/restores would timeout when remote and threaded.",
"body": "Keepalives are now used to make sure the remote for the main process does not timeout while the thread remotes do all the work. The error messages for timeouts was also improved to make debugging easier."
},
{
"commit": "b0a6954671dcee50e16a72f4c44d0eaa84b67c5c",
"date": "2015-12-23 11:04:26 -0500",
"subject": "A number of doc improvements:",
"body": "1) Started on a general markdown renderer\n2) Internal links now work in PDF\n3) Improvements to PDF styling\n4) Some comment and formatting fixes\n5) User guide edits."
},
{
"commit": "fdc99e30bd2e154623fb71134413a11d695d3420",
"date": "2015-12-23 10:48:33 -0500",
"subject": "Allow restores to be run against a read-only repository.",
"body": "Two things needed to be changed:\n1) Don't open a log file when log-level-file=off\n2) New --no-lock option to suppress lock file creation for restores."
},
{
"commit": "d5cef05a6857512bc1c1410909a58df4d1c102da",
"date": "2015-12-21 19:25:50 -0500",
"subject": "Added rc to version check."
},
{
"commit": "a840808bc6916e089dcb119998a742fbb8629fea",
"date": "2015-12-21 19:25:17 -0500",
"subject": "Regression test for issue #159: duplicated log section entries in config file",
"body": "Add a perl -cW test to prevent similar errors in the future."
},
{
"commit": "fe9c66591f3a0324b0bae483d825d75c4ac38d74",
"date": "2015-12-21 14:29:54 -0500",
"subject": "Fixed issue #159: Duplicated log section entries in config file",
"body": "This would cause a warning when run with perl -cw but appears to have been harmless otherwise."
},
{
"commit": "4925756dee22faee7bf6e1ca9bcd417d09cf5ba4",
"date": "2015-11-22 18:16:54 -0500",
"subject": "Merge branch 'master' into dev after release 0.88"
},
{
"commit": "e04c21b012d8196f716f093a5bbc46f16cc4a1fb",
"date": "2015-11-22 17:27:30 -0500",
"subject": "v0.88: Documentation and Minor Bug Fixes"
},
{
"commit": "fa05715dec955a30f271df9c1c059c9c876e3f4d",
"date": "2015-11-22 16:44:01 -0500",
"subject": "Added documentation in the user guide for delta restores, expiration, dedicated backup hosts, starting and stopping pgBackRest, and replication."
},
{
"commit": "8ddfdcdd3bc2ee5e76487d903696840655357f87",
"date": "2015-11-22 14:02:14 -0500",
"subject": "Various fixes and features implemented during doc development",
"body": "* Better messaging for expiration.\n* Fixed already stopped message.\n* retention-archive and retention-archive-type now use retention-full and 'full' when not specified.\n* Fixed issue where backup-user was required (should default to backrest).\n* ExecuteTest now supports retries.\n* Fixed issue where log test was not comparing test logs.\n* Fixed issue where test logs would not match for ssh connection errors"
},
{
"commit": "7ff9fc996c6f43e6c6aeff68624b145efa3fea89",
"date": "2015-11-20 11:03:06 -0500",
"subject": "Release notes for fixes and rebuild command-line help."
},
{
"commit": "4c5470e0499e336b704e9472d8a3c7463b256cc2",
"date": "2015-11-20 10:55:28 -0500",
"subject": "Implemented issue #156: Don't create backup symlinks in the repository."
},
{
"commit": "11f724bdfc31f7a3fa701d44ce985f47362f65a2",
"date": "2015-11-20 10:28:58 -0500",
"subject": "Fixed issue #155: Start/Stop do not automatically read config file."
},
{
"commit": "d89cd955d0fb5b45ec69e02e948c18eab9feb9bf",
"date": "2015-11-20 09:18:12 -0500",
"subject": "Fixed issue #154: Log files are overwritten rather than appended."
},
{
"commit": "e5cf1d84a710eb03c179b41c271e203613a89377",
"date": "2015-10-29 17:45:29 +0100",
"subject": "CSS Tweaks."
},
{
"commit": "2f83362f32114f2f516d344334e3fa25e0aaad4b",
"date": "2015-10-28 13:02:35 +0100",
"subject": "Minor user guide fix."
},
{
"commit": "a498becf11f385c4b525c318412ec8154c0ebd34",
"date": "2015-10-28 11:29:04 +0100",
"subject": "Merge branch 'master' into dev after release 0.87"
},
{
"commit": "2813c4d4ebdeccff8a54cbf8157fa3bdca01c44b",
"date": "2015-10-28 11:15:38 +0100",
"subject": "v0.87: Website and User Guide"
},
{
"commit": "32ce87d56d0def3a4249606eca9dec765fb1fca4",
"date": "2015-10-28 10:19:33 +0100",
"subject": "Fixed minor path issue in README.md."
},
{
"commit": "57a06ba3b12533d623090714c99d1604a74085e6",
"date": "2015-10-28 10:10:36 +0100",
"subject": "Implemented issue #148: Website with basic user guide."
},
{
"commit": "3dc014224487c8ab32a86874396b3e78b647315e",
"date": "2015-10-08 14:36:39 -0400",
"subject": "Renamed userguide.xml to reference.xml so it doesn't conflict with the new user guide."
},
{
"commit": "994ead1f05eac573948993b51dcb9a1f45f4876e",
"date": "2015-10-08 13:47:51 -0400",
"subject": "Removed IO::String dependency from docs."
},
{
"commit": "0bcbe21520f66f58d6795cd0e0969ba90afa8332",
"date": "2015-10-08 12:44:55 -0400",
"subject": "Merge branch 'master' into dev after release 0.85"
},
{
"commit": "097eb7ca419a49464fdcfccac873760acf4fee3e",
"date": "2015-10-08 12:34:50 -0400",
"subject": "v0.85: Start/Stop Commands and Minor Bug Fixes"
},
{
"commit": "6e170d27e4ec69b94f38f0f5db4a6abe5232f393",
"date": "2015-10-08 12:23:37 -0400",
"subject": "Replaced expired CentOS VMs with new ones."
},
{
"commit": "1f9d6c330a35cdfb7402439240e5fc8a77811fea",
"date": "2015-10-08 12:22:57 -0400",
"subject": "Updated WAL magic for PostgreSQL 9.5 beta1."
},
{
"commit": "ddd4c14773176d03ffbb30d958f6c3d8596e41a3",
"date": "2015-10-08 11:43:56 -0400",
"subject": "Implemented issue #129: Stop/Start Commands. Implemented issue #136: Add stderr back into protocol layer.",
"body": "There were also miscellaneous bug fixes and improvements to buffering in IO.pm."
},
{
"commit": "e488f7bb198b4af6f7b1595392b57648bf985dcb",
"date": "2015-09-22 21:07:49 -0400",
"subject": "Fixed issue #144: Error on resume when temp files (file.tmp.*) present."
},
{
"commit": "a3d82eef9897965dbe1bff08a92418877447acca",
"date": "2015-09-16 15:23:19 -0500",
"subject": "Document code in Db.pm."
},
{
"commit": "210f8ef723a56d0f0d4d8c4a0120729ef952a44a",
"date": "2015-09-14 12:28:22 -0400",
"subject": "Merge branch 'master' into dev after release 0.82"
},
{
"commit": "9be15d00f8527309fd81118bb483adb0b1956651",
"date": "2015-09-14 11:18:50 -0400",
"subject": "v0.82: Refactoring, Command-line Help, and Minor Bug Fixes"
},
{
"commit": "e0dafbff7ff294b137e085cde63f0e69685b31b3",
"date": "2015-09-09 15:40:54 -0400",
"subject": "Improvements to issue #132: Improved command-line help. Regression tests are now more comprehensive by default. Better handling for errors in safeExit(). Release notes."
},
{
"commit": "d7e3be1ebff5d0d017a7406552acd9b3a97f0bb8",
"date": "2015-09-08 18:29:13 -0400",
"subject": "Fixed issue #138: Fix --no-start-stop working on running db without --force.",
"body": "Unable to reproduce this anymore. It seems to have been fixed with the last round of config changes. Add regression tests to make sure it doesn't happen again."
},
{
"commit": "b17bf31fb6dbe67b6efdcd634a4d29ede1cf9d76",
"date": "2015-09-08 16:58:00 -0400",
"subject": "Implement issue #130: Info files should be updated with new version when pgBackRest is upgraded."
},
{
"commit": "59b2261a8ee15d061367ffefe598c05cb93fcb3e",
"date": "2015-09-08 16:44:47 -0400",
"subject": "Fix issue #137: Info command throws an exception if no stanzas exist."
},
{
"commit": "8d01138f6def41f12a1c3adcf4e7fbfea65b9aae",
"date": "2015-09-08 15:47:34 -0400",
"subject": "Improved issue #135: Suppress PostgreSQL notices.",
"body": "Regression tests now fail if there is any unexpected output on stderr."
},
{
"commit": "bb6963cf3b7ba30e2fa13e8df57b234d283d2cbe",
"date": "2015-09-08 14:01:19 -0400",
"subject": "Implement issue #135: Suppress PostgreSQL notices."
},
{
"commit": "adc5568b15090c797863206830730e1974bfdc7a",
"date": "2015-09-08 12:58:13 -0400",
"subject": "Fixed issue #132: Improved command-line help.",
"body": "Some platform specific fixes and added regression tests to detect issues."
},
{
"commit": "ac3c0d43ab8701855b45bc40f1298e9707dc0e14",
"date": "2015-09-08 07:31:24 -0400",
"subject": "Implemented issue #132: Improved command-line help. Implemented issue #133: Dynamic module loading where possible."
},
{
"commit": "0913072c4554d62a50e393158f4685dd52831390",
"date": "2015-09-02 19:07:21 -0400",
"subject": "Removed unused parameter from Info::new()."
},
{
"commit": "ee55817fcee2184b353e26f608b461d9d3fc9d7f",
"date": "2015-09-02 18:55:04 -0400",
"subject": "Refactoring documentation generator."
},
{
"commit": "bf3ef15ccc2991686c51ba10946ef095d248951f",
"date": "2015-09-01 19:05:10 -0400",
"subject": "Implemented issue #117: Refactor expiration tests to be purely synthetic"
},
{
"commit": "6a9377a0a9389d285cd36b1fe179d47f46e15d9a",
"date": "2015-08-29 14:20:46 -0400",
"subject": "Code cleanup and refactoring to standardize on patterns that have evolved over time."
},
{
"commit": "d3262822efff785911fa1d2450d1fb1ac0d1b950",
"date": "2015-08-27 15:55:29 -0400",
"subject": "Fixed issue #128: Replace config name in test logs",
"body": "It was actually the bin path that was causing the issue."
},
{
"commit": "83473eb9fb4e437c47a1773c7f4cb7e93f71ee2a",
"date": "2015-08-09 11:29:00 -0400",
"subject": "Merge branch 'master' into dev after release 0.80"
},
{
"commit": "a59284a4cca37a0c299f411e44cdfe7e43bb9ba7",
"date": "2015-08-09 11:20:43 -0400",
"subject": "v0.80: DBI Support, Stability, and Convenience Features"
},
{
"commit": "65d9de4ee76bcce4f102e2b17d7f7ced809880a0",
"date": "2015-08-09 09:18:58 -0400",
"subject": "Document issue #114: Better description of repo-path."
},
{
"commit": "7e49e4596f9fdaae102c5caae7dae35c25e75bef",
"date": "2015-08-08 20:17:33 -0400",
"subject": "Removed dead function wait_for_file()."
},
{
"commit": "45259a487f2522ac961ceba0bb38cc8ad0089d00",
"date": "2015-08-08 18:36:36 -0400",
"subject": "Change log for issue #94: backup_stop needs a timeout."
},
{
"commit": "1ab6239b4e9b37ed34564e9de9ee102fea82b329",
"date": "2015-08-08 18:32:41 -0400",
"subject": "Implemented issue #118: Clean up database vs. database cluster in the docs."
},
{
"commit": "e82afac8854e74fb1451491abde5f353ca496b1b",
"date": "2015-08-08 18:22:38 -0400",
"subject": "Implemented issue #94: backup_stop needs a timeout.",
"body": "The timeout applies to all queries agains the cluster during a backup."
},
{
"commit": "8c0508789e5debc508aae05d28ebe5f7f4700809",
"date": "2015-08-08 17:11:20 -0400",
"subject": "Implemented issue #25: Option to call stop_backup with every backup."
},
{
"commit": "12e8a7572c07fc4ea1d44ba944e530c391396047",
"date": "2015-08-08 00:51:58 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Expiration tests worked differently with checkpoint_segments. Only allow this test < 9.5 until purely synthetic tests are written."
},
{
"commit": "2edf5d4bf7b47b4fd3fd446740a82c35be84dbda",
"date": "2015-08-07 14:43:53 -0400",
"subject": "Split most of README.md out into CHANGELOG.md and USERGUIDE.md. Added release dates to change log."
},
{
"commit": "61c729b37b7787740a1e011544dd97971c44d0ce",
"date": "2015-08-07 10:21:08 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Skip copying tablespace_map instead of deleting it later.\nCleaned up the skip code for pg_control as well."
},
{
"commit": "4e7bd4468a785a00c37b5d29262d86f76f725a78",
"date": "2015-08-06 16:36:55 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Most tests are working now. What's not working:\n\n1) --target-resume option fails because pause_on_recovery setting was removed. Need to implement to the new 9.5 option and make that work with older versions in a consistent way.\n2) No tests for the new .partial WAL segments that can be generated on timeline switch."
},
{
"commit": "adb8a009255fdfcd726bf7ded3aef60c80b645cf",
"date": "2015-08-06 00:24:02 -0400",
"subject": "Improvements to release notes."
},
{
"commit": "ca1fd9740aede681866e8a52bcece052de631597",
"date": "2015-08-06 00:00:30 -0400",
"subject": "Working on issue #117: Refactor expiration tests to be purely synthetic.",
"body": "Split BackupTest.pm into two modules. It was getting ungainly to work on."
},
{
"commit": "8b57188bc1e5e6941bf46e9fc4cfd6d8e5bd7856",
"date": "2015-08-05 23:37:46 -0400",
"subject": "Fixed issue #120: Wrong \"oldest backup timestamp\" in info output."
},
{
"commit": "a10dd8ba98b2c0e16b560e447336c663e7b865de",
"date": "2015-08-05 22:05:45 -0400",
"subject": "Implemented issue #121: Check data from db against what's passed to backrest."
},
{
"commit": "576d50fc1ed0283b5b77e99a72bdf787b473a1c3",
"date": "2015-08-05 18:54:41 -0400",
"subject": "Added ssh control master config to speed regression testing. Added vagrant config for Centos 7."
},
{
"commit": "ba4e5fc4cb486c28ddba44f60cfc77fe8b171b39",
"date": "2015-08-05 13:35:19 -0400",
"subject": "Release notes for issue #20: Convert Postgres calls from psql to DBD::Pg."
},
{
"commit": "23e6267adc90293d80887492208f68de3c40297d",
"date": "2015-08-05 12:32:12 -0400",
"subject": "Implemented issue #20: Convert Postgres calls from psql to DBD::Pg."
},
{
"commit": "f8a2da940012187d5a48c10018ded60128793f5d",
"date": "2015-08-05 08:43:41 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "* Major refactoring of the protocol layer to support this work.\n* Fixed protocol issue that was preventing ssh errors (especially connect) from being logged."
},
{
"commit": "021afa804638c609a7a8074a9502f4bf05c01688",
"date": "2015-08-01 17:26:15 -0400",
"subject": "Ensure that info output is terminated by a linefeed.",
"body": "On some systems the JSON->encode() function was adding a linefeed and on others it was not. This was causing regression test failures in in the test logs and may have also been inconvenient for users."
},
{
"commit": "1b0f997f59ef67358b7091fe832b9a5b026da0de",
"date": "2015-07-24 18:05:06 -0400",
"subject": "Implemented issue #119: Make sure all repo permissions are 640/750.",
"body": "Updated remaining test logs."
},
{
"commit": "97c036973cb945912a08ee7774bc5619a331db7f",
"date": "2015-07-23 13:11:38 -0400",
"subject": "Implemented issue #119: Make sure all repo permissions are 640/750."
},
{
"commit": "f3199d13b1c213fe6a52c16ca935fe878dcfbc97",
"date": "2015-07-16 11:12:48 -0400",
"subject": "Implement issue #115: When restoring copy pg_control last."
},
{
"commit": "702afeb6f0e14003d4e694e5d3f2b3b39f5b6164",
"date": "2015-07-13 15:37:50 -0400",
"subject": "Merge branch 'master' into dev after release 0.78"
},
{
"commit": "c568f5e72745ec9a799c8cd42a5bb8492a5dbec2",
"date": "2015-07-13 14:44:32 -0400",
"subject": "v0.78: Remove CPAN dependencies, stability improvements"
},
{
"commit": "65847b5fb1c2886ea7d2d546236c2db3202a34ae",
"date": "2015-07-13 13:25:04 -0400",
"subject": "Vagrant backrest mount is no longer RO so development can be done entirely within VMs."
},
{
"commit": "89c0f23f372aa08dd7eaff51eb08fb09f8749d89",
"date": "2015-07-13 12:13:07 -0400",
"subject": "Update release notes and some test fixes."
},
{
"commit": "073e3b7c0055a45b0717d4a4b91ede54a3b68569",
"date": "2015-07-11 22:47:22 -0400",
"subject": "Minor for regression tests. Improved CentOS 6 vagrant config."
},
{
"commit": "ea7914d9805aea676b25bd31ce38459f32803294",
"date": "2015-07-11 19:07:28 -0400",
"subject": "Wait now uses a Fibonacci backoff rather than exponential."
},
{
"commit": "b777525f62fdde71dab702a9afef9b5ad8f6a4b5",
"date": "2015-07-11 17:16:35 -0400",
"subject": "Added --exe param to allow testing of packaged versions. Updates to u12 vagrant vm."
},
{
"commit": "e9ce4efedfb653338a5a9a40bbe1238393ea6886",
"date": "2015-07-10 09:20:28 -0400",
"subject": "Removed dependency on dequeue_timed() which eliminates the CPAN install. Added vagrant config for CentOS 6."
},
{
"commit": "1df8c305499ee698f91dacf9958c8eb56e71e64c",
"date": "2015-07-09 10:21:02 -0400",
"subject": "Swapped config and operation sections to hopefully make the docs flow a little better."
},
{
"commit": "e799361e90adcb1648b2ce208f2fb3ffdd47df2e",
"date": "2015-07-09 10:11:49 -0400",
"subject": "Clarification for CPAN requirements."
},
{
"commit": "8b7fd99637d26cff0df192534a729effa435d97a",
"date": "2015-07-06 21:00:48 -0400",
"subject": "Added vagrant configuration for Ubuntu 12.04. Changes to regression tests to work better with VMs."
},
{
"commit": "bb443dd098140e07d8ceddc56673b45f303c748d",
"date": "2015-07-06 17:59:44 -0400",
"subject": "Renamed pg_backrest.pl to pg_backrest in the docs."
},
{
"commit": "38f48be3cf7be6a24ee513f48fd4a55eb54a1ee5",
"date": "2015-07-02 10:05:13 -0400",
"subject": "Improvements to help to make it more dynamic depending on environment. Changed PgBackRest to pgBackRest."
},
{
"commit": "12932dc54cf24a43b7db7c7e829ad04cbc8816d6",
"date": "2015-06-30 14:57:17 -0400",
"subject": "Merge branch 'master' into dev after release 0.77"
},
{
"commit": "b1ded135df1e3dd4d4b40a0cbb1a7c1303e7a037",
"date": "2015-06-30 14:47:58 -0400",
"subject": "v0.77: CentOS/RHEL 6 support and protocol improvements"
},
{
"commit": "7248795b91dcc6fe749561afb556f625dfe20497",
"date": "2015-06-29 22:07:42 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "Replaced IPC::System::Simple and Net::OpenSSH with IPC::Open3 to eliminate CPAN dependency for multiple distros. Using open3 will also be used for local processes so it make sense to switch now."
},
{
"commit": "c59adfc68dd10e2ab42a686cace1829b6e4d4e2a",
"date": "2015-06-27 11:12:44 -0400",
"subject": "Shorted test command line params."
},
{
"commit": "760baab6b25196df2e1aa430e8736debad34a433",
"date": "2015-06-22 14:35:25 -0400",
"subject": "Implemented issue #111: Add the psql path for *BSD.",
"body": "Author: Eric Radman\nModified by Committer"
},
{
"commit": "dcad0f70070488692c39409b99cb082fe3d0e796",
"date": "2015-06-22 14:20:56 -0400",
"subject": "Merged issue #111: Print the real exception when DBH->connect fails.",
"body": "Author: Eric Radman"
},
{
"commit": "f210fe99c33fbab478fc3e75cc09bd5e5089446f",
"date": "2015-06-22 13:11:07 -0400",
"subject": "Implemented issue #109: Move VERSION into source code.",
"body": "Also stopped replacing FORMAT number which explains the large number of test log changes. FORMAT should change very rarely and cause test log failures when it does."
},
{
"commit": "af580168712ac0c370cc5532bb34ab1805823ffa",
"date": "2015-06-22 10:04:58 -0400",
"subject": "Release notes for issue #108: Incompatibility with Perl 5.10.1."
},
{
"commit": "fdd9e8eb176ec0f5c087726393f15a19d121fabd",
"date": "2015-06-22 09:58:01 -0400",
"subject": "Improved release notes on fsync to include restore."
},
{
"commit": "3f841fcd95c17541d5f04012a72153a8d5cbd8ce",
"date": "2015-06-22 09:51:16 -0400",
"subject": "Improved issue #110: 'db-version' is required but not defined.",
"body": "Improved the error message and added hints."
},
{
"commit": "61dfeca3c1d2ddfce53de9fafd137607e21223b8",
"date": "2015-06-21 12:06:13 -0400",
"subject": "Fixed issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "49f1a3e4812e962201ae80c92ad377f3f8dc4643",
"date": "2015-06-19 14:27:44 -0400",
"subject": "Document issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "0695c0e7af347478c86a6aaddf068f712f27d91d",
"date": "2015-06-19 14:02:26 -0400",
"subject": "Document issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "06c290421240ed74f0388a3b71e240fc1a9e6162",
"date": "2015-06-18 16:55:09 -0400",
"subject": "Change operation constants and functions to command."
},
{
"commit": "4e2c14623b5fe018ab71f797c2c1b9d9a58634cc",
"date": "2015-06-18 15:39:30 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "More separation of the protocol and remote layers than was done in issue #106.\nSettings are passed to the remote via command-line parameters rather than in the protocol."
},
{
"commit": "22e126eda7802ac30d7f275a58425528238ee265",
"date": "2015-06-17 15:40:12 -0400",
"subject": "Fix for logic that removes trailing spaces from code."
},
{
"commit": "a050b76fa9a6785f67a7b492b8b8bad7dd94a482",
"date": "2015-06-17 15:33:58 -0400",
"subject": "Implement issue #107: Better debug commands."
},
{
"commit": "a5d9d6d84d584ed1f574f0eb7f77b32ea2c8e6e6",
"date": "2015-06-17 12:53:33 -0400",
"subject": "Added file and directory syncs to the File object for additional safety during backup and archiving."
},
{
"commit": "9511f9c35cbc4b5fac38fb67b86ad9c2f859be69",
"date": "2015-06-17 11:26:07 -0400",
"subject": "Implemented issue #106: Roll pg_backup_remote into pg_backrest"
},
{
"commit": "0ba40292532c11d00b6f1e3a5096d0e1a021cac5",
"date": "2015-06-16 16:21:24 -0400",
"subject": "Update version to 0.80."
},
{
"commit": "da8b337ee80b7c28ffb8fde7a4b0a11418b926c8",
"date": "2015-06-16 15:44:27 -0400",
"subject": "Added supported versions of PostreSQL."
},
{
"commit": "c23916d6de7004a5c039ea7810e7306e6fe99b6e",
"date": "2015-06-14 20:59:48 -0400",
"subject": "Merge branch 'master' into dev after release 0.75"
},
{
"commit": "1afbab010fc89476ba8a234772f86ca38e6c4f26",
"date": "2015-06-14 20:59:32 -0400",
"subject": "v0.75: New repository format, info command and experimental 9.5 support"
},
{
"commit": "8459e25e32433c7ecba8d4e5189fee45681ef8ae",
"date": "2015-06-14 11:49:55 -0400",
"subject": "Test fix for issue #96."
},
{
"commit": "b365d9aacc38dd8f8d6d43a99d034cb1cf8b20ff",
"date": "2015-06-14 11:48:33 -0400",
"subject": "Updated release notes for 0.75."
},
{
"commit": "b865070eddb4eedbeab70e5de287e250680b3f85",
"date": "2015-06-14 10:12:36 -0400",
"subject": "Experimental 9.5 support. Unit tests are not working yet."
},
{
"commit": "0b6f81a812a02c34b2f8cc9e5b14139d27dc4895",
"date": "2015-06-14 09:36:58 -0400",
"subject": "Implemented issue #50: Reverse ordering by file size."
},
{
"commit": "57640d1ac33c6a38c6afe632e1b8a3d6271740fc",
"date": "2015-06-14 08:37:37 -0400",
"subject": "Implemented issue #96: Executable names"
},
{
"commit": "6c807f2ddd6a996a46e0d3733f09e61110361742",
"date": "2015-06-13 18:30:10 -0400",
"subject": "Fixed release notes for info command."
},
{
"commit": "148836fe44e81622d1836f851b8b87e21d32188e",
"date": "2015-06-13 18:25:49 -0400",
"subject": "Implemented issue #26: Info command.",
"body": "* Includes updating the manifest to format 4. It turns out the manifest and .info files were not very good for providing information. A format update was required anyway so worked through the backlog of changes that would require a format change.\n\n* Multiple database versions are now supported in the archive. Doesn't actually work yet but the structure should be good.\n\n* Tests use more constants now that test logs can catch name regressions."
},
{
"commit": "5a73b1a2408fd22f90417fcbf70edd41a6a99f3b",
"date": "2015-06-10 15:54:24 -0400",
"subject": "Fixed minor typos in the documentation."
},
{
"commit": "aca4511350ff6a2d30e712ac0eda39774a93ffa0",
"date": "2015-06-10 15:44:13 -0400",
"subject": "Documentation for issue #93: Prevent misconfigured retention-archive setting",
"body": "Not an actual fix - just some documentation to (hopefully) keep users from getting bitten until then."
},
{
"commit": "af98f164cd5f5dfce97b88434e8fe19f7bc0d6aa",
"date": "2015-06-02 09:42:56 -0400",
"subject": "Fixed issue #97: Interleaved log lines during parallel operations."
},
{
"commit": "7e06e53a69e79c49a44bbab14a99f15ac20548d9",
"date": "2015-06-01 09:39:02 -0400",
"subject": "Merge branch 'master' into dev after release 0.70"
},
{
"commit": "f83f0fa54d1a3b13524fa0ded8a6dffe88276bbc",
"date": "2015-06-01 09:24:38 -0400",
"subject": "v0.70: Stability improvements for archiving, improved logging and help"
},
{
"commit": "95d62a82d94985165145d1d543cfdf4acb197992",
"date": "2015-05-31 09:50:42 -0400",
"subject": "Minor log changes for formatting and consistency."
},
{
"commit": "200e3b26fe902ae1c71a5954c72455902676f90a",
"date": "2015-05-29 22:11:51 -0400",
"subject": "Prevent log test regexp replacement when multithreaded. Logging should be completely disabled in this case."
},
{
"commit": "1586e0eb7555a6f2d44925b3572ab2457ff3e069",
"date": "2015-05-29 17:58:13 -0400",
"subject": "Implement issue #92: Check for ERRORs in backup full tests"
},
{
"commit": "e7d2d704fe4befc028257e5f88a97b810a423449",
"date": "2015-05-29 16:31:12 -0400",
"subject": "Fixed issue #91: Race condition in async archive-push."
},
{
"commit": "5fd4f3bd5b68db1f68f1df9c00e513a15fbd387b",
"date": "2015-05-29 14:39:43 -0400",
"subject": "Improvements to log testing.",
"body": "Replaced tokens are now numbered to give a more accurate rendition of the logs.\nSome formatting improvements."
},
{
"commit": "5fce709ae7d925c6969aa002da2dd262fe93d73a",
"date": "2015-05-29 12:33:38 -0400",
"subject": "Document issue #88: Thoughts on repo & release management."
},
{
"commit": "d321ef0b6d5af0c1dce8fd5701edbadffffce5af",
"date": "2015-05-29 12:26:31 -0400",
"subject": "Implement issue #89: Make confess backtraces log-level dependent.",
"body": "ASSERTs still dump stack traces to the console and file in all cases. ERRORs only dump stack traces to the file when the file log level is DEBUG or TRACE."
},
{
"commit": "13e4eec629df044c90c64424a6992ff3e99b5173",
"date": "2015-05-29 11:41:19 -0400",
"subject": "Implement issue #90: Move archive-max-mb archive-stop checks to end of archive-push."
},
{
"commit": "639c27e113fb8fd76be5ca5533e420c2ed11b44c",
"date": "2015-05-29 08:18:12 -0400",
"subject": "Release notes for issue #68: Allow duplicate WAL to be pushed if the checksum matches."
},
{
"commit": "7ace66e544cd4da848b30c893131b61403242b33",
"date": "2015-05-29 08:12:39 -0400",
"subject": "Implement issue #68: Allow duplicate WAL to be pushed if the checksum matches."
},
{
"commit": "6d2f2d3f91227dffe635ab14de3db3d83c09e0c6",
"date": "2015-05-28 20:52:42 -0400",
"subject": "Fix for issue #74: More helpful message when targeting missing stanzas."
},
{
"commit": "3083e5fc7ef96368351a9558fe04e4e7c71c9490",
"date": "2015-05-28 13:17:34 -0400",
"subject": "Fix for issue #83: Provide more helpful error message during archive-stop situations. Fix for issue #84: archive-async in combination with archive-max-mb doesn't work as documented. Unit tests for archive stop."
},
{
"commit": "a4974f8996c519024f6b645650c9f598b41be553",
"date": "2015-05-26 15:29:42 -0400",
"subject": "Fix for issue #70: command line help improvements"
},
{
"commit": "ca0c866d3babd68fb433a12e9efda066ffb8e9eb",
"date": "2015-05-26 12:26:59 -0400",
"subject": "Implement issue #71: log a message when waiting for a checkpoint Some other log improvements"
},
{
"commit": "5c43e7035a2adfafa0c8f3a72dd46913ce0cb771",
"date": "2015-05-26 11:36:03 -0400",
"subject": "Implement issue #79: Support comment characters in config file"
},
{
"commit": "e9099b99aad5cec0b87668fa90babfc18472e63f",
"date": "2015-05-26 10:01:05 -0400",
"subject": "Updated required modules. Minor doc fixes."
},
{
"commit": "d5335b40e83539bf137ff9051ecac84e6d85a2b6",
"date": "2015-05-22 14:49:14 -0400",
"subject": "Fix for issue #80: enabling archive-copy causes failing differential & incremental backups"
},
{
"commit": "5ada7fb5adf25d7127d08879cd270164d231a1be",
"date": "2015-05-12 15:44:10 -0400",
"subject": "Use JSON::PP instead of JSON since it is shipped with core Perl."
},
{
"commit": "ab4efce5d1064cf887dfea4e541d95c8605444a8",
"date": "2015-05-11 18:36:02 -0400",
"subject": "Merge branch 'master' into dev after release 0.65"
},
{
"commit": "49fe40850fad0a850e52d9ebe79e32b7029c5735",
"date": "2015-05-11 18:29:40 -0400",
"subject": "v0.65: Improved resume and restore logging, compact restores"
},
{
"commit": "a7d6382cf2317a0d2502f4410fb372778059206f",
"date": "2015-05-08 19:33:34 -0400",
"subject": "Unit test fix for absolute path change in a0d985b7ad37bb2582d6d92ddd225a9090da1b64."
},
{
"commit": "9aa41ee76bc4f14b8f8e2856893ac09ad68c33d0",
"date": "2015-05-08 18:34:27 -0400",
"subject": "Added tablespace setting to allow compact database restores for development, staging, etc."
},
{
"commit": "a0d985b7ad37bb2582d6d92ddd225a9090da1b64",
"date": "2015-05-07 17:37:25 -0500",
"subject": "Fixed an issue where an absolute path was not written into recovery.conf when the restore was run with a relative path."
},
{
"commit": "1ac4b781fd304fcc6aa663afc324cdb2d1fdcb06",
"date": "2015-05-07 15:56:56 -0600",
"subject": "Better info logging for restore. Most of the messages were debug before and some important ones were missing."
},
{
"commit": "095a9a0b831877b9b5d62b4b37da4caca0edb7df",
"date": "2015-05-07 10:29:30 -0600",
"subject": "Added resume setting to allow disabling resume feature."
},
{
"commit": "328c2ca5c0dd5ed67ddc2c5d76102cee16235f20",
"date": "2015-05-06 18:24:34 -0600",
"subject": "Much better resume: 1) Re-checksums files that have checksums in the manifest 2) Recopies files that do not have a checksum 3) Saves the manifest at regular intervals to preserve checksums 4) Unit tests for all cases (that I can think of)"
},
{
"commit": "56588f6fdd30378728372e1dea2a4920c043acb3",
"date": "2015-05-05 11:08:48 -0600",
"subject": "Log testing can now be enabled for certain deterministic tests. This works by comparing the generated logs against a previous copy. Currently only enabled for the backup/synthetic tests."
},
{
"commit": "1d1c7e47d149fc9b3b9b0c1db6238e998d56c804",
"date": "2015-05-01 19:13:12 -0400",
"subject": "Doc fixes for archive-max-mb setting."
},
{
"commit": "b0db7c04979d4f012bfd66067a25088bd84687ad",
"date": "2015-04-29 17:43:28 -0400",
"subject": "Fixed case error in Perl module name."
},
{
"commit": "174896e7971931662a7672dd0271fe0f23b846d0",
"date": "2015-04-23 20:52:41 -0400",
"subject": "Centralized wait functions."
},
{
"commit": "2dac171642b6bd876ee44c4d4c9bcb238f7df999",
"date": "2015-04-22 16:39:53 -0400",
"subject": "More modular locking - this is the first part of a series of improvements."
},
{
"commit": "87f69508e3500ff7c93a7637bfeb4643f68f2c74",
"date": "2015-04-21 10:48:01 -0400",
"subject": "Set version to 0.75"
},
{
"commit": "6987cfaa536555bcb1cb0df3e40c03802a786aa0",
"date": "2015-04-21 09:46:28 -0400",
"subject": "Merge branch 'master' into dev after release 0.61"
},
{
"commit": "a9b9ec249234b9106f7c8a7615e227d1b7783a07",
"date": "2015-04-21 09:45:03 -0400",
"subject": "v0.61: bug fix for uncompressed remote destination"
},
{
"commit": "4b51f5dc500d9ba63246b953db57deb30afb3a57",
"date": "2015-04-19 18:00:51 -0400",
"subject": "Removed unused font."
},
{
"commit": "4bc9ee9b8a39ffeab8b2bab434698106ada795c6",
"date": "2015-04-19 17:53:45 -0400",
"subject": "Merge branch 'master' into dev after release v0.60."
},
{
"commit": "5185d49873914c3207894452abfb0a504625821d",
"date": "2015-04-19 17:53:29 -0400",
"subject": "v0.60: better version support and WAL improvements"
},
{
"commit": "279bd07623be81d9197e5612ac8a85b2d57c5335",
"date": "2015-04-19 17:29:52 -0400",
"subject": "Each option is assigned a source to designate where it came from (param, config, default). operationWrite() created to easily pass parameters on to a new process."
},
{
"commit": "e20a3c991d3868afa050a20e99af7f98895c5d99",
"date": "2015-04-19 17:28:19 -0400",
"subject": "Added tests for set = latest."
},
{
"commit": "cb153f7242a8249fe34ee3f391260f6a108acde2",
"date": "2015-04-19 17:27:40 -0400",
"subject": "Docs and comment fixes."
},
{
"commit": "6646089f9a15b7500ee18082e8a01222a8eaac16",
"date": "2015-04-19 17:27:01 -0400",
"subject": "wait_remainder() now waits until .05 seconds after the second to resolve some resolution problems."
},
{
"commit": "f1cc1d6123fac516dc797ab7fce5ac1a6be62390",
"date": "2015-04-11 15:02:04 -0400",
"subject": "Refactored backup manifest update by centralizing the code."
},
{
"commit": "b8ce891603d66dddf9d71bdfabc8e6d9908f60e8",
"date": "2015-04-11 12:31:39 -0400",
"subject": "Altered rsync comparison test to use a specially crafted table that has a 70% compression ratio. Improved the output of file_size_format()."
},
{
"commit": "9fe7f87e3a2dc206b4d7464f34b5f200fa30df9f",
"date": "2015-04-07 19:21:48 -0400",
"subject": "Allow any boolean option that is not command-line only to be negated."
},
{
"commit": "43d86e64a4ce73d69c4d9c73f32ef5cff23d5344",
"date": "2015-04-07 18:36:59 -0400",
"subject": "First pass at tests comparing rsync to backrest. Decent results, but room for improvement.",
"body": "All tests local over SSH with rsync default compression, 4 threads and default compression on backrest. Backrest default is gzip = 6, assuming rsync is the same.\n\nOn a 1GB DB:\n\nrsync time = 32.82\nbackrest time = 19.48\n\nbackrest is 171% faster.\n\nOn a 5GB DB:\n\nrsync time = 171.16\nbackrest time = 86.97\n\nbackrest is 196% faster."
},
{
"commit": "7081c8b86701c88abfee03b01382364f79a7cae9",
"date": "2015-04-07 07:34:37 -0400",
"subject": "New model where threads are created early and destroyed late. Backups now work like restores in terms of how jobs are queued. Split out BackupFile and RestoreFile for easier multi-threading/processing."
},
{
"commit": "808c7863b64ba56f3fe588f31ef86139a133896c",
"date": "2015-04-03 09:56:03 -0400",
"subject": "Duplicate WAL issue in 9.3 was fixed in 9.3.6."
},
{
"commit": "3f651a8ce8d489a680e08467b9baccd7edef188b",
"date": "2015-04-02 22:07:23 -0400",
"subject": "Unit tests will now work across all installed versions of Postgres. Created a function to list all supported versions. Now used for all version checking."
},
{
"commit": "0b27c749991ac58de400c81c5e0fe4d0e890f957",
"date": "2015-04-01 16:28:16 -0400",
"subject": "Increased version to 0.60 and added release notes."
},
{
"commit": "984fceea67770938d6a4030278d2226cd9e14b5a",
"date": "2015-04-01 15:58:33 -0400",
"subject": "Moved archive functions from pg_backrest.pl and Backup.pl to Archive.pm. Moved Remote code from pg_backrest.pl to Config.pm. Added version specific code to regression tests and Db.pm. archive-push checks for duplicate WAL in the archive. archive-push reads the db sys id to match up WAL to the correct archive."
},
{
"commit": "9caccc2ce242c1ee6980c50918f022992c5235fa",
"date": "2015-03-29 13:35:36 -0400",
"subject": "Doc fixes."
},
{
"commit": "92a4d648ace8d112bb80f2ebffc6441fca94d11e",
"date": "2015-03-26 17:42:45 -0400",
"subject": "Fixed issues in collision unit tests."
},
{
"commit": "16cc2110c54648d2ddabe86e6533518b80edc29c",
"date": "2015-03-25 15:17:59 -0400",
"subject": "Merge branch 'master' into dev"
},
{
"commit": "b37d59832f6c3dc2050879e7231228d497b4059c",
"date": "2015-03-25 15:15:55 -0400",
"subject": "v0.50: restore and much more"
},
{
"commit": "82fa497511850c7dfe7521b99150bfd95a090a6c",
"date": "2015-03-25 14:43:21 -0400",
"subject": "Last doc fixes."
},
{
"commit": "4a6f4e23408b3c65a5594a09c6218ceef90615ee",
"date": "2015-03-24 18:50:54 -0400",
"subject": "Getting docs in shape for the next release."
},
{
"commit": "a998119cbaff2ffbff7e469ef5e5edbfee03d132",
"date": "2015-03-24 18:50:14 -0400",
"subject": "Various option and unit test fixes."
},
{
"commit": "a3604bc5121cd4a427c90bcd72468b5b32c5d938",
"date": "2015-03-24 11:43:37 -0400",
"subject": "Changed retention section to expire."
},
{
"commit": "58d6c37f4af5bc040a15bacd90c1ab056f7bca03",
"date": "2015-03-23 17:17:43 -0400",
"subject": "Changed permission to mode in manifest."
},
{
"commit": "8a3c6388b2b7981318f2e7c626cd1b88f907218a",
"date": "2015-03-23 16:01:15 -0400",
"subject": "Removed WAL from some option names - still waffling on this naming thing."
},
{
"commit": "66c474abe21d412ef6f4f5db0fc30063a8466cc4",
"date": "2015-03-23 15:45:25 -0400",
"subject": "A few unit test fixes."
},
{
"commit": "1729fa1c51c369c57a79061186818ce4781f408c",
"date": "2015-03-17 18:31:05 -0400",
"subject": "Added unit tests for expiration."
},
{
"commit": "f4f31302f0529c510ca535e3c57e67181f637092",
"date": "2015-03-16 14:45:53 -0400",
"subject": "Broke archive-required into two options: backup-wal-check and backup-wal-store."
},
{
"commit": "258fb9c6e24445e8be390b729cae005208decdca",
"date": "2015-03-16 14:01:01 -0400",
"subject": "More work on automated docs. Merging this to go back to some feature/bug work for a while."
},
{
"commit": "882f068254242ed06bceb57e14f5f52e5ed317f8",
"date": "2015-03-12 12:15:19 -0400",
"subject": "All config options can now be provided on the command-line. Lots of name changes, but more thought needed there. Still needs cleanup."
},
{
"commit": "7675a11dedaeebaeb5f546bb6c1849f989af794a",
"date": "2015-03-08 14:05:41 -0400",
"subject": "First pass at building automated docs for markdown/html. This works pretty well, but the config sections of doc.xml still require too much maintenance. With the new Config code, it should be possible to generate those sections automatically."
},
{
"commit": "ae6bdecfaf47893346443620a0a57586cf22ebdf",
"date": "2015-03-08 13:26:09 -0400",
"subject": "Split command-line parameter processing out into a separate file. This is in preparation allowing all parameters to be specified/overridden on the command line, with pg_backrest.conf being option."
},
{
"commit": "f115e01b71b23f1fc4fc8b98c42993a31b87a3e0",
"date": "2015-03-04 22:38:27 -0500",
"subject": "More work on docs."
},
{
"commit": "8dc3ba184d661a5c865c395618d20f22e7f4ccc4",
"date": "2015-03-04 20:09:26 -0500",
"subject": "More work on docs."
},
{
"commit": "163f8982624632674c55bf5fddadf3423460a228",
"date": "2015-03-04 18:50:02 -0500",
"subject": "HTML docs look to be in a workable format."
},
{
"commit": "bfb2c05357521718ef115ca40af60ac51f11ed69",
"date": "2015-03-04 00:36:54 -0500",
"subject": "Started on new HTML docs. The markdown is not cutting it."
},
{
"commit": "942b29d5b42a9ad62c96023def0c8cf1a3fc6b19",
"date": "2015-03-03 23:15:40 -0500",
"subject": "Added unit test for recovery type=preserve."
},
{
"commit": "d19baefdb99e4853f3dec7abaae757b18e117a16",
"date": "2015-03-03 22:33:41 -0500",
"subject": "Removed db-timestamp-start and stop from manifest. Better to get these values from"
},
{
"commit": "7509b01e22352404ef89ded72b8bd413c7f0a726",
"date": "2015-03-03 21:21:07 -0500",
"subject": "Added format to manifest to identify a manifest/dir structure version."
},
{
"commit": "f5761a41c12df812ef6c3dd3f9a15654deead958",
"date": "2015-03-03 10:03:55 -0500",
"subject": "Modules cleanup."
},
{
"commit": "3d0d308a98ff95b60a4b1258344443cdef934230",
"date": "2015-03-03 00:57:20 -0500",
"subject": "Made all warnings FATAL. Fixed one bug that was exposed."
},
{
"commit": "c0ec62b131a6f3a780c659ed82a8e3403d16092b",
"date": "2015-03-02 23:42:55 -0500",
"subject": "Fixed bug in File->hash() and removed improper last statements from do loops."
},
{
"commit": "7dbb11e8b85a81305f25d840433d6b125fdf5a76",
"date": "2015-03-02 22:58:32 -0500",
"subject": "Added buffer-size param and added config validation improvements."
},
{
"commit": "8e8f2f3c77793d24ef1a4aaa7f373abdc9610ac0",
"date": "2015-03-02 20:36:12 -0500",
"subject": "New config options compress-level and compress-level-network to control compression levels."
},
{
"commit": "49112eb6d3a43446bfe7c0830a99b6eef5b0b8fa",
"date": "2015-03-02 09:46:11 -0500",
"subject": "Better compression window settings."
},
{
"commit": "d874e122aaa5382b6610089cae1b2379ee97985f",
"date": "2015-03-01 23:41:01 -0500",
"subject": "Optimized compression to disable headers/crc when the source and destination are both uncompressed. Set different compression levels based on usage."
},
{
"commit": "0df1b7c4733cd354b2e6e55e2de7e034fb3fe1c9",
"date": "2015-03-01 22:43:32 -0500",
"subject": "Changed file sizes are now detected and stored in the manifest. Remove thread file minimums - they are unrealistic for a real db and hinder unit tests."
},
{
"commit": "23102f19e57f1548aab5b9709fc7aebed3567ba5",
"date": "2015-03-01 22:23:52 -0500",
"subject": "All copy() cases generate checksums during copy. Unit tests for bAppendChecksum option for copy()."
},
{
"commit": "83658a477820eae8e20238d9fc11034724cb6699",
"date": "2015-03-01 16:43:54 -0500",
"subject": "Docs for checksum option being removed."
},
{
"commit": "76391dde90856f5cbbc4be3b506524000938a412",
"date": "2015-03-01 16:42:27 -0500",
"subject": "Archive checksums are not calculated in stream."
},
{
"commit": "393525d28030711e0aaf0226d7744673d7b01097",
"date": "2015-03-01 15:17:57 -0500",
"subject": "Full refactor of binary_xfer. Compression now uses Compress::Raw::Zlib."
},
{
"commit": "77bc4238dc1afd854049fd901eb1dce76185371f",
"date": "2015-03-01 13:41:35 -0500",
"subject": "ZLib stuff starting to look good. All references removed from File and using binary_xfer for all de/compression."
},
{
"commit": "7ede058b456cb708acdcdba93b52a6729adf9380",
"date": "2015-02-28 20:31:56 -0500",
"subject": "Backup checksums are no longer optional."
},
{
"commit": "28326d6b4c4a815882acb1d6e95a28701fd12b2b",
"date": "2015-02-28 19:07:29 -0500",
"subject": "File->copy now returns hash and size in all cases, though the local copies are not optimal. They just call hash_size()."
},
{
"commit": "260a6cb8f1c7a98ad44f1c4ba0d654c6ca49f544",
"date": "2015-02-28 15:54:49 -0500",
"subject": "Working on calculating hash and file size in binary_xfer()."
},
{
"commit": "0f94476a1f3c4af2cb6aa9bc631bc4a01e05a8ad",
"date": "2015-02-28 12:10:50 -0500",
"subject": "Changed buffer sizes."
},
{
"commit": "f6b9ab732671b75a7ebb708c8ce85b79b575d46b",
"date": "2015-02-28 10:28:25 -0500",
"subject": "Minor param fix."
},
{
"commit": "f93c6caec206071c91d814b3d490da5d357ff44f",
"date": "2015-02-28 10:23:33 -0500",
"subject": "Backup/restore copy will be run in the main process when thread-max=1. I've resisted this change because it adds complexity, but I have to accept that threads are not stable on all platforms. Or maybe any platform."
},
{
"commit": "5d10a18b257a92ce520c575a488d8921e8284f5e",
"date": "2015-02-28 10:21:36 -0500",
"subject": "Added thread-max parameter to test.pl to allow backup threads to be specified."
},
{
"commit": "d6205d95011e5efb3856f5e62d09571374070492",
"date": "2015-02-27 23:31:39 -0500",
"subject": "Looks like all unit tests pass - now for a long test run to see if that is really true. And to see if the old lockup is gone."
},
{
"commit": "25442655c84cd10d026e23f5ad66aa17e5c96ae5",
"date": "2015-02-27 18:42:28 -0500",
"subject": "Hash of compressed file is working. Something still broken in binary_xfer because some 0 length archive files are showing up. Investigating."
},
{
"commit": "53f783d3fecd725aed2b7e1a203e11e8f8c85e0b",
"date": "2015-02-27 16:36:40 -0500",
"subject": "binary_xfer compress/decompression working without threads. All unit tests passing. Hooray."
},
{
"commit": "c18c629878705c01798e099de4f300b26129b679",
"date": "2015-02-27 14:11:59 -0500",
"subject": "Compress looks good, back to decompress."
},
{
"commit": "bd44b2c471a093e350fa5f18bb33832cf75c784b",
"date": "2015-02-27 13:48:29 -0500",
"subject": "Making binary xfer more modular."
},
{
"commit": "2506bbb21a044725309e3e8c2ba6761082114676",
"date": "2015-02-26 19:12:22 -0500",
"subject": "Working on decompression."
},
{
"commit": "64e1b1cea789b6751fc285a9861912cf09aca04b",
"date": "2015-02-26 14:16:12 -0500",
"subject": "Simple compression case is working. Still need to implement decompress, handle flags, and do checksum decompression."
},
{
"commit": "b9378d94a21f28c466a2e9fea9fa19d60987be86",
"date": "2015-02-26 09:22:05 -0500",
"subject": "Working on removing threads from instream compress/decompression."
},
{
"commit": "d2602a5c0762ca7ad1cd275587556f2a280b8098",
"date": "2015-02-03 20:33:33 -0500",
"subject": "Tracking down a lockup in the restore threads. It doesn't happen in backup - they are the same except that restore uses the ThreadGroup object. I'm beginning to think that threads and objects don't play together very nicely. Objects in threads seems OK, but threads in objects, not so much."
},
{
"commit": "7bee43372d41df531d6c571140dbb8eed805adf2",
"date": "2015-02-02 21:10:44 -0500",
"subject": "Increase timeout."
},
{
"commit": "d4aae88becf6e82df8f5e3eb71c24a17098bed88",
"date": "2015-02-02 20:11:32 -0500",
"subject": "Try non-blocking dequeue in backup."
},
{
"commit": "850c978240329d536f641e6832871e738526e435",
"date": "2015-02-02 19:56:48 -0500",
"subject": "All restore compares no-start-stop for now."
},
{
"commit": "d93b246a692b29f09fcb1b8539dbaad443da1e14",
"date": "2015-02-02 19:34:34 -0500",
"subject": "Empty restore queues in a non-blocking way."
},
{
"commit": "7f38461c6814e0e092ee83a3222112aa21c85456",
"date": "2015-02-02 18:48:33 -0500",
"subject": "Remove ThreadQueue->end(). Not supported on all platforms."
},
{
"commit": "bde8943517ad260d87414ba6f8aa03c3e799e790",
"date": "2015-02-02 18:33:11 -0500",
"subject": "Fixes to restore compare unit tests."
},
{
"commit": "8abcf6caf109479e069f2ec36bf37d7007261c22",
"date": "2015-02-02 08:28:37 -0500",
"subject": "For no just ignore sizes in the tests since they are normal and do not indicate a bad backup."
},
{
"commit": "a6d3b7e1a960052728cc274645ebb011b741ab18",
"date": "2015-01-31 23:04:24 -0500",
"subject": "Working on checking restores against the manifest. Current issue is that the manifest does not always record the final size of the file - it may change while the file is being copied. This is fine in principal but makes testing a pain."
},
{
"commit": "018a2afacadbf9e6a848c1e0ff66f0cd9d732755",
"date": "2015-01-31 18:23:37 -0500",
"subject": "Moved bNoStartStop tablespace mapping to Manifest object."
},
{
"commit": "d7b669d5605bf75116c2d9584c745dfff9fee54c",
"date": "2015-01-31 18:15:08 -0500",
"subject": "Moved manifest build to manifest object."
},
{
"commit": "cd500484a2ddebdd43730c051835c3b5b18d83fe",
"date": "2015-01-31 17:37:55 -0500",
"subject": "Revert \"Working on doc formatting.\"",
"body": "This reverts commit a0559799fd2330e7d6c7a28f431bbdd2828eb80e."
},
{
"commit": "a0559799fd2330e7d6c7a28f431bbdd2828eb80e",
"date": "2015-01-31 17:36:25 -0500",
"subject": "Working on doc formatting."
},
{
"commit": "682d419d082f96628811909a969101d61b5a2c4f",
"date": "2015-01-31 17:32:16 -0500",
"subject": "Fixed file list."
},
{
"commit": "1ba176285e38e85e03dab31718cfc1a742bcd574",
"date": "2015-01-31 17:10:19 -0500",
"subject": "Work on restore/recovery docs."
},
{
"commit": "f94812932a3fc3c3a59ac2da499268c9768ba2e6",
"date": "2015-01-31 16:27:32 -0500",
"subject": "Working on operations docs."
},
{
"commit": "267efbd71d56af8b2dc68dc5d21c710b69e16bbb",
"date": "2015-01-31 15:37:59 -0500",
"subject": "Fixed restore::thread-max"
},
{
"commit": "0c9da6a5ab8cdfe8283cebfbb7ea8fb751857e1d",
"date": "2015-01-31 15:06:53 -0500",
"subject": "Removed version file - redundant to the version in backup.manifest."
},
{
"commit": "e524c4dd1a9e1fe0ae4a46f90eb12ae7a50bb333",
"date": "2015-01-31 13:48:09 -0500",
"subject": "Timeline unit tests are working. Options from config file are being written to recovery.conf. Fixed issue with .history files not being picked up by archive-xfer."
},
{
"commit": "cd9df8b4f87cb2042c1b2ddfbba1a1fe76a1fdee",
"date": "2015-01-31 09:05:05 -0500",
"subject": "Renamed uninit to cleanup."
},
{
"commit": "11c257296a7632ae760b1ddae66beec2f9e114ca",
"date": "2015-01-30 20:16:21 -0500",
"subject": "In the end it was a single non-undefed reference holding up the show. The Backup file should be split into Archive, Backup, Expire, and made into objects. That would cut down on this kind of nastiness."
},
{
"commit": "50e015a8385e347e2ba75fb84f9ab7c5fef7fa70",
"date": "2015-01-30 18:58:49 -0500",
"subject": "Revert \"Abortive attempt at cleaning up some thread issues - I realized the issue is in mixing threads and objects too liberally. Trying another approach but want to keep this code for historical and reference purposes.\"",
"body": "This reverts commit e95631f82ac8c15cb2492bb321703797be54eff6."
},
{
"commit": "e95631f82ac8c15cb2492bb321703797be54eff6",
"date": "2015-01-30 14:55:55 -0500",
"subject": "Abortive attempt at cleaning up some thread issues - I realized the issue is in mixing threads and objects too liberally. Trying another approach but want to keep this code for historical and reference purposes."
},
{
"commit": "fb934ecce9c204a5ed1d444b8c3876c8393af440",
"date": "2015-01-30 14:54:08 -0500",
"subject": "Allow immediate stops when discarding data at end of unit test. Makes the shutdowns faster."
},
{
"commit": "19e455afc1c152f212d0de771bb373a03ab5a8a1",
"date": "2015-01-28 16:25:38 -0500",
"subject": "Some fixes in unit tests - more needed."
},
{
"commit": "499d6c84220d9b9e916686aeef2c605aa6995b0b",
"date": "2015-01-28 13:14:46 -0500",
"subject": "Added tests for all --delta --force combinations. Added error check for postmaster running. Added error check for path not empty."
},
{
"commit": "16dd2717942eb52004e4cee3510fc524d8042fc9",
"date": "2015-01-28 11:12:21 -0500",
"subject": "Added an incremental backup to vary the unit tests."
},
{
"commit": "139b1cf87242995e41a68dbcb35a10c72da9d592",
"date": "2015-01-28 10:29:29 -0500",
"subject": "Fixed small race condition in cleanup - the archiver was recreating paths after they had been deleted. Put in a loop to make sure it gets done."
},
{
"commit": "60550cd45b802b9d1859d9bdd22f5211b9908944",
"date": "2015-01-28 00:28:21 -0500",
"subject": "Archive async now works local, but there is a pending bug to make sure archive::path != backup::path. Added code to be sure that restore will not try to log into the backup path unless it is local."
},
{
"commit": "b98b2df9f83c70516de37d574d36dcf6194b8f1d",
"date": "2015-01-28 00:26:20 -0500",
"subject": "Fixed wait_for_file() so that it will not error if the path does not yet exist."
},
{
"commit": "a59bd8c3281237f35da0ad4b7af33953cf53a26b",
"date": "2015-01-27 22:59:59 -0500",
"subject": "Restores except for type=none are mostly working. There are some failing unit tests to fix."
},
{
"commit": "13544d51bf9be1128486b167a3ecb5dc3fb6a09c",
"date": "2015-01-27 11:44:23 -0500",
"subject": "Recovery is working for none and default, but unit tests are not complete."
},
{
"commit": "f59aae101df6cb877f644a47e461e5e35440b21d",
"date": "2015-01-26 14:59:58 -0500",
"subject": "Ready to start writing recovery unit tests."
},
{
"commit": "ac22c314a90143f1a23f782b88d3f60e14dc6b32",
"date": "2015-01-26 11:01:24 -0500",
"subject": "Working on plumbing for recovery options."
},
{
"commit": "eeffd62a12d7afa70794dfefcdbfdc08a4083760",
"date": "2015-01-25 17:27:46 -0500",
"subject": "Working on recovery options."
},
{
"commit": "6db49e10831cafa4088b300b2884139bfd0662d0",
"date": "2015-01-25 12:20:12 -0500",
"subject": "Cleaned up some time functions."
},
{
"commit": "9069c34e3412889848da22abd5f4697ef8151010",
"date": "2015-01-24 11:05:26 -0500",
"subject": "Added more tablespace changes to backup unit tests."
},
{
"commit": "e1c5f7f8edf23d561ba7e730eb718cb2166e32e4",
"date": "2015-01-23 18:28:39 -0500",
"subject": "Now able to check for specific errors in unit tests - as long as they are raised with an error code."
},
{
"commit": "c6dad127486b569d683ae9cdff4f10693a3b4453",
"date": "2015-01-23 14:12:53 -0500",
"subject": "Using usleep for more resolution,"
},
{
"commit": "d3763908e741d9d675d9967e2531dfd195ca03ba",
"date": "2015-01-22 21:20:49 -0500",
"subject": "Added longer sleep to show how big an issue this can be."
},
{
"commit": "a3b3f98f66e6e36154831800434e1a7ad3dac431",
"date": "2015-01-22 20:55:16 -0500",
"subject": "Fixed some issues with remote backups after restore (unit test bugs only)."
},
{
"commit": "21c715b25c2fd484e8b4e8d53b64a9b2d59ad7d6",
"date": "2015-01-22 20:11:33 -0500",
"subject": "Restore tablespace remaps are working."
},
{
"commit": "df4b50b9778d50b1c39fa5828c18cb2e68a5c92c",
"date": "2015-01-22 19:04:55 -0500",
"subject": "Restore with base path remap working."
},
{
"commit": "82969eb4971eb78b6a992b2f48e46c1a49189737",
"date": "2015-01-22 17:43:19 -0500",
"subject": "Wrote some helper functions to make backup unit tests simpler. Fixed an issue with checksum generation in resume."
},
{
"commit": "b53cb9f64e4d665ce138d98aecc99404db0a127c",
"date": "2015-01-22 10:54:02 -0500",
"subject": "Unit tests for backup resume. Improved warning message when a backup cannot be resumed."
},
{
"commit": "fc2838d60fea12347de7be0c239ed72a80446774",
"date": "2015-01-21 18:37:49 -0500",
"subject": "All references to old-style manifest eliminated (hopefully)."
},
{
"commit": "ade9ad78b4523b51051c536ca3814e5f1acf8521",
"date": "2015-01-21 13:57:58 -0500",
"subject": "Allow file keys to be validated on remove."
},
{
"commit": "ba7a939798d2499d40e5c1fd8ece9b6b6141777b",
"date": "2015-01-21 10:44:08 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "a938813c017095dbba6160b433cc164bdea04fac",
"date": "2015-01-20 19:04:45 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "c33bc1e899af1ef6ec23ec9bd73bdcc257636428",
"date": "2015-01-20 18:00:03 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "26c568b7bcd58934a44f93a55a8ef28e5259ef17",
"date": "2015-01-20 16:20:27 -0500",
"subject": "Manifest checksum failure shows expected value to allow manual fix - though not recommended."
},
{
"commit": "92c9ed8963b9f73c104d684fd73ad376b751323b",
"date": "2015-01-20 16:05:15 -0500",
"subject": "Added checksum to manifest to detect corruption."
},
{
"commit": "44fad1f4a442cf18cf712c70f2eb4018f3f66a02",
"date": "2015-01-20 14:42:22 -0500",
"subject": "Improvements to manifest save."
},
{
"commit": "8a7ee1bb1f69928d37c8803cdd018197b68567be",
"date": "2015-01-20 14:13:35 -0500",
"subject": "Integration of new Manifest object."
},
{
"commit": "15a45f31f4632250620aa955cddb3e4f46427eec",
"date": "2015-01-20 12:17:39 -0500",
"subject": "Added feature list."
},
{
"commit": "e20f93ef1bca2fcac214b8ce6a732053c55f201c",
"date": "2015-01-12 09:05:26 -0500",
"subject": "Cleaned up test usage."
},
{
"commit": "84abcd7d61ce46eead29f790d6b528f3105f499b",
"date": "2015-01-11 11:53:03 -0500",
"subject": "Minor fixes."
},
{
"commit": "34116d3816ac0425bb0e787be266abade3e501c0",
"date": "2015-01-11 11:52:16 -0500",
"subject": "Added usage to test.pl and automatic search for psql-bin."
},
{
"commit": "425e9485aaf171864e4e0ad7a327f9a60378a33d",
"date": "2015-01-08 16:36:45 -0500",
"subject": "Re-added File-hash() - accidentally deleted it when working on owner()."
},
{
"commit": "131d91090614382780d16daec1815b53ebda97f2",
"date": "2015-01-08 15:43:43 -0500",
"subject": "New structure for --delta and --force params."
},
{
"commit": "2e09df2cec296b3b639ae14238c56e48836b1ff0",
"date": "2015-01-08 12:04:56 -0500",
"subject": "More work on new manifest object."
},
{
"commit": "0085e88966a48f1e5667f1e7618474c03578b04d",
"date": "2015-01-07 12:58:21 -0500",
"subject": "Added File-owner()"
},
{
"commit": "4f5ad8496d8d31b27a1da60de064716ce073062e",
"date": "2015-01-07 10:59:43 -0500",
"subject": "Integrating new manifest object."
},
{
"commit": "d6d57e654e48101fdbd2ef06316f71b395dbdfd1",
"date": "2015-01-06 13:08:56 -0500",
"subject": "Fixed the way wait was done after the manifest is created. Previously, waits were done for base and each tablespace which is not very efficient. Now one wait is done after the entire manifest is built. Also storing the exact time that copy began."
},
{
"commit": "43098086afd9cbf4e487a18fd2c2d6c486e4e224",
"date": "2015-01-03 16:49:26 -0500",
"subject": "Implemented timestamp last modified to record the time of the last modified file in the backup. Also added timestamp-db-start and timestamp-db-stop to for more info. timestamp-db-start can be used for PITR."
},
{
"commit": "91b06bef475d6ad17036c27337be59db35460f0d",
"date": "2015-01-03 14:22:59 -0500",
"subject": "File->manifest detects files that are modified in the future."
},
{
"commit": "2449d7384cd725587d8ee1ddff884581105fe796",
"date": "2015-01-03 12:56:44 -0500",
"subject": "Wrote a new test to check rsync collisions."
},
{
"commit": "2e080eedb85f7394d40fb14ec6c92b0a3e11aba5",
"date": "2015-01-02 14:18:07 -0500",
"subject": "Added an optional delay after manifest build so that files are not copied in the same second that the manifest is built. This can result in (admittedly unlikely) race conditions that can produce an invalid backup. I was also able to reduce the sleep types when waiting for thread termination - so unit test times are improved by almost 100%."
},
{
"commit": "297b22cb2bde9dddf99f557a40f8a6fb6e0807c8",
"date": "2015-01-02 14:15:15 -0500",
"subject": "Added INFO level logging when paths/files/links are removed during the clean phase of restore deltas."
},
{
"commit": "32b37335a14dd1f7ed98200df3869b0443afb2d8",
"date": "2014-12-31 19:03:03 -0500",
"subject": "Trying to find realistic conditions where a file can be changed without the timestamp changing between backups. So far, this is the only case I can make work - it looks like adding a 1 second pause after creation of the manifest would cover this case."
},
{
"commit": "59e901684d0119ec6547356386190bec90837c72",
"date": "2014-12-31 14:59:33 -0500",
"subject": "Working on improved backup/restore unit tests."
},
{
"commit": "fb948de55946fee59f9503df4c377ef19c82a1f8",
"date": "2014-12-31 12:28:16 -0500",
"subject": "Fixed some minor issues in ownership code found by unit tests."
},
{
"commit": "7e083e8749d5c767040e451d908bb2d9d9f419e1",
"date": "2014-12-31 11:20:46 -0500",
"subject": "Restore as root is now working."
},
{
"commit": "0805055d4b96de49f4ee0e7514f3fde31d95f98e",
"date": "2014-12-30 15:41:43 -0500",
"subject": "More work on restore ownership code."
},
{
"commit": "46ba3a18dfb2a0fa5c034571e46edd4297b6272f",
"date": "2014-12-30 11:59:57 -0500",
"subject": "Ownership code runs through - may not work for all cases."
},
{
"commit": "9f8f33f957ee7d1db68c48c84ebef2cb43c85cce",
"date": "2014-12-23 18:52:38 -0500",
"subject": "Working on restore options and integration with unit tests."
},
{
"commit": "a96b83beb84d1c82b24c8d79e08c674757a4bf25",
"date": "2014-12-23 15:03:06 -0500",
"subject": "Restore can now remap base/tablespace locations. Made Restore more modular."
},
{
"commit": "653ab486af8897f1058bf0e846aa739f14a4a33f",
"date": "2014-12-23 12:48:25 -0500",
"subject": "All restore module variables are now object local."
},
{
"commit": "51544edc70319b38e000003d50af16eb333c191a",
"date": "2014-12-23 11:48:51 -0500",
"subject": "Some cleanup in restore."
},
{
"commit": "2db71e91adf078eda5d687155e8e8beaf98996f3",
"date": "2014-12-22 11:24:32 -0500",
"subject": "Basic restore functionality is working."
},
{
"commit": "9086728b73e4c5f2063d9ed3e39a66ed9eade216",
"date": "2014-12-21 10:11:17 -0500",
"subject": "Restore removes paths/files/links and recreated paths/links."
},
{
"commit": "1557327d2bb2f3aedb2e3363d89569de02acca82",
"date": "2014-12-19 17:49:56 +0000",
"subject": "Restore cleans out missing files and some basic unit tests."
},
{
"commit": "161a73159e9723ada085423ead853ba4d68da0af",
"date": "2014-12-18 22:05:06 +0000",
"subject": "Added some constants."
},
{
"commit": "b9d9c7fa66e681266ad213ec4b31691bec313d14",
"date": "2014-12-18 16:47:03 +0000",
"subject": "Incremented version to .50 since restore functionality if going in."
},
{
"commit": "1dc00c9d4b14af15febebde963cc70a44f357ec8",
"date": "2014-12-18 16:42:54 +0000",
"subject": "Starting on restore functionality, finally."
},
{
"commit": "1a3c5cd9dbd832bb8a6a01a897c2368b21d5418c",
"date": "2014-12-18 16:14:30 +0000",
"subject": "Added latest link so it is easy to get to the last backup."
},
{
"commit": "7d19504d3a84867cf910ce03b554f7f5ef0d49b6",
"date": "2014-12-18 14:58:07 +0000",
"subject": "Removed some tests in full that were redundant with the tests in backup."
},
{
"commit": "93c7ef3c9ea429c64f035bec1acb6f41a18a3397",
"date": "2014-12-18 14:56:01 +0000",
"subject": "Moved some code into a more logical order."
},
{
"commit": "c76a8d64d0abca36fc217c94d22542190e1045ee",
"date": "2014-12-16 17:41:54 +0000",
"subject": "Moved more config logic to Config.pm"
},
{
"commit": "61245583472b1a621e69ffbdddedd5bd68d9133a",
"date": "2014-12-15 22:20:42 +0000",
"subject": "Moved config functions to a new file."
},
{
"commit": "6dd9e881dc06862d7361a2a1db0d91cf93296e61",
"date": "2014-11-27 14:07:09 +0000",
"subject": "Added reminder."
},
{
"commit": "602db70d6a9100d80ec421f66d4e76812cd81b85",
"date": "2014-10-20 11:44:36 -0400",
"subject": "More backup unit tests."
},
{
"commit": "9765b4e20b0d1e3878806387ccf0f0cda124abbe",
"date": "2014-10-19 17:41:11 -0400",
"subject": "Backup unit test - more work on tablespaces and references."
},
{
"commit": "66a5da6fd1757afc1647a051464417497e49e18f",
"date": "2014-10-19 16:30:16 -0400",
"subject": "More work on backup unit tests - added tablespace tests."
},
{
"commit": "4de1d9aa5aed934a293d2540816186656c4b58e1",
"date": "2014-10-19 11:46:01 -0400",
"subject": "Backup unit tests are working."
},
{
"commit": "1d43c633265e218fc2346786c5f9046d1bd792db",
"date": "2014-10-18 13:25:20 -0400",
"subject": "Working on better backup unit tests."
},
{
"commit": "ed5777101f4402c940f551b9e0321dec98d1e260",
"date": "2014-10-16 13:22:34 -0400",
"subject": "Changes in how paths are removed."
},
{
"commit": "b6e0bb2ae550a0ea83f2b1139b771add43d1eb6f",
"date": "2014-10-16 08:58:11 -0400",
"subject": "Small unit test changes."
},
{
"commit": "5c216c93d5f62a0c395d2830dcc840c84256f4a8",
"date": "2014-10-15 19:11:09 -0400",
"subject": "Working on backup unit tests."
},
{
"commit": "f9ff7c6ec7303ae938df9542af98b45b29e779f2",
"date": "2014-10-14 23:58:17 -0400",
"subject": "Comments."
},
{
"commit": "0ba838cd3e06c2464db399eed6b08216b65138ab",
"date": "2014-10-14 21:44:42 -0400",
"subject": "Checksums seem to be working again - still waiting on the new backup unit tests to confirm."
},
{
"commit": "59a267d6387c463ff0cd469ca8ac1c00e4125d38",
"date": "2014-10-14 15:46:03 -0400",
"subject": "Fixed typos."
},
{
"commit": "b19dd9b5529fab599b536dd5819bc7050d884df7",
"date": "2014-10-14 15:44:50 -0400",
"subject": "Changes to the aborted backups code."
},
{
"commit": "3a54eaf9dec90896cedb9a3ab34219c02babcae9",
"date": "2014-10-14 08:27:50 -0400",
"subject": "Last backup type is now checked - still need a unit test for it."
},
{
"commit": "c8aeadce8eb7f1b9f9bb76b4fc291a920118cb8c",
"date": "2014-10-11 00:16:34 -0400",
"subject": "Comments."
},
{
"commit": "aafc0fef6918938a4f32551220afac4340d72c32",
"date": "2014-10-10 16:03:33 -0400",
"subject": "Removed Moose from the Db object."
},
{
"commit": "2c173ba53e5dafd5fd090d31c05227250b403ff8",
"date": "2014-10-10 15:13:28 -0400",
"subject": "Removed moose from File object."
},
{
"commit": "c1d6890c604c1d9f4e6c940f0ff6e0f552e40e19",
"date": "2014-10-09 16:01:06 -0400",
"subject": "More Moose removal."
},
{
"commit": "3d86adadb5a7d3cba91e6839721681d3b1237f37",
"date": "2014-10-08 13:54:31 -0400",
"subject": "Remote object now using ProcessAsync for de/compression. Removed dependency on Moose from Remote."
},
{
"commit": "16ebbd2279e25e46b91b65b2684f4e3a7fce9525",
"date": "2014-10-06 20:53:34 -0400",
"subject": "Documentation fixes."
},
{
"commit": "74cae73ee0ddee2d16bd5d7e923f23538cd94bc7",
"date": "2014-10-05 20:21:15 -0400",
"subject": "Moved version number to v0.31."
},
{
"commit": "4bc4d97f2bfc8702937fe931b5b8d956a73d42f6",
"date": "2014-10-05 19:49:30 -0400",
"subject": "v0.30: core restructuring and unit tests"
},
{
"commit": "de35cedc277615bfb777f8a522d35a0d807de9dd",
"date": "2014-10-05 18:52:05 -0400",
"subject": "Working on getting async process thread into Remote.pl"
},
{
"commit": "122dc65351f9553f06d374c6c7b29e6357261dc4",
"date": "2014-10-03 09:31:23 -0400",
"subject": "Added compress and checksum settings to backup manifest."
},
{
"commit": "fbc2ae132541eafe92e27cd6d6be0d003bf4e16d",
"date": "2014-10-02 14:34:58 -0400",
"subject": "Fixed function names in comments."
},
{
"commit": "4cbc6c650a6c1fe3924e91e3fb5b53181a9dfcd9",
"date": "2014-10-02 13:54:26 -0400",
"subject": "File->hash now works on compressed files."
},
{
"commit": "991afe3b161e06d940be7acb70a2f8596a495eb2",
"date": "2014-10-02 10:55:38 -0400",
"subject": "Merge from dev-0.30."
},
{
"commit": "168398e58a374f062a156088fc4e3571d5772f98",
"date": "2014-09-30 15:51:08 -0400",
"subject": "Merge from dev-0.30."
},
{
"commit": "5151b103e8eb985b9cbb91a90a580db122b4afe8",
"date": "2014-09-29 23:10:53 -0400",
"subject": "Formatting."
},
{
"commit": "5f30ae3c463ba28759dd5e87a339599f3e95fabd",
"date": "2014-09-29 19:51:51 -0400",
"subject": "Merge branch 'dev-0.30' of https://github.com/dwsteele/pg_backrest into dev"
},
{
"commit": "aab5ec2943919c7990d0da202275bd978ce384c1",
"date": "2014-09-29 19:39:28 -0400",
"subject": "Converting _ to -. Last one I hope."
},
{
"commit": "bdbdaf39d35e8bfcc88976179716843571890c23",
"date": "2014-09-29 19:08:08 -0400",
"subject": "Work in progress - new hash method."
},
{
"commit": "82b0bc0e72c6a47efb7891098ffa854ca2c69621",
"date": "2014-09-29 22:51:02 +0000",
"subject": "Fixed relative path issue in archive-get."
},
{
"commit": "7ed6587c42c4594dc4bd9939e12386cb1f4e73ad",
"date": "2014-09-19 17:51:51 -0400",
"subject": "ISSUE-11: Added --no-start-stop and --force options."
},
{
"commit": "07801a9a3c9573d44a664c109d4e48affe5406a2",
"date": "2014-09-19 11:22:26 -0400",
"subject": "Changed timestamp keys to be more consistent."
},
{
"commit": "121cb8a811710ab739f680e2b97d0f03c6075024",
"date": "2014-09-19 10:47:22 -0400",
"subject": "Title fix."
},
{
"commit": "7b1039dbe284beb436557a7db2c7da20967c3ad7",
"date": "2014-09-18 17:39:24 -0400",
"subject": "Fixed error message."
},
{
"commit": "535f32c8275c780b64e04dc30da2d4ec4333b744",
"date": "2014-09-18 17:24:40 -0400",
"subject": "Removed old unit tests."
},
{
"commit": "6ac124493d1cd0aacbb0d342745c43f240f1eddd",
"date": "2014-09-18 16:42:13 -0400",
"subject": "Added prior backup label to backup.manifest"
},
{
"commit": "82f22dd9fedbb01cbad24697b605a16a25d5f541",
"date": "2014-09-18 16:41:36 -0400",
"subject": "Documentation for config functions."
},
{
"commit": "fd12299ecd1b39246ede3a2100419cc624c64bbc",
"date": "2014-09-18 15:18:52 -0400",
"subject": "Some fixes in test logging."
},
{
"commit": "77802d3689b7e8f2c161165c50cdff12f0ce6ae6",
"date": "2014-09-18 13:13:04 -0400",
"subject": "Fixed some language."
},
{
"commit": "97c12f4eda0847025c78e98bab91bde92dfd3b93",
"date": "2014-09-18 12:57:50 -0400",
"subject": "Update backrest project description."
},
{
"commit": "a5f09caff7b4017a09e4f80888c211d5d3d7c713",
"date": "2014-09-18 12:37:14 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "3ab81752c00f69c6981bb53d06df60ebc0083666",
"date": "2014-09-18 11:50:27 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "d3238daf7ec8926635306c2b8d3294b37405c557",
"date": "2014-09-18 11:28:23 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "06ad947102fb54fbe4a48f5b1f77353610c9c716",
"date": "2014-09-16 11:22:55 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "65f89bd643f2b14338d80fef1644c1fd4a9ada8f",
"date": "2014-09-16 08:55:40 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "4d8c97eb55edd3a6472942cf924cf5965e6b69ef",
"date": "2014-09-16 08:21:29 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "48b0e0d4612d3f9156f7d4fccce2fdd3c13c3ac5",
"date": "2014-09-16 08:15:49 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "411e870c7a04551614132b3a4f461e88d74ef9b8",
"date": "2014-09-15 22:04:26 -0400",
"subject": "Notes."
},
{
"commit": "1125397aae9fc4c59b516b133d5c82337041e070",
"date": "2014-09-15 19:00:40 -0400",
"subject": "Updated readme."
},
{
"commit": "f86674da02a7f15f98cf1f64c331277e7fa7f3d3",
"date": "2014-09-15 18:26:03 -0400",
"subject": "Documentation."
},
{
"commit": "8c9aa3ab7c511c317b32896aaa2958a198e67927",
"date": "2014-09-15 18:18:40 -0400",
"subject": "Documentation."
},
{
"commit": "c5192e0fa5ea46e01d9ec0cf39bb1364c10aeed1",
"date": "2014-09-15 18:12:30 -0400",
"subject": "More docs, changed hardline default to Y."
},
{
"commit": "b9b038b328526fb0ea24b2fe879be23d63708e6e",
"date": "2014-09-14 20:06:45 -0400",
"subject": "Added docs and fixed spaces."
},
{
"commit": "ab7323711f83d833d391751f0f8a5205282f6214",
"date": "2014-09-14 17:07:44 -0400",
"subject": "Fixed issue in archive extension."
},
{
"commit": "cfe8851174e861ae707989874bbe2de3ae50de38",
"date": "2014-09-14 16:48:33 -0400",
"subject": "A few more fixes for differential."
},
{
"commit": "c0d81f0d10986e1308b3d90d082d2c65b07bd53a",
"date": "2014-09-14 16:30:53 -0400",
"subject": "Fixed issues in differential expiration."
},
{
"commit": "9555775d72800cf69f7859651548298e3c22d350",
"date": "2014-09-14 15:55:27 -0400",
"subject": "Retention defaults, single-quotes."
},
{
"commit": "6315d326ea7bb184eea63598cc80b6cda42a6f84",
"date": "2014-09-14 15:31:56 -0400",
"subject": "Fixed a few issues in manifest."
},
{
"commit": "23870f60f5038302c8e47aee7d231f4fb89d64ec",
"date": "2014-09-14 13:17:07 -0400",
"subject": "Small change to fix branch."
},
{
"commit": "4903a818f3e63494f80525be151911d5f3358b0b",
"date": "2014-09-14 13:15:21 -0400",
"subject": "Merge branch 'dev' of https://github.com/dwsteele/pg_backrest into dev"
},
{
"commit": "4551a2d089c448c1e4a61606d63e1510a3fa3b91",
"date": "2014-09-14 13:12:37 -0400",
"subject": "Docs and unit test fix."
},
{
"commit": "d83820d962c7ea1c28788129487b2c210e12b374",
"date": "2014-09-14 12:50:21 -0400",
"subject": "More documentation."
},
{
"commit": "d7faf578f3e4d5d1e694e704e874b71003a357c7",
"date": "2014-09-14 11:46:22 -0400",
"subject": "Test configuration formatting."
},
{
"commit": "b0b6c6a91658993a1186a8e005bd78cb307cd92f",
"date": "2014-09-14 11:40:17 -0400",
"subject": "More doc tests."
},
{
"commit": "2dc90edb07f22c30ff89d05cb469866f4a300b4c",
"date": "2014-09-14 11:38:49 -0400",
"subject": "More work on docs."
},
{
"commit": "8964ba4502591cd77f65de79607eb8e98c35a2fa",
"date": "2014-09-13 14:18:59 -0400",
"subject": "Testing formatting."
},
{
"commit": "e47ec0ab2b370cc531961efed4e91d253abe7e08",
"date": "2014-09-13 14:13:50 -0400",
"subject": "Working on documentation formatting."
},
{
"commit": "e7ccced3b4a97433fb7c0061462ae80dc10278a5",
"date": "2014-09-13 14:04:54 -0400",
"subject": "More work on documentation."
},
{
"commit": "934159eef0a508913f4b36de71bd019a87a4f3bf",
"date": "2014-09-13 11:43:39 -0400",
"subject": "More table tests."
},
{
"commit": "826f9cde2c92f780bd43b0f767612b97b777b420",
"date": "2014-09-13 11:35:58 -0400",
"subject": "Playing with tables."
},
{
"commit": "9eb2015d9fbb933dff00d1fb866f7edbc719e7f4",
"date": "2014-09-13 11:25:35 -0400",
"subject": "Working on documentation."
},
{
"commit": "fa82d5f0af3d5151a58ad44157a74a82d16428d0",
"date": "2014-08-15 10:48:50 -0400",
"subject": "Added help (issue #10)"
},
{
"commit": "679005e537bb0c2bf0a115330a8d9646a7e69c65",
"date": "2014-08-14 09:40:20 -0400",
"subject": "Some cleanup of the diff/incr code."
},
{
"commit": "3798071c5f2b9c0f8d89c83c65d962ccfbd7fd1d",
"date": "2014-08-12 20:01:36 -0400",
"subject": "Added backup.manifest change to last commit."
},
{
"commit": "e8e7c82b147e2deac127187ae758c0c47061ea5a",
"date": "2014-08-12 20:00:52 -0400",
"subject": "pg_backrest.pl returns version. Version is also stored in the backup path in the version and backup.manifest files. Merged the two date string functions."
},
{
"commit": "b48a7e6cc2b4702bf1ad26d652142fbb1c28d931",
"date": "2014-08-12 19:17:16 -0400",
"subject": "The backup label (and path name) are now created at the end of the backup instead of the beginning. This makes selecting a backup for PITR much easier."
},
{
"commit": "672c6b2ccb3b5926cd0e6bb0d78524d07bc74db6",
"date": "2014-08-12 19:04:46 -0400",
"subject": "Backup start/stop timestamp now stored in backup.manifest"
},
{
"commit": "34cb57f925e0f794e1845eae9b3f85dbdc65fe0e",
"date": "2014-08-12 18:36:38 -0400",
"subject": "Using checkpoint command instead of pg_switch_xlog."
},
{
"commit": "6b4a8fbc217bc2aa227d879753695bec860e6c3d",
"date": "2014-08-10 21:22:17 -0400",
"subject": "Unit tests now working on Ubuntu 12.04"
},
{
"commit": "0298e8dd16b3bce2c6e8d51ab231b079f148ecd8",
"date": "2014-08-10 15:02:14 -0400",
"subject": "Created unit tests for files deleted by the db during backup."
},
{
"commit": "09e2351ae8b17a8eaccba81337e16fc4d7aeb7a4",
"date": "2014-08-09 18:35:55 -0400",
"subject": "Test log mode is working."
},
{
"commit": "83d0db27d10ca966f7675239069fbdbd1c4ffc3a",
"date": "2014-07-27 18:18:59 -0400",
"subject": "Added release comment."
},
{
"commit": "2d9f027e3a8e7ded65efda2fe93780f6e624a1bf",
"date": "2014-07-27 18:13:23 -0400",
"subject": "Cleanup, work on test framework."
},
{
"commit": "a849f2d2fdf4709790246bf9d3f65c5b71cee5ee",
"date": "2014-07-27 14:26:07 -0400",
"subject": "Removed remaining decencies on Config::IniFiles"
},
{
"commit": "6f4310db426da453f498eb7eac47d6c32608993e",
"date": "2014-07-27 14:03:21 -0400",
"subject": "Changes for testing - finished changing config to local implementation."
},
{
"commit": "50dd95c005136aeb03ae5907028c696af6b173db",
"date": "2014-07-25 19:07:40 -0400",
"subject": "Sync up - hopefully."
},
{
"commit": "287e15f01facef1d7174d31d6b1f8e4f86323562",
"date": "2014-07-25 18:31:56 -0400",
"subject": "Test commit."
},
{
"commit": "6614f50cc824de153454d86c9c7c3a3d273ecf99",
"date": "2014-07-25 18:18:20 -0400",
"subject": "Test change"
},
{
"commit": "9dd3df6fd324e33411f539aa63b901cd9895205b",
"date": "2014-07-23 08:04:48 -0400",
"subject": "Added to feature backlog."
},
{
"commit": "75160a41b9690e01575df334c00f671a5f4f1d01",
"date": "2014-07-21 08:11:04 -0400",
"subject": "Added notes for some changes."
},
{
"commit": "06b5ee3f753e87d15a0c7d34488346c0d3c225f4",
"date": "2014-07-16 23:38:38 -0400",
"subject": "Working on new config load/save functions and unit tests."
},
{
"commit": "f6e01de7ced32b89a1cf0f68a2c631fcaa1b127d",
"date": "2014-07-16 20:28:47 -0400",
"subject": "Improved backup::full unit test."
},
{
"commit": "5d39b4f64660ccbd4cee64033c186d9a78f0b231",
"date": "2014-07-16 20:07:50 -0400",
"subject": "Local backups are now completely local."
},
{
"commit": "9ad1d79f0000497225366981979cb228be66e266",
"date": "2014-07-16 19:15:56 -0400",
"subject": "Unit tests for archive-get."
},
{
"commit": "9d9dae418bc03a4586bdb579d113a651927c4d1a",
"date": "2014-07-15 22:32:41 -0400",
"subject": "Added archive-put unit tests. Lots of other unit test improvements."
},
{
"commit": "8d398e4bffe30bdb1b33fb5aa4b5d5880592681c",
"date": "2014-07-13 10:37:16 -0400",
"subject": "Starting on archive unit tests."
},
{
"commit": "375545320d3278dc9a585ad136e5cc3d93e28475",
"date": "2014-07-13 09:13:19 -0400",
"subject": "Added tests for large files (16MB archive log). Fixed a sync error in binary_xfer()."
},
{
"commit": "ed4bcf3e4681a5002b50d8fc165ba7af0be4035c",
"date": "2014-07-12 19:36:12 -0400",
"subject": "Whitespace is now cleaned in test.pl"
},
{
"commit": "353cdb6b31e68d7751b44496ebbab72e26be9a92",
"date": "2014-07-12 19:03:39 -0400",
"subject": "Local archiving is working again."
},
{
"commit": "e36a785b1bd7480b0445c118c2ed926132038f75",
"date": "2014-07-12 10:26:51 -0400",
"subject": "Fixed execute function - now only displays output when there is an error."
},
{
"commit": "7f4c4e13d2031e78f276ed1fc560e97d3c1f9191",
"date": "2014-07-02 19:15:21 -0400",
"subject": "Back to Open3."
},
{
"commit": "fead7aa5f1ae741b25b0bc17458a307f7e08515e",
"date": "2014-07-02 18:58:38 -0400",
"subject": "Not loving IPC::Run, but saving my work just in case."
},
{
"commit": "d0ca69d433edf407d6b3ea47032444adb61b3209",
"date": "2014-06-30 18:35:05 -0400",
"subject": "Integrating IPC::Run - IPC::Open3 is out."
},
{
"commit": "c300c841eb3177519d16073f2312dd597348fb53",
"date": "2014-06-30 08:29:25 -0400",
"subject": "Added release notes."
},
{
"commit": "934b7dbe9b5865d505e1726c299a09597f8c1ce8",
"date": "2014-06-29 17:23:34 -0400",
"subject": "De/compression is now done in threads instead of forked processes."
},
{
"commit": "c85413ec6837a36ccf3911f07d63f9eb8648e770",
"date": "2014-06-29 10:53:39 -0400",
"subject": "Lots of improvements to unit tests. A few bug fixes."
},
{
"commit": "f9ec149ffe866c1a43b020f1a0e2dfa57b9fdc50",
"date": "2014-06-28 14:32:34 -0400",
"subject": "Working on unit tests."
},
{
"commit": "97b9560e5c03eb314282dac3984fc21b5d2a2fad",
"date": "2014-06-28 11:47:21 -0400",
"subject": "Fixed binary_xfer() issue. Now seems to work in all cases."
},
{
"commit": "9c160a03e36029c8d4eaaf81344f972820a5a2e8",
"date": "2014-06-23 19:08:36 -0400",
"subject": "Some refinements to compression."
},
{
"commit": "e1829bb2d269192fa5af4effcf74e53b293d4ea0",
"date": "2014-06-23 18:54:00 -0400",
"subject": "First fully working backup in a while."
},
{
"commit": "88bbbb4222a5de1eb572219b16e92ce92d9817e3",
"date": "2014-06-22 20:19:13 -0400",
"subject": "Fighting with a relative path issue in archive logging."
},
{
"commit": "5d01aac92e4f27da4f6459885bfd4d00e0d22da6",
"date": "2014-06-22 16:05:00 -0400",
"subject": "Working on backup - mostly working except for the last archive step."
},
{
"commit": "f91dce259f30b20608e882052c91c8466c95c20d",
"date": "2014-06-22 14:51:28 -0400",
"subject": "Working on backup unit tests."
},
{
"commit": "8fff74ccfb518dcd837d2407b6a6427dbf8fedbd",
"date": "2014-06-22 11:56:01 -0400",
"subject": "Backup unit test able to create and drop clusters."
},
{
"commit": "3c748c4b10ad200c7284c0900f8518fc8b73015f",
"date": "2014-06-22 10:54:31 -0400",
"subject": "More work on unit tests."
},
{
"commit": "0b597d8da9ddab0c29bee8de24515ccf1066f667",
"date": "2014-06-22 10:30:17 -0400",
"subject": "Working on getting backup running again."
},
{
"commit": "0dd15dd216e5084b7594dba7a23e61d65c07d73d",
"date": "2014-06-21 20:08:49 -0400",
"subject": "Cleanup."
},
{
"commit": "753fa11b5d4417952424680d723050a2c76e431c",
"date": "2014-06-21 19:16:55 -0400",
"subject": "remove() and hash() now working."
},
{
"commit": "7c161be995a0a157f6f91e3179fc6d8664f96b5e",
"date": "2014-06-21 18:19:37 -0400",
"subject": "manifest() and list() are working."
},
{
"commit": "53f1d3c78e795546665ee8b51ef4a3be902955b5",
"date": "2014-06-21 15:46:26 -0400",
"subject": "path_create() working."
},
{
"commit": "7bc464a44b4145db527a97012cafc74735dbcd17",
"date": "2014-06-21 15:17:09 -0400",
"subject": "Working on BackRest::File methods."
},
{
"commit": "936b8d0db03ee00e24f81a47d24fa8f612ee7018",
"date": "2014-06-21 14:19:03 -0400",
"subject": "move() is working."
},
{
"commit": "80206a28e930b7b769494eb05ee035fac69e9c3d",
"date": "2014-06-21 12:22:25 -0400",
"subject": "Ignore missing source in copy() working."
},
{
"commit": "e1903d53d01bb707bf9ac3347710d03b24dc4851",
"date": "2014-06-21 11:05:29 -0400",
"subject": "copy() works when both files are local or both files are remote."
},
{
"commit": "4a113cae66e8ef4ac83b6089ca2f3fe4c82ff185",
"date": "2014-06-21 10:05:49 -0400",
"subject": "Better error handling for missing source file in copy()."
},
{
"commit": "3af52398006b8f2bfd689cea6d9ce94a7a87fbff",
"date": "2014-06-21 08:42:30 -0400",
"subject": "Various compression options working in copy()."
},
{
"commit": "08750f2fdafb157721aff191aacbc2f2d927f852",
"date": "2014-06-16 06:12:38 -0400",
"subject": "Still working on copy()."
},
{
"commit": "0b3b743f5a6030bedf92f736bc6cb6021f2ced48",
"date": "2014-06-15 19:18:26 -0400",
"subject": "Stupid compress issue was in the unit test - but did tighten up the code a bit."
},
{
"commit": "d162ce203d6c70bb80dc0f5224329ae76b53f3f7",
"date": "2014-06-15 18:32:43 -0400",
"subject": "Trying to get various compression options working in copy()."
},
{
"commit": "9526975ad357a25d16c37e5c337a8d4186746b53",
"date": "2014-06-15 16:53:20 -0400",
"subject": "Cleanup, comments."
},
{
"commit": "adf654edb34df2a6ae67eff691e3e469cd95a5d5",
"date": "2014-06-15 15:56:45 -0400",
"subject": "In-stream compression now working in copy."
},
{
"commit": "f51c06119c8d5f52312d41f6d4738bac3abeb0c8",
"date": "2014-06-15 09:32:11 -0400",
"subject": "copy() works through multiple runs an multiple remotes."
},
{
"commit": "d568b6525b51b33301a4edb2a7b38660975602cc",
"date": "2014-06-14 20:47:32 -0400",
"subject": "copy() works with remote in either direction."
},
{
"commit": "79f85fe6c426ad536382d28ce97bf56e91232207",
"date": "2014-06-14 19:50:54 -0400",
"subject": "Finally a working copy() with new protocol."
},
{
"commit": "3a32363a568e09f34d2ec3154ce64754a4175d0e",
"date": "2014-06-12 21:56:20 -0400",
"subject": "Working on copy."
},
{
"commit": "976bafca9e84f9efcf43dbbf27183ead85bece4c",
"date": "2014-06-07 17:29:11 -0400",
"subject": "Added new tests."
},
{
"commit": "ca6823986d2e6ab6aeebe0d8cc4389eff83a0929",
"date": "2014-06-07 16:29:03 -0400",
"subject": "Sample install file."
},
{
"commit": "58e70422acb9d8a53d348479da8cdcdaf2ffc655",
"date": "2014-06-07 16:27:30 -0400",
"subject": "Testing install.md"
},
{
"commit": "166318d00d324504f242a84a134309ff496c06e2",
"date": "2014-06-07 16:25:20 -0400",
"subject": "Moved remaining libraries and other files."
},
{
"commit": "31b05eaab3c22346ef6bdec305889f3ca70cfd78",
"date": "2014-06-07 16:13:41 -0400",
"subject": "Moved pg_backrest_utility."
},
{
"commit": "0a8a5c7ed484bae9487d6fe3eb0536c70395f787",
"date": "2014-06-07 16:06:46 -0400",
"subject": "Refactoring - added version file."
},
{
"commit": "ea1a158d828485ea45cf137ba232497ba00aaab9",
"date": "2014-06-07 15:30:13 -0400",
"subject": "Improved logging."
},
{
"commit": "e60e2b22ed4c6d26d39e5c1732871df8f9815ad1",
"date": "2014-06-07 15:01:29 -0400",
"subject": "Much improved param protocol."
},
{
"commit": "e07a6b4e3f14fd24b15497f907d3c5589ec80b93",
"date": "2014-06-07 13:15:55 -0400",
"subject": "Cleaner remote implementation."
},
{
"commit": "1bc80c50edf1461ff87eec127221569ff4b327a7",
"date": "2014-06-07 11:51:27 -0400",
"subject": "First passing test with new protocol."
},
{
"commit": "ae130229ef89c1360796bfbe593c265aae4b6494",
"date": "2014-06-06 21:16:24 -0400",
"subject": "Working on remote protocol."
},
{
"commit": "e71a986ef3e1cf43a7edd0207b7d4f97ee21cdac",
"date": "2014-06-05 23:51:27 -0400",
"subject": "More work on copy()"
},
{
"commit": "e44cd6c1ca1d789cb0b6a6ef81418d68072377d1",
"date": "2014-06-05 22:42:47 -0400",
"subject": "More paths through copy() working."
},
{
"commit": "ca6b435c4ffbfb7459298535cc06fa48f6900d36",
"date": "2014-06-05 16:40:05 -0400",
"subject": "June Hackathon: copy_in and copy_out functions written, some paths through File->copy() working, basic unit tests setup."
},
{
"commit": "c2dd53f90885a0ce8bd4399d8e2555c96b36159d",
"date": "2014-06-05 10:20:03 -0400",
"subject": "Changes to allow specific tests to be run."
},
{
"commit": "5813aedaa3894d36c4645744fa47b005a635ef08",
"date": "2014-06-05 09:59:04 -0400",
"subject": "Added recognition section to read me."
},
{
"commit": "5d09af9cc04c42271a3b5d2879f28a0d6483dfc8",
"date": "2014-06-04 13:47:17 -0400",
"subject": "Better include markdown."
},
{
"commit": "82814aebdd0c37206538b8b55229ee686f7d0f68",
"date": "2014-06-04 11:58:30 -0400",
"subject": "Whitespace cleaning."
},
{
"commit": "1793b7a5c4d70ee262c57c56faaa2d975d5b9673",
"date": "2014-06-03 22:02:56 -0400",
"subject": "Comments and formatting."
},
{
"commit": "1b9782cb9e566fcc08a8c0f23ceba8ecf44e7f15",
"date": "2014-06-03 21:22:07 -0400",
"subject": "Converted path_create(), improved unit tests."
},
{
"commit": "ffa45d07bf9d3ba6134341c1f1293560a76e57bc",
"date": "2014-06-03 19:03:03 -0400",
"subject": "New version of move()."
},
{
"commit": "816c67edfdc9b263bfed9ab7a7fa213d78990436",
"date": "2014-06-02 17:48:07 -0400",
"subject": "Converted File::compress"
},
{
"commit": "0249d3516b274b650afc04c16e56fd160f53bc71",
"date": "2014-06-02 16:26:37 -0400",
"subject": "Manifest is working (unit tests at least)."
},
{
"commit": "361c2c24bfb92d78b0a7006df6945f714a0c511f",
"date": "2014-06-01 18:39:35 -0400",
"subject": "Working on manifest."
},
{
"commit": "03383691932d7951ae036409a16d6b364483b97d",
"date": "2014-06-01 17:23:33 -0400",
"subject": "Working on more robust file functions."
},
{
"commit": "85f591f801fc7cc19044fb2190829ad1ec057d80",
"date": "2014-05-27 09:00:24 -0400",
"subject": "More unit tests for file functions."
},
{
"commit": "3e12f9230b35bc625cc653b620452090ab9b2260",
"date": "2014-05-14 15:07:37 -0400",
"subject": "Working on unit tests for file_copy. Still need to add specific error tests, timestamp, and permissions."
},
{
"commit": "db40553434035ffc4ab1f61061f429f023bde5b8",
"date": "2014-05-13 16:41:20 -0400",
"subject": "Changed version."
},
{
"commit": "1fa8dbb778bfe43bb345639f8e29c9978347c9ef",
"date": "2014-05-13 11:47:14 -0400",
"subject": "v0.19: Improved error reporting/handling"
},
{
"commit": "d234aeea64b9cf6e7ec643fdd0d53961769c768f",
"date": "2014-05-13 11:23:15 -0400",
"subject": "More work on error-handling."
},
{
"commit": "a2b28623d42d1979d91bc112a411588d8996a66b",
"date": "2014-04-28 09:13:25 -0400",
"subject": "Working on better error handling."
},
{
"commit": "53fa574d7eaf5a1574e3f87d41abd8ff5077faf9",
"date": "2014-04-13 11:58:35 -0400",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "9acbba173e65f40d6032ed47a1760ec48e383b91",
"date": "2014-04-13 09:51:51 -0400",
"subject": "v0.18: Return soft error from archive-get when file is missing"
},
{
"commit": "d8c488f73f1453295028d7b464c99869c084f862",
"date": "2014-04-11 14:15:56 -0400",
"subject": "Added the feature backlog."
},
{
"commit": "06b8eefd19dc7d75259888a281962d54fa7e121c",
"date": "2014-04-03 18:20:46 -0400",
"subject": "Fixed up README"
},
{
"commit": "7aa6c8ecaf3b15e7c4f58ce345f205b7aef2b423",
"date": "2014-04-03 18:17:40 -0400",
"subject": "v0.17: Warn when archive directories cannot be deleted"
},
{
"commit": "49536498e6d54e283f656a41d7e1dcd5fbaed487",
"date": "2014-04-03 16:52:39 -0400",
"subject": "Warning for non-empty dirs instead of error"
},
{
"commit": "194696f6742d571bdeb49e75f6d9d980c2cbf1fe",
"date": "2014-04-02 17:25:37 -0400",
"subject": "Working on unit tests."
},
{
"commit": "9a5bb36c0f5ec13a03c86f61644ac02c46fba679",
"date": "2014-04-01 21:41:34 -0400",
"subject": "Added notes."
},
{
"commit": "be1163b948200c409199302ab5c03e724c7b7331",
"date": "2014-04-01 10:49:37 -0400",
"subject": "v0.16: RequestTTY=yes for SSH sessions"
},
{
"commit": "235c75b1b00f05312a437bc53c313fd2e19a2d42",
"date": "2014-04-01 09:01:34 -0400",
"subject": "Added ;"
},
{
"commit": "7624d65edf340887559c87a806cee6e6da41db65",
"date": "2014-04-01 08:59:09 -0400",
"subject": "Added TTY code."
},
{
"commit": "2b8972936ffb52d27678d69f1fc332f712df014e",
"date": "2014-03-30 21:02:17 -0400",
"subject": "Updates to README."
},
{
"commit": "765af10c88ff08de48133629c124d472da68af1c",
"date": "2014-03-29 18:18:03 -0400",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "dafaeb0b82994172ffc8238e14a50db027c53262",
"date": "2014-03-29 18:16:08 -0400",
"subject": "v0.15: Added archive-get"
},
{
"commit": "ba2590dc8eb014152ddcb0a1b1e0c59fd8d1fb22",
"date": "2014-03-28 15:20:36 -0400",
"subject": "archive-get function is working. Added option to force checkpoint at backup start."
},
{
"commit": "8ae6c2719dfb83a8404265c5e0b72d93bfbdd36a",
"date": "2014-03-28 11:59:44 -0400",
"subject": "Better code in file_list_get()."
},
{
"commit": "23df43e781f9a0631b79b723bf4f09ecb3a07a7e",
"date": "2014-03-28 11:40:37 -0400",
"subject": "file_list_get now works locally and remotely"
},
{
"commit": "9d949b7ad6446be70316a50d84adf5c24f6f37c5",
"date": "2014-03-26 10:53:49 -0400",
"subject": "v0.11: Minor fixes"
},
{
"commit": "126b39855d6680453bbc2af8a565e776b07d4046",
"date": "2014-03-25 18:56:05 -0400",
"subject": "Working on archive-get"
},
{
"commit": "e68f836b2e719c822df6b17df68b2a825a4702c9",
"date": "2014-03-08 09:12:53 -0500",
"subject": "Documented enhancements planned for v0.15"
},
{
"commit": "bbb3b48cf8181e0a69328dbb12dcf75169f08e24",
"date": "2014-03-05 20:06:13 -0500",
"subject": "Added comments."
},
{
"commit": "587bd1f8d9fa3329d95239501399166aa147bda7",
"date": "2014-03-05 19:53:13 -0500",
"subject": "v0.10: Backup and archiving are functional"
},
{
"commit": "1617afb704bab58c0e8c8153c8f116f36d196e95",
"date": "2014-03-05 19:51:03 -0500",
"subject": "Initial commit."
},
{
"commit": "1a4f2527e32e4ecf2efac9d47a0ab46bd5da891b",
"date": "2014-03-05 19:49:05 -0500",
"subject": "Fixed version number."
},
{
"commit": "ae30ec98e9c1ce41bfcbba02adbf7a3e6add95db",
"date": "2014-03-05 19:47:05 -0500",
"subject": "First release merge from master."
},
{
"commit": "81616e19bd43ecd1ffae3401dc713149cffb18e7",
"date": "2014-03-05 19:45:01 -0500",
"subject": "v0.01: Backup and archiving are functional"
},
{
"commit": "951419178bed96227cff47d1b08a87b40610dce3",
"date": "2014-03-05 19:43:23 -0500",
"subject": "Initial commit."
},
{
"commit": "2b55b8ca5ef7eea92f24515155596a5bb46db112",
"date": "2014-03-05 19:10:23 -0500",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "1eb8e1be2d31724c2f7b01899734411e25b068b5",
"date": "2014-03-05 18:56:15 -0500",
"subject": "v0.01: Backup and archiving are functional"
},
{
"commit": "80d5332fa032f604f63e2833e1c919e8c52a460e",
"date": "2014-03-04 08:00:51 -0500",
"subject": "Squashed commit of the following: "
},
{
"commit": "f0d82151b91828fece28a57d2de24f5ccc92e0d1",
"date": "2014-03-03 16:38:01 -0500",
"subject": "Changed thread timeout from WARN to ERROR"
},
{
"commit": "571d449717fecee1eac64088bde42606fcddc4eb",
"date": "2014-02-27 19:15:00 -0500",
"subject": "Redirect find error output to /dev/null. Sometimes files are removed from the db while find is running. We only want to error if the find process errors."
},
{
"commit": "84c4cec257b25fc026f12560d6c0bc5cfb5822ec",
"date": "2014-02-27 13:00:41 -0500",
"subject": "Put redirects in common places where errors are be output but we don't want to see them."
},
{
"commit": "ae782d08845e2d9f5fd9df8ce8a05cb472da6f56",
"date": "2014-02-25 07:30:45 -0500",
"subject": "Made archiving single-threaded so it will work"
},
{
"commit": "a84478045e7e25d197368a19ac375509f80dfc9c",
"date": "2014-02-24 18:04:42 -0500",
"subject": "No attempt to kill threads - just abort"
},
{
"commit": "da41eb3883622a333e6e84056c05964bc2e4e402",
"date": "2014-02-24 17:59:42 -0500",
"subject": "Added more warnings"
},
{
"commit": "21b15b7cf6a8b48a4e9c65691eaece5306e47c22",
"date": "2014-02-24 09:33:47 -0500",
"subject": "Added thread timeout."
},
{
"commit": "5de8f275f0e9f06a45f1d2dafb540d5db244d505",
"date": "2014-02-22 11:14:01 -0500",
"subject": "Removed stderr redirects from the master ssh connection"
},
{
"commit": "0e4f0f1308e15dad9e6d6d07cf9bc92bc1aa1492",
"date": "2014-02-22 10:54:02 -0500",
"subject": "Fixed issue with archive path expiration"
},
{
"commit": "e8c7d7aca69dae3ff14cf0065815bced3f2002f1",
"date": "2014-02-22 09:05:58 -0500",
"subject": "When archive_retention_type is full, use the oldest backup if there are fewer than required"
},
{
"commit": "9270a6789206a0f2fcd5f92d5faaae5e6ac54973",
"date": "2014-02-21 16:09:34 -0500",
"subject": "Removed some more stderr redirects"
},
{
"commit": "6d975d283073e90247214961e31d49959e7765c6",
"date": "2014-02-21 08:49:27 -0500",
"subject": "No longer discarding stderr"
},
{
"commit": "0387a8ee09e5fbd66fe8d4dae055f9fea07e6039",
"date": "2014-02-21 07:34:17 -0500",
"subject": "replaced process id with thread id. Added use thread to all modules."
},
{
"commit": "ac3ce81621fab54c925eead8c53dee01c797d63e",
"date": "2014-02-21 06:42:42 -0500",
"subject": "Add process id to logging, don't generate checksum for 0 length files"
},
{
"commit": "3d8e933343d8b7fa0900d37f68cd235b923980bf",
"date": "2014-02-19 16:06:21 -0500",
"subject": "More threads"
},
{
"commit": "857e1774292da086f3ad4e9fca4ed28efea6683f",
"date": "2014-02-19 15:13:07 -0500",
"subject": "Using separate master queues"
},
{
"commit": "800cd898317d76b24e8aa7f3acdbcb39cb2de052",
"date": "2014-02-19 13:37:18 -0500",
"subject": "Thread files are no longer in an array"
},
{
"commit": "81433c0fdde660c3357526a3447cd1146a6b9f8c",
"date": "2014-02-19 13:03:52 -0500",
"subject": "Now using one control master for threading."
},
{
"commit": "b4ac9552d24a12ddf06d4df293a360cd72a1cf4d",
"date": "2014-02-18 19:29:57 -0500",
"subject": "Skipped files removed from manifest, checksums stored"
},
{
"commit": "27b820cfb4c5ac0ff5695202cdab98d471e0b95f",
"date": "2014-02-18 15:42:51 -0500",
"subject": "Backup handles files that were removed by the db"
},
{
"commit": "187fdaf49bd1d9abb1805e28afc2fab9161bc405",
"date": "2014-02-16 19:01:06 -0500",
"subject": "Better compression choices."
},
{
"commit": "5c695a6522fd0092934e60dec7634760cde0673f",
"date": "2014-02-16 18:20:55 -0500",
"subject": "Improved archive logging and put in max limit"
},
{
"commit": "13086e96266f8872ad0a07dfbac3289233742242",
"date": "2014-02-16 17:02:25 -0500",
"subject": "Renamed processes."
},
{
"commit": "eb25dbdb9dedae5ef7dd35e8e5dbff839168373d",
"date": "2014-02-16 16:58:25 -0500",
"subject": "Added stanza to command string"
},
{
"commit": "b45d9c946e74434a01e62b371f9c382dcb64210d",
"date": "2014-02-16 16:51:05 -0500",
"subject": "Improved command string"
},
{
"commit": "6d7f89fc98ad2e511e6e549943ff5c8311de89cf",
"date": "2014-02-16 01:31:24 -0500",
"subject": "change process string"
},
{
"commit": "577c5af33fe05c961273d0d62c42dbd3320b4d87",
"date": "2014-02-16 01:24:54 -0500",
"subject": "testing"
},
{
"commit": "b514058cee5801897530e6d27d1a61b0f6b7692f",
"date": "2014-02-15 16:46:13 -0500",
"subject": "Changed to perl storable - at least it works"
},
{
"commit": "392da9162084cb17eb7eff8bf1815e970df8ac3e",
"date": "2014-02-15 15:28:22 -0500",
"subject": "Remove old local archive dirs."
},
{
"commit": "0bc40d206cdbf777f56bfa2cb21472da71185872",
"date": "2014-02-15 14:33:31 -0500",
"subject": "Some fixes for config"
},
{
"commit": "0979841f1a08352ece1ade8821d69080f82b1132",
"date": "2014-02-15 14:18:15 -0500",
"subject": "Async compress, thread kill improvements"
},
{
"commit": "bd00fb7f0ceb86092c3998ac1ac923bb4f28ae2f",
"date": "2014-02-15 10:45:01 -0500",
"subject": "Still working on thread kill"
},
{
"commit": "3b2dd68aac9bc00e1b45d2a8d6dfd74da17112f7",
"date": "2014-02-15 10:31:57 -0500",
"subject": "More robust join code."
},
{
"commit": "27bf9b65720e278419c0c0a414141fb7b729c789",
"date": "2014-02-15 10:09:47 -0500",
"subject": "First SSH session is shared between objects and thread 0"
},
{
"commit": "c7aebf05c4e12dc9fbd7ba4bed838c6110e6cdd0",
"date": "2014-02-14 21:39:18 -0500",
"subject": "Handle term signals gracefully."
},
{
"commit": "d100294894e1f1a5b2d35f6807d3e3a18a8c0b7e",
"date": "2014-02-14 19:56:28 -0500",
"subject": "Ability to resume failed backups, better locking"
},
{
"commit": "308652cc657f5f015c6affde2d01a784862c96a0",
"date": "2014-02-14 09:05:14 -0500",
"subject": "Remove a lot of path creates - percent logging."
},
{
"commit": "e14d52c42a48b2c707ae585e9470c637c9966d46",
"date": "2014-02-14 08:23:25 -0500",
"subject": "Improved backup threading"
},
{
"commit": "e93a444a415244de15769f07b69741530254f882",
"date": "2014-02-13 23:37:52 -0500",
"subject": "Changes to manifest."
},
{
"commit": "5c393a0df9beb7ce8e78b3b3627bc1114aa1f94d",
"date": "2014-02-13 21:44:19 -0500",
"subject": "Increased time to wait for log files"
},
{
"commit": "dccdec2ffa5d145f0dd8efceafaef651f59d72c6",
"date": "2014-02-13 21:41:20 -0500",
"subject": "trying to make labels stick"
},
{
"commit": "ae3dcc57f01983e4eac6ca72bb482b9fa2e6e4d3",
"date": "2014-02-13 21:31:57 -0500",
"subject": "Thread errors now exit"
},
{
"commit": "6d9e7db1c69ee2f862e2941574c5c60ec8d5130f",
"date": "2014-02-13 20:54:41 -0500",
"subject": "Increased thread total."
},
{
"commit": "405d36497dc326b12dbc243a1b3bcd97ce438168",
"date": "2014-02-13 20:33:05 -0500",
"subject": "Less logging"
},
{
"commit": "a78d677b1e226cf9cda517ffeb662b63480c4099",
"date": "2014-02-13 20:29:42 -0500",
"subject": "Wait for archive files."
},
{
"commit": "d4ba078183f0edd290f136cdb13c43f9f70ffd43",
"date": "2014-02-13 18:14:15 -0500",
"subject": "Only save manifest once"
},
{
"commit": "1bec36b65b9ed5f2ca31879dc03877708ce048df",
"date": "2014-02-13 18:07:58 -0500",
"subject": "Better thread logging."
},
{
"commit": "2bafa5cf26773ba14da891c1079140c2b9ff08af",
"date": "2014-02-13 17:52:38 -0500",
"subject": "Logging tweak"
},
{
"commit": "8453681ccdb41e8ad1e3cf71c2df761bb2341768",
"date": "2014-02-13 17:50:14 -0500",
"subject": "Logging tweaks"
},
{
"commit": "4349f0caff1e9a9e1501483af8a64ec594513082",
"date": "2014-02-13 17:47:53 -0500",
"subject": "Fixes to log level and more logging"
},
{
"commit": "7d55ce865bf9bf0580c256ae25acbf776692ec3a",
"date": "2014-02-13 17:11:53 -0500",
"subject": "Work on log levels"
},
{
"commit": "133e27d813e3e70f7c322fe6705e7104909e8b3f",
"date": "2014-02-13 15:26:07 -0500",
"subject": "Archive tmp file fix."
},
{
"commit": "19f9a5193f547a874b871e7388328043da4ad274",
"date": "2014-02-13 14:54:28 -0500",
"subject": "Minor config changes."
},
{
"commit": "13a1f0cf246f24dd1fba09543b5fc19ebb065c70",
"date": "2014-02-13 13:54:43 -0500",
"subject": "Lots and lots of logging improvements"
},
{
"commit": "14b13d48404aedaf629ea647592b058db324b5c4",
"date": "2014-02-13 12:02:45 -0500",
"subject": "Async archive log backup working."
},
{
"commit": "f0df759bb97f3499e6c245fee88fceb491e4b551",
"date": "2014-02-13 00:21:25 -0500",
"subject": "Small debug fix"
},
{
"commit": "7c4d463b1da98c4f9c94693ee64c4776075e36e3",
"date": "2014-02-12 23:49:40 -0500",
"subject": "More balanced backup."
},
{
"commit": "b770c8ebece6c40190cc9d62f6798eeb32d4a105",
"date": "2014-02-12 22:33:09 -0500",
"subject": "More work on archive-pull"
},
{
"commit": "8e60a3111fd22095c6bdbbe99b51c3af87e661a0",
"date": "2014-02-12 20:28:27 -0500",
"subject": "Lots of archive-pull plumbing"
},
{
"commit": "16df430b73834c97410565bd96edeb7e7f79714d",
"date": "2014-02-12 17:34:34 -0500",
"subject": "New constants and basic fork."
},
{
"commit": "564bd65b3e8241113998558208d561c61b73fbb3",
"date": "2014-02-12 16:01:48 -0500",
"subject": "Basic plumbing for archive-pull function"
},
{
"commit": "5181282b7402ecbba88544e4cafddac1c7eb8f76",
"date": "2014-02-12 08:04:42 -0500",
"subject": "Command line parameter checks"
},
{
"commit": "729b07fed5eaa8247eaee65bd8f3e1a996bd7752",
"date": "2014-02-12 07:45:29 -0500",
"subject": "Hardlink now a conf option."
},
{
"commit": "219120ba811ad102f3c0df60119d645d919d534b",
"date": "2014-02-12 07:39:42 -0500",
"subject": "Archiving and flag changes."
},
{
"commit": "b9a2e7093ef381ce3b5e6bf2ee9ebf9cf03fa3d7",
"date": "2014-02-11 21:17:30 -0500",
"subject": "Some more file debug info"
},
{
"commit": "1a9f73b781db87e98ea1a42db2b43a29dec950f3",
"date": "2014-02-11 17:07:49 -0500",
"subject": "Added timestamp to log"
},
{
"commit": "49dbc897a635262db27de5091e8d330f92efa948",
"date": "2014-02-11 16:57:51 -0500",
"subject": "Small file allocation improvements."
},
{
"commit": "9a1de327a197af06ab647d88cd7669ff938b4daa",
"date": "2014-02-11 16:37:20 -0500",
"subject": "Turned ssh compression on"
},
{
"commit": "71812fca996ca53d205694c796694bb46dd4fbae",
"date": "2014-02-11 16:21:33 -0500",
"subject": "Thread total is defined in the conf file."
},
{
"commit": "171ca709d62a129907e241012e493162c6be2472",
"date": "2014-02-11 16:08:55 -0500",
"subject": "Better file ordering for threads."
},
{
"commit": "c58ccb588e846d7012923a927c2b955cffef3a3c",
"date": "2014-02-11 15:31:16 -0500",
"subject": "Parallel backup now working"
},
{
"commit": "a55b37efc31e6a6074ed98fe8c92ff10cfaf277b",
"date": "2014-02-07 19:34:14 -0500",
"subject": "Working on parallel backup"
},
{
"commit": "820791cf922e4c186288ee005e87a914df4d6c3e",
"date": "2014-02-06 17:31:33 -0500",
"subject": "FF log is skipped for pre-9.3 databases."
},
{
"commit": "60b2be58ac5e410719335993dabf218decc266d5",
"date": "2014-02-06 16:37:37 -0500",
"subject": "Finished db object abstraction"
},
{
"commit": "f20f3b3ee642c02b3b4295b235bc59b99a48af20",
"date": "2014-02-06 15:54:22 -0500",
"subject": "Started db object abstraction."
},
{
"commit": "9d08f2a64494c9528c30531bd95b7306484f229e",
"date": "2014-02-06 12:49:54 -0500",
"subject": "More robust config. Retention is read from config."
},
{
"commit": "a2b0d7a674a1524f53440be45d333409a3ad1a2b",
"date": "2014-02-05 22:26:10 -0500",
"subject": "Backup expiration working again. Other changes."
},
{
"commit": "27986e0c10999660078e7c74b25bc99eb3e028ce",
"date": "2014-02-05 21:39:08 -0500",
"subject": "File is now an object."
},
{
"commit": "3e7faf0e5f7d3f61856f0c7f3b50329172e69585",
"date": "2014-02-05 16:53:25 -0500",
"subject": "Some path fixes."
},
{
"commit": "7bee0f3141a301c0a1fa1bb8d092dbbd317fe296",
"date": "2014-02-05 15:56:05 -0500",
"subject": "Moved backup location."
},
{
"commit": "a15fcb8c23e11bb2ec056abe13120591cd70c515",
"date": "2014-02-05 13:10:36 -0500",
"subject": "Moved tmp path."
},
{
"commit": "7ffade2453afafb98d2d67d3612742e17075947e",
"date": "2014-02-05 11:35:09 -0500",
"subject": "Fixed file mod time and permissions"
},
{
"commit": "c86a61ca3e15acc1afc09c400aa866a958e1fd27",
"date": "2014-02-05 10:40:49 -0500",
"subject": "Relative links working for tablespaces."
},
{
"commit": "12a960f91a59fbcce53659b1ed4fbed5a1ba8fc9",
"date": "2014-02-05 08:21:27 -0500",
"subject": "File copy supports decompression"
},
{
"commit": "a81049995859666f378ee804ef15aba1d87543e2",
"date": "2014-02-04 18:48:39 -0500",
"subject": "Remote backup fully working."
},
{
"commit": "e38c482a26d270b19813c67829f0df977afa0996",
"date": "2014-02-03 20:48:02 -0500",
"subject": "Cleanup"
},
{
"commit": "946b8261cfedd62114642344614392426196ba00",
"date": "2014-02-03 20:29:03 -0500",
"subject": "Moved archive_push function"
},
{
"commit": "d5832a70c05dd40e73d6457e2b287f500454b781",
"date": "2014-02-03 20:23:04 -0500",
"subject": "Moved last backup function."
},
{
"commit": "aef6730267af465eea3ab99ecd06917f1628d176",
"date": "2014-02-03 19:57:21 -0500",
"subject": "Moved backup functions."
},
{
"commit": "316a5b559858b3aea89306efd4f0557c2f386d09",
"date": "2014-02-03 19:03:17 -0500",
"subject": "Working on remote"
},
{
"commit": "fa668d50072542890f15d9ebda77bb2ed552e3e9",
"date": "2014-02-03 14:50:23 -0500",
"subject": "Move file init code to file module"
},
{
"commit": "aef4adf1f3864de9e844d7fb7bb31afce5e887d2",
"date": "2014-02-02 19:03:05 -0500",
"subject": "Splitting main perl file"
},
{
"commit": "4c2e4f7e4924a0cd4ba9d3cae1f99f5fe115d147",
"date": "2014-02-02 12:45:59 -0500",
"subject": "Lots more work on remote functionality"
},
{
"commit": "bf8ac7abe6210b2300375ba879ade54f8dd69167",
"date": "2014-02-02 11:12:55 -0500",
"subject": "manifest_get() now works remotely"
},
{
"commit": "4556de472240b161eb3e8ac37ece2eac7f5c3278",
"date": "2014-02-02 10:40:05 -0500",
"subject": "Source and destination can now be remote."
},
{
"commit": "de972ef5d3bb73f69839a06a43dc9448ccd500cd",
"date": "2014-02-01 12:57:27 -0500",
"subject": "More work on file_copy"
},
{
"commit": "52ba8801efe419988a8900b5696944e8015a3a12",
"date": "2014-02-01 11:04:33 -0500",
"subject": "Working on remote file copy"
},
{
"commit": "2ad7a3d815da205d2b84372ad3f8279c2572a76e",
"date": "2014-01-31 00:04:08 -0500",
"subject": "Formatting."
},
{
"commit": "c5de8fa6e637a877aee003ef623b606d113070c8",
"date": "2014-01-30 23:58:26 -0500",
"subject": "Created variable for compression extension"
},
{
"commit": "151ff8ba6049b8a4b98900cbbde23bb540d71796",
"date": "2014-01-30 23:24:34 -0500",
"subject": "Removed unused strPath param from path_get()"
},
{
"commit": "52004d3c84b5886e229dcab67729eff2e1ae7291",
"date": "2014-01-30 23:16:19 -0500",
"subject": "Comments"
},
{
"commit": "447d83fcdc64c0a075772a6b6f7affb0191e2b2a",
"date": "2014-01-30 23:09:34 -0500",
"subject": "Removing more copies."
},
{
"commit": "f86618377c5b8efe7fe18683f0fb009f7391ad59",
"date": "2014-01-30 11:35:34 -0500",
"subject": "Lots of backup refactoring."
},
{
"commit": "e13a706c0a251baf9f69126653bb2eabb78064b5",
"date": "2014-01-29 15:38:57 -0500",
"subject": "More moving. Links now also get references."
},
{
"commit": "54c73b38139127e0acb9a13be6cd7a94d84851ca",
"date": "2014-01-29 15:03:57 -0500",
"subject": "Moving stuff around"
},
{
"commit": "c26b47d4c7d346dd67168333114ee8770baa6efd",
"date": "2014-01-29 12:06:30 -0500",
"subject": "Abstracting file functions."
},
{
"commit": "47c3c82540ab3acbf741b6e511b86898e40c9b5c",
"date": "2014-01-29 06:40:15 -0500",
"subject": "Fixed checksum function."
},
{
"commit": "12f6d889de8ec6363b3275ccf887b41b3336d994",
"date": "2014-01-28 17:16:07 -0500",
"subject": "More modular file copy."
},
{
"commit": "6625ea1405aef8b19b0f5e0c347cb1b7f9761747",
"date": "2014-01-23 19:39:51 -0500",
"subject": "Coded paths needed for archive logging"
},
{
"commit": "cdd1ef73069062720af4061b1955d09c3af27330",
"date": "2014-01-22 21:40:56 -0500",
"subject": "Added general path function"
},
{
"commit": "161de23c3bf7e4ce7e58f6611acbf227a675cd8f",
"date": "2014-01-22 19:03:20 -0500",
"subject": "Starting new structure"
},
{
"commit": "89b96954f6f6aa87d7ad138c7a87a8cf64558fc4",
"date": "2014-01-21 22:02:14 -0500",
"subject": "Allow any archive file start starts with 24 hex characters."
},
{
"commit": "7e73cf22cf8df6410600760390c7600eff3b5152",
"date": "2014-01-21 21:59:54 -0500",
"subject": "Changed where .backup files were copied"
},
{
"commit": "62ae46e2139e37d2a036131801c85db13148cd0d",
"date": "2014-01-21 21:12:24 -0500",
"subject": "Archive expiration working."
},
{
"commit": "a83e94ba27dd0c0958eaca145d4630ef5d7e0fbe",
"date": "2014-01-21 20:38:58 -0500",
"subject": "Fixed error in the backup regexp"
},
{
"commit": "faaaa5690f5c2f7999a692a999e3b3de67ff648f",
"date": "2014-01-20 20:09:50 -0500",
"subject": "Working on archive retention."
},
{
"commit": "df7ada85c226fb7e851fa4c3e1182e9f1a78fe47",
"date": "2014-01-18 10:14:35 -0500",
"subject": "Working on expiration"
},
{
"commit": "1e0f2485dbcf73b730fb04e6f2ef212d46df725d",
"date": "2014-01-18 00:03:32 -0500",
"subject": "Working on expiration"
},
{
"commit": "3719d54cc99d6be4b3d22fb853a2c7ff46b4b3dc",
"date": "2014-01-15 20:41:29 -0500",
"subject": "Some notes. removed dead .backup move"
},
{
"commit": "a7de734105b876654b7cbc8d9d448f2749176369",
"date": "2014-01-12 20:12:49 -0500",
"subject": "Some cleanup - fixed tablespace path regression."
},
{
"commit": "05dcbc2246ed949fec256e45c6c441b26f30673b",
"date": "2014-01-12 15:28:19 -0500",
"subject": "Working on making backups consistent"
},
{
"commit": "c1e59048808f969b2380a0607a2447d27822d25b",
"date": "2014-01-12 01:46:27 -0500",
"subject": "Fixed xlog copy - working on correctness"
},
{
"commit": "3ed83e78f2dd8a424a9adc396aa3c2eeed6cf39f",
"date": "2014-01-11 02:16:14 -0500",
"subject": "Working on archive log copy"
},
{
"commit": "387439ac8e0b01d61f896c67bd92be88acb9b063",
"date": "2014-01-10 16:01:25 -0500",
"subject": "Working on processing archive logs"
},
{
"commit": "e23820098d7a1dc83e3e8a1f88616a7aa298e388",
"date": "2014-01-10 14:02:56 -0500",
"subject": "Notices are not emitted on start and stop backup"
},
{
"commit": "8b73a26b8425a14ce233f16fa29d38fbaf428331",
"date": "2014-01-10 00:49:19 -0500",
"subject": "Some notes for things to do."
},
{
"commit": "49c1fcd3eb33873d402e486bc2b7ede8280d4fc9",
"date": "2014-01-10 00:43:26 -0500",
"subject": "Backup file is being copied to pg_xlog"
},
{
"commit": "8e966c50dd1a28e5cfabc8670c88bfbdcb9913aa",
"date": "2014-01-10 00:22:51 -0500",
"subject": "Removed commented code"
},
{
"commit": "b5f965942bc370beb7803395f79872323f7c59ba",
"date": "2014-01-10 00:21:46 -0500",
"subject": "Added optional hard-linking."
},
{
"commit": "cceac444ad357bf8babe36f906bacdc25b845841",
"date": "2014-01-09 21:55:09 -0500",
"subject": "Added comment"
},
{
"commit": "c47ec3d2609539d5437664aad4535bc2a2edad81",
"date": "2014-01-09 21:40:33 -0500",
"subject": "All backup references are now stored."
},
{
"commit": "ed5f8226a4a08ca4665bd49b3413bcaf7e4959c5",
"date": "2014-01-09 20:12:46 -0500",
"subject": "References are from oldest backup"
},
{
"commit": "bb8fb5b54f14b622af02899c95ad9e8e88d74e8b",
"date": "2014-01-09 20:00:34 -0500",
"subject": "Sparse backup dirs implemented"
},
{
"commit": "854972dde65f9560ff8177115e5b2e785e478a28",
"date": "2014-01-09 18:23:50 -0500",
"subject": "Basic deltas work."
},
{
"commit": "c89984cd59dc2ca1792d8cd99df1978719aed16e",
"date": "2014-01-09 18:02:42 -0500",
"subject": "Revert 2914a6d..e31b21f",
"body": "This rolls back to commit 2914a6dcc67b120be0ee5d808590849ebe9c3664."
},
{
"commit": "e31b21f95aa5bad69ab2a31f9fd569d1a2e01a78",
"date": "2014-01-09 18:01:34 -0500",
"subject": "Revert 52d8697..e0be213",
"body": "This rolls back to commit 52d86971183da8f8a88775f0196f44c3ab9440a1."
},
{
"commit": "e0be2132063932108069a0754d7416c2e2c58624",
"date": "2014-01-09 18:01:12 -0500",
"subject": "Revert 2914a6d..9633e17",
"body": "This rolls back to commit 2914a6dcc67b120be0ee5d808590849ebe9c3664."
},
{
"commit": "9633e17d04d00e31c80c3d12f848a5351b97963b",
"date": "2014-01-09 17:58:40 -0500",
"subject": "Revert \"Removed tmp file.\"",
"body": "This reverts commit 52d86971183da8f8a88775f0196f44c3ab9440a1."
},
{
"commit": "2914a6dcc67b120be0ee5d808590849ebe9c3664",
"date": "2014-01-09 17:58:01 -0500",
"subject": "Working on delta"
},
{
"commit": "52d86971183da8f8a88775f0196f44c3ab9440a1",
"date": "2014-01-03 21:24:13 -0500",
"subject": "Removed tmp file."
},
{
"commit": "ba5075a3e0458874f8b8dff0b4bc1f8cb07243ae",
"date": "2014-01-03 21:19:41 -0500",
"subject": "New implementation for archive logging"
},
{
"commit": "6379b723dee94d63ef55134468ff86f588c717f8",
"date": "2014-01-03 20:10:53 -0500",
"subject": "Set the backup label"
},
{
"commit": "78457a2f420428cab317e6cdb57446008ad9751c",
"date": "2014-01-03 19:59:47 -0500",
"subject": "Simplified incremental naming"
},
{
"commit": "ef846ac8db0d44339214676a88e0ee7c06d1a217",
"date": "2014-01-03 19:28:49 -0500",
"subject": "Working on backup rotation."
},
{
"commit": "e6e995ec19f8cb01311ce0f9f2772edbc009b7d2",
"date": "2013-12-18 22:08:49 -0500",
"subject": "Fixed typo in config."
},
{
"commit": "ba72eda700cdde982a360cdf99a4a5d367403cf4",
"date": "2013-12-18 21:30:51 -0500",
"subject": "Commented out dir mod time variable."
},
{
"commit": "9907c8b7b74bc2b3bef76a47567c695de680a2e3",
"date": "2013-12-17 07:47:24 -0500",
"subject": "Set file mtime."
},
{
"commit": "b1ffa9419034ef7f3b6795f64633cf3dab87d052",
"date": "2013-12-16 21:59:22 -0500",
"subject": "New storage structure, saved archive start/stop location."
},
{
"commit": "6d992855d213edae6f1f6986226c7b9d9ad55116",
"date": "2013-12-15 20:56:42 -0500",
"subject": "Cleaning up start stop backup code."
},
{
"commit": "0d3fa39117e17d1f7cf83927079da7fdaea826a9",
"date": "2013-12-15 20:04:07 -0500",
"subject": "Added start and stop backup."
},
{
"commit": "1d21f4f9fa2f659d1f8e441fae00a87d4150373a",
"date": "2013-12-15 18:18:54 -0500",
"subject": "Added diff to commands."
},
{
"commit": "31fca50eae78b777c1113957806ad8658d744235",
"date": "2013-12-15 17:18:50 -0500",
"subject": "Backup more or less works - no start/stop backup or archiving."
},
{
"commit": "21b7a3f27a373e877f2da845f6f5ac4974d3daac",
"date": "2013-12-14 15:02:47 -0500",
"subject": "Added manifest load and save."
},
{
"commit": "8b40ea7d598d3110c04f664b38060336c744290f",
"date": "2013-12-14 14:03:08 -0500",
"subject": "Tablespace names are now recorded"
},
{
"commit": "2ba26ffc262404347a46211545a5a2948a3e656c",
"date": "2013-12-14 13:14:59 -0500",
"subject": "More refactoring."
},
{
"commit": "d12773ca85fb73fedac018aecdc6ea5283ddbd2f",
"date": "2013-12-11 20:39:07 -0500",
"subject": "Added generic config command"
},
{
"commit": "4aa480b858bba7a0114c292132f7289b726258b0",
"date": "2013-12-11 20:13:39 -0500",
"subject": "Cleaned up some var names."
},
{
"commit": "299d402209fd4535f1d7aa8dcb32d6c440f61577",
"date": "2013-12-11 19:57:54 -0500",
"subject": "More cleanup"
},
{
"commit": "aa6e72bb9cf9e0523db135790c2cf3097db4c97d",
"date": "2013-12-11 19:22:41 -0500",
"subject": "Refactoring"
},
{
"commit": "0dba2ab8c7178ec592fe25a0178b5be482f6d544",
"date": "2013-12-10 20:16:43 -0500",
"subject": "Added backup command"
},
{
"commit": "0bdccd298269113aa0454506824a230923cfbb17",
"date": "2013-12-10 19:18:41 -0500",
"subject": "Reversed order of tests."
},
{
"commit": "f09505f60efbd715fd72b617036db4124c2b5054",
"date": "2013-12-10 19:11:54 -0500",
"subject": "Working on unit tests for archiving."
},
{
"commit": "39989dd01c2fd77147a1b775ae6b092f3d86c65b",
"date": "2013-12-09 17:26:47 -0500",
"subject": "Working on manifest."
},
{
"commit": "02a9a693b8881698008ba9f83cbffcc2e8be7f3f",
"date": "2013-12-06 20:24:14 -0500",
"subject": "Working on backup."
},
{
"commit": "4d42d448e95df1c7535c3b73594483462f5f893c",
"date": "2013-12-05 23:29:05 -0500",
"subject": "Working on backup."
},
{
"commit": "12518e72967ee6f54419f1acdb8f01b3cb2da26e",
"date": "2013-12-05 08:59:39 -0500",
"subject": "Working on backup."
},
{
"commit": "ae6886c8e058f3a094d7fbb7544122e3e33dc935",
"date": "2013-12-04 22:30:26 -0500",
"subject": "Started backup command."
},
{
"commit": "c9c7e340a7d89feb96d1070b45a15dd4fecfeb4d",
"date": "2013-12-04 21:37:45 -0500",
"subject": "Added config file."
},
{
"commit": "53b2aae10640d6abb287f9c163f2b6700dc7b9de",
"date": "2013-12-02 21:37:01 -0500",
"subject": "Added note."
},
{
"commit": "4a2b009c2e24c4c7c52849ad53358557658ee2a3",
"date": "2013-12-02 21:34:25 -0500",
"subject": "Removed unused include."
},
{
"commit": "1e114cdc9de43efdf43ccbd1d296c01f297a2907",
"date": "2013-12-02 21:26:32 -0500",
"subject": "Fix comments."
},
{
"commit": "9553baf540404c528b73a1608e5308b93d06d166",
"date": "2013-12-02 21:23:10 -0500",
"subject": "Basic error checking and options for archive-local command"
},
{
"commit": "c7c049902fd87c6f4c43d25b9d60d9289a1742f5",
"date": "2013-12-02 16:21:40 -0500",
"subject": "Added warnings, comments, removed dead code."
},
{
"commit": "5761832df5ce2e7655602d92f9d1a55a75a75bee",
"date": "2013-12-02 15:10:18 -0500",
"subject": "Implemented strict."
},
{
"commit": "a2c98391dfe7f360de7e97f0cb06d55dbb06af3d",
"date": "2013-12-02 14:34:37 -0500",
"subject": "Starting on configuration."
},
{
"commit": "2be8c5d9e7cef1256bb9f530d0594aec8bbf1351",
"date": "2013-11-23 20:05:04 -0500",
"subject": "Working on unit tests."
},
{
"commit": "5d0251be2f05dbb44063b874a62057040dcc0f66",
"date": "2013-11-23 19:16:09 -0500",
"subject": "Working on archive-local and beefing up unit tests."
},
{
"commit": "8b37786e5b640c7a1c270388ac1158cce45ebf72",
"date": "2013-11-22 23:24:37 -0500",
"subject": "Now connecting to db."
},
{
"commit": "8db52c115a18f690d42db975ee1bb28363b5135f",
"date": "2013-11-22 17:29:01 -0500",
"subject": "Fixed whitespace."
},
{
"commit": "d86e7eb6276bbe1df025c372690c19da8133c4bb",
"date": "2013-11-20 22:30:26 -0500",
"subject": "Added checksums."
},
{
"commit": "bc46aefe61871e27281b9b8c9ffc185c8e2846af",
"date": "2013-11-20 22:24:30 -0500",
"subject": "Fixed for OSX. Do not every use TextEditor on code!"
},
{
"commit": "e67821a23096f4788f6bef71e7d4d361b7d9858f",
"date": "2013-11-20 21:49:07 -0500",
"subject": "Working on OSX port."
},
{
"commit": "9ce37308b5a3fb81e204a37cfbe28bec968126e4",
"date": "2013-11-17 21:48:53 -0500",
"subject": "Working on archive-local command."
},
{
"commit": "548578c8c96d304fb777c9aeb233733f97145818",
"date": "2013-11-17 13:58:21 -0500",
"subject": "Working on unit test."
},
{
"commit": "d7283f20f9607f0a73931462d88866487500f087",
"date": "2013-11-11 20:10:38 -0500",
"subject": "Updated license."
},
{
"commit": "4a562eb55a691c0658b2f148703afacb38587b0d",
"date": "2013-11-11 13:08:39 -0800",
"subject": "Initial commit"
}
]
pgbackrest-release-2.24/doc/resource/html/ 0000775 0000000 0000000 00000000000 13625315071 0020547 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.24/doc/resource/html/default.css 0000664 0000000 0000000 00000021552 13625315071 0022712 0 ustar 00root root 0000000 0000000 /*******************************************************************************
Html and body
*******************************************************************************/
html
{
background-color: #f8f8f8;
font-family: Avenir, Corbel, sans-serif;
font-size: 12pt;
margin-top: 8px;
margin-left: 1%;
margin-right: 1%;
width: 98%;
}
body
{
margin: 0px auto;
padding: 0px;
width: 100%;
text-align: justify;
}
@media (min-width: 1000px)
{
body
{
width: 1000px;
}
}
/*******************************************************************************
Link default styling
*******************************************************************************/
a:link, a:visited, a:hover, a:active
{
text-decoration: underline;
color: black;
}
/*******************************************************************************
Header
*******************************************************************************/
.page-header
{
width:100%;
text-align:center;
}
.page-header-title
{
font-size: xx-large;
font-weight: bolder;
}
.page-header-subtitle
{
position: relative;
top: -.25em;
font-size: large;
font-weight: bold;
}
.page-header-logo
{
float: left;
margin-top: 0.3em;
}
.page-header-logo > img
{
width: 69px;
height: 69px;
}
/*******************************************************************************
Menu
*******************************************************************************/
/*.page-menu*/
.menu-body
{
text-align: center;
}
.menu
{
white-space: nowrap;
display: inline;
margin-left: .5em;
font-size: 13pt;
}
.menu:first-of-type
{
margin-left: 0px;
}
.menu:before
{
content: "[";
}
.menu:after
{
content: "]";
}
/*.menu-link*/
a.menu-link:link, a.menu-link:visited, a.menu-link:active
{
text-decoration: none;
}
a.menu-link:hover
{
text-decoration: underline;
}
/*******************************************************************************
Table of Contents
*******************************************************************************/
.page-toc-body
{
margin-top: .25em;
margin-bottom: 2em;
}
.section1-toc:first-of-type
{
margin-top: 0;
}
.section1-toc
{
margin-top: .5em;
}
.section1-toc-number
{
display: inline;
font-size: 14pt;
margin-right: .5em;
}
.section1-toc-title
{
display: inline;
font-size: 14pt;
}
.section2-toc
{
margin-left: 1.8em;
}
.section2-toc-number
{
display: inline;
margin-right: .5em;
}
.section2-toc-title
{
display: inline;
}
.section3-toc
{
margin-left: 2.3em;
}
.section3-toc-number
{
display: inline;
margin-right: .5em;
}
.section3-toc-title
{
display: inline;
}
/*******************************************************************************
Section
*******************************************************************************/
.section1
{
margin-top: 2.5em;
}
.section1:first-of-type
{
margin-top: 1em;
}
.section2, .section3
{
margin-top: 1em;
}
.section1-header, .section2-header, .section3-header, .page-toc-header
{
margin-top: .5em;
font-weight: 500;
}
.section1-header, .page-toc-header
{
border-radius: 3px;
background-color: #396a93;
color: #f8f8f8;
font-size: 22pt;
padding-left: .5em;
margin-bottom: .5em;
}
.section1-number, .section2-number, .section3-number
{
display: inline;
margin-right: .5em;
}
.section1-title, .section2-title, .section3-title
{
display: inline;
}
.section1-subtitle, .section2-subtitle, .section3-subtitle
{
font-weight: bold;
font-size: 16pt;
margin-top: .5em;
}
.section1-subsubtitle, .section2-subsubtitle, .section3-subsubtitle
{
font-style: italic;
font-size: 14pt;
margin-top: 0px;
}
.section1-subtitle
{
font-size: 16pt;
}
.section1-subsubtitle
{
font-size: 14pt;
}
.section2
{
margin-top: 1em;
}
.section2-header
{
border-bottom: 2px #396a93 solid;
color: #396a93;
font-size: 16pt;
}
.section2-subtitle, .section2-subtitle
{
font-size: 14pt;
}
.section2-subsubtitle, .section3-subsubtitle
{
font-size: 12pt;
}
.section3
{
margin-left: 1em;
margin-top: 1em;
}
.section3:first-of-type
{
border-top: none;
}
.section3-header
{
display: inline;
font-size: 14pt;
color: #396a93;
border-bottom: 1px #396a93 solid;
}
.section-intro
{
margin-top: .75em;
}
/*.section-body*/
/*******************************************************************************
Table Elements
*******************************************************************************/
.table
{
margin-top: .5em;
border-spacing: .5em 0;
}
.table-caption
{
text-align: left;
font-size: 12pt;
font-weight: bold;
color: #396a93;
}
.table-header-row
{
}
.table-header-left,
.table-header-center,
.table-header-right
{
white-space: nowrap;
border-bottom: 1px black solid;
}
.table-header-left
{
text-align: left;
}
.table-header-center
{
text-align: center;
}
.table-header-right
{
text-align: right;
}
.table-header-fill
{
width: 100%;
}
.table-row
{
}
.table-data-left,
.table-data-center,
.table-data-right
{
white-space: nowrap;
}
.table-data-left
{
padding-top: 0px;
text-align: left;
}
.table-data-center
{
text-align: center;
}
.table-data-right
{
text-align: right;
}
/*******************************************************************************
Config, Execute, Code Block, Release Elements
*******************************************************************************/
.section-body-text
{
margin-top: 1em;
}
.section-body-text:first-of-type
{
margin-top: .75em;
}
.execute,
.config,
.code-block
{
/*white-space: nowrap;*/
margin-left: 1em;
margin-right: 1em;
margin-top: .8em;
margin-bottom: 1em;
}
.execute-title,
.config-title
{
font-size: 11pt;
margin-bottom: .125em;
}
.execute-body,
.config-body,
.code-block
{
border-radius: 3px;
background-color: #444444;
font-family: monospace;
unicode-bidi: embed;
color: #f8f8f8;
/*color: white;*/
font-size: 10pt;
}
.execute-body-cmd,
.execute-body-output, .execute-body-output-highlight,
.config-body-title,
.code-block
{
padding-left: .5em;
padding-right: .5em;
}
/* Would rather not use pre at all, but Firefox won't copy code samples correctly without it */
pre
{
margin: 0px;
padding: 0px;
white-space: pre-wrap;
}
.execute-body-cmd:before
{
content: "$ ";
}
.execute-body-cmd:first-of-type, .execute-body-output,
.config-body-title, .config-body-output,
.code-block,
.execute-body-output-highlight, .execute-body-output-highlight-error
{
padding-top: .25em;
}
.execute-body-cmd, .execute-body-output,
.config-body-title, .config-body-output,
.code-block,
.execute-body-output-highlight, .execute-body-output-highlight-error
{
padding-bottom: .25em;
}
.execute-body-output,
.config-body-output,
.code-block
{
border-radius: 3px;
background-color: #606060;
}
.execute-body-output-highlight
{
border-radius: 3px;
background-color: #1e7b1e;
}
.execute-body-output-highlight-error
{
border-radius: 3px;
background-color: #a32929;
}
.execute-body-output, .execute-body-output-highlight, .execute-body-output-highlight-error,
.config-body-output
{
padding-left: 1.75em;
}
/*.code-block*/
/*.section-body-execute-output*/
/*******************************************************************************
Lists
*******************************************************************************/
ul.list-unordered
{
margin-top: .5em;
}
li.list-unordered
{
margin-top: .5em;
}
/*******************************************************************************
Admonition
*******************************************************************************/
.admonition
{
padding-left: 20px;
font-style: italic;
margin: 10px 0px;
}
.admonition>.note, .admonition>.warning, .admonition>.caution, .admonition>.important, .admonition>.tip
{
font-weight: bold;
float: left;
padding-right: 10px;
}
.admonition>.note-text, .admonition>.warning-text, .admonition>.caution-text, .admonition>.important-text, .admonition>.tip-text
{
overflow: hidden;
}
/*******************************************************************************
Keywords
*******************************************************************************/
.backrest, .cmd, .postgres, .host, .proper
{
font-weight: 500;
}
.path, .br-option, .br-setting, .pg-option, .pg-setting, .id, .user, .file, .path
{
unicode-bidi: embed;
font-family: monospace;
white-space: nowrap;
}
/*******************************************************************************
Footer
*******************************************************************************/
.page-footer
{
border-top: 2px #cccccc solid;
margin-top: 1em;
padding-top: .25em;
font-size: x-small;
white-space: nowrap;
text-align: center;
}
pgbackrest-release-2.24/doc/resource/html/favicon.png 0000664 0000000 0000000 00000036701 13625315071 0022711 0 ustar 00root root 0000000 0000000 ‰PNG
IHDR szzô pHYs šœ ;®iTXtXML:com.adobe.xmp
Adobe Photoshop CC 2015 (Macintosh)
2016-05-14T16:50:19-04:00
2016-05-14T17:10:09-04:00
2016-05-14T17:10:09-04:00
image/png
3
xmp.iid:d9e4410d-ca59-49b8-8098-ad17fe93c96c
adobe:docid:photoshop:901a563a-5aa6-1179-89fa-991d02f05b6a
xmp.did:c8495a23-30be-496a-b761-dc67c0d8dfe2
created
xmp.iid:c8495a23-30be-496a-b761-dc67c0d8dfe2
2016-05-14T16:50:19-04:00
Adobe Photoshop CC 2015 (Macintosh)
saved
xmp.iid:a2b493b0-578b-4cd4-8b14-7f81bc6b2cb4
2016-05-14T16:59:42-04:00
Adobe Photoshop CC 2015 (Macintosh)
/
saved
xmp.iid:d9e4410d-ca59-49b8-8098-ad17fe93c96c
2016-05-14T17:10:09-04:00
Adobe Photoshop CC 2015 (Macintosh)
/
1
720000/10000
720000/10000
2
65535
32
32
ZÁ‰À cHRM z% €ƒ ùÿ €é u0 ê` :˜ o’_ÅF IDATxÚì—½KÃ@Æ
QŠ:ˆvê¢â".Nââæ$]Ä?@ÄAÐQ\T‚‚³ƒƒ"
~M \ì"Žuñ‡.‘mt¹ƒ#ä’»|Ð%/¼$áž÷yž ïÝ%` cÀðÈC BŽ1
\^ˆ¸L¸f².»@7B8˜]`OÔ¦ŠAàÖB8˜wÀ@)Äe^'_Ï@\æ¦x%Cq™ãaBŽÆÀ,ðüfÐÄ= Ì%)ž îS¼õ£à°ZrÕé:J ^ÙÀªº¥Y¶•b x•ñ†…xCá^ ^ã;A#'¢Žbbø1ï‰]QÛÑàN¥ø’(Ò~(Íúl` ©ÌZ+çËNé¼ `••ËíX¬€/째N™›8ß ëÛp;Àý‹-W 85`Å à 8‹Á´ ÅŸ€sù0 >/PUT
}ifelse
pdfmark_5
}forall
}bdf
/ds{
Adobe_AGM_Utils begin
}bdf
/dt{
currentdict Adobe_AGM_Utils eq{
end
}if
}bdf
systemdict/setpacking known
{setpacking}if
%%EndResource
%%BeginResource: procset Adobe_AGM_Core 2.0 0
%%Version: 2.0 0
%%Copyright: Copyright(C)1997-2007 Adobe Systems, Inc. All Rights Reserved.
systemdict/setpacking known
{
currentpacking
true setpacking
}if
userdict/Adobe_AGM_Core 209 dict dup begin put
/Adobe_AGM_Core_Id/Adobe_AGM_Core_2.0_0 def
/AGMCORE_str256 256 string def
/AGMCORE_save nd
/AGMCORE_graphicsave nd
/AGMCORE_c 0 def
/AGMCORE_m 0 def
/AGMCORE_y 0 def
/AGMCORE_k 0 def
/AGMCORE_cmykbuf 4 array def
/AGMCORE_screen[currentscreen]cvx def
/AGMCORE_tmp 0 def
/AGMCORE_&setgray nd
/AGMCORE_&setcolor nd
/AGMCORE_&setcolorspace nd
/AGMCORE_&setcmykcolor nd
/AGMCORE_cyan_plate nd
/AGMCORE_magenta_plate nd
/AGMCORE_yellow_plate nd
/AGMCORE_black_plate nd
/AGMCORE_plate_ndx nd
/AGMCORE_get_ink_data nd
/AGMCORE_is_cmyk_sep nd
/AGMCORE_host_sep nd
/AGMCORE_avoid_L2_sep_space nd
/AGMCORE_distilling nd
/AGMCORE_composite_job nd
/AGMCORE_producing_seps nd
/AGMCORE_ps_level -1 def
/AGMCORE_ps_version -1 def
/AGMCORE_environ_ok nd
/AGMCORE_CSD_cache 0 dict def
/AGMCORE_currentoverprint false def
/AGMCORE_deltaX nd
/AGMCORE_deltaY nd
/AGMCORE_name nd
/AGMCORE_sep_special nd
/AGMCORE_err_strings 4 dict def
/AGMCORE_cur_err nd
/AGMCORE_current_spot_alias false def
/AGMCORE_inverting false def
/AGMCORE_feature_dictCount nd
/AGMCORE_feature_opCount nd
/AGMCORE_feature_ctm nd
/AGMCORE_ConvertToProcess false def
/AGMCORE_Default_CTM matrix def
/AGMCORE_Default_PageSize nd
/AGMCORE_Default_flatness nd
/AGMCORE_currentbg nd
/AGMCORE_currentucr nd
/AGMCORE_pattern_paint_type 0 def
/knockout_unitsq nd
currentglobal true setglobal
[/CSA/Gradient/Procedure]
{
/Generic/Category findresource dup length dict copy/Category defineresource pop
}forall
setglobal
/AGMCORE_key_known
{
where{
/Adobe_AGM_Core_Id known
}{
false
}ifelse
}ndf
/flushinput
{
save
2 dict begin
/CompareBuffer 3 -1 roll def
/readbuffer 256 string def
mark
{
currentfile readbuffer{readline}stopped
{cleartomark mark}
{
not
{pop exit}
if
CompareBuffer eq
{exit}
if
}ifelse
}loop
cleartomark
end
restore
}bdf
/getspotfunction
{
AGMCORE_screen exch pop exch pop
dup type/dicttype eq{
dup/HalftoneType get 1 eq{
/SpotFunction get
}{
dup/HalftoneType get 2 eq{
/GraySpotFunction get
}{
pop
{
abs exch abs 2 copy add 1 gt{
1 sub dup mul exch 1 sub dup mul add 1 sub
}{
dup mul exch dup mul add 1 exch sub
}ifelse
}bind
}ifelse
}ifelse
}if
}def
/np
{newpath}bdf
/clp_npth
{clip np}def
/eoclp_npth
{eoclip np}def
/npth_clp
{np clip}def
/graphic_setup
{
/AGMCORE_graphicsave save store
concat
0 setgray
0 setlinecap
0 setlinejoin
1 setlinewidth
[]0 setdash
10 setmiterlimit
np
false setoverprint
false setstrokeadjust
//Adobe_AGM_Core/spot_alias gx
/Adobe_AGM_Image where{
pop
Adobe_AGM_Image/spot_alias 2 copy known{
gx
}{
pop pop
}ifelse
}if
/sep_colorspace_dict null AGMCORE_gput
100 dict begin
/dictstackcount countdictstack def
/showpage{}def
mark
}def
/graphic_cleanup
{
cleartomark
dictstackcount 1 countdictstack 1 sub{end}for
end
AGMCORE_graphicsave restore
}def
/compose_error_msg
{
grestoreall initgraphics
/Helvetica findfont 10 scalefont setfont
/AGMCORE_deltaY 100 def
/AGMCORE_deltaX 310 def
clippath pathbbox np pop pop 36 add exch 36 add exch moveto
0 AGMCORE_deltaY rlineto AGMCORE_deltaX 0 rlineto
0 AGMCORE_deltaY neg rlineto AGMCORE_deltaX neg 0 rlineto closepath
0 AGMCORE_&setgray
gsave 1 AGMCORE_&setgray fill grestore
1 setlinewidth gsave stroke grestore
currentpoint AGMCORE_deltaY 15 sub add exch 8 add exch moveto
/AGMCORE_deltaY 12 def
/AGMCORE_tmp 0 def
AGMCORE_err_strings exch get
{
dup 32 eq
{
pop
AGMCORE_str256 0 AGMCORE_tmp getinterval
stringwidth pop currentpoint pop add AGMCORE_deltaX 28 add gt
{
currentpoint AGMCORE_deltaY sub exch pop
clippath pathbbox pop pop pop 44 add exch moveto
}if
AGMCORE_str256 0 AGMCORE_tmp getinterval show( )show
0 1 AGMCORE_str256 length 1 sub
{
AGMCORE_str256 exch 0 put
}for
/AGMCORE_tmp 0 def
}{
AGMCORE_str256 exch AGMCORE_tmp xpt
/AGMCORE_tmp AGMCORE_tmp 1 add def
}ifelse
}forall
}bdf
/AGMCORE_CMYKDeviceNColorspaces[
[/Separation/None/DeviceCMYK{0 0 0}]
[/Separation(Black)/DeviceCMYK{0 0 0 4 -1 roll}bind]
[/Separation(Yellow)/DeviceCMYK{0 0 3 -1 roll 0}bind]
[/DeviceN[(Yellow)(Black)]/DeviceCMYK{0 0 4 2 roll}bind]
[/Separation(Magenta)/DeviceCMYK{0 exch 0 0}bind]
[/DeviceN[(Magenta)(Black)]/DeviceCMYK{0 3 1 roll 0 exch}bind]
[/DeviceN[(Magenta)(Yellow)]/DeviceCMYK{0 3 1 roll 0}bind]
[/DeviceN[(Magenta)(Yellow)(Black)]/DeviceCMYK{0 4 1 roll}bind]
[/Separation(Cyan)/DeviceCMYK{0 0 0}]
[/DeviceN[(Cyan)(Black)]/DeviceCMYK{0 0 3 -1 roll}bind]
[/DeviceN[(Cyan)(Yellow)]/DeviceCMYK{0 exch 0}bind]
[/DeviceN[(Cyan)(Yellow)(Black)]/DeviceCMYK{0 3 1 roll}bind]
[/DeviceN[(Cyan)(Magenta)]/DeviceCMYK{0 0}]
[/DeviceN[(Cyan)(Magenta)(Black)]/DeviceCMYK{0 exch}bind]
[/DeviceN[(Cyan)(Magenta)(Yellow)]/DeviceCMYK{0}]
[/DeviceCMYK]
]def
/ds{
Adobe_AGM_Core begin
/currentdistillerparams where
{
pop currentdistillerparams/CoreDistVersion get 5000 lt
{<>setdistillerparams}if
}if
/AGMCORE_ps_version xdf
/AGMCORE_ps_level xdf
errordict/AGM_handleerror known not{
errordict/AGM_handleerror errordict/handleerror get put
errordict/handleerror{
Adobe_AGM_Core begin
$error/newerror get AGMCORE_cur_err null ne and{
$error/newerror false put
AGMCORE_cur_err compose_error_msg
}if
$error/newerror true put
end
errordict/AGM_handleerror get exec
}bind put
}if
/AGMCORE_environ_ok
ps_level AGMCORE_ps_level ge
ps_version AGMCORE_ps_version ge and
AGMCORE_ps_level -1 eq or
def
AGMCORE_environ_ok not
{/AGMCORE_cur_err/AGMCORE_bad_environ def}if
/AGMCORE_&setgray systemdict/setgray get def
level2{
/AGMCORE_&setcolor systemdict/setcolor get def
/AGMCORE_&setcolorspace systemdict/setcolorspace get def
}if
/AGMCORE_currentbg currentblackgeneration def
/AGMCORE_currentucr currentundercolorremoval def
/AGMCORE_Default_flatness currentflat def
/AGMCORE_distilling
/product where{
pop systemdict/setdistillerparams known product(Adobe PostScript Parser)ne and
}{
false
}ifelse
def
/AGMCORE_GSTATE AGMCORE_key_known not{
/AGMCORE_GSTATE 21 dict def
/AGMCORE_tmpmatrix matrix def
/AGMCORE_gstack 32 array def
/AGMCORE_gstackptr 0 def
/AGMCORE_gstacksaveptr 0 def
/AGMCORE_gstackframekeys 14 def
/AGMCORE_&gsave/gsave ldf
/AGMCORE_&grestore/grestore ldf
/AGMCORE_&grestoreall/grestoreall ldf
/AGMCORE_&save/save ldf
/AGMCORE_&setoverprint/setoverprint ldf
/AGMCORE_gdictcopy{
begin
{def}forall
end
}def
/AGMCORE_gput{
AGMCORE_gstack AGMCORE_gstackptr get
3 1 roll
put
}def
/AGMCORE_gget{
AGMCORE_gstack AGMCORE_gstackptr get
exch
get
}def
/gsave{
AGMCORE_&gsave
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gstackptr 1 add
dup 32 ge{limitcheck}if
/AGMCORE_gstackptr exch store
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gdictcopy
}def
/grestore{
AGMCORE_&grestore
AGMCORE_gstackptr 1 sub
dup AGMCORE_gstacksaveptr lt{1 add}if
dup AGMCORE_gstack exch get dup/AGMCORE_currentoverprint known
{/AGMCORE_currentoverprint get setoverprint}{pop}ifelse
/AGMCORE_gstackptr exch store
}def
/grestoreall{
AGMCORE_&grestoreall
/AGMCORE_gstackptr AGMCORE_gstacksaveptr store
}def
/save{
AGMCORE_&save
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gstackptr 1 add
dup 32 ge{limitcheck}if
/AGMCORE_gstackptr exch store
/AGMCORE_gstacksaveptr AGMCORE_gstackptr store
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gdictcopy
}def
/setoverprint{
dup/AGMCORE_currentoverprint exch AGMCORE_gput AGMCORE_&setoverprint
}def
0 1 AGMCORE_gstack length 1 sub{
AGMCORE_gstack exch AGMCORE_gstackframekeys dict put
}for
}if
level3/AGMCORE_&sysshfill AGMCORE_key_known not and
{
/AGMCORE_&sysshfill systemdict/shfill get def
/AGMCORE_&sysmakepattern systemdict/makepattern get def
/AGMCORE_&usrmakepattern/makepattern load def
}if
/currentcmykcolor[0 0 0 0]AGMCORE_gput
/currentstrokeadjust false AGMCORE_gput
/currentcolorspace[/DeviceGray]AGMCORE_gput
/sep_tint 0 AGMCORE_gput
/devicen_tints[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0]AGMCORE_gput
/sep_colorspace_dict null AGMCORE_gput
/devicen_colorspace_dict null AGMCORE_gput
/indexed_colorspace_dict null AGMCORE_gput
/currentcolor_intent()AGMCORE_gput
/customcolor_tint 1 AGMCORE_gput
/absolute_colorimetric_crd null AGMCORE_gput
/relative_colorimetric_crd null AGMCORE_gput
/saturation_crd null AGMCORE_gput
/perceptual_crd null AGMCORE_gput
currentcolortransfer cvlit/AGMCore_gray_xfer xdf cvlit/AGMCore_b_xfer xdf
cvlit/AGMCore_g_xfer xdf cvlit/AGMCore_r_xfer xdf
<<
/MaxPatternItem currentsystemparams/MaxPatternCache get
>>
setuserparams
end
}def
/ps
{
/setcmykcolor where{
pop
Adobe_AGM_Core/AGMCORE_&setcmykcolor/setcmykcolor load put
}if
Adobe_AGM_Core begin
/setcmykcolor
{
4 copy AGMCORE_cmykbuf astore/currentcmykcolor exch AGMCORE_gput
1 sub 4 1 roll
3{
3 index add neg dup 0 lt{
pop 0
}if
3 1 roll
}repeat
setrgbcolor pop
}ndf
/currentcmykcolor
{
/currentcmykcolor AGMCORE_gget aload pop
}ndf
/setoverprint
{pop}ndf
/currentoverprint
{false}ndf
/AGMCORE_cyan_plate 1 0 0 0 test_cmyk_color_plate def
/AGMCORE_magenta_plate 0 1 0 0 test_cmyk_color_plate def
/AGMCORE_yellow_plate 0 0 1 0 test_cmyk_color_plate def
/AGMCORE_black_plate 0 0 0 1 test_cmyk_color_plate def
/AGMCORE_plate_ndx
AGMCORE_cyan_plate{
0
}{
AGMCORE_magenta_plate{
1
}{
AGMCORE_yellow_plate{
2
}{
AGMCORE_black_plate{
3
}{
4
}ifelse
}ifelse
}ifelse
}ifelse
def
/AGMCORE_have_reported_unsupported_color_space false def
/AGMCORE_report_unsupported_color_space
{
AGMCORE_have_reported_unsupported_color_space false eq
{
(Warning: Job contains content that cannot be separated with on-host methods. This content appears on the black plate, and knocks out all other plates.)==
Adobe_AGM_Core/AGMCORE_have_reported_unsupported_color_space true ddf
}if
}def
/AGMCORE_composite_job
AGMCORE_cyan_plate AGMCORE_magenta_plate and AGMCORE_yellow_plate and AGMCORE_black_plate and def
/AGMCORE_in_rip_sep
/AGMCORE_in_rip_sep where{
pop AGMCORE_in_rip_sep
}{
AGMCORE_distilling
{
false
}{
userdict/Adobe_AGM_OnHost_Seps known{
false
}{
level2{
currentpagedevice/Separations 2 copy known{
get
}{
pop pop false
}ifelse
}{
false
}ifelse
}ifelse
}ifelse
}ifelse
def
/AGMCORE_producing_seps AGMCORE_composite_job not AGMCORE_in_rip_sep or def
/AGMCORE_host_sep AGMCORE_producing_seps AGMCORE_in_rip_sep not and def
/AGM_preserve_spots
/AGM_preserve_spots where{
pop AGM_preserve_spots
}{
AGMCORE_distilling AGMCORE_producing_seps or
}ifelse
def
/AGM_is_distiller_preserving_spotimages
{
currentdistillerparams/PreserveOverprintSettings known
{
currentdistillerparams/PreserveOverprintSettings get
{
currentdistillerparams/ColorConversionStrategy known
{
currentdistillerparams/ColorConversionStrategy get
/sRGB ne
}{
true
}ifelse
}{
false
}ifelse
}{
false
}ifelse
}def
/convert_spot_to_process where{pop}{
/convert_spot_to_process
{
//Adobe_AGM_Core begin
dup map_alias{
/Name get exch pop
}if
dup dup(None)eq exch(All)eq or
{
pop false
}{
AGMCORE_host_sep
{
gsave
1 0 0 0 setcmykcolor currentgray 1 exch sub
0 1 0 0 setcmykcolor currentgray 1 exch sub
0 0 1 0 setcmykcolor currentgray 1 exch sub
0 0 0 1 setcmykcolor currentgray 1 exch sub
add add add 0 eq
{
pop false
}{
false setoverprint
current_spot_alias false set_spot_alias
1 1 1 1 6 -1 roll findcmykcustomcolor 1 setcustomcolor
set_spot_alias
currentgray 1 ne
}ifelse
grestore
}{
AGMCORE_distilling
{
pop AGM_is_distiller_preserving_spotimages not
}{
//Adobe_AGM_Core/AGMCORE_name xddf
false
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 0 eq
AGMUTIL_cpd/OverrideSeparations known and
{
AGMUTIL_cpd/OverrideSeparations get
{
/HqnSpots/ProcSet resourcestatus
{
pop pop pop true
}if
}if
}if
{
AGMCORE_name/HqnSpots/ProcSet findresource/TestSpot gx not
}{
gsave
[/Separation AGMCORE_name/DeviceGray{}]AGMCORE_&setcolorspace
false
AGMUTIL_cpd/SeparationColorNames 2 copy known
{
get
{AGMCORE_name eq or}forall
not
}{
pop pop pop true
}ifelse
grestore
}ifelse
}ifelse
}ifelse
}ifelse
end
}def
}ifelse
/convert_to_process where{pop}{
/convert_to_process
{
dup length 0 eq
{
pop false
}{
AGMCORE_host_sep
{
dup true exch
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
dup(Black)eq 3 -1 roll or
{pop}
{convert_spot_to_process and}ifelse
}
forall
{
true exch
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
(Black)eq or and
}forall
not
}{pop false}ifelse
}{
false exch
{
/PhotoshopDuotoneList where{pop false}{true}ifelse
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
dup(Black)eq 3 -1 roll or
{pop}
{convert_spot_to_process or}ifelse
}
{
convert_spot_to_process or
}
ifelse
}
forall
}ifelse
}ifelse
}def
}ifelse
/AGMCORE_avoid_L2_sep_space
version cvr 2012 lt
level2 and
AGMCORE_producing_seps not and
def
/AGMCORE_is_cmyk_sep
AGMCORE_cyan_plate AGMCORE_magenta_plate or AGMCORE_yellow_plate or AGMCORE_black_plate or
def
/AGM_avoid_0_cmyk where{
pop AGM_avoid_0_cmyk
}{
AGM_preserve_spots
userdict/Adobe_AGM_OnHost_Seps known
userdict/Adobe_AGM_InRip_Seps known or
not and
}ifelse
{
/setcmykcolor[
{
4 copy add add add 0 eq currentoverprint and{
pop 0.0005
}if
}/exec cvx
/AGMCORE_&setcmykcolor load dup type/operatortype ne{
/exec cvx
}if
]cvx def
}if
/AGMCORE_IsSeparationAProcessColor
{
dup(Cyan)eq exch dup(Magenta)eq exch dup(Yellow)eq exch(Black)eq or or or
}def
AGMCORE_host_sep{
/setcolortransfer
{
AGMCORE_cyan_plate{
pop pop pop
}{
AGMCORE_magenta_plate{
4 3 roll pop pop pop
}{
AGMCORE_yellow_plate{
4 2 roll pop pop pop
}{
4 1 roll pop pop pop
}ifelse
}ifelse
}ifelse
settransfer
}
def
/AGMCORE_get_ink_data
AGMCORE_cyan_plate{
{pop pop pop}
}{
AGMCORE_magenta_plate{
{4 3 roll pop pop pop}
}{
AGMCORE_yellow_plate{
{4 2 roll pop pop pop}
}{
{4 1 roll pop pop pop}
}ifelse
}ifelse
}ifelse
def
/AGMCORE_RemoveProcessColorNames
{
1 dict begin
/filtername
{
dup/Cyan eq 1 index(Cyan)eq or
{pop(_cyan_)}if
dup/Magenta eq 1 index(Magenta)eq or
{pop(_magenta_)}if
dup/Yellow eq 1 index(Yellow)eq or
{pop(_yellow_)}if
dup/Black eq 1 index(Black)eq or
{pop(_black_)}if
}def
dup type/arraytype eq
{[exch{filtername}forall]}
{filtername}ifelse
end
}def
level3{
/AGMCORE_IsCurrentColor
{
dup AGMCORE_IsSeparationAProcessColor
{
AGMCORE_plate_ndx 0 eq
{dup(Cyan)eq exch/Cyan eq or}if
AGMCORE_plate_ndx 1 eq
{dup(Magenta)eq exch/Magenta eq or}if
AGMCORE_plate_ndx 2 eq
{dup(Yellow)eq exch/Yellow eq or}if
AGMCORE_plate_ndx 3 eq
{dup(Black)eq exch/Black eq or}if
AGMCORE_plate_ndx 4 eq
{pop false}if
}{
gsave
false setoverprint
current_spot_alias false set_spot_alias
1 1 1 1 6 -1 roll findcmykcustomcolor 1 setcustomcolor
set_spot_alias
currentgray 1 ne
grestore
}ifelse
}def
/AGMCORE_filter_functiondatasource
{
5 dict begin
/data_in xdf
data_in type/stringtype eq
{
/ncomp xdf
/comp xdf
/string_out data_in length ncomp idiv string def
0 ncomp data_in length 1 sub
{
string_out exch dup ncomp idiv exch data_in exch ncomp getinterval comp get 255 exch sub put
}for
string_out
}{
string/string_in xdf
/string_out 1 string def
/component xdf
[
data_in string_in/readstring cvx
[component/get cvx 255/exch cvx/sub cvx string_out/exch cvx 0/exch cvx/put cvx string_out]cvx
[/pop cvx()]cvx/ifelse cvx
]cvx/ReusableStreamDecode filter
}ifelse
end
}def
/AGMCORE_separateShadingFunction
{
2 dict begin
/paint? xdf
/channel xdf
dup type/dicttype eq
{
begin
FunctionType 0 eq
{
/DataSource channel Range length 2 idiv DataSource AGMCORE_filter_functiondatasource def
currentdict/Decode known
{/Decode Decode channel 2 mul 2 getinterval def}if
paint? not
{/Decode[1 1]def}if
}if
FunctionType 2 eq
{
paint?
{
/C0[C0 channel get 1 exch sub]def
/C1[C1 channel get 1 exch sub]def
}{
/C0[1]def
/C1[1]def
}ifelse
}if
FunctionType 3 eq
{
/Functions[Functions{channel paint? AGMCORE_separateShadingFunction}forall]def
}if
currentdict/Range known
{/Range[0 1]def}if
currentdict
end}{
channel get 0 paint? AGMCORE_separateShadingFunction
}ifelse
end
}def
/AGMCORE_separateShading
{
3 -1 roll begin
currentdict/Function known
{
currentdict/Background known
{[1 index{Background 3 index get 1 exch sub}{1}ifelse]/Background xdf}if
Function 3 1 roll AGMCORE_separateShadingFunction/Function xdf
/ColorSpace[/DeviceGray]def
}{
ColorSpace dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace[/DeviceN[/_cyan_/_magenta_/_yellow_/_black_]/DeviceCMYK{}]def
}{
ColorSpace dup 1 get AGMCORE_RemoveProcessColorNames 1 exch put
}ifelse
ColorSpace 0 get/Separation eq
{
{
[1/exch cvx/sub cvx]cvx
}{
[/pop cvx 1]cvx
}ifelse
ColorSpace 3 3 -1 roll put
pop
}{
{
[exch ColorSpace 1 get length 1 sub exch sub/index cvx 1/exch cvx/sub cvx ColorSpace 1 get length 1 add 1/roll cvx ColorSpace 1 get length{/pop cvx}repeat]cvx
}{
pop[ColorSpace 1 get length{/pop cvx}repeat cvx 1]cvx
}ifelse
ColorSpace 3 3 -1 roll bind put
}ifelse
ColorSpace 2/DeviceGray put
}ifelse
end
}def
/AGMCORE_separateShadingDict
{
dup/ColorSpace get
dup type/arraytype ne
{[exch]}if
dup 0 get/DeviceCMYK eq
{
exch begin
currentdict
AGMCORE_cyan_plate
{0 true}if
AGMCORE_magenta_plate
{1 true}if
AGMCORE_yellow_plate
{2 true}if
AGMCORE_black_plate
{3 true}if
AGMCORE_plate_ndx 4 eq
{0 false}if
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
currentdict
end exch
}if
dup 0 get/Separation eq
{
exch begin
ColorSpace 1 get dup/None ne exch/All ne and
{
ColorSpace 1 get AGMCORE_IsCurrentColor AGMCORE_plate_ndx 4 lt and ColorSpace 1 get AGMCORE_IsSeparationAProcessColor not and
{
ColorSpace 2 get dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace
[
/Separation
ColorSpace 1 get
/DeviceGray
[
ColorSpace 3 get/exec cvx
4 AGMCORE_plate_ndx sub -1/roll cvx
4 1/roll cvx
3[/pop cvx]cvx/repeat cvx
1/exch cvx/sub cvx
]cvx
]def
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
currentdict 0 false AGMCORE_separateShading
}if
}ifelse
}{
currentdict ColorSpace 1 get AGMCORE_IsCurrentColor
0 exch
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
}ifelse
}if
currentdict
end exch
}if
dup 0 get/DeviceN eq
{
exch begin
ColorSpace 1 get convert_to_process
{
ColorSpace 2 get dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace
[
/DeviceN
ColorSpace 1 get
/DeviceGray
[
ColorSpace 3 get/exec cvx
4 AGMCORE_plate_ndx sub -1/roll cvx
4 1/roll cvx
3[/pop cvx]cvx/repeat cvx
1/exch cvx/sub cvx
]cvx
]def
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
currentdict 0 false AGMCORE_separateShading
/ColorSpace[/DeviceGray]def
}if
}ifelse
}{
currentdict
false -1 ColorSpace 1 get
{
AGMCORE_IsCurrentColor
{
1 add
exch pop true exch exit
}if
1 add
}forall
exch
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
}ifelse
currentdict
end exch
}if
dup 0 get dup/DeviceCMYK eq exch dup/Separation eq exch/DeviceN eq or or not
{
exch begin
ColorSpace dup type/arraytype eq
{0 get}if
/DeviceGray ne
{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
ColorSpace 0 get/CIEBasedA eq
{
/ColorSpace[/Separation/_ciebaseda_/DeviceGray{}]def
}if
ColorSpace 0 get dup/CIEBasedABC eq exch dup/CIEBasedDEF eq exch/DeviceRGB eq or or
{
/ColorSpace[/DeviceN[/_red_/_green_/_blue_]/DeviceRGB{}]def
}if
ColorSpace 0 get/CIEBasedDEFG eq
{
/ColorSpace[/DeviceN[/_cyan_/_magenta_/_yellow_/_black_]/DeviceCMYK{}]def
}if
currentdict 0 false AGMCORE_separateShading
}if
}if
currentdict
end exch
}if
pop
dup/AGMCORE_ignoreshade known
{
begin
/ColorSpace[/Separation(None)/DeviceGray{}]def
currentdict end
}if
}def
/shfill
{
AGMCORE_separateShadingDict
dup/AGMCORE_ignoreshade known
{pop}
{AGMCORE_&sysshfill}ifelse
}def
/makepattern
{
exch
dup/PatternType get 2 eq
{
clonedict
begin
/Shading Shading AGMCORE_separateShadingDict def
Shading/AGMCORE_ignoreshade known
currentdict end exch
{pop<>}if
exch AGMCORE_&sysmakepattern
}{
exch AGMCORE_&usrmakepattern
}ifelse
}def
}if
}if
AGMCORE_in_rip_sep{
/setcustomcolor
{
exch aload pop
dup 7 1 roll inRip_spot_has_ink not {
4{4 index mul 4 1 roll}
repeat
/DeviceCMYK setcolorspace
6 -2 roll pop pop
}{
//Adobe_AGM_Core begin
/AGMCORE_k xdf/AGMCORE_y xdf/AGMCORE_m xdf/AGMCORE_c xdf
end
[/Separation 4 -1 roll/DeviceCMYK
{dup AGMCORE_c mul exch dup AGMCORE_m mul exch dup AGMCORE_y mul exch AGMCORE_k mul}
]
setcolorspace
}ifelse
setcolor
}ndf
/setseparationgray
{
[/Separation(All)/DeviceGray{}]setcolorspace_opt
1 exch sub setcolor
}ndf
}{
/setseparationgray
{
AGMCORE_&setgray
}ndf
}ifelse
/findcmykcustomcolor
{
5 makereadonlyarray
}ndf
/setcustomcolor
{
exch aload pop pop
4{4 index mul 4 1 roll}repeat
setcmykcolor pop
}ndf
/has_color
/colorimage where{
AGMCORE_producing_seps{
pop true
}{
systemdict eq
}ifelse
}{
false
}ifelse
def
/map_index
{
1 index mul exch getinterval{255 div}forall
}bdf
/map_indexed_devn
{
Lookup Names length 3 -1 roll cvi map_index
}bdf
/n_color_components
{
base_colorspace_type
dup/DeviceGray eq{
pop 1
}{
/DeviceCMYK eq{
4
}{
3
}ifelse
}ifelse
}bdf
level2{
/mo/moveto ldf
/li/lineto ldf
/cv/curveto ldf
/knockout_unitsq
{
1 setgray
0 0 1 1 rectfill
}def
level2/setcolorspace AGMCORE_key_known not and{
/AGMCORE_&&&setcolorspace/setcolorspace ldf
/AGMCORE_ReplaceMappedColor
{
dup type dup/arraytype eq exch/packedarraytype eq or
{
/AGMCORE_SpotAliasAry2 where{
begin
dup 0 get dup/Separation eq
{
pop
dup length array copy
dup dup 1 get
current_spot_alias
{
dup map_alias
{
false set_spot_alias
dup 1 exch setsepcolorspace
true set_spot_alias
begin
/sep_colorspace_dict currentdict AGMCORE_gput
pop pop pop
[
/Separation Name
CSA map_csa
MappedCSA
/sep_colorspace_proc load
]
dup Name
end
}if
}if
map_reserved_ink_name 1 xpt
}{
/DeviceN eq
{
dup length array copy
dup dup 1 get[
exch{
current_spot_alias{
dup map_alias{
/Name get exch pop
}if
}if
map_reserved_ink_name
}forall
]1 xpt
}if
}ifelse
end
}if
}if
}def
/setcolorspace
{
dup type dup/arraytype eq exch/packedarraytype eq or
{
dup 0 get/Indexed eq
{
AGMCORE_distilling
{
/PhotoshopDuotoneList where
{
pop false
}{
true
}ifelse
}{
true
}ifelse
{
aload pop 3 -1 roll
AGMCORE_ReplaceMappedColor
3 1 roll 4 array astore
}if
}{
AGMCORE_ReplaceMappedColor
}ifelse
}if
DeviceN_PS2_inRip_seps{AGMCORE_&&&setcolorspace}if
}def
}if
}{
/adj
{
currentstrokeadjust{
transform
0.25 sub round 0.25 add exch
0.25 sub round 0.25 add exch
itransform
}if
}def
/mo{
adj moveto
}def
/li{
adj lineto
}def
/cv{
6 2 roll adj
6 2 roll adj
6 2 roll adj curveto
}def
/knockout_unitsq
{
1 setgray
8 8 1[8 0 0 8 0 0]{}image
}def
/currentstrokeadjust{
/currentstrokeadjust AGMCORE_gget
}def
/setstrokeadjust{
/currentstrokeadjust exch AGMCORE_gput
}def
/setcolorspace
{
/currentcolorspace exch AGMCORE_gput
}def
/currentcolorspace
{
/currentcolorspace AGMCORE_gget
}def
/setcolor_devicecolor
{
base_colorspace_type
dup/DeviceGray eq{
pop setgray
}{
/DeviceCMYK eq{
setcmykcolor
}{
setrgbcolor
}ifelse
}ifelse
}def
/setcolor
{
currentcolorspace 0 get
dup/DeviceGray ne{
dup/DeviceCMYK ne{
dup/DeviceRGB ne{
dup/Separation eq{
pop
currentcolorspace 3 gx
currentcolorspace 2 get
}{
dup/Indexed eq{
pop
currentcolorspace 3 get dup type/stringtype eq{
currentcolorspace 1 get n_color_components
3 -1 roll map_index
}{
exec
}ifelse
currentcolorspace 1 get
}{
/AGMCORE_cur_err/AGMCORE_invalid_color_space def
AGMCORE_invalid_color_space
}ifelse
}ifelse
}if
}if
}if
setcolor_devicecolor
}def
}ifelse
/sop/setoverprint ldf
/lw/setlinewidth ldf
/lc/setlinecap ldf
/lj/setlinejoin ldf
/ml/setmiterlimit ldf
/dsh/setdash ldf
/sadj/setstrokeadjust ldf
/gry/setgray ldf
/rgb/setrgbcolor ldf
/cmyk[
/currentcolorspace[/DeviceCMYK]/AGMCORE_gput cvx
/setcmykcolor load dup type/operatortype ne{/exec cvx}if
]cvx bdf
level3 AGMCORE_host_sep not and{
/nzopmsc{
6 dict begin
/kk exch def
/yy exch def
/mm exch def
/cc exch def
/sum 0 def
cc 0 ne{/sum sum 2#1000 or def cc}if
mm 0 ne{/sum sum 2#0100 or def mm}if
yy 0 ne{/sum sum 2#0010 or def yy}if
kk 0 ne{/sum sum 2#0001 or def kk}if
AGMCORE_CMYKDeviceNColorspaces sum get setcolorspace
sum 0 eq{0}if
end
setcolor
}bdf
}{
/nzopmsc/cmyk ldf
}ifelse
/sep/setsepcolor ldf
/devn/setdevicencolor ldf
/idx/setindexedcolor ldf
/colr/setcolor ldf
/csacrd/set_csa_crd ldf
/sepcs/setsepcolorspace ldf
/devncs/setdevicencolorspace ldf
/idxcs/setindexedcolorspace ldf
/cp/closepath ldf
/clp/clp_npth ldf
/eclp/eoclp_npth ldf
/f/fill ldf
/ef/eofill ldf
/@/stroke ldf
/nclp/npth_clp ldf
/gset/graphic_setup ldf
/gcln/graphic_cleanup ldf
/ct/concat ldf
/cf/currentfile ldf
/fl/filter ldf
/rs/readstring ldf
/AGMCORE_def_ht currenthalftone def
/clonedict Adobe_AGM_Utils begin/clonedict load end def
/clonearray Adobe_AGM_Utils begin/clonearray load end def
currentdict{
dup xcheck 1 index type dup/arraytype eq exch/packedarraytype eq or and{
bind
}if
def
}forall
/getrampcolor
{
/indx exch def
0 1 NumComp 1 sub
{
dup
Samples exch get
dup type/stringtype eq{indx get}if
exch
Scaling exch get aload pop
3 1 roll
mul add
}for
ColorSpaceFamily/Separation eq
{sep}
{
ColorSpaceFamily/DeviceN eq
{devn}{setcolor}ifelse
}ifelse
}bdf
/sssetbackground{
aload pop
ColorSpaceFamily/Separation eq
{sep}
{
ColorSpaceFamily/DeviceN eq
{devn}{setcolor}ifelse
}ifelse
}bdf
/RadialShade
{
40 dict begin
/ColorSpaceFamily xdf
/background xdf
/ext1 xdf
/ext0 xdf
/BBox xdf
/r2 xdf
/c2y xdf
/c2x xdf
/r1 xdf
/c1y xdf
/c1x xdf
/rampdict xdf
/setinkoverprint where{pop/setinkoverprint{pop}def}if
gsave
BBox length 0 gt
{
np
BBox 0 get BBox 1 get moveto
BBox 2 get BBox 0 get sub 0 rlineto
0 BBox 3 get BBox 1 get sub rlineto
BBox 2 get BBox 0 get sub neg 0 rlineto
closepath
clip
np
}if
c1x c2x eq
{
c1y c2y lt{/theta 90 def}{/theta 270 def}ifelse
}{
/slope c2y c1y sub c2x c1x sub div def
/theta slope 1 atan def
c2x c1x lt c2y c1y ge and{/theta theta 180 sub def}if
c2x c1x lt c2y c1y lt and{/theta theta 180 add def}if
}ifelse
gsave
clippath
c1x c1y translate
theta rotate
-90 rotate
{pathbbox}stopped
{0 0 0 0}if
/yMax xdf
/xMax xdf
/yMin xdf
/xMin xdf
grestore
xMax xMin eq yMax yMin eq or
{
grestore
end
}{
/max{2 copy gt{pop}{exch pop}ifelse}bdf
/min{2 copy lt{pop}{exch pop}ifelse}bdf
rampdict begin
40 dict begin
background length 0 gt{background sssetbackground gsave clippath fill grestore}if
gsave
c1x c1y translate
theta rotate
-90 rotate
/c2y c1x c2x sub dup mul c1y c2y sub dup mul add sqrt def
/c1y 0 def
/c1x 0 def
/c2x 0 def
ext0
{
0 getrampcolor
c2y r2 add r1 sub 0.0001 lt
{
c1x c1y r1 360 0 arcn
pathbbox
/aymax exch def
/axmax exch def
/aymin exch def
/axmin exch def
/bxMin xMin axmin min def
/byMin yMin aymin min def
/bxMax xMax axmax max def
/byMax yMax aymax max def
bxMin byMin moveto
bxMax byMin lineto
bxMax byMax lineto
bxMin byMax lineto
bxMin byMin lineto
eofill
}{
c2y r1 add r2 le
{
c1x c1y r1 0 360 arc
fill
}
{
c2x c2y r2 0 360 arc fill
r1 r2 eq
{
/p1x r1 neg def
/p1y c1y def
/p2x r1 def
/p2y c1y def
p1x p1y moveto p2x p2y lineto p2x yMin lineto p1x yMin lineto
fill
}{
/AA r2 r1 sub c2y div def
AA -1 eq
{/theta 89.99 def}
{/theta AA 1 AA dup mul sub sqrt div 1 atan def}
ifelse
/SS1 90 theta add dup sin exch cos div def
/p1x r1 SS1 SS1 mul SS1 SS1 mul 1 add div sqrt mul neg def
/p1y p1x SS1 div neg def
/SS2 90 theta sub dup sin exch cos div def
/p2x r1 SS2 SS2 mul SS2 SS2 mul 1 add div sqrt mul def
/p2y p2x SS2 div neg def
r1 r2 gt
{
/L1maxX p1x yMin p1y sub SS1 div add def
/L2maxX p2x yMin p2y sub SS2 div add def
}{
/L1maxX 0 def
/L2maxX 0 def
}ifelse
p1x p1y moveto p2x p2y lineto L2maxX L2maxX p2x sub SS2 mul p2y add lineto
L1maxX L1maxX p1x sub SS1 mul p1y add lineto
fill
}ifelse
}ifelse
}ifelse
}if
c1x c2x sub dup mul
c1y c2y sub dup mul
add 0.5 exp
0 dtransform
dup mul exch dup mul add 0.5 exp 72 div
0 72 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
72 0 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
1 index 1 index lt{exch}if pop
/hires xdf
hires mul
/numpix xdf
/numsteps NumSamples def
/rampIndxInc 1 def
/subsampling false def
numpix 0 ne
{
NumSamples numpix div 0.5 gt
{
/numsteps numpix 2 div round cvi dup 1 le{pop 2}if def
/rampIndxInc NumSamples 1 sub numsteps div def
/subsampling true def
}if
}if
/xInc c2x c1x sub numsteps div def
/yInc c2y c1y sub numsteps div def
/rInc r2 r1 sub numsteps div def
/cx c1x def
/cy c1y def
/radius r1 def
np
xInc 0 eq yInc 0 eq rInc 0 eq and and
{
0 getrampcolor
cx cy radius 0 360 arc
stroke
NumSamples 1 sub getrampcolor
cx cy radius 72 hires div add 0 360 arc
0 setlinewidth
stroke
}{
0
numsteps
{
dup
subsampling{round cvi}if
getrampcolor
cx cy radius 0 360 arc
/cx cx xInc add def
/cy cy yInc add def
/radius radius rInc add def
cx cy radius 360 0 arcn
eofill
rampIndxInc add
}repeat
pop
}ifelse
ext1
{
c2y r2 add r1 lt
{
c2x c2y r2 0 360 arc
fill
}{
c2y r1 add r2 sub 0.0001 le
{
c2x c2y r2 360 0 arcn
pathbbox
/aymax exch def
/axmax exch def
/aymin exch def
/axmin exch def
/bxMin xMin axmin min def
/byMin yMin aymin min def
/bxMax xMax axmax max def
/byMax yMax aymax max def
bxMin byMin moveto
bxMax byMin lineto
bxMax byMax lineto
bxMin byMax lineto
bxMin byMin lineto
eofill
}{
c2x c2y r2 0 360 arc fill
r1 r2 eq
{
/p1x r2 neg def
/p1y c2y def
/p2x r2 def
/p2y c2y def
p1x p1y moveto p2x p2y lineto p2x yMax lineto p1x yMax lineto
fill
}{
/AA r2 r1 sub c2y div def
AA -1 eq
{/theta 89.99 def}
{/theta AA 1 AA dup mul sub sqrt div 1 atan def}
ifelse
/SS1 90 theta add dup sin exch cos div def
/p1x r2 SS1 SS1 mul SS1 SS1 mul 1 add div sqrt mul neg def
/p1y c2y p1x SS1 div sub def
/SS2 90 theta sub dup sin exch cos div def
/p2x r2 SS2 SS2 mul SS2 SS2 mul 1 add div sqrt mul def
/p2y c2y p2x SS2 div sub def
r1 r2 lt
{
/L1maxX p1x yMax p1y sub SS1 div add def
/L2maxX p2x yMax p2y sub SS2 div add def
}{
/L1maxX 0 def
/L2maxX 0 def
}ifelse
p1x p1y moveto p2x p2y lineto L2maxX L2maxX p2x sub SS2 mul p2y add lineto
L1maxX L1maxX p1x sub SS1 mul p1y add lineto
fill
}ifelse
}ifelse
}ifelse
}if
grestore
grestore
end
end
end
}ifelse
}bdf
/GenStrips
{
40 dict begin
/ColorSpaceFamily xdf
/background xdf
/ext1 xdf
/ext0 xdf
/BBox xdf
/y2 xdf
/x2 xdf
/y1 xdf
/x1 xdf
/rampdict xdf
/setinkoverprint where{pop/setinkoverprint{pop}def}if
gsave
BBox length 0 gt
{
np
BBox 0 get BBox 1 get moveto
BBox 2 get BBox 0 get sub 0 rlineto
0 BBox 3 get BBox 1 get sub rlineto
BBox 2 get BBox 0 get sub neg 0 rlineto
closepath
clip
np
}if
x1 x2 eq
{
y1 y2 lt{/theta 90 def}{/theta 270 def}ifelse
}{
/slope y2 y1 sub x2 x1 sub div def
/theta slope 1 atan def
x2 x1 lt y2 y1 ge and{/theta theta 180 sub def}if
x2 x1 lt y2 y1 lt and{/theta theta 180 add def}if
}
ifelse
gsave
clippath
x1 y1 translate
theta rotate
{pathbbox}stopped
{0 0 0 0}if
/yMax exch def
/xMax exch def
/yMin exch def
/xMin exch def
grestore
xMax xMin eq yMax yMin eq or
{
grestore
end
}{
rampdict begin
20 dict begin
background length 0 gt{background sssetbackground gsave clippath fill grestore}if
gsave
x1 y1 translate
theta rotate
/xStart 0 def
/xEnd x2 x1 sub dup mul y2 y1 sub dup mul add 0.5 exp def
/ySpan yMax yMin sub def
/numsteps NumSamples def
/rampIndxInc 1 def
/subsampling false def
xStart 0 transform
xEnd 0 transform
3 -1 roll
sub dup mul
3 1 roll
sub dup mul
add 0.5 exp 72 div
0 72 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
72 0 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
1 index 1 index lt{exch}if pop
mul
/numpix xdf
numpix 0 ne
{
NumSamples numpix div 0.5 gt
{
/numsteps numpix 2 div round cvi dup 1 le{pop 2}if def
/rampIndxInc NumSamples 1 sub numsteps div def
/subsampling true def
}if
}if
ext0
{
0 getrampcolor
xMin xStart lt
{
xMin yMin xMin neg ySpan rectfill
}if
}if
/xInc xEnd xStart sub numsteps div def
/x xStart def
0
numsteps
{
dup
subsampling{round cvi}if
getrampcolor
x yMin xInc ySpan rectfill
/x x xInc add def
rampIndxInc add
}repeat
pop
ext1{
xMax xEnd gt
{
xEnd yMin xMax xEnd sub ySpan rectfill
}if
}if
grestore
grestore
end
end
end
}ifelse
}bdf
}def
/pt
{
end
}def
/dt{
}def
/pgsv{
//Adobe_AGM_Core/AGMCORE_save save put
}def
/pgrs{
//Adobe_AGM_Core/AGMCORE_save get restore
}def
systemdict/findcolorrendering known{
/findcolorrendering systemdict/findcolorrendering get def
}if
systemdict/setcolorrendering known{
/setcolorrendering systemdict/setcolorrendering get def
}if
/test_cmyk_color_plate
{
gsave
setcmykcolor currentgray 1 ne
grestore
}def
/inRip_spot_has_ink
{
dup//Adobe_AGM_Core/AGMCORE_name xddf
convert_spot_to_process not
}def
/map255_to_range
{
1 index sub
3 -1 roll 255 div mul add
}def
/set_csa_crd
{
/sep_colorspace_dict null AGMCORE_gput
begin
CSA get_csa_by_name setcolorspace_opt
set_crd
end
}
def
/map_csa
{
currentdict/MappedCSA known{MappedCSA null ne}{false}ifelse
{pop}{get_csa_by_name/MappedCSA xdf}ifelse
}def
/setsepcolor
{
/sep_colorspace_dict AGMCORE_gget begin
dup/sep_tint exch AGMCORE_gput
TintProc
end
}def
/setdevicencolor
{
/devicen_colorspace_dict AGMCORE_gget begin
Names length copy
Names length 1 sub -1 0
{
/devicen_tints AGMCORE_gget 3 1 roll xpt
}for
TintProc
end
}def
/sep_colorspace_proc
{
/AGMCORE_tmp exch store
/sep_colorspace_dict AGMCORE_gget begin
currentdict/Components known{
Components aload pop
TintMethod/Lab eq{
2{AGMCORE_tmp mul NComponents 1 roll}repeat
LMax sub AGMCORE_tmp mul LMax add NComponents 1 roll
}{
TintMethod/Subtractive eq{
NComponents{
AGMCORE_tmp mul NComponents 1 roll
}repeat
}{
NComponents{
1 sub AGMCORE_tmp mul 1 add NComponents 1 roll
}repeat
}ifelse
}ifelse
}{
ColorLookup AGMCORE_tmp ColorLookup length 1 sub mul round cvi get
aload pop
}ifelse
end
}def
/sep_colorspace_gray_proc
{
/AGMCORE_tmp exch store
/sep_colorspace_dict AGMCORE_gget begin
GrayLookup AGMCORE_tmp GrayLookup length 1 sub mul round cvi get
end
}def
/sep_proc_name
{
dup 0 get
dup/DeviceRGB eq exch/DeviceCMYK eq or level2 not and has_color not and{
pop[/DeviceGray]
/sep_colorspace_gray_proc
}{
/sep_colorspace_proc
}ifelse
}def
/setsepcolorspace
{
current_spot_alias{
dup begin
Name map_alias{
exch pop
}if
end
}if
dup/sep_colorspace_dict exch AGMCORE_gput
begin
CSA map_csa
/AGMCORE_sep_special Name dup()eq exch(All)eq or store
AGMCORE_avoid_L2_sep_space{
[/Indexed MappedCSA sep_proc_name 255 exch
{255 div}/exec cvx 3 -1 roll[4 1 roll load/exec cvx]cvx
]setcolorspace_opt
/TintProc{
255 mul round cvi setcolor
}bdf
}{
MappedCSA 0 get/DeviceCMYK eq
currentdict/Components known and
AGMCORE_sep_special not and{
/TintProc[
Components aload pop Name findcmykcustomcolor
/exch cvx/setcustomcolor cvx
]cvx bdf
}{
AGMCORE_host_sep Name(All)eq and{
/TintProc{
1 exch sub setseparationgray
}bdf
}{
AGMCORE_in_rip_sep MappedCSA 0 get/DeviceCMYK eq and
AGMCORE_host_sep or
Name()eq and{
/TintProc[
MappedCSA sep_proc_name exch 0 get/DeviceCMYK eq{
cvx/setcmykcolor cvx
}{
cvx/setgray cvx
}ifelse
]cvx bdf
}{
AGMCORE_producing_seps MappedCSA 0 get dup/DeviceCMYK eq exch/DeviceGray eq or and AGMCORE_sep_special not and{
/TintProc[
/dup cvx
MappedCSA sep_proc_name cvx exch
0 get/DeviceGray eq{
1/exch cvx/sub cvx 0 0 0 4 -1/roll cvx
}if
/Name cvx/findcmykcustomcolor cvx/exch cvx
AGMCORE_host_sep{
AGMCORE_is_cmyk_sep
/Name cvx
/AGMCORE_IsSeparationAProcessColor load/exec cvx
/not cvx/and cvx
}{
Name inRip_spot_has_ink not
}ifelse
[
/pop cvx 1
]cvx/if cvx
/setcustomcolor cvx
]cvx bdf
}{
/TintProc{setcolor}bdf
[/Separation Name MappedCSA sep_proc_name load]setcolorspace_opt
}ifelse
}ifelse
}ifelse
}ifelse
}ifelse
set_crd
setsepcolor
end
}def
/additive_blend
{
3 dict begin
/numarrays xdf
/numcolors xdf
0 1 numcolors 1 sub
{
/c1 xdf
1
0 1 numarrays 1 sub
{
1 exch add/index cvx
c1/get cvx/mul cvx
}for
numarrays 1 add 1/roll cvx
}for
numarrays[/pop cvx]cvx/repeat cvx
end
}def
/subtractive_blend
{
3 dict begin
/numarrays xdf
/numcolors xdf
0 1 numcolors 1 sub
{
/c1 xdf
1 1
0 1 numarrays 1 sub
{
1 3 3 -1 roll add/index cvx
c1/get cvx/sub cvx/mul cvx
}for
/sub cvx
numarrays 1 add 1/roll cvx
}for
numarrays[/pop cvx]cvx/repeat cvx
end
}def
/exec_tint_transform
{
/TintProc[
/TintTransform cvx/setcolor cvx
]cvx bdf
MappedCSA setcolorspace_opt
}bdf
/devn_makecustomcolor
{
2 dict begin
/names_index xdf
/Names xdf
1 1 1 1 Names names_index get findcmykcustomcolor
/devicen_tints AGMCORE_gget names_index get setcustomcolor
Names length{pop}repeat
end
}bdf
/setdevicencolorspace
{
dup/AliasedColorants known{false}{true}ifelse
current_spot_alias and{
7 dict begin
/names_index 0 def
dup/names_len exch/Names get length def
/new_names names_len array def
/new_LookupTables names_len array def
/alias_cnt 0 def
dup/Names get
{
dup map_alias{
exch pop
dup/ColorLookup known{
dup begin
new_LookupTables names_index ColorLookup put
end
}{
dup/Components known{
dup begin
new_LookupTables names_index Components put
end
}{
dup begin
new_LookupTables names_index[null null null null]put
end
}ifelse
}ifelse
new_names names_index 3 -1 roll/Name get put
/alias_cnt alias_cnt 1 add def
}{
/name xdf
new_names names_index name put
dup/LookupTables known{
dup begin
new_LookupTables names_index LookupTables names_index get put
end
}{
dup begin
new_LookupTables names_index[null null null null]put
end
}ifelse
}ifelse
/names_index names_index 1 add def
}forall
alias_cnt 0 gt{
/AliasedColorants true def
/lut_entry_len new_LookupTables 0 get dup length 256 ge{0 get length}{length}ifelse def
0 1 names_len 1 sub{
/names_index xdf
new_LookupTables names_index get dup length 256 ge{0 get length}{length}ifelse lut_entry_len ne{
/AliasedColorants false def
exit
}{
new_LookupTables names_index get 0 get null eq{
dup/Names get names_index get/name xdf
name(Cyan)eq name(Magenta)eq name(Yellow)eq name(Black)eq
or or or not{
/AliasedColorants false def
exit
}if
}if
}ifelse
}for
lut_entry_len 1 eq{
/AliasedColorants false def
}if
AliasedColorants{
dup begin
/Names new_names def
/LookupTables new_LookupTables def
/AliasedColorants true def
/NComponents lut_entry_len def
/TintMethod NComponents 4 eq{/Subtractive}{/Additive}ifelse def
/MappedCSA TintMethod/Additive eq{/DeviceRGB}{/DeviceCMYK}ifelse def
currentdict/TTTablesIdx known not{
/TTTablesIdx -1 def
}if
end
}if
}if
end
}if
dup/devicen_colorspace_dict exch AGMCORE_gput
begin
currentdict/AliasedColorants known{
AliasedColorants
}{
false
}ifelse
dup not{
CSA map_csa
}if
/TintTransform load type/nulltype eq or{
/TintTransform[
0 1 Names length 1 sub
{
/TTTablesIdx TTTablesIdx 1 add def
dup LookupTables exch get dup 0 get null eq
{
1 index
Names exch get
dup(Cyan)eq
{
pop exch
LookupTables length exch sub
/index cvx
0 0 0
}
{
dup(Magenta)eq
{
pop exch
LookupTables length exch sub
/index cvx
0/exch cvx 0 0
}{
(Yellow)eq
{
exch
LookupTables length exch sub
/index cvx
0 0 3 -1/roll cvx 0
}{
exch
LookupTables length exch sub
/index cvx
0 0 0 4 -1/roll cvx
}ifelse
}ifelse
}ifelse
5 -1/roll cvx/astore cvx
}{
dup length 1 sub
LookupTables length 4 -1 roll sub 1 add
/index cvx/mul cvx/round cvx/cvi cvx/get cvx
}ifelse
Names length TTTablesIdx add 1 add 1/roll cvx
}for
Names length[/pop cvx]cvx/repeat cvx
NComponents Names length
TintMethod/Subtractive eq
{
subtractive_blend
}{
additive_blend
}ifelse
]cvx bdf
}if
AGMCORE_host_sep{
Names convert_to_process{
exec_tint_transform
}
{
currentdict/AliasedColorants known{
AliasedColorants not
}{
false
}ifelse
5 dict begin
/AvoidAliasedColorants xdf
/painted? false def
/names_index 0 def
/names_len Names length def
AvoidAliasedColorants{
/currentspotalias current_spot_alias def
false set_spot_alias
}if
Names{
AGMCORE_is_cmyk_sep{
dup(Cyan)eq AGMCORE_cyan_plate and exch
dup(Magenta)eq AGMCORE_magenta_plate and exch
dup(Yellow)eq AGMCORE_yellow_plate and exch
(Black)eq AGMCORE_black_plate and or or or{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
Names names_index/devn_makecustomcolor cvx
]cvx ddf
/painted? true def
}if
painted?{exit}if
}{
0 0 0 0 5 -1 roll findcmykcustomcolor 1 setcustomcolor currentgray 0 eq{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
Names names_index/devn_makecustomcolor cvx
]cvx ddf
/painted? true def
exit
}if
}ifelse
/names_index names_index 1 add def
}forall
AvoidAliasedColorants{
currentspotalias set_spot_alias
}if
painted?{
/devicen_colorspace_dict AGMCORE_gget/names_index names_index put
}{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
names_len[/pop cvx]cvx/repeat cvx 1/setseparationgray cvx
0 0 0 0/setcmykcolor cvx
]cvx ddf
}ifelse
end
}ifelse
}
{
AGMCORE_in_rip_sep{
Names convert_to_process not
}{
level3
}ifelse
{
[/DeviceN Names MappedCSA/TintTransform load]setcolorspace_opt
/TintProc level3 not AGMCORE_in_rip_sep and{
[
Names/length cvx[/pop cvx]cvx/repeat cvx
]cvx bdf
}{
{setcolor}bdf
}ifelse
}{
exec_tint_transform
}ifelse
}ifelse
set_crd
/AliasedColorants false def
end
}def
/setindexedcolorspace
{
dup/indexed_colorspace_dict exch AGMCORE_gput
begin
currentdict/CSDBase known{
CSDBase/CSD get_res begin
currentdict/Names known{
currentdict devncs
}{
1 currentdict sepcs
}ifelse
AGMCORE_host_sep{
4 dict begin
/compCnt/Names where{pop Names length}{1}ifelse def
/NewLookup HiVal 1 add string def
0 1 HiVal{
/tableIndex xdf
Lookup dup type/stringtype eq{
compCnt tableIndex map_index
}{
exec
}ifelse
/Names where{
pop setdevicencolor
}{
setsepcolor
}ifelse
currentgray
tableIndex exch
255 mul cvi
NewLookup 3 1 roll put
}for
[/Indexed currentcolorspace HiVal NewLookup]setcolorspace_opt
end
}{
level3
{
currentdict/Names known{
[/Indexed[/DeviceN Names MappedCSA/TintTransform load]HiVal Lookup]setcolorspace_opt
}{
[/Indexed[/Separation Name MappedCSA sep_proc_name load]HiVal Lookup]setcolorspace_opt
}ifelse
}{
[/Indexed MappedCSA HiVal
[
currentdict/Names known{
Lookup dup type/stringtype eq
{/exch cvx CSDBase/CSD get_res/Names get length dup/mul cvx exch/getinterval cvx{255 div}/forall cvx}
{/exec cvx}ifelse
/TintTransform load/exec cvx
}{
Lookup dup type/stringtype eq
{/exch cvx/get cvx 255/div cvx}
{/exec cvx}ifelse
CSDBase/CSD get_res/MappedCSA get sep_proc_name exch pop/load cvx/exec cvx
}ifelse
]cvx
]setcolorspace_opt
}ifelse
}ifelse
end
set_crd
}
{
CSA map_csa
AGMCORE_host_sep level2 not and{
0 0 0 0 setcmykcolor
}{
[/Indexed MappedCSA
level2 not has_color not and{
dup 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or{
pop[/DeviceGray]
}if
HiVal GrayLookup
}{
HiVal
currentdict/RangeArray known{
{
/indexed_colorspace_dict AGMCORE_gget begin
Lookup exch
dup HiVal gt{
pop HiVal
}if
NComponents mul NComponents getinterval{}forall
NComponents 1 sub -1 0{
RangeArray exch 2 mul 2 getinterval aload pop map255_to_range
NComponents 1 roll
}for
end
}bind
}{
Lookup
}ifelse
}ifelse
]setcolorspace_opt
set_crd
}ifelse
}ifelse
end
}def
/setindexedcolor
{
AGMCORE_host_sep{
/indexed_colorspace_dict AGMCORE_gget
begin
currentdict/CSDBase known{
CSDBase/CSD get_res begin
currentdict/Names known{
map_indexed_devn
devn
}
{
Lookup 1 3 -1 roll map_index
sep
}ifelse
end
}{
Lookup MappedCSA/DeviceCMYK eq{4}{1}ifelse 3 -1 roll
map_index
MappedCSA/DeviceCMYK eq{setcmykcolor}{setgray}ifelse
}ifelse
end
}{
level3 not AGMCORE_in_rip_sep and/indexed_colorspace_dict AGMCORE_gget/CSDBase known and{
/indexed_colorspace_dict AGMCORE_gget/CSDBase get/CSD get_res begin
map_indexed_devn
devn
end
}
{
setcolor
}ifelse
}ifelse
}def
/ignoreimagedata
{
currentoverprint not{
gsave
dup clonedict begin
1 setgray
/Decode[0 1]def
/DataSourcedef
/MultipleDataSources false def
/BitsPerComponent 8 def
currentdict end
systemdict/image gx
grestore
}if
consumeimagedata
}def
/add_res
{
dup/CSD eq{
pop
//Adobe_AGM_Core begin
/AGMCORE_CSD_cache load 3 1 roll put
end
}{
defineresource pop
}ifelse
}def
/del_res
{
{
aload pop exch
dup/CSD eq{
pop
{//Adobe_AGM_Core/AGMCORE_CSD_cache get exch undef}forall
}{
exch
{1 index undefineresource}forall
pop
}ifelse
}forall
}def
/get_res
{
dup/CSD eq{
pop
dup type dup/nametype eq exch/stringtype eq or{
AGMCORE_CSD_cache exch get
}if
}{
findresource
}ifelse
}def
/get_csa_by_name
{
dup type dup/nametype eq exch/stringtype eq or{
/CSA get_res
}if
}def
/paintproc_buf_init
{
/count get 0 0 put
}def
/paintproc_buf_next
{
dup/count get dup 0 get
dup 3 1 roll
1 add 0 xpt
get
}def
/cachepaintproc_compress
{
5 dict begin
currentfile exch 0 exch/SubFileDecode filter/ReadFilter exch def
/ppdict 20 dict def
/string_size 16000 def
/readbuffer string_size string def
currentglobal true setglobal
ppdict 1 array dup 0 1 put/count xpt
setglobal
/LZWFilter
{
exch
dup length 0 eq{
pop
}{
ppdict dup length 1 sub 3 -1 roll put
}ifelse
{string_size}{0}ifelse string
}/LZWEncode filter def
{
ReadFilter readbuffer readstring
exch LZWFilter exch writestring
not{exit}if
}loop
LZWFilter closefile
ppdict
end
}def
/cachepaintproc
{
2 dict begin
currentfile exch 0 exch/SubFileDecode filter/ReadFilter exch def
/ppdict 20 dict def
currentglobal true setglobal
ppdict 1 array dup 0 1 put/count xpt
setglobal
{
ReadFilter 16000 string readstring exch
ppdict dup length 1 sub 3 -1 roll put
not{exit}if
}loop
ppdict dup dup length 1 sub()put
end
}def
/make_pattern
{
exch clonedict exch
dup matrix currentmatrix matrix concatmatrix 0 0 3 2 roll itransform
exch 3 index/XStep get 1 index exch 2 copy div cvi mul sub sub
exch 3 index/YStep get 1 index exch 2 copy div cvi mul sub sub
matrix translate exch matrix concatmatrix
1 index begin
BBox 0 get XStep div cvi XStep mul/xshift exch neg def
BBox 1 get YStep div cvi YStep mul/yshift exch neg def
BBox 0 get xshift add
BBox 1 get yshift add
BBox 2 get xshift add
BBox 3 get yshift add
4 array astore
/BBox exch def
[xshift yshift/translate load null/exec load]dup
3/PaintProc load put cvx/PaintProc exch def
end
gsave 0 setgray
makepattern
grestore
}def
/set_pattern
{
dup/PatternType get 1 eq{
dup/PaintType get 1 eq{
currentoverprint sop[/DeviceGray]setcolorspace 0 setgray
}if
}if
setpattern
}def
/setcolorspace_opt
{
dup currentcolorspace eq{pop}{setcolorspace}ifelse
}def
/updatecolorrendering
{
currentcolorrendering/RenderingIntent known{
currentcolorrendering/RenderingIntent get
}
{
Intent/AbsoluteColorimetric eq
{
/absolute_colorimetric_crd AGMCORE_gget dup null eq
}
{
Intent/RelativeColorimetric eq
{
/relative_colorimetric_crd AGMCORE_gget dup null eq
}
{
Intent/Saturation eq
{
/saturation_crd AGMCORE_gget dup null eq
}
{
/perceptual_crd AGMCORE_gget dup null eq
}ifelse
}ifelse
}ifelse
{
pop null
}
{
/RenderingIntent known{null}{Intent}ifelse
}ifelse
}ifelse
Intent ne{
Intent/ColorRendering{findresource}stopped
{
pop pop systemdict/findcolorrendering known
{
Intent findcolorrendering
{
/ColorRendering findresource true exch
}
{
/ColorRendering findresource
product(Xerox Phaser 5400)ne
exch
}ifelse
dup Intent/AbsoluteColorimetric eq
{
/absolute_colorimetric_crd exch AGMCORE_gput
}
{
Intent/RelativeColorimetric eq
{
/relative_colorimetric_crd exch AGMCORE_gput
}
{
Intent/Saturation eq
{
/saturation_crd exch AGMCORE_gput
}
{
Intent/Perceptual eq
{
/perceptual_crd exch AGMCORE_gput
}
{
pop
}ifelse
}ifelse
}ifelse
}ifelse
1 index{exch}{pop}ifelse
}
{false}ifelse
}
{true}ifelse
{
dup begin
currentdict/TransformPQR known{
currentdict/TransformPQR get aload pop
3{{}eq 3 1 roll}repeat or or
}
{true}ifelse
currentdict/MatrixPQR known{
currentdict/MatrixPQR get aload pop
1.0 eq 9 1 roll 0.0 eq 9 1 roll 0.0 eq 9 1 roll
0.0 eq 9 1 roll 1.0 eq 9 1 roll 0.0 eq 9 1 roll
0.0 eq 9 1 roll 0.0 eq 9 1 roll 1.0 eq
and and and and and and and and
}
{true}ifelse
end
or
{
clonedict begin
/TransformPQR[
{4 -1 roll 3 get dup 3 1 roll sub 5 -1 roll 3 get 3 -1 roll sub div
3 -1 roll 3 get 3 -1 roll 3 get dup 4 1 roll sub mul add}bind
{4 -1 roll 4 get dup 3 1 roll sub 5 -1 roll 4 get 3 -1 roll sub div
3 -1 roll 4 get 3 -1 roll 4 get dup 4 1 roll sub mul add}bind
{4 -1 roll 5 get dup 3 1 roll sub 5 -1 roll 5 get 3 -1 roll sub div
3 -1 roll 5 get 3 -1 roll 5 get dup 4 1 roll sub mul add}bind
]def
/MatrixPQR[0.8951 -0.7502 0.0389 0.2664 1.7135 -0.0685 -0.1614 0.0367 1.0296]def
/RangePQR[-0.3227950745 2.3229645538 -1.5003771057 3.5003465881 -0.1369979095 2.136967392]def
currentdict end
}if
setcolorrendering_opt
}if
}if
}def
/set_crd
{
AGMCORE_host_sep not level2 and{
currentdict/ColorRendering known{
ColorRendering/ColorRendering{findresource}stopped not{setcolorrendering_opt}if
}{
currentdict/Intent known{
updatecolorrendering
}if
}ifelse
currentcolorspace dup type/arraytype eq
{0 get}if
/DeviceRGB eq
{
currentdict/UCR known
{/UCR}{/AGMCORE_currentucr}ifelse
load setundercolorremoval
currentdict/BG known
{/BG}{/AGMCORE_currentbg}ifelse
load setblackgeneration
}if
}if
}def
/set_ucrbg
{
dup null eq{pop/AGMCORE_currentbg load}{/Procedure get_res}ifelse setblackgeneration
dup null eq{pop/AGMCORE_currentucr load}{/Procedure get_res}ifelse setundercolorremoval
}def
/setcolorrendering_opt
{
dup currentcolorrendering eq{
pop
}{
clonedict
begin
/Intent Intent def
currentdict
end
setcolorrendering
}ifelse
}def
/cpaint_gcomp
{
convert_to_process//Adobe_AGM_Core/AGMCORE_ConvertToProcess xddf
//Adobe_AGM_Core/AGMCORE_ConvertToProcess get not
{
(%end_cpaint_gcomp)flushinput
}if
}def
/cpaint_gsep
{
//Adobe_AGM_Core/AGMCORE_ConvertToProcess get
{
(%end_cpaint_gsep)flushinput
}if
}def
/cpaint_gend
{np}def
/T1_path
{
currentfile token pop currentfile token pop mo
{
currentfile token pop dup type/stringtype eq
{pop exit}if
0 exch rlineto
currentfile token pop dup type/stringtype eq
{pop exit}if
0 rlineto
}loop
}def
/T1_gsave
level3
{/clipsave}
{/gsave}ifelse
load def
/T1_grestore
level3
{/cliprestore}
{/grestore}ifelse
load def
/set_spot_alias_ary
{
dup inherit_aliases
//Adobe_AGM_Core/AGMCORE_SpotAliasAry xddf
}def
/set_spot_normalization_ary
{
dup inherit_aliases
dup length
/AGMCORE_SpotAliasAry where{pop AGMCORE_SpotAliasAry length add}if
array
//Adobe_AGM_Core/AGMCORE_SpotAliasAry2 xddf
/AGMCORE_SpotAliasAry where{
pop
AGMCORE_SpotAliasAry2 0 AGMCORE_SpotAliasAry putinterval
AGMCORE_SpotAliasAry length
}{0}ifelse
AGMCORE_SpotAliasAry2 3 1 roll exch putinterval
true set_spot_alias
}def
/inherit_aliases
{
{dup/Name get map_alias{/CSD put}{pop}ifelse}forall
}def
/set_spot_alias
{
/AGMCORE_SpotAliasAry2 where{
/AGMCORE_current_spot_alias 3 -1 roll put
}{
pop
}ifelse
}def
/current_spot_alias
{
/AGMCORE_SpotAliasAry2 where{
/AGMCORE_current_spot_alias get
}{
false
}ifelse
}def
/map_alias
{
/AGMCORE_SpotAliasAry2 where{
begin
/AGMCORE_name xdf
false
AGMCORE_SpotAliasAry2{
dup/Name get AGMCORE_name eq{
/CSD get/CSD get_res
exch pop true
exit
}{
pop
}ifelse
}forall
end
}{
pop false
}ifelse
}bdf
/spot_alias
{
true set_spot_alias
/AGMCORE_&setcustomcolor AGMCORE_key_known not{
//Adobe_AGM_Core/AGMCORE_&setcustomcolor/setcustomcolor load put
}if
/customcolor_tint 1 AGMCORE_gput
//Adobe_AGM_Core begin
/setcustomcolor
{
//Adobe_AGM_Core begin
dup/customcolor_tint exch AGMCORE_gput
1 index aload pop pop 1 eq exch 1 eq and exch 1 eq and exch 1 eq and not
current_spot_alias and{1 index 4 get map_alias}{false}ifelse
{
false set_spot_alias
/sep_colorspace_dict AGMCORE_gget null ne
3 1 roll 2 index{
exch pop/sep_tint AGMCORE_gget exch
}if
mark 3 1 roll
setsepcolorspace
counttomark 0 ne{
setsepcolor
}if
pop
not{/sep_tint 1.0 AGMCORE_gput}if
pop
true set_spot_alias
}{
AGMCORE_&setcustomcolor
}ifelse
end
}bdf
end
}def
/begin_feature
{
Adobe_AGM_Core/AGMCORE_feature_dictCount countdictstack put
count Adobe_AGM_Core/AGMCORE_feature_opCount 3 -1 roll put
{Adobe_AGM_Core/AGMCORE_feature_ctm matrix currentmatrix put}if
}def
/end_feature
{
2 dict begin
/spd/setpagedevice load def
/setpagedevice{get_gstate spd set_gstate}def
stopped{$error/newerror false put}if
end
count Adobe_AGM_Core/AGMCORE_feature_opCount get sub dup 0 gt{{pop}repeat}{pop}ifelse
countdictstack Adobe_AGM_Core/AGMCORE_feature_dictCount get sub dup 0 gt{{end}repeat}{pop}ifelse
{Adobe_AGM_Core/AGMCORE_feature_ctm get setmatrix}if
}def
/set_negative
{
//Adobe_AGM_Core begin
/AGMCORE_inverting exch def
level2{
currentpagedevice/NegativePrint known AGMCORE_distilling not and{
currentpagedevice/NegativePrint get//Adobe_AGM_Core/AGMCORE_inverting get ne{
true begin_feature true{
<>setpagedevice
}end_feature
}if
/AGMCORE_inverting false def
}if
}if
AGMCORE_inverting{
[{1 exch sub}/exec load dup currenttransfer exch]cvx bind settransfer
AGMCORE_distilling{
erasepage
}{
gsave np clippath 1/setseparationgray where{pop setseparationgray}{setgray}ifelse
/AGMIRS_&fill where{pop AGMIRS_&fill}{fill}ifelse grestore
}ifelse
}if
end
}def
/lw_save_restore_override{
/md where{
pop
md begin
initializepage
/initializepage{}def
/pmSVsetup{}def
/endp{}def
/pse{}def
/psb{}def
/orig_showpage where
{pop}
{/orig_showpage/showpage load def}
ifelse
/showpage{orig_showpage gR}def
end
}if
}def
/pscript_showpage_override{
/NTPSOct95 where
{
begin
showpage
save
/showpage/restore load def
/restore{exch pop}def
end
}if
}def
/driver_media_override
{
/md where{
pop
md/initializepage known{
md/initializepage{}put
}if
md/rC known{
md/rC{4{pop}repeat}put
}if
}if
/mysetup where{
/mysetup[1 0 0 1 0 0]put
}if
Adobe_AGM_Core/AGMCORE_Default_CTM matrix currentmatrix put
level2
{Adobe_AGM_Core/AGMCORE_Default_PageSize currentpagedevice/PageSize get put}if
}def
/driver_check_media_override
{
/PrepsDict where
{pop}
{
Adobe_AGM_Core/AGMCORE_Default_CTM get matrix currentmatrix ne
Adobe_AGM_Core/AGMCORE_Default_PageSize get type/arraytype eq
{
Adobe_AGM_Core/AGMCORE_Default_PageSize get 0 get currentpagedevice/PageSize get 0 get eq and
Adobe_AGM_Core/AGMCORE_Default_PageSize get 1 get currentpagedevice/PageSize get 1 get eq and
}if
{
Adobe_AGM_Core/AGMCORE_Default_CTM get setmatrix
}if
}ifelse
}def
AGMCORE_err_strings begin
/AGMCORE_bad_environ(Environment not satisfactory for this job. Ensure that the PPD is correct or that the PostScript level requested is supported by this printer. )def
/AGMCORE_color_space_onhost_seps(This job contains colors that will not separate with on-host methods. )def
/AGMCORE_invalid_color_space(This job contains an invalid color space. )def
end
/set_def_ht
{AGMCORE_def_ht sethalftone}def
/set_def_flat
{AGMCORE_Default_flatness setflat}def
end
systemdict/setpacking known
{setpacking}if
%%EndResource
%%BeginResource: procset Adobe_CoolType_Core 2.31 0
%%Copyright: Copyright 1997-2006 Adobe Systems Incorporated. All Rights Reserved.
%%Version: 2.31 0
10 dict begin
/Adobe_CoolType_Passthru currentdict def
/Adobe_CoolType_Core_Defined userdict/Adobe_CoolType_Core known def
Adobe_CoolType_Core_Defined
{/Adobe_CoolType_Core userdict/Adobe_CoolType_Core get def}
if
userdict/Adobe_CoolType_Core 70 dict dup begin put
/Adobe_CoolType_Version 2.31 def
/Level2?
systemdict/languagelevel known dup
{pop systemdict/languagelevel get 2 ge}
if def
Level2? not
{
/currentglobal false def
/setglobal/pop load def
/gcheck{pop false}bind def
/currentpacking false def
/setpacking/pop load def
/SharedFontDirectory 0 dict def
}
if
currentpacking
true setpacking
currentglobal false setglobal
userdict/Adobe_CoolType_Data 2 copy known not
{2 copy 10 dict put}
if
get
begin
/@opStackCountByLevel 32 dict def
/@opStackLevel 0 def
/@dictStackCountByLevel 32 dict def
/@dictStackLevel 0 def
end
setglobal
currentglobal true setglobal
userdict/Adobe_CoolType_GVMFonts known not
{userdict/Adobe_CoolType_GVMFonts 10 dict put}
if
setglobal
currentglobal false setglobal
userdict/Adobe_CoolType_LVMFonts known not
{userdict/Adobe_CoolType_LVMFonts 10 dict put}
if
setglobal
/ct_VMDictPut
{
dup gcheck{Adobe_CoolType_GVMFonts}{Adobe_CoolType_LVMFonts}ifelse
3 1 roll put
}bind def
/ct_VMDictUndef
{
dup Adobe_CoolType_GVMFonts exch known
{Adobe_CoolType_GVMFonts exch undef}
{
dup Adobe_CoolType_LVMFonts exch known
{Adobe_CoolType_LVMFonts exch undef}
{pop}
ifelse
}ifelse
}bind def
/ct_str1 1 string def
/ct_xshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
_ct_x _ct_y moveto
0
rmoveto
}
ifelse
/_ct_i _ct_i 1 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/ct_yshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
_ct_x _ct_y moveto
0 exch
rmoveto
}
ifelse
/_ct_i _ct_i 1 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/ct_xyshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
{_ct_na _ct_i 1 add get}stopped
{pop pop pop}
{
_ct_x _ct_y moveto
rmoveto
}
ifelse
}
ifelse
/_ct_i _ct_i 2 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/xsh{{@xshow}stopped{Adobe_CoolType_Data begin ct_xshow end}if}bind def
/ysh{{@yshow}stopped{Adobe_CoolType_Data begin ct_yshow end}if}bind def
/xysh{{@xyshow}stopped{Adobe_CoolType_Data begin ct_xyshow end}if}bind def
currentglobal true setglobal
/ct_T3Defs
{
/BuildChar
{
1 index/Encoding get exch get
1 index/BuildGlyph get exec
}bind def
/BuildGlyph
{
exch begin
GlyphProcs exch get exec
end
}bind def
}bind def
setglobal
/@_SaveStackLevels
{
Adobe_CoolType_Data
begin
/@vmState currentglobal def false setglobal
@opStackCountByLevel
@opStackLevel
2 copy known not
{
2 copy
3 dict dup/args
7 index
5 add array put
put get
}
{
get dup/args get dup length 3 index lt
{
dup length 5 add array exch
1 index exch 0 exch putinterval
1 index exch/args exch put
}
{pop}
ifelse
}
ifelse
begin
count 1 sub
1 index lt
{pop count}
if
dup/argCount exch def
dup 0 gt
{
args exch 0 exch getinterval
astore pop
}
{pop}
ifelse
count
/restCount exch def
end
/@opStackLevel @opStackLevel 1 add def
countdictstack 1 sub
@dictStackCountByLevel exch @dictStackLevel exch put
/@dictStackLevel @dictStackLevel 1 add def
@vmState setglobal
end
}bind def
/@_RestoreStackLevels
{
Adobe_CoolType_Data
begin
/@opStackLevel @opStackLevel 1 sub def
@opStackCountByLevel @opStackLevel get
begin
count restCount sub dup 0 gt
{{pop}repeat}
{pop}
ifelse
args 0 argCount getinterval{}forall
end
/@dictStackLevel @dictStackLevel 1 sub def
@dictStackCountByLevel @dictStackLevel get
end
countdictstack exch sub dup 0 gt
{{end}repeat}
{pop}
ifelse
}bind def
/@_PopStackLevels
{
Adobe_CoolType_Data
begin
/@opStackLevel @opStackLevel 1 sub def
/@dictStackLevel @dictStackLevel 1 sub def
end
}bind def
/@Raise
{
exch cvx exch errordict exch get exec
stop
}bind def
/@ReRaise
{
cvx $error/errorname get errordict exch get exec
stop
}bind def
/@Stopped
{
0 @#Stopped
}bind def
/@#Stopped
{
@_SaveStackLevels
stopped
{@_RestoreStackLevels true}
{@_PopStackLevels false}
ifelse
}bind def
/@Arg
{
Adobe_CoolType_Data
begin
@opStackCountByLevel @opStackLevel 1 sub get
begin
args exch
argCount 1 sub exch sub get
end
end
}bind def
currentglobal true setglobal
/CTHasResourceForAllBug
Level2?
{
1 dict dup
/@shouldNotDisappearDictValue true def
Adobe_CoolType_Data exch/@shouldNotDisappearDict exch put
begin
count @_SaveStackLevels
{(*){pop stop}128 string/Category resourceforall}
stopped pop
@_RestoreStackLevels
currentdict Adobe_CoolType_Data/@shouldNotDisappearDict get dup 3 1 roll ne dup 3 1 roll
{
/@shouldNotDisappearDictValue known
{
{
end
currentdict 1 index eq
{pop exit}
if
}
loop
}
if
}
{
pop
end
}
ifelse
}
{false}
ifelse
def
true setglobal
/CTHasResourceStatusBug
Level2?
{
mark
{/steveamerige/Category resourcestatus}
stopped
{cleartomark true}
{cleartomark currentglobal not}
ifelse
}
{false}
ifelse
def
setglobal
/CTResourceStatus
{
mark 3 1 roll
/Category findresource
begin
({ResourceStatus}stopped)0()/SubFileDecode filter cvx exec
{cleartomark false}
{{3 2 roll pop true}{cleartomark false}ifelse}
ifelse
end
}bind def
/CTWorkAroundBugs
{
Level2?
{
/cid_PreLoad/ProcSet resourcestatus
{
pop pop
currentglobal
mark
{
(*)
{
dup/CMap CTHasResourceStatusBug
{CTResourceStatus}
{resourcestatus}
ifelse
{
pop dup 0 eq exch 1 eq or
{
dup/CMap findresource gcheck setglobal
/CMap undefineresource
}
{
pop CTHasResourceForAllBug
{exit}
{stop}
ifelse
}
ifelse
}
{pop}
ifelse
}
128 string/CMap resourceforall
}
stopped
{cleartomark}
stopped pop
setglobal
}
if
}
if
}bind def
/ds
{
Adobe_CoolType_Core
begin
CTWorkAroundBugs
/mo/moveto load def
/nf/newencodedfont load def
/msf{makefont setfont}bind def
/uf{dup undefinefont ct_VMDictUndef}bind def
/ur/undefineresource load def
/chp/charpath load def
/awsh/awidthshow load def
/wsh/widthshow load def
/ash/ashow load def
/@xshow/xshow load def
/@yshow/yshow load def
/@xyshow/xyshow load def
/@cshow/cshow load def
/sh/show load def
/rp/repeat load def
/.n/.notdef def
end
currentglobal false setglobal
userdict/Adobe_CoolType_Data 2 copy known not
{2 copy 10 dict put}
if
get
begin
/AddWidths? false def
/CC 0 def
/charcode 2 string def
/@opStackCountByLevel 32 dict def
/@opStackLevel 0 def
/@dictStackCountByLevel 32 dict def
/@dictStackLevel 0 def
/InVMFontsByCMap 10 dict def
/InVMDeepCopiedFonts 10 dict def
end
setglobal
}bind def
/dt
{
currentdict Adobe_CoolType_Core eq
{end}
if
}bind def
/ps
{
Adobe_CoolType_Core begin
Adobe_CoolType_GVMFonts begin
Adobe_CoolType_LVMFonts begin
SharedFontDirectory begin
}bind def
/pt
{
end
end
end
end
}bind def
/unload
{
systemdict/languagelevel known
{
systemdict/languagelevel get 2 ge
{
userdict/Adobe_CoolType_Core 2 copy known
{undef}
{pop pop}
ifelse
}
if
}
if
}bind def
/ndf
{
1 index where
{pop pop pop}
{dup xcheck{bind}if def}
ifelse
}def
/findfont systemdict
begin
userdict
begin
/globaldict where{/globaldict get begin}if
dup where pop exch get
/globaldict where{pop end}if
end
end
Adobe_CoolType_Core_Defined
{/systemfindfont exch def}
{
/findfont 1 index def
/systemfindfont exch def
}
ifelse
/undefinefont
{pop}ndf
/copyfont
{
currentglobal 3 1 roll
1 index gcheck setglobal
dup null eq{0}{dup length}ifelse
2 index length add 1 add dict
begin
exch
{
1 index/FID eq
{pop pop}
{def}
ifelse
}
forall
dup null eq
{pop}
{{def}forall}
ifelse
currentdict
end
exch setglobal
}bind def
/copyarray
{
currentglobal exch
dup gcheck setglobal
dup length array copy
exch setglobal
}bind def
/newencodedfont
{
currentglobal
{
SharedFontDirectory 3 index known
{SharedFontDirectory 3 index get/FontReferenced known}
{false}
ifelse
}
{
FontDirectory 3 index known
{FontDirectory 3 index get/FontReferenced known}
{
SharedFontDirectory 3 index known
{SharedFontDirectory 3 index get/FontReferenced known}
{false}
ifelse
}
ifelse
}
ifelse
dup
{
3 index findfont/FontReferenced get
2 index dup type/nametype eq
{findfont}
if ne
{pop false}
if
}
if
dup
{
1 index dup type/nametype eq
{findfont}
if
dup/CharStrings known
{
/CharStrings get length
4 index findfont/CharStrings get length
ne
{
pop false
}
if
}
{pop}
ifelse
}
if
{
pop
1 index findfont
/Encoding get exch
0 1 255
{2 copy get 3 index 3 1 roll put}
for
pop pop pop
}
{
currentglobal
4 1 roll
dup type/nametype eq
{findfont}
if
dup gcheck setglobal
dup dup maxlength 2 add dict
begin
exch
{
1 index/FID ne
2 index/Encoding ne and
{def}
{pop pop}
ifelse
}
forall
/FontReferenced exch def
/Encoding exch dup length array copy def
/FontName 1 index dup type/stringtype eq{cvn}if def dup
currentdict
end
definefont ct_VMDictPut
setglobal
}
ifelse
}bind def
/SetSubstituteStrategy
{
$SubstituteFont
begin
dup type/dicttype ne
{0 dict}
if
currentdict/$Strategies known
{
exch $Strategies exch
2 copy known
{
get
2 copy maxlength exch maxlength add dict
begin
{def}forall
{def}forall
currentdict
dup/$Init known
{dup/$Init get exec}
if
end
/$Strategy exch def
}
{pop pop pop}
ifelse
}
{pop pop}
ifelse
end
}bind def
/scff
{
$SubstituteFont
begin
dup type/stringtype eq
{dup length exch}
{null}
ifelse
/$sname exch def
/$slen exch def
/$inVMIndex
$sname null eq
{
1 index $str cvs
dup length $slen sub $slen getinterval cvn
}
{$sname}
ifelse def
end
{findfont}
@Stopped
{
dup length 8 add string exch
1 index 0(BadFont:)putinterval
1 index exch 8 exch dup length string cvs putinterval cvn
{findfont}
@Stopped
{pop/Courier findfont}
if
}
if
$SubstituteFont
begin
/$sname null def
/$slen 0 def
/$inVMIndex null def
end
}bind def
/isWidthsOnlyFont
{
dup/WidthsOnly known
{pop pop true}
{
dup/FDepVector known
{/FDepVector get{isWidthsOnlyFont dup{exit}if}forall}
{
dup/FDArray known
{/FDArray get{isWidthsOnlyFont dup{exit}if}forall}
{pop}
ifelse
}
ifelse
}
ifelse
}bind def
/ct_StyleDicts 4 dict dup begin
/Adobe-Japan1 4 dict dup begin
Level2?
{
/Serif
/HeiseiMin-W3-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiMin-W3}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiMin-W3/CIDFont resourcestatus
{pop pop/HeiseiMin-W3}
{/Ryumin-Light}
ifelse
}
{/Ryumin-Light}
ifelse
}
ifelse
def
/SansSerif
/HeiseiKakuGo-W5-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiKakuGo-W5}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiKakuGo-W5/CIDFont resourcestatus
{pop pop/HeiseiKakuGo-W5}
{/GothicBBB-Medium}
ifelse
}
{/GothicBBB-Medium}
ifelse
}
ifelse
def
/HeiseiMaruGo-W4-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiMaruGo-W4}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiMaruGo-W4/CIDFont resourcestatus
{pop pop/HeiseiMaruGo-W4}
{
/Jun101-Light-RKSJ-H/Font resourcestatus
{pop pop/Jun101-Light}
{SansSerif}
ifelse
}
ifelse
}
{
/Jun101-Light-RKSJ-H/Font resourcestatus
{pop pop/Jun101-Light}
{SansSerif}
ifelse
}
ifelse
}
ifelse
/RoundSansSerif exch def
/Default Serif def
}
{
/Serif/Ryumin-Light def
/SansSerif/GothicBBB-Medium def
{
(fonts/Jun101-Light-83pv-RKSJ-H)status
}stopped
{pop}{
{pop pop pop pop/Jun101-Light}
{SansSerif}
ifelse
/RoundSansSerif exch def
}ifelse
/Default Serif def
}
ifelse
end
def
/Adobe-Korea1 4 dict dup begin
/Serif/HYSMyeongJo-Medium def
/SansSerif/HYGoThic-Medium def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
/Adobe-GB1 4 dict dup begin
/Serif/STSong-Light def
/SansSerif/STHeiti-Regular def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
/Adobe-CNS1 4 dict dup begin
/Serif/MKai-Medium def
/SansSerif/MHei-Medium def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
end
def
Level2?{currentglobal true setglobal}if
/ct_BoldRomanWidthProc
{
stringwidth 1 index 0 ne{exch .03 add exch}if setcharwidth
0 0
}bind def
/ct_Type0WidthProc
{
dup stringwidth 0 0 moveto
2 index true charpath pathbbox
0 -1
7 index 2 div .88
setcachedevice2
pop
0 0
}bind def
/ct_Type0WMode1WidthProc
{
dup stringwidth
pop 2 div neg -0.88
2 copy
moveto
0 -1
5 -1 roll true charpath pathbbox
setcachedevice
}bind def
/cHexEncoding
[/c00/c01/c02/c03/c04/c05/c06/c07/c08/c09/c0A/c0B/c0C/c0D/c0E/c0F/c10/c11/c12
/c13/c14/c15/c16/c17/c18/c19/c1A/c1B/c1C/c1D/c1E/c1F/c20/c21/c22/c23/c24/c25
/c26/c27/c28/c29/c2A/c2B/c2C/c2D/c2E/c2F/c30/c31/c32/c33/c34/c35/c36/c37/c38
/c39/c3A/c3B/c3C/c3D/c3E/c3F/c40/c41/c42/c43/c44/c45/c46/c47/c48/c49/c4A/c4B
/c4C/c4D/c4E/c4F/c50/c51/c52/c53/c54/c55/c56/c57/c58/c59/c5A/c5B/c5C/c5D/c5E
/c5F/c60/c61/c62/c63/c64/c65/c66/c67/c68/c69/c6A/c6B/c6C/c6D/c6E/c6F/c70/c71
/c72/c73/c74/c75/c76/c77/c78/c79/c7A/c7B/c7C/c7D/c7E/c7F/c80/c81/c82/c83/c84
/c85/c86/c87/c88/c89/c8A/c8B/c8C/c8D/c8E/c8F/c90/c91/c92/c93/c94/c95/c96/c97
/c98/c99/c9A/c9B/c9C/c9D/c9E/c9F/cA0/cA1/cA2/cA3/cA4/cA5/cA6/cA7/cA8/cA9/cAA
/cAB/cAC/cAD/cAE/cAF/cB0/cB1/cB2/cB3/cB4/cB5/cB6/cB7/cB8/cB9/cBA/cBB/cBC/cBD
/cBE/cBF/cC0/cC1/cC2/cC3/cC4/cC5/cC6/cC7/cC8/cC9/cCA/cCB/cCC/cCD/cCE/cCF/cD0
/cD1/cD2/cD3/cD4/cD5/cD6/cD7/cD8/cD9/cDA/cDB/cDC/cDD/cDE/cDF/cE0/cE1/cE2/cE3
/cE4/cE5/cE6/cE7/cE8/cE9/cEA/cEB/cEC/cED/cEE/cEF/cF0/cF1/cF2/cF3/cF4/cF5/cF6
/cF7/cF8/cF9/cFA/cFB/cFC/cFD/cFE/cFF]def
/ct_BoldBaseFont
11 dict begin
/FontType 3 def
/FontMatrix[1 0 0 1 0 0]def
/FontBBox[0 0 1 1]def
/Encoding cHexEncoding def
/_setwidthProc/ct_BoldRomanWidthProc load def
/_bcstr1 1 string def
/BuildChar
{
exch begin
_basefont setfont
_bcstr1 dup 0 4 -1 roll put
dup
_setwidthProc
3 copy
moveto
show
_basefonto setfont
moveto
show
end
}bind def
currentdict
end
def
systemdict/composefont known
{
/ct_DefineIdentity-H
{
/Identity-H/CMap resourcestatus
{
pop pop
}
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CIDSystemInfo 3 dict dup begin
/Registry(Adobe)def
/Ordering(Identity)def
/Supplement 0 def
end def
/CMapName/Identity-H def
/CMapVersion 1.000 def
/CMapType 1 def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
}
def
/ct_BoldBaseCIDFont
11 dict begin
/CIDFontType 1 def
/CIDFontName/ct_BoldBaseCIDFont def
/FontMatrix[1 0 0 1 0 0]def
/FontBBox[0 0 1 1]def
/_setwidthProc/ct_Type0WidthProc load def
/_bcstr2 2 string def
/BuildGlyph
{
exch begin
_basefont setfont
_bcstr2 1 2 index 256 mod put
_bcstr2 0 3 -1 roll 256 idiv put
_bcstr2 dup _setwidthProc
3 copy
moveto
show
_basefonto setfont
moveto
show
end
}bind def
currentdict
end
def
}if
Level2?{setglobal}if
/ct_CopyFont{
{
1 index/FID ne 2 index/UniqueID ne and
{def}{pop pop}ifelse
}forall
}bind def
/ct_Type0CopyFont
{
exch
dup length dict
begin
ct_CopyFont
[
exch
FDepVector
{
dup/FontType get 0 eq
{
1 index ct_Type0CopyFont
/_ctType0 exch definefont
}
{
/_ctBaseFont exch
2 index exec
}
ifelse
exch
}
forall
pop
]
/FDepVector exch def
currentdict
end
}bind def
/ct_MakeBoldFont
{
dup/ct_SyntheticBold known
{
dup length 3 add dict begin
ct_CopyFont
/ct_StrokeWidth .03 0 FontMatrix idtransform pop def
/ct_SyntheticBold true def
currentdict
end
definefont
}
{
dup dup length 3 add dict
begin
ct_CopyFont
/PaintType 2 def
/StrokeWidth .03 0 FontMatrix idtransform pop def
/dummybold currentdict
end
definefont
dup/FontType get dup 9 ge exch 11 le and
{
ct_BoldBaseCIDFont
dup length 3 add dict copy begin
dup/CIDSystemInfo get/CIDSystemInfo exch def
ct_DefineIdentity-H
/_Type0Identity/Identity-H 3 -1 roll[exch]composefont
/_basefont exch def
/_Type0Identity/Identity-H 3 -1 roll[exch]composefont
/_basefonto exch def
currentdict
end
/CIDFont defineresource
}
{
ct_BoldBaseFont
dup length 3 add dict copy begin
/_basefont exch def
/_basefonto exch def
currentdict
end
definefont
}
ifelse
}
ifelse
}bind def
/ct_MakeBold{
1 index
1 index
findfont
currentglobal 5 1 roll
dup gcheck setglobal
dup
/FontType get 0 eq
{
dup/WMode known{dup/WMode get 1 eq}{false}ifelse
version length 4 ge
and
{version 0 4 getinterval cvi 2015 ge}
{true}
ifelse
{/ct_Type0WidthProc}
{/ct_Type0WMode1WidthProc}
ifelse
ct_BoldBaseFont/_setwidthProc 3 -1 roll load put
{ct_MakeBoldFont}ct_Type0CopyFont definefont
}
{
dup/_fauxfont known not 1 index/SubstMaster known not and
{
ct_BoldBaseFont/_setwidthProc /ct_BoldRomanWidthProc load put
ct_MakeBoldFont
}
{
2 index 2 index eq
{exch pop }
{
dup length dict begin
ct_CopyFont
currentdict
end
definefont
}
ifelse
}
ifelse
}
ifelse
pop pop pop
setglobal
}bind def
/?str1 256 string def
/?set
{
$SubstituteFont
begin
/$substituteFound false def
/$fontname 1 index def
/$doSmartSub false def
end
dup
findfont
$SubstituteFont
begin
$substituteFound
{false}
{
dup/FontName known
{
dup/FontName get $fontname eq
1 index/DistillerFauxFont known not and
/currentdistillerparams where
{pop false 2 index isWidthsOnlyFont not and}
if
}
{false}
ifelse
}
ifelse
exch pop
/$doSmartSub true def
end
{
5 1 roll pop pop pop pop
findfont
}
{
1 index
findfont
dup/FontType get 3 eq
{
6 1 roll pop pop pop pop pop false
}
{pop true}
ifelse
{
$SubstituteFont
begin
pop pop
/$styleArray 1 index def
/$regOrdering 2 index def
pop pop
0 1 $styleArray length 1 sub
{
$styleArray exch get
ct_StyleDicts $regOrdering
2 copy known
{
get
exch 2 copy known not
{pop/Default}
if
get
dup type/nametype eq
{
?str1 cvs length dup 1 add exch
?str1 exch(-)putinterval
exch dup length exch ?str1 exch 3 index exch putinterval
add ?str1 exch 0 exch getinterval cvn
}
{
pop pop/Unknown
}
ifelse
}
{
pop pop pop pop/Unknown
}
ifelse
}
for
end
findfont
}if
}
ifelse
currentglobal false setglobal 3 1 roll
null copyfont definefont pop
setglobal
}bind def
setpacking
userdict/$SubstituteFont 25 dict put
1 dict
begin
/SubstituteFont
dup $error exch 2 copy known
{get}
{pop pop{pop/Courier}bind}
ifelse def
/currentdistillerparams where dup
{
pop pop
currentdistillerparams/CannotEmbedFontPolicy 2 copy known
{get/Error eq}
{pop pop false}
ifelse
}
if not
{
countdictstack array dictstack 0 get
begin
userdict
begin
$SubstituteFont
begin
/$str 128 string def
/$fontpat 128 string def
/$slen 0 def
/$sname null def
/$match false def
/$fontname null def
/$substituteFound false def
/$inVMIndex null def
/$doSmartSub true def
/$depth 0 def
/$fontname null def
/$italicangle 26.5 def
/$dstack null def
/$Strategies 10 dict dup
begin
/$Type3Underprint
{
currentglobal exch false setglobal
11 dict
begin
/UseFont exch
$WMode 0 ne
{
dup length dict copy
dup/WMode $WMode put
/UseFont exch definefont
}
if def
/FontName $fontname dup type/stringtype eq{cvn}if def
/FontType 3 def
/FontMatrix[.001 0 0 .001 0 0]def
/Encoding 256 array dup 0 1 255{/.notdef put dup}for pop def
/FontBBox[0 0 0 0]def
/CCInfo 7 dict dup
begin
/cc null def
/x 0 def
/y 0 def
end def
/BuildChar
{
exch
begin
CCInfo
begin
1 string dup 0 3 index put exch pop
/cc exch def
UseFont 1000 scalefont setfont
cc stringwidth/y exch def/x exch def
x y setcharwidth
$SubstituteFont/$Strategy get/$Underprint get exec
0 0 moveto cc show
x y moveto
end
end
}bind def
currentdict
end
exch setglobal
}bind def
/$GetaTint
2 dict dup
begin
/$BuildFont
{
dup/WMode known
{dup/WMode get}
{0}
ifelse
/$WMode exch def
$fontname exch
dup/FontName known
{
dup/FontName get
dup type/stringtype eq{cvn}if
}
{/unnamedfont}
ifelse
exch
Adobe_CoolType_Data/InVMDeepCopiedFonts get
1 index/FontName get known
{
pop
Adobe_CoolType_Data/InVMDeepCopiedFonts get
1 index get
null copyfont
}
{$deepcopyfont}
ifelse
exch 1 index exch/FontBasedOn exch put
dup/FontName $fontname dup type/stringtype eq{cvn}if put
definefont
Adobe_CoolType_Data/InVMDeepCopiedFonts get
begin
dup/FontBasedOn get 1 index def
end
}bind def
/$Underprint
{
gsave
x abs y abs gt
{/y 1000 def}
{/x -1000 def 500 120 translate}
ifelse
Level2?
{
[/Separation(All)/DeviceCMYK{0 0 0 1 pop}]
setcolorspace
}
{0 setgray}
ifelse
10 setlinewidth
x .8 mul
[7 3]
{
y mul 8 div 120 sub x 10 div exch moveto
0 y 4 div neg rlineto
dup 0 rlineto
0 y 4 div rlineto
closepath
gsave
Level2?
{.2 setcolor}
{.8 setgray}
ifelse
fill grestore
stroke
}
forall
pop
grestore
}bind def
end def
/$Oblique
1 dict dup
begin
/$BuildFont
{
currentglobal exch dup gcheck setglobal
null copyfont
begin
/FontBasedOn
currentdict/FontName known
{
FontName
dup type/stringtype eq{cvn}if
}
{/unnamedfont}
ifelse
def
/FontName $fontname dup type/stringtype eq{cvn}if def
/currentdistillerparams where
{pop}
{
/FontInfo currentdict/FontInfo known
{FontInfo null copyfont}
{2 dict}
ifelse
dup
begin
/ItalicAngle $italicangle def
/FontMatrix FontMatrix
[1 0 ItalicAngle dup sin exch cos div 1 0 0]
matrix concatmatrix readonly
end
4 2 roll def
def
}
ifelse
FontName currentdict
end
definefont
exch setglobal
}bind def
end def
/$None
1 dict dup
begin
/$BuildFont{}bind def
end def
end def
/$Oblique SetSubstituteStrategy
/$findfontByEnum
{
dup type/stringtype eq{cvn}if
dup/$fontname exch def
$sname null eq
{$str cvs dup length $slen sub $slen getinterval}
{pop $sname}
ifelse
$fontpat dup 0(fonts/*)putinterval exch 7 exch putinterval
/$match false def
$SubstituteFont/$dstack countdictstack array dictstack put
mark
{
$fontpat 0 $slen 7 add getinterval
{/$match exch def exit}
$str filenameforall
}
stopped
{
cleardictstack
currentdict
true
$SubstituteFont/$dstack get
{
exch
{
1 index eq
{pop false}
{true}
ifelse
}
{begin false}
ifelse
}
forall
pop
}
if
cleartomark
/$slen 0 def
$match false ne
{$match(fonts/)anchorsearch pop pop cvn}
{/Courier}
ifelse
}bind def
/$ROS 1 dict dup
begin
/Adobe 4 dict dup
begin
/Japan1 [/Ryumin-Light/HeiseiMin-W3
/GothicBBB-Medium/HeiseiKakuGo-W5
/HeiseiMaruGo-W4/Jun101-Light]def
/Korea1 [/HYSMyeongJo-Medium/HYGoThic-Medium]def
/GB1 [/STSong-Light/STHeiti-Regular]def
/CNS1 [/MKai-Medium/MHei-Medium]def
end def
end def
/$cmapname null def
/$deepcopyfont
{
dup/FontType get 0 eq
{
1 dict dup/FontName/copied put copyfont
begin
/FDepVector FDepVector copyarray
0 1 2 index length 1 sub
{
2 copy get $deepcopyfont
dup/FontName/copied put
/copied exch definefont
3 copy put pop pop
}
for
def
currentdict
end
}
{$Strategies/$Type3Underprint get exec}
ifelse
}bind def
/$buildfontname
{
dup/CIDFont findresource/CIDSystemInfo get
begin
Registry length Ordering length Supplement 8 string cvs
3 copy length 2 add add add string
dup 5 1 roll dup 0 Registry putinterval
dup 4 index(-)putinterval
dup 4 index 1 add Ordering putinterval
4 2 roll add 1 add 2 copy(-)putinterval
end
1 add 2 copy 0 exch getinterval $cmapname $fontpat cvs exch
anchorsearch
{pop pop 3 2 roll putinterval cvn/$cmapname exch def}
{pop pop pop pop pop}
ifelse
length
$str 1 index(-)putinterval 1 add
$str 1 index $cmapname $fontpat cvs putinterval
$cmapname length add
$str exch 0 exch getinterval cvn
}bind def
/$findfontByROS
{
/$fontname exch def
$ROS Registry 2 copy known
{
get Ordering 2 copy known
{get}
{pop pop[]}
ifelse
}
{pop pop[]}
ifelse
false exch
{
dup/CIDFont resourcestatus
{
pop pop
save
1 index/CIDFont findresource
dup/WidthsOnly known
{dup/WidthsOnly get}
{false}
ifelse
exch pop
exch restore
{pop}
{exch pop true exit}
ifelse
}
{pop}
ifelse
}
forall
{$str cvs $buildfontname}
{
false(*)
{
save exch
dup/CIDFont findresource
dup/WidthsOnly known
{dup/WidthsOnly get not}
{true}
ifelse
exch/CIDSystemInfo get
dup/Registry get Registry eq
exch/Ordering get Ordering eq and and
{exch restore exch pop true exit}
{pop restore}
ifelse
}
$str/CIDFont resourceforall
{$buildfontname}
{$fontname $findfontByEnum}
ifelse
}
ifelse
}bind def
end
end
currentdict/$error known currentdict/languagelevel known and dup
{pop $error/SubstituteFont known}
if
dup
{$error}
{Adobe_CoolType_Core}
ifelse
begin
{
/SubstituteFont
/CMap/Category resourcestatus
{
pop pop
{
$SubstituteFont
begin
/$substituteFound true def
dup length $slen gt
$sname null ne or
$slen 0 gt and
{
$sname null eq
{dup $str cvs dup length $slen sub $slen getinterval cvn}
{$sname}
ifelse
Adobe_CoolType_Data/InVMFontsByCMap get
1 index 2 copy known
{
get
false exch
{
pop
currentglobal
{
GlobalFontDirectory 1 index known
{exch pop true exit}
{pop}
ifelse
}
{
FontDirectory 1 index known
{exch pop true exit}
{
GlobalFontDirectory 1 index known
{exch pop true exit}
{pop}
ifelse
}
ifelse
}
ifelse
}
forall
}
{pop pop false}
ifelse
{
exch pop exch pop
}
{
dup/CMap resourcestatus
{
pop pop
dup/$cmapname exch def
/CMap findresource/CIDSystemInfo get{def}forall
$findfontByROS
}
{
128 string cvs
dup(-)search
{
3 1 roll search
{
3 1 roll pop
{dup cvi}
stopped
{pop pop pop pop pop $findfontByEnum}
{
4 2 roll pop pop
exch length
exch
2 index length
2 index
sub
exch 1 sub -1 0
{
$str cvs dup length
4 index
0
4 index
4 3 roll add
getinterval
exch 1 index exch 3 index exch
putinterval
dup/CMap resourcestatus
{
pop pop
4 1 roll pop pop pop
dup/$cmapname exch def
/CMap findresource/CIDSystemInfo get{def}forall
$findfontByROS
true exit
}
{pop}
ifelse
}
for
dup type/booleantype eq
{pop}
{pop pop pop $findfontByEnum}
ifelse
}
ifelse
}
{pop pop pop $findfontByEnum}
ifelse
}
{pop pop $findfontByEnum}
ifelse
}
ifelse
}
ifelse
}
{//SubstituteFont exec}
ifelse
/$slen 0 def
end
}
}
{
{
$SubstituteFont
begin
/$substituteFound true def
dup length $slen gt
$sname null ne or
$slen 0 gt and
{$findfontByEnum}
{//SubstituteFont exec}
ifelse
end
}
}
ifelse
bind readonly def
Adobe_CoolType_Core/scfindfont/systemfindfont load put
}
{
/scfindfont
{
$SubstituteFont
begin
dup systemfindfont
dup/FontName known
{dup/FontName get dup 3 index ne}
{/noname true}
ifelse
dup
{
/$origfontnamefound 2 index def
/$origfontname 4 index def/$substituteFound true def
}
if
exch pop
{
$slen 0 gt
$sname null ne
3 index length $slen gt or and
{
pop dup $findfontByEnum findfont
dup maxlength 1 add dict
begin
{1 index/FID eq{pop pop}{def}ifelse}
forall
currentdict
end
definefont
dup/FontName known{dup/FontName get}{null}ifelse
$origfontnamefound ne
{
$origfontname $str cvs print
( substitution revised, using )print
dup/FontName known
{dup/FontName get}{(unspecified font)}
ifelse
$str cvs print(.\n)print
}
if
}
{exch pop}
ifelse
}
{exch pop}
ifelse
end
}bind def
}
ifelse
end
end
Adobe_CoolType_Core_Defined not
{
Adobe_CoolType_Core/findfont
{
$SubstituteFont
begin
$depth 0 eq
{
/$fontname 1 index dup type/stringtype ne{$str cvs}if def
/$substituteFound false def
}
if
/$depth $depth 1 add def
end
scfindfont
$SubstituteFont
begin
/$depth $depth 1 sub def
$substituteFound $depth 0 eq and
{
$inVMIndex null ne
{dup $inVMIndex $AddInVMFont}
if
$doSmartSub
{
currentdict/$Strategy known
{$Strategy/$BuildFont get exec}
if
}
if
}
if
end
}bind put
}
if
}
if
end
/$AddInVMFont
{
exch/FontName 2 copy known
{
get
1 dict dup begin exch 1 index gcheck def end exch
Adobe_CoolType_Data/InVMFontsByCMap get exch
$DictAdd
}
{pop pop pop}
ifelse
}bind def
/$DictAdd
{
2 copy known not
{2 copy 4 index length dict put}
if
Level2? not
{
2 copy get dup maxlength exch length 4 index length add lt
2 copy get dup length 4 index length add exch maxlength 1 index lt
{
2 mul dict
begin
2 copy get{forall}def
2 copy currentdict put
end
}
{pop}
ifelse
}
if
get
begin
{def}
forall
end
}bind def
end
end
%%EndResource
currentglobal true setglobal
%%BeginResource: procset Adobe_CoolType_Utility_MAKEOCF 1.23 0
%%Copyright: Copyright 1987-2006 Adobe Systems Incorporated.
%%Version: 1.23 0
systemdict/languagelevel known dup
{currentglobal false setglobal}
{false}
ifelse
exch
userdict/Adobe_CoolType_Utility 2 copy known
{2 copy get dup maxlength 27 add dict copy}
{27 dict}
ifelse put
Adobe_CoolType_Utility
begin
/@eexecStartData
def
/@recognizeCIDFont null def
/ct_Level2? exch def
/ct_Clone? 1183615869 internaldict dup
/CCRun known not
exch/eCCRun known not
ct_Level2? and or def
ct_Level2?
{globaldict begin currentglobal true setglobal}
if
/ct_AddStdCIDMap
ct_Level2?
{{
mark
Adobe_CoolType_Utility/@recognizeCIDFont currentdict put
{
((Hex)57 StartData
0615 1e27 2c39 1c60 d8a8 cc31 fe2b f6e0
7aa3 e541 e21c 60d8 a8c9 c3d0 6d9e 1c60
d8a8 c9c2 02d7 9a1c 60d8 a849 1c60 d8a8
cc36 74f4 1144 b13b 77)0()/SubFileDecode filter cvx exec
}
stopped
{
cleartomark
Adobe_CoolType_Utility/@recognizeCIDFont get
countdictstack dup array dictstack
exch 1 sub -1 0
{
2 copy get 3 index eq
{1 index length exch sub 1 sub{end}repeat exit}
{pop}
ifelse
}
for
pop pop
Adobe_CoolType_Utility/@eexecStartData get eexec
}
{cleartomark}
ifelse
}}
{{
Adobe_CoolType_Utility/@eexecStartData get eexec
}}
ifelse bind def
userdict/cid_extensions known
dup{cid_extensions/cid_UpdateDB known and}if
{
cid_extensions
begin
/cid_GetCIDSystemInfo
{
1 index type/stringtype eq
{exch cvn exch}
if
cid_extensions
begin
dup load 2 index known
{
2 copy
cid_GetStatusInfo
dup null ne
{
1 index load
3 index get
dup null eq
{pop pop cid_UpdateDB}
{
exch
1 index/Created get eq
{exch pop exch pop}
{pop cid_UpdateDB}
ifelse
}
ifelse
}
{pop cid_UpdateDB}
ifelse
}
{cid_UpdateDB}
ifelse
end
}bind def
end
}
if
ct_Level2?
{end setglobal}
if
/ct_UseNativeCapability? systemdict/composefont known def
/ct_MakeOCF 35 dict def
/ct_Vars 25 dict def
/ct_GlyphDirProcs 6 dict def
/ct_BuildCharDict 15 dict dup
begin
/charcode 2 string def
/dst_string 1500 string def
/nullstring()def
/usewidths? true def
end def
ct_Level2?{setglobal}{pop}ifelse
ct_GlyphDirProcs
begin
/GetGlyphDirectory
{
systemdict/languagelevel known
{pop/CIDFont findresource/GlyphDirectory get}
{
1 index/CIDFont findresource/GlyphDirectory
get dup type/dicttype eq
{
dup dup maxlength exch length sub 2 index lt
{
dup length 2 index add dict copy 2 index
/CIDFont findresource/GlyphDirectory 2 index put
}
if
}
if
exch pop exch pop
}
ifelse
+
}def
/+
{
systemdict/languagelevel known
{
currentglobal false setglobal
3 dict begin
/vm exch def
}
{1 dict begin}
ifelse
/$ exch def
systemdict/languagelevel known
{
vm setglobal
/gvm currentglobal def
$ gcheck setglobal
}
if
?{$ begin}if
}def
/?{$ type/dicttype eq}def
/|{
userdict/Adobe_CoolType_Data known
{
Adobe_CoolType_Data/AddWidths? known
{
currentdict Adobe_CoolType_Data
begin
begin
AddWidths?
{
Adobe_CoolType_Data/CC 3 index put
?{def}{$ 3 1 roll put}ifelse
CC charcode exch 1 index 0 2 index 256 idiv put
1 index exch 1 exch 256 mod put
stringwidth 2 array astore
currentfont/Widths get exch CC exch put
}
{?{def}{$ 3 1 roll put}ifelse}
ifelse
end
end
}
{?{def}{$ 3 1 roll put}ifelse} ifelse
}
{?{def}{$ 3 1 roll put}ifelse}
ifelse
}def
/!
{
?{end}if
systemdict/languagelevel known
{gvm setglobal}
if
end
}def
/:{string currentfile exch readstring pop}executeonly def
end
ct_MakeOCF
begin
/ct_cHexEncoding
[/c00/c01/c02/c03/c04/c05/c06/c07/c08/c09/c0A/c0B/c0C/c0D/c0E/c0F/c10/c11/c12
/c13/c14/c15/c16/c17/c18/c19/c1A/c1B/c1C/c1D/c1E/c1F/c20/c21/c22/c23/c24/c25
/c26/c27/c28/c29/c2A/c2B/c2C/c2D/c2E/c2F/c30/c31/c32/c33/c34/c35/c36/c37/c38
/c39/c3A/c3B/c3C/c3D/c3E/c3F/c40/c41/c42/c43/c44/c45/c46/c47/c48/c49/c4A/c4B
/c4C/c4D/c4E/c4F/c50/c51/c52/c53/c54/c55/c56/c57/c58/c59/c5A/c5B/c5C/c5D/c5E
/c5F/c60/c61/c62/c63/c64/c65/c66/c67/c68/c69/c6A/c6B/c6C/c6D/c6E/c6F/c70/c71
/c72/c73/c74/c75/c76/c77/c78/c79/c7A/c7B/c7C/c7D/c7E/c7F/c80/c81/c82/c83/c84
/c85/c86/c87/c88/c89/c8A/c8B/c8C/c8D/c8E/c8F/c90/c91/c92/c93/c94/c95/c96/c97
/c98/c99/c9A/c9B/c9C/c9D/c9E/c9F/cA0/cA1/cA2/cA3/cA4/cA5/cA6/cA7/cA8/cA9/cAA
/cAB/cAC/cAD/cAE/cAF/cB0/cB1/cB2/cB3/cB4/cB5/cB6/cB7/cB8/cB9/cBA/cBB/cBC/cBD
/cBE/cBF/cC0/cC1/cC2/cC3/cC4/cC5/cC6/cC7/cC8/cC9/cCA/cCB/cCC/cCD/cCE/cCF/cD0
/cD1/cD2/cD3/cD4/cD5/cD6/cD7/cD8/cD9/cDA/cDB/cDC/cDD/cDE/cDF/cE0/cE1/cE2/cE3
/cE4/cE5/cE6/cE7/cE8/cE9/cEA/cEB/cEC/cED/cEE/cEF/cF0/cF1/cF2/cF3/cF4/cF5/cF6
/cF7/cF8/cF9/cFA/cFB/cFC/cFD/cFE/cFF]def
/ct_CID_STR_SIZE 8000 def
/ct_mkocfStr100 100 string def
/ct_defaultFontMtx[.001 0 0 .001 0 0]def
/ct_1000Mtx[1000 0 0 1000 0 0]def
/ct_raise{exch cvx exch errordict exch get exec stop}bind def
/ct_reraise
{cvx $error/errorname get(Error: )print dup( )cvs print
errordict exch get exec stop
}bind def
/ct_cvnsi
{
1 index add 1 sub 1 exch 0 4 1 roll
{
2 index exch get
exch 8 bitshift
add
}
for
exch pop
}bind def
/ct_GetInterval
{
Adobe_CoolType_Utility/ct_BuildCharDict get
begin
/dst_index 0 def
dup dst_string length gt
{dup string/dst_string exch def}
if
1 index ct_CID_STR_SIZE idiv
/arrayIndex exch def
2 index arrayIndex get
2 index
arrayIndex ct_CID_STR_SIZE mul
sub
{
dup 3 index add 2 index length le
{
2 index getinterval
dst_string dst_index 2 index putinterval
length dst_index add/dst_index exch def
exit
}
{
1 index length 1 index sub
dup 4 1 roll
getinterval
dst_string dst_index 2 index putinterval
pop dup dst_index add/dst_index exch def
sub
/arrayIndex arrayIndex 1 add def
2 index dup length arrayIndex gt
{arrayIndex get}
{
pop
exit
}
ifelse
0
}
ifelse
}
loop
pop pop pop
dst_string 0 dst_index getinterval
end
}bind def
ct_Level2?
{
/ct_resourcestatus
currentglobal mark true setglobal
{/unknowninstancename/Category resourcestatus}
stopped
{cleartomark setglobal true}
{cleartomark currentglobal not exch setglobal}
ifelse
{
{
mark 3 1 roll/Category findresource
begin
ct_Vars/vm currentglobal put
({ResourceStatus}stopped)0()/SubFileDecode filter cvx exec
{cleartomark false}
{{3 2 roll pop true}{cleartomark false}ifelse}
ifelse
ct_Vars/vm get setglobal
end
}
}
{{resourcestatus}}
ifelse bind def
/CIDFont/Category ct_resourcestatus
{pop pop}
{
currentglobal true setglobal
/Generic/Category findresource
dup length dict copy
dup/InstanceType/dicttype put
/CIDFont exch/Category defineresource pop
setglobal
}
ifelse
ct_UseNativeCapability?
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CIDSystemInfo 3 dict dup begin
/Registry(Adobe)def
/Ordering(Identity)def
/Supplement 0 def
end def
/CMapName/Identity-H def
/CMapVersion 1.000 def
/CMapType 1 def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
if
}
{
/ct_Category 2 dict begin
/CIDFont 10 dict def
/ProcSet 2 dict def
currentdict
end
def
/defineresource
{
ct_Category 1 index 2 copy known
{
get
dup dup maxlength exch length eq
{
dup length 10 add dict copy
ct_Category 2 index 2 index put
}
if
3 index 3 index put
pop exch pop
}
{pop pop/defineresource/undefined ct_raise}
ifelse
}bind def
/findresource
{
ct_Category 1 index 2 copy known
{
get
2 index 2 copy known
{get 3 1 roll pop pop}
{pop pop/findresource/undefinedresource ct_raise}
ifelse
}
{pop pop/findresource/undefined ct_raise}
ifelse
}bind def
/resourcestatus
{
ct_Category 1 index 2 copy known
{
get
2 index known
exch pop exch pop
{
0 -1 true
}
{
false
}
ifelse
}
{pop pop/findresource/undefined ct_raise}
ifelse
}bind def
/ct_resourcestatus/resourcestatus load def
}
ifelse
/ct_CIDInit 2 dict
begin
/ct_cidfont_stream_init
{
{
dup(Binary)eq
{
pop
null
currentfile
ct_Level2?
{
{cid_BYTE_COUNT()/SubFileDecode filter}
stopped
{pop pop pop}
if
}
if
/readstring load
exit
}
if
dup(Hex)eq
{
pop
currentfile
ct_Level2?
{
{null exch/ASCIIHexDecode filter/readstring}
stopped
{pop exch pop(>)exch/readhexstring}
if
}
{(>)exch/readhexstring}
ifelse
load
exit
}
if
/StartData/typecheck ct_raise
}
loop
cid_BYTE_COUNT ct_CID_STR_SIZE le
{
2 copy cid_BYTE_COUNT string exch exec
pop
1 array dup
3 -1 roll
0 exch put
}
{
cid_BYTE_COUNT ct_CID_STR_SIZE div ceiling cvi
dup array exch 2 sub 0 exch 1 exch
{
2 copy
5 index
ct_CID_STR_SIZE
string
6 index exec
pop
put
pop
}
for
2 index
cid_BYTE_COUNT ct_CID_STR_SIZE mod string
3 index exec
pop
1 index exch
1 index length 1 sub
exch put
}
ifelse
cid_CIDFONT exch/GlyphData exch put
2 index null eq
{
pop pop pop
}
{
pop/readstring load
1 string exch
{
3 copy exec
pop
dup length 0 eq
{
pop pop pop pop pop
true exit
}
if
4 index
eq
{
pop pop pop pop
false exit
}
if
}
loop
pop
}
ifelse
}bind def
/StartData
{
mark
{
currentdict
dup/FDArray get 0 get/FontMatrix get
0 get 0.001 eq
{
dup/CDevProc known not
{
/CDevProc 1183615869 internaldict/stdCDevProc 2 copy known
{get}
{
pop pop
{pop pop pop pop pop 0 -1000 7 index 2 div 880}
}
ifelse
def
}
if
}
{
/CDevProc
{
pop pop pop pop pop
0
1 cid_temp/cid_CIDFONT get
/FDArray get 0 get
/FontMatrix get 0 get div
7 index 2 div
1 index 0.88 mul
}def
}
ifelse
/cid_temp 15 dict def
cid_temp
begin
/cid_CIDFONT exch def
3 copy pop
dup/cid_BYTE_COUNT exch def 0 gt
{
ct_cidfont_stream_init
FDArray
{
/Private get
dup/SubrMapOffset known
{
begin
/Subrs SubrCount array def
Subrs
SubrMapOffset
SubrCount
SDBytes
ct_Level2?
{
currentdict dup/SubrMapOffset undef
dup/SubrCount undef
/SDBytes undef
}
if
end
/cid_SD_BYTES exch def
/cid_SUBR_COUNT exch def
/cid_SUBR_MAP_OFFSET exch def
/cid_SUBRS exch def
cid_SUBR_COUNT 0 gt
{
GlyphData cid_SUBR_MAP_OFFSET cid_SD_BYTES ct_GetInterval
0 cid_SD_BYTES ct_cvnsi
0 1 cid_SUBR_COUNT 1 sub
{
exch 1 index
1 add
cid_SD_BYTES mul cid_SUBR_MAP_OFFSET add
GlyphData exch cid_SD_BYTES ct_GetInterval
0 cid_SD_BYTES ct_cvnsi
cid_SUBRS 4 2 roll
GlyphData exch
4 index
1 index
sub
ct_GetInterval
dup length string copy put
}
for
pop
}
if
}
{pop}
ifelse
}
forall
}
if
cleartomark pop pop
end
CIDFontName currentdict/CIDFont defineresource pop
end end
}
stopped
{cleartomark/StartData ct_reraise}
if
}bind def
currentdict
end def
/ct_saveCIDInit
{
/CIDInit/ProcSet ct_resourcestatus
{true}
{/CIDInitC/ProcSet ct_resourcestatus}
ifelse
{
pop pop
/CIDInit/ProcSet findresource
ct_UseNativeCapability?
{pop null}
{/CIDInit ct_CIDInit/ProcSet defineresource pop}
ifelse
}
{/CIDInit ct_CIDInit/ProcSet defineresource pop null}
ifelse
ct_Vars exch/ct_oldCIDInit exch put
}bind def
/ct_restoreCIDInit
{
ct_Vars/ct_oldCIDInit get dup null ne
{/CIDInit exch/ProcSet defineresource pop}
{pop}
ifelse
}bind def
/ct_BuildCharSetUp
{
1 index
begin
CIDFont
begin
Adobe_CoolType_Utility/ct_BuildCharDict get
begin
/ct_dfCharCode exch def
/ct_dfDict exch def
CIDFirstByte ct_dfCharCode add
dup CIDCount ge
{pop 0}
if
/cid exch def
{
GlyphDirectory cid 2 copy known
{get}
{pop pop nullstring}
ifelse
dup length FDBytes sub 0 gt
{
dup
FDBytes 0 ne
{0 FDBytes ct_cvnsi}
{pop 0}
ifelse
/fdIndex exch def
dup length FDBytes sub FDBytes exch getinterval
/charstring exch def
exit
}
{
pop
cid 0 eq
{/charstring nullstring def exit}
if
/cid 0 def
}
ifelse
}
loop
}def
/ct_SetCacheDevice
{
0 0 moveto
dup stringwidth
3 -1 roll
true charpath
pathbbox
0 -1000
7 index 2 div 880
setcachedevice2
0 0 moveto
}def
/ct_CloneSetCacheProc
{
1 eq
{
stringwidth
pop -2 div -880
0 -1000 setcharwidth
moveto
}
{
usewidths?
{
currentfont/Widths get cid
2 copy known
{get exch pop aload pop}
{pop pop stringwidth}
ifelse
}
{stringwidth}
ifelse
setcharwidth
0 0 moveto
}
ifelse
}def
/ct_Type3ShowCharString
{
ct_FDDict fdIndex 2 copy known
{get}
{
currentglobal 3 1 roll
1 index gcheck setglobal
ct_Type1FontTemplate dup maxlength dict copy
begin
FDArray fdIndex get
dup/FontMatrix 2 copy known
{get}
{pop pop ct_defaultFontMtx}
ifelse
/FontMatrix exch dup length array copy def
/Private get
/Private exch def
/Widths rootfont/Widths get def
/CharStrings 1 dict dup/.notdef
dup length string copy put def
currentdict
end
/ct_Type1Font exch definefont
dup 5 1 roll put
setglobal
}
ifelse
dup/CharStrings get 1 index/Encoding get
ct_dfCharCode get charstring put
rootfont/WMode 2 copy known
{get}
{pop pop 0}
ifelse
exch
1000 scalefont setfont
ct_str1 0 ct_dfCharCode put
ct_str1 exch ct_dfSetCacheProc
ct_SyntheticBold
{
currentpoint
ct_str1 show
newpath
moveto
ct_str1 true charpath
ct_StrokeWidth setlinewidth
stroke
}
{ct_str1 show}
ifelse
}def
/ct_Type4ShowCharString
{
ct_dfDict ct_dfCharCode charstring
FDArray fdIndex get
dup/FontMatrix get dup ct_defaultFontMtx ct_matrixeq not
{ct_1000Mtx matrix concatmatrix concat}
{pop}
ifelse
/Private get
Adobe_CoolType_Utility/ct_Level2? get not
{
ct_dfDict/Private
3 -1 roll
{put}
1183615869 internaldict/superexec get exec
}
if
1183615869 internaldict
Adobe_CoolType_Utility/ct_Level2? get
{1 index}
{3 index/Private get mark 6 1 roll}
ifelse
dup/RunInt known
{/RunInt get}
{pop/CCRun}
ifelse
get exec
Adobe_CoolType_Utility/ct_Level2? get not
{cleartomark}
if
}bind def
/ct_BuildCharIncremental
{
{
Adobe_CoolType_Utility/ct_MakeOCF get begin
ct_BuildCharSetUp
ct_ShowCharString
}
stopped
{stop}
if
end
end
end
end
}bind def
/BaseFontNameStr(BF00)def
/ct_Type1FontTemplate 14 dict
begin
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0]def
/FontBBox [-250 -250 1250 1250]def
/Encoding ct_cHexEncoding def
/PaintType 0 def
currentdict
end def
/BaseFontTemplate 11 dict
begin
/FontMatrix [0.001 0 0 0.001 0 0]def
/FontBBox [-250 -250 1250 1250]def
/Encoding ct_cHexEncoding def
/BuildChar/ct_BuildCharIncremental load def
ct_Clone?
{
/FontType 3 def
/ct_ShowCharString/ct_Type3ShowCharString load def
/ct_dfSetCacheProc/ct_CloneSetCacheProc load def
/ct_SyntheticBold false def
/ct_StrokeWidth 1 def
}
{
/FontType 4 def
/Private 1 dict dup/lenIV 4 put def
/CharStrings 1 dict dup/.notdefput def
/PaintType 0 def
/ct_ShowCharString/ct_Type4ShowCharString load def
}
ifelse
/ct_str1 1 string def
currentdict
end def
/BaseFontDictSize BaseFontTemplate length 5 add def
/ct_matrixeq
{
true 0 1 5
{
dup 4 index exch get exch 3 index exch get eq and
dup not
{exit}
if
}
for
exch pop exch pop
}bind def
/ct_makeocf
{
15 dict
begin
exch/WMode exch def
exch/FontName exch def
/FontType 0 def
/FMapType 2 def
dup/FontMatrix known
{dup/FontMatrix get/FontMatrix exch def}
{/FontMatrix matrix def}
ifelse
/bfCount 1 index/CIDCount get 256 idiv 1 add
dup 256 gt{pop 256}if def
/Encoding
256 array 0 1 bfCount 1 sub{2 copy dup put pop}for
bfCount 1 255{2 copy bfCount put pop}for
def
/FDepVector bfCount dup 256 lt{1 add}if array def
BaseFontTemplate BaseFontDictSize dict copy
begin
/CIDFont exch def
CIDFont/FontBBox known
{CIDFont/FontBBox get/FontBBox exch def}
if
CIDFont/CDevProc known
{CIDFont/CDevProc get/CDevProc exch def}
if
currentdict
end
BaseFontNameStr 3(0)putinterval
0 1 bfCount dup 256 eq{1 sub}if
{
FDepVector exch
2 index BaseFontDictSize dict copy
begin
dup/CIDFirstByte exch 256 mul def
FontType 3 eq
{/ct_FDDict 2 dict def}
if
currentdict
end
1 index 16
BaseFontNameStr 2 2 getinterval cvrs pop
BaseFontNameStr exch definefont
put
}
for
ct_Clone?
{/Widths 1 index/CIDFont get/GlyphDirectory get length dict def}
if
FontName
currentdict
end
definefont
ct_Clone?
{
gsave
dup 1000 scalefont setfont
ct_BuildCharDict
begin
/usewidths? false def
currentfont/Widths get
begin
exch/CIDFont get/GlyphDirectory get
{
pop
dup charcode exch 1 index 0 2 index 256 idiv put
1 index exch 1 exch 256 mod put
stringwidth 2 array astore def
}
forall
end
/usewidths? true def
end
grestore
}
{exch pop}
ifelse
}bind def
currentglobal true setglobal
/ct_ComposeFont
{
ct_UseNativeCapability?
{
2 index/CMap ct_resourcestatus
{pop pop exch pop}
{
/CIDInit/ProcSet findresource
begin
12 dict
begin
begincmap
/CMapName 3 index def
/CMapVersion 1.000 def
/CMapType 1 def
exch/WMode exch def
/CIDSystemInfo 3 dict dup
begin
/Registry(Adobe)def
/Ordering
CMapName ct_mkocfStr100 cvs
(Adobe-)search
{
pop pop
(-)search
{
dup length string copy
exch pop exch pop
}
{pop(Identity)}
ifelse
}
{pop (Identity)}
ifelse
def
/Supplement 0 def
end def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
composefont
}
{
3 2 roll pop
0 get/CIDFont findresource
ct_makeocf
}
ifelse
}bind def
setglobal
/ct_MakeIdentity
{
ct_UseNativeCapability?
{
1 index/CMap ct_resourcestatus
{pop pop}
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CMapName 2 index def
/CMapVersion 1.000 def
/CMapType 1 def
/CIDSystemInfo 3 dict dup
begin
/Registry(Adobe)def
/Ordering
CMapName ct_mkocfStr100 cvs
(Adobe-)search
{
pop pop
(-)search
{dup length string copy exch pop exch pop}
{pop(Identity)}
ifelse
}
{pop(Identity)}
ifelse
def
/Supplement 0 def
end def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
composefont
}
{
exch pop
0 get/CIDFont findresource
ct_makeocf
}
ifelse
}bind def
currentdict readonly pop
end
end
%%EndResource
setglobal
%%BeginResource: procset Adobe_CoolType_Utility_T42 1.0 0
%%Copyright: Copyright 1987-2004 Adobe Systems Incorporated.
%%Version: 1.0 0
userdict/ct_T42Dict 15 dict put
ct_T42Dict begin
/Is2015?
{
version
cvi
2015
ge
}bind def
/AllocGlyphStorage
{
Is2015?
{
pop
}
{
{string}forall
}ifelse
}bind def
/Type42DictBegin
{
25 dict begin
/FontName exch def
/CharStrings 256 dict
begin
/.notdef 0 def
currentdict
end def
/Encoding exch def
/PaintType 0 def
/FontType 42 def
/FontMatrix[1 0 0 1 0 0]def
4 array astore cvx/FontBBox exch def
/sfnts
}bind def
/Type42DictEnd
{
currentdict dup/FontName get exch definefont end
ct_T42Dict exch
dup/FontName get exch put
}bind def
/RD{string currentfile exch readstring pop}executeonly def
/PrepFor2015
{
Is2015?
{
/GlyphDirectory
16
dict def
sfnts 0 get
dup
2 index
(glyx)
putinterval
2 index
(locx)
putinterval
pop
pop
}
{
pop
pop
}ifelse
}bind def
/AddT42Char
{
Is2015?
{
/GlyphDirectory get
begin
def
end
pop
pop
}
{
/sfnts get
4 index
get
3 index
2 index
putinterval
pop
pop
pop
pop
}ifelse
}bind def
/T0AddT42Mtx2
{
/CIDFont findresource/Metrics2 get begin def end
}bind def
end
%%EndResource
currentglobal true setglobal
%%BeginFile: MMFauxFont.prc
%%Copyright: Copyright 1987-2001 Adobe Systems Incorporated.
%%All Rights Reserved.
userdict /ct_EuroDict 10 dict put
ct_EuroDict begin
/ct_CopyFont
{
{ 1 index /FID ne {def} {pop pop} ifelse} forall
} def
/ct_GetGlyphOutline
{
gsave
initmatrix newpath
exch findfont dup
length 1 add dict
begin
ct_CopyFont
/Encoding Encoding dup length array copy
dup
4 -1 roll
0 exch put
def
currentdict
end
/ct_EuroFont exch definefont
1000 scalefont setfont
0 0 moveto
[
<00> stringwidth
<00> false charpath
pathbbox
[
{/m cvx} {/l cvx} {/c cvx} {/cp cvx} pathforall
grestore
counttomark 8 add
}
def
/ct_MakeGlyphProc
{
] cvx
/ct_PSBuildGlyph cvx
] cvx
} def
/ct_PSBuildGlyph
{
gsave
8 -1 roll pop
7 1 roll
6 -2 roll ct_FontMatrix transform 6 2 roll
4 -2 roll ct_FontMatrix transform 4 2 roll
ct_FontMatrix transform
currentdict /PaintType 2 copy known {get 2 eq}{pop pop false} ifelse
dup 9 1 roll
{
currentdict /StrokeWidth 2 copy known
{
get 2 div
0 ct_FontMatrix dtransform pop
5 1 roll
4 -1 roll 4 index sub
4 1 roll
3 -1 roll 4 index sub
3 1 roll
exch 4 index add exch
4 index add
5 -1 roll pop
}
{
pop pop
}
ifelse
}
if
setcachedevice
ct_FontMatrix concat
ct_PSPathOps begin
exec
end
{
currentdict /StrokeWidth 2 copy known
{ get }
{ pop pop 0 }
ifelse
setlinewidth stroke
}
{
fill
}
ifelse
grestore
} def
/ct_PSPathOps 4 dict dup begin
/m {moveto} def
/l {lineto} def
/c {curveto} def
/cp {closepath} def
end
def
/ct_matrix1000 [1000 0 0 1000 0 0] def
/ct_AddGlyphProc
{
2 index findfont dup length 4 add dict
begin
ct_CopyFont
/CharStrings CharStrings dup length 1 add dict copy
begin
3 1 roll def
currentdict
end
def
/ct_FontMatrix ct_matrix1000 FontMatrix matrix concatmatrix def
/ct_PSBuildGlyph /ct_PSBuildGlyph load def
/ct_PSPathOps /ct_PSPathOps load def
currentdict
end
definefont pop
}
def
systemdict /languagelevel known
{
/ct_AddGlyphToPrinterFont {
2 copy
ct_GetGlyphOutline 3 add -1 roll restore
ct_MakeGlyphProc
ct_AddGlyphProc
} def
}
{
/ct_AddGlyphToPrinterFont {
pop pop restore
Adobe_CTFauxDict /$$$FONTNAME get
/Euro
Adobe_CTFauxDict /$$$SUBSTITUTEBASE get
ct_EuroDict exch get
ct_AddGlyphProc
} def
} ifelse
/AdobeSansMM
{
556 0 24 -19 541 703
{
541 628 m
510 669 442 703 354 703 c
201 703 117 607 101 444 c
50 444 l
25 372 l
97 372 l
97 301 l
49 301 l
24 229 l
103 229 l
124 67 209 -19 350 -19 c
435 -19 501 25 509 32 c
509 131 l
492 105 417 60 343 60 c
267 60 204 127 197 229 c
406 229 l
430 301 l
191 301 l
191 372 l
455 372 l
479 444 l
194 444 l
201 531 245 624 348 624 c
433 624 484 583 509 534 c
cp
556 0 m
}
ct_PSBuildGlyph
} def
/AdobeSerifMM
{
500 0 10 -12 484 692
{
347 298 m
171 298 l
170 310 170 322 170 335 c
170 362 l
362 362 l
374 403 l
172 403 l
184 580 244 642 308 642 c
380 642 434 574 457 457 c
481 462 l
474 691 l
449 691 l
433 670 429 657 410 657 c
394 657 360 692 299 692 c
204 692 94 604 73 403 c
22 403 l
10 362 l
70 362 l
69 352 69 341 69 330 c
69 319 69 308 70 298 c
22 298 l
10 257 l
73 257 l
97 57 216 -12 295 -12 c
364 -12 427 25 484 123 c
458 142 l
425 101 384 37 316 37 c
256 37 189 84 173 257 c
335 257 l
cp
500 0 m
}
ct_PSBuildGlyph
} def
end
%%EndFile
setglobal
Adobe_CoolType_Core begin /$Oblique SetSubstituteStrategy end
%%BeginResource: procset Adobe_AGM_Image 1.0 0
%%Version: 1.0 0
%%Copyright: Copyright(C)2000-2006 Adobe Systems, Inc. All Rights Reserved.
systemdict/setpacking known
{
currentpacking
true setpacking
}if
userdict/Adobe_AGM_Image 71 dict dup begin put
/Adobe_AGM_Image_Id/Adobe_AGM_Image_1.0_0 def
/nd{
null def
}bind def
/AGMIMG_&image nd
/AGMIMG_&colorimage nd
/AGMIMG_&imagemask nd
/AGMIMG_mbuf()def
/AGMIMG_ybuf()def
/AGMIMG_kbuf()def
/AGMIMG_c 0 def
/AGMIMG_m 0 def
/AGMIMG_y 0 def
/AGMIMG_k 0 def
/AGMIMG_tmp nd
/AGMIMG_imagestring0 nd
/AGMIMG_imagestring1 nd
/AGMIMG_imagestring2 nd
/AGMIMG_imagestring3 nd
/AGMIMG_imagestring4 nd
/AGMIMG_imagestring5 nd
/AGMIMG_cnt nd
/AGMIMG_fsave nd
/AGMIMG_colorAry nd
/AGMIMG_override nd
/AGMIMG_name nd
/AGMIMG_maskSource nd
/AGMIMG_flushfilters nd
/invert_image_samples nd
/knockout_image_samples nd
/img nd
/sepimg nd
/devnimg nd
/idximg nd
/ds
{
Adobe_AGM_Core begin
Adobe_AGM_Image begin
/AGMIMG_&image systemdict/image get def
/AGMIMG_&imagemask systemdict/imagemask get def
/colorimage where{
pop
/AGMIMG_&colorimage/colorimage ldf
}if
end
end
}def
/ps
{
Adobe_AGM_Image begin
/AGMIMG_ccimage_exists{/customcolorimage where
{
pop
/Adobe_AGM_OnHost_Seps where
{
pop false
}{
/Adobe_AGM_InRip_Seps where
{
pop false
}{
true
}ifelse
}ifelse
}{
false
}ifelse
}bdf
level2{
/invert_image_samples
{
Adobe_AGM_Image/AGMIMG_tmp Decode length ddf
/Decode[Decode 1 get Decode 0 get]def
}def
/knockout_image_samples
{
Operator/imagemask ne{
/Decode[1 1]def
}if
}def
}{
/invert_image_samples
{
{1 exch sub}currenttransfer addprocs settransfer
}def
/knockout_image_samples
{
{pop 1}currenttransfer addprocs settransfer
}def
}ifelse
/img/imageormask ldf
/sepimg/sep_imageormask ldf
/devnimg/devn_imageormask ldf
/idximg/indexed_imageormask ldf
/_ctype 7 def
currentdict{
dup xcheck 1 index type dup/arraytype eq exch/packedarraytype eq or and{
bind
}if
def
}forall
}def
/pt
{
end
}def
/dt
{
}def
/AGMIMG_flushfilters
{
dup type/arraytype ne
{1 array astore}if
dup 0 get currentfile ne
{dup 0 get flushfile}if
{
dup type/filetype eq
{
dup status 1 index currentfile ne and
{closefile}
{pop}
ifelse
}{pop}ifelse
}forall
}def
/AGMIMG_init_common
{
currentdict/T known{/ImageType/T ldf currentdict/T undef}if
currentdict/W known{/Width/W ldf currentdict/W undef}if
currentdict/H known{/Height/H ldf currentdict/H undef}if
currentdict/M known{/ImageMatrix/M ldf currentdict/M undef}if
currentdict/BC known{/BitsPerComponent/BC ldf currentdict/BC undef}if
currentdict/D known{/Decode/D ldf currentdict/D undef}if
currentdict/DS known{/DataSource/DS ldf currentdict/DS undef}if
currentdict/O known{
/Operator/O load 1 eq{
/imagemask
}{
/O load 2 eq{
/image
}{
/colorimage
}ifelse
}ifelse
def
currentdict/O undef
}if
currentdict/HSCI known{/HostSepColorImage/HSCI ldf currentdict/HSCI undef}if
currentdict/MD known{/MultipleDataSources/MD ldf currentdict/MD undef}if
currentdict/I known{/Interpolate/I ldf currentdict/I undef}if
currentdict/SI known{/SkipImageProc/SI ldf currentdict/SI undef}if
/DataSource load xcheck not{
DataSource type/arraytype eq{
DataSource 0 get type/filetype eq{
/_Filters DataSource def
currentdict/MultipleDataSources known not{
/DataSource DataSource dup length 1 sub get def
}if
}if
}if
currentdict/MultipleDataSources known not{
/MultipleDataSources DataSource type/arraytype eq{
DataSource length 1 gt
}
{false}ifelse def
}if
}if
/NComponents Decode length 2 div def
currentdict/SkipImageProc known not{/SkipImageProc{false}def}if
}bdf
/imageormask_sys
{
begin
AGMIMG_init_common
save mark
level2{
currentdict
Operator/imagemask eq{
AGMIMG_&imagemask
}{
use_mask{
process_mask AGMIMG_&image
}{
AGMIMG_&image
}ifelse
}ifelse
}{
Width Height
Operator/imagemask eq{
Decode 0 get 1 eq Decode 1 get 0 eq and
ImageMatrix/DataSource load
AGMIMG_&imagemask
}{
BitsPerComponent ImageMatrix/DataSource load
AGMIMG_&image
}ifelse
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
cleartomark restore
end
}def
/overprint_plate
{
currentoverprint{
0 get dup type/nametype eq{
dup/DeviceGray eq{
pop AGMCORE_black_plate not
}{
/DeviceCMYK eq{
AGMCORE_is_cmyk_sep not
}if
}ifelse
}{
false exch
{
AGMOHS_sepink eq or
}forall
not
}ifelse
}{
pop false
}ifelse
}def
/process_mask
{
level3{
dup begin
/ImageType 1 def
end
4 dict begin
/DataDict exch def
/ImageType 3 def
/InterleaveType 3 def
/MaskDict 9 dict begin
/ImageType 1 def
/Width DataDict dup/MaskWidth known{/MaskWidth}{/Width}ifelse get def
/Height DataDict dup/MaskHeight known{/MaskHeight}{/Height}ifelse get def
/ImageMatrix[Width 0 0 Height neg 0 Height]def
/NComponents 1 def
/BitsPerComponent 1 def
/Decode DataDict dup/MaskD known{/MaskD}{[1 0]}ifelse get def
/DataSource Adobe_AGM_Core/AGMIMG_maskSource get def
currentdict end def
currentdict end
}if
}def
/use_mask
{
dup/Mask known {dup/Mask get}{false}ifelse
}def
/imageormask
{
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}
{
save mark
level2 AGMCORE_host_sep not and{
currentdict
Operator/imagemask eq DeviceN_PS2 not and{
imagemask
}{
AGMCORE_in_rip_sep currentoverprint and currentcolorspace 0 get/DeviceGray eq and{
[/Separation/Black/DeviceGray{}]setcolorspace
/Decode[Decode 1 get Decode 0 get]def
}if
use_mask{
process_mask image
}{
DeviceN_NoneName DeviceN_PS2 Indexed_DeviceN level3 not and or or AGMCORE_in_rip_sep and
{
Names convert_to_process not{
2 dict begin
/imageDict xdf
/names_index 0 def
gsave
imageDict write_image_file{
Names{
dup(None)ne{
[/Separation 3 -1 roll/DeviceGray{1 exch sub}]setcolorspace
Operator imageDict read_image_file
names_index 0 eq{true setoverprint}if
/names_index names_index 1 add def
}{
pop
}ifelse
}forall
close_image_file
}if
grestore
end
}{
Operator/imagemask eq{
imagemask
}{
image
}ifelse
}ifelse
}{
Operator/imagemask eq{
imagemask
}{
image
}ifelse
}ifelse
}ifelse
}ifelse
}{
Width Height
Operator/imagemask eq{
Decode 0 get 1 eq Decode 1 get 0 eq and
ImageMatrix/DataSource load
/Adobe_AGM_OnHost_Seps where{
pop imagemask
}{
currentgray 1 ne{
currentdict imageormask_sys
}{
currentoverprint not{
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentdict ignoreimagedata
}ifelse
}ifelse
}ifelse
}{
BitsPerComponent ImageMatrix
MultipleDataSources{
0 1 NComponents 1 sub{
DataSource exch get
}for
}{
/DataSource load
}ifelse
Operator/colorimage eq{
AGMCORE_host_sep{
MultipleDataSources level2 or NComponents 4 eq and{
AGMCORE_is_cmyk_sep{
MultipleDataSources{
/DataSource DataSource 0 get xcheck
{
[
DataSource 0 get/exec cvx
DataSource 1 get/exec cvx
DataSource 2 get/exec cvx
DataSource 3 get/exec cvx
/AGMCORE_get_ink_data cvx
]cvx
}{
DataSource aload pop AGMCORE_get_ink_data
}ifelse def
}{
/DataSource
Width BitsPerComponent mul 7 add 8 idiv Height mul 4 mul
/DataSource load
filter_cmyk 0()/SubFileDecode filter def
}ifelse
/Decode[Decode 0 get Decode 1 get]def
/MultipleDataSources false def
/NComponents 1 def
/Operator/image def
invert_image_samples
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentoverprint not Operator/imagemask eq and{
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentdict ignoreimagedata
}ifelse
}ifelse
}{
MultipleDataSources NComponents AGMIMG_&colorimage
}ifelse
}{
true NComponents colorimage
}ifelse
}{
Operator/image eq{
AGMCORE_host_sep{
/DoImage true def
currentdict/HostSepColorImage known{HostSepColorImage not}{false}ifelse
{
AGMCORE_black_plate not Operator/imagemask ne and{
/DoImage false def
currentdict ignoreimagedata
}if
}if
1 AGMCORE_&setgray
DoImage
{currentdict imageormask_sys}if
}{
use_mask{
process_mask image
}{
image
}ifelse
}ifelse
}{
Operator/knockout eq{
pop pop pop pop pop
currentcolorspace overprint_plate not{
knockout_unitsq
}if
}if
}ifelse
}ifelse
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
}def
/sep_imageormask
{
/sep_colorspace_dict AGMCORE_gget begin
CSA map_csa
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}{
save mark
AGMCORE_avoid_L2_sep_space{
/Decode[Decode 0 get 255 mul Decode 1 get 255 mul]def
}if
AGMIMG_ccimage_exists
MappedCSA 0 get/DeviceCMYK eq and
currentdict/Components known and
Name()ne and
Name(All)ne and
Operator/image eq and
AGMCORE_producing_seps not and
level2 not and
{
Width Height BitsPerComponent ImageMatrix
[
/DataSource load/exec cvx
{
0 1 2 index length 1 sub{
1 index exch
2 copy get 255 xor put
}for
}/exec cvx
]cvx bind
MappedCSA 0 get/DeviceCMYK eq{
Components aload pop
}{
0 0 0 Components aload pop 1 exch sub
}ifelse
Name findcmykcustomcolor
customcolorimage
}{
AGMCORE_producing_seps not{
level2{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne AGMCORE_avoid_L2_sep_space not and currentcolorspace 0 get/Separation ne and{
[/Separation Name MappedCSA sep_proc_name exch dup 0 get 15 string cvs(/Device)anchorsearch{pop pop 0 get}{pop}ifelse exch load]setcolorspace_opt
/sep_tint AGMCORE_gget setcolor
}if
currentdict imageormask
}{
currentdict
Operator/imagemask eq{
imageormask
}{
sep_imageormask_lev1
}ifelse
}ifelse
}{
AGMCORE_host_sep{
Operator/knockout eq{
currentdict/ImageMatrix get concat
knockout_unitsq
}{
currentgray 1 ne{
AGMCORE_is_cmyk_sep Name(All)ne and{
level2{
Name AGMCORE_IsSeparationAProcessColor
{
Operator/imagemask eq{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
/sep_tint AGMCORE_gget 1 exch sub AGMCORE_&setcolor
}if
}{
invert_image_samples
}ifelse
}{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
[/Separation Name[/DeviceGray]
{
sep_colorspace_proc AGMCORE_get_ink_data
1 exch sub
}bind
]AGMCORE_&setcolorspace
/sep_tint AGMCORE_gget AGMCORE_&setcolor
}if
}ifelse
currentdict imageormask_sys
}{
currentdict
Operator/imagemask eq{
imageormask_sys
}{
sep_image_lev1_sep
}ifelse
}ifelse
}{
Operator/imagemask ne{
invert_image_samples
}if
currentdict imageormask_sys
}ifelse
}{
currentoverprint not Name(All)eq or Operator/imagemask eq and{
currentdict imageormask_sys
}{
currentoverprint not
{
gsave
knockout_unitsq
grestore
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
currentcolorspace 0 get/Separation ne{
[/Separation Name MappedCSA sep_proc_name exch 0 get exch load]setcolorspace_opt
/sep_tint AGMCORE_gget setcolor
}if
}if
currentoverprint
MappedCSA 0 get/DeviceCMYK eq and
Name AGMCORE_IsSeparationAProcessColor not and
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{Name inRip_spot_has_ink not and}{false}ifelse
Name(All)ne and{
imageormask_l2_overprint
}{
currentdict imageormask
}ifelse
}ifelse
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
end
}def
/colorSpaceElemCnt
{
mark currentcolor counttomark dup 2 add 1 roll cleartomark
}bdf
/devn_sep_datasource
{
1 dict begin
/dataSource xdf
[
0 1 dataSource length 1 sub{
dup currentdict/dataSource get/exch cvx/get cvx/exec cvx
/exch cvx names_index/ne cvx[/pop cvx]cvx/if cvx
}for
]cvx bind
end
}bdf
/devn_alt_datasource
{
11 dict begin
/convProc xdf
/origcolorSpaceElemCnt xdf
/origMultipleDataSources xdf
/origBitsPerComponent xdf
/origDecode xdf
/origDataSource xdf
/dsCnt origMultipleDataSources{origDataSource length}{1}ifelse def
/DataSource origMultipleDataSources
{
[
BitsPerComponent 8 idiv origDecode length 2 idiv mul string
0 1 origDecode length 2 idiv 1 sub
{
dup 7 mul 1 add index exch dup BitsPerComponent 8 idiv mul exch
origDataSource exch get 0()/SubFileDecode filter
BitsPerComponent 8 idiv string/readstring cvx/pop cvx/putinterval cvx
}for
]bind cvx
}{origDataSource}ifelse 0()/SubFileDecode filter def
[
origcolorSpaceElemCnt string
0 2 origDecode length 2 sub
{
dup origDecode exch get dup 3 -1 roll 1 add origDecode exch get exch sub 2 BitsPerComponent exp 1 sub div
1 BitsPerComponent 8 idiv{DataSource/read cvx/not cvx{0}/if cvx/mul cvx}repeat/mul cvx/add cvx
}for
/convProc load/exec cvx
origcolorSpaceElemCnt 1 sub -1 0
{
/dup cvx 2/add cvx/index cvx
3 1/roll cvx/exch cvx 255/mul cvx/cvi cvx/put cvx
}for
]bind cvx 0()/SubFileDecode filter
end
}bdf
/devn_imageormask
{
/devicen_colorspace_dict AGMCORE_gget begin
CSA map_csa
2 dict begin
dup
/srcDataStrs[3 -1 roll begin
AGMIMG_init_common
currentdict/MultipleDataSources known{MultipleDataSources{DataSource length}{1}ifelse}{1}ifelse
{
Width Decode length 2 div mul cvi
{
dup 65535 gt{1 add 2 div cvi}{exit}ifelse
}loop
string
}repeat
end]def
/dstDataStr srcDataStrs 0 get length string def
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}{
save mark
AGMCORE_producing_seps not{
level3 not{
Operator/imagemask ne{
/DataSource[[
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
colorSpaceElemCnt/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource 1/string cvx/readstring cvx/pop cvx]cvx colorSpaceElemCnt 1 sub{dup}repeat]def
/MultipleDataSources true def
/Decode colorSpaceElemCnt[exch{0 1}repeat]def
}if
}if
currentdict imageormask
}{
AGMCORE_host_sep{
Names convert_to_process{
CSA get_csa_by_name 0 get/DeviceCMYK eq{
/DataSource
Width BitsPerComponent mul 7 add 8 idiv Height mul 4 mul
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
4/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource
filter_cmyk 0()/SubFileDecode filter def
/MultipleDataSources false def
/Decode[1 0]def
/DeviceGray setcolorspace
currentdict imageormask_sys
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate{
/DataSource
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
CSA get_csa_by_name 0 get/DeviceRGB eq{3}{1}ifelse/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource
/MultipleDataSources false def
/Decode colorSpaceElemCnt[exch{0 1}repeat]def
currentdict imageormask_sys
}{
gsave
knockout_unitsq
grestore
currentdict consumeimagedata
}ifelse
}ifelse
}
{
/devicen_colorspace_dict AGMCORE_gget/names_index known{
Operator/imagemask ne{
MultipleDataSources{
/DataSource[DataSource devn_sep_datasource/exec cvx]cvx def
/MultipleDataSources false def
}{
/DataSource/DataSource load dstDataStr srcDataStrs 0 get filter_devn def
}ifelse
invert_image_samples
}if
currentdict imageormask_sys
}{
currentoverprint not Operator/imagemask eq and{
currentdict imageormask_sys
}{
currentoverprint not
{
gsave
knockout_unitsq
grestore
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
currentdict imageormask
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
end
end
}def
/imageormask_l2_overprint
{
currentdict
currentcmykcolor add add add 0 eq{
currentdict consumeimagedata
}{
level3{
currentcmykcolor
/AGMIMG_k xdf
/AGMIMG_y xdf
/AGMIMG_m xdf
/AGMIMG_c xdf
Operator/imagemask eq{
[/DeviceN[
AGMIMG_c 0 ne{/Cyan}if
AGMIMG_m 0 ne{/Magenta}if
AGMIMG_y 0 ne{/Yellow}if
AGMIMG_k 0 ne{/Black}if
]/DeviceCMYK{}]setcolorspace
AGMIMG_c 0 ne{AGMIMG_c}if
AGMIMG_m 0 ne{AGMIMG_m}if
AGMIMG_y 0 ne{AGMIMG_y}if
AGMIMG_k 0 ne{AGMIMG_k}if
setcolor
}{
/Decode[Decode 0 get 255 mul Decode 1 get 255 mul]def
[/Indexed
[
/DeviceN[
AGMIMG_c 0 ne{/Cyan}if
AGMIMG_m 0 ne{/Magenta}if
AGMIMG_y 0 ne{/Yellow}if
AGMIMG_k 0 ne{/Black}if
]
/DeviceCMYK{
AGMIMG_k 0 eq{0}if
AGMIMG_y 0 eq{0 exch}if
AGMIMG_m 0 eq{0 3 1 roll}if
AGMIMG_c 0 eq{0 4 1 roll}if
}
]
255
{
255 div
mark exch
dup dup dup
AGMIMG_k 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 1 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_y 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 2 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_m 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 3 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_c 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec pop pop pop
counttomark 1 roll
}{
pop
}ifelse
counttomark 1 add -1 roll pop
}
]setcolorspace
}ifelse
imageormask_sys
}{
write_image_file{
currentcmykcolor
0 ne{
[/Separation/Black/DeviceGray{}]setcolorspace
gsave
/Black
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 1 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Yellow/DeviceGray{}]setcolorspace
gsave
/Yellow
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 2 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Magenta/DeviceGray{}]setcolorspace
gsave
/Magenta
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 3 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Cyan/DeviceGray{}]setcolorspace
gsave
/Cyan
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
close_image_file
}{
imageormask
}ifelse
}ifelse
}ifelse
}def
/indexed_imageormask
{
begin
AGMIMG_init_common
save mark
currentdict
AGMCORE_host_sep{
Operator/knockout eq{
/indexed_colorspace_dict AGMCORE_gget dup/CSA known{
/CSA get get_csa_by_name
}{
/Names get
}ifelse
overprint_plate not{
knockout_unitsq
}if
}{
Indexed_DeviceN{
/devicen_colorspace_dict AGMCORE_gget dup/names_index known exch/Names get convert_to_process or{
indexed_image_lev2_sep
}{
currentoverprint not{
knockout_unitsq
}if
currentdict consumeimagedata
}ifelse
}{
AGMCORE_is_cmyk_sep{
Operator/imagemask eq{
imageormask_sys
}{
level2{
indexed_image_lev2_sep
}{
indexed_image_lev1_sep
}ifelse
}ifelse
}{
currentoverprint not{
knockout_unitsq
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
level2{
Indexed_DeviceN{
/indexed_colorspace_dict AGMCORE_gget begin
}{
/indexed_colorspace_dict AGMCORE_gget dup null ne
{
begin
currentdict/CSDBase known{CSDBase/CSD get_res/MappedCSA get}{CSA}ifelse
get_csa_by_name 0 get/DeviceCMYK eq ps_level 3 ge and ps_version 3015.007 lt and
AGMCORE_in_rip_sep and{
[/Indexed[/DeviceN[/Cyan/Magenta/Yellow/Black]/DeviceCMYK{}]HiVal Lookup]
setcolorspace
}if
end
}
{pop}ifelse
}ifelse
imageormask
Indexed_DeviceN{
end
}if
}{
Operator/imagemask eq{
imageormask
}{
indexed_imageormask_lev1
}ifelse
}ifelse
}ifelse
cleartomark restore
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
}def
/indexed_image_lev2_sep
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
Indexed_DeviceN not{
currentcolorspace
dup 1/DeviceGray put
dup 3
currentcolorspace 2 get 1 add string
0 1 2 3 AGMCORE_get_ink_data 4 currentcolorspace 3 get length 1 sub
{
dup 4 idiv exch currentcolorspace 3 get exch get 255 exch sub 2 index 3 1 roll put
}for
put setcolorspace
}if
currentdict
Operator/imagemask eq{
AGMIMG_&imagemask
}{
use_mask{
process_mask AGMIMG_&image
}{
AGMIMG_&image
}ifelse
}ifelse
end end
}def
/OPIimage
{
dup type/dicttype ne{
10 dict begin
/DataSource xdf
/ImageMatrix xdf
/BitsPerComponent xdf
/Height xdf
/Width xdf
/ImageType 1 def
/Decode[0 1 def]
currentdict
end
}if
dup begin
/NComponents 1 cdndf
/MultipleDataSources false cdndf
/SkipImageProc{false}cdndf
/Decode[
0
currentcolorspace 0 get/Indexed eq{
2 BitsPerComponent exp 1 sub
}{
1
}ifelse
]cdndf
/Operator/image cdndf
end
/sep_colorspace_dict AGMCORE_gget null eq{
imageormask
}{
gsave
dup begin invert_image_samples end
sep_imageormask
grestore
}ifelse
}def
/cachemask_level2
{
3 dict begin
/LZWEncode filter/WriteFilter xdf
/readBuffer 256 string def
/ReadFilter
currentfile
0(%EndMask)/SubFileDecode filter
/ASCII85Decode filter
/RunLengthDecode filter
def
{
ReadFilter readBuffer readstring exch
WriteFilter exch writestring
not{exit}if
}loop
WriteFilter closefile
end
}def
/spot_alias
{
/mapto_sep_imageormask
{
dup type/dicttype ne{
12 dict begin
/ImageType 1 def
/DataSource xdf
/ImageMatrix xdf
/BitsPerComponent xdf
/Height xdf
/Width xdf
/MultipleDataSources false def
}{
begin
}ifelse
/Decode[/customcolor_tint AGMCORE_gget 0]def
/Operator/image def
/SkipImageProc{false}def
currentdict
end
sep_imageormask
}bdf
/customcolorimage
{
Adobe_AGM_Image/AGMIMG_colorAry xddf
/customcolor_tint AGMCORE_gget
<<
/Name AGMIMG_colorAry 4 get
/CSA[/DeviceCMYK]
/TintMethod/Subtractive
/TintProc null
/MappedCSA null
/NComponents 4
/Components[AGMIMG_colorAry aload pop pop]
>>
setsepcolorspace
mapto_sep_imageormask
}ndf
Adobe_AGM_Image/AGMIMG_&customcolorimage/customcolorimage load put
/customcolorimage
{
Adobe_AGM_Image/AGMIMG_override false put
current_spot_alias{dup 4 get map_alias}{false}ifelse
{
false set_spot_alias
/customcolor_tint AGMCORE_gget exch setsepcolorspace
pop
mapto_sep_imageormask
true set_spot_alias
}{
//Adobe_AGM_Image/AGMIMG_&customcolorimage get exec
}ifelse
}bdf
}def
/snap_to_device
{
6 dict begin
matrix currentmatrix
dup 0 get 0 eq 1 index 3 get 0 eq and
1 index 1 get 0 eq 2 index 2 get 0 eq and or exch pop
{
1 1 dtransform 0 gt exch 0 gt/AGMIMG_xSign? exch def/AGMIMG_ySign? exch def
0 0 transform
AGMIMG_ySign?{floor 0.1 sub}{ceiling 0.1 add}ifelse exch
AGMIMG_xSign?{floor 0.1 sub}{ceiling 0.1 add}ifelse exch
itransform/AGMIMG_llY exch def/AGMIMG_llX exch def
1 1 transform
AGMIMG_ySign?{ceiling 0.1 add}{floor 0.1 sub}ifelse exch
AGMIMG_xSign?{ceiling 0.1 add}{floor 0.1 sub}ifelse exch
itransform/AGMIMG_urY exch def/AGMIMG_urX exch def
[AGMIMG_urX AGMIMG_llX sub 0 0 AGMIMG_urY AGMIMG_llY sub AGMIMG_llX AGMIMG_llY]concat
}{
}ifelse
end
}def
level2 not{
/colorbuf
{
0 1 2 index length 1 sub{
dup 2 index exch get
255 exch sub
2 index
3 1 roll
put
}for
}def
/tint_image_to_color
{
begin
Width Height BitsPerComponent ImageMatrix
/DataSource load
end
Adobe_AGM_Image begin
/AGMIMG_mbuf 0 string def
/AGMIMG_ybuf 0 string def
/AGMIMG_kbuf 0 string def
{
colorbuf dup length AGMIMG_mbuf length ne
{
dup length dup dup
/AGMIMG_mbuf exch string def
/AGMIMG_ybuf exch string def
/AGMIMG_kbuf exch string def
}if
dup AGMIMG_mbuf copy AGMIMG_ybuf copy AGMIMG_kbuf copy pop
}
addprocs
{AGMIMG_mbuf}{AGMIMG_ybuf}{AGMIMG_kbuf}true 4 colorimage
end
}def
/sep_imageormask_lev1
{
begin
MappedCSA 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or has_color not and{
{
255 mul round cvi GrayLookup exch get
}currenttransfer addprocs settransfer
currentdict imageormask
}{
/sep_colorspace_dict AGMCORE_gget/Components known{
MappedCSA 0 get/DeviceCMYK eq{
Components aload pop
}{
0 0 0 Components aload pop 1 exch sub
}ifelse
Adobe_AGM_Image/AGMIMG_k xddf
Adobe_AGM_Image/AGMIMG_y xddf
Adobe_AGM_Image/AGMIMG_m xddf
Adobe_AGM_Image/AGMIMG_c xddf
AGMIMG_y 0.0 eq AGMIMG_m 0.0 eq and AGMIMG_c 0.0 eq and{
{AGMIMG_k mul 1 exch sub}currenttransfer addprocs settransfer
currentdict imageormask
}{
currentcolortransfer
{AGMIMG_k mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_y mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_m mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_c mul 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}ifelse
}{
MappedCSA 0 get/DeviceGray eq{
{255 mul round cvi ColorLookup exch get 0 get}currenttransfer addprocs settransfer
currentdict imageormask
}{
MappedCSA 0 get/DeviceCMYK eq{
currentcolortransfer
{255 mul round cvi ColorLookup exch get 3 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 2 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 1 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 0 get 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}{
currentcolortransfer
{pop 1}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 2 get}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 1 get}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 0 get}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}ifelse
}ifelse
}ifelse
}ifelse
end
}def
/sep_image_lev1_sep
{
begin
/sep_colorspace_dict AGMCORE_gget/Components known{
Components aload pop
Adobe_AGM_Image/AGMIMG_k xddf
Adobe_AGM_Image/AGMIMG_y xddf
Adobe_AGM_Image/AGMIMG_m xddf
Adobe_AGM_Image/AGMIMG_c xddf
{AGMIMG_c mul 1 exch sub}
{AGMIMG_m mul 1 exch sub}
{AGMIMG_y mul 1 exch sub}
{AGMIMG_k mul 1 exch sub}
}{
{255 mul round cvi ColorLookup exch get 0 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 1 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 2 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 3 get 1 exch sub}
}ifelse
AGMCORE_get_ink_data currenttransfer addprocs settransfer
currentdict imageormask_sys
end
}def
/indexed_imageormask_lev1
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
currentdict
MappedCSA 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or has_color not and{
{HiVal mul round cvi GrayLookup exch get HiVal div}currenttransfer addprocs settransfer
imageormask
}{
MappedCSA 0 get/DeviceGray eq{
{HiVal mul round cvi Lookup exch get HiVal div}currenttransfer addprocs settransfer
imageormask
}{
MappedCSA 0 get/DeviceCMYK eq{
currentcolortransfer
{4 mul HiVal mul round cvi 3 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi 2 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi 1 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
tint_image_to_color
}{
currentcolortransfer
{pop 1}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi 2 add Lookup exch get HiVal div}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi 1 add Lookup exch get HiVal div}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi Lookup exch get HiVal div}exch addprocs 4 1 roll
setcolortransfer
tint_image_to_color
}ifelse
}ifelse
}ifelse
end end
}def
/indexed_image_lev1_sep
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
{4 mul HiVal mul round cvi Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 1 add Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 2 add Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 3 add Lookup exch get HiVal div 1 exch sub}
AGMCORE_get_ink_data currenttransfer addprocs settransfer
currentdict imageormask_sys
end end
}def
}if
end
systemdict/setpacking known
{setpacking}if
%%EndResource
currentdict Adobe_AGM_Utils eq {end} if
%%EndProlog
%%BeginSetup
Adobe_AGM_Utils begin
2 2010 Adobe_AGM_Core/ds gx
Adobe_CoolType_Core/ds get exec
Adobe_AGM_Image/ds gx
currentdict Adobe_AGM_Utils eq {end} if
%%EndSetup
%%Page: (Page 1) 1
%%EndPageComments
%%BeginPageSetup
%ADOBeginClientInjection: PageSetup Start "AI11EPS"
%AI12_RMC_Transparency: Balance=75 RasterRes=300 GradRes=150 Text=0 Stroke=1 Clip=1 OP=0
%ADOEndClientInjection: PageSetup Start "AI11EPS"
Adobe_AGM_Utils begin
Adobe_AGM_Core/ps gx
Adobe_AGM_Utils/capture_cpd gx
Adobe_CoolType_Core/ps get exec
Adobe_AGM_Image/ps gx
%ADOBeginClientInjection: PageSetup End "AI11EPS"
/currentdistillerparams where
{pop currentdistillerparams /CoreDistVersion get 5000 lt} {true} ifelse
{ userdict /AI11_PDFMark5 /cleartomark load put
userdict /AI11_ReadMetadata_PDFMark5 {flushfile cleartomark } bind put}
{ userdict /AI11_PDFMark5 /pdfmark load put
userdict /AI11_ReadMetadata_PDFMark5 {/PUT pdfmark} bind put } ifelse
[/NamespacePush AI11_PDFMark5
[/_objdef {ai_metadata_stream_123} /type /stream /OBJ AI11_PDFMark5
[{ai_metadata_stream_123}
currentfile 0 (% &&end XMP packet marker&&)
/SubFileDecode filter AI11_ReadMetadata_PDFMark5
application/postscript
Kelik
Crunchy Data Solutions, Inc.
Adobe Illustrator CS3
2014-12-19T19:56:59+07:00
2014-12-19T19:56:59+07:00
2014-12-19T19:56:59+07:00
256
80
JPEG
/9j/4AAQSkZJRgABAgEASABIAAD/7QAsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA
AQBIAAAAAQAB/+4ADkFkb2JlAGTAAAAAAf/bAIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoK
DBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxscHx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8f
Hx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f/8AAEQgAUAEAAwER
AAIRAQMRAf/EAaIAAAAHAQEBAQEAAAAAAAAAAAQFAwIGAQAHCAkKCwEAAgIDAQEBAQEAAAAAAAAA
AQACAwQFBgcICQoLEAACAQMDAgQCBgcDBAIGAnMBAgMRBAAFIRIxQVEGE2EicYEUMpGhBxWxQiPB
UtHhMxZi8CRygvElQzRTkqKyY3PCNUQnk6OzNhdUZHTD0uIIJoMJChgZhJRFRqS0VtNVKBry4/PE
1OT0ZXWFlaW1xdXl9WZ2hpamtsbW5vY3R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo+Ck5SVlpeYmZ
qbnJ2en5KjpKWmp6ipqqusra6voRAAICAQIDBQUEBQYECAMDbQEAAhEDBCESMUEFURNhIgZxgZEy
obHwFMHR4SNCFVJicvEzJDRDghaSUyWiY7LCB3PSNeJEgxdUkwgJChgZJjZFGidkdFU38qOzwygp
0+PzhJSktMTU5PRldYWVpbXF1eX1RlZmdoaWprbG1ub2R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo
+DlJWWl5iZmpucnZ6fkqOkpaanqKmqq6ytrq+v/aAAwDAQACEQMRAD8A9U4q7FXYq7FXYq7FXz3/
AM5Z+ctZ0y20HRNPlktY7mR76e4iYoxe2ZPRVWG/wO3P58TikJp+W/8Azkn5YuPJ1u3m69MXmKCQ
2zwQwySyXXEApMiQqwXmDQ1oOQPtitMl/wCV1S3Z/wBwvknzJqKdFuGsxbwtWlOLyP8AwxQv/wCV
pecv/Lc6z/yMt/8AmrFVjfnVJZlRrPkrzFYKx4+slolzEDSu7RSV+W2KphpP55flfqM/1b9Nx2N3
UK9tqCSWbqx6AmdUT/hsVZvbXVtdQrPbTJPA+6SxsHQj2Zag4qqYq7FXYq7FXYq7FUv1PzF5f0oE
6nqdpYBd2NzPHDTav7bL2xVjN3+dn5UWpIl8z2TEGn7pzMPviD4qgE/5yG/Jx5jCPMaB1qCWt7tV
28HMIU/fiqZWn5zflXdkCLzRYLypT1pRD18fV4UxVkuna9oepgNpuo2t6pFQbaaOUU6/sFsVR2Ku
xV2KuxV2KuxV2KuxV2KuxV2KuxV2KsM87fm75H8nXKWWq3jS6pIAY9MtEM9yQ32aquy8u3IiuKvM
/Mmi63+bGo2V95ksG0Hyxp5ZtN01+P6RmMlObztT9wrcR8HXb5NhVlOlaX5T8n2ypp8dro8dKery
WJ27fFKx5ufmcUM58rapJfxSOky3Vquyzqwccv5eQJrtiUvO/wA8vN3mzRHiTRWKQrb3FzcOE9Q0
gWIJGqkFau0xYkg/Cppir55vPzFvzevfa3NcX/mG0e2lsXr6UNrKkyyyokS8UWka+m9V5Ek9h8Sm
n1JqOj6frcQtdSsIdTjpRYrmJZ6D/J5Biv8AscWLFm/I6bT52vfJOo6j5TvSSxit5Wms3NP27eVq
mvu5A/lxSif+VgfnD5MX/ndPLg8w6Qn2tb0QfvVX+aW3IX6dkX3wKzHyp+cH5deaEX9Ga1Atyw3s
7lvq84Phwk48v9jUYqitZ/NL8utGqNR8x2ETjrEk6Syj/nnEXf8ADFWB6n/zlH5GWYWvl+x1HzBe
PURR20BjRv8AkZ+9+6M4rSBfzn/zkj5oH+4Hytb+WLN+lzqLAzLXp8M/A/8AJDFUO35Gfm7r+/mz
8wpkjbd7Wx9Z4jXtx5Wsf/CYqjdN/wCcS/y9gPPUL7Ur+UmrVljiQ19kj51/2eKbT63/AOca/wAn
Ik4vojznb4pLu7B/4SVBii01i/Iz8pYgQvlm0Nf5/Uf/AIkxxVQufyA/J+5BEnluFankfSmuYt/+
ecq7e2KpBf8A/OLH5XzkNZnUNNlU8o3t7nkVYUof3yy9xitoQfkd+Y2ifF5T/Ma+ijX7Fnfq0sQP
/Bun/JLFV6a7/wA5L+Wx/uT0TTfNlrH9uaxkEM5p4D93+EGKo/S/+cjfKa3KWPmvTtQ8p6g2xj1C
B/Sr7Oq8+vdowMVemaRrej6zZre6TewX9o/2Z7eRZV3FaEqTQ+2Ko3FXYq7FXYq7FXYq7FXYqh9R
uxZafdXhXkLaGSYr4+mpan4Yq+Nvyk/OCx0DzLruoeaopLs+YeLT6nEoknhlVmbZWI/dv6lGAPYY
pIe6WPnfRtS8t3uv6b6sthaQyTCSaJ4A/pozsFMgWtONCRt74WL5n8tfmR5ts/Ok3mSCK31TXbxH
ijN7GZljLspDQryXgU48V3oBtgZU+iPym/OXzH5n0S/tr97WfzBbfvraVYpYoWheqrzXinSRWUlD
hQUPafnDr/mPT7uW18h6le6zprvbXL2bKbP1oyVIErLyr/khSRirFPyd/LzRNa1PXvMPnHRZdLuN
KvTOY7tHggiRwZFQIVjDvGRvyB6rthhEyNAWSxyZIwiZSNRDONf/ADhuFd7Xy1ClnaIaC7kUPK9P
2grVVQf8oE/LpnS6XsWAF5dz3dHiNf7TZJExwDhj/OO5Pw5D7fgx/wD5Wh515cv0o9f9SKn3cKZn
fyZp/wCb9/63Vfy5rf8AVD8o/qZP5Y/Oq7jmS38wIs9uxAN7EoWRK92RfhYf6oB+eYGq7FiReLY9
zt+z/abICI5xxR/nDmPeOR+FfFNPP/5J/l153s21JUi07UbhecOs2fFQ5YVDSoKRyg+J+L/KGc2Y
EGiN3tI5ImIkD6Swzyh/zi95STSprPzRcR3eomUm1v8ATbmRGMRAorRSKUDKR1ANa+26YEdEjID1
Zf5E/KzX/wAvNVWPQNRj1XyzdsFvLC9RIruCrf30VxGtJONalGCgjpvkWT01rm2R+DSor/ylgDv7
ZIRPcxMwNrVCQASTQDck5Fkppc2z14So3EVajA0HiaZIxI6MRMHq3HPBLX0pFenXiwNPuwGJHNRI
HkV+Bkppc2ztwSVGf+UMCfuGSMSOjETB6qmRZKMt7ZwuEmnjjdvsq7qpPyBOSEJHkGEskRsSFYEE
Ag1B6HIs0JqdrpF3bm21SG3uLeTrDdKjo1P8lwQcIiTyQZAc2DXP5IeSfrZ1Ty29z5Y1Jh8N5o05
hQ07NCecLL2I44kUkG070eXzlpUy2WtXdnrdtXiuoRcbO8Wv2TNbsxhf3ZHX2Q4REnoxMwOrJfrV
tz9P1k9SvHhyFa+FMeE86XjF1apkWSk91aoxR5kVh1VmAP3E5IQJ6MTMDmVXIsnYq7FXYqwn81Pz
B8s+VPL1zBqdwW1DUYJIdP06EepcTPIpQcUHRandjt9O2KvlfyD+WE2oeYYdLvY/V1YUlurLZorG
Ift3hGxlP7NvXr/eUAKlSSy//nIDU7/QtF0ny1pjrBpF4jm5VTWaT0StFf8AyDyr7n2FMJQHlv5c
webZfM8P+F4PX1AKyvzWsSxOOLmVtuC+9Qa9N8CS9c/Knybe2Hmq6+r3VtPeRRtFfTWAd7DToWcP
Ipmk/vrqTjxSPfj1Y0FMKC9r053061W00+ltbqzMIogFHKRi7tt1LMxJPc4oYr+ePmO6gXT/AC6s
po0Qur0g/bNSkamnYFWNPlnQdiYBvkPuH6Xk/abUn04hy+o/o/HuVPym/LixvLCPzBrUQuFmJ+o2
cgrHxU09SRT9qpHwg7U33qKHtTtKUZeHA13n9DHsTsWEo+LlF3yj0957/Lp193WjZWZtvqpgjNsB
xEBReFPDjSmc/wAcru93rPDjXDQruefeZfyV0fU74XWl3X6JDA+tbpF6sZavVF5x8PkNvCmbfTdt
ThGpDj+Lz+s9m8WWXFA+H3irH3ikl86eVrzyt+Ws+nzal+kLf65C9uDEYjFy5c1H7ySoJ37b18cy
dJqxn1IkI8J4Te/P7HF13Z8tNojAy448Qraq7+p/FsK8q/l95i8z6fJf6aYBBFMYG9Vyrc1VXOwV
tqOM2Wp7Rx4ZcMrurdJouxsuogZQ4aBrdF6B5n8y+RPMq6fqTSpaxSBL6xZucZjf9uPqK0PIFevT
K9RgxarHxR59C5Gk1GbQ5hCd8IO8eld4+/ZV/MWdf+VrXHE1BnsiCOhBghyPZ/8Aig90vvLLtSN6
8/1ofdF7j5s/5RbWf+YG5/5MtnMaX+9h/WH3vZ68Xp8g/oS+4vCvyxfn/if20O7/AONc6ntE/wB3
/wAMi8N2Tj/vf+Ez/Qk3kzzjdeWtch1CIl4CeF5AP92RE/EP9YdV98yNZphmxmJ59Pe4/Z2rlpso
mOXUd4/HJ9OWF9aX9nDe2comtrhBJDIvQqwqM4mcDEmJ5h9Jx5IziJRNgvnz8pXr+Y1ivh9Z/wCT
Emdd2qf8Gl8PvD592FjrVw8uL/clP/zH/NbULnUZND8uSvFBG/ozXUNfVmkrQpGRuFDbVXdvl1w+
z+zYxj4mQb93d73adr9sTlPwsJIHIkcye4fjf3JTZfk756vrY3cywWsjjn6VzKfVau+4RZACf8oj
MmfbGCJoWfcNnBx+zupmOI8IPmd/0oK31jz1+XuqJb3AkgjPxmzlbnbTLXcqQSv0qajvlk8eDVxs
b+fUNePJqtBMA7Du/hP48t06/NzzNYa/ovlnVbI0jnF2JIyatHIvoB0b3B+8b5jdlYJYZ5In+j+l
zO3tRHUY8U48jxfD6Xo/5UGv5f6SfFZj/wAl5M0/an+MS+H3B6DsKNaSA9/+6LyL82np+Y18vj9W
/wCTEedB2Uf8Gj8fvLyPbuO9XPz4f9yE1/OnQ5dJ8xwa5a1jh1CjF1NClzFSpFOnJeLD3rlHY+o4
8Zxn+H7i5ntDozjzDLHYS/3Q/H3vTNF882N15FXzPcsAsEDG8RaCk8fwsgHYu1OI9xmkzaKUc/hD
qdvc9Np+0Iy03jS6Df3j9Z5PH/I+nXfnbz011fj1IBIb3UDuV4hvhiFezNRafy18M6LWZhpsFR58
h+v8dXkOztNLWarinuL4pfq/RXc+ic499BWTzxQQSTzMEhiUvI56BVFST8hiryPR/wA8vM/mJ5rv
yx5Hm1HQI5Xhj1KfULeyaUoeqRzqAfcBziqpdfmJ+aevXE2h+WfL9jpOqoB9ZvL3UrW8+rK3QtBa
GRg2xpz+44q8q17yX508sTT+YPNMGotLO3+5Lzbbpb6hcxIfhPoD11+qLQ058CwGysv2cKvQ/wAs
rzy3H5ekh8g6TcR6ZKxF75j1McDNJ0ZY1r6k7+NOKL/MOmKlS8/flL5V806PdzelLF5q4F7TVGmk
dXdR8MMkbH00iPT4F+Hr1ryVBQun6T5E/KbyXHbawz3eo6qvH6lalheahMfhogUh0iBPEGo/4I7q
obSfzJljjg8uaNpMV1rDt+68u6QqpYacp2C3FyFIaT/fr7/FsAO6r1rTtD1IxwSXhjhkAUydQC21
eINTSvSuKHkX5+M8fniPlsHsoWX5c5B+sZ1PYx/c/wCcf0PGe0Ef8IH9UfeXs/5eXdtdeRtCltiD
GLKGNqf78iURydP8tWzn9dEjNO/5xeo7OkDp4V/NH2bFkOYrmOxV57+ercfIbn/l6h/jm07H/v8A
4F0/bovTH3hhH5T/AJneWPLPly5sNVaYXEl486CKPmODRRoN6jeqHNj2loMmbIJRqqr7S6rsftDF
gxGMyb4r5eQYx5u8wXHn7zvGdKtWU3Hp2llCwHMqpJ5ycagfaLHwHfbMzS4hpsPqPLcuv1uU6zUD
gHOgP2/jkjPzF/cfmxNBWvpy2CV8aW8AyGhN6W/633lu7Qh/hvxh90Xv/mz/AJRbWf8AmBuf+TLZ
y+m/vY/1h972GqF4p/1T9zwL8ppOX+KfbQ7r/jXOn7SP93/XDx/Y8P73/hZY55Z8t33mGPU1sKvd
afam7SACpkVXVXRf8ri1R40p3zLz6kYuHi5SNODpdDLMJcPOIv3s+/I/8wPql6PLGoSUtbpidOdj
9idusW/aTt/lf62avtfR8Q8SPMc/d+x3PYWu4D4MuR+n393x+/3sR8j6jNZeaby8hNJrWy1KaMja
jR2krD8RmfrIiWIA9ZR+8Ot0FwzSkOcYzP8AsSyH8hNMtL/zZcXdwodtPtzJbqdwJHYIG+ha0zF7
ZymOIAfxFzPZ/TxlmMj/AAjb4voTOWeyUbmysroKLq3jnC7qJUV6V8OQOSjMx5GmMoCXMW8Y/wCc
hbe1s08vx20McEbG8YpGoQE/6OK0UDfOg7EmTx2b+n9Ly/tFjA8OhX1f71j/AJY/O3VdA0K10iHT
reeK1DBZXZwx5Oz7gbftZk6jsqOWZmZHdxdJ21PDjGMRBpjHmLzVceZPM51eeFIJbholMUZJUcFV
Bud/2czMGAYcfADdW6/U5zqM3GRV0+kfzB8sjzH5UvdPRQbpV9eyO208YJUb9OW6H2OcnodR4WUS
6dfc9v2jpBnwmHXmPf8AjZ8wp5g1SDR7jRBKyWM86TzQGo/eRAr/ABFR7DwzsDiiZif8QFPBjLOO
M4/4SbI8x+PsfRn5S+VDoHlSFp046hqNLm6qPiUMP3cZ/wBVe3iTnK9p6nxcu30x2D2vZGj8DCL+
qW5/UzXNc7R41+Zvn/V/MGu335ZeTXgS9Nq58wavOx420DcUkihVd2lIlAJHStNjUqqxXzL5x0b8
qfJ1h5WsXe+1WK3k+pKwAoZZHkaeanRfUduK7nt74V5sm/5x6uNL07yJa3cP+kz6k0k+p3NeUzXH
qMG5k7kgUG/zxUvVrjVtHuLSWOYrNDIjJLbuteasKFSpFCCNsCsbtLNWSCw062WC0tkEVpaRDjHF
EuwA/rhQnUehW9pbyXV5yn9JGkaGIE1CitAB8THwGKXztr/k/wA3a/5lS7vGEXmrzCzkuDyh0XSY
qKEQggeqwbgCP8qndsVes+W9G8s+Q9AFjo4jtYYl5XupzFVeRqbu7tT7z9FBiqnonm7T/MuoPDo7
y6kkbcJdQQH6sJP5Flcj1G/1OQHemKGvzt8h3ms6Hb6tYqZ9T0qMidF+1LBSrED+ZCOQHep9s2vZ
WrGOXDL6Zfe6jtjQnLASj9UfueZfln+bN35Qd7K7ia80WZubwKQJInNAXj5bGoG6kj5jvttd2eM+
42m6fs7tA6f0neH3e56y35+/l4Lcyia5aQCv1cQNzJ8Kk8K/7LNN/JGe6ofN3p7XwVdn5PMvNv57
+Z9T1ANocjaTYRgqkYCPLIT+1IxUj5AdPfNtp+yscI+v1F0+q7Xyzl+79MU882xebx+Tz33mm7ln
vr28t5IbeVVUww0biCFVaM1amvt3rmPpzi/NVjFAA/FydTHKdITlNyJHwecQ+VL+48lSeabastvb
Xr2d5GBvGojjdJf9UtJxPhtm0OpAy+GeZFj7XTR0ROHxB0lR+zd6z/zj7qXlWe1ntI7OK38yQAmW
43aSeAn7Sly3HiaB1Wg6H5abtiGQEG7h9xd72IcXCQABkH2hhX5zGXTvzTubx1qH+qXMQOwZUiRP
+JREZn9mHi04HvDru1IcGq4v6p+X9j1Xzh+avkyTyLfz2Wow3Fzf2jw21krL64edOA9SOvJeHKrV
8Ns0+m0GUZgCKAPPps7zVa/F4JIkCSOXXfyeZfk5aTvp/nG/APoQ6PNAzducqs4H3RHNt2nMcWMf
0w6fsjF6ch/o0jv+ccX5ea9S/wCYA/8AJ6PK+2v7uP8AW/Qz7BjWSXuQ/wCdnkWTy/rS6/pqGPTb
+Tk/p1AguftECnQP9pfeo8Ml2XrPEhwS+ofaGHa2g8OfiR5H7Ckn5PQRaj58gs7gloru3vIpt9ys
lvIrfgcyO0pGOEkdCPvaOycYlno9Qfub8vazqn5Z+fJkv4GdYS1texD4fVgcgrJHXbsHX7sGbHHV
Ydj5j3rp5S0ec2PI+Y730Hpv5j+RtQshdwa3ZpHSrJPMkMi/6ySFWH3Zzc9FmiaMS9TDWYpCxIfN
hHm7/nILRtNvUtdBt11dVB9e5LtFED2VPhJb3PTwrmfp+x5SFzPC67U9swgagONhv5w69qut+XvK
mq6lYjT5Lv69JBbhix9E/V+DmoX7XUe1MzuzcUcc8kYm64f0uv7WnLLDHKQ4b4tvkz/8rvJPlDUf
IWk3t9pFrc3UySGWaSMMzETOBUn2Ga7X6vLHNICRA/Y7Ps/RYZYYkxiTXc8o/NPTtO0r8yJ7LT7d
LW1jNsUgiAVQWjQmgHiTm40GSU8FyNnd0vaGCMNTURQ2fUmci9i+XprSzn/Ot7KWJWtZNcKPDSil
Tcbig7Z1omRpLHPg/Q8ecMTraI2431DnJPYMU1zSfzKuKtpHmLT7LwjfTHf/AIdrpv8AiOKvmy+/
5x1/Ou61u61lzbfpG6nkuZLpLpY3MkrFmYcfs1LHpim0Jcf84yfnBczNPcR200zmryyXaszHpuxq
Titpr5e/Iz8//LkjvotxDZeoayRpdRtGxHdo3DIT8xitsiuvJf8AzlLcQCE31nEKcWeJ7VHb35CO
oP8Aq0woekeRIvzM0mwtrfW9ESWeCJIZri3vIpPWCKAHIlMZDGm/xHFWeTSX89kypbGGWRaFXdPh
r13UsPuwKkY8t34YuETmQAWqKkCtBX2qcNqhdV8ktq2nz6fqFvFcWlwpSWNyCKHuK9COx7Yqhfyd
8han5Q8pWmmau8Ut7bGUK0JqoWSV3G9BU8WGBWfYq8686fkh5W8x3Ml9bO2k6jKS0ssChonY9WeE
8fi91YV75stN2pkxij6out1PZePKb+mXkwof84z3/q0Ovxel/P8AV25df5fUp+OZ38tj+b9rg/yF
/T+z9rOfJf5KeVfLdxHfTF9U1KM1jnuABHGw6NHEKgH3Yn2pmBqe08mUV9MXP03ZmLEb+qXmnP5k
eT7jzb5abSLe5S1kaaOX1ZFLCiV2oPnlOi1Aw5OIi2/WafxsZhdID8v/ACLF5P8AKV/pOsXUF3a3
NxJNPIw4RenLFHEUfmafsfjk9ZrPFyCcdqDXo9H4OMwJ4rLC9N/I7UtP1+PXvK3mCCO2imMtgWVp
P3daGN2RqOtKqfEZmy7VjPHwzjd83Dh2SYZOOEqZ359/LXR/OlnD9dY2mp260gvoRyK13KMppzSu
9Kg+BG9cHSa2WA7bxPRztXooZx6tiOrzOD/nGnUzdAXGtwi1B3eOFzIR/qkhQf8AZZtD23Gto7ur
HYe+8tvc9W0zyHpOjeULzy5pA9JbuCaOS5k+J3lmjKepIRSv0ds1GTVynkE5dC7fHpY48ZhFjP5X
flLf+TNYur+51CK7S4tzAEjRlIJdXrUn/JzK13aAzxAAqi4uh7POCRN3bPde0TT9c0i60nUE9S0u
0KSDuO6svgysAR75r8WWWOQlHmHPy4oziYy5F5n5A/JLUfK3mu31qXVIrqG3WVfSWNlY+pGyA7kj
9rNpq+0xlxmNU6zR9l+Dk4uK2Zeefy68vecbVV1BDDewgrbX8NBKg68TXZ0r+yfopmFpdZPCfTy7
nN1WjhmFS597ym4/5xp1lZiLbWreSGuzSROjU/1VLj8c247bjW8S6g9hnpL7GU+T/wDnH7QdJuo7
3Wbk6vPGQ0dvw9O3DD+ZSWMlPcgeIzE1Pa85iojhH2uVpuyMeM3I8R+xNvzW/LO887DSha3sdkNP
9fl6iM3L1vTpTj0p6WU6DWjBxWLuv0t2v0Pj8O9cN/bTJPJHl6by55WsNFmmW4ks1dWmQFVblIz7
A/62YuqzeJkMx1crTYfDxiPcwPz1+S+peZfOEuvQ6nDbxSejSB42Zh6SKp3BpvxzYaXtKOLFwEXz
cHVdmnLl47rk9YzUO1eT/wDKl9S/5WJ/iv8AScPofpH6/wDVfTbnx9Tnw5VpXNv/AClHwPDr+GnV
fyafH8W+t09YzUO1dirsVdirsVdirsVdirAPzou3tfLVpIjlCb1FqDT/AHVIe3ywhUr8tnydp7rr
Fprkt/fWNpNdyafyBDcIGMi/ZHT54oVB+eEH1Rbs6JOIDL6TTep+7GwIAfhQv1+H8caSlWveeNWn
89afJZW1xLa8YZbHT/UZBcq6llkC0oOQbwPTFDKNT/NRYb24sdN0ibUrmxjMmohH4rAVH7xSeDk8
DsTQb40lR1L85NItdM06/gtHuBfhw8fqBDE0RUOrfC1T8VR4jGlU5vzjhVdPMWjzSvqRb6tEJBzZ
RMYRRQhqxZT8I+VcaVVsfzes5V1KK+02WxvtOiaX6o71ZwhAZalUKsK1pTGlSy4/NfStd0XUYrjS
phawQCW5CzAbfWI4kVW4dSZAT/HGkIy3/MrStI0LQ7XTtMkludQQta6eJq8VMzxrWVlJJd1P7OKp
pdfmXDp2iNfaxpk9hfG4a2g01jWSQqqOXViqjhSTrTGkqvlv8wl1TW30PUdNl0jU+HqQQTMWLrx5
HqqUPHfGlYn+YvKb8xdM02W4eC3vYoFZ0anFXldCd9u2IQo+XPMZ0Hzxd6WdVa+0OCOV55y3NAsU
Bl5Chb4lYcPh6nFU5X85o/SF/JodwuiGb0BqAcH4qVpw4ha03pzxpKP1T80YI9ZTSNE059ZumjSW
scgjUrJGJRx+F+XwMCcaViXmjzxr8/mjRqafdWYDW8kelvIy/WH9WtKcQKlvg3GKGU6h+abwXn6O
tdFmu9Tgtxc6hbCQKIP3YkdOXBixQNQ/CN9saSgU/OcfoaTVZdFeOD1kt4CJ6rI7K7MORjFOAQV2
PXGlRcX5w6QdEk1SWzkj/fC2tLfkGeaQIryU2AVU5jf3HjjSrovzLubsappkmmTaXr0FpLPZW0h9
RpCsZcUBRPiA+LjTfGlYT5OOha2XW+1650/zFJL/AKMzNRHrSnxHcuWJ/aHtXFCdXVzf+dPzCvNC
N3Jb6XpxkEkcZp8MDCNzToWaRupGwxVC3Gqah5U8zah5cN5Jdadc2kvpCQ1ZS8DMjezArxNOoxVk
P5K3j3WhXzu5crdUBJr/ALrXxxKXoeBXYq7FXYq7FXYq7FXl3/OQzzL5PsTEjO36QjqEBJp6E3hh
CsWsvPfky40a903TPLE9pq82lXcP10QIvxLaOzmqkt8XDFUrt55m/Iq5Jif1l1gKEKNyr6aHYEeB
xQu1bWZtD8w+RdevrWY6eul2PL0lLMTEGjZRy4jn0NK98VQesW8Giebr648ywavbaJqpe6s7rTyi
uUuG9RVkLho2Kh+LqG2PiKYqpa1Dpcdp5abSbS/XTLu9uJGGoBWmI5wRkn0kVQpCbDf54qy3859a
g0n8zPK93OGaC3W3nlWMcnKR3ZZgo2qaDbFKR3w1nzRqPmjzqmnXFnpKWbi29ZWUyN6a26BR+0eI
LNSoBxQnNm0n/Qut86ROJzODInFuRP12MVpT+UDFKR6le+WJfJegWus21/b6glhJLZalbRepGztd
TL9XlRuPdQdj+127qEDc6P581HyDZazcQ3dzaafdTCGJw7TrBKkX7xAat6YaIjpt16Yqyn8tJ/Jm
pedNPm0lNel1GBZWuJr94GgiIiZSjMicmryoPs/wxSu/NC0OqfnBoumXMcjWNxFawSMgIojzScvi
A9zirNdS/LHR9O8oa1ZeXrY/pG8t2VJZHLyOUIdYgx2UMVptSvfFXkknmm5l/L+28ixaTfHzCl6T
JEYWHw82cbfb5VbjTj2xQv8AOY0WxgispoNRsvOGmQWtvzijL2106QoKq3wspShUMvUL3xVV8wXv
mTSG8ieYPMUNzL6KpJcM6ky8Ybwyojlv2zEy05b+OKoXz95w02Pz1Jf6XNeaXBqNlC+oOgR5St1C
rkelzUCsbJVS/wBrfwxSj/Ndx5bP5VaSPK8817AupN9caRKTCdoWJ9RFqF+EClKinc4oZN+bmh6r
c+TfLGp6ZbyT2+lwAXMUAJkWOWKIq4ABNF9Lc02rilj/AJW1vysmrjWfL9j5g1PWNMt5p5YrxoWi
UrEUMZaONpGrzp28fbFCX+cNe0rztqdjD5W8u3Vrrkr0vjwCqxalOQQldupkbjt1xSndxcax+Wf5
iXOs6nZz32i6gkgmvYF51ExWV6E0UMsq9GIqMVS201aTz/501vzBbp6Gn6fYTypC7L6pCWzJEvEG
pLP8RpsOlemKFv5afmrH5S0u6srrSLu7kuJ/WV4xxAHBVp8Q/wAnFL6OwK7FXYq7FXYq7FXYq7FX
Yq7FXYq7FXYq8x/MH8s/MnmH8x/K/mXT7i0i07RpLZ72Kd5VmYQ3XrN6apG6mqdKsN8VenYq7FXY
q7FXYq7FXYq7FXYq7FXkuuflF5ri84ar5h8razZwx64hj1Gz1K2FwoDkM3AkNyHJQQpA+nCrJ/ys
/LeDyJoMlh9bN9eXUnr3dyV4KW4hQqJVqKtO5qfwwKzPFXYq7FWmVWUqwDKwoyncEHscVYNd/kx5
Hl8zWHmK1tW0+8sp1uWitTwgmZN15xU4j4qH4aV74qzrFX//2Q==
uuid:9FF31C844B89E4118B38AD403A6910BE
uuid:A0F31C844B89E4118B38AD403A6910BE
uuid:9EF31C844B89E4118B38AD403A6910BE
uuid:9DF31C844B89E4118B38AD403A6910BE
15.000000
6.000000
Centimeters
1
False
False
Cyan
Magenta
Black
Default Swatch Group
0
% &&end XMP packet marker&&
[{ai_metadata_stream_123}
<>
/PUT AI11_PDFMark5
[/Document
1 dict begin /Metadata {ai_metadata_stream_123} def
currentdict end /BDC AI11_PDFMark5
%ADOEndClientInjection: PageSetup End "AI11EPS"
%%EndPageSetup
1 -1 scale 0 -118.425 translate
pgsv
[1 0 0 1 0 0 ]ct
gsave
np
gsave
0 0 mo
0 118.425 li
394.977 118.425 li
394.977 0 li
cp
clp
[1 0 0 1 0 0 ]ct
19.7549 69.0186 mo
25.5771 66.1777 li
28.5205 58.6543 li
25.5771 66.1797 li
19.7549 69.0186 li
cp
82.2852 15.5752 mo
84.7217 13.3574 li
96.2686 10.7109 li
96.3955 10.8467 li
88.6777 13.9385 li
88.6777 13.9385 99.0977 13.165 102.572 15.0986 cv
106.043 17.0293 106.043 20.1211 106.043 20.1211 cv
106.075 20.1699 li
105.454 21.5303 104.063 23.8545 101.815 23.8545 cv
98.6377 23.8545 96.1934 23.1201 94.7256 24.5859 cv
93.2588 26.0537 92.2822 28.9873 92.2822 28.9873 cv
93.9922 31.1865 li
93.9922 31.1865 100.593 29.2314 101.815 29.2314 cv
103.037 29.2314 107.193 31.6758 107.193 31.6758 cv
107.927 28.7422 li
107.927 28.7422 111.35 30.21 114.527 31.1865 cv
117.706 32.165 118.438 32.6543 119.66 32.165 cv
120.883 31.6758 122.839 29.4766 122.839 29.4766 cv
122.839 29.4766 118.683 29.7207 116.728 28.0088 cv
114.772 26.2979 114.283 21.6523 114.772 19.4531 cv
115.262 17.2539 116.728 15.7861 116.728 15.7861 cv
116.728 15.7861 115.731 16.7813 114.257 18.042 cv
114.477 16.5674 115.365 14.8818 118.008 13.9385 cv
126.554 10.8828 133.218 12.0322 141.788 14.5225 cv
149.307 16.709 157.038 19.4346 163.837 22.2197 cv
163.428 22.1738 li
151.748 20.9717 140.362 22.8691 131.74 31.4922 cv
130.414 32.8193 129.225 34.2129 128.177 35.6689 cv
127.334 35.2031 126.146 34.5889 125.065 34.1943 cv
123.127 33.4883 120.129 34.1943 118.017 34.373 cv
115.901 34.5498 113.608 40.0205 113.608 40.0205 cv
114.137 40.374 117.838 38.7861 124.184 39.667 cv
124.722 39.7422 125.196 39.8203 125.615 39.9014 cv
123.506 44.1309 122.433 48.8018 122.433 53.8604 cv
122.433 54.5771 122.454 55.2881 122.497 55.9922 cv
116.783 56.8545 114.653 58.2793 109.652 60.6357 cv
103.88 63.3516 93.6904 75.2373 93.6904 75.2373 cv
93.6904 75.2373 100.822 70.8223 105.916 66.748 cv
111.01 62.6729 121.879 60.9736 121.879 60.9736 cv
124.131 64.3604 li
124.386 65.0996 124.669 65.8281 124.981 66.543 cv
124.364 67.5469 122.562 70.4414 117.802 77.9531 cv
116.644 79.7852 116.043 81.2168 115.837 82.3408 cv
14.7275 82.3408 li
16.8047 75.5186 li
22.6475 76.7725 li
22.6475 76.7725 21.5977 73.8828 21.5977 72.3057 cv
21.5977 70.7305 23.1729 70.2031 25.5342 68.8906 cv
27.8926 67.5771 29.4668 64.6865 30.5186 61.7979 cv
31.5703 58.9082 39.6992 61.0098 45.7363 59.4326 cv
46.0195 59.3594 46.2881 59.2881 46.5459 59.2178 cv
44.8896 60.6709 40.3984 65.1582 44.5313 67.8672 cv
49.5156 71.1377 57.25 72.3398 58.626 71.8252 cv
60 71.3105 62.5762 67.5225 67.7354 62.5322 cv
72.8916 57.541 73.374 55.9209 76.2959 55.0615 cv
79.2188 54.2002 82.9795 60.835 85.6982 56.0654 cv
86.1523 55.3848 81.3145 51.3447 80.2832 51.3447 cv
79.251 51.3447 72.7188 54.4404 69.625 56.6797 cv
66.5322 58.918 61.7207 62.3594 61.7207 62.3594 cv
61.7207 62.3594 58.7979 58.4023 55.876 57.8838 cv
54.1602 57.5811 51.4395 57.9307 49.4844 58.2705 cv
51.9932 57.2949 52.7881 56.3555 56.2275 54.4434 cv
60.9512 51.8145 82.9863 31.8506 82.9863 31.8506 cv
82.9863 31.8506 81.4131 32.1123 77.4775 32.1123 cv
73.542 32.1123 71.4443 29.4863 71.4443 26.8584 cv
71.4443 24.2334 75.1162 24.2334 77.4775 23.1816 cv
79.2549 22.3916 82.8809 15.54 82.2852 15.5752 cv
cp
74.9365 44.0313 mo
74.9365 44.0313 67.5205 53.3809 63.9746 54.3496 cv
60.4277 55.3154 58.8164 55.9619 58.8164 55.9619 cv
58.8164 55.9619 63.9746 58.2188 67.5205 56.2822 cv
71.0674 54.3496 72.0342 52.4131 72.6797 50.8027 cv
73.3252 49.1885 74.6143 44.6758 74.9365 44.0313 cv
cp
111.285 40.6963 mo
111.285 40.6963 105.684 47.4189 101.481 49.6602 cv
97.2793 51.9023 88.5947 58.9043 87.4736 61.7051 cv
87.2842 62.1797 86.9492 62.8242 86.5244 63.5664 cv
84.6221 64.4219 70.2422 70.9756 68.5449 74.0361 cv
66.7266 77.3135 73.2734 81.6855 78.0039 81.6855 cv
82.7324 81.6855 83.4619 81.3184 84.1875 79.5 cv
84.9141 77.6787 87.8252 68.5713 87.8252 68.5713 cv
87.7754 68.3389 li
89.3232 65.0498 91.3223 60.666 97.2793 56.9453 cv
104.001 52.7422 110.725 47.4189 111.005 44.6172 cv
111.285 41.8164 111.285 40.6963 111.285 40.6963 cv
cp
183.195 25.4912 mo
185.947 24.9873 li
187.441 29.9678 li
183.195 25.4912 li
cp
false sop
/0
[/DeviceCMYK] /CSA add_res
0 0 0 0.2 cmyk
ef
61.3281 44.1543 mo
55.1865 48.2129 50.9814 52.3965 43.6748 55.8047 cv
43.1602 55.9365 38.2422 57.0195 32.9072 55.5977 cv
27.6162 55.1182 25.0918 57.7158 24.3955 59.8018 cv
23.7012 61.8877 23.7793 64.6689 21.6934 66.0586 cv
19.6074 67.4502 15.0879 70.9268 14.043 75.4463 cv
13.002 79.9658 12.6543 82.252 12.6543 82.252 cv
33.7949 82.2422 54.9355 82.2305 76.0742 82.2207 cv
62.0518 81.6533 62.1406 78.1113 63.0674 75.4463 cv
58.3457 79.0215 35.4531 79.5947 39.7725 66.0586 cv
41.1631 62.584 44.292 59.8018 44.292 59.8018 cv
44.292 59.8018 38.0322 60.4971 36.9912 64.6689 cv
35.9492 68.8408 30.6631 70.9268 30.6631 70.9268 cv
28.3242 79.9326 11.4922 72.9551 24.752 68.2148 cv
26.4902 66.1299 27.6045 66.0586 27.6045 64.3213 cv
27.6045 62.584 27.6045 58.4102 33.5137 58.4102 cv
39.4238 58.4102 44.292 59.4531 50.8975 55.6299 cv
57.5049 51.8047 80.4512 33.3779 80.4512 33.3779 cv
80.4512 33.3779 73.498 34.4199 70.0195 31.9863 cv
66.5449 29.5527 67.2393 24.6846 70.3672 24.6846 cv
78.1592 23.0488 79.8252 18.127 89.7666 13.8242 cv
102.715 9.4541 122.715 8.00391 139.905 12.168 cv
151.376 14.9502 179.54 26.0762 186.146 31.6406 cv
187.235 32.5537 189.251 31.7793 190.784 31.7793 cv
188.468 29.2822 188.928 27.8154 188.928 27.8154 cv
188.928 27.8154 196.228 28.1611 201.444 30.249 cv
204.53 31.4834 206.762 32.4756 208.071 33.0791 cv
208.071 32.1699 li
206.768 30.7266 204.817 28.6729 203.53 27.8154 cv
201.444 26.4238 199.009 26.4238 199.009 26.4238 cv
216.259 20.8223 240.3 15.5498 258.23 15.1221 cv
290.347 11.502 335.718 26.3477 356.526 33.5781 cv
336.302 20.4961 295.238 10.8369 268.892 9.73633 cv
254.43 8.62305 228.911 13.5596 218.132 16.6875 cv
207.355 19.8184 187.884 24.3379 184.06 24.3379 cv
180.234 24.3379 160.633 14.8193 149.639 11.8213 cv
130.78 6.52246 112.891 5.17871 94.0117 9.73633 cv
91.5771 10.083 90.5342 10.4307 90.5342 10.4307 cv
93.2041 8.8291 85.3389 1.17578 83.9268 0 cv
83.9268 0 79.7549 5.5625 79.7549 9.04004 cv
79.7549 12.5176 81.4922 14.9502 81.4922 14.9502 cv
81.4922 14.9502 76.9746 19.8184 72.1074 20.8613 cv
67.2393 21.9043 63.416 25.0332 62.0244 29.2041 cv
60.6338 33.3779 61.3281 38.9404 61.3281 40.6777 cv
61.3281 42.417 61.3281 44.1543 61.3281 44.1543 cv
0 0 0 1 cmyk
ef
129.473 13.5596 mo
131.212 12.5176 132.951 11.8213 132.951 11.8213 cv
134.479 14.9385 137.84 24.3486 133.646 26.7725 cv
130.863 28.5107 127.735 28.8574 127.735 28.8574 cv
128.083 30.4805 128.432 32.1025 128.778 33.7236 cv
129.188 34.3369 li
128.866 34.7383 128.557 35.1436 128.259 35.5557 cv
126.76 34.6396 125.137 33.2842 124.954 31.6406 cv
124.606 28.5107 125.301 27.4668 125.301 27.4668 cv
125.301 27.4668 132.951 25.3809 133.3 22.251 cv
133.646 19.1221 132.302 14.1963 132.302 14.1963 cv
132.302 14.1963 126.344 17.3838 125.301 20.8613 cv
124.26 24.3379 122.521 24.3379 122.521 24.3379 cv
121.314 23.9268 120.583 22.5762 120.781 20.8613 cv
121.459 16.9961 125.854 15.7324 129.473 13.5596 cv
ef
93.6631 25.0332 mo
88.7412 24.7881 85.1309 29.9209 85.3184 35.8115 cv
83.5811 39.2881 79.4092 43.1123 79.4092 43.1123 cv
79.8711 44.7354 80.334 46.3574 80.7979 47.9795 cv
79.0605 49.7197 77.3213 51.457 75.584 53.1963 cv
75.584 53.1963 79.4092 50.4141 82.5381 53.1963 cv
85.666 55.9766 85.666 57.7158 85.666 57.7158 cv
85.666 57.7158 93.5713 47.6592 97.7422 45.2246 cv
102.865 44.6953 105.324 42.8623 106.18 40.5537 cv
107.222 38.8145 106.227 36.4395 106.227 36.4395 cv
105.479 38.4326 99.54 43.2715 96.0967 40.5742 cv
93.9189 39.0029 94.252 36.5713 96.9131 34.6787 cv
99.5742 32.5439 104.094 33.0293 104.094 33.0293 cv
104.094 33.0293 103.051 28.5098 100.617 28.5098 cv
98.1826 28.5098 94.7061 30.5957 94.0117 28.5098 cv
93.3145 26.4238 93.6631 25.0332 93.6631 25.0332 cv
ef
109.196 30.5498 mo
111.975 31.8916 112.797 35.0342 112.124 39.0215 cv
113.693 39.0215 115.053 34.5322 119.366 34.5322 cv
120.85 34.5322 125.373 34.9561 127.54 36.584 cv
128.06 35.8076 128.616 35.0469 129.213 34.3027 cv
127.66 31.5342 126.934 30.5957 124.954 30.5957 cv
122.867 30.5957 119.591 32.7021 116.238 32.3447 cv
114.019 32.1377 112.034 29.0205 109.196 30.5498 cv
ef
110.699 40.3291 mo
110.699 40.3291 105.831 45.5459 102.008 47.6318 cv
98.1826 49.7197 96.791 52.1514 96.791 52.1514 cv
96.791 52.1514 101.659 50.7627 105.137 47.6318 cv
108.613 44.5029 110.699 40.3291 110.699 40.3291 cv
ef
104.441 52.499 mo
104.441 52.499 94.0117 58.7588 90.5342 62.9297 cv
87.0566 67.1016 85.3184 72.666 85.3184 72.666 cv
85.3184 72.666 94.0117 64.6699 97.4873 60.8447 cv
100.965 57.0195 104.441 52.499 104.441 52.499 cv
ef
112.437 54.585 mo
112.437 54.585 102.354 58.4102 97.4873 63.2773 cv
92.6201 68.1455 91.5771 75.0996 91.5771 75.0996 cv
91.5771 75.0996 100.269 63.9727 105.484 61.1904 cv
110.699 58.4102 112.437 54.585 112.437 54.585 cv
ef
124.023 26.2744 mo
125.671 22.1143 127.697 17.6133 130.58 16.7393 cv
130.58 16.7393 128.472 20.0527 129.665 21.2432 cv
130.857 22.4355 133.499 19.3496 133.773 18.334 cv
134.604 21.8398 133.959 25.877 129.785 26.6719 cv
125.613 27.4668 124.023 26.2744 124.023 26.2744 cv
ef
95.2402 38.0352 mo
94.8633 35.8799 101.882 31.4043 105.548 34.75 cv
105.546 38.6484 100.375 40.4961 97.3486 39.9102 cv
99.1445 39.248 103.124 38.0859 103.258 35.4717 cv
100.435 34.6602 97.7715 35.6523 95.2402 38.0352 cv
ef
100.445 34.6191 mo
101.738 34.6191 102.785 35.6689 102.785 36.9609 cv
102.785 38.2539 101.738 39.3037 100.445 39.3037 cv
99.1523 39.3037 98.1045 38.2539 98.1045 36.9609 cv
98.1045 35.6689 99.1523 34.6191 100.445 34.6191 cv
ef
78.1514 36.7051 mo
78.1514 36.7051 63.8828 49.2383 58.376 52.9971 cv
55.3379 54.9238 54.3398 55.3633 48.5801 56.7578 cv
56.5605 56.5664 62.7471 54.7754 68.1396 48.9883 cv
71.4883 43.6992 78.1514 36.7051 78.1514 36.7051 cv
ef
119.811 69.3398 mo
115.662 70.9775 111.518 72.6172 107.37 74.2568 cv
110.973 75.8018 111.531 78.3604 111.531 82.0762 cv
111.531 82.0762 113.916 82.3115 114.244 80.0176 cv
114.571 77.7217 113.588 75.5215 113.588 75.5215 cv
114.773 73.1777 118.063 70.9775 119.811 69.3398 cv
ef
49.6133 58.0928 mo
54.7139 57.292 59.9609 59.6162 62.0723 64.2617 cv
62.0723 64.2617 63.3408 62.0439 66.1943 59.8232 cv
69.0479 57.6035 75.3887 53.7988 75.3887 53.7988 cv
75.3887 53.7988 65.7305 58.5566 63.1943 58.2393 cv
58.2764 57.0146 55.5146 56.0361 49.6133 58.0928 cv
ef
89.2461 26.9473 mo
90.6973 23.8691 99.5195 23.1572 103.017 23.8711 cv
103.017 23.8711 96.6387 24.3037 94.748 25.7363 cv
93.4551 26.7178 93.084 28.877 93.084 28.877 cv
92.2139 28.5762 90.1143 27.2471 89.2461 26.9473 cv
ef
124.654 16.5166 mo
119.8 16.7285 117.983 20.7813 119.496 25.0674 cv
114.891 21.041 117.998 13.5713 124.654 16.5166 cv
ef
15.0635 77.6289 mo
0 79.1367 li
18.0771 81.3965 li
15.0635 77.6289 li
cp
ef
gsave
154.107 80.6592 mo
146.741 80.6592 140.455 78.0361 135.249 72.7852 cv
130.044 67.5371 127.441 61.2266 127.441 53.8604 cv
127.441 46.5361 130.055 40.2617 135.283 35.0342 cv
140.51 29.8057 146.786 27.1914 154.107 27.1914 cv
159.447 27.1914 164.343 28.6592 168.801 31.5918 cv
173.255 34.5264 176.542 38.3525 178.66 43.0742 cv
167.476 43.0742 li
165.931 41.2217 163.958 39.71 161.555 38.541 cv
159.149 37.3711 156.668 36.7881 154.107 36.7881 cv
149.389 36.7881 145.362 38.4521 142.032 41.7842 cv
138.7 45.1123 137.036 49.1377 137.036 53.8604 cv
137.036 58.624 138.692 62.6621 142 65.9688 cv
145.308 69.2793 149.346 70.9316 154.107 70.9316 cv
156.668 70.9316 159.138 70.3477 161.521 69.1797 cv
163.903 68.0098 165.888 66.4775 167.476 64.5801 cv
178.66 64.5801 li
176.586 69.3438 173.321 73.2168 168.865 76.1943 cv
164.41 79.1709 159.49 80.6592 154.107 80.6592 cv
cp
360.11 36.9668 mo
368.553 36.9668 li
377.102 54.9521 li
386.04 36.9668 li
394.977 36.9668 li
380.688 64.8281 li
380.688 80.6592 li
372.579 80.6592 li
372.579 64.2754 li
360.11 36.9668 li
cp
327.471 36.999 mo
335.63 36.999 li
335.63 55.0244 li
349.135 55.0244 li
349.135 36.999 li
357.295 36.999 li
357.295 80.6592 li
349.135 80.6592 li
349.135 63.2939 li
335.63 63.2939 li
335.63 80.6592 li
327.471 80.6592 li
327.471 36.999 li
cp
304.758 81.1563 mo
298.62 81.1563 293.383 78.9697 289.047 74.5957 cv
284.71 70.2227 282.542 64.9668 282.542 58.8281 cv
282.542 52.7285 284.719 47.5 289.074 43.1455 cv
293.429 38.791 298.656 36.6133 304.758 36.6133 cv
309.205 36.6133 313.285 37.835 316.995 40.2783 cv
320.708 42.7227 323.446 45.9111 325.209 49.8428 cv
315.893 49.8428 li
314.607 48.2988 312.964 47.04 310.959 46.0674 cv
308.957 45.0947 306.89 44.6064 304.758 44.6064 cv
300.826 44.6064 297.472 45.9951 294.697 48.7676 cv
291.923 51.543 290.536 54.8965 290.536 58.8281 cv
290.536 62.7979 291.914 66.1621 294.671 68.918 cv
297.426 71.6748 300.788 73.0527 304.758 73.0527 cv
306.89 73.0527 308.947 72.5645 310.933 71.5908 cv
312.916 70.6182 314.569 69.3398 315.893 67.7598 cv
325.209 67.7598 li
323.482 71.7295 320.764 74.9551 317.052 77.4365 cv
313.339 79.915 309.24 81.1563 304.758 81.1563 cv
cp
245.772 36.999 mo
253.104 36.999 li
272.068 64.7813 li
272.068 36.999 li
280.227 36.999 li
280.227 80.6592 li
272.675 80.6592 li
253.931 52.9297 li
253.931 80.6592 li
245.772 80.6592 li
245.772 36.999 li
cp
213.08 36.999 mo
221.241 36.999 li
221.241 62.6328 li
221.241 64.1768 li
221.241 66.125 221.432 67.7695 221.817 69.1104 cv
222.203 70.4521 222.93 71.4268 223.997 72.0313 cv
225.062 72.6396 226.146 72.9424 227.248 72.9424 cv
228.424 72.9424 229.546 72.6484 230.61 72.0596 cv
231.678 71.4717 232.422 70.4141 232.843 68.8906 cv
233.266 67.3652 233.478 65.7207 233.478 63.9561 cv
233.478 62.8535 li
233.478 36.999 li
241.692 36.999 li
241.692 63.9004 li
241.692 67.2451 241.195 70.1768 240.205 72.6934 cv
239.211 75.2109 237.437 77.2422 234.884 78.7861 cv
232.33 80.3301 229.767 81.1016 227.193 81.1016 cv
224.694 81.1016 222.103 80.3193 219.421 78.7568 cv
216.737 77.1943 215.01 75.1465 214.238 72.6123 cv
213.467 70.0742 213.08 66.748 213.08 62.6328 cv
213.08 36.999 li
cp
181.328 36.999 mo
193.29 36.999 li
197.002 36.999 200.088 37.5137 202.552 38.543 cv
205.015 39.5723 206.906 41.4268 208.229 44.1104 cv
209.553 46.793 210.215 49.291 210.215 51.6084 cv
210.215 54.4746 209.525 56.9199 208.146 58.9385 cv
206.769 60.96 205.279 62.4131 203.683 63.2939 cv
202.084 64.1768 200.512 64.7109 198.969 64.8945 cv
210.491 80.6592 li
200.677 80.6592 li
189.486 65.5 li
189.486 80.6592 li
181.328 80.6592 li
181.328 36.999 li
cp
195.604 58.1133 mo
197.406 58.1133 198.95 57.4668 200.236 56.1816 cv
201.521 54.8965 202.166 53.333 202.166 51.498 cv
202.166 49.6602 201.541 48.0986 200.291 46.8105 cv
199.043 45.5254 197.48 44.8818 195.604 44.8818 cv
189.486 44.8818 li
189.486 58.1133 li
195.604 58.1133 li
cp
clp
394.977 81.1563 mo
394.977 27.1914 li
127.441 27.1914 li
127.441 81.1563 li
394.977 81.1563 li
cp
level3{
gsave
clp
[-2.35879e-06 -53.9628 267.531 -4.75783e-07 261.265 81.1416 ]ct
/0
<<
/ShadingType 2
/ColorSpace /0 /CSA get_res
/Coords [0 0 1 0 ]
/Domain [0 1 ]
/Extend[ true true]
/Function
<<
/Domain[0 1 ]
/FunctionType 3
/Functions [
<<
/Domain[0 1 ]
/Range[0 1 0 1 0 1 0 1 ]
/FunctionType 0
/Order 1
/DataSource <~pRV?bpRM9apRD3`pR;-_pmM0_pm;$]pm1s\pltgZplb[XplYUWplGIUpl5=Spl#1Qpkf%OpkSnMq1\kL
q1J_Jq1/MGq0rAEq0`5Cq0N)Aq02l>q/u`
/BitsPerSample 8
/Encode [0 63 ]
/Decode [0 1 0 1 0 1 0 1 ]
/Size [64 ]
>>
]
/Bounds []
/Encode [0 1 ]
>>
>>/Gradient add_res /0 /Gradient get_res clonedict shfill grestore
}if
level3 not{
gsave
[-2.35879e-06 -53.9628 267.531 -4.75783e-07 261.265 81.1416 ]ct
clp
/0 {
/0 /CSA get_res setcolorspace
<<
/NumSamples 256
/NumComp 4
/Scaling[[0.00392157 0 ][0.00392157 0 ][0.00392157 0 ][0.00392157 0 ]]
/Samples[
<~p@e4Rp@e4Rp@e4Rp@n=Up\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\=OYq"XXZ
q"XXZq"XXZq"XXZq"XXZq"XXZq"XXZq"XXZq"X[\q>'j^q>'j^q>'j^q>'j^q>'j^q>'j^q>'j^q>'m`
qYL'bqYL'bqYL'bqYL'bqYL'bqYL'bqYL'bqYL'cqtp9fqtp9fqtp9fqtp9fqtp9fqtp9fqtp9gr;?Kj
r;?Kjr;?Kjr;?Kjr;?Kjr;?Kjr;?KjrVc]nrVc]nrVc]nrVc]nrVc]nrVc]nrr2ors8W-!s8W-!s8W-!
~>
<~SXl=BSXc4?S=?";S!oe7R[KS2R$X/+Q^3r&Q'@MsPEM)lP*(lgOH5H_NfB$WN/NUOMM[1GLkgb?L4t>7
KS4u0JUr?%It)orI=6KjH[C'aG^+FVG'8"NFEDSEEcH&;Df9N1D/=!'C2.HsBP1phAS#C_@q&kT?sd5H
?!U`@>?Y35=BAR)<`N.!;c6Lj:esk^9he;S91hfJ84Z6?77BU36:*t'5X.Fq4Zkee3]T/Y2`g,pX][+sA*P+!)ID*#fh8)&O2,()7Ms&eP]e%hB-Z$k*LN#mgkB"pG,3!WiB&
~>
0 0 ]
>>
0 0 1 0 []true true []
/DeviceCMYK
GenStrips
} /Gradient add_res /0 /Gradient get_res exec grestore
}if
np
grestore
gsave
99.4893 96.4805 mo
103.66 96.5508 li
106.966 96.5508 li
107.243 96.7246 li
107.104 98.4639 li
107.035 100.068 li
106.757 100.376 li
103.278 100.376 li
99.4893 100.376 li
99.4893 106.219 li
103.905 106.219 li
108.043 106.219 li
108.321 106.427 li
108.112 108.27 li
107.973 110.078 li
107.625 110.321 li
93.9248 110.321 li
93.7852 110.078 li
93.8887 98.5674 li
93.7852 87.3691 li
93.8887 87.125 li
107.451 87.125 li
107.833 87.4395 li
107.694 89.3164 li
107.625 91.1309 li
107.278 91.3691 li
103.348 91.3691 li
99.4893 91.3691 li
99.4893 96.4805 li
cp
118.325 97.1758 mo
118.068 97.0361 117.751 96.9688 117.379 96.9688 cv
116.841 96.9688 116.389 97.0947 116.012 97.3496 cv
115.207 98.0107 li
115.207 101.837 li
115.207 103.182 115.225 104.584 115.265 106.044 cv
115.306 107.505 115.34 108.849 115.38 110.078 cv
115.207 110.321 li
110.024 110.321 li
109.815 110.078 li
109.921 101.939 li
109.815 93.8037 li
110.061 93.4561 li
110.447 93.4316 110.837 93.3994 111.214 93.3506 cv
111.596 93.3057 112.076 93.2354 112.65 93.1416 cv
115.102 92.6904 li
115.38 93.0381 li
115.38 94.5332 li
116.882 93.3057 118.383 92.6904 119.885 92.6904 cv
120.765 92.6904 121.681 92.9502 122.638 93.4736 cv
123.599 93.9951 124.22 94.7881 124.51 95.8535 cv
124.799 96.9209 124.944 98.1504 124.944 99.541 cv
124.944 101.837 li
124.944 103.389 124.967 104.845 125.014 106.199 cv
125.061 107.557 125.118 108.849 125.188 110.078 cv
124.944 110.321 li
119.832 110.321 li
119.554 110.078 li
119.727 102.498 li
119.727 102.219 119.727 101.945 119.727 101.68 cv
119.727 101.413 119.727 101.141 119.727 100.861 cv
119.727 99.9346 119.635 99.1631 119.449 98.5498 cv
119.258 97.9346 118.888 97.4785 118.325 97.1758 cv
cp
127.97 96.4111 mo
126.16 96.5156 li
125.918 96.2021 li
126.127 93.1074 li
126.403 92.793 li
127.97 92.793 li
127.899 88.7617 li
128.109 88.4824 li
133.082 87.0908 li
133.289 87.3008 li
133.289 92.793 li
136.28 92.793 li
136.525 93.1074 li
136.211 96.2021 li
135.932 96.4111 li
133.22 96.4111 li
133.289 103.158 li
133.289 104.479 li
133.289 105.083 133.33 105.547 133.412 105.87 cv
133.493 106.194 133.679 106.467 133.967 106.688 cv
134.258 106.908 134.658 107.017 135.168 107.017 cv
135.632 107.017 136.06 106.891 136.455 106.636 cv
136.768 106.844 li
136.65 107.237 136.542 107.776 136.437 108.461 cv
136.333 109.145 136.28 109.729 136.28 110.217 cv
135.793 110.53 li
135.093 110.692 134.171 110.774 133.035 110.774 cv
132.287 110.774 131.633 110.722 131.059 110.618 cv
130.49 110.513 129.923 110.275 129.365 109.904 cv
128.811 109.533 128.422 108.879 128.212 107.939 cv
128.004 107.001 127.899 105.917 127.899 104.687 cv
127.899 103.782 li
127.97 96.4111 li
cp
152.625 102.741 mo
152.208 102.983 li
142.366 103.192 li
142.481 104.027 142.725 104.723 143.097 105.278 cv
143.467 105.835 144.012 106.246 144.73 106.513 cv
145.449 106.779 146.169 106.913 146.888 106.913 cv
148.464 106.913 150.052 106.462 151.652 105.557 cv
151.929 105.765 li
151.755 109.487 li
151.304 109.834 li
149.75 110.461 148.034 110.774 146.157 110.774 cv
145.137 110.774 144.175 110.668 143.271 110.461 cv
142.366 110.251 141.357 109.787 140.245 109.069 cv
139.132 108.351 138.344 107.302 137.881 105.922 cv
137.417 104.542 137.185 102.926 137.185 101.07 cv
137.185 99.4727 137.486 98.0225 138.089 96.7246 cv
138.692 95.4268 139.671 94.4297 141.028 93.7334 cv
142.383 93.0381 143.815 92.6904 145.321 92.6904 cv
146.898 92.6904 148.231 93.0313 149.322 93.7158 cv
150.41 94.4004 151.234 95.4512 151.789 96.8643 cv
152.347 98.2773 152.625 100.236 152.625 102.741 cv
cp
146.394 96.5508 mo
146.064 96.3418 145.612 96.2363 145.026 96.2363 cv
144.632 96.2363 144.214 96.3359 143.786 96.5342 cv
143.352 96.7305 143.01 97.125 142.749 97.7158 cv
142.494 98.3076 142.366 98.915 142.366 99.541 cv
147.513 99.541 li
147.513 98.8223 147.455 98.2305 147.34 97.7676 cv
147.224 97.3037 146.905 96.8975 146.394 96.5508 cv
cp
159.718 110.078 mo
159.58 110.321 li
154.399 110.321 li
154.189 110.078 li
154.295 101.939 li
154.189 93.8037 li
154.427 93.4561 li
154.821 93.4316 155.204 93.3994 155.58 93.3506 cv
155.958 93.3057 156.434 93.2354 157.006 93.1416 cv
159.447 92.6904 li
159.718 93.0381 li
159.718 95.6816 li
160.276 94.6602 160.92 93.9248 161.649 93.4736 cv
162.38 93.0215 163.173 92.7598 164.031 92.6904 cv
164.31 93.0381 li
164.263 93.2695 164.165 93.7207 164.014 94.3936 cv
163.862 95.0664 163.764 95.5176 163.718 95.751 cv
163.369 98.4277 li
163.023 98.5332 li
162.652 98.2998 162.211 98.1846 161.702 98.1846 cv
161.307 98.1846 160.912 98.3242 160.518 98.6025 cv
160.124 98.8818 159.869 99.4141 159.754 100.201 cv
159.639 100.99 159.58 101.743 159.58 102.462 cv
159.58 103.76 159.598 105.083 159.627 106.427 cv
159.655 107.771 159.689 108.988 159.718 110.078 cv
cp
171.231 94.0811 mo
171.786 93.6172 172.436 93.2695 173.189 93.0381 cv
173.938 92.8057 174.674 92.6904 175.392 92.6904 cv
176.451 92.6904 177.46 92.9502 178.422 93.4736 cv
179.379 93.9951 180.166 94.9971 180.782 96.4805 cv
181.392 97.9639 181.697 99.3086 181.697 100.516 cv
181.697 102.162 181.368 103.819 180.707 105.488 cv
180.046 107.156 179.106 108.346 177.889 109.053 cv
176.673 109.759 175.565 110.211 174.568 110.407 cv
173.572 110.605 172.414 110.703 171.092 110.703 cv
171.231 118.181 li
171.022 118.425 li
165.84 118.425 li
165.631 118.181 li
165.77 105.174 li
165.631 93.8037 li
165.874 93.4561 li
166.27 93.4316 166.657 93.3994 167.039 93.3506 cv
167.423 93.3057 167.903 93.2354 168.482 93.1416 cv
170.952 92.6904 li
171.231 93.0381 li
171.231 94.0811 li
cp
171.022 105.07 mo
171.126 106.947 li
171.856 106.947 172.43 106.918 172.841 106.861 cv
173.253 106.803 173.769 106.606 174.383 106.27 cv
175.003 105.934 175.479 105.268 175.808 104.271 cv
176.14 103.273 176.307 102.288 176.307 101.313 cv
176.307 100.388 176.181 99.541 175.926 98.7764 cv
175.67 98.0107 175.266 97.4551 174.708 97.1064 cv
174.15 96.7578 173.605 96.585 173.074 96.585 cv
172.655 96.585 172.262 96.6494 171.892 96.7764 cv
171.521 96.9043 171.266 97.0488 171.126 97.21 cv
171.022 105.07 li
cp
188.652 110.078 mo
188.514 110.321 li
183.332 110.321 li
183.124 110.078 li
183.227 101.939 li
183.124 93.8037 li
183.361 93.4561 li
183.756 93.4316 184.139 93.3994 184.515 93.3506 cv
184.893 93.3057 185.366 93.2354 185.94 93.1416 cv
188.38 92.6904 li
188.652 93.0381 li
188.652 95.6816 li
189.209 94.6602 189.853 93.9248 190.584 93.4736 cv
191.313 93.0215 192.107 92.7598 192.966 92.6904 cv
193.243 93.0381 li
193.197 93.2695 193.098 93.7207 192.948 94.3936 cv
192.797 95.0664 192.698 95.5176 192.652 95.751 cv
192.304 98.4277 li
191.957 98.5332 li
191.585 98.2998 191.145 98.1846 190.635 98.1846 cv
190.24 98.1846 189.847 98.3242 189.452 98.6025 cv
189.059 98.8818 188.804 99.4141 188.688 100.201 cv
188.571 100.99 188.514 101.743 188.514 102.462 cv
188.514 103.76 188.529 105.083 188.562 106.427 cv
188.589 107.771 188.623 108.988 188.652 110.078 cv
cp
199.815 84.6924 mo
200.023 85.0039 li
200.023 87.125 li
200.023 89.2129 li
199.647 89.5957 li
197.417 89.8047 li
195.087 90.1162 li
194.844 89.8721 li
194.844 87.7871 li
194.844 85.5957 li
195.255 85.2822 li
197.347 85.0732 li
197.781 85.0732 198.239 85.0283 198.72 84.9346 cv
199.194 84.8428 199.567 84.7617 199.815 84.6924 cv
cp
194.809 110.321 mo
194.6 110.078 li
194.704 101.939 li
194.6 93.8037 li
194.844 93.4561 li
195.238 93.4316 195.625 93.3994 196.009 93.3506 cv
196.392 93.3057 196.872 93.2354 197.451 93.1416 cv
199.921 92.6904 li
200.198 93.0381 li
200.158 94.3125 200.122 95.7383 200.082 97.3154 cv
200.043 98.8916 200.023 100.4 200.023 101.837 cv
200.023 103.182 200.043 104.584 200.082 106.044 cv
200.122 107.505 200.158 108.849 200.198 110.078 cv
199.921 110.321 li
194.809 110.321 li
cp
214.456 93.9082 mo
214.317 94.6035 214.218 95.1826 214.161 95.6465 cv
214.103 96.1104 214.073 96.666 214.073 97.3154 cv
213.692 97.4551 li
213.11 96.9912 212.475 96.6367 211.777 96.3955 cv
211.083 96.1504 210.398 96.0273 209.728 96.0273 cv
209.332 96.0273 209.025 96.0684 208.805 96.1504 cv
208.585 96.2314 208.365 96.3467 208.145 96.498 cv
207.924 96.6494 207.791 96.8516 207.743 97.1064 cv
207.651 97.6182 207.743 98.0107 208.021 98.29 cv
208.301 98.5674 208.719 98.8223 209.274 99.0537 cv
210.179 99.3672 li
211.731 100.016 212.926 100.59 213.762 101.09 cv
214.596 101.588 215.013 102.717 215.013 104.479 cv
215.013 105.522 214.81 106.542 214.403 107.54 cv
213.998 108.535 213.425 109.237 212.671 109.644 cv
211.917 110.049 211.117 110.333 210.259 110.496 cv
209.408 110.657 208.539 110.738 207.664 110.738 cv
206.619 110.738 205.629 110.646 204.696 110.461 cv
203.758 110.275 203.015 109.997 202.458 109.627 cv
202.111 109.208 li
202.203 108.535 202.261 107.887 202.285 107.262 cv
202.309 106.636 202.33 106.032 202.354 105.453 cv
202.703 105.313 li
204.232 106.658 205.798 107.331 207.397 107.331 cv
207.722 107.331 208.034 107.291 208.335 107.21 cv
208.637 107.127 208.887 107.001 209.084 106.827 cv
209.28 106.653 209.425 106.443 209.519 106.199 cv
209.61 105.957 209.658 105.777 209.658 105.662 cv
209.658 105.384 209.564 105.121 209.379 104.879 cv
209.194 104.636 208.289 104.126 206.667 103.348 cv
205.044 102.572 204.024 101.935 203.606 101.436 cv
203.188 100.938 202.893 100.4 202.72 99.8184 cv
202.547 99.2393 202.458 98.6729 202.458 98.1152 cv
202.458 97.5596 202.615 96.7246 202.929 95.6123 cv
203.241 94.499 204.07 93.7334 205.415 93.3164 cv
206.759 92.8994 207.987 92.6904 209.101 92.6904 cv
210.956 92.6904 212.625 92.9912 214.107 93.5957 cv
214.456 93.9082 li
cp
231.496 102.741 mo
231.079 102.983 li
221.237 103.192 li
221.354 104.027 221.597 104.723 221.967 105.278 cv
222.34 105.835 222.885 106.246 223.604 106.513 cv
224.321 106.779 225.039 106.913 225.758 106.913 cv
227.334 106.913 228.922 106.462 230.523 105.557 cv
230.801 105.765 li
230.628 109.487 li
230.175 109.834 li
228.622 110.461 226.906 110.774 225.027 110.774 cv
224.008 110.774 223.046 110.668 222.142 110.461 cv
221.237 110.251 220.229 109.787 219.116 109.069 cv
218.003 108.351 217.214 107.302 216.75 105.922 cv
216.288 104.542 216.056 102.926 216.056 101.07 cv
216.056 99.4727 216.356 98.0225 216.96 96.7246 cv
217.563 95.4268 218.543 94.4297 219.898 93.7334 cv
221.256 93.0381 222.687 92.6904 224.193 92.6904 cv
225.771 92.6904 227.104 93.0313 228.192 93.7158 cv
229.282 94.4004 230.106 95.4512 230.661 96.8643 cv
231.219 98.2773 231.496 100.236 231.496 102.741 cv
cp
225.266 96.5508 mo
224.934 96.3418 224.482 96.2363 223.898 96.2363 cv
223.504 96.2363 223.086 96.3359 222.656 96.5342 cv
222.223 96.7305 221.881 97.125 221.621 97.7158 cv
221.366 98.3076 221.237 98.915 221.237 99.541 cv
226.385 99.541 li
226.385 98.8223 226.327 98.2305 226.21 97.7676 cv
226.095 97.3037 225.775 96.8975 225.266 96.5508 cv
cp
244.781 102.498 mo
244.919 110.078 li
244.746 110.321 li
239.218 110.321 li
239.078 110.078 li
239.182 98.5674 li
239.078 87.3691 li
239.182 87.125 li
245.522 87.125 li
248.356 87.125 250.455 87.3584 251.816 87.8223 cv
253.174 88.2861 254.106 88.9277 254.622 89.752 cv
255.132 90.5752 255.469 91.3574 255.631 92.0986 cv
255.794 92.8418 255.875 93.6172 255.875 94.4297 cv
255.875 96.167 255.526 97.6514 254.832 98.8818 cv
254.136 100.109 253.104 101.019 251.735 101.609 cv
250.368 102.202 248.444 102.498 245.964 102.498 cv
244.781 102.498 li
cp
244.781 98.4277 mo
245.928 98.4277 li
246.3 98.4277 246.752 98.3887 247.285 98.3076 cv
247.819 98.2256 248.345 98.0342 248.866 97.7334 cv
249.39 97.4307 249.76 97.0195 249.979 96.498 cv
250.2 95.9766 250.311 95.2979 250.311 94.4639 cv
250.311 93.6533 250.137 92.9971 249.782 92.498 cv
249.429 92.001 248.936 91.6641 248.305 91.4893 cv
247.667 91.3164 246.843 91.2295 245.834 91.2295 cv
244.781 91.2295 li
244.781 98.4277 li
cp
263.664 92.793 mo
264.082 92.7256 264.568 92.6904 265.125 92.6904 cv
266.307 92.6904 267.473 92.876 268.621 93.2461 cv
269.767 93.6172 270.683 94.2041 271.367 95.002 cv
272.052 95.8027 272.545 96.8398 272.845 98.1152 cv
273.146 99.3916 273.296 100.689 273.296 102.01 cv
273.296 102.773 273.262 103.453 273.192 104.045 cv
273.122 104.636 272.96 105.354 272.705 106.199 cv
272.451 107.048 271.958 107.857 271.228 108.634 cv
270.498 109.412 269.61 109.956 268.567 110.268 cv
267.524 110.582 266.389 110.738 265.161 110.738 cv
264.023 110.738 262.97 110.611 261.995 110.356 cv
261.021 110.102 260.118 109.627 259.281 108.93 cv
258.447 108.235 257.833 107.291 257.438 106.097 cv
257.044 104.903 256.848 103.61 256.848 102.219 cv
256.848 101.779 256.854 101.431 256.864 101.175 cv
256.877 100.92 256.929 100.312 257.022 99.3506 cv
257.114 98.3887 257.456 97.3496 258.048 96.2363 cv
258.639 95.124 259.584 94.2207 260.882 93.5244 cv
261.369 93.3164 261.826 93.1543 262.256 93.0381 cv
262.685 92.9229 263.154 92.8418 263.664 92.793 cv
cp
262.585 105.139 mo
262.771 105.743 262.999 106.206 263.265 106.531 cv
263.532 106.856 263.827 107.053 264.152 107.122 cv
264.477 107.192 264.754 107.227 264.986 107.227 cv
265.657 107.227 266.231 107.035 266.708 106.653 cv
267.183 106.27 267.513 105.633 267.698 104.739 cv
267.883 103.848 267.977 102.856 267.977 101.768 cv
267.977 101.256 267.964 100.811 267.942 100.427 cv
267.919 100.045 267.854 99.4941 267.751 98.7764 cv
267.645 98.0576 267.473 97.5195 267.229 97.1592 cv
266.984 96.7998 266.679 96.54 266.307 96.376 cv
265.937 96.2148 265.576 96.1328 265.23 96.1328 cv
264.719 96.1328 264.255 96.248 263.838 96.4805 cv
263.282 96.8516 262.876 97.5459 262.621 98.5674 cv
262.366 99.5879 262.239 100.712 262.239 101.939 cv
262.239 102.613 262.272 103.232 262.342 103.801 cv
262.412 104.369 262.494 104.815 262.585 105.139 cv
cp
286.511 93.9082 mo
286.373 94.6035 286.274 95.1826 286.217 95.6465 cv
286.157 96.1104 286.128 96.666 286.128 97.3154 cv
285.747 97.4551 li
285.168 96.9912 284.53 96.6367 283.834 96.3955 cv
283.14 96.1504 282.454 96.0273 281.782 96.0273 cv
281.389 96.0273 281.08 96.0684 280.859 96.1504 cv
280.641 96.2314 280.42 96.3467 280.199 96.498 cv
279.98 96.6494 279.846 96.8516 279.801 97.1064 cv
279.707 97.6182 279.801 98.0107 280.079 98.29 cv
280.356 98.5674 280.773 98.8223 281.33 99.0537 cv
282.233 99.3672 li
283.787 100.016 284.982 100.59 285.816 101.09 cv
286.651 101.588 287.067 102.717 287.067 104.479 cv
287.067 105.522 286.866 106.542 286.461 107.54 cv
286.054 108.535 285.479 109.237 284.728 109.644 cv
283.974 110.049 283.173 110.333 282.316 110.496 cv
281.463 110.657 280.595 110.738 279.718 110.738 cv
278.676 110.738 277.686 110.646 276.751 110.461 cv
275.812 110.275 275.069 109.997 274.514 109.627 cv
274.166 109.208 li
274.26 108.535 274.317 107.887 274.341 107.262 cv
274.363 106.636 274.388 106.032 274.41 105.453 cv
274.758 105.313 li
276.287 106.658 277.853 107.331 279.452 107.331 cv
279.776 107.331 280.091 107.291 280.391 107.21 cv
280.693 107.127 280.941 107.001 281.139 106.827 cv
281.335 106.653 281.482 106.443 281.573 106.199 cv
281.667 105.957 281.713 105.777 281.713 105.662 cv
281.713 105.384 281.619 105.121 281.434 104.879 cv
281.249 104.636 280.346 104.126 278.723 103.348 cv
277.1 102.572 276.078 101.935 275.662 101.436 cv
275.244 100.938 274.949 100.4 274.775 99.8184 cv
274.601 99.2393 274.514 98.6729 274.514 98.1152 cv
274.514 97.5596 274.67 96.7246 274.983 95.6123 cv
275.297 94.499 276.126 93.7334 277.47 93.3164 cv
278.814 92.8994 280.042 92.6904 281.157 92.6904 cv
283.012 92.6904 284.68 92.9912 286.164 93.5957 cv
286.511 93.9082 li
cp
289.259 96.4111 mo
287.45 96.5156 li
287.207 96.2021 li
287.416 93.1074 li
287.695 92.793 li
289.259 92.793 li
289.189 88.7617 li
289.398 88.4824 li
294.371 87.0908 li
294.58 87.3008 li
294.58 92.793 li
297.57 92.793 li
297.814 93.1074 li
297.502 96.2021 li
297.223 96.4111 li
294.511 96.4111 li
294.58 103.158 li
294.58 104.479 li
294.58 105.083 294.621 105.547 294.701 105.87 cv
294.782 106.194 294.967 106.467 295.259 106.688 cv
295.549 106.908 295.948 107.017 296.458 107.017 cv
296.922 107.017 297.352 106.891 297.745 106.636 cv
298.057 106.844 li
297.941 107.237 297.831 107.776 297.728 108.461 cv
297.622 109.145 297.57 109.729 297.57 110.217 cv
297.084 110.53 li
296.383 110.692 295.46 110.774 294.326 110.774 cv
293.577 110.774 292.923 110.722 292.349 110.618 cv
291.781 110.513 291.212 110.275 290.655 109.904 cv
290.101 109.533 289.711 108.879 289.504 107.939 cv
289.294 107.001 289.189 105.917 289.189 104.687 cv
289.189 103.782 li
289.259 96.4111 li
cp
314.575 92.8633 mo
314.714 93.1074 li
314.611 94.6035 li
314.575 96.2725 li
314.263 96.5508 li
312.211 96.376 li
312.651 97.3262 312.871 98.2666 312.871 99.1934 cv
312.871 100.027 312.675 100.827 312.281 101.593 cv
311.887 102.356 311.278 102.99 310.455 103.487 cv
309.631 103.986 308.92 104.3 308.316 104.427 cv
307.713 104.555 307.134 104.624 306.578 104.636 cv
306.021 104.648 305.604 104.653 305.325 104.653 cv
304.873 105.628 li
307.064 106.322 li
308.989 106.901 310.455 107.446 311.464 107.956 cv
312.471 108.468 313.121 109.117 313.41 109.904 cv
313.7 110.692 313.845 111.376 313.845 111.956 cv
313.845 112.65 313.741 113.318 313.533 113.956 cv
313.324 114.592 312.912 115.26 312.297 115.955 cv
311.683 116.651 310.755 117.189 309.516 117.572 cv
308.276 117.953 306.972 118.146 305.604 118.146 cv
304.792 118.146 304.017 118.088 303.273 117.973 cv
302.206 117.74 301.257 117.347 300.422 116.79 cv
299.588 116.233 299.048 115.619 298.805 114.946 cv
298.562 114.272 298.439 113.693 298.439 113.208 cv
298.439 112.65 298.526 112.113 298.701 111.591 cv
298.874 111.07 299.112 110.623 299.413 110.251 cv
299.715 109.881 299.958 109.608 300.144 109.434 cv
300.329 109.261 300.527 109.093 300.733 108.93 cv
300.527 108.79 300.329 108.641 300.144 108.479 cv
299.958 108.314 299.773 108.13 299.588 107.921 cv
299.588 107.505 li
299.982 106.926 300.363 106.304 300.733 105.645 cv
301.106 104.984 301.406 104.351 301.64 103.75 cv
299.97 102.658 299.09 101.62 298.996 100.636 cv
298.903 99.6514 298.858 98.9971 298.858 98.6729 cv
298.858 98 298.974 97.3213 299.205 96.6367 cv
299.436 95.9531 299.883 95.2637 300.544 94.5684 cv
301.205 93.8721 302.127 93.415 303.309 93.1953 cv
304.491 92.9746 305.882 92.8633 307.481 92.8633 cv
314.575 92.8633 li
cp
303.97 99.7852 mo
304.225 100.736 304.591 101.274 305.065 101.401 cv
305.54 101.529 305.835 101.593 305.95 101.593 cv
306.368 101.593 306.753 101.448 307.099 101.156 cv
307.447 100.869 307.696 100.498 307.848 100.045 cv
307.997 99.5928 308.072 99.1123 308.072 98.6025 cv
308.072 98.4873 308.062 98.3584 308.038 98.2188 cv
308.014 98.0791 307.992 97.8896 307.968 97.6445 cv
307.944 97.4014 307.806 97.0947 307.55 96.7246 cv
307.295 96.3535 307.019 96.1104 306.716 95.9932 cv
306.415 95.8779 306.159 95.8213 305.95 95.8213 cv
305.604 95.8213 305.256 95.9365 304.907 96.167 cv
304.562 96.4004 304.299 96.7764 304.127 97.2988 cv
303.951 97.8193 303.864 98.334 303.864 98.8447 cv
303.864 99.2168 303.899 99.5303 303.97 99.7852 cv
cp
302.961 113.208 mo
303.055 113.672 303.298 114.071 303.691 114.407 cv
304.086 114.744 304.508 114.962 304.961 115.068 cv
305.412 115.174 305.882 115.225 306.368 115.225 cv
306.693 115.225 306.983 115.2 307.238 115.155 cv
307.492 115.109 307.737 115.011 307.968 114.859 cv
308.201 114.708 308.392 114.471 308.542 114.147 cv
308.693 113.821 308.768 113.497 308.768 113.173 cv
308.768 113.012 308.722 112.795 308.63 112.53 cv
308.537 112.263 308.112 111.985 307.359 111.695 cv
306.605 111.404 305.87 111.145 305.152 110.912 cv
304.004 110.53 li
303.309 111.411 302.961 112.199 302.961 112.894 cv
302.961 113.208 li
cp
321.704 110.078 mo
321.564 110.321 li
316.385 110.321 li
316.176 110.078 li
316.281 101.939 li
316.176 93.8037 li
316.414 93.4561 li
316.807 93.4316 317.189 93.3994 317.567 93.3506 cv
317.943 93.3057 318.419 93.2354 318.992 93.1416 cv
321.433 92.6904 li
321.704 93.0381 li
321.704 95.6816 li
322.262 94.6602 322.905 93.9248 323.636 93.4736 cv
324.365 93.0215 325.159 92.7598 326.017 92.6904 cv
326.296 93.0381 li
326.249 93.2695 326.151 93.7207 326 94.3936 cv
325.849 95.0664 325.749 95.5176 325.704 95.751 cv
325.356 98.4277 li
325.008 98.5332 li
324.638 98.2998 324.198 98.1846 323.688 98.1846 cv
323.292 98.1846 322.897 98.3242 322.504 98.6025 cv
322.109 98.8818 321.854 99.4141 321.739 100.201 cv
321.623 100.99 321.564 101.743 321.564 102.462 cv
321.564 103.76 321.584 105.083 321.612 106.427 cv
321.642 107.771 321.675 108.988 321.704 110.078 cv
cp
342.535 102.741 mo
342.119 102.983 li
332.277 103.192 li
332.393 104.027 332.637 104.723 333.007 105.278 cv
333.378 105.835 333.923 106.246 334.642 106.513 cv
335.36 106.779 336.078 106.913 336.797 106.913 cv
338.374 106.913 339.962 106.462 341.562 105.557 cv
341.84 105.765 li
341.666 109.487 li
341.215 109.834 li
339.661 110.461 337.945 110.774 336.067 110.774 cv
335.048 110.774 334.085 110.668 333.182 110.461 cv
332.277 110.251 331.269 109.787 330.156 109.069 cv
329.042 108.351 328.255 107.302 327.79 105.922 cv
327.328 104.542 327.096 102.926 327.096 101.07 cv
327.096 99.4727 327.396 98.0225 327.999 96.7246 cv
328.603 95.4268 329.582 94.4297 330.937 93.7334 cv
332.294 93.0381 333.727 92.6904 335.233 92.6904 cv
336.809 92.6904 338.142 93.0313 339.23 93.7158 cv
340.322 94.4004 341.146 95.4512 341.701 96.8643 cv
342.259 98.2773 342.535 100.236 342.535 102.741 cv
cp
336.305 96.5508 mo
335.975 96.3418 335.522 96.2363 334.937 96.2363 cv
334.544 96.2363 334.126 96.3359 333.697 96.5342 cv
333.263 96.7305 332.919 97.125 332.659 97.7158 cv
332.404 98.3076 332.277 98.915 332.277 99.541 cv
337.425 99.541 li
337.425 98.8223 337.366 98.2305 337.248 97.7676 cv
337.133 97.3037 336.813 96.8975 336.305 96.5508 cv
cp
357.802 88.2383 mo
357.419 92.5508 li
357.14 92.6904 li
355.425 91.3691 353.758 90.708 352.133 90.708 cv
351.508 90.708 350.877 90.8809 350.238 91.2295 cv
349.601 91.5781 349.283 92.2021 349.283 93.1074 cv
349.283 93.6865 349.566 94.2041 350.134 94.6553 cv
350.703 95.1074 351.393 95.4961 352.202 95.8213 cv
353.073 96.167 li
354.836 96.8867 356.161 97.7451 357.054 98.7422 cv
357.947 99.7373 358.462 101.024 358.602 102.602 cv
358.602 103.853 358.393 105.1 357.977 106.339 cv
357.559 107.58 356.893 108.506 355.977 109.122 cv
355.061 109.737 354.115 110.164 353.142 110.407 cv
352.169 110.652 351.113 110.774 349.979 110.774 cv
348.702 110.774 347.515 110.641 346.413 110.373 cv
345.312 110.107 344.355 109.718 343.544 109.208 cv
343.302 108.825 li
343.347 108.525 343.412 108.148 343.493 107.696 cv
343.572 107.245 343.613 106.96 343.613 106.844 cv
343.788 104.653 li
344.102 104.514 li
345.955 105.929 347.798 106.636 349.63 106.636 cv
350.441 106.636 351.241 106.422 352.03 105.992 cv
352.818 105.563 353.211 104.85 353.211 103.853 cv
353.211 103.134 352.945 102.555 352.411 102.115 cv
351.878 101.674 351.078 101.198 350.012 100.689 cv
349.074 100.236 li
347.428 99.4482 346.153 98.5918 345.249 97.6641 cv
344.343 96.7363 343.892 95.4727 343.892 93.8721 cv
343.892 92.7129 344.112 91.5713 344.553 90.4463 cv
344.992 89.3223 345.764 88.4258 346.866 87.7529 cv
347.967 87.0801 349.56 86.7441 351.647 86.7441 cv
352.781 86.7441 353.896 86.8711 354.985 87.125 cv
356.075 87.3799 357.014 87.7529 357.802 88.2383 cv
cp
375.259 109.627 mo
375.746 109.857 376.291 110.107 376.893 110.373 cv
377.495 110.641 378 110.856 378.405 111.017 cv
378.813 111.179 379.269 111.342 379.779 111.505 cv
380.29 111.666 380.741 111.816 381.136 111.956 cv
381.24 112.304 li
379.502 115.955 li
379.084 116.128 li
378.344 115.688 377.536 115.231 376.667 114.749 cv
375.797 114.272 374.934 113.816 374.076 113.377 cv
373.218 112.935 372.204 112.433 371.034 111.875 cv
369.862 111.317 369.023 110.912 368.513 110.657 cv
367.424 110.542 366.426 110.309 365.521 109.956 cv
364.617 109.608 363.661 108.994 362.652 108.112 cv
361.645 107.227 360.891 105.998 360.394 104.415 cv
359.895 102.839 359.645 101.129 359.645 99.292 cv
359.645 98.8047 359.667 98.2998 359.714 97.7744 cv
359.761 97.252 359.854 96.4111 359.991 95.2471 cv
360.131 94.0889 360.624 92.7314 361.47 91.1885 cv
362.316 89.6416 363.336 88.5918 364.53 88.0371 cv
365.726 87.4736 366.56 87.125 367.034 86.9863 cv
367.51 86.8496 368.036 86.7783 368.617 86.7783 cv
369.081 86.7783 369.485 86.7783 369.833 86.7783 cv
371.318 86.7783 372.803 87.0332 374.285 87.5439 cv
375.77 88.0527 376.94 88.8359 377.797 89.8906 cv
378.655 90.9453 379.269 92.2266 379.642 93.7334 cv
380.012 95.2393 380.196 96.8271 380.196 98.498 cv
380.196 100.561 379.966 102.322 379.502 103.782 cv
379.038 105.244 378.48 106.443 377.831 107.382 cv
377.183 108.321 376.326 109.069 375.259 109.627 cv
cp
368.096 91.3691 mo
367.284 91.8779 366.628 92.8057 366.131 94.1504 cv
365.632 95.4961 365.383 97.0264 365.383 98.7422 cv
365.383 100.341 365.504 101.779 365.748 103.053 cv
365.991 104.329 366.42 105.186 367.034 105.628 cv
367.649 106.066 368.17 106.344 368.6 106.462 cv
369.028 106.577 369.463 106.636 369.902 106.636 cv
370.506 106.636 371.056 106.531 371.556 106.322 cv
372.054 106.113 372.528 105.703 372.981 105.088 cv
373.433 104.473 373.752 103.732 373.937 102.862 cv
374.122 101.993 374.261 101.164 374.354 100.376 cv
374.446 99.5879 374.494 98.7998 374.494 98.0107 cv
374.494 96.6904 374.366 95.4961 374.11 94.4297 cv
373.855 93.3623 373.473 92.5801 372.963 92.0811 cv
372.454 91.583 371.983 91.248 371.556 91.0732 cv
371.126 90.8984 370.669 90.8135 370.182 90.8135 cv
369.857 90.8135 369.562 90.8477 369.296 90.917 cv
369.028 90.9873 368.803 91.0508 368.617 91.1084 cv
368.433 91.167 368.258 91.2529 368.096 91.3691 cv
cp
381.762 110.321 mo
381.623 110.078 li
381.726 98.5674 li
381.623 87.3691 li
381.726 87.125 li
387.291 87.125 li
387.466 87.3691 li
387.418 88.9922 387.384 90.7998 387.361 92.793 cv
387.337 94.7881 387.326 96.7119 387.326 98.5674 cv
387.326 106.079 li
394.733 105.974 li
394.977 106.356 li
394.697 109.974 li
394.456 110.321 li
381.762 110.321 li
cp
clp
394.977 118.425 mo
394.977 84.6924 li
93.7852 84.6924 li
93.7852 118.425 li
394.977 118.425 li
cp
/0
<<
/Name (Black)
/CSA /0 get_csa_by_name
/MappedCSA /0 /CSA get_res
/TintMethod /Subtractive
/TintProc null
/NComponents 4
/Components [ 0 0 0 1 ]
>>
/CSD add_res
1 /0 /CSD get_res sepcs
level3{
gsave
clp
[0 -33.7323 301.188 0 244.39 118.423 ]ct
/1
<<
/ShadingType 2
/ColorSpace [/Separation /sep_colorspace_dict AGMCORE_gget dup /Name get exch /MappedCSA get /sep_colorspace_proc load]
/Coords [0 0 1 0 ]
/Domain [0 1 ]
/Extend[ true true]
/Function
<<
/Domain[0 1 ]
/FunctionType 3
/Functions [
<<
/Domain[0 1 ]
/FunctionType 2
/C0 [1 ]
/C1 [0.5 ]
/N 1
>>
]
/Bounds []
/Encode [0 1 ]
>>
>>/Gradient add_res /1 /Gradient get_res clonedict shfill grestore
}if
level3 not{
gsave
[0 -33.7323 301.188 0 244.39 118.423 ]ct
clp
/1 {
<<
/NumSamples 256
/NumComp 1
/Scaling[[0.00392157 0 ]]
/Samples[
<~s8N#rrVZTjqtg0bq=saZp\+=Rp%7nJoCDJBnaQ&:n*]W2mHj3*lg!d"l0.?okN:pgjlGL_j5T(WiS`YO
hqm5Gh;$f?gY1B7g"=s/f@JO'e^W*te'c[ldEp7dcd'h\c-4DTbK@uLaiMQDa2Z-<`Pf^4_ns:,_8*k$
^V7Fq]tD"i]=PSa\[]/Y\$i`Q[C!fV50o^US=KVTqJ'N
T:VXFSXc4>S!oe6R@'A.Q^3r&Q'@MsPEM)kOcYZcO,f6[NJrgSMi*CKM26tCLPCP;KnP,3K7\]+JUi9#
~>
]
>>
0 0 1 0 []true true []
/Separation
GenStrips
} /Gradient add_res /1 /Gradient get_res exec grestore
}if
np
grestore
%ADOBeginClientInjection: EndPageContent "AI11EPS"
userdict /annotatepage 2 copy known {get exec}{pop pop} ifelse
%ADOEndClientInjection: EndPageContent "AI11EPS"
grestore
grestore
pgrs
%%PageTrailer
%ADOBeginClientInjection: PageTrailer Start "AI11EPS"
[/EMC AI11_PDFMark5
[/NamespacePop AI11_PDFMark5
%ADOEndClientInjection: PageTrailer Start "AI11EPS"
[
[/CSA [/0 ]]
[/CSD [/0 ]]
[/Gradient [/0 /1 ]]
] del_res
Adobe_AGM_Image/pt gx
Adobe_CoolType_Core/pt get exec
Adobe_AGM_Core/pt gx
currentdict Adobe_AGM_Utils eq {end} if
%%Trailer
Adobe_AGM_Image/dt get exec
Adobe_CoolType_Core/dt get exec
Adobe_AGM_Core/dt get exec
%%EOF
%AI9_PrintingDataEnd
userdict /AI9_read_buffer 256 string put
userdict begin
/ai9_skip_data
{
mark
{
currentfile AI9_read_buffer { readline } stopped
{
}
{
not
{
exit
} if
(%AI9_PrivateDataEnd) eq
{
exit
} if
} ifelse
} loop
cleartomark
} def
end
userdict /ai9_skip_data get exec
%AI9_PrivateDataBegin
%!PS-Adobe-3.0 EPSF-3.0
%%Creator: Adobe Illustrator(R) 13.0
%%AI8_CreatorVersion: 13.0.0
%%For: (Fitri Ardiwahyudi) ()
%%Title: (Crunchy_EnterprisePostgreSQL.eps)
%%CreationDate: 12/19/14 7:57 PM
%AI9_DataStream
%Gb!R&q-NX9Z7,Y,!;?IC1./ni"r/"B5X@hY_O3ta&2:n'q`TG!CHpA*ktGVsf\bEG4T6D?Uf5fL;cctCV7ka6F?/Rr-XW_7J*#H:
%PAqr_S3+\8h8pAonp5)hS&&@e-H`X@!#e>UaUC"$7%"IMKdTbq2BC,\A,N^Cr#JHH9l\l+bie*PGUh![md`T5M>O%="a<#qd^[aF
%\\,nfe@RCS%tpqWgKD%m;$L<9j6ri+E8835rcSNUcCJK*F?/lO6/Bcd#(T(ualTj#DnPEIRK.EU5Pp/hF*&Z*Nk`%-MZr_pHGDl1
%aqsHV\mo\ZqXHf-%).JfL"KN:Vj#^4JUKWTSW,^h!?Q]AiM%cF,+Cokb'0g2N!$PH0[V/`-Fbo/`[%huQZ.!s)bjm"S3*9QUKNUK
%P%PJ,%K84)r&Y/Ukm]"ul27$0[5mRc+r/'cC\YYPfZ?,"3Ql!hC`7i%1MLn0AiUogGE^teL5B>O$%RqJIk]0Yj"_?/Y#!)27"q-m_aq7e)3)p+"-LqB+h3sM-F_HNh![chOc:^9E?HMGa58j8'BM1r!h5$Zh-'NBc!YWB`gojrLfo\,,o@1U
%"HB.,Tm<-C^ajF"24Wae5eT]N'2>CX'Obo[*;1-8VW7(Qq7m)iAlSf:oKVS#&7Mg\9Vdf$\sU_OPG^AM[0#?-kS(A`37NiG"G+G6Al5%6
%(:D9$5P0%UMcs\uW"o/`5#JA$)7:r\d?EZI\l15V2M-JI$3J8AVZd+W(Bj:;kqVEUkmtU$m\2)nrC"Na7A$Ln)ADs8XjEI!8BF"O
%,4p`GTFmkn1i>nlngk[mqF#h,&YVu'M9q)E7O(6lB\_f1\r+L\E"Zmur2:>K(]$O:"9Df'r'7Hd[,d2hE(C
%SFVKE+TG7g1d:Pg+;#*H;3Q?[A*>jdKuQVC9W1:L7H6b-kV"bR_LM2LHB,/$:Xf`2%t,'C&h+uG-28'A.KcX4<.67A8H/tG;(Fsl
%8f'7'dX0JbdP$3=5c4H'/a,FK#*"X8-5mnNRZ*]j7H6b-W"kG51d45>ngsW*D:%KO?7OW-G6m:9"sVl&L8h7NBgY$2P!W]1l368u
%Tf_KZTfU"_k_=CY3C:bUqMn`Vli]@pT%k^n8C*-)&nr[T-aY$."T4>%YG1FF)4-\)X.ia]:5\BOl)&L)a<,_3OWgah$C<3,'gA93
%;+dR\'l)+0df*.W">4s4Hj'?Xr?bR-Q2\b_jGrf#r(ABYho]m.cfIlta;*eqq3Oj?^Qm^;?RA/>c=A?kN:a;U,^5L1jBnlSr`4K3
%IkED#P:Odonukq7Ik/:U5=YWBloF&GqBUG7J()0RD\uhD=\bgsSh1:90p@J&I(CL-nOu')^R*?uGT-OVH1X7*8]BX-cbOsq2pJ8r
%@]#M)pim_FAd(Ad5ck067_m?Hip`.^B.Bi+q4HfsYW0`I/$hNOs'6ZgD'XA.7UPgf'#.5"W\QMRnPh!*e[b5oVEc^$L/3O<)?$pm=;WbbV=-n@T*3SrXdo\n`Pp#+B^S*6jVoB@9jIBJ?H@U)]6f\[1TJB_\PPBWb9l`diA?$cPOV&6U""Y`BV3L+Qe:\=--':+&
%H\pn[$G'#&J=pOQ$;T],-7+X3KCg#6:;V@:#t$$pbmJ2K'dV&"r#i;'Su,DEGsZHs-!Znr)2o5BSs?+>6VgA4&O3Ra*+gp,3'l(-
%[EBhRfR?BhKV%5=Op"6Of,@qG0dJ%1`6_g_[YdBK-5<@YLVf5NS>'7VY?60Q)ZC&V@PGh8t&!M+ZjB2fl`[o4*
%V7'&$oc/()@k%bU9K1B@O,)Fl7DaoS6.Q#qQDGLSIa\m:qIU=V#e-amV2@\7&;Ng&.BggKMqO%?SPgOa2j@Vlc=BfY%N.2C(V-<;
%!61HQ'I-Ef?sD;Dl4qiGU8>Bg)/A%pCU0+g^t&Yd'GaONpP:1[Kt4!GkZQ+P.RMJODg=/g6;R.krD+.Cg7k/@?&S>HdVmj*oUGC_
%rIqE'B+`/q.%+R-b7]4IFp>Ko!uDs5@[K&h'ZPK*_;aj)q4eE;1MHM]4KNk1CbU:h#+tX\Z(^U6bIB#gt:]"3-UbSqLe+(6&8U;-CVb$.n
%V7A@N'$EOf9[n8A$PJq!B4!D86=VlsQjUQ^Ij95*hpJqKmP'n_oN1l@d$>6s<"_m9K)S6.J9`A*66'Jbj?N&mU69U%[k3b,'>9L?
%a:t%baUAS&bYeo_$](lCob#8p8tC&mZ?Kur6OBNhR[OP;BZUUJG_o(g./'0[,,
%\VEdM&\"F\K\Amd(.XMud%DrL(ARVmKU^%*\jj\iY+es[eR4WhPOHT$8\HCtP,2'83)#p`UJ'#)+:EhA8Ol@JQWcgM7H3>@HVVU4
%c+-9r++bmI`?j^e[>NHQ`ip^o_ESe.J&E;]mrSb<%5l0sT,EG1aU"SY&gVL)C4SC&0II^;@h=d`M8`@5is]hH8:/g
%<517rTqL%\=`Q:IgE*-$`))BqhkC'VqR7>DRYl3t59OJteYG:Pj!C7F6qlDZ!kIs7e%="3BKM
%kRY[=7/3]u+aZa3$=$0G]W=qu,>LfE!KN<>co/#k=dF)nN0Hp9qFPXjqcHL93]=iRNP6a="i^MXe"ZX?U6ifqWrG^5IYl&e17,=H
%UQNHtYVij1e._P!MkT*KqVpBEcF5,_Mi`3hDT66#!c].g`3<3!Q051`e4rb9ZeG8PV\E@A&t^YEC`/OB.;A
%JW*Cpc'5^N7CNO)H6.CXOiS2#T9N`M&_0H*6CEJf(bHt$g!VuPg1,7UGMGOu&Q$RDYDO#9
%A$:ZJ;XV:bE[%k\'Jb5*k:H0_Z>6f^V&-jITiPKO%G\m)!(Mgkaj\=gi#EN9*]oA-Di`G\WoG`'ZiJF"=a:"^!MfN0=hZu.Q^QhYgoZjC^7sfl06bmEi$f^OcNJ/-N=c-2J&684b"GK3i:2j--
%O5a%.7ClD@[LL-UTSs/A7>5Jep*5q2Q*Ec9;b=oTQ+^j_&)jCOL-.a]8:*iMb4DE$+t:R2X:hP/Z4sA#Iuodl8DHkNF>Sas0:1bV
%0Y^3AU-bh(b>qfk7ESVnXWbHYY#(aTI]'D!+/SL^^EN%ACCpB,P5lW;Z2C5mTif?_->r;"O.$Z2#d[PK9?<+;92!7F#F%WkW3(5qXL5qTgrJ5[Y5'WN!OrID);nn]'=^jZ1=d6[h^M'F=]#8eJn'1A8DH4[?EcsA:S@\X;
%rj4b+2`lq9GA01,o]H7aFH-4_-;VG-`pd=;E\5u_c2s=$DFLq)i6-Q!r>G5Cn?@"#q:8^Z(B]"LXWCY#(YpBW3WF9[:8_U4J(e+I
%2l4^m.VeuJ"%O"h0Y*V`9!;]e)X&mj`Pqj:/C<)j"5NgH%)(F6O,%(OBD+LT)'L]D04Q4#ej(R@45rMN*ref]3tTSbI_4)!E;ln/
%UZtIX,;+_anY#R$HnkE(LW0igVrFn;D"qaVnuolS3`C0!^=&GAh%(NGAd'*Xl#SiKK8*c^8[,Htk+3R/sj^7&Q\Ckg3?7CL.#=dUjF[*HV0j7,N"#nmgSZWK='cc1n5;S4"4it+O'Qirn7-PD8H,*h(!ksQk\
%9b\8;6oi(2.L@8T1@amF,+2-%P$Bc5bTsO:@^;4L-i%:!.C`8LMT'A7a]'b/V:$gRJJM1\<&qpq.OfpY30oJD#qj>rcrMSJ_e$A&
%=5q@BcW)qJc(nL0jq?oh3gJjUBid?ZcDHNa;S%flXpj@5],8$O]d*YFaGql"RW>`JM\XFn4"Zfnh;D%BmUG6/==Nl2doO0im7P%8
%:d$YD#30I\GXq5H@QOoDlobs.;p@op*jIsC4U$pQ'9K7\(708"a>
%3jTsGaJ$j*Z_/mQd&8Lo>o$BQGYs#6*e)879F600:RB$^1X[/&r=%m[-CFllK?+J.28c3nS;uSphTI&77JOuV%\S:kW'gt,,Ct8;
%es1tt)1F'.3G%t7JKAA79[G7!Zmu;@Q2k1m6bkE*!ORmm/M)N,(88&?EuGsn5Z8?;[nX-#]L`.2R"q:hk]@DY)^5I\iBZ.]T_3;h
%dnL,;;ZV5A#.m]b&SJmSUqp61^hP.1HE[]&/q>h9)aX-3\P'*g&+YQ@oPSjf^47JP!AkgRmYZsK$u)htfKOGmE^
%lrt&6P=`C%kWpT4!5e=9[KZ0<;L?4%HT\^e@-'GT"jq-)D:a`q4.0bCbJmOo_6ecqKeRIqZfDVMe%5&ihpZ"L-a#SPCJP6#d-f#U,k?#[ZLT?Ip/nF#aqlUd(bDoiq(ncT?
%\:ZINV0aQk?SIV::o,-NaU,),GUS6/Mu[BZompG$NiHY/=WfN"(H82-=,C6.h5o
%h0MTXhi\VR,paOjJ(X"G#>PEZQE1$o7IMhkMs9\[Q`C)CAArThE]c>2e@@"-pW6i]hEc#eRe&e`S;Q?V]3[a0rWdT-rrk!FJ,]=p
%n8/"E(:.g($6`cr*P322`o^e0*XoftSS4AFnipoE'A4YLFrY-RY($uZMf0u\OrF=47jZcdg5P=3*9lI4H8N"]en-W9
%3#Tq)s67@M0e#hp(;o?2(Z=d>#+l9$puu
%q:D:KR#:3UV6OTq"Tj],8c,Abom<]9UNa9CS^uZok\1=rJ?Z#2QtM>)/&)kG+&ZL]qm2lAIS3refjTKc]\Wq_3Ef6(d@7Z#3-G-BAJcN@TM=&$+>N9q2gc_7)DotKf``e:+NCt,D03d%.9+C_8T-*&W5BX93Y:u
%>)c*!Xm$`8hRPmfUs>AAg^q+EQm`]qLNHSQX=*_:8A<-8=nH&2gO3:6SV^85b`)a?djGN4dUWBAAq1N%;oPj&XD'2-_!^@jT>6)n]DIYY(Pi#Wf#PZ^^7?0S^d:K(#W2Qrkd--S.iZ3QCXArr/1dDVQK!oc?MT_fs^dE7F,tKfspd;\YPro!=&Z0hq$kq^SU+c+OGDM36AWt6o$QRZG=cIb(OZ,#io)_HB&C8DV^^SBUEQ$
%XPm3'-31BC%L5B
%31=W0m@^^n0'q>mHL7B5c=E=;:G_N^3jDQfm'Za8*Lg9>(d*tt6L/MskJ_,/(\K89_a:,a?VZh)Gpc"h(Foe!j)u[iCZ?sZ@QHj]
%MtduaZotn&IsCN2$+Jd[5?8OgBfKCG)^fHZ[(/)+ZX1@@.W=5K.7\p4aE4j5dD%T?E^&m%YK/:q-G_=GIQe^3Qe4,g7J@R8LnS@P
%@7&kn$XWYn^F*QUa\$S5DId?R*l`-@/U"&ALZe"F/Lu-E+&;[pgc'TFHJ).NY1<]WMOf5T*N/U6r@k?7N1MlnYJkQ!e&euk/P^d#
%$=8ES`b*'P=oET/QF&sibf?2pK\MTtL/sX)H\J"?!?NkNMgnOA;8[]$0R^*72r0ibH"/WrQp,aV>q:nQ"B3H'_L5lh'Fcr,@3)Q@
%W)ABHk8c*<)2>fLQdJL>B!(K87\e#YdaPY1jY;ij@HCO;C>i4r.4f*]3[9R;Pd?6`YSGIB6!a:Af9TrGsm2.0W"^$lI(Ock3c\
%Va6sk#'@V@IH.Xt^`%Y3#GV/&9[GjDJ;2jZaUG;:5u5[p)-J[5;RZC>^S.nO'jAK(m?V3ZpKW$H[ent>K8Fs3q%jr]BAut'hi)Kjr^0hD)h!rHWAFO*3Uh&uIpdOgEHJG\U?-YOYlKdc9lAFcK/E,aWk.0@m9\;,=ZV;iV@r^#kUS_4EB7$MH#m!YYs
%SP=>K(+N\t[L"AF&pcM8<6u0=mc@u4MHZb"QjfX7ic&MslH//m<;'bI7INjXDgXA9\j1/,,kBH^!VJHK#-^(B+
%G4['eWIBB/Wo\4mLbmWB5qPh'aIpPdiVb">m4)N3"BTsJoc[TZ(WMNHcdMQ^r1/:G
%2<=NljEk_'YAemSHQ[:#bOb;Zf@q"R*WGSArA.4uP5.*d[NbS^dYGk
%qt'dTUL(,[6JmNkb%Kb(?tPg/-S5f=5'"QMo6tE?4nV7^d*&`IBH@)GrW`d#kMPJgLnjk!6?1HFrJ"'"Nah81Q]ki=*LhO*MIQ%5
%%?5D0%'djFcgQF$C#:'3OC7pq@6)m>rj!=fr^_91)Q0(>A-D:S[no7MhLDJWZ`,tSjm8Dic_nt8\'XYns#Cnam_<58q2#mlPimYq
%LaCC&"*ZmoFNTq>!A5RQk'b"\Ycmp?I&qC:.!S'S,/V3j)fHQ#DW:4Bh7^-?rZ92ia3qHWLJ"*o08D&""B`;W56K;]A4$*>,ol)D
%^J6%6%k#CfrL_7lbXo@_!:QqPP-@3Hd^e.a=/?##s5XAA)C4j\Pc)I7@o@sT4ABilgeY+ubQ!7jcWL.LdcpN:8mM,Y3ns9jhA*6:
%V'c5q)ZCKN??9I+D^jARI4)s\iqcH9G;aPM8j4#o"TITC]fc5O@Rm'*hCkT#).\;Kq2]XoVE\)MAQjSup#8sr=;U`t^J8H0#u+qP
%\A+D"Y=#5^SNem&4I>:HNc#Y[`S:"'Ecl%Vb,XYj)=],$.&[npc;f/KnlD@YhQQ^pnL;ci080NEJ`Df$JHtEFL-qeOp.`j`/S3Ik
%V2QO[F8A%,@Of2re9!`iPX>)@pE=X05C7tZ-@jXo=qoL!"pnl`]VBTJ*uMd*48T*1#6Tja48?]M0l"
%EFZ4_E8e8Kp2YqA>AF+q[?"+eb*-qYhUuPe(XE8^mf0E)8&*!lfm]'24)^a%iS.i`Y&t*:C[>+/564m9/N_C5FoPO25556;!neoG
%7XCLI+E.UjR/lVLDrB@\:RXh6B*=.J4k*"3#@mSkocR5)Q_-5Zom*MqUe@Y-(^fm9@3NP,&5f>,V&$Tg!Q1\L=O>NC'$4G1,AeDn
%ZjEBa>/9mq;q9@[MlU?$FE\'6cUB]?0m`k(JPu%5>"&KZcR7TrL%88D-js.aN&##4\r>"@6,jQ3<%5)FUJg^H4Je6r*2K.r-]o2r
%3=,4k+&']6KI(jGj;We$h:;F[_ufJJ6ng11ilTYGO%L"L?\0Bg*)9J3DdR`<@!8dO!+['$RnR<6hl9$Y=iV7H,1bU,XYL@9P1s.$rOpGnj[)E=X":k;[dFs_B%R;kVkUH
%1^l-;hi$(Y$Pm[LlP#uM)r-%Cru"m6(tmmOk/sl^n8Zk$$(bN=AhdoEc"6*T+#s>IKc_$Np@#`<_mfA,V)S64,ZC,RSOb?$k2D9Q
%m0Gl5E!Bc+D*W_8b'uh]Vo87DScrGb3DL6)1&HZOT0HQZ?J[g7p%i#e4eU7#TQi9OY6qBjYmVW>\F@[VZ%R)_OLo&Cn&LP$@B.']
%gC$,2&:-RAoYS)B&f6Qu<,j-el@/8U@&9aqeA-glR5\an:/($t@\r-:[,i_K"Z`.RQc8Dm.!*Te]c&U;J18`@Bhu\9D6mJq7kRbgcg62rX`=Au?S6GRo&5d7=q)j6kZtn8KC/b^G7M6^[eW5?Q32ep/Qm;2ar,
%@do#kfW)l7.XBH?emAk?BA+X?1A0_',S<;IB+HAhgu.43+OR1>N0VE1)]!t4-J7^)GmVL6]?G'PrQY3J
%ScA6pr^q*XH,f]HjUS@EGMiWsAC&Vmo2Y%pSq^Dj#$^G,*4nl8FlNilV=_[EXJMK"8^$aGU,&[[?$5&@2`X2/k;,s!Kp\39d\"2W
%oCn=i^4:l#Z!TIS]fY<$IYZ7GeGWmaGTCUL'lRtW!pGQOqO0$rfY4;-1e*=XOXkn=Gj0uXo4.H.]2]*S70],tcr'*[qjbZnJe!+N`r.-P<7j%b9Bg+bg0U_G1Y@cH.VL];1=9Zt>eK+nT7
%nu=[kT1t;U#k8')h:8kkb?fS9f]#o6;D0#TAnoXrlIiGW+@`Y0Ap3S(b[bHWJA17Rc>a`SaPNrqSX5f,q:d/0e_>NluFOZToPlO0SRA2V;2+Yd6@H%4WG,^(akK]EAoVN]Zj=YpO.d%d8
%DRho=;O3VTA9Ii$`Z)_l?^UdKjS+XDhh/BK9'S]?9odrXP-;RDkBsci;`\Cd@-<\ZE7Ji9
%r9(0f_&i4DX4"eiq$i3`Kh,JAtP(ja8+E&=r4.W"Q0&1'c!-^pkd2O,qHr6Uje:3"hTWq
%2o6S`'B6KUF4-Z,QrJC2$"/c]!sZ^7("98m!I2t/(8o,I^G-LsHp(sD_@PK:o9Hon-"&(54nL_^t,mUkMJP/Mq#t7gXRu4r=,:BLU/8teeF_&+?gX_A"6H<(hnqeegOD3%
%(GbI[0#1ptU6sVa`PSN4HDlM"Hm'Wj>K!OIrW:TRIK5ahW"EX.=2t283$&G.[1BDFehYi=Ur%WCb=_I1:FMq7r$eZ`8$J:m814E&
%5T<-?Qa,LumT=LCBd;Sb*94h(EoTL_nZ,R3<9FXroGnPAkE5WsHhTTd)WVBX@E^Y22H=l-j[Tr;GF.6P7mUiV5J(`n0OsHh(XNr\p?[l9Sp5
%4-,)@i,Og]T-lnjpId=0X?mUh%L+m\.e&Y,OlGq]_/m=lmYpr!0\0I5=gGT$/X:.J?8S,PRSW2&O*qTD>f";))tUoE1%QPrq'e]f
%We=cmGo/Rk&]O55cCrfjSJi3D=6ts]+dG8QeuJ[6N>8bCt9!(=RH(8M"gjISpK3?
%",KkuIk;iYD`jc$LI)(Y=nZ&RRFQ@p,F,n!>N5N&mRJb\FWUiIV4XB-Xa9jS@4r(S0pNh2SW?nZ(cKX8n(pA_RaB!kH=0D+#^]d(
%b1ths"8@B)Tn@qE[G[Zr/G/)UPa@doQNha&?Q`c:k3e]:)!L;c/Y?hOYQ]p'sPeUnBG6d61\a1'FS;`#*]nlZTR]#e+bkH/&&
%q!M)9$q.RD<5/M'M$ZE;kFPI=PK;G'UH1O1]TV]c2[^F5br&l77UYkX,*p7lkaf<&_8_]/A-m6\]`LZ#A'6''_<^.@X*'A?DqN"q+U2N+Y$0XP4o^]jb_rgK_DNe;EX3Ki%dtO/;]#F:cT0$!IP@%Cq+"@d6o4+!#/XO
%e(a>Le?P@$BCI#/hF*hXaf&Jpngm:2=NKB%@&(V]hT0C".+_?=C-*JEp/6]1t
%[-kmXA#.6?.jM^XD@B%H-d7XaUY("<#UtG?eaW.XA?=S#Dt$c:1)[&=-I-8K",&M@6JcK$Ga^70/c]U3k47fXg.7Ra'%1sAY=$I?
%)P_Y2[.5sb1a@Du0TG6fap=ui45[+;c-rHdCC[,i,J=A?6W9e7d'
%]__JMjH"qJ87*1\CQ&tP0<8U]D2&NBc&`:Vqt8jO1"**h5^Y30b;uFI[=Zb+INk9gJMT10_^3bS83;0VW`Eh/`T>!Y&g7^d.*^$$[ZNTNl^Co+[f2EBdHj&^"
%,'U15Dr<6i<'(,Y'VUMgR_h-EP&;9=!)d7)7k,!E!ts&;F]:HNg0MgIG`7b3:@B)1N"f\DA)2X+Vn12KKToU_n7D<4mr<>q#"[c)
%elaPI-[-_Pin4$D.0DK=IFi^(2nZolG`J2uQdEV1XtS+Ek08=L]>+Fjm.$AOG]_QY_UQ..H3jg-]"]FIHaW;[S]ZoZ:;leTCFuBp
%.s&J6=Cg(^;qh$2ZU7OIlCi68Ed)M&5VNK7K@skcag>m-4&b<"(
%`En2CZ?396rVh":m@hAPc=?c_0:Wg%-oQ=_'Gc$s"66:DRFcB7ce4oK?15[Rs5*4T4>j]#MC7lE/oRJ'mJ!CQdFJ-adb3/nkni/]
%0g]@>rHI[Tp$mc\QQJ5;d!P-T^irj.#5:mp_88RDUHG*>"cd59`&GS'.\Eg`r*\j0e39=43AaAJKkBVk_@s!mZ(DHkdDmOCG&W]`HNt"mr!V#UP.M2$d[!#C'Mu-8<&Ll?mR&[(B
%r-e^8s79S1luWbU7d>8+NA_Z!0h8f&]L>MV1.$i01-s(M6^0E!*5*k92+ZJ?(.bKtPW@0,:hR5*-#]5,arK@g<[C&5>LXco"2E0h$u4nLB_Y*@phS9T^NKjN`^s@0J+M
%0!o+O44J88%>1j8dGo-X,;,=28+!JQ#eZ93.VjUT/6g;Yo2D4F_UDqCW&1&P''Y0iA`Wl^@DYj`ar4X#\cE^V
%KVa`.7[:^(q&pGR-GqcWI;0gTH1X7dV1*W+9$ku@1dCU+DtR6X5[TCs%sTc(fU!0QF_NHWgB7D"k1O/,7mN%H"GC7Xo(e/Eo`:@U
%n[G>_QE"rrn;fJiL+DF>TZbQ)b3R"g8/O17L=EO[Gm&LChbDU""B3R*[1OH4Rtr]<;;e>]t_7bj'VRJOr"fC+W4K)+nYIVBMC&@r2[7Q0UB,&AHD/S>hE=g#NDlt
%Mu!#D4Z\iZ7BU0YW?l?&Fq/o-[4#r_pR!/H>>r6t\#-d\MHDpgdgf1GVPiu_SuE=CUXtqUQe.NBD\]_O3j6[K'#k'Uedj()bYTf?
%038P)ra=J%7N]tAV!ABT.O]nO)jtPaXULR,/TG`/DlbfQm4:^trN^?;l9h:5AfY:aSbG3W<,*<"N%/e&7qHL+gYnQDR]mZkM1qqA
%n551!Ok!8QkKKS:4k0>nC,Y1S07T??E^"b)_L1MD:M-s*[4F.CPpD,9J)69E>%"k2EH1$XJp$S^8IYf;VmHbN3jRbV&=flBc*W*!8!\q=OulG]c*@R+B]'8MR>9>FT)"AkNcDGj2IRd0?a2UahZ&]jmnB37!Z^
%ZcLm'%[BCsCra8)VXCk8]Ad3;q[,3/,eet5Ib!G]b>NbJ5ae_9Y&\Q&l;_LB7H3W3a*H;B[#oaZ($\bf^J<5`-=b0D'r,060+QWF
%(#nI=69HR3Y1QkX-QUV3Q5e5i:@2acBT*@k<5qsYG3N88i+X'>`$aTpD11%jF*1*h^/*(gpt"iUsLZKI,F:*k2a1^S^%4&'W9
%bATKLSZb`1)l,EAc^DUso\f;/jBI^oS#JFS"=#
%KX"8f\lP^i'42MP-b\A!,l=mc+4Eu-!ImYPIfi15fWs'iCTZ&X1)SuPf-aDc4e`neb,VDhHkc\uF.tb*k;EZaC!H-nkFe]uh\*")#l(:DN=;!7S(^Xu2&Ned(`(gm[Fo8p"oO.h$YC=Z>;US9R>J2-]]-?fNq`
%+s(YCP#CCj]"CN&\STZF"r?TDI>_^'+T^EOJOQ&hoW-Nf4a7':k)2EFY&q1*KRh%NpQWf3,..'PebqQSMme3)hlUhEN,f^OcLr%@
%DDu@7(s]bXdTM,=/FHtLHsEP:XXajuNYp4N>-iWpr5#1Ce`jFNjk7TRgMY@hGJfK)J;lb9?d
%D9pejrLd6S:Z#O-jk\WV6!Fgcc7Fo+*5*T+gb.B5FF3QF^aUM;b0X*F@ITCMu=NXo_B>]LAr-OEb^AQs#
%E4^o:79DG]Qu'h0B0u[],^_G>$T4%M!8BQt;?dU?%^r"K*nF,$)9u\%g\CL].+2A1eL^E%jPLnBEHuE[31:;Yk<`ol3dV\5D.Z/k
%>_ohALR#DH_QpKAAY\W`B_7?TF.k?jW]*^&gFurk
%J,6-5`L!u5D\0.,@j/:WR$2p'fuei2P=UiogM\ZpRCF*qBZsrW/P$#uTdn/PbX&/.d_ZdB--sY1%S1RVaJNnYI-Pp^phpYjT()JM
%$WY2(4HW=uh5GqNjkWW?STP+l9#]/320@CaFr'Uq2@i6gNS>gd^Oph]Q.NM,cJ%ESc&PW`
%R9lObF.L#*k%f?=TD;6g[HOu$A[Ats/Ej;T/E@q1U0Zfc!#FF;I+X(ZYFKYt^8RU:3$u4S0uq"$k*:ucBeYGtXd72)m-'m,F3\Sr
%402=qc/,&b$E2P.$:8jlCbs.:AN+CGAFHI*1!t;7ZZP$b>rT42DVCYClQlc"r3C1ZQkm:O0AG]c,hle;NOFFPXX+Ou@U3%URbEK>
%#aAT=5j&#&JSDT$6-NLABif*R>tf-4q<61;FnQlY[lC=/JeMKk4C/dI*
%fo"<.@p[f++(_SjVOiX-=*orV2[8"cmeQLn1s;LnLo5s[g.AA3kgID]*@u\
%W8k4dM(oeN9b"9/X>S[jA19#Nk*7C]!7T4C>>jh,->H\A@cg<,CCa=KBU_mnS+o^9.iY#pq74cmgG"0QWnA.A8ucct\$W*#dp!29
%!/eTIXaIcmabPk!02<#t">MMV_;7e!f-8j'Gt198eD<:B"p?En15oDddAt,u':PjmjYl2HlH4p.b[Xu=B!;+*j=jqMe;:jf0i[UA
%YTnpgk>JX8jb`oD'5)c)r,pkUCAl40];et20k=GQ6S!R3l_H+567(nG=Vf'r=<7!j-mK4ENn+ejZ)=:Q/Cu)T!cjVZbb3fc&ASCCBA.5IAZ[\H^&6AC;V':&gqRgr+1+%9q6lM$c0o)>oelf!eH61;B+DQ=eXNpGY?G,Xi-*Y-rcXYnJ.*mX87
%TVhSg2m%kamtRR[J%Mh<1O/@:!k.-83!X@.fKhZjMD+6HI64Te1Pj"DQ??"NA^^fD?+lV5/O5?j7-\)5D!kLgfb:p%94B^5^Y?K8
%*Z6,V4!AJ"=R?N?]Y]Tbk^qu?H6`;s(s]QIp&rNQghaV.hVP!_=XM)Zqjf%h[o>_IV*%_oAmL4f;*t*N+6,tsSQ&!_/R7$loG#rk
%\`T:30iKs2]X0UG-e3M&5jo_l@=,GH[fKtuS:!7XJ2$0Y'`JiX-d+"^hhU[KP(t.NMco#$/
%g+&ardO`Bdk%ma)#tlBEu(6.@_8_G$><_bU"8VQoHV;j[qZR[qT?\8MpRO^npa]f9CpTb`HCos4^$b543MUZV%,\%ieOadsB&QcsHF@fNjOE:&Cu-D>h:H:bLn)`(^)\4[O@On&mZDmcs-=3kJ)SqUK\Wk$ciAVDF)3PUtUmWp,IWl&=L1ZV<>[6F@H7LD=pZ)l&5VPG$[mUZs'c@#CbuR3hok>IIt+!24[V?R!*%O(Y*Us[<29@Ac$4',@Y=]bM#NFSV'P;*E:K*e^@Tja1$Hs
%Gj=H\*!#9L(]1LX0cUsbH$"-e31IfgiKIbe6+i+]T3#[T,tm]9U\!b%]aJIpZ9?lA,G[)[oQB/+%NGjh,/>jr!X7&QBB)ahG0,jq
%E-/\H>4Q4R-*k/CbX"D*;`Ye5Up.-Y(3CHSeQtrrQSp$C=F:$1f1lVVgT2t^F/iBer1LYZC=\?)\^S:Ub*bo:r\8WZ(?XDgqQSFY
%mOTiuS/'I4H7-5qrab8d].F80^''=1>MS5rQocZ5`Uib`q_?>D=r_YIUfOI2Fj(l.I9U>+Y\@,dEI>2]D9kn%"n;G?/?rR_*`B
%r+`u8$&4c;DdCOBX#o$n!V.].*AoIFZT52(?9[]'If:?%db4'eFZHHU1uH71ZmlLsL>0fsZFXc8:G9gb:>!EAEj_L;q.i%=)8@-5
%CqU(=X$ns,:dMi8WjTIp:p"$kL2&a(%:ulN\bYPjq.qN&"'[F4?mqnU"*]%BK58oP.a@3"Slj=ecJJtbJ<^pdH$JI856;UEZnkrEGF=WbB+WRTd_U44(/>#'ecP[ge8S-38C?62LRuU*j:?%]In`U\*\r^@F'jfsJ"]l$KI"/Si.1XmIWtXocqF]d(
%mP[t\PnWRD5IYs0'CIEaEI>d^/h.t=d#LlDZV_gb-fs`k0$3I=]u-!s_,jVXe^3Ks`R`7b-nl^?:Bh=Z;g]oSs3-Z\-+u"GL`8ZAuojiL%@r:;+&)ohJ',18]i7lIub)
%HDXs_r=:km*69mi=n
%r>W2'$^PE5DL^GOGE/R`7odn/(9MHLL+-EYZW3!cU:j5oG`N^#ULe%iZ7)6mh\5i@;l#@k>Il^ZlLL*Zf[No1
%HDDW`a4s+h.\tcJ0l`cmbuM:^rBYYLa7%$18aYE,hm>47>^io37+=9k7iVGFr1blR-h:1ee6
%f@sJ?;#mJCoAo%6Bm)QpV1#S.jCtV-c;"',nEXoD[-NlU1_')r1!uQ\d_bfjX&;4S4Rnm:@^/_05l.gu2ca^sU=5CHlZQBQ?D_]g
%QSW^UN72hq`CfIHE6C?Pm<';Z@.2gXg3TR2?M3aQE8\cYP!X/hJIH1#8^h
%DLAIfRdKH!XN0\W_K=h]?,akpd_QEW_1LpC3O5+3jS1bFYqF7-G%HoD_\BF<+%dPN-tCA=8/MR44.(
%akl[Y3Dd5tG)_cXo;9XLdOqZQ^\CP.VXHNai/OeL['EJAMc)gB]f.M(e@k%f]G,<8rb:XKHmeZNSI*2^<&a8a"YAf/?eXdK$XgDu
%s/n^Dg[fi`%l1jlMC!F;Z(rhQQ#bh`mnhDu9r\2aec=uZFDjtujrj;lDq-ND@9[pAW!3fQJ+G-T4o``@!*)*[2lHebY2NJc(Yc/$
%:a[`i&a&@B=>LG(F.s_LfVVZ!)O=LT!3XgRR?D'L'D55R(R%U"h)Qqo2EB<+([m)FkPFSAP&"_!L>)'#
%5OHhiKhWNQ[P^2!cT3Re:h-o\\UHT=e=Gm6l+X)-.
%AX:W,kEddHos5^nlM6^7Sa0p:Wo$8nJ/FgBB0@Bt*NJFtlY"9claN=$E3>i+N\clC6#3I[[/A"PpdjN>D0<"RogFR:H$4/0TCo14
%CVGABoNXWH:tK4oo\/L))=X.Pk=bDU]NR%2Q?;R>nqWUaff_A^deST9j;uPoD
%V2`YsUiZL9NLaC".oJ;jf2#>[[;r;)b'U9L4P.oJJFl7JHWEpfp&L-"?K%[d0LMBC3g)ReQ3qos6j4D`:[1G5F(#hVF^fB>*0'haOd6\UN,-qJC3nh\qt@XNok\qIM_YWI?oh
%O3]_MG4>3[eT:]?3JpUF@CA8LDl))QF/kj;0sp&QI^429T'EdVH*3d)S+H1Unbu;/p"MpkX8TSXcK\`F4kEJaip^dV
%c-GudDpO]b\UL"a_ontSC!K4LY:?Y[o43!DT>b$[eiMF/`/[E,^re4:iOOEg)kC#M8fOAfB3$(?[%j#[R\u\5R9"3RY2=PFjeh5;
%BaiV9WIEUg*`SctB.X]JLIkgaF8`0\6[9ttbB*W`$Y#A=H+S.rXAALFnAdFJf?_SG,!O4'cLl8D_eaP"T9b];;uJ8JCY(Ptc['W9
%WT&#IY+PCJ+F-RmWA;%?4Z&<;>pf0[lAcD2H_h>[fhm^Pql8-u?H"a$BBtQOg9O/<*D;-*[&Z-@)R]>>W`*6V0Zs]Qi%b=:!gQV1
%]Ce7A:dpblru>-e+u.tD1ssAccpj#*.)tF=:[h#iN^^Uk_o0G]WgMd4oC'$lhbuf^8o7+QM9juJH,S]*")VN;a4?uc-Xl$/G)nDLu+HT-]3`_ce`at
%NHpqEn"[ZsUN[g&L+`E"^OtDJdXCS;(WFj.dh@,2??kJ+X)[@%QRjflF.-`pgBW;/mS>L(lIG"*-k9#tipo2"S,:'h>r6M]<,%d#
%X+X5'Qd:I6*aJEY<:86(ir&+i+)0ie^sF2qI)5KPq>#Vl&rI.WUj14Q>iF,T.>9hS@W]-#3+PXB(r(moYcX7IGhnD_3D*;e@+/
%*DY'I(C8;CSub&=rpC0!7?A$kPMK??'!E&.g;S?roBu=X=Q;Rt6eTu2WK99Ql'Gc'pM5#LnPVGJ+_m!<48EfD8o&f(k5s3W9$GLkq_%@DY-pNY876HVk3;g@fq:%Yg?Q.N-$O!lYLFpbN`'J)[pqh>G*C
%!f#_;Lk@D\Q8gifrXdogcZSCAXmf=MC3W/1G?s%P0JiNdDZnTLb20:K"77(/h7@+nnu\ke`n/>1I"P;PL`Dq5di4VS4ArWAf^$W1
%6Fa;D9:Ar>U-8=JQa=53@9S:Fj[6Bl3+=G*Dk@*^bRCDCi"TM*4e3E
%\bob(ZC$+.qai>>M?f_V*_DOLcgg#`ZnX5b+!*T[6&Pu6r=L?m6Wdc&S?JJ+TC@EQH(9@F@u19V]rMkH#*R2kn)DdGjmsElqfjF6
%H!csAdEJJfRQ['a<:EoslC>Qc0X;HIenef(]T,1u.fdX?2r3Fea1,K!Bo5c3\4T?_$$(0oV=g:!f4*HXl2FJM?s+*4dUPK/(
%q"&'Wm`%SYqo9U!jbpL@3Q:jb0q7r+9_^Ca,eDmdCF(]G']":6QFHt,O,L-&:[nQDqn5P=FO3]''BAn6Q[:VaNdt\cOebDE5W@?"
%mlQ9r32"h#liQ9rlQNg^YL'7)k[V>cm>i@KlFU!:o&\2,9WD;]-2&IR^9?*J"5h&QP8j"c'\6!IHnU,9gqn]u_5$43jm%n16r/%VNdr)@cM>TaMW?!#gi:s[U!c[iGNiF[DnT37Q7LJ4;Y7q!5RWf0LW<#jXX=5bBU'[fs7iVU-)nq9K1m/)j(p8S>\#=[+-=6k0Kj0&J]3+hs,%up"qP9iJ*Ar)
%nnJY.`_L53819cp?]Ck5rV2OE8GA@X>bF*)O7l%CnK1_mi)r`q0aYY4T]<'f+p?%arAR?%BLG4@jI],!2`1p$?e7%>T%#$Yn(aQd
%M>9U>c]/:%j%G(3MU3TW`:/"61Jj`NJ?_;(=q_#kF&e+2BqZSI\^IW$Z7c-arX!7?3f&6"WQ.4qG[EDO$/anDn>JuN%_Hg6pa
%(Kkq8WnoMJCJB.>o(u+X/?>'kBhEJ4R.e=c^CFhVrB9%u3UMqhG?$D1$"C3q7U>Q;ki)e96dphPSol-2N*3,P\%AWZ;ZP^L,%DRD
%(cc$&jc%uc/@NrN!:[JQG"-@ns3uN^mI+g%%/u'DSPRf6UqSU[ID6G8OdX%[OMRNV*&>:.6E8>ImgBGnI4&kE$DV]$cJ_0eW/Lq<
%E_U#C-HDZ757VPWH4]X;CI&qKUGYg=Eo:,'qQh/1N`n"a5Gj8#%\Y4Xpdi;Mh)pVBk\_9&_P^uj
%MOOTt7hG%L%>3GJ(-_TYcc8$%6a@e-SDJk4M`DV6L^%OqkR@%qYa!fc$#08dMQnF!R7-1Nn.tdMIriJ,Bq3l&W+/lH3Y\i.:bM\j
%3P`1^XUf%ZarR6BEI#+,P?bYCGBiaWr_D'X`S9D5!==ATbg>kZI=/q`#CS-qmhla1Nc*L4Wk
%'7gV=ap`cK4Ct2-'s$O+fm#nQTR%6hj25B;$t0gHADmK3hNcAs;XR4.PBOuaQK*O@,n@\E'6i)OjGF\u=S?X\T*jRcE'*iu"[DB+
%Ig;0k46MV=>NN2t9SsqaVYu&b^Oma'O]I1_"MZ4^$+#>Z,BS*2M>te#8%&;bP7IW7[.>aRa)aTj;*.(%7PNkL6M]$6-ZJmGon:)8
%E9lO?l3T%`/Pl0$OnV82M`AYdD8W2O72NH]me>s*nf^]U%gf+OOA!fiFGo,2ja!PkS`_f:j+jQeI7i?t`0VhU^V^_g[p[sr\j4oh
%R]_:*!TFk0(n?&[,=AjYnTb=u3-Tk7=C_gLpm:ksrj&UoEejTb>,]8BQs5NeU8dWhnP?j9Ch=tU:o4:6b8IG$.1BW_pZbS
%a$pNh/7Wd>CbYEp"fksP/H'R!+Tc8q+R
%V@ETdO+PnqZ(a9+.A=SQPUV'mjctN6NWFknk$%@s3YV!
%0fH\5KTu."<4r[VU@Ai)81J$57.rLr<=N[>K$,)a49R`fM#e!LP[2lo0H^mH_Z^7MgFBF=G+H$4#2&)P7[Y,?66Qrh]\r[>OrtW@
%8:Z"B;CsRFT:/BX.1oeQUXk'NQFBWAb!hW;omP#&moPHCC]3NR%i=8Aup)r3!bZYCI3WNj6\F81eNHV'62.-jnYD6;5
%a=`)!oqC^]dCj]a&.Z7eL)ZhjK0HfX(;74f,MT<q4FZ5
%3*$'ZV=;APmEglO%s>M(?BA&#c[-:9ab2(cQka&0Dc%n[2=A-%d%;c8ASV67aeC*A5g]?q:On
%1GSQ^=]sD^WseGo^?SV0"1EO=QZp5OC3RIF0p&kj?:Jq)J5h^U_):EnP3GW*7%La7)t`=$)Ktj*KID1!"fB=%`9VP"98(@U>RR7IaS]Q[-OpALh]tBA?pkM\2\:,gQPgkOPW0:tbYiO<'>&U4dD[3*gGN
%U"MUZNNZLkiQ\'\OW_b8G&VH7o`AL6G*iT7QceMYjh'h2^O,?SMLg?3Ee'2"(7[GnQ2*^qk#\
%3#4%g#RG`Eb=^oQ#u/n-^JCu>W\5IW#`t7*L_)RFdsLPteob!c;gd.\_>_9cqg=E<4JuBMQO<#uIsCf=gHNZM4b*D.dnd^UdpIM"
%h4O`8ot0+0oD>`*rSdRu5l0#F`l!ODV;jq;DLYA@nRP/NrpAE$GApMn_SkBPHES)Bt)Qga')Mb`$0.GEGr:ZOk5VZ==l3_tY4_lL@k^\<1`+,A*;.@"E2FUh;13`KF+%h\,8X'@@E
%fWfK3XLg>bV/[Erm.Ri2KDT%D%X'>+qO3A%NGfp=`!n]ml_VOd&So3[j7e;AT\,dB31X)e4-O:"Q]/q:0l/c;CruqISSWRLYS1#Q
%%Y>]1RhIlP[bdj6Qd?,;1"faKRVd3=YTDNd\0s-NGM`\VGS$SCmhp*$hhArDmsqVgg?"+cg0]$FcF(Vp:rXg!W0f;It(V#uKeO%4k
%D-4Jd9-u2>f$Y&VfuV`uCs3fM^kTl4gRiNGB$[ntG(rpM*aiWBYA#l`WG:cPG(-JKE2cm?2&]nF`h8r&O#E=fF6Ce_>NE[8B]L\>
%:%%W\%`8P=q]R<`T"VHXD-?:hPgLg7/lWd@;eKI?i7(lg>`E5?Ru7^#R;h`JX@p!.
%`lEg?dg*F*`cPW;aTUE"TA)4E1WL[F^m!8I^5A)0$JaHig92$&U
%"!`7>XiqPP$`:FQ%6F97M/ZC7MC(GNX2=%Y2m$(/]qA<[BMJ)-Vk(Nf)4V5\)stj:`CPmt'FB,b,5,[t+/#9W\h\&Z4O#ua`\=pn
%+.aZY8u;e;P0#1-8m?"'<5Y.B.7<.\Qopk(&?)ba4ESfFak6e;HMqUI!FP[%C14Eq-M'7W&E"e+nE`QcVBXP=NKbQqmF5!f@03r?
%U)hG2];Dla@n/5O1a_n<9KafdWIleYdjEG[Ke<+brY1j,&"=&=K+2[V`L-4HkGnIm;\.Tep6b8fV'\"WZ;.Y$E\"VBTj+%[>ca9-h%7@
%,6Pr5#c$XWil"1L2(#7h32Pl,.+/ERFYFFW_Zebgq"G]7fA-d+T(dd3
%^?L+?6S2gM"k$FT4d?qgFtM:GApbjo*E0,9WL$FA_anT4fkoJ/1*=tS)^nTa9ep'@UQH3aU=_P_>+'V[`nHjJT\X18*'D"CEmC)TNr2%f"qOG-4%"pq$^VUj.=cEBDnUDkD:s/D<>a
%V46&`$u8PDW>AQt$Epa2g'1(]3fZe4fsoNtL+TpAZ2Rj"`"'H4[W49[S4>N@/Ri>t-e&X:)kXRgA@#l4fLNN57I=*fbkMSoeWrF-
%^+g>NJg33K+`g9haP\WaT6Lb[#'d?m[=l8U,0MW1'`iM!:i.=LBY;'":3m&8[Un_1Vq8@GS3njZC`b`G`pm=c9_Ak@R;s<^ftq6L
%a)&5:LI*Q9,[8O52a`l&R*ZX'Q_@@bO%Bfl973i(T^$!efeI3*J3_arTe`@aE&-.Kdtcp!TX5
%'ShH1I*[B.R]5HoEG]bd?Ki32[HeQ&/tEe$=k'>qJm&-:nUk=f[c&qD%5r1RM6pH<265,$()If?b)u5d60!:-?p54f5Lh-1/1(mH4I`jE#-7-/"%21;6tAc
%Wo0\(!fh+rTadB\5bSOn'Z#I:(X%PSL5ZEG'uX-*;_4i*OnkN(]m;)73KWF1P3#)LZ7ZRrV@3-*'Eb406N7WS5_p$E]MrUhd%d*4
%UC3BNM,2Ub0Gjg
%Vf<#'!uA_-@dfMU+M6'm@BIN,&d1;ENd`U&NIYdK*#HbH9Wp$JlgR%PU(F'T`TL6SE0_YWq^I[QSq[FUhs&ag7BB6'8I&=O5T
%8ho:ZYF/!Z@BMN?"0g5eG!1jd"S]8pTOpIdF]8hmL/b4ZcSHPofG,&`5jW.YjH?';'2*B[C^33W.P?V3VI?XkBF8XDReDJjG(8`,qq7';hZj]7Of5adQp1aoIB`V(.U
%KCA808K7cB%N4CmFC6Ru5/fCG:^kH>\T&`4^ONgS89TbEqua1]kRc(%n;om(-.?qb`c.cc(Tbg>@[F6*$VRo!:i$Y:.K,#+a('OB
%c?5(Q5Q0[W*!pcKZX#aX_#m!RDN>]b''Xs_=`*;ZF*5b2r%"b^jP]8&s+7q$ch6#Q.AA\sm9mt=cF*pk$V//I6aAS&]@,PRU<6NB
%n5-T^$=+XZaF=qNac!nRTpTI6hDk!FN?i(,46s"E7!$9P%bYDpKjYo0@MCgc6a?SKt8-^
%juko_O_2"_s7AQRHtF(ikL@RAh;6jXd]&+!u/7=MWS6fEF^lp#TMroSWP@B@p8mKC%4Q6?D&\'PVo,KFAG
%mRN*8*X9+/IeP@bX)5H6(T\!-QuJ=A;-I>Mo=KGE!LjU+q4=c7n;.WgC(R%Lg9a[.iNlpV#V%0]Gf%TJ&C=qt,5a2jpO`E8VD*sL
%-uh3I1cTsBJY%LrYSVV^Q67h`)"NrE6;n:i$1:*aMb%.qi#%0!5/=.l9Z/!GQC1n(VE:!O2L8,H#]P(uR2h4#_q"%!#%FOXdnGHC
%p7b+P(8kY%%,IoqSjMbdJ7;mDKn^9.HR]\mDGU`Qq?ah#h"@%h*9!EIFFJgE;#EZaWDjf#KVN$26K0]S@-f7R*_Em+_2$Eq/d]H"
%Ui4&*'r!h[d)tnH3i1[MDs&:]@h^>aA4TM/S5CVl,fkQGMF>-5kWnke'`rVV&/DD[84?p>iE"$b11Z77377]mPj]J=?l)S5
%[(PTk%\"\p24m^P^'0_XeVp6p<"D&A=l0%o/FlD@_H%n>[L7BH.@g3@3!e2@j;>MB&[\)Y7i8I`R-N:L]D5:b!!gI<*!9NuG;&
%jS\L:@HnP+K-)!qKm-0TmXjXH]P?)Y"1j'C`JhpsbeUa(JPhd7a/V8gQ?Cc`X1>o`eu;p53#^[lI^7)*nS3o9o-TulP][l`p\qcg
%Ba5rFKA/"p>s2I4&pBAEN^s,#6'[=ZQ_q2[\-\./Kc]jENNhU`MZ)L_'b!P74qJZg^Or[Ebk(QK;<[X!\=_]-\(Fj)6\ZfD+c"\2
%'A8Bp[?kHKIDPV6Hn>$or+&+]^lZ,/a6kR"f<]k\N)\fY'RXNKV$3Jn;Nu#LQg+A+]7*>dZ*EKY_(']BT\s@+KV46WMMN-LO?dc:
%X^,L+"d0B$#$Q)6"U#PC>K'dpc]7$o41aoMdhE<">+A#2Im=$VBhpZimlQMaj4rV
%0p_*[1&DGb]#FOIEuO8XK+]4;6t;GugHq?2SDat_u0nq"BPcq
%Fq/3?!RX#+BY1$0j:&6I%^cu]>".=P@piLbfYqgi]?s3^(r?jRadP*LBub+u6_jH/0S,#)0$5m9)\)uK6i[Y>(ucqNj6BIH3aCQaACBZ'?JW`V1Du*FpqGWp2I0WP1L(cApr!GXmi+q&o-BKc:[pQk#S`^_K)!KQ)/>/JO>Bb=5X#_uFLm)9qrtAlC1pZ>o
%\(,bYWCRng$*.fY:lZesiJd?[g0S.t_+Z:ZiU4j^.+Ud*($;M:UcS-klLn%mb7p*de(#*4/qWZs/=:EX]\D=SHQ,ZMH[81"fTfQi
%A'XdN9CbmmqXf5]*&P<+Pr]g+6rh7C=FJq3"f+TF4!TqZcG*R^R="s@5fLB_B1/M^-N[5*DanQk,d*;J_7%jXB62&,uoCr2=n
%mQ)&,gBns?LZSk-^8Y"]lbY12HUTF?O>2@UFiQ#+3=n=>q1O)J$<4-Da<&4BVBc%,n-4kU-cGV0*hZ3eu6hNJ!XB/";\ao-C&.,#6I_jNhCGfanGAp7f$^'sS=s)89&:1eRB"B[_&ABP&j2,l,
%(7Ycl9t>"e'--K9?E-`T_soa-j\kb-4#4*A?8t9lcbZ)DBEIhK5,KtmcRIQ&o^1.o`_3ZX[p5Q"UcpQIa_lSH5Ee\;nHi!7+DEI^
%=\j;Bi'=qh=1bktS+cQDQ!N^I&^$R:qV%AW4/.5lC;">?UQe9+O8&%90h;CT#d4ZF\gcCB2OO]Z`=^g,.h!d56I:C%^i[m?=;f-J
%[4e1K''qBZOGA&fS05DYL$'R3BFt>k?UnC"46-J2\(!MSKrgK($NSK]bHscX&mjbU(?h`dYh1!Xb&k(I02ib0gH1
%T\'6qV?(:c!4P=H[/j5%_p_&,b@Df)]4q#^!%\m`s"'/ulNGi[)Ve+n!M^3A6$ru_C`2el@NoXa3*c^=GEgB.\Vj+GN<9s?aJR4Z
%I-=tpPd>TeaQ\G--tI9tfEh\[#h^AXRt=d$Th+Er=p7-FGS0lN3?^H(0#9%!AcVD$nE!sFYREf`*"o>6.Sn1FdTkq3c%+FOYqkg@
%6PnN*@Uki:7=5(-1T+iW-U;:"3PCK'D9Sr8)CJ,H^mq-hOG$)'.j0
%R1?R:M:9l3hW*?)HObLq=Nf7;f&*aiI0COie0;J'-3Xrt?\%Y8d\<*sPYMYG/is/YG'#s0m;rVT\;qJ-gpFO<\=s7/5aM`")MG;e
%6pN4W;?S4=VL"V&7AE`7\m3L2EDsCEJST2+gnT!!AdKm#G.3&)6AoX^bEFHlesQSu"!4cZd!Z9B8,tAhMH[\MVaYl5bY:``VX[+9
%_2ofpk]?B\OJu:#S_5B(M4#-qOQV!PVrtTT>BNds+8'NuPmd_O!qK4@!kblQahha-_Qg1E/_j1/DqeqY(M-hsluk&JVV)SknL)^#
%0QD/Rk]5XM:oFl9W&[bW^AJL0;%J1BWW@jH;k[s+b@_`Ft=CBrJ`iCA]rd<0o/mR%)d%Aj<37n&tDU-d?"pK!JneR^OmV__mZa\Yodf7.#M[,1F7-&AnHb0VDlu:7_T,g64PH/2GhmBHI,<4W>F#9Oki37J'
%9V9pM;KJe\IY6>\5Vm6!"%[^dL6)Oc;\Kh?V9dI"_mgm#n1bF3=g6Y;
%WFs7!SkC+BgV_b[H`k18g=t/X-i(br#'7Snl,/I6%f.(Vns:1XB4SkCP=BNm@Y0+C-k-DD;HuHr!-B8dM>fl?R3IX^"d'-&5!:I<
%aD"!R^VYATB'OZ*O,esiHCjEOaW9jT(e:k"%36>+(XImR`A.C6?B&]CTK[f#LfMqI?l&?sL/0L.8O4>d(+t3u;679Qo\r]mH7g,0
%KEW28]LdDpZ9$S2"L"ARK;"cjoFE-_`&V:fYp@'\`*fRN]WPLW]p
%TW\=['-E0A0`99lLNrWI:\JBb=O5G?Z[pQn!oBgI4Y*$m'Dk#6@rS+Nj
%HMd$3^AIVJs4a,nroo2Fr7/RV"oGo]r8ua0qNE;K56(6k^\R"6^Ad[>Il3?Oqd7)7iU,qa:N%:PC#efgIY42QrhuB,&q'l5R=fG(
%5Q0:,YQ"Oc5