JPush - Revision history

imported_>xur17: /* Server */

2011-02-05T18:32:29Z

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

imported_>amigadave: wikify slightly

2010-10-25T07:43:04Z

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

imported_>xur17: /* Client */

2010-10-20T20:20:51Z

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

imported_>xur17: /* Client */

2010-10-20T20:20:23Z

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>

imported_>xur17: /* Client */

2010-10-20T18:14:56Z

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"

imported_>amigadave: wikify slightly

2010-10-18T14:57:42Z

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

imported_>xur17: /* Client */

2010-10-17T15:21:18Z

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

imported_>xur17: /* Install */

2010-10-16T20:23:01Z

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

imported_>xur17 at 20:22, 16 October 2010

2010-10-16T20:22:36Z

← 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

imported_>xur17 at 20:04, 16 October 2010

2010-10-16T20:04:44Z

← 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: