Troubleshoot your installation
This document outlines several problems that you may experience with your Ruby installation.
Ruby on Rails® web server port
Ruby on Rails uses its own web server, which must run on an alternate port. This causes an issue if you run a firewall on your system.
Ensure that you have opened each Ruby application's port in your firewall. We recommend that you only open the range of ports that are necessary to access each application (for example, if you run six Ruby applications, open ports
12006 on the firewall).
Unavailable RubyGems repository
Occasionally, the RubyGems repository is unavailable. If the RubyGems repository is unavailable during the installation process, run the
/usr/local/cpanel/scripts/installruby script again.
For more information, read the Ruby documentation.
To troubleshoot Mongrel-specific errors, review the
- If the errors indicate uninstalled gems, install them with the
gem install name command, where
name represents the gem name.
- If the errors indicate the wrong version of gems, run the
gem uninstall command, and then reinstall the correct gem version.
You can also restart the Mongrel server manually to resolve other issues. To do this, run the following command:
mongrel_rails start -p -d -e production -P log/mongrel.pid
Run this command from the Ruby on Rails application's base directory as the user who owns the Ruby application.
If you encounter an unidentified problem, you can perform the following actions to troubleshoot the issue: