<sect2 id="pg-arman-name">

<title>NAME</title>

<para>

pg_arman - Backup and recovery manager forPostgreSQL

pg_arman - Backup and recovery manager for&productname;

</para>

</sect2>

<sect2 id="pg-arman-synopsis">

<sect2 id="pg-arman-description">

<title>DESCRIPTION</title>

<para>

pg_arman is a utility program to backup and restorePostgreSQL

pg_arman is a utility program to backup and restore&productname;

database.

</para>

<para>

initializing the backup catalog. If the variables are

initialized, pg_arman can adjust the config file to the setting.

In this case, you have to specify the database cluster path for

PostgreSQL. Please specify it in PGDATA environmental variable

&productname;. Please specify it in PGDATA environmental variable

or -D/--pgdata option.

</para>

<programlisting>

<sect3 id="pg-arman-restore">

<title>RESTORE</title>

<para>

PostgreSQL server should be stopped before performing a restore.

&productname; server should be stopped before performing a restore.

If database cluster still exists, restore command will save

unarchived transaction log and delete all database files. You

can retry recovery until a new backup is taken. After restoring

<sect3 id="pg-arman-connection-options">

<title>CONNECTION OPTIONS</title>

<para>

Parameters to connectPostgreSQL server.

Parameters to connect&productname; server.

</para>

<literallayout><emphasis role="strong">-d</emphasis> DBNAME / <emphasis role="strong">--dbname</emphasis>=DBNAME:

The database name to execute pg_start_backup() and pg_stop_backup().</literallayout>

in command line and configuration file for security reason.

</para>

<para>

This utility, like most otherPostgreSQL utilities, also uses the

This utility, like most other&productname; utilities, also uses the

environment variables supported by libpq (see Environment

Variables).

</para>

<para>

pg_arman can recover to point-in-time if timeline, transaction

ID, or timestamp is specified in recovery.conf. xlogdump is a

contrib module ofPostgreSQL core that allows checking in the

contrib module of&productname; core that allows checking in the

content of WAL files and determine when to recover. This might

help.

</para>

<itemizedlist spacing="compact">

<listitem>

<para>

In order to work, thePostgreSQL instance on which backups

In order to work, the&productname; instance on which backups

are taken need to have data checksums enabled or to enable

wal_log_hints.

</para>

</listitem>

<listitem>

<para>

pg_arman is aimed at working withPostgreSQL 9.5 and newer

pg_arman is aimed at working with&productname; 9.5 and newer

versions.

</para>

</listitem>