Thu Apr 14 22:13:15 PDT 2005
- Previous message: [Slony1-commit] By cbbrowne: A user submitted the following report:
- Next message: [Slony1-commit] By cbbrowne: Normalize various SGML documentation in order to cut down
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Log Message: ----------- Normalized a bunch of stuff to deal with error messages coming from SGML processors with stricter handling of omitted tags... Modified Files: -------------- slony1-engine/doc/adminguide: bookindex.sgml (r1.5 -> r1.6) defineset.sgml (r1.13 -> r1.14) intro.sgml (r1.12 -> r1.13) plainpaths.sgml (r1.6 -> r1.7) -------------- next part -------------- Index: defineset.sgml =================================================================== RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/adminguide/defineset.sgml,v retrieving revision 1.13 retrieving revision 1.14 diff -Ldoc/adminguide/defineset.sgml -Ldoc/adminguide/defineset.sgml -u -w -r1.13 -r1.14 --- doc/adminguide/defineset.sgml +++ doc/adminguide/defineset.sgml @@ -52,8 +52,7 @@ <listitem><para> If the table hasn't even got a candidate primary key, you can ask &slony1; to provide one. This is done by first using <xref linkend="stmttableaddkey"> to add a column populated using a -&slony1; sequence, and then having the <xref -linkend="stmtsetaddtable"> include the directive +&slony1; sequence, and then having the <xref linkend="stmtsetaddtable"> include the directive <option>key=serial</option>, to indicate that &slony1;'s own column should be used.</para></listitem> Index: intro.sgml =================================================================== RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/adminguide/intro.sgml,v retrieving revision 1.12 retrieving revision 1.13 diff -Ldoc/adminguide/intro.sgml -Ldoc/adminguide/intro.sgml -u -w -r1.12 -r1.13 --- doc/adminguide/intro.sgml +++ doc/adminguide/intro.sgml @@ -144,6 +144,7 @@ <para>There are a number of distinct models for database replication; it is impossible for one replication system to be all things to all people.</para></sect2> +</sect1> <sect1 id="slonylistenercosts"><title> <productname>Slony-I</productname> Communications Costs</title> @@ -154,8 +155,8 @@ <itemizedlist> -<listitem><para> It is necessary to have <xref linkend= -"table.sl-listen"> entries allowing connection from each node to every +<listitem><para> It is necessary to have <xref + linkend="table.sl-listen"> entries allowing connection from each node to every other node. Most will normally not need to be very heavily, but it still means that there needs to be n(n-1) paths. </para></listitem> Index: plainpaths.sgml =================================================================== RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/adminguide/plainpaths.sgml,v retrieving revision 1.6 retrieving revision 1.7 diff -Ldoc/adminguide/plainpaths.sgml -Ldoc/adminguide/plainpaths.sgml -u -w -r1.6 -r1.7 --- doc/adminguide/plainpaths.sgml +++ doc/adminguide/plainpaths.sgml @@ -7,32 +7,34 @@ <itemizedlist> <listitem><para> <xref linkend="admconninfo"> - controlling how a -<xref linkend="slonik"> script accesses the various nodes. +<xref linkend="slonik"> script accesses the various nodes.</para> <para> These connections are the ones that go from your -<quote/administrative workstation/ to all of the nodes in a &slony1; -cluster. +<quote>administrative workstation</quote> to all of the nodes in a &slony1; +cluster.</para> -<para> It is <emphasis>vital</emphasis> that you have connections from -the central location where you run <xref linkend="slonik"> to each and -every node in the network. These connections are only used briefly, -to submit the few <acronym>SQL</acronym> requests required to control -the administration of the cluster. +<para> It is <emphasis>vital</emphasis> that you have connections from the +central location where you run <xref linkend="slonik"> +to each and every node in the network. These connections are only +used briefly, to submit the few <acronym>SQL</acronym> requests required to +control the administration of the cluster.</para> <para> Since these communications paths are only used briefly, it may be quite reasonable to <quote>hack together</quote> temporary -connections using <link linkend="tunnelling">SSH tunnelling</link>. +connections using <link linkend="tunnelling">SSH +tunnelling</link>.</para></listitem> <listitem><para> <xref linkend="stmtstorepath"> - controlling how <xref linkend="slon"> daemons communicate with remote nodes. These -paths are stored in <xref linkend="table.sl-path">. +paths are stored in <xref linkend="table.sl-path">.</para> <para> You forcibly <emphasis>need</emphasis> to have a path between each subscriber node and its provider; other paths are optional, and will not be used unless a listen path in <xref -linkend="table.sl-listen">. is needed that uses that particular path. +linkend="table.sl-listen">. is needed that uses that particular +path.</para></listitem> -</itemizedlist> +</itemizedlist></para> <para> The distinctions and possible complexities of paths are not normally an issue for people with simple networks where all the hosts @@ -53,24 +55,24 @@ <listitem><para> DB1 and DB2 are databases residing in a secure <quote>database layer,</quote> firewalled against outside access -except from specifically controlled locations. +except from specifically controlled locations.</para> <para> Let's suppose that DB1 is the origin node for the replication -system. +system.</para></listitem> <listitem><para> DB3 resides in a <quote>DMZ</quote> at the same site; it is intended to be used as a &slony1; <quote>provider</quote> for -remote locations. +remote locations.</para></listitem> <listitem><para> DB4 is a counterpart to DB3 in a <quote>DMZ</quote> at a secondary/failover site. Its job, in the present configuration, is to <quote>feed</quote> servers in the secure database layers at the -secondary site. +secondary site.</para></listitem> <listitem><para> DB5 and and DB6 are counterparts to DB1 and DB2, but -are, at present, configured as subscribers. +are, at present, configured as subscribers.</para> <para> Supposing disaster were to strike at the <quote>primary</quote> site, the secondary site would be well-equipped to take over servicing -the applications that use this data. +the applications that use this data.</para> <para> Managers paying bills are likely to be reluctant to let the machines at the secondary site merely be <quote>backups;</quote> they @@ -78,7 +80,7 @@ be the case. If the primary site is being used for <quote>transactional activities,</quote> the replicas at the secondary site may be used for running time-oriented reports that are allowed to -be a little bit behind. +be a little bit behind.</para></listitem> <listitem><para> The symmetry of the configuration means that if you had <emphasis>two</emphasis> transactional applications needing @@ -86,13 +88,14 @@ additional replication sets so that each site is normally <quote>primary</quote> for one application, and where destruction of one site could be addressed by consolidating services at the remaining -site. +site.</para></listitem> </itemizedlist> -<para> +<para></para> -<para> There is also room for discussion of SSH tunnelling here...</para> +<para> There is also room for discussion of SSH tunnelling +here...</para> </sect1> <!-- Keep this comment at the end of the file
- Previous message: [Slony1-commit] By cbbrowne: A user submitted the following report:
- Next message: [Slony1-commit] By cbbrowne: Normalize various SGML documentation in order to cut down
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
More information about the Slony1-commit mailing list