Editing JPush

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
JPush provides a way for information to be pushed to a device or computer. It provides 'hooks' on the server that cause 'actions' to be performed on the device, such as checking for new email.
JPush provides a way for information to be pushed to a device or computer. It provides 'hooks' on the server that cause 'actions' to be performed on the device, such as checking for new email.
-
One common use is to get push email on a [[Nokia N900|N900]] device.
+
One common use is to get push email on a n900 device.
-
==How it Works==
+
===How it Works===
-
 
+
JPush utilizes an existing XMPP (Jabber) connection to communicate with a device.  The client adds the server as a 'buddy' using any existing jabber account on the n900.
-
JPush utilizes an existing XMPP (Jabber) connection to communicate with a device.  The client adds the server as a 'buddy' using any existing jabber account on the N900.
+
==Setup==
==Setup==
-
 
===Pre-Setup===
===Pre-Setup===
-
 
+
*Create jabber account separate from your own (anywhere works, gmail, jabber.org, etc).
-
* Create jabber account separate from your own (anywhere works, gmail, jabber.org, etc).
+
*Add server account to buddy list of client account.
-
* Add server account to buddy list of client account.
+
*Modest must be set to check for new email automatically (just set it to once every 24 hours). This is some odd issue that I ran into.
-
* Modest must be set to check for new email automatically (just set it to once every 24 hours). This is some odd issue that I ran into.
+
*Install the following files as instructed below.
-
* Install the following files as instructed below.
+
===Install===
===Install===
-
 
+
Server: a .deb file is available [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here].
-
*Server: a .deb file is available [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here].
+
Client (n900): a .deb is not available yet. Download the source code from [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here], and install the files in any directory. Make sure the files are executable (chmod +x).
-
*Client (N900): a .deb is not available yet. Download the source code from [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here], and install the files in any directory. Make sure the files are executable (<code>chmod +x</code>).
+
===Configuration===
===Configuration===
-
 
====Server====
====Server====
 +
1. Edit /usr/bin/jpush-server
 +
*edit the config block:
 +
**insert username and password for a new jabber account created above.
 +
**set a secret that you will also put on the client (make this up).
 +
**set notifications (type of commands to be sent to the device). Leave this as the default if you only want email.
-
# Edit <code>/usr/bin/jpush-server</code>
+
2. Setup Email Hook
-
#* edit the config block:
+
*/usr/bin/jpush-emailhook should be called whenever a new email is received.  This sends an update to JPushServer, which notifies the n900.
-
#** insert username and password for a new jabber account created above.
+
*This file receives two arguments -> /usr/bin/jpush-emailhook username updateType
-
#** set a secret that you will also put on the client (make this up).
+
**EX: To receive push email, insert new line into /etc/aliases as: 'part-of-email-before-at-symbol "|/usr/bin/emailhook username email"'
-
#** set notifications (type of commands to be sent to the device). Leave this as the default if you only want email.
+
**Run 'sudo newaliases' to make server update email config above.
-
# Setup Email Hook
+
**Forward all email to part-of-email-before-at-symbol@server.com
-
#* <code>/usr/bin/jpush-emailhook</code> should be called whenever a new email is received.  This sends an update to JPushServer, which notifies the N900.
+
-
#* This file receives two arguments: <code>/usr/bin/jpush-emailhook username updateType</code>
+
-
#** example: To receive push email, insert new line into <code>/etc/aliases</code> as: <pre>part-of-email-before-at-symbol "|/usr/bin/jpush-emailhook username email"</pre>
+
-
#** Run '<code>sudo newaliases</code>' to make server update email config above.
+
-
#** Forward all email to part-of-email-before-at-symbol@server.com
+
-
# Starting
+
-
#* Run jpush-server start
+
-
====Client====
+
3. Starting
 +
*Run jpush-server start
-
# Edit <code>/opt/jpush/jpush.py</code>
+
===Client===
-
#* edit the config block
+
1. Edit /?/?/jpush
-
#** set a secret (use the same value that you set for the server config above).
+
*edit the config block
-
# Optional - Edit <code>/?/?/actions.py</code>
+
**set a secret (use the same value that you set for the server config above).
-
#* Follow instructions in file.
+
*set client account information.  Figure out client account information (run the following command to list all accounts:
 +
 
 +
/usr/bin/dbus-send --type=method_call --print-reply --dest=org.freedesktop.Telepathy.AccountManager /org/freedesktop/Telepathy/AccountManager org.freedesktop.DBus.Properties.Get string:org.freedesktop.Telepathy.AccountManager string:ValidAccounts
 +
 
 +
2. Optional - Edit /?/?/actions.py
 +
* Follow instructions in file.
==Download==
==Download==
-
 
https://garage.maemo.org/projects/jpush/
https://garage.maemo.org/projects/jpush/
-
 
-
[[Category:Software]]
 
-
[[Category:Fremantle]]
 

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)