Table of Contents

Introduction

This document aims to get you starting with (GP). (GP) is a tool integrating executable specifications and automated functional testing into software development processes, thus reducing any ambiguity related to the expression of needs between all actors.

...

Finally, please take advantage of the [Glossary] in which we have explained the most frequently used terms in this document.

What is an executable specification?

Now more than ever, the need of responsiveness and high quality regarding the software product we are delivering becomes urgent. Realization time from the concept to the solution (time to market) must be drastically shorten.

...

The fact is that alternative and more efficient ways exist and they adress both following goals : * reduce waste of time for the company, * deliver more valuable product to costumers.

How is it possible?

The traditional way is often similar to this one:

...

• the time to discover an issue in the product is highly reduced, so the corresponding cost are also saved,
• the risk of misunderstanding specifications is highly reduced since the specifications are directly executed and tested, there is no place for ambiguity,
• the risk of developping unused functionalities are highly reduced because developpement team is working close to the specifications (we say here requirements development driven).

What GreenPepper tools do I need?

What is Confluence?

Managing executable specifications is done thanks to a wiki that every team member should access to. This wiki must be Confluence including the (GP) plug-in (also called (GP) Toolbox). To install Confluence and the (GP) plug-in, please read section [How_to_Install_GreenPepper_for_Confluence]. Use the Confluence wiki to create, edit and execute the (GP) specifications.

Work environment for Java

Writing the specifications in Confluence is not enough. To make them executable you need to implement source code called fixtures. Figure above gives an overview of the different (GP) tools within JAVA work environment.

As a JAVA developer you may use the Eclipse plug-in to interact efficiently the system under test (JAVA source code) and the specifications (Confluence pages)

How to Install GreenPepper?

How to Install GreenPepper for Confluence?

How to Install JAVA?

Installation

Download the latest JDK version here Post-Installation Create an environment variable JAVA_HOME that point to the location of the JDK directory of the installation (ex: JAVA_HOME=C:\Program Files\Java\jdk1.7.0_55)

How to Install Confluence?

...

• Download the latest Standalone version of Confluence here
• Request an evaluation key here (a sign-up is required!) 

Installation

Extract the Confluence archive (atlassian-confluence-5.7.1.zip) to a directory (ex: C:\ ). The archive already include a directory like atlassian-confluence-5.7.1, so the result of the extraction will give us the final directory C:\atlassian-confluence-5.7.1 that will represent the confluence.home throughout this guide. 

...

###########################
# Configuration Directory #
###########################
# specify your directory below (don't forget to remove the '#' in front)
confluence.home=C:/atlassian-confluence-5.7.1/data

Starting Confluence

Start Confluence by launching confluence.home\bin\startup.bat Open your internet browser to http://localhost:8090 The first time you try to access Confluence, you would need to go through a wizard that will help you configuring Confluence.

Installation Type

Please select the Standard Installation option. In case you do not have any regular license you are able install a trial version first.

Enter License step

At this step, please enter the licence key obtained earlier.

...

Otherwise use your Atlassian Account to generate an evaluation key automatically. The key is valid for a period of 30 days.

User Management

At this step, please configure your user management. In case you are already running a JIRA instance you are able to connect your instance at this point in time.

System Administrator

Please note that the username is admin and the password admin.

Setup Completed

Stopping Confluence

Stop Confluence by launching confluence.home\bin\shutdown.bat

How to Install Confluence Plug-in?

Prerequisites

A Running Confluence instance ( see section [How_to_Install_Confluence] ).

Preparation

• Download the latest version of (GP) Confluence Plugin here

The installation of GreenPepper is no different from any other Confluence plug-in installation. Simply upload your confluence-greenpepper-plug-in-xx-complete.jar via your Universal Plugin Manager (see Confluence | Administration | Addons menu)

Basic Configuration

• Log in Confluence using admin as username and admin as password
• Follow the Browse | Confluence Admin menu entering the Administration Console page
• Select Plugins item in the Configuration navigation menu entering the Plugin Manager page
• Select the "GreenPepper Toolbox" among the installed plugin list (shortcut)

...

A detailed documentation of how to install the Confluence plugin can be found here.

How to Install Eclipse plug-in for JAVA?

CAUTION : This document only show common indications to help you get started quickly. The full documentation can be found here. The GreenPepper Eclipse Plugin version use for this guide is 2.2.0.3 and the Eclipse IDE is 3.4.1 (Classic bundle).

Prerequisites

• A Java Virtual Machine (please see section [How_to_Install_JAVA])
• A running Confluence instance (please see section [How_to_Install_Confluence])

Preparation

• Download the Eclipse IDE here
• Downloaded the binaries for GreenPepper Eclipse Plugin on your workstation here.

Installation

Follow the installation instruction on this site here

...