<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML><HEAD><META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"><TITLE></TITLE><META NAME="GENERATOR" CONTENT="OpenOffice.org 3.2 (Unix)"><META NAME="AUTHOR" CONTENT="tim "><META NAME="CREATED" CONTENT="20120112;13215100"><META NAME="CHANGEDBY" CONTENT="tim "><META NAME="CHANGED" CONTENT="20120213;11591300"><STYLE TYPE="text/css"><!-- @page { margin: 2cm } P { margin-bottom: 0.21cm } H1 { margin-bottom: 0.21cm } H1.western { font-family: "Liberation Sans", sans-serif; font-size: 16pt } H1.cjk { font-family: "DejaVu Sans"; font-size: 16pt } H1.ctl { font-family: "DejaVu Sans"; font-size: 16pt } H2 { margin-bottom: 0.21cm } H2.western { font-family: "Liberation Sans", sans-serif; font-size: 14pt; font-style: italic } H2.cjk { font-size: 14pt; font-style: italic } H2.ctl { font-size: 14pt; font-style: italic } H3 { margin-bottom: 0.21cm } H3.western { font-family: "Liberation Sans", sans-serif } TD P { margin-bottom: 0cm } A:link { so-language: zxx }

--></STYLE></HEAD><BODY LANG="en-AU" DIR="LTR">

1Introduction

1.1Purpose

The purpose of this document is to define a high level QA strategy

at Moodle and communicate that process to the relevant stakeholders. This document is loosely based upon the IEEE829 standard for software testing documentation; adaptations have been made to this standard to make the document more lightweight, suitable for use in an agile process and relevant to the organisation.

This document is test centric, only explaining the development

process from a testing point of view. The scope of this document does not cover the details of the entire development process at Moodle but how testing is applied to it. This document also discusses potential

benefits to the organisation of the processes discussed.

1.2Scope

This document encompasses all testing activities at Moodle and how they will be performed. This includes:

Testing methodology at Moodle
How testing applies to the Moodle development life cycle
Managing legacy items
Hardware requirements
Testing tools and how they will be used
Test Environments
Roles and responsibilities
Training requirements

2Testing Methodology at Moodle

The full <A HREF="https://docs.moodle.org/dev/Process">development

life-cycle</A> at Moodle is documented in detail <A HREF="https://docs.moodle.org/dev/Process">elsewhere</A>. Moodle is currently developed using agile methodologies including scrum. The following stages of development take place within this

life-cycle:

Weekly integration cycle
3 weekly stable sprints
6 monthly major releases
3 point releases between every major release

2.1Testing Methodology

It is desirable on an agile project that a process of test driven

development and continuous integration (CI) is performed. The aim of this is to increase business value and return on investment (ROI) by allowing software defects and issues - such as conflicting or problematic requirements - to be detected early in the software development life cycle (SDLC) when they can be resolved more easily. Although some manual testing is still required; to provide frequent and swift feedback, it is desirable that test automation is used where possible.

Currently there are no definition of distinct testing

methodologies at Moodle. To give context to what types of tests should run and when, Moodle will adopt a process of categorising distinct types of test and their purpose.

Leading agile testing exponent, Brian Marick, introduced the

concept of testing quadrants to define different categories of tests

that accomplish different purposes:

<IMG SRC="moodle%20test%20process%20v0.1%20(draft)_html_65cb6144.png" NAME="graphics1" ALIGN=LEFT WIDTH=643 HEIGHT=511 BORDER=0>Lisa

Crispin and Janet Gregory explain these quadrants in detail in their book: “Agile Testing: A Practical Guide or Testers and Agile Teams”. To summarise, this is a list of traditional testing disciplines categorised relative to their context in an Agile process such as scrum.

Moodle is open source, community based software and this poses a

number of unique challenges to a test driven, agile, process. Because Moodle is community based, with features and bug fixes developed externally and submitted to integration, some forms of testing defined here, such as paper prototyping, may not be relevant to the organisation. This section is therefore intended as reference material only, with the methods of testing described in this section being potential weapons in Moodle's testing arsenal; actual testing

process will be defined later in the document.

Moodle will adopt the agile testing quadrant to define testing

categories relevant to the organisation and facilitate communication of required testing on Moodle projects.

2.1.1Quadrant Terms Explained

Tests that support the team – tests that assist with development and requirements gathering.
Tests that critique the product – constructive appraisal of the software under test to drive future development.
Technology facing – tests that verify scientific and technological aspects of the software under test.

Business
facing – tests that verify the business logic, processes and
communicate user requirements.

