Log Message:
-----------
Added in documentation for New Generation testbed

Tags:
----
REL_1_1_STABLE

Modified Files:
--------------
    slony1-engine/doc/adminguide:
        filelist.sgml (r1.13 -> r1.13.2.1)
        slony.sgml (r1.20 -> r1.20.2.1)

Added Files:
-----------
    slony1-engine/doc/adminguide:
        testbed.sgml (r1.3.2.1)

-------------- next part --------------
Index: slony.sgml
===================================================================
RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/adminguide/slony.sgml,v
retrieving revision 1.20
retrieving revision 1.20.2.1
diff -Ldoc/adminguide/slony.sgml -Ldoc/adminguide/slony.sgml -u -w -r1.20 -r1.20.2.1
--- doc/adminguide/slony.sgml
+++ doc/adminguide/slony.sgml
@@ -8,6 +8,7 @@
   <!entity reference  SYSTEM "reference.sgml">
   <!ENTITY slony1 "<PRODUCTNAME>Slony-I</PRODUCTNAME>">
   <!ENTITY postgres "<PRODUCTNAME>PostgreSQL</PRODUCTNAME>">
+  <!ENTITY windows "<trademark>Windows</trademark>">
 ]>
 
 <book id="slony">
@@ -37,7 +38,7 @@
 <article id="slonyadmin"> 
 <title> Slony-I Administration </title>
  <articleinfo>
-  <corpauthor>The Slony Global Development Group</corpauthor>
+  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
   <author> <firstname>Christopher</firstname> <surname>Browne</surname> </author>
  </articleinfo>
  &firstdb;
@@ -58,6 +59,7 @@
  &adminscripts;
  &versionupgrade;
  &bestpractices;
+ &testbed;
  &help;
 </article>
 
Index: filelist.sgml
===================================================================
RCS file: /usr/local/cvsroot/slony1/slony1-engine/doc/adminguide/filelist.sgml,v
retrieving revision 1.13
retrieving revision 1.13.2.1
diff -Ldoc/adminguide/filelist.sgml -Ldoc/adminguide/filelist.sgml -u -w -r1.13 -r1.13.2.1
--- doc/adminguide/filelist.sgml
+++ doc/adminguide/filelist.sgml
@@ -40,6 +40,7 @@
 <!entity bestpractices      SYSTEM "bestpractices.sgml">
 <!entity locking            SYSTEM "locking.sgml">
 <!entity supportedplatforms SYSTEM "supportedplatforms.sgml">
+<!entity testbed            SYSTEM "testbed.sgml">
 
 <!-- back matter -->
 <!entity biblio     SYSTEM "biblio.sgml">
--- /dev/null
+++ doc/adminguide/testbed.sgml
@@ -0,0 +1,113 @@
+<!-- $Id: testbed.sgml,v 1.3.2.1 2005/11/30 17:41:30 cbbrowne Exp $ -->
+<sect1 id="testbed"><title> &slony1; Test Bed Framework </title>
+
+<para> As of version 1.2, &slony1; has a common test bed framework
+intended to better support performing a comprehensive set of tests.
+The code lives in the source tree under the <filename> tests
+</filename> directory.</para>
+
+<para>Here are some of the vital files...</para>
+
+<itemizedlist>
+
+<listitem><para> <filename>run_test.sh</filename> </para></listitem>
+
+</itemizedlist>
+
+<para> This is the central script for running tests.  Typical usage is
+thus:</para>
+
+<para> <command> ./run_test.sh </command></para>
+<screen>
+usage ./run_test.sh testname
+</screen>
+
+<para> You need to specify the subdirectory name of the test set to be
+run; each such set is stored in a subdirectory of
+<filename>tests</filename>.</para>
+
+<para> You may need to set one or more of the following environment
+variables to reflect your local configuration.  For instance, the
+writer runs his <quote>main</quote> test like the following:</para>
+
+<screen> PGBINDIR=/opt/OXRS/dbs/pgsql8/bin PGPORT=5532 PGUSER=cbbrowne ./run_test.sh test1 </screen>
+
+<glosslist>
+<glossentry><glossterm> <envar>PGBINDIR</envar> </glossterm>
+
+<glossdef><para> This determines where the test scripts look for
+&postgres; and &slony1; binaries.  The default is <filename>
+/usr/local/pgsql/bin</filename> </para> 
+
+<para> There are also variables <envar>PGBINDIR1</envar> thru
+<envar>PGBINDIR13</envar> which allows you to specify a separate path
+for each database instance.  That will be particularly useful when
+testing interoperability of &slony1; across different versions of
+&postgres;. In order to create a database of each respective version,
+you need to point to an <application>initdb</application> of the
+appropriate version.</para> </glossdef> </glossentry>
+
+<glossentry><glossterm> <envar>PGPORT</envar> </glossterm>
+<glossdef><para> This indicates what port the backend is on.  By
+default, 5432 is used. </para> 
+
+<para> There are also variables <envar>PORT1</envar> thru
+<envar>PORT13</envar> which allows you to specify a separate port
+number for each database instance.  That will be particularly useful
+when testing interoperability of &slony1; across different versions of
+&postgres;. </para> </glossdef> </glossentry>
+
+<glossentry><glossterm> <envar>PGUSER</envar> </glossterm>
+<glossdef><para> By default, the user <filename>postgres</filename> is
+used; this is taken as the default user ID to use for all of the
+databases. </para>
+
+<para> There are also variables <envar>USER1</envar> thru
+<envar>USER13</envar> which allow specifying a separate user name for
+each database instance.</para>  </glossdef> </glossentry>
+
+<glossentry><glossterm> <envar>HOST</envar> </glossterm>
+<glossdef><para> By default, <filename>localhost</filename> is used.
+</para>
+
+<para> There are also variables <envar>HOST1</envar> thru
+<envar>HOST13</envar> which allow specifying a separate host for
+each database instance.</para></glossdef>
+</glossentry>
+
+<glossentry><glossterm> <envar>DB1</envar> thru <envar>DB13 </envar> </glossterm> 
+
+<glossdef><para> By default, <filename>slonyregress1</filename> thru
+<filename>slonyregress13</filename> are used.
+</para>
+
+<para> You may override these from the environment. </para></glossdef>
+</glossentry>
+
+<glossentry>
+<glossterm><envar>ENCODING</envar></glossterm>
+
+<glossdef><para> By default, <filename>UNICODE</filename> is used, so
+that tests can create UTF8 tables and test the multibyte capabilities.
+</para></glossdef>
+
+</glossentry>
+
+</glosslist>
+
+</sect1>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode:sgml
+sgml-omittag:nil
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:"book.sgml"
+sgml-exposed-tags:nil
+sgml-local-catalogs:("/usr/lib/sgml/catalog")
+sgml-local-ecat-files:nil
+End:
+-->