You’ve taken the plunge and installed Ruby on your cPanel system using our \/scripts\/installruby command. Now, you are preparing to run Rails applications to step into the Web 2.0 world. This guide will cover some of the common issues that might prevent your application from working.<\/p>\n
Latest cPanel Versions<\/strong> If you have newer versions than the above and installed them manually rather than using our script installer, the issue is likely being caused by a conflict with the version installed and our interface. We do not currently support Rails 3.0.0 due to the differences in how it generates applications and how mongrel does not work with that version of Rails.<\/p>\n Newer versions of Ruby do not work with our gem installer, so if Ruby was manually updated by removing the yum exclusion line in \/etc\/yum.conf, then that version of Ruby would need to be uninstalled and the compatible versions installed using our script.<\/p>\n Reinstall Ruby<\/strong> By moving the folders, you can a) revert to your prior installation if needed, and b) wipe all existing traces of your Ruby, Rails, Ruby Gem and Mongrel installation. At that point, issuing this command will then install a fresh copy of those components:<\/p>\n Please note that we can only assist when using compatible, installed versions that our script provides. If you have any issues with reinstalling ruby or any related services, we are happy to help. You are welcome to open a support ticket using WHM > Support Center > Contact cPanel for assistance with getting the right versions installed onto your server.<\/p>\n Common Issue with Applications Not Working<\/strong> To check the rails version, you would run in root SSH the following command:<\/p>\n To downgrade to Rails 2.3.8, you would use the following steps:<\/p>\n 2. Mongrel is not running Replace username<\/strong> with the actual username. Here is an example on my own machine for this command:<\/p>\n If you do not see any processes running for that user for mongrel, then mongrel is not running. You would want to check the errors in the logs mentioned next to see what is happening.<\/p>\n 3. Check the logs In the mongrel log, if the issue is a missing gem, it will normally look like the following entry:<\/p>\n In this instance, you can simply install the needed gem<\/p>\n For the above, it would be missing mysql, so you would run:<\/p>\n 4. Application is getting killed or stopping Additionally, if you have prm (process resource monitor) being used, check it is not killing the process.<\/p>\n 5. Port is not working Gem specific tips<\/strong> Use the following command:<\/p>\n or<\/p>\n You can see a list of all remote gems (those you can install) using this command:<\/p>\n 2. Install Gem specific version Rails is frequently installed locally for other versions using this method, since some applications require a different version of Rails than the global Rails version. You can see what version of Rails might be required by an application by using this command:<\/p>\n Here username<\/strong> is the cPanel username and appname<\/strong> is the application name. On my machine, here is an example:<\/p>\n To install that older Rails version, you would then use inside the application’s folder:<\/p>\n 3. Gem mkmf.log location So, can also check log file:<\/p>\n You can then check the version we install:<\/p>\n In this instance, to install the gem, you would need to configure ImageMagick from source to get the higher version required:<\/p>\n 4. Gem error for ri and RDoc documentation For example, you might see the following on installing mysql gem:<\/p>\n What matters here are these lines:<\/p>\n This means the gem did successfully install. Documentation, while important, doesn’t impact a gem functioning.<\/p>\n 5. Gem won’t install on system due to stdio.h failure Check \/usr\/bin\/ld and \/usr\/bin\/gcc for file permissions. They both must be 755 for gems to install.<\/p>\n If instead the user is unable to install a gem, check if they have compiler access:<\/p>\n WHM >> Security Center >> Compiler Access<\/p>\n If they do not, they cannot compile some gems. The user can either enable compiler access or install the gem using WHM or root SSH.<\/p>\n Mongrel Specific Tips<\/strong> In the above, please replace username<\/strong> with the cPanel username, appname<\/strong> with the application folder name, pid#<\/strong> with the PID number for the mongrel process, and port#<\/strong> with the port number that the application is using (again, you could either have seen this in the ps aux for the mongrel process before killing it or in cPanel > Ruby on Rails area by hovering over the URL link for the application). When you restart the application without mongrel, you will then get errors mongrel won’t provide such as this example:<\/p>\n This indicated that Rails 2.3.5 is required, so you would install it onto the account itself:<\/p>\n Then it should start via command line:<\/p>\n You must be in the user’s application folder to run the “ruby script\/server -p port# -d” command.<\/p>\n Of note, if you use this command rather than running it via mongrel process, then you will see errors in a browser once the application starts up if there are still coding issues. Mongrel will hide the errors and put them into the \/home\/username\/rails_apps\/appname\/log\/mongrel.log file. Instead, under mongrel, you’ll see this in a browser:<\/p>\n Finally, after getting the application working, you can then kill the process started for that port and start the application using cPanel > Ruby on Rails area to get the normal mongrel process running. The mongrel process could also be started in command line using this syntax:<\/p>\n Change port# to the port number for the user. Change production to development if the user is under development environment instead.<\/p>\n Important Folder Locations<\/strong> Of note, the older cPanel Rails applications were installed to \/home\/username\/etc\/rails_apps\/appname instead. If you cannot find the Rails application at the current path, check in \/home\/username\/etc instead.<\/p>\n Enjoy!<\/p>\n – Posted by Tristan James Wallace<\/p>\n","protected":false},"excerpt":{"rendered":" You’ve taken the plunge and installed Ruby on your cPanel system using our \/scripts\/installruby command. Now, you are preparing to run Rails applications to step into the Web 2.0 world. This guide will cover some of the common issues that might prevent your application from working.<\/p>\n","protected":false},"author":77,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[49],"tags":[],"class_list":["post-35","post","type-post","status-publish","format-standard","hentry","category-products"],"acf":[],"yoast_head":"\n
\nFor all issues reported, first check the ruby version, rails version, ruby gem version and mongrel version. The current versions that we install are the following:<\/p>\n# ruby -v\nruby 1.8.7 (2009-06-08 patchlevel 173) [i686-linux]\n# rails -v\nRails 2.3.8\n# gem -v\n1.3.7\n# gem list mongrel\n*** LOCAL GEMS ***\nmongrel (1.1.5)<\/pre>\n
\nAny time you are going to reinstall Ruby (to obtain the current version we use for Ruby, Rails, Ruby Gem and Mongrel), please do the following steps:<\/p>\n# mv \/usr\/lib\/ruby \/usr\/lib\/ruby.bak\n# mv \/usr\/local\/lib\/ruby \/usr\/local\/lib\/ruby.bak\n# mv \/usr\/bin\/ruby \/usr\/bin\/ruby.bak\n# mv \/usr\/local\/bin\/ruby \/usr\/local\/bin\/ruby.bak\n# mv \/usr\/bin\/rails \/usr\/bin\/rails.bak\n# mv \/usr\/local\/bin\/rails \/usr\/local\/bin\/rails.bak\n# mv \/usr\/bin\/gem \/usr\/bin\/gem.bak\n# mv \/usr\/local\/bin\/gem \/usr\/local\/bin\/gem.bak<\/pre>\n
# \/scripts\/installruby<\/pre>\n
\n1. Check the Rails version is 2.3.8 or lower
\nIf you are running a version of Rails higher than 2.3.8 such as Rails 3.0.0, Rails applications will not be generated properly in the cPanel interface. This will cause the application to not start. The resolution is to downgrade Rails to a version compatible with cPanel.<\/p>\n# rails -v<\/pre>\n
# gem uninstall rails\n# gem uninstall actionmailer\n# gem uninstall activemodel\n# gem uninstall actionpack\n# gem uninstall activerecord\n# gem uninstall activeresource\n# gem uninstall activesupport\n# gem uninstall railties\n# gem install rails -v=2.3.8<\/pre>\n
\nIf mongrel is not running for the application, then the site will not load. This can be determined by simply running a ps aux for the user’s name for mongrel:<\/p>\n# ps aux | grep mongrel | grep username<\/pre>\n
# ps aux | grep mongrel | grep admin\nadmin 19279 0.0 2.3 26312 23264 ? S Dec02 0:03 \/usr\/bin\/ruby \/usr\/bin\/mongrel_rail\nstart -p 12004 -d -e development -P log\/mongrel.pid\nadmin 24185 0.0 3.0 34272 30348 ? S Dec02 0:03 \/usr\/bin\/ruby \/usr\/bin\/mongrel_rails\nstart -p 12003 -d -e development -P log\/mongrel.pid<\/pre>\n
\nThe log files will be at \/home\/username\/rails_apps\/appname\/log\/ location where username<\/strong> is the cPanel username and appname<\/strong> is the name of the application. The main logs to check are mongrel.log and either development.log or production.log depending on which environment type is being used for the application.<\/p>\n\u00a0 Status: 500 Internal Server Error\n\u00a0 no such file to load -- mysql<\/pre>\n
# gem install gemname<\/pre>\n
# gem install mysql<\/pre>\n
\nIf you are running a firewall such as CSF, disable LFD and CSF on the system temporarily in WHM > Plugins > ConfigServer Security & Firewall > Firewall disable<\/p>\n
\nAgain, if you are running a firewall, check the port has been whitelisted in the firewall. You can see which port is being used by the application in cPanel > Ruby on Rails > Rails Server URL field (either hovering over it or clicking on it will show the port listed for the application). You can always disable the firewall or stop it temporarily to see if the firewall is the cause for the port not working.<\/p>\n
\n1. To check which gems are installed locally<\/p>\n# gem list<\/pre>\n
# gem list --local<\/pre>\n
# gem list --remote<\/pre>\n
\nOf note, you can install any gem specific version by using that -v=# tag so long as the version is in the gem repository. Let’s say you want to install sqlite3-ruby version 1.2.5, you would run:<\/p>\n# gem install sqlite3-ruby -v=1.2.5<\/pre>\n
# grep -i rails_version \/home\/username\/rails_apps\/appname\/config\/environment.rb<\/pre>\n
# grep -i rails_gem \/home\/admin\/rails_apps\/library\/config\/environment.rb\nRAILS_GEM_VERSION = '2.3.4' unless defined? RAILS_GEM_VERSION<\/pre>\n
# cd \/home\/admin\/rails_apps\/library\n# gem install rails -v=2.3.4<\/pre>\n
\nWhen a gem will not install, it will produce a mkmf.log file and that entry will appear in the gem install failure message. For example, RMagick gem failing:<\/p>\n# gem install rmagick\nBuilding native extensions.\u00a0 This could take a while...\nERROR:\u00a0 Error installing rmagick:\n\u00a0\u00a0\u00a0 ERROR: Failed to build gem native extension.\n\/usr\/bin\/ruby extconf.rb\nchecking for Ruby version >= 1.8.5... yes\nchecking for gcc... yes\nchecking for Magick-config... yes\nchecking for ImageMagick version >= 6.4.9... no\nCan't install RMagick 2.13.1. You must have ImageMagick 6.4.9 or later.\n*** extconf.rb failed ***\nCould not create Makefile due to some reason, probably lack of\nnecessary libraries and\/or headers.\u00a0 Check the mkmf.log file for more\ndetails.\u00a0 You may need configuration options.\nProvided configuration options:\n\u00a0\u00a0\u00a0 --with-opt-dir\n\u00a0\u00a0\u00a0 --without-opt-dir\n\u00a0\u00a0\u00a0 --with-opt-include\n\u00a0\u00a0\u00a0 --without-opt-include=${opt-dir}\/include\n\u00a0\u00a0\u00a0 --with-opt-lib\n\u00a0\u00a0\u00a0 --without-opt-lib=${opt-dir}\/lib\n\u00a0\u00a0\u00a0 --with-make-prog\n\u00a0\u00a0\u00a0 --without-make-prog\n\u00a0\u00a0\u00a0 --srcdir=.\n\u00a0\u00a0\u00a0 --curdir\n\u00a0\u00a0\u00a0 --ruby=\/usr\/bin\/ruby\nGem files will remain installed in \/usr\/lib\/ruby\/gems\/1.8\/gems\/rmagick-2.13.1 for inspection.\n\nResults logged to \/usr\/lib\/ruby\/gems\/1.8\/gems\/rmagick-2.13.1\/ext\/RMagick\/gem_make.out<\/pre>\n# cat \/usr\/lib\/ruby\/gems\/1.8\/gems\/rmagick-2.13.1\/ext\/RMagick\/mkmf.log\nchecking for Ruby version >= 1.8.5... -------------------- yes\n--------------------\nfind_executable: checking for gcc... -------------------- yes\n--------------------\nfind_executable: checking for Magick-config... -------------------- yes\n--------------------\nchecking for ImageMagick version >= 6.4.9... -------------------- no\n--------------------\nCan't install RMagick 2.13.1. You must have ImageMagick 6.4.9 or later.\nSystem needs ImageMagick 6.4.9 or later.<\/pre>\n
# convert --version\nVersion: ImageMagick 6.4.8 2010-10-14 Q16 http:\/\/www.imagemagick.org\nCopyright: Copyright (C) 1999-2009 ImageMagick Studio LLC<\/pre>\n
# cd \/usr\/src\n# wget ftp:\/\/ftp.imagemagick.org\/pub\/ImageMagick\/ImageMagick.tar.gz\n# tar xvfz ImageMagick.tar.gz\n# cd ImageMagick*\n# .\/configure\n# make\n# make install<\/pre>\n
\nThese errors are non-fatal and only pertain to documentation. They are meaningless to the gem working.<\/p>\n# gem install mysql\nBuilding native extensions.\u00a0 This could take a while...\nSuccessfully installed mysql-2.8.1\n1 gem installed\nInstalling ri documentation for mysql-2.8.1...\nNo definition for next_result\nNo definition for field_name\nNo definition for field_table\nNo definition for field_def\n[snip]\nInstalling RDoc documentation for mysql-2.8.1...\nNo definition for next_result\nNo definition for field_name\nNo definition for field_table\nNo definition for field_def\n[snip]<\/pre>\n
Successfully installed mysql-2.8.1\n1 gem installed<\/pre>\n
\nOn trying to install a gem, the following type of error occurs:<\/p>\nERROR: Error installing hpricot:\nERROR: Failed to build gem native extension.\n\/usr\/bin\/ruby extconf.rb\nchecking for stdio.h... no\n*** extconf.rb failed ***<\/pre>\n
\nStopping mongrel process and using regular Rails process for checking errors. You would change to the user’s application directory, ps aux that user’s mongrel process, kill the process, then start up the application manually.<\/p>\n# cd \/home\/username\/rails_apps\/appname\n# ps aux | grep mongrel | grep username\n# kill -9 pid#\n# ruby script\/server -p port# -d<\/pre>\n
# ruby script\/server -p 12008 -d\nMissing the Rails 2.3.5 gem. Please `gem install -v=2.3.5 rails`, update your\nRAILS_GEM_VERSION setting in config\/environment.rb for the Rails version\nyou do have installed, or comment out RAILS_GEM_VERSION to use the latest\nversion installed.<\/pre>\n
# gem install -v=2.3.5 rails<\/pre>\n
# ruby script\/server -p 12008 -d\n=> Booting Mongrel\n=> Rails 2.3.5 application starting on http:\/\/0.0.0.0:12008<\/pre>\n
--Begin error--\nWe're sorry, but something went wrong.\nWe've been notified about this issue and we'll take a look at it shortly.\n--End error--<\/pre>\n
# \/usr\/bin\/ruby -I \/usr\/bin\/mongrel_rails start -p port# -d -e production -P log\/mongrel.pid<\/pre>\n
\n\/home\/username\/rails_apps\/appname\/public ==> Location for the public files, this is what we show in a browser
\n\/home\/username\/rails_apps\/appname\/config ==> This folder contains the database.yml and environment.rb files. The database.yml file configures the database for the rails application (such as mysql or sqlite or postgres, the database name, database username and password). The environment.rb file can set the rails gem version to use.
\n\/home\/username\/rails_apps\/appname\/log ==> This folder contains the log files
\n\/home\/username\/rails_apps\/appname\/app ==> This folder contains the main coding for the application with folders controllers, helpers, models and views inside of it.<\/p>\n