JPush - Revision history

xur17: /* Server */

xur17 — Sat, 05 Feb 2011 18:32:29 GMT

Server

← Older revision		Revision as of 18:32, 5 February 2011
Line 33:		Line 33:
	#* <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.		#* <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>		#* 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/emailhook username email"</pre>	+	#** 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.		#** Run '<code>sudo newaliases</code>' to make server update email config above.
	#** Forward all email to part-of-email-before-at-symbol@server.com		#** Forward all email to part-of-email-before-at-symbol@server.com

amigadave: wikify slightly

amigadave — Mon, 25 Oct 2010 07:43:04 GMT

wikify slightly

← Older revision		Revision as of 07:43, 25 October 2010
Line 11:		Line 11:
	===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===
Line 25:		Line 25:
	====Server====		====Server====

-	1. Edit <code>/usr/bin/jpush-server</code>	+	# Edit <code>/usr/bin/jpush-server</code>
-	*edit the config block:	+	#* edit the config block:
-	**insert username and password for a new jabber account created above.	+	#** 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 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.	+	#** set notifications (type of commands to be sent to the device). Leave this as the default if you only want email.
-		+	# Setup Email Hook
-	2. Setup Email Hook	+	#* <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.
-	*/usr/bin/jpush-emailhook 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>
-	*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/emailhook username email"</pre>
-	**EX: To receive push email, insert new line into <code>/etc/aliases</code> as: <pre>part-of-email-before-at-symbol "\|/usr/bin/emailhook username email"</pre>	+	#** Run '<code>sudo newaliases</code>' to make server update email config above.
-	**Run '<code>sudo newaliases</code>' to make server update email config above.	+	#** Forward all email to part-of-email-before-at-symbol@server.com
-	**Forward all email to part-of-email-before-at-symbol@server.com	+	# Starting
-		+	#* Run jpush-server start
-	3. Starting	+
-	*Run jpush-server start	+

	====Client====		====Client====

-	1. Edit /opt/jpush/jpush.py	+	# Edit <code>/opt/jpush/jpush.py</code>
-	*edit the config block	+	#* edit the config block
-	**set a secret (use the same value that you set for the server config above).	+	#** set a secret (use the same value that you set for the server config above).
-		+	# Optional - Edit <code>/?/?/actions.py</code>
-	2. Optional - Edit <code>/?/?/actions.py</code>	+	#* Follow instructions in file.
-	* Follow instructions in file.	+

	==Download==		==Download==

xur17: /* Client */

xur17 — Wed, 20 Oct 2010 20:20:51 GMT

Client

← Older revision		Revision as of 20:20, 20 October 2010
Line 43:		Line 43:
	====Client====		====Client====

-	1. Edit /?/?/jpush	+	1. Edit /opt/jpush/jpush.py
	*edit the config block		*edit the config block
	**set a secret (use the same value that you set for the server config above).		**set a secret (use the same value that you set for the server config above).

xur17: /* Client */

xur17 — Wed, 20 Oct 2010 20:20:23 GMT

Client

← Older revision		Revision as of 20:20, 20 October 2010
Line 46:		Line 46:
	*edit the config block		*edit the config block
	**set a secret (use the same value that you set for the server config above).		**set a secret (use the same value that you set for the server config above).
-	*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 \| grep "jabber"

	2. Optional - Edit <code>/?/?/actions.py</code>		2. Optional - Edit <code>/?/?/actions.py</code>

xur17: /* Client */

xur17 — Wed, 20 Oct 2010 18:14:56 GMT

Client

← Older revision		Revision as of 18:14, 20 October 2010
Line 46:		Line 46:
	*edit the config block		*edit the config block
	**set a secret (use the same value that you set for the server config above).		**set a secret (use the same value that you set for the server config above).
