DEPRECATED: This is based on OpenShift 2 and JBoss AS7, and is no longer supported. Users are asked to check out the AeroGear community template for Openshift 3: https://github.com/aerogear/aerogear-unifiedpush-server/tree/master/openshift
Provides the AeroGear UnifiedPush Server running on top of JBoss Application Server on OpenShift and embeds the AeroGear SimplePush Server within JBoss Application Server on OpenShift.
| Project Info | |
|---|---|
| License: | Apache License, Version 2.0 |
| Build: | Openshift |
| Documentation: | https://aerogear.org/push/ |
| Issue tracker: | https://issues.jboss.org/browse/AGPUSH |
| Mailing lists: | aerogear-users (subscribe) |
| aerogear-dev (subscribe) |
The AeroGear UnifiedPush Server is a server that allows sending push notifications to different (mobile) platforms. The initial version of the server supports Apple’s APNs, Google Cloud Messaging and Mozilla’s SimplePush.
The AeroGear SimplePush Server is a Java server side implementation of Mozilla's SimplePush Protocol that describes a JavaScript API and a protocol which allows backend/application developers to send notification messages to their web applications.
The AeroGear Push Server cartridge defaults to using MySQL. When creating your application, you'll also want to add the MySQL cartridge:
rhc app create --no-git <APP> https://cartreflect-claytondev.rhcloud.com/reflect?github=aerogear/openshift-origin-cartridge-aerogear-push-jboss7
Once the server is running access it via https://{APP}-{NAMESPACE}.rhcloud.com/ag-push. Check the Administration console user guide for more information on using the console.
Temporarily, there is an "admin:123" user. On first login, you will need to change the password.
For secured connections, client applications should connect to the AeroGear SimplePush Server via https://{APP}-{NAMESPACE}.rhcloud.com:8443/simplepush.
For unsecured connections, client applications can connect to the AeroGear SimplePush Server via http://{APP}-{NAMESPACE}.rhcloud.com:8000/simplepush.
NOTE: It is recommended that you always use secured connections.
Currently, if your AeroGear Push Server application is idled by OpenShift, attempts to establish a WebSocket connection to the AeroGear SimplePush Server will not wake up your idled application. This is a known issue (see AEROGEAR-1296) and will be fixed in a future release of OpenShift Online. Note that requests to your application on port 80 (i.e., http://{APP}-{NAMESPACE}.rhcloud.com) will wake up your idled application.
.openshift/ Location for OpenShift specific files
action_hooks/ See the Action Hooks documentation [1]
markers/ See the Markers section [2]
[1] Action Hooks documentation [2] Markers
The aerogear-push cartridge provides several environment variables to reference for ease
of use:
OPENSHIFT_AEROGEAR_PUSH_IP The IP address used to bind JBossAS
OPENSHIFT_AEROGEAR_PUSH_HTTP_PORT The JBossAS listening port
OPENSHIFT_AEROGEAR_PUSH_TOKEN_KEY The token key for the SimplePush Server
OPENSHIFT_AEROGEAR_PUSH_CLUSTER_PORT
OPENSHIFT_AEROGEAR_PUSH_MESSAGING_PORT
OPENSHIFT_AEROGEAR_PUSH_MESSAGING_THROUGHPUT_PORT
OPENSHIFT_AEROGEAR_PUSH_REMOTING_PORT
JAVA_OPTS_EXT Appended to JAVA_OPTS prior to invoking the Java VM
For more information about environment variables, consult the OpenShift Application Author Guide.
Adding marker files to .openshift/markers will have the following effects:
enable_jpda Will enable the JPDA socket based transport on the java virtual
machine running the JBoss AS 7 application server. This enables
you to remotely debug code running inside the JBoss AS 7
application server.
java7 Will run JBossAS with Java7 if present. If no marker is present
then the baseline Java version will be used (currently Java6)
For more details about the current release, please consult our documentation.
If you would like to help develop AeroGear you can join our developer's mailing list, join #aerogear on Freenode, or shout at us on Twitter @aerogears.
Also takes some time and skim the contributor guide
Join our user mailing list for any questions or help! We really hope you enjoy app development with AeroGear!
If you found a bug please create a ticket for us on Jira with some steps to reproduce it.