2.1.2Testing Disciplines Explained

Functional Testing – Interacting positively
and negatively with the software under test the way a user or process would, with specific expectations of inputs and outputs from
the system under test.
Examples – Examples of user scenarios.
Story Tests – Defining a development story using a test.
Prototypes – e.g. paper prototyping of the
system under development to gather and communicate customer
requirements for the user interface.
Simulations – e.g. Wizard of Oz testing;
similar to paper prototyping but involving inputs to and outputs from a human representing the system. Used for gathering functional
requirements from users.
Unit testing – testing the behaviour of a particular piece of code.
Component testing – testing the interaction of interrelated pieces of code.
Exploratory testing – freestyle testing of the
system under test. The scope of exploratory testing can be limited
by defined constraints.
Scenarios – Specific business scenarios.
Usability testing – Using roles to exercise the system in a way the user might (something Moodle already does).
UAT – Real users executing tests to evaluate it's suitability relevant to business requirements.
Alpha/Beta – Suitable for software distributed
to a large customer base where formal UAT may not be practical. Both have a similar goal to UAT. Alpha is an early distribution of the software, that may not be fully complete, to selected users for early feedback. Beta is distribution of almost finished software to
users.
Performance and Load Testing – Testing the
responsiveness of the software in normal circumstances and under
high usage conditions.
Security Testing – Testing application security features.
'ility' Testing – Security, Maintainability, Interoperability, Compatibility, Scalability etc. etc.

3Methodologies in the Moodle Development Process

As previously discussed, Moodle has an established

process for developing and integrating software. This section applies

relevant testing methodology to the existing process.

Generally a re-usable automated suite of functional

regression tests, a test automation harness, it's supporting infrastructure and phased development of regular automated functional regression tests will be developed in an iterative manner using scrum. Initially these test cases will be based upon the current user acceptance test cases. The tools and other aspects of automation will

be discussed later in the document.

3.1Weekly (Continuous) Integration Cycle

Current testing of integration issues occurs towards

the end of the SDLC at Moodle during the Wednesday (AWST) testing phase. This is the last possible chance Moodle gets to capture regressions. It will result in the late discovery of regressions during unguided exploratory testing and worse still the introduction of regressions into Master. Discovery of issues late in the SDLC prevent the issues from being dealt with in a timely manner when

integrators are able to resolve those issues relatively easily.

The processes described here will move the bulk of

testing and the majority of responsibility for capturing regressions from the Wednesday testing phase to earlier in the SDLC whilst also

increasing test coverage.

3.1.1Continuous Integration (CI)

Continuous

integration provides early feedback of problematic code to the team. We will know early in the SDLC whether a working version of the code

is available and what to do to make it work.

A CI server

currently exists for the integration process. This server will be

moved to a VM on the VM Server.

3.1.2Functional Test Automation

Frequently running tests similar to those currently

executed during the 6 monthly major release more regularly, earlier in the SDLC will assist with trapping regression issues at the point where integration into the existing code base occurs. This will help

integrators either:

Protect existing code by allowing integrators to stop the new code being added.
Allow the immediate rectification of the
regression issues at integration rather than finding them later in
the SDLC.

The weekly integration cycle has a phase of manual

bug retesting throughout the working day on Wednesdays (AWST). The automated functional regression suite described above will run outside of working hours (AWST) and can be run as often as required.

The set up of test VMs will be performed by the

3.1.3Performance Testing Matrix

Measuring system performance during this testing will

assist with preventing degradation of performance in existing code

caused by regressions.

To assist with early capture of performance

degradation due to regression; a performance matrix will record performance against automated user interactions generated by the

functional test harness.

Consideration will be given to modifying the

functional test harness, selecting relevant test cases that will be re-run a given number of times to generate aggregated results as part of a performance and load suite. i.e. running the same test several times as part of a suite of tests in one “test run” will provide more accurate performance data, providing mean values, than running a

test once.

3.1.4New Unit Tests

Creating unit tests prior to creating the code starts

the whole SDLC off with a focus on quality. If the code isn't considered complete until the test passes then the code itself will be of a high quality by the time it is implemented. It also creates a repository of unit regression tests in an iterative manner whilst not requiring of a great deal of extra effort to write those tests. As these tests are added, they will provide early regression testing on

new code.

The various XUnit code driven unit testing frameworks

are universally popular, incredibly powerful and the industry standard for unit testing tools. PHPUnit will provide developers with

a more powerful suite of tools for unit testing.

Everything submitted to integration must include unit

