Zilla-Push Read Me

Zilla-Push — что это такое

Zilla-Push – это система для отправки уведомлений или сообщений на различные платформы и устройства. В настоящее время поддерживаются две основные платформы: iOS и Android. Для устройств iOS используется собственная система Apple Push Notification Service (APNS), а для Android – Openfire, открытая система. Система Zilla-Push позволяет выполнять такие функции, как регистрация устройств, отправка сообщений, адаптация каналов, обратная связь о состоянии отправки и сбор статистики.

Текущее состояние

Проект всё ещё находится в стадии разработки и пока не выпущена стабильная версия. Текущая версия разработки: 1.0.0-SNAPSHOT.

Используемые внешние сервисы

В Zilla-Push используются следующие серверы:

• MongoDB 2.2.3;
• Redis 2.6.9;
• Openfire 3.8.2.

Как запустить

Установка среды компиляции

• JDK1.6+;
• Maven3.0.3+.

Установка серверной среды

Если у вас уже есть указанная серверная среда, этот шаг можно пропустить.

Установка MongoDB

Скачайте программу MongoDB версии 2.2.3 с официального сайта MongoDB. http://www.mongodb.org/downloads Для подробной информации об установке обратитесь к документации MongoDB: http://docs.mongodb.org/manual/installation/

Установка Redis

Скачайте Redis версии 2.6.9 с официального сайта Redis. http://www.redis.io/download Для подробной информации об установке обратитесь к инструкциям на странице загрузки Redis.

Установка Openfire

Скачайте Openfire версии 3.8.2 с официального сайта Openfire. http://www.igniterealtime.org/downloads/index.jsp#openfire Установка Openfire проста, достаточно распаковать архив. Openfire предоставляет мастер установки, который поможет вам выполнить установку и настройку.

Запуск скрипта

Перед запуском скрипта необходимо изменить конфигурацию MongoDB, Redis и Openfire в проекте push-server.

• Конфигурация MongoDB находится по пути: push-server\src\main\resources\META-INF\db\data-mongodb.properties.
• Конфигурация Redis находится по пути: push-server\src\main\resources\META-INF\db\data-redis.properties.
• Конфигурация Openfire находится по пути: push-server\src\main\resources\META-INF\channel\channel.properties. После настройки запустите скрипт quick-start.bat (для Windows) или quick-start (для Linux) в каталоге zilla-push. Скрипт скомпилирует, упакует и установит модули проекта в локальный репозиторий, а затем запустит сервис.

После запуска сервиса перейдите по адресу http://localhost:8080/push-console в браузере.

Проверка работы

На данный момент нет клиентских программ для конечных устройств, но вы можете использовать программу push-test для имитации проверки (только для канала Openfire).

1. На главной странице «Конфигурационное управление» в push-console (web-интерфейс, ws-клиент) добавьте имя пользователя и пароль для входа на сервер Openfire. Этот пользователь должен быть создан на сервере Openfire.
2. Создайте пользователя Openfire с помощью программы push-test. java -jar push-test-1.0.0-SNAPSHOT.jar of_usereg config.properties 100 1 Эта команда создаст 100 пользователей на сервере Openfire с именем «newuser» и индексом от 1 до 100, а также с паролем «password» и соответствующим индексом. Файл config.properties необходим для работы программы push-test, его можно получить из проекта push-test.
3. Запустите имитацию конечного устройства. java -jar -Xms512m -Xmx1024m -Xss160k push-test-1.0.0-SNAPSHOT.jar of_push config.properties Эта команда имитирует 100 конечных устройств (настраивается в файле config.properties), которые регистрируются в системе отправки и подключаются к серверу Openfire.
4. Отправьте сообщение. Вы можете использовать страницу отправки в push-console или программу push-test для отправки сообщения. При использовании программы push-test выполните следующую команду: java -jar push-test-1.0.0-SNAPSHOT.jar push config.properties
5. Проверьте получение сообщения. Когда сообщение отправлено, вы увидите уведомление о получении сообщения на консоли или в имитационном устройстве. Вы можете проверить статус каждой отправки на странице консоли. После завершения отправки всех сообщений введите «P» на имитационном устройстве для запроса статуса доставки и подтверждения. Это вызовет вызов сервера OpenFire.

Будущее Zilla-Push

Zilla-Push является растущим открытым проектом, у которого нет прошлого, только будущее. Мы надеемся привлечь больше разработчиков с открытым исходным кодом, чтобы вместе развивать проект и сделать его более мощным.