⚠️ This is a legacy testsuite! For latest WildFly HAL tests see https://github.com/hal/testsuite.next

Testsuite

Selenium testsuite for the HAL management console. It uses Drone and Graphene Arquillian extensions.

Prerequisites

• JDK 8 or higher
• Maven 3.0.4 or higher
• Firefox browser (tested on 31.2.0 esr version, will probably not run with far older or younger versions)
• Wildfly (10 or higher) or EAP (7 or higher)
• To setup WildFly/EAP for HAL RBAC tests please follow RBAC.md instructions.

You can download it here: http://wildfly.org/downloads/ or http://www.jboss.org/products/eap/download/

Currently it's necessary to unsecure the management http-interface to be able to run testsuite.

How to unsecure management http-interface using CLI

Standalone

/core-service=management/management-interface=http-interface:undefine-attribute(name=security-realm)
:reload

Domain

/host=master/core-service=management/management-interface=http-interface:undefine-attribute(name=security-realm)
/host=master:reload

How to run tests

mvn test -P{module},{server.mode} -Djboss.dist=${path_to_server_home} -Darq.extension.webdriver.firefox_binary=${path_to_firefox_binary} -Djbeap2168workaround

Required profile (-P) parameters

Can be one of those:

Required jboss.dist parameter

Path to server home folder. Server is expected to be already manually started. In case of standalone mode standalone-full-ha configuration is expected. E.g. -Djboss.dist=/home/user/workspace/wildfly/build/target/wildfly-9.0.0.Alpha2-SNAPSHOT/

Optional arq.extension.webdriver.firefox_binary parameter

Path to Firefox binary file. If not provided system default firefox will be used. E.g. -Darq.extension.webdriver.firefox_binary=/home/user/apps/firefox-31.2.0esr/firefox

Optional take.screenshot.after.each.test parameter

If screenshot should be made after each test. Default is false. E.g. -Dtake.screenshot.after.each.test=true

Optional federation.already.enabled parameter

If PicketLink federation subsystem should be enabled for related tests (otherwise it is assumed the subsystem is already configured and should not be added before tests and removed after them) E.g. -Dfederation.already.enabled=true

Optional propagate.to.model.timeout

Sometimes the model resource change is not yet propagated fast enough even if in GUI the change seems to be already persisted. This parameter means how long to wait for GUI change to be propagated to model in milis. Default value is 500.

Optional jbeap2168workaround

Until https://issues.jboss.org/browse/JBEAP-2168 is fixed you can use this optional parameter to switch on workaround to re-navigate up to 2 times again if navigation seems to be frozen. E.g. -Djbeap2168workaround

Optional elytronSecurity

Run only Elytron related tests.

Optional picketSecurity

Run only PicketBox and PicketLink related tests.

Optional noSecurity

Run tests except of Elytron, PicketBox and Picketlink related ones.

Modules

common

Should contain all common abstraction like UI navigation, test categories, DMR abstraction etc. It's intentioned to be able to used as a dependency of external testsuites as well.

basic

Should contain majority of tests which don't require special configuration.

rbac

Should contain RBAC related tests. To setup WildFly/EAP for HAL RBAC tests please follow RBAC.md instructions.

Tips

• If you want tests to be run on background use vncserver. E.g.

vncserver :10 -geometry 1920x1080

export DISPLAY=:10

Known issues

• No sreenshots on test failure neither test error currently (It seems Arquillian unlike Surefire thinks they passed).
• Multiple aliases for tested IP address (usually 127.0.0.1) in hosts file has to be avoided - see related Selenium issue

Problems?

Ping us on IRC freenode.net#wildfly-management Issue tracking

Have fun.