diff options
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/config.sgml | 25 | ||||
| -rw-r--r-- | doc/src/sgml/installation.sgml | 13 | ||||
| -rw-r--r-- | doc/src/sgml/runtime.sgml | 46 |
3 files changed, 71 insertions, 13 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index fa2dcf336c4..3ace7dfa930 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -3037,6 +3037,14 @@ local0.* /var/log/postgresql to the <application>syslog</application> daemon's configuration file to make it work. </para> + <para> + On Windows, when you use the <literal>eventlog</literal> + option for <varname>log_destination</>, you should + register an event source and its library with the operating + system so that the Windows Event Viewer can display event + log messages cleanly. + See <xref linkend="event-log-registration"> for details. + </para> </note> </listitem> </varlistentry> @@ -3287,6 +3295,23 @@ local0.* /var/log/postgresql </listitem> </varlistentry> + <varlistentry id="guc-event-source" xreflabel="event_source"> + <term><varname>event_source</varname> (<type>string</type>)</term> + <indexterm> + <primary><varname>event_source</> configuration parameter</primary> + </indexterm> + <listitem> + <para> + When logging to <application>event log</> is enabled, this parameter + determines the program name used to identify + <productname>PostgreSQL</productname> messages in + the log. The default is <literal>PostgreSQL</literal>. + This parameter can only be set in the <filename>postgresql.conf</> + file or on the server command line. + </para> + </listitem> + </varlistentry> + </variablelist> </sect2> <sect2 id="runtime-config-logging-when"> diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 0410cff4aca..41b9009de05 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -1552,19 +1552,6 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install. </procedure> <formalpara> - <title>Registering <application>eventlog</> on <systemitem - class="osname">Windows</>:</title> - <para> - To register a <systemitem class="osname">Windows</> <application>eventlog</> - library with the operating system, issue this command after installation: -<screen> -<userinput>regsvr32 <replaceable>pgsql_library_directory</>/pgevent.dll</> -</screen> - This creates registry entries used by the event viewer. - </para> - </formalpara> - - <formalpara> <title>Uninstallation:</title> <para> To undo the installation use the command <command>gmake diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml index 68ceff15303..86499c67ac5 100644 --- a/doc/src/sgml/runtime.sgml +++ b/doc/src/sgml/runtime.sgml @@ -2295,4 +2295,50 @@ ssh -L 63333:db.foo.com:5432 joe@shell.foo.com </sect1> + <sect1 id="event-log-registration"> + <title>Registering <application>Event Log</> on <systemitem + class="osname">Windows</></title> + + <indexterm zone="event-log-registration"> + <primary>event log</primary> + <secondary>event log</secondary> + </indexterm> + + <para> + To register a <systemitem class="osname">Windows</> + <application>event log</> library with the operating system, + issue this command: +<screen> +<userinput>regsvr32 <replaceable>pgsql_library_directory</>/pgevent.dll</> +</screen> + This creates registry entries used by the event viewer, under the default + event source named <literal>PostgreSQL</literal>. + </para> + + <para> + To specify a different event source name (see + <xref linkend="guc-event-source">), use the <literal>/n</literal> + and <literal>/i</literal> options: +<screen> +<userinput>regsvr32 /n /i:<replaceable>event_source_name</> <replaceable>pgsql_library_directory</>/pgevent.dll</> +</screen> + </para> + + <para> + To unregister the <application>event log</> library from + the operating system, issue this command: +<screen> +<userinput>regsvr32 /u [/i:<replaceable>event_source_name</>] <replaceable>pgsql_library_directory</>/pgevent.dll</> +</screen> + </para> + + <note> + <para> + To enable event logging in the database server, modify + <xref linkend="guc-log-destination"> to include + <literal>eventlog</literal> in <filename>postgresql.conf</filename>. + </para> + </note> + </sect1> + </chapter> |