Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
BARMAN-CLOUD-WAL-ARCHIVE(1)	 Version 2.11	   BARMAN-CLOUD-WAL-ARCHIVE(1)

NAME
       barman-cloud-wal-archive	 -  Archive  PostgreSQL	WAL files in the Cloud
       using archive_command

SYNOPSIS
       barman-cloud-wal-archive	[OPTIONS] DESTINATION_URL SERVER_NAME WAL_PATH

DESCRIPTION
       This script can be used in the archive_command of a  PostgreSQL	server
       to ship WAL files to the	Cloud.	Currently only AWS S3 is supported.

       This  script  and Barman	are administration tools for disaster recovery
       of PostgreSQL servers written in	Python and maintained by 2ndQuadrant.

POSITIONAL ARGUMENTS
       DESTINATION_URL
	      URL of the cloud destination, such as a bucket in	AWS  S3.   For
	      example:	s3://BUCKET_NAME/path/to/folder	 (where	BUCKET_NAME is
	      the bucket you have created in AWS).

       SERVER_NAME
	      the name of the server as	configured in Barman.

       WAL_PATH
	      the value	of the `%p' keyword (according to `archive_command').

OPTIONS
       -h, -help
	      show a help message and exit

       -V, -version
	      show program's version number and	exit

       -t, -test
	      test connectivity	to the cloud destination and exit

       -P, -profile
	      profile name (e.g. INI section in	AWS credentials	file)

       -z, -gzip
	      gzip-compress the	WAL while uploading to the cloud

       -j, -bzip2
	      bzip2-compress the WAL while uploading to	the cloud

       -e ENCRYPT, -encrypt ENCRYPT
	      enable server-side encryption with  the  given  method  for  the
	      transfer.	 Allowed methods: AES256 and aws:kms.

       -endpoint-url
	      override the default S3 URL construction mechanism by specifying
	      an endpoint.

REFERENCES
       For Boto:

       o https://boto3.amazonaws.com/v1/documentation/api/latest/guide/config-
	 uration.html

       For AWS:

       o http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-
	 up.html

       o http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-
	 started.html.

DEPENDENCIES
       o boto3

EXIT STATUS
       0      Success

       Not zero
	      Failure

SEE ALSO
       This script can be used in conjunction with pre_archive_retry_script to
       relay WAL files to S3, as follows:

	      pre_archive_retry_script = 'barman-cloud-wal-archive [*OPTIONS*] *DESTINATION_URL* ${BARMAN_SERVER} ${BARMAN_FILE}'

BUGS
       Barman has been extensively tested, and is currently being used in sev-
       eral  production	environments.  However,	we cannot exclude the presence
       of bugs.

       Any bug can be reported via the Github issue tracker.

RESOURCES
       o Homepage: <http://www.pgbarman.org/>

       o Documentation:	<http://docs.pgbarman.org/>

       o Professional support: <http://www.2ndQuadrant.com/>

COPYING
       Barman is the property of 2ndQuadrant Limited and its code is  distrib-
       uted under GNU General Public License v3.

       Copyright   (C)	 2011-2020   2ndQuadrant  Ltd  -  <http://www.2ndQuad-
       rant.com/>.

AUTHORS
       2ndQuadrant <http://www.2ndQuadrant.com>.

Barman User manuals		 July 9, 2020	   BARMAN-CLOUD-WAL-ARCHIVE(1)
NAME | SYNOPSIS | DESCRIPTION | POSITIONAL ARGUMENTS | OPTIONS | REFERENCES | DEPENDENCIES | EXIT STATUS | SEE ALSO | BUGS | RESOURCES | COPYING | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=barman-cloud-wal-archive&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help