Troubleshooting Common Startup Errors

NOTE: Please feel free to make additions. I’m adding to it as I test SproutCore on both the Mac and Windows.

Installation Errors

ruby -v

You need ruby installed to run SproutCore. So you should be able to type “ruby -v” and see "ruby 1.8.6 " returned on the next line. If you don’t see this you need to install ruby.

• On the Mac, Ruby should already be installed. If not, follow the instructions here and stop before you install Rails.
• On Windows , One Click Ruby Installer is easy to download and install.

sproutcore -v

After you have successfully install sproutcore (see How Do I Get Sproutcore), the easiest test is to just type “sproutcore -v” at the terminal prompt. You should see “sproutcore 0.9.10” or a higher version number. If you see “command not found”, then sproutcore is not installed. You might want to try the installation over again from the start.

Ruby Forge errors

While things may look like a Ruby Forge error, it could also be something else. It is possible that you are having trouble connecting to the Ruby Forge servers. It could be a problem with Ruby Forge (it is a volunteer run site) or somewhere in between. See if you can type in at the terminal “ping rubyforge.com”. Also note that it may take a while to initialize the “gem” setup if you have not used it before.

X-Code Tools installed?

To determine if the X-Code Tools are installed on Mac OS X, enter ‘ls -d /Developer’ in terminal. You should get a response of ‘/Developer’ if it is and ‘ls: /Developerx: No such file or directory’ if its not.

Errors When Using Browser to See Application

Assuming you have SproutCore installed, you now want a quick start to see something on your browser. Start with the Hello World Tutorial For this we assume you’ve created a directory called “sproutcore”. From there you ran the command “sproutcore hello_world”. Now you’ve started the development web server on your machine with the command “sc-server”. However, you get one of these errors:

Unable to Connect

Your browser can not find the web server. First, check your terminal where you typed “sc-server” where you should see

 Welcome to SproutCore
 Not Using Sessions
 Using Mongrel Adapter</pre>

Second, make certain you have port 4020 specified in the URL. It should be http://localhost:4020/hello_world.

No matching entry in sproutcore for /sproutcore/hello_world/index.html
This one made me feel stupid once figured it. The URL should be http://localhost:4020/hello_world and not http://localhost:4020/sproutcore/hello_world  There is no sproutcore in the URL.
No SproutCore Bundle registered at this location

 ~ No SproutCore Bundle registered at this location. - (Merb::ControllerExceptions::NotFound)
/opt/local/lib/ruby/gems/1.8/gems/sproutcore-0.9.13/lib/sproutcore/merb/bundle_controller.rb:50:in `main'
/opt/local/lib/ruby/gems/1.8/gems/merb-core-0.9.3/lib/merb-core/controller/abstract_controller.rb:221:in `send'

I got this one when I created an example project and then started sc-server in the /example directory. Unfortunately I still had the URL for the hello_world application. So I just changed from http://localhost:4020/hello_world to http://localhost:4020/example and got the start page.

This also happens if you point the browser directly to http://localhost:4020.
No images
This is a known issue with Windows through 0.9.11. You should see both a yellow background image (looks like a sticky note). There is also a green sproutit logo too at the bottom of the page. To see the images use gem to upgrade to 0.9.13.
Comments

	
added how to tell if x-code tools are installed, not sure if you wanted something via the command line — gskluzacek
	
updated no images section to reflect the version the issue existed to as well as the version it fixed in — gskluzacek
	
added links to Hello World, How To Get, Ruby for Windows. Removed work in progress and minor changes. — raydaly