-	*set client account information. Figure out client account information (run the following command to list all accounts:	+	*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 \| grep "jabber"		/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 \| grep "jabber"

amigadave: wikify slightly

amigadave — Mon, 18 Oct 2010 14:57:42 GMT

wikify slightly

← Older revision		Revision as of 14:57, 18 October 2010
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 ~~n900~~ device.	+	One common use is to get push email on a [[Nokia N900\|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.
Line 14:		Line 17:

	===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 (chmod +x).

	===Configuration===		===Configuration===
		+
	====Server====		====Server====
-	1. Edit /usr/bin/jpush-server	+
		+	1. Edit <code>/usr/bin/jpush-server</code>
	*edit the config block:		*edit the config block:
	**insert username and password for a new jabber account created above.		**insert username and password for a new jabber account created above.
Line 26:		Line 32:

	2. Setup Email Hook		2. Setup Email Hook
-	*/usr/bin/jpush-emailhook should be called whenever a new email is received. This sends an update to JPushServer, which notifies the ~~n900~~.	+	*/usr/bin/jpush-emailhook should be called whenever a new email is received. This sends an update to JPushServer, which notifies the N900.
-	*This file receives two arguments -> /usr/bin/jpush-emailhook username updateType	+	*This file receives two arguments -> <code>/usr/bin/jpush-emailhook username updateType</code>
-	**EX: To receive push email, insert new line into /etc/aliases as: 'part-of-email-before-at-symbol "\|/usr/bin/emailhook username email"'	+	**EX: To receive push email, insert new line into <code>/etc/aliases</code> as: <pre>part-of-email-before-at-symbol "\|/usr/bin/emailhook username email"</pre>
-	**Run 'sudo newaliases' to make server update email config above.	+	**Run '<code>sudo newaliases</code>' to make server update email config above.
	**Forward all email to part-of-email-before-at-symbol@server.com		**Forward all email to part-of-email-before-at-symbol@server.com

Line 36:		Line 42:

	====Client====		====Client====
		+
	1. Edit /?/?/jpush		1. Edit /?/?/jpush
	*edit the config block		*edit the config block
Line 43:		Line 50:
	/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 \| grep "jabber"		/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 \| grep "jabber"

-	2. Optional - Edit /?/?/actions.py	+	2. Optional - Edit <code>/?/?/actions.py</code>
	* Follow instructions in file.		* Follow instructions in file.

	==Download==		==Download==
		+
	https://garage.maemo.org/projects/jpush/		https://garage.maemo.org/projects/jpush/
		+
		+	[[Category:Software]]
		+	[[Category:Fremantle]]

xur17: /* Client */

xur17 — Sun, 17 Oct 2010 15:21:18 GMT

Client

← Older revision		Revision as of 15:21, 17 October 2010
Line 41:		Line 41:
	*set client account information. Figure out client account information (run the following command to list all accounts:		*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	+	/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 \| grep "jabber"

	2. Optional - Edit /?/?/actions.py		2. Optional - Edit /?/?/actions.py

xur17: /* Install */

xur17 — Sat, 16 Oct 2010 20:23:01 GMT

Install

← Older revision		Revision as of 20:23, 16 October 2010
Line 14:		Line 14:

	===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 (chmod +x).

	===Configuration===		===Configuration===

xur17 at 20:22, 16 October 2010

xur17 — Sat, 16 Oct 2010 20:22:36 GMT

← Older revision		Revision as of 20:22, 16 October 2010
Line 35:		Line 35:
	*Run jpush-server start		*Run jpush-server start

-	===Client===	+	====Client====
	1. Edit /?/?/jpush		1. Edit /?/?/jpush
	*edit the config block		*edit the config block

xur17 at 20:04, 16 October 2010

xur17 — Sat, 16 Oct 2010 20:04:44 GMT

← Older revision		Revision as of 20:04, 16 October 2010
Line 6:		Line 6:
	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.

-	==~~Installation~~==	+	==Setup==
-	1. Create jabber account separate from your own (anywhere works, gmail, jabber.org, etc).	+	===Pre-Setup===
-	~~2. Install the following files as instructed below.~~	+	*Create jabber account separate from your own (anywhere works, gmail, jabber.org, etc).
-	3. Add server account to buddy list of client account.	+	*Add server account to buddy list of client account.
-	4. 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.

-	===Server===	+	===Install===
		+	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).
		+
		+	===Configuration===
		+	====Server====
	1. Edit /usr/bin/jpush-server		1. Edit /usr/bin/jpush-server
	*edit the config block:		*edit the config block: