This project contains the integration tests and functional tests for the Aerogear UnifiedPush Server project.

The only requirement is that you have a running mysql instance with a unifiedpush and keycloak databases. The exact way to setup the database is described in UnifiedPush Server User Guide.

You can use docker to run unifiedpush server database:

docker run --name unifiedpush -p 3306:3306 -e MYSQL_ROOT_PASSWORD=supersecret -d mysql

Note, on Mac OS X, you'll need to use boot2docker ip to get address of the database, for instance

mysql -e 'create database unifiedpush default character set = "UTF8" default collate = "utf8_general_ci";' -h$(boot2docker ip) -P3306 -uroot -psupersecret

Then, you should follow steps from the guide to setup mysql database.

We switched to gradle for running our test suite. To run the test suite now, you just run the following from your commandline:

./gradlew :spacelift:test -Pprofile={selected profile}

Just replace the {selected profile} with a profile you want to run. You can find the list of profiles below. You can also override one of many properties by adding -P{property name}={property value} at the end of the command (without the curly brackets).

The easiest way to get the tests running is the following command:

./gradlew --stacktrace :spacelift:test -Pwildfly8UpsFromSource -Pdatasource=mysql -PrunMigrator=false

In case you've used docker, you need to pass -PdbJdbc_url='jdbc:mysql://$(boot2docker ip):3306/unifiedpush?useUnicode=true&characterEncoding=UTF-8' to the tests as well.

To learn more go to https://github.com/arquillian/arquillian-spacelift-gradle-plugin.

This project consists of three main parts. Tools, tests and Spacelift build script.

Library made for easy access to UnifiedPush Server REST API. The code is located in module :tools:aerogear-ups-rest-api.

This module contains three submodules: :common, :client and :server. The :server module is a WAR which you can deploy along with the UnifiedPush Server and it will provide you with some REST endpoints used to automate UPS testing suite. The :client module can be used to access the REST endpoints of the :server using a Java API. And the :common is basically just code shared between the :client and :server.

You can get a standalone application for client by running following code:

./gradlew --stacktrace :tools:test-extension:client:assemble

Then, you will find a distribution to be executed in tools/test-extension/client/build/distributions folder. Extract any of the archives and look for bin folder for the script to be executed on your platform.

• GET /status: Simply returns HTTP OK (200) response. It can be used to detect when the :server WAR file has been deployed into the container.

• GET /cleanup/applications: Loads all created Push Applications from the UnifiedPush Server datasource and deletes them. This will also delete all variants and installations.

• GET /keycloak: Reconfigures keycloak to allow direct grant access, which basically means authentication using REST api and disables requirement for password change as password cannot be changed using Keycloak's REST API.

• GET /keycloak/realms: Returns list of realms registered. This is used primarily to wait until the keycloak loads configuration from JSON into database.

• POST /datagenerator: Generates testing data in the UPS datasource, based on the DataGeneratorConfig which is required as a json body of the request.

• GET /senderStats: Returns current sender statistics. It represents the message and device tokens were requested to receive when the GCM and APNS proxy is used.

• DELETE /senderStats: Resets the sender statistics.

• POST /javaSenderTest: Sends a message over the UnifiedPush Server using the given parameters. The purpose of this endpoint is to test sending messages when having both WARs in the same container. It takes four form parameters:

  • pushAppId: ID of the application the message will be sent to.
  • secret: Secret for the application.
  • serverUrl: URL where the UnifiedPush Server is located.
  • alert: Text that will be sent as the alert parameter of the message.

• GET /proxy/activate: Activates the GCM and APNS simulators/proxy.

• GET /proxy/deactivate: Deactivates the GCM and APNS simulators/proxy.

There are currently three test projects, integration, admin-ui and performance (although the performance are heavily outdated).

When writing new tests and debugging them it might be painful to run the whole suite over and over again as it takes about 4 minutes to complete the setup and run all the tests. It is however possible to start the container and run the tests yourself.