tests in PHPUnit. It is to be encouraged that anyone developing software for Moodle should work in a test driven manner, where unit tests are written before writing the code that makes the test pass. The unit tests will remain with the system under test and can be run as regression tests using a CI server. The tests will run whenever

any new code is added to any monitored GIT repository.

3.1.5Legacy Unit Tests

Legacy unit tests are not run automatically. These

tests can be run automatically on a regular basis via CI. Running these using CI, even using a workaround by executing them automatically via the Moodle user interface, will provide early

regression testing on legacy code.

Unit tests are currently written using the SimpleTest

tool. These tests are included with Moodle and can be run as an Admin

user. These legacy tests must run automatically using a CI server.

3.1.6Causal Analysis of Issues

As part of the weekly integration cycle, issues will

be analysed and documented to determine the likely cause of the issue. The analysis will provide metrics for determining and removing

areas of risk where defects are injected during development.

The metrics gathered during this exercise can be used to identify problem areas of the system.

Problematic areas of the system can be tested more thoroughly than less problematic areas.
The cause of the issues can be identified and eliminated.

Fewer route causes of issues will reduce the number of issues and increase ROI and overall quality.

3.1.7Restricted Scope Manual Testing

The scope of testing issue fixes must be limited to

retesting the issue itself. Clear instructions to specifically recreate the issue must be included in the testing instructions of

the issue.

Restricting the scope of manual testing during the

Wednesday (AWST) testing phase will reduce the effort required to retest the issues and yet there will actually be more testing performed than there is at the moment and earlier in the SDLC. This will only be possible if those raising issues provide precise

instructions for recreating the problem.

3.2Stable Sprints

Development work during stable sprints is performed

in-house by Moodle HQ developers and will follow a process of Test Driven Development (TDD). The requirements for Stable sprints are gathered with testing steps from tracker issues. To allow this process to work effectively, so that requirements are not ambiguous, any new tracker issues must be raised with clear and unambiguous

testing instructions.

Programmers working on the stable sprint will write

unit tests and component tests from Q1 of the agile testing quadrants matrix that will prove their fixes to code works. Then they will

write their fixes

3.2.1Continuous Integration

To allow early feedback on fixes provided by the

stable team they will require their own branch in GIT and their own instance of Jenkins. Developers will check their code into this branch at the end of each day and unit tests will run at check in and

again overnight.

3.2.2 3.2.3Functional Test Automation

Automated functional testing will take place as part of the regular integration cycle.

3.3Major Releases and New Development

3.4Point Releases

4Managing Legacy Items

5Hardware Requirements

A cloud based server will be used to virtualize all test and build platforms. The server is already in the process of being provisioned.

Server specifications are:

Make/Model: Dell T710

CPU: 2 x Intel Xeon E5645 2.4GHz, 12MB Cache 6 core CPU

Network: 2 x Broadcom 5709C dual-port gigabit ethernet module

RAM: 48GB (12x4GB) 1333MHz LV RDIMMS (triple channel)

Storage: 4 x 600GB 3.5" 15,000 RPM 6GBPS SAS hot plug hard disks with Dell H700 1GB Raid card configured for RAID 10.

6Testing Tools and Their Use

All of the tools specified below are free with most being open source and extendible. The advantages are:

There is no cost to Moodle for licences.
Applications are web based with a tiny footprint and will run on low spec hardware/VMs.
Applications with databases all run on MySQL, which is free.
Moodle can extend the tools/create plugins, in-house, if customisations are required.

6.1Continuous Integration

Continuous integration is the process of running

tests frequently when code is checked into a repository. The aim of this is to keep code clean and allow the early capture of broken/incomplete code, early warning of conflicting changes (regressions) and a constantly available current “build” for demo

and testing.

6.1.1Jenkins

Jenkins is a fully extendible application that

monitors executions of repeated jobs. Results are displayed via a web

application.

Jenkins will be used as an information hub to provide Moodle with continuous feedback about the quality of Moodle software.

Jenkins can monitor any/multiple GIT repository for

changes without adding hooks to the code and be used to run a set of

tasks such as:

Pull git
Run unit tests
Create a moodle site
Add some information to it
Run the selenium tests
Report errors/warnings/failures

6.1.2Phing

“PHing Is

Not GNU make” is a build tool for PHP based upon Apache Ant. Phing commands are specified in XML just like in Ant. Phing can run PHPUnit and SimpleTest unit tests, execute shell commands, perform actions with

GIT and much, much more.

As part of continuous

