public inbox for [email protected]
help / color / mirror / Atom feedrecovery configuration parameters
6+ messages / 2 participants
[nested] [flat]
* recovery configuration parameters
@ 2010-04-27 12:03 Fujii Masao <[email protected]>
2010-04-27 19:52 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Fujii Masao @ 2010-04-27 12:03 UTC (permalink / raw)
To: pgsql-docs
Hi,
While the server configuration parameters are listed in
the index page, why not the recovery ones? It's very
inconvenient to be unable to reach the document of them
immediately when setting up the standby server.
How about listing the recovery configuration parameters
in the index page?
Regards,
--
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: recovery configuration parameters
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
@ 2010-04-27 19:52 ` Heikki Linnakangas <[email protected]>
2010-04-28 02:16 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Heikki Linnakangas @ 2010-04-27 19:52 UTC (permalink / raw)
To: Fujii Masao <[email protected]>; +Cc: pgsql-docs
Fujii Masao wrote:
> While the server configuration parameters are listed in
> the index page, why not the recovery ones? It's very
> inconvenient to be unable to reach the document of them
> immediately when setting up the standby server.
>
> How about listing the recovery configuration parameters
> in the index page?
Agreed. This patch should do it. It lists them as "XXX recovery
parameter", e.g:
restore_command recovery parameter, Archive recovery settings
similar to the way GUCs are listed as "XXX configuration parameter".
PS. I just noticed that the links in the index for GUCs take you to the
section in the manual, not directly to the parameter. For example, when
you click on the index term for "max_connections", it takes you to
section "18.3.1 Connection Settings" (the link points to
http://developer.postgresql.org/pgdocs/postgres/runtime-config-connection.html#RUNTIME-CONFIG-CONNEC...),
which begins with listen_addresses. max_connections is there a few
paragraphs down, but I would've expected the link to point directly to
description of the parameter.
--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: recovery configuration parameters
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
2010-04-27 19:52 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
@ 2010-04-28 02:16 ` Fujii Masao <[email protected]>
2010-04-28 06:19 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Fujii Masao @ 2010-04-28 02:16 UTC (permalink / raw)
To: [email protected]; +Cc: pgsql-docs
On Wed, Apr 28, 2010 at 4:52 AM, Heikki Linnakangas
<[email protected]> wrote:
> Fujii Masao wrote:
>> While the server configuration parameters are listed in
>> the index page, why not the recovery ones? It's very
>> inconvenient to be unable to reach the document of them
>> immediately when setting up the standby server.
>>
>> How about listing the recovery configuration parameters
>> in the index page?
>
> Agreed. This patch should do it.
Which patch?
> PS. I just noticed that the links in the index for GUCs take you to the
> section in the manual, not directly to the parameter. For example, when
> you click on the index term for "max_connections", it takes you to
> section "18.3.1 Connection Settings" (the link points to
> http://developer.postgresql.org/pgdocs/postgres/runtime-config-connection.html#RUNTIME-CONFIG-CONNEC...),
> which begins with listen_addresses. max_connections is there a few
> paragraphs down, but I would've expected the link to point directly to
> description of the parameter.
I think that such a direct link is useful, but I'm not sure how.
Though I added the "zone" attribute into the "indexterm" tag for
"max_connections" as a trial, I was not able to get the expected
result.
Regards,
--
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: recovery configuration parameters
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
2010-04-27 19:52 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
2010-04-28 02:16 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
@ 2010-04-28 06:19 ` Heikki Linnakangas <[email protected]>
2010-04-28 07:06 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Heikki Linnakangas @ 2010-04-28 06:19 UTC (permalink / raw)
To: Fujii Masao <[email protected]>; +Cc: pgsql-docs
Fujii Masao wrote:
> On Wed, Apr 28, 2010 at 4:52 AM, Heikki Linnakangas
> <[email protected]> wrote:
>> Fujii Masao wrote:
>>> While the server configuration parameters are listed in
>>> the index page, why not the recovery ones? It's very
>>> inconvenient to be unable to reach the document of them
>>> immediately when setting up the standby server.
>>>
>>> How about listing the recovery configuration parameters
>>> in the index page?
>> Agreed. This patch should do it.
>
> Which patch?
Ah, crap. This one.
--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com
Attachments:
[text/x-diff] recovery-config-index.patch (4.6K, 2-recovery-config-index.patch)
download | inline diff:
diff --git a/doc/src/sgml/recovery-config.sgml b/doc/src/sgml/recovery-config.sgml
index 3aff445..439db3f 100644
--- a/doc/src/sgml/recovery-config.sgml
+++ b/doc/src/sgml/recovery-config.sgml
@@ -36,6 +36,9 @@
<varlistentry id="restore-command" xreflabel="restore_command">
<term><varname>restore_command</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>restore_command</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
The shell command to execute to retrieve an archived segment of
@@ -72,6 +75,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<varlistentry id="restartpoint-command" xreflabel="restartpoint_command">
<term><varname>restartpoint_command</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>restartpoint_command</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
This parameter specifies a shell command that will be executed at
@@ -98,6 +104,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<varlistentry id="recovery-end-command" xreflabel="recovery_end_command">
<term><varname>recovery_end_command</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>recovery_end_command</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
This parameter specifies a shell command that will be executed once only
@@ -129,6 +138,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<term><varname>recovery_target_time</varname>
(<type>timestamp</type>)
</term>
+ <indexterm>
+ <primary><varname>recovery_target_time</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
This parameter specifies the time stamp up to which recovery
@@ -144,6 +156,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<varlistentry id="recovery-target-xid" xreflabel="recovery_target_xid">
<term><varname>recovery_target_xid</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>recovery_target_xid</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
This parameter specifies the transaction ID up to which recovery
@@ -166,6 +181,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<term><varname>recovery_target_inclusive</varname>
(<type>boolean</type>)
</term>
+ <indexterm>
+ <primary><varname>recovery_target_inclusive</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
Specifies whether we stop just after the specified recovery target
@@ -185,6 +203,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<term><varname>recovery_target_timeline</varname>
(<type>string</type>)
</term>
+ <indexterm>
+ <primary><varname>recovery_target_timeline</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
Specifies recovering into a particular timeline. The default is
@@ -207,6 +228,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<varlistentry id="standby-mode" xreflabel="standby_mode">
<term><varname>standby_mode</varname> (<type>boolean</type>)</term>
+ <indexterm>
+ <primary><varname>standby_mode</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
Specifies whether to start the <productname>PostgreSQL</> server as
@@ -221,6 +245,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
</varlistentry>
<varlistentry id="primary-conninfo" xreflabel="primary_conninfo">
<term><varname>primary_conninfo</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>primary_conninfo</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
Specifies a connection string to be used for the standby server
@@ -254,6 +281,9 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
</varlistentry>
<varlistentry id="trigger-file" xreflabel="trigger_file">
<term><varname>trigger_file</varname> (<type>string</type>)</term>
+ <indexterm>
+ <primary><varname>trigger_file</> recovery parameter</primary>
+ </indexterm>
<listitem>
<para>
Specifies a trigger file whose presence ends recovery in the
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: recovery configuration parameters
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
2010-04-27 19:52 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
2010-04-28 02:16 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
2010-04-28 06:19 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
@ 2010-04-28 07:06 ` Fujii Masao <[email protected]>
2010-04-28 07:34 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Fujii Masao @ 2010-04-28 07:06 UTC (permalink / raw)
To: Heikki Linnakangas <[email protected]>; +Cc: pgsql-docs
On Wed, Apr 28, 2010 at 3:19 PM, Heikki Linnakangas
<[email protected]> wrote:
> Fujii Masao wrote:
>> On Wed, Apr 28, 2010 at 4:52 AM, Heikki Linnakangas
>> <[email protected]> wrote:
>>> Fujii Masao wrote:
>>>> While the server configuration parameters are listed in
>>>> the index page, why not the recovery ones? It's very
>>>> inconvenient to be unable to reach the document of them
>>>> immediately when setting up the standby server.
>>>>
>>>> How about listing the recovery configuration parameters
>>>> in the index page?
>>> Agreed. This patch should do it.
>>
>> Which patch?
>
> Ah, crap. This one.
Thanks! Seems good.
Regards,
--
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: recovery configuration parameters
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
2010-04-27 19:52 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
2010-04-28 02:16 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
2010-04-28 06:19 ` Re: recovery configuration parameters Heikki Linnakangas <[email protected]>
2010-04-28 07:06 ` Re: recovery configuration parameters Fujii Masao <[email protected]>
@ 2010-04-28 07:34 ` Heikki Linnakangas <[email protected]>
0 siblings, 0 replies; 6+ messages in thread
From: Heikki Linnakangas @ 2010-04-28 07:34 UTC (permalink / raw)
To: Fujii Masao <[email protected]>; +Cc: pgsql-docs
Fujii Masao wrote:
> On Wed, Apr 28, 2010 at 3:19 PM, Heikki Linnakangas
> <[email protected]> wrote:
>> Fujii Masao wrote:
>>> On Wed, Apr 28, 2010 at 4:52 AM, Heikki Linnakangas
>>> <[email protected]> wrote:
>>>> Fujii Masao wrote:
>>>>> While the server configuration parameters are listed in
>>>>> the index page, why not the recovery ones? It's very
>>>>> inconvenient to be unable to reach the document of them
>>>>> immediately when setting up the standby server.
>>>>>
>>>>> How about listing the recovery configuration parameters
>>>>> in the index page?
>>>> Agreed. This patch should do it.
>>> Which patch?
>> Ah, crap. This one.
>
> Thanks! Seems good.
Ok, committed.
--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2010-04-28 07:34 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2010-04-27 12:03 recovery configuration parameters Fujii Masao <[email protected]>
2010-04-27 19:52 ` Heikki Linnakangas <[email protected]>
2010-04-28 02:16 ` Fujii Masao <[email protected]>
2010-04-28 06:19 ` Heikki Linnakangas <[email protected]>
2010-04-28 07:06 ` Fujii Masao <[email protected]>
2010-04-28 07:34 ` Heikki Linnakangas <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox