Port-an-existing-app-to-OOD.md

 * Rails 4.1.15+
 * Use rubygems.org gems when possible
-* Dataroot changes
\ No newline at end of file
+* Dataroot changes
+
+### `Gemfile`
+
+Update Rails
+
+```diff
+-gem 'rails', '4.0.0'
++gem 'rails', '4.1.16'
+```
+
+Update `sass-rails`
+
+```diff
+-gem 'sass-rails', '4.0.2'
++gem 'sass-rails', '5.0.3'
+```
+
+Update `bootstrap-sass`
+
+```diff
+-gem 'bootstrap-sass', '3.3.1.0'
++gem 'bootstrap-sass', '3.3.5.0'
+```
+
+Update OSC gems
+
+```diff
+-gem 'osc-machete', '~> 1.0.0', :git => 'git@github.com:OSC/osc-machete.git', :tag => 'v1.0.1'
++gem 'osc-machete', '~> 1.2.0', :git => 'git@github.com:OSC/osc-machete.git', :tag => 'v1.2.0'
+-gem 'osc_machete_rails', '~> 1.0.0', :git => 'git@github.com:OSC/osc_machete_rails.git', :tag => 'v1.0.1'
++gem 'osc_machete_rails', '~> 1.2.2', :git => 'git@github.com:OSC/osc_machete_rails.git', :tag => 'v1.2.2'
+-gem 'osc-vnc', '~> 1.0.0', :git => 'git@github.com:OSC/osc-vnc.git', :tag => 'v1.0.8'
++gem 'osc-vnc', '~> 1.1.2', :git => 'git@github.com:OSC/osc-vnc.git', :tag => 'v1.1.2'
+```
+
+Add `ood_appkit`, `pbs`, and `awesim_branding` gems
+
+```diff
++gem 'ood_appkit', '~> 0.3.0', :git => 'git@github.com:OSC/ood_appkit.git', :tag => 'v0.3.0'
++gem 'pbs', '~> 2.0.2', :git => 'git@github.com:OSC/pbs-ruby.git', :tag => 'v2.0.2'
++gem 'awesim_branding', :git => 'git@github.com:AweSim-OSC/awesim_branding.git'
+```
+
+Remove `awesim_rails` and `awesim_rails_logging` gems
+
+```diff  
+-gem 'awesim_rails', '~> 1.0.0', :git => 'git@github.com:AweSim-OSC/awesim_rails.git', :tag => 'v1.0.0'
+-gem 'awesim_rails_logging', '~> 1.0.0', :git => 'git@github.com:AweSim-OSC/awesim_rails_logging.git', :tag => 'v1.0.0'
+```
+
+Find all references to `AwesimRails` in the app code and modify to `OodAppkit`
+
+Examples:
+
+```diff
+-      outdir: File.join(AwesimRails.dataroot, "vnc", "paraview"),
++      outdir: File.join(OodAppkit.dataroot, "vnc", "paraview"),
+
+-Paperclip::Attachment.default_options[:path] = "#{AwesimRails.dataroot}/uploads/:class/:id/:created_at/:attachment/:filename"
++Paperclip::Attachment.default_options[:path] = "#{OodAppkit.dataroot}/uploads/:class/:id/:created_at/:attachment/:filename"
+```
+
+Run Bundler
+
+```
+$ bin/bundle install --path=vendor/bundle
+```
+
+## Test Changes
+
+Test to make sure everything's working properly.
+