Cloud Push with the E-mail Notification Provider

Introduction

Next to the traditional Push ICEpush comes with basic Cloud Push support. If a user is registered to a group but is not currently listening for Push notifications, upon a push to that group instead of sending a traditional Push notification ICEpush can send a Cloud Push notification instead. With ICEpush the Cloud Push notification can be send using the E-mail Notification Provider.

Configuration

In order to enable the E-mail Notification Provider an SMTP service is required and the ICEpush application's Web archive needs to be configured correctly.

Server

The ICEpush application's Web archive requires the following configuration in order to enable the E-mail Notification Provider:

  1. The mail.jar library must be added to the /WEB-INF/lib/ folder. This allows the E-mail Notification Provider itself to get registered with ICEpush.
  2. The WEB-INF/web.xml must be conifigured to use the desired SMTP service as follows:
    <!--
        Default: false
    -->
    <context-param>
        <param-name>smtp.debug</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: localhost
    -->
    <context-param>
        <param-name>smtp.host</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: 465 (if using TLS or SSL) or 25
    -->
    <context-param>
        <param-name>smtp.port</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: nobody@localhost.com
    -->
    <context-param>
        <param-name>smtp.from</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: <empty string>
    -->
    <context-param>
        <param-name>smtp.user</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: <empty string>
    -->
    <context-param>
        <param-name>smtp.password</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: NONE (other options are TLS or SSL)
    -->
    <context-param>
        <param-name>smtp.security</param-name>
        <param-value></param-value>
    </context-param>

    <!--
        Default: false
    -->
    <context-param>
        <param-name>smtp.verify-server-certificate</param-name>
        <param-value></param-value>
    </context-param>

Deployment

Once the configured ICEpush application is deployed to the application server and started, the logs can be used to determine if the E-mail Notification Provider is configured correctly to use the SMTP service.