Skip to content
This repository has been archived by the owner on Dec 5, 2019. It is now read-only.

An OpenShift cartridge to install the UnifiedPush Server, running on WildFly

License

Notifications You must be signed in to change notification settings

aerogear-attic/openshift-origin-cartridge-aerogear-push

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenShift AeroGear Push Server Cartridge

DEPRECATED: This is based on OpenShift 2, 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 WildFly 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.

Installation

The AeroGear Push Server cartridge requires a medium sized gear and defaults to using MySQL for its database. When creating your application, you'll also want to add the MySQL cartridge:

rhc create-app --gear-size medium --no-git <APP> https://cartreflect-claytondev.rhcloud.com/reflect?github=aerogear/openshift-origin-cartridge-aerogear-push

Getting started with the AeroGear UnifiedPush Server

Administration Console

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.

Login

Temporarily, there is an "admin:123" user. On first login, you will need to change the password.

Template Repository Layout

.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

Environment Variables

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
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.

Markers

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)

Documentation

For more details about the current release, please consult our documentation.

Development

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

Questions?

Join our user mailing list for any questions or help! We really hope you enjoy app development with AeroGear!

Found a bug?

If you found a bug please create a ticket for us on Jira with some steps to reproduce it.