./spacelift/workspace/wildfly-8.2.0.Final/bin/standalone.sh \
    -b 0.0.0.0 \
    -c standalone-full.xml \
    -Dhttp.proxyHost=127.0.0.1 \
    -Dhttp.proxyPort=16000 \
    -Dhttps.proxyHost=127.0.0.1 \
    -Dhttps.proxyPort=16000 \
    -Djavax.net.ssl.trustStore=$(pwd)/spacelift/workspace/certs/aerogear.truststore \
    -Djavax.net.ssl.trustStorePassword=aerogear \
    -Dcustom.aerogear.apns.push.host=127.0.0.1 \
    -Dcustom.aerogear.apns.push.port=16002 \
    -Dcustom.aerogear.apns.feedback.host=127.0.0.1 \
    -Dcustom.aerogear.apns.feedback.port=16003 \
    -Dcustom.aerogear.apns.keystore.path=$(pwd)/spacelift/workspace/certs/apns_server.jks \
    -Dcustom.aerogear.apns.keystore.password=aerogear \
    -Dcustom.aerogear.apns.keystore.type=JKS \
    -Dgcm.mock.certificate.path=$(pwd)/spacelift/workspace/certs/gcm_mock.crt \
    -Dgcm.mock.certificate.password=$(pwd)/spacelift/workspace/certs/gcm_mock.key \
    -Dgcm.mock.server.port=16010

Run this from the root of the repository to fire up a WildFly container. If you have run the whole testsuite before, it should already have the UnifiedPush Server, Auth Server and Test Extension deployed. Before you run the tests you should open http://localhost:8080/unifiedpush-test-extension-server/proxy/activate to activate the GCM proxy and APNS simulator.

./gradlew :tests:integration:test -PcontainerUri=http://localhost:8080

Running this command will run all the integration tests against a container running at localhost on port 8080. It is also possible to run just one test class by adding --tests org.jboss.aerogear.unifiedpush.test.MessageSendTest or very similarly even a single test method --tests org.jboss.aerogear.unifiedpush.test.MessageSendTest.selectiveSendWithInvalidTokens.

When a new release is staged, you need to open build.gradle and spacelift/build.gradle and update all the versions (this includes aerogear-parent, keycloak etc.) to the versions of the release.

Then it should be as easy as running the command:

./gradlew --stacktrace :spacelift:test -Pwildfly8UpsFromMavenRepository -Pdatasource=mysql -PrunMigrator=false

This should run the integration tests which tests basically most of the internals through REST APIs. Then you should verify that the message delivery really does work. To do that you need to setup an application and create variants for the platforms you want to test. It is recommended to use the hellopush quickstart from https://github.com/jboss-mobile/unified-push-helloworld to test this as it is the easiest way. Once you deploy the hellopush apps onto the devices, just send a message from the UnifiedPush Server UI and verify that it did arrive on the device.

It is also recommended to do a thorough testing for each major and minor version (the versioning is major.minor.point), preferably when the first beta is staged. This testing is manual and consists of going through the UI and trying to click every button, switch every switch and so on.

Runs the integration tests against WildFly 8 instance. It is recommended to use one of these profiles because they need little to no configuration.

You need to provide the WAR files that will be deployed using properties:

The tested UnifiedPush Server will be downloaded and built from GitHub repository.

The tested UnifiedPush Server will be downloaded from Maven repository.

Runs the integration tests against EAP6 instance. You need to provide the download URL for the EAP by changing the property eap6RemoteUrl to an url where it can be downloaded. You should also set property eap6Version to the correct version of EAP you want to use.

You need to provide the WAR files that will be deployed using properties:

The tested UnifiedPush Server will be downloaded and built from GitHub repository.

The tested UnifiedPush Server will be downloaded from Maven repository.

Runs the integration tests against external application server instance. This means you need to provide the jboss home with a configured application server using the property jbossHome.

You need to provide the WAR files that will be deployed using properties:

The tested UnifiedPush Server will be downloaded and built from GitHub repository.

The tested UnifiedPush Server will be downloaded from Maven repository.

Runs the integration tests against an OpenShift gear.

Runs Admin UI functional tests against OpenShift.

You can use this optional property to with this profile: