From 1a3ced3f45423d79e08ca7d861e8118e8618d3b2 Mon Sep 17 00:00:00 2001 From: "Chris St. Pierre" Date: Fri, 5 Oct 2012 11:57:16 -0400 Subject: wrote more detailed unit testing documentation --- doc/development/testing.txt | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) (limited to 'doc/development/testing.txt') diff --git a/doc/development/testing.txt b/doc/development/testing.txt index 1f0842053..f00193574 100644 --- a/doc/development/testing.txt +++ b/doc/development/testing.txt @@ -8,22 +8,24 @@ Testing Testing Prereleases ------------------- -Before each release, several prereleases will be tagged. It is -helpful to have users test these releases (when feasible) because -it is hard to replicate the full range of potential reconfiguration -situations; between different operating systems, system management -tools, and configuration specification variation, there can be -large differences between sites. +Before each release, several prereleases will be tagged. It is helpful +to have users test these releases (when feasible) because it is hard +to replicate the full range of potential reconfiguration situations; +between different operating systems, system management tools, and +configuration specification variation, there can be large differences +between sites. -For more details please visit `Tracking Development Releases of Bcfg2 `_ . +For more details please visit `Tracking Development Releases of Bcfg2 +`_ +. Upgrade Testing --------------- -This section describes upgrade procedures to completely test the -client and server. These procedures can be used for either pre-release +This section describes upgrade procedures to completely test the +client and server. These procedures can be used for either pre-release testing, or for confidence building in a new release. @@ -33,9 +35,9 @@ Server Testing 1. Ensure that the server produces the same configurations for clients * Before the upgrade, generate all client configurations using the - buildall subcommand of bcfg2-info. This subcommand takes a directory - argument; it will generate one client configuration in each file, - naming each according to the client name. + buildall subcommand of bcfg2-info. This subcommand takes a + directory argument; it will generate one client configuration in + each file, naming each according to the client name. .. code-block:: sh @@ -54,7 +56,8 @@ Server Testing * Upgrade the server software * Generate all client configurations in a second location using the new software. Any tracebacks reflect bugs, and should be filed in - the ticketing system. Any new messages should be carefully examined. + the ticketing system. Any new messages should be carefully + examined. * Compare each file in the old directory to those in the new directory using ``bcfg2-admin compare -r /old/directory /new/directory`` @@ -78,5 +81,5 @@ Server Testing Client Testing ^^^^^^^^^^^^^^ -Run the client in dry-run and non-dry-run mode; ensure that multiple +Run the client in dry-run and non-dry-run mode; ensure that multiple runs produce consistent results. -- cgit v1.2.3-1-g7c22