integration Phing will be the engine behind Jenkins, performing tasks like getting the latest code for a test environment for the GIT

repository and running unit tests.

6.1.3 Phing Jenkins Plugin

This plugin integrates Phing with Jenkins.

6.1.4Clover PHP Plugin

To capture code coverage reports from PHPUnit.

6.1.5PHPUnit

Unit testing tool for PHP; implementation is already planned.

6.1.6SimpleTest

Moodle's legacy unit testing tool.

6.2Other Automated Testing

Methods of testing other than unit testing will be automated. This includes, but is not limited to functional testing.

6.2.1Selenium

Selenium is an extremely powerful, free and fully

extendible browser automation tool that contains the following

features:

Selenium IDE – Firefox plugin app for
recording browser interactions with any web application. This is ideal for creating quick bug recreation test scripts and automation
aided exploratory testing.
Selenium Webdriver – Selenium Server is a
server application that runs Selenium test cases. Selenium webdriver
is a collection of language specific bindings to drive a browser.

Selenium provides extensions to existing unit test

tools such as JUnit. There are unofficial language bindings for PHPUnit and webdriver and an official backwards compatibility to

version one of Selenium through PHPUnit.

Selenium test cases can be written in an object oriented manner and re-usable methods can be created.

Selenium is highly

resistant to CSS changes and supports using XPath to locate page

elements.

Furthermore

Selenium server can be run in a grid configuration so that tests can run in parallel across multiple test environments controlled by one

hub:

When a test is

required to run on a specific platform Selenium Grid can be made aware of the environments you wish to use. The Selenium Hub will then ensure that a test runs only on the Selenium slaves providing

the requested environment:

6.2.2Selenium Jenkins Plugin

A Jenkins plugin that gives Jenkins the ability to

turn a Jenkins cluster into a Selenium Cluster. The plugin installs Selenium Grid on all of the slaves automatically and sets up the grid on it's own. Great for deploying the latest code to multiple Selenium

test environments automatically.

6.2.3Firebug

Firebug is Firefox plugin that gives a user the ability to easily inspect page source.

6.2.4Firepath

Firepath is a Firefox plugin that can generate XPath expressions.

6.2.5Eclipse IDE

Eclipse IDE will be used to design Selenium test cases.

6.2.6JUnit/PHPUnit Selenium Extension

SeleniumHQ officially support JUnit extensions for

Selenium. The JUnit support is more mature than PHPUnit and is fully

updated to work with the latest version of Selenium Server.

6.3Hosting Test Environments

Hosting instances of Jenkins and test environments will be performed using server virtualization.

6.3.1XEN

Xen is a robust, secure, high performance type 1 baremetal

hypervisor, or a virtual machine monitor (VMM). Xen can securely execute multiple virtual machines, each running its own OS, on a single physical system with close-to-native performance. Xen is open source, and it's used as the core virtualization engine for many

vendors products.

6.4Version Control

6.4.1GIT

Moodle use GIT for version control.

6.5Test Management and Defect Tracking

6.5.1TestLink

TestLink is a free test management tool written in

PHP. The test management tool is used to specify and manage tests and test suites, then report on test execution. A test management tool is useful for managing and co-ordinating organisational testing effort and documenting testing. Currently Moodle use Jira as the test management tool. Jira is software development management tool and not

a test management tool.

In TestLink we can create testing projects, test

plans and document test cases, manage test execution runs then log

and report results for manual and automated tests.

6.5.2TestLink Jenkins Plugin

This plugin integrates TestLink with Jenkins and generates reports on automated test execution.

6.5.3Jira

Moodle already use Jira for development and project planning and tracking issues.

7Test Environments

Test environments for automation will be hosted on

the VM server. These will include a CI server (the build machine),

database servers, web servers and client PCs.

7.1Requirements Gathering

As a task while provisioning the VM Server, two

surveys have been run to determine popular Test Platforms. Survey 1 gathered metrics from the Moodle Community and Survey 2 gathered metrics from Moodle Partners. Limiting factors of these surveys are that both samples are relatively small. The results of the surveys

are as follows:

7.1.1Survey 1 The Moodle Community:

Fig. 1 Separate Database and Web Server Yes/No:

Fig. 2 Operating System of Separate Web Server:

Fig. 3 Operating System of Separate Database Server:

Fig. 4 What Databases are Used on a Split System:

Fig. 5 What Databases are Used on an all in one Database Server and Webserver:

Fig. 6 What Web Server is Used on a Split System:

Fig. 7 What Web Server is Used on an all in one Database Server and Webserver:

