blob: 1f0842053dbc7541d4751a25203bfdbfced97e97 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
.. -*- mode: rst -*-
.. _development-testing:
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.
For more details please visit `Tracking Development Releases of Bcfg2 <http://trac.mcs.anl.gov/projects/bcfg2/wiki/TrackingDevelopmentTrunk>`_ .
Upgrade Testing
---------------
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.
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.
.. code-block:: sh
mgt1:~/bcfg# bcfg2-info
Filesystem check 1 of 25
...
> buildall /path/to/cf-old
Generated config for fs2.bgl.mcs.anl.gov in 1.97310400009 seconds
Generated config for fs13.bgl.mcs.anl.gov in 1.47958016396 seconds
...
Take notice of any messages produced during configuration generation.
These generally reflect minor issues in the configuration specification.
Ideally, they should be fixed.
* 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.
* Compare each file in the old directory to those in the new directory
using ``bcfg2-admin compare -r /old/directory /new/directory``
.. code-block:: sh
mgt1:~/bcfg# bcfg2-admin compare -r cf-old/ cf-new/
Entry: fs2.bgl.mcs.anl.gov.xml
Entry: fs2.bgl.mcs.anl.gov.xml good
Entry: fs13.bgl.mcs.anl.gov.xml
Entry: fs13.bgl.mcs.anl.gov.xml good
Entry: login1.bgl.mcs.anl.gov.xml
ConfigFile /bin/whatami contents differ
ConfigFile /bin/whatami differs (in bundle softenv)
Entry: login1.bgl.mcs.anl.gov.xml bad
This can be used to compare configurations for single clients, or
different clients.
2. Compare old and new group diagrams (using ``bcfg2-admin viz``)
Client Testing
^^^^^^^^^^^^^^
Run the client in dry-run and non-dry-run mode; ensure that multiple
runs produce consistent results.
|
