Installation

Installation

Prerequisites:

• A Web browser (Chrome, Firefox, IE, or Safari)
• A Java runtime
  • You can verify that you have Java by opening a command prompt and typing java -version.
  • Download and install Java if you do not have it
    • gwen-web v2.x will require Java 8
    • gwen-web v1.x will require Java 7+

To install the Gwen Web engine, follow the instructions in one of the following methods:

• Download a Gwen Workspace (recommended)
• Install it Manually
• Integrate it with Maven

Installing a Binary Release

Download a Gwen Workspace

This is the recommended way to install Gwen

A downloadable Gwen Workspace will self install and configure Gwen to execute consistently on any user workstation or build server. This method is ideal for web automation teams wanting to share their work with each other in Git and who need an easy way to execute their Gwen suite on any machine and target different environments.

1. Download the latest gwen-workspace.zip
2. Extract the zip file into a directory
   • If you are on a Unix platform, open a command prompt and execute the following command inside the unpacked gwen-web-[version] folder to make the scripts executable:
     • chmod u+x gwen*
3. Start using Gwen

OR..

Install it manually yourself

Perform the following to manually download and install the latest binary build:

1. Download the gwen-web zip file from the latest release page
2. Extract the zip to a desired location on your local drive. This will create a gwen-web-[version] folder in your unpacked location
   • If you are on a Unix platform, open a command prompt and execute the following command inside the unpacked gwen-web-[version] folder to make the scripts executable:
     • chmod u+x {,bin/}gwen*
3. Configure your target browser as described in runtime settings
4. Start using Gwen

Automatic Install through Maven

If you you would like to integrate Gwen with Maven, see:

• Integrating Gwen with Maven