rhoconnect 3.3.6 → 3.4.2

data/doc/extending-rhoconnect-server.txt

@@ -49,7 +49,7 @@ For example, suppose you have a Rhodes app with a Product model. To use a custom
 	  # Uncomment the following line to enable sync with Product.
 	  enable :sync
 
-	  #add model specifc code here
+	  #add model specific code here
 	  property :my_custom_blob_field, :blob, :overwrite 
 	end
 	

data/doc/heroku-addon.txt

@@ -1,51 +1,145 @@
-Heroku Addon
-==========
+RhoConnect is a data synchronization server and client library that keeps enterprise app data current and available on users’ mobile devices.
 
-RhoConnect is now available for those using <a href='http://heroku.com' target='_blank'>Heroku</a> as an addon.  
+The information is stored locally on a user’s device, and is available even when disconnected and offline.
 
+Full documentation on all the capabilities of RhoConnect is in the [RhoConnect Developer Reference](http://docs.rhomobile.com/rhoconnect/introduction).
 
-Adding RhoConnect from Heroku
+
+Overview
+--------
+Combining Rhodes, RhoConnect, and `rhoconnect-rb` will allow you to create a mobile app that can connect to and manage your backend rails app seamlessly.
+
+<p><img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/arc_rhoconnect.png' height='400' width='650'/></p>
+
+Gem
+-----
+To install the latest stable RhoConnect gem, run:
+
+    :::term
+    $ [sudo] gem install rhoconnect
+
+Using from Rails
+------------
+`rhoconnect-rb` is a ruby gem that allows your rails app to interact with RhoConnect.  To use RhoConnect from a rails application you must first install the `rhoconnect-rb` gem.
+
+    :::term
+    $ [sudo] gem install rhoconnect-rb
+
+**NOTE: `rhoconnect-rb` only supports rails 3.  You will not be able to connect your app to RhoConnect with rails < 3.**
+
+Load the `rhoconnect-rb` library
+
+    :::ruby
+    require 'rhoconnect-rb'
+
+**NOTE: If you are using DataMapper, install the `dm-serializer` library and require it in your application.  `rhoconnect-rb` depends on this utility to interact with RhoConnect applications using JSON.**
+
+###Configuration:
+
+You need to define a few configuration variables.  You can define them in an initializer.  Good practice is to create a file called rhoconnect.rb in the initializers directory of your rails app.  Inside of your newly created rhoconnect.rb file you will define the following config block.
+
+    :::ruby
+    Rhoconnectrb.configure do |config|
+      config.app_endpoint = "http://localhost:3000"
+      config.authenticate = lambda { |credentials| return true }
+    end
+
+Inside of this block three variables are defined.
+
+The `app_endpoint` is the location of your rails app.  Defining this variable will cause your rails app to automatically (on startup) set the rails url location in your RhoConnect instance. If you do not define this variable, you will have to manually configure the Backend App URL in the RhoConnect console.
+
+The last variable, `authenticate`, is a lambda and can be used to setup any custom authentication you would like.  The credentials passed will be a hash containing a login and password (`{'login' => login, 'password' => password}`).  You can then write any custom authentication inside of this block.  In the example above authentication is ignored.
+
+You can also alternatively define these variables in `environment.rb` as an environment variables.
+
+    :::ruby
+    ENV['APP_ENDPOINT']   = "http://localhost:3000"
+
+
+**NOTE: environment variables take precedence over config variables**
+
+
+Next you will need to include `Rhoconnectrb::Resource` in the model you want to synchronize with your mobile application:
+
+    :::ruby
+    class Product < ActiveRecord::Base
+      include Rhoconnectrb::Resource
+    end
+
+Or, if you are using DataMapper:
+
+    :::ruby
+    class Product
+      include DataMapper::Resource
+      include Rhoconnectrb::Resource
+    end
+
+###Declaring a partition key
+
+Your model must declare a partition key for `rhoconnect-rb`.  This partition key is used by `rhoconnect-rb` to uniquely identify the model dataset when it is stored in a RhoConnect application. It is typically an attribute on the model or related model.  `rhoconnect-rb` supports two types of partitions:
+
+* app - No unique key will be used, a shared dataset is used for all users.
+* lambda\{some lambda\} - Execute a lambda which returns the unique key string.
+
+For example, the Product model above might have a belongs_to :user relationship.
+
+The partition identifying the username would be declared as:
+
+    :::ruby
+    class Product < ActiveRecord::Base
+      include Rhoconnectrb::Resource
+
+      belongs_to :user
+
+      def partition
+        lambda { self.user.username }
+      end
+    end
+
+
+Deploying to Heroku
 -----------------------
 To use RhoConnect from Heroku, install the RhoConnect add-on:
 
-	:::term
-	$ heroku addons:add rhoconnect
-	
-##Setup
+    :::term
+    $ heroku addons:add rhoconnect
 
-From inside your heroku account, setup the url to your backend service that RhoConnect will connect to.
+###Setup
 
-First, click the addons drop down and select rhoconnect.
+From inside your Heroku account, setup the url to your backend service that RhoConnect will connect to.
+
+First, click the addons drop down and select RhoConnect.
 <p><img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/addon_rhoconnect.png' width="479" height="319"/></p>
 
-You will be redirected to the admin console of your RhoConnect instance where you can set the backend app url. Select the Settings tab, then select Plugin Settings from the left menu.
+You will be redirected to the admin console of your RhoConnect instance where you can set the Backend App url to your backend service.  Select Backend App Url from the right menu.
+<p><img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/console.png' /></p>
 
-<img src="http://rhodocs.s3.amazonaws.com/rhoconnect/plugin-settings-console.png"/>
 
 From here you can enter a url to your backend service.  Enter a url (for example http://myrailsapp.com), and click the add link to save the url.
 
-RhoConnect is now setup with your backend service.  
+
+RhoConnect is now setup with your backend service.
 
 Connecting a simple rhodes app
 -------------------------------
-To view a full tutorial about creating a rhodes application and the features of rhodes see [RhoStudio tutorial](http://docs.rhomobile.com/rhostudio.tutorial).
+To view a full tutorial about creating a rhodes application and the features of rhodes see [Rhodes framework](http://docs.rhomobile.com/rhodes/tutorial).
 
-##Gem installation:
+###Gem installation:
 
-	:::term
-	$ [sudo] gem install rhodes
+    :::term
+    $ gem install rhodes
 
-Next using the rhodes gem you can create a rhodes app.   
+Next using the rhodes gem you can create a rhodes app.
 
-	:::term
+    :::term
     $ rhodes app sample_app url_of_rhoconnect_instance
-	
+
 To get the value for the url_of_rhoconnect_instance argument, go to the RhoConnect console and click on the right Backend App URL link.  From there you can copy the syncserver url.
 
-<p><img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/console.png' width="800" height="280"/></p>  
- 
+<p><img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/console_rhodesurl.png' width="750" height="280"/></p>
 
-##Other Resources
+Other resources
+----
 [RhoConnect Introduction](http://docs.rhomobile.com/rhoconnect/introduction)
 
 [RhoConnect Installation](http://docs.rhomobile.com/rhoconnect/install)
@@ -53,3 +147,5 @@ To get the value for the url_of_rhoconnect_instance argument, go to the RhoConne
 [RhoConnect Tutorial](http://docs.rhomobile.com/rhoconnect/tutorial)
 
 [Using RhoConnect from Rails/Sinatra](http://docs.rhomobile.com/rhoconnect/rails-plugin)
+
+[Webinar Using Rhoconnect with Rhoconnect-rb](http://player.vimeo.com/video/27495682?byline=0&portrait=0&color=de0909)

data/doc/install.txt

@@ -2,81 +2,143 @@
 
 This section discusses how to install the development environment for RhoConnect. For those who have developed a RhoConnect application, and now wish to deploy that RhoConnect application on a server, refer to the instructions for deploying a RhoConnect application, such as [preparing a RhoConnect app for production](/rhoconnect/preparing-production) and [deploying a RhoConnect application](/rhoconnect/deploying).
 
-On Windows and Mac OS, the usual way to install the RhoConnect development environment is to install RhoStudio. 
+## Installing RhoConnect with RhoStudio
 
-On Linux, you install the RhoConnect gem from the command line; you can also do this from Windows or Mac OS.
+The most common way to install RhoConnect on a Windows or Macintosh platform is to install RhoMobile Suite. The RhoMobile Suite installer installs Rho products, such as Rhodes, RhoConnect, RhoElements, and RhoStudio. RhoStudio is an Eclipse installation that facilitates development of native smartphone applications.
 
-## Mac OS
+[Click here for the RhoMobile Suite installation instructions](/rhomobile-install).
 
-If you're running Mac OS, download the latest [Motorola RhoMobile Suite Installer for Macintosh](http://rhomobile.com/rhostudio-mac). This contains [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction) and [Rhodes](/rhodes/introduction).
+NOTE: The rest of this chapter consists of instructions for installing RhoConnect from the command line, without using the RhoMobile Suite installer. You do not need to perform those instructions if you installed using the RhoMobile Suite installer.
 
-Although Mac OS has [Ruby](http://www.ruby-lang.org/en/) installed, the official way to install Ruby for RhoStudio is to install [Ruby Version Manager](https://rvm.io//) and then install Ruby version 1.9.3.
+## Installing RhoConnect from the Command Line
 
-Click on the Motorola RhoMobile Suite Installer for Mac download file to open it. You will get a window similar to this:
+To install RhoConnect on Linux, and to install RhoConnect on Windows or Mac OS using the command line (this does not install RhoStudio), you need to install the Rhodes gem. Download and install:
 
-<img src="http://rhodocs.s3.amazonaws.com/rhodes-devel/rhostudio-mac-install.png" alt="RhoStudioInstaller Mac" />
+1. [Ruby v1.9.3](http://www.ruby-lang.org/en/downloads/).
 
-Run "Install gems on rvm" (this requires that you have installed Ruby Version Manager). A terminal window will open; wait for the gems install process to complete.
+	* On Windows, [RubyInstaller](http://rubyinstaller.org) is a convenient way to install Ruby; you should check "Add Ruby executables to your PATH" and "Associate .rb and .rbw files with this Ruby installation".
 
-Then drag Motorola RhoStudio to the Applications folder.
+	* On Macintosh, Ruby is already installed, but this version is outdated and isn't compatible with RhoStudio: install [Ruby Version Manager](https://rvm.io//) (RVM) and then use RVM to install Ruby version 1.9.3.
 
-**NOTE: Installing Ruby into the System folder is not supported by RhoMobile; the official RhoMobile way to install and use Ruby on the Macintosh is with Ruby Version Manager. If you do not use Ruby Version Manager and instead install Ruby into the System folder, you will need to start and run RhoStudio from the command line using sudo.**
+2. Ruby Web Server - We tested with [thin](http://code.macournoyer.com/thin/), and [passenger](http://www.modrails.com/). WEBrick, the web server that ships with ruby, is known to cause issues with HTTP headers/cookies and is ***not*** recommended.
 
-## Windows
+3. [Redis](http://redis.io/) - RhoConnect includes a simple [rhoconnect task](/rhoconnect/command-line#rhoconnect-cli-rhoconnect-v32) `rhoconnect redis-install` to install redis, covered in the [Rhoconnect CLI section](/rhoconnect/command-line#rhoconnect-cli-rhoconnect-v32). Alternatively, you can [install redis directly](http://redis.io/download).
 
-If you're running Windows, download the latest [Motorola RhoMobile Suite Installer for Windows](http://rhomobile.com/rhostudio-windows) and run it. This installs the [Ruby stack](http://www.ruby-lang.org/en/), [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction), and [Rhodes](/rhodes/introduction).
+4. Install the RhoConnect Gem.
 
-If you are running Windows 64-bit, you need to use 32-bit Java when you run RhoStudio. You can include the 32-bit Java in the PATH, or you can run RhoStudio with a link to 32-bit Java:
+Run this command to install the RhoConnect Gem.
 
-	C:\RhoStudio\eclipse\RhoStudio.exe -vm "<32-bit java path>\bin\javaw.exe"
+	:::term
+	$ gem install rhoconnect
 
-## Java Development Kit (JDK)
+NOTE: If you get any `no such file to load -- something` messages while running the rhoconnect or rhodes commands, this can usually be resolved by putting "sudo" in front of the command, as in `sudo gem install something`.
 
-You need to have the Java Development Kit (JDK) installed for RhoStudio. If you are planning to build for Blackberry or Android, make sure you have JDK version 1.6.0_2 or higher installed; the 32-bit Windows version of the JDK is required for Blackberry tools.
+NOTE: Windows doesn't come with the necessary build tools to install gems ('make', for example). There are various ways to get these tools, but the GnuWin32 project at http://gnuwin32.sourceforge.net/ provides the tools, and can be conveniently installed via the GetGnuWin32 installer at http://sourceforge.net/projects/getgnuwin32/files/. You should follow the GetGnuWin32 instructions carefully.
 
-### Installing the Java Development Kit
+## Setting the Location of the RhoStudio Workspace Directory
 
-The Sun JDK for Windows or Linux is available [here](http://java.sun.com/javase/downloads/index.jsp). For Windows, install the 32-bit version of the JDK; RhoStudio needs the 32-bit version.
+When you start RhoStudio, you can set the location of the workspace directory. The path to the workspace directory should not contain space symbols: if the path has spaces, a RhoConnect application created with RhoStudio will not work properly.
 
-For Mac OS 10.6 and earlier, the JDK is already installed. For Mac OS 10.7, Java is not automatically installed. Download the Java for Mac Installer from [Apple support](http://support.apple.com/kb/DL1421) and install Java.
+## Standalone Ruby Installation and Ruby Version Manager
 
-### Setting the JDK Path
+Do not install Ruby as a standalone if you also use Ruby Version Manager (rvm) to install Ruby. If you need only one version of Ruby, you can install Ruby as a standalone. If you need more than one version of Ruby, you should uninstall standalone Ruby and then install Ruby with Ruby Version Manager. Mixed standalone Ruby and rvm-controlled Ruby installations can conflict and cause runtime issues in Rhodes applications.
 
-On Windows installs for RhoMobile, go to RhoStudio Preferences (Windows -> Preferences) and set the JDK path in the rhobuild.yml file. On Windows 64-bit installations, you must set this path to the 32-bit version of the JDK, such as `C:/Program Files (x86)/Java/jdk<version number>/bin`.
+## Migrating to OS X Mountain Lion from the command line
 
-On Mac OS, the path to the JDK is automatically set once Java is installed.
+If you had a workable RhoConnect environment on Macintosh OS X Lion, then after you upgrade to Mountain Lion, you need to do some extra steps to restore your workable environment.
 
-For Linux and for RhoConnect installs from the command line, set the JDK path in JAVA_HOME and PATH.
+### Getting Xcode and Command Line Tools Installed
 
-## Installing RhoConnect from the Command Line
+You can get Xcode from the Mac App Store. You’ll need at least version 4.4 of Xcode for it to work with OS X Mountain Lion. After the installation, open Xcode in your /Applications folder. Then go to Xcode -> Preferences -> Downloads tab and install the “Command Line Tools.”
 
-To install RhoConnect on Linux, and to install RhoConnect on Windows or Mac OS using the command line (this does not install RhoStudio), you need to install the Rhodes gem. Download and install:
+### Installing Homebrew and GCC
 
-1. [Ruby v1.9.3](http://www.ruby-lang.org/en/downloads/) (On Windows, [RubyInstaller](http://rubyinstaller.org) is a convenient way to install Ruby; you should check "Add Ruby executables to your PATH" and "Associate .rb and .rbw files with this Ruby installation".)
+If you need to install any Ruby that’s older than 1.9.3, such as 1.9.2, 1.8.7 or REE, you’ll need to install GCC 4.2. Apple does not ship the Command Line Tools with gcc-4.2 compiler anymore (you can check by running `which gcc-4.2`), so you need to install it via Homebrew by enabling [homebrew-dupes](https://github.com/Homebrew/homebrew-dupes) repository and installing GCC.
 
-2. Ruby Web Server - We tested with [thin](http://code.macournoyer.com/thin/), and [passenger](http://www.modrails.com/). WEBrick, the web server that ships with ruby, is known to cause issues with HTTP headers/cookies and is ***not*** recommended.
+	:::term
+	$ brew tap homebrew/dupes
+	$ brew install apple-gcc42
 
-3. [Redis](http://redis.io/) - RhoConnect includes a simple [rake task](/rhoconnect/command-line#rake-tasks) `redis:install` to install redis, covered in the [Rake Tasks section](rhoconnect/command-line#rake-tasks). Alternatively, you can [install redis directly](http://redis.io/download).
+Apple has removed X11 support from their operating system, but the X11 package is needed to
+compile 1.8.7 or REE. You can get the X11 package from [XQuartz]( http://xquartz.macosforge.org/landing). By default, it installs in the /opt/X11 folder.
 
-4. Install the RhoConnect Gem. 
+If you had Homebrew already installed, then you need only update it
 
-Run this command to install the RhoConnect Gem.
+	:::term
+	$ brew update
+	$ brew doctor
+
+If the `brew doctor` command complains about the `/usr/local/bin` path, then edit the `/etc/paths` file to move `/usr/local/bin` line to the top of it.
+
+### Updating RVM (Ruby Version Manager) with Ruby 1.9.3
+
+Because the OS X Mountain Lion toolchain is changed, you should use Ruby Version Manager to reinstall existing Ruby 1.9.3.
 
 	:::term
-	$ [sudo] gem install rhoconnect
+	$ rvm get stable
+	$ rvm reinstall 1.9.3
 
-NOTE: If you get any `no such file to load -- something` messages while running the rake tasks or rhodes commands, this can usually be resolved by putting "sudo" in front of the command, as in `sudo gem install something`.
+### Installing legacy rubies
 
-NOTE: Windows doesn't come with the necessary build tools to install gems ('make', for example). There are various ways to get these tools, but the GnuWin32 project at http://gnuwin32.sourceforge.net/ provides the tools, and can be conveniently installed via the GetGnuWin32 installer at http://sourceforge.net/projects/getgnuwin32/files/. You should follow the GetGnuWin32 instructions carefully.
+Run the following commands to install legacy rubies:
 
-**NOTE: Installing RhoStudio as a plugin for Eclipse is currently disabled.**
+	:::term
+	$ export CPPFLAGS=-I/opt/X11/include
+	$ CC=/usr/local/bin/gcc-4.2 rvm reinstall 1.8.7
+	$ CC=/usr/local/bin/gcc-4.2 rvm reinstall ree
 
-RhoSimulator, which comes with RhoStudio for Mac and Windows, does not work with Linux.
+## Upgrading an Existing Application
 
-## Setting the Location of the RhoStudio Workspace Directory
+If you have an existing application, upgrading to the latest version of RhoConnect is simple.
 
-When you start RhoStudio, you can set the location of the workspace directory. The path to the workspace directory should not contain space symbols: if the path has spaces, a RhoConnect application created with RhoStudio will not work properly.
+Open the `Gemfile` of your application and find the rhoconnect line, it should look something like:
 
-## Standalone Ruby Installation and Ruby Version Manager
+	:::ruby
+	gem 'rhoconnect', '3.3.6'
 
-Do not install Ruby as a standalone if you also use Ruby Version Manager (rvm) to install Ruby. If you need only one version of Ruby, you can install Ruby as a standalone. If you need more than one version of Ruby, you should uninstall standalone Ruby and then install Ruby with Ruby Version Manager. Mixed standalone Ruby and rvm-controlled Ruby installations can conflict and cause runtime issues in Rhodes applications.
+Change this to the latest release version, which you can find on [rubygems.org](http://rubygems.org/gems/rhoconnect), for example if it is 3.4.0:
+
+	:::ruby
+	gem 'rhoconnect', '3.4.0'
+
+Run the following command from the root application directory:
+
+	:::term
+	$ bundle install
+
+Now update your application's RhoConnect dependency manifest:
+
+	:::term
+	$ rhoconnect update
+
+## Upgrading previous versions to RhoConnect 3.4+
+
+If you have an existing RhoConnect application using version < 3.4 and want to upgrade it to RhoConnect 3.4+, then
+you need to update the `Gemfile` file to properly use the latest RhoConnect runtime dependencies.
+
+First, follow the instructions described in the [previous section](/rhoconnect/install#upgrading-an-existing-application).
+
+Next, make sure your `Gemfile` looks like the following example, replacing the version as necessary.
+The `rhoconnect update` command will generate a reference `Gemfile.new` which you can use to replace your `Gemfile`:
+
+	:::ruby
+	source 'http://rubygems.org'
+
+	gem 'rhoconnect', '<put correct version here>'
+	gemfile_path = File.join(File.dirname(__FILE__), ".rcgemfile")
+
+	begin
+		eval(IO.read(gemfile_path))
+	rescue Exception => e
+		puts "ERROR: Couldn't read RhoConnect .rcgemfile"
+		puts e.message
+		exit 1
+	end
+
+	# DON'T FORGET to add your application specific gems after this line ...
+	# ...
+
+Finally, run `bundle install` to install any missing dependencies:
+
+	:::term
+	$ bundle install

data/doc/java-plugin.txt

@@ -129,7 +129,7 @@ Now that the rhoconnect-java jar library is included in your Maven local reposit
     	<type>jar</type>
 	</dependency>
 
-### Creating the rhoconnect-java Pluigin Jar File from the rhoconnect-java Repository
+### Creating the rhoconnect-java Plugin Jar File from the rhoconnect-java Repository
 
 Instead of downloading the rhoconnect-java plugin jar file, you can generate it from sources by cloning the `rhoconnect-java` repository:
 
@@ -268,7 +268,7 @@ To help the rhoconnect-java plugin correctly map the model name to the service b
 * The service bean should be auto-wired into the corresponding controller via @Autowired annotation 
 
 Data partitioning in your code should be based on filtering data for unique user (i.e. your user name) or per application (shared dataset for all users).
-For more information about RhoConnect partitions, please refer to the [RhoConnect docs](http://docs.rhomobile.com/rhosync/source-adapters#data-partitioning).
+For more information about RhoConnect partitions, please refer to the [RhoConnect docs](http://docs.rhomobile.com/rhoconnect/source-adapters#data-partitioning).
 
 ## Establishing communication from java backend application to the RhoConnect server
 

data/doc/licensing.txt

@@ -2,7 +2,7 @@ Licensing Your RhoConnect Application
 ===
 
 ## RhoHub License
-If you plan to deploy your RhoConnect application on RhoHub under a premium or enterprise plan, just click on the **"Production app?"** button to enable your paid-level license.
+If you plan to deploy your RhoConnect application on RhoHub under a premium or enterprise plan, just click on the **"Live app ON/OFF"** button on the RhoHub page for that RhoConnect app to enable your paid-level license.
 
 **NOTE: Toggling this button will re-deploy your RhoConnect application to a new redis database.  Make sure you __backup all critical data__ before doing this!**
 

data/doc/plugin-intro.txt

@@ -3,6 +3,8 @@ RhoConnect Plugins Introduction
 
 Rhoconnect Plugins allow you to connect your backend apps seamlessly with rhoconnect. You can write the source (query, create, update and delete operations) into a backend application, and use a RhoConnect plugin in the language that matchs your backend application, such as Java or .NET.
 
+**NOTE: When you create a RhoConnect Plugin to connect your backend apps, you should not create a corresponding RhoConnect source adapter. RhoConnect Plugins do not use RhoConnect source adapters.**
+
 <img src='https://s3.amazonaws.com/rhodocs/rhoconnect-service/intro-plugin.png' alt='image' height='467' width='800' />
 
-**NOTE: Another way to connect particular backend applications (such as for Salesforce or Oracle) is to generate a [RhoConnect source adapter](/rhoconnect/source-adapters) which contains the query, create, update and delete operations.**
+**NOTE: Instead of using RhoConnect Plugins to connect particular backend applications (such as for Salesforce or Oracle), you can generate a [RhoConnect source adapter](/rhoconnect/source-adapters) which contains the query, create, update and delete operations.**

data/doc/preparing-production.txt

@@ -18,17 +18,17 @@ If you don't change the `:secret` setting, RhoConnect automatically warns you ea
 
  	[11:34:56 AM 2011-01-12] ************************************************************
 
-	[11:34:56 AM 2011-01-12] WARNING: Change the session secret in config.ru from <changeme> to something secure.
-	[11:34:56 AM 2011-01-12]   i.e. running `rake rhoconnect:secret` in your app will generate a secret you could use.
+	[11:34:56 AM 2012-01-12] WARNING: Change the session secret in config.ru from <changeme> to something secure.
+	[11:34:56 AM 2012-01-12]   i.e. running `rhoconnect secret` in your app will generate a secret you could use.
 
 	[11:34:56 AM 2011-01-12] ************************************************************
 	
 
-As this warning states, a good way to generate a cryptographically secure secret is by running `rake rhoconnect:secret` in your RhoConnect  application.
+As this warning states, a good way to generate a cryptographically secure secret is by running `rhoconnect secret` in your RhoConnect application.
 
 	:::term
 	$ cd storemanager-server
-	$ rake rhoconnect:secret
+	$ rhoconnect secret
 	040a2355475e9d0fb591ef78d5b9ca61a34cbcfd3f11942b18bc1d91f1ca66c27b2e0386333843a7efa29f40fff03624cd908d0883364ffbfa3208ab23fa2664
 	
 Then plug this secret into your `config.ru`:

data/doc/public/cli.txt

@@ -84,7 +84,7 @@ The server will show that it is running on the console.
 
 ### Start the Application
 
-Open a new console window (since the redis server is running in the previous console window). Then change directories to your rhoconnect applciation and start the application.
+Open a new console window (since the redis server is running in the previous console window). Then change directories to your rhoconnect application and start the application.
 
 	:::term
 	$ cd storeserver
@@ -159,7 +159,7 @@ Here is a complete list of the rake tasks available in a RhoConnect application:
 	rake redis:about                    # About redis
 	rake redis:attach                   # Attach to redis dtach socket
 	rake redis:download                 # Download package
-	rake redis:install                  # Install the latest verison of Redis from Github (requires git, duh)
+	rake redis:install                  # Install the latest version of Redis from Github (requires git, duh)
 	rake redis:restart                  # Restart redis
 	rake redis:start                    # Start redis
 	rake redis:stop                     # Stop redis

data/doc/push-backend-setup.txt

@@ -7,7 +7,7 @@ A RhoConnect push to the client consists of executing a RhoConnect ping call. Th
 
 You can trigger a push remotely using the [RhoConnect API Ping method](/rhoconnect/rest-api). This is useful if you want to fully control the push process from a remote server, such as when you use a RhoConnect plugin to connect your backend application to the RhoConnect server application.
 
-**NOTE: If you want to sync all the sources, use 'all' for the source list (the soure_name parameter) instead of a comma-separated list of the RhoConnect application source names to sync.**
+**NOTE: If you want to sync all the sources, use 'all' for the source list (the source_name parameter) instead of a comma-separated list of the RhoConnect application source names to sync.**
 
 ### Example of Ping for Ruby Backend Application
 
@@ -145,3 +145,13 @@ To queue a ping that is executed asynchronously in a job, you can have PingJob q
 	)
 
 **Note: For this job to execute, you will need to have a resque worker running.  See running [async jobs](/rhoconnect/async-jobs) for more information.**
+
+## Triggering Push Automatically after Updating RhoConnect Data from Plugins
+
+Whenever a backend application modifies RhoConnect data for one of the sources, you can trigger an automatic push notification to be sent to the user's device(s) whose source data was modified. This will force the user's client application to perform a sync on the modified source.
+To enable this, you need to specify the following setting in the `settings.yml` file:
+
+	:::yaml
+	:push_notify: 'true'
+
+**Note: The automatic push notification will be applied only to the user-partitioned sources. App-partitioned sources can not trigger an automatic push notification.**