As Debian and Ubuntu are similar and Red Hat and

Centos are similar that,based upon our sample data, our three main operating used by the Moodle community Debian/Ubuntu, Red Hat/Centos and MS Server 2008 with a weighting of almost 75% towards the two

Linux operating systems.

Of the five supported databases, the majority of

community users prefer MySQL with PostgreSQL and MSSQL a fairly equal

but distant second and third.

The Majority of community users also use Apache with IIS a very distant second.

7.1.1Survey 2 The Moodle Partners:

Fig. 8 Separate Database and Web Server Yes/No:

Fig. 9 Partner OS Database Server (combining answers for fig 8):

Fig. 10 Partner OS Web Server (combining answers for fig 8):

Fig. 11 What Databases are Used on a Split System:

Fig. 12 What Databases are Used on a Combined System:

Fig. 12 What Web Servers are used on a Split System:

Fig. 13 What Web Servers are used on a Combined System:

This suggests that the majority of partners use

Debian/Ubuntu or Centos/Rad Hat Linux, Apache and either a MySQL or

PostgreSQL database.

7.2VM Requirements

In true agile fashion and to promote flexibility,

VM's for test environments will be modular i.e. they will be separate database servers and web servers. This will allow the mixing and matching of databases and their host OS to the web servers and their host OS as requirements change. At any time, any Web Server can connect to any Database Server. It should also reduce potential

numbers of running VMs required for a particular platform.

<IMG SRC="moodle%20test%20process%20v0.1%20(draft)_html_6185ac88.gif" ALIGN=LEFT>A

master hub VM is required for Jenkins and the hub for the Selenium

grid.

8Implementation

Agile testing guru and automation expert Brian Marick

coined the term “Hump of Pain” to describe the initial phase of implementing test automation. The impact of this hump can be minimised by good planning, good coaching and a strong managerial support for the new processes. As time progresses, particularly as infrastructure becomes implemented, the test cases in the automated suite are completed and the introduced practices become second

nature; the hump disappears.

8.1Agile Implementation of Testing Practices

Modifications to the process should be made in an incremental

manner based up scrum methodology. A series of 2 weekly sprints will

be used to time-box test planning and implementation tasks.

8.2Phase 1: Infrastructure and the Integration Process

The infrastructure to maintain automated testing

effort must be implemented. This process will start with the installation of cloud based hardware at Moodle HQ and the setup of

VM's to support the required test environments.

The integration process affects quality for the whole

organisation as all code must go through the integration process to become 'live'. The processes described above will will be initially implemented at integration. Any changes to the existing processes will take place side-by-side with existing processes to manage risk. i.e. existing processes impacted by changes will be maintained in

their current state until implementation of changes becomes stable.

The setup of test environments will initially start

with a restricted number of high risk test environments so that the automation process, particularly test cases, can be developed

incrementally.

9Roles and Responsibilities

Below is a list of stakeholders and their roles relevant to this document

Name	Role	Responsibilities
Tim Barker	Test Manager	Co-ordinate testing effort Define organisational test strategy and requirements Specify test plans and cases
Jordan Tomkinson	System Administrator	Provision of Hardware Commission test platforms and supporting infrastructure
Martin Dougiamas	Moodle Founder and MD	Approval
Michael de Raadt	Development Manager	Approval
Eloy Lafuente	Knight in Shining Armour	Technical guidance and advice
Helen Foster	Community Manager	Community liaison with regard to requirements gathering
Moodle Developers	Development	Input into VM requirements Design and write unit tests Test Execution Performance Test Matrix (Sam Hemelryk)

10Training Requirements

11Useful Resources

<A HREF="http://jenkins-php.org/">Template for Jenkins Jobs for PHP Projects</A>

<A HREF="http://www.phing.info/trac/">Phing</A>

<A HREF="https://wiki.jenkins-ci.org/display/JENKINS/Phing+Plugin">Phing Jenkins Plugin</A>

<A HREF="http://www.teamst.org/">TestLink</A>

<A HREF="https://wiki.jenkins-ci.org/display/JENKINS/TestLink+Plugin">Testlink Jenkins Plugin</A>

<A HREF="https://wiki.jenkins-ci.org/display/JENKINS/Clover+PHP+Plugin">Clover Jenkins Plugin</A>

<A HREF="http://seleniumhq.org/">Selenium</A>

<A HREF="https://wiki.jenkins-ci.org/display/JENKINS/Selenium+Plugin">Selenium Jenkins Plugin</A>

</BODY></HTML>

Documentation

Testing strategy