I’ve been hosting a number of PHP driven sites, including this blog, from a shared hosting service for quite a while now. Shared hosting is fine for personal websites or even small businesses with 4-5 page brochure style websites that do not receive lots of traffic, but they’re not fine if slow performance or intermittent downtime causes you to loose business (or even the respect of your visitors). In such cases I recommend a VPS, because you control who you’re hosting and thus can ensure optimal uptime and performance. I highly recommend Linode as a VPS provider.

I’ve been using the shared hosting for PHP/Wordpress sites, and a VPS to host the Ruby on Rails applications I’ve been working on. Really this is expensive, so I’m wanting to consolidate to one VPS for everything.

I’ve been forewarned that cPanel does things it’s own way, so if you’re trying to do something out-of-the-box you can run into issues. I’m aware of this, and through this article will let you know if setting up a Rails 3.1.3 hosting environment is possible with a WHM / cPanel server (RELEASE version 11.30.5, build 3). I plan on using Gitosis under an account to host repositories, Capistrano for deployment, and Passenger with Apache2 already provided by cPanel.

Installing Ruby

To stay within the “box” of the cPanel environment, I installed Ruby using the script provided by cPanel

/scripts/installruby

Gitosis

To setup Gitosis you have to first install Python tools.

yum -y install python-setuptools

Next, to install Git, you’ll have to use a special command because cPanel has configured /etc/yum.conf to exclude certain packages, including perl packages, so that they do not break or conflict with the cPanel system. Use the following command to install Git:

yum --disableexcludes=main install git

From the root home directory, download and install Gitosis.

cd /root
git clone git://eagain.net/gitosis.git
cd gitosis
python setup.py install

Next create an account to host your Git repositories from the WHM interface. I’ve added a user with the user name ‘git’, and used ‘git.web-app-host.com’ as the domain (a subdomain under my hosting service domain). Set the password to a very long secure password. You won’t be needing it again, as you’ll be using an SSH key to authenticate.

After you’re done creating the cPanel account which will host the repositories, copy your public key from your local machine to your root users home direcotry ( /root/ ).

scp ~/.ssh/id_rsa.pub root@vps.web-app-host.com:/root

Go back to your SSH session as ‘root’ on the server and run this command to initialize the Gitosis repository under the ‘git’ user account.

root@vps [~]# sudo -H -u git gitosis-init < /root/id_rsa.pub
Initialized empty Git repository in /home/git/repositories/gitosis-admin.git/
Reinitialized existing Git repository in /home/git/repositories/gitosis-admin.git/

NOTE: Do not use the 'Manage SSH Keys' option from the cPanel for the Git acccount, as this will remove the Gitosis-admin repository key from /home/git/.ssh/authorized_keys.

Run the following command to make sure the post-update hook is executable. If this isn't done, then tasks performed by Gitosis after you commit an update aren't performed (i.e. creating new repositories).

sudo chmod u+x /home/git/repositories/gitosis-admin.git/hooks/post-update

On your local machine, run the following command to clone the Gitosis-admin repository, used to manage your repositories on the server, to your local machine.

git clone git@:gitosis-admin.git

This should look like this:

$ git clone git@vps.web-app-host.com:gitosis-admin.git
Cloning into 'gitosis-admin'...
stdin: is not a tty
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (5/5), done.
remote: Total 5 (delta 0), reused 5 (delta 0)
Receiving objects: 100% (5/5), done.

rm /root/id_rsa.pub

[gitosis]

[group gitosis-admin]
writable = gitosis-admin marketsim
members = jason@mymacbook.local

[repo marketsim]
gitweb = no
description = Market Simulation App
owner = Jason Miller
daemon = no

[gitosis]

[group gitosis-admin]
writable = gitosis-admin
members = jason@mymacbook.local

[group marketsim-team]
members = jason@mymacbook.local
writable = marketsim

[repo marketsim]
gitweb = no
description = Market Simulation App
owner = Jason Miller
daemon = no

$ cd marketsim
$ git init .
$ git add .
$ git commit -m "initial commit"
$ git remote add origin git@vps.web-app-host.com:marketsim.git
$ git push origin master
stdin: is not a tty
Initialized empty Git repository in /home/git/repositories/marketsim.git/
Counting objects: 3, done.
Writing objects: 100% (3/3), 209 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@vps.web-app-host.com:marketsim.git
 * [new branch]      master -> master

$ ssh root@vps.web-app-host.com
root@vps [~]# gem install bundler
Fetching: bundler-1.0.21.gem (100%)
Successfully installed bundler-1.0.21
1 gem installed
Installing ri documentation for bundler-1.0.21...
Installing RDoc documentation for bundler-1.0.21...
root@vps [~]# which bundle
/usr/bin/bundle

require "bundler/capistrano"
load "deploy/assets"

#############################################################
# Settings

set :application, "marketsim"
default_run_options[:pty] = true  # Must be set for the password prompt from git to work
set :use_sudo, false

set :user, "marketsi"  # The server's user for deploys
set :deploy_to, "/home/#{user}/rails"
set :ssh_options, { :forward_agent => true }

set :domain, "marketsim.org"
server domain, :app, :web
role :db, domain, :primary => true

#############################################################
# Git

set :scm, :git
set :repository,  "git@vps.web-app-host.com:marketsim.git"
set :branch, "master"
set :deploy_via, :remote_cache

#############################################################
# Passenger

namespace :passenger do
  desc "Restart Application"
  task :restart do
    run "touch #{current_path}/tmp/restart.txt"
  end
end

after :deploy, "passenger:restart"

cap deploy:setup

cap deploy

gem install passenger

passenger-install-apache2-module

# /usr/local/apache/conf/includes/pre_main_global.conf
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11
PassengerRuby /usr/bin/ruby

cp /usr/local/apache/conf/httpd.conf /usr/local/apache/conf/httpd.conf.bak-modrails
/usr/local/cpanel/bin/apache_conf_distiller --update
/scripts/rebuildhttpdconf
/etc/init.d/httpd restart

rm -rf /home/marketsi/public_html/
ln -s /home/marketsi/rails/current/public /home/marketsi/public_html
chown marketsi:nobody public_html/
chmod 750 public_html/

RailsBaseURI /
PassengerAppRoot /home/marketsi/rails/current

I checked online to see how this is done and found references to the ‘relative_url_root’ setting, but then shortly found that this has been deprecated.

I’m using Phusion Passenger with Apache 2, so I inserted the following configuration into my VirtualHost entry for the site.

Alias /info /home/myapp/current/public
<Location /info>
  PassengerAppRoot /home/myapp/current
  RailsEnv production
</Location>

The Rails application was expecting requests from the root of the site still. I found a StackOverflow article where someone suggested configuring all the routes under the “/info” scope like so:

# config/routes.rb
scope "/info" do
  root :to => "welcome#index"
  resources :posts
end

This worked fine in development mode. I just made sure to pull up the pages using http://localhost:3000/info/

I had tested this in production before building out the application further, and it seemed to work fine. Later on when I deployed after many updates, I found that the application was referencing precompiled assets using ‘/assets/’ and not ‘/info/assets/’. Further investigation pointed out that I needed to configure assets with a prefix like so:

# config/application.rb
config.assets.prefix = "/info/assets"

This seemed like it would help, but this caused assets to be precompiled under ‘public/info/assets’.

I had previously Googled for ‘rails 3.1 subdirectory path’, not registering that the more appropriate keyword is ‘sub URI’ for what I’m trying to accomplish.

It turns out that the best way to do this with Passenger is to mount the application to the sub-URI using the proper Apache configuration, and leave it up to the Rack interface to handle serving the requests to the Rails application, without using any Rails application configuration for the sub-URI.

I removed the scoped routes, and the assets prefix, returning my application to it’s default configuration. I then created a symbolic link for ‘info’ in the websites DocumentRoot, pointing to the ‘public’ folder of my application as per the Passenger documentation.

ln -s /home/myapp/current/public /home/mysite/public_html/info

I added the appropriate configuration into my VirtualHost entry as advised by the Passenger documentation, but this only worked for the root of the website, not my admin area I had wanted to serve from /info/admin/. All I got was a 404 page from the main site.

I found that the following configuration worked perfectly, with the symbolic link still needing to be present.

Alias /info /home/myapp/current/public
<Location /info>
  PassengerAppRoot /home/myapp/current
  RackEnv production
  RackBaseURI /info
</Location>

You might notice that I’m using ‘RackEnv production’ instead of ‘RailsEnv production’. This is because I recall at some point previously that Rails 3.0 applications are Rack Applications, and thus you have to use ‘RackEnv’ instead for Passenger to load the application in the proper environment mode.

Update 01/04/12: I’m using the TinyMCE-Rails plugin to provide a WYSIWYG editor for one of the resources in my application. It’s not loading in production however (surprise, surprise). I checked into the precompiled Javascript file being served from the live server, and I see it includes the following:

window.tinyMCEPreInit=window.tinyMCEPreInit||{base:"/assets/tinymce",query:"3.4.7",suffix:""}

The ‘base’ value should be ‘/info/assets/tinymce’. I see that in the TinyMCE-Rails gem the coding for this is:

window.tinyMCEPreInit = window.tinyMCEPreInit || {
  base:   '<%= Rails.application.config.assets.prefix %>/tinymce',
  query:  '<%= TinyMCE::VERSION %>',
  suffix: ''
};

All call to ‘asset_path(‘rails.png’)’ in production returns ‘/info/assets/rails-e4b51606cd77fda2615e7439907bfc92.png’ so Rails is honoring the RackSubURI setting configured for Passenger. The following returns the same path.

The reason why this works is that the Rails asset helpers pull the relative_url_root value from the controller configuration, which must receive it from the Rack configuration. When deploying the app using Capistrano, such configuration is not present, and thus the correct path cannot be included in the precompiled assets.

The issue was reported via Git hub in issue #3259 and #2435, and a fix will was implemented in Rails 3.2, with a possibly backport to Rails 3.1.4.

It appears that you’ll need to add a configuration to your application.rb or environments/production.rb, depending on how your development and production environments are setup.

# config/environments/production.rb

# Use sub-uri in production
config.relative_url_root = '/info'

Or possibly configure your deployment script to include the environment variable when precompiling.

RAILS_RELATIVE_URL_ROOT="/info" bundle exec rake assets:precompile

I wanted to test this, but I can’t seem to update to Rails 3.2, or install a new Rails app using edge Rails.

rails new testapp --edge
.
.
.
Bundler could not find compatible versions for gem "actionpack":
  In Gemfile:
    sass-rails (>= 0) ruby depends on
      actionpack (~> 3.1.0) ruby

    rails (>= 0) ruby depends on
      actionpack (4.0.0.beta)

I’m just going to configure my app under a subdomain instead of sub-uri for now.

When I’d try to run the task itself I would get a ‘Don’t know how to build task’ error.

I just realized that I was naming my task file with the ‘.rb’ extension, and not ‘.rake’. Doh!

Sometimes I’m not sure if the requests being made via the commands I’m using are making the right calls on the HighRise API.

I found this thread on StackOverflow: How do I view the HTTP response to an ActiveResource request?. The solution I found helpful was this one on overriding ActiveResource::Connection so that it outputs the debug output. This worked for me even with Rails 3.1.

Just in case this article with the code disappears, here is the initializer code you can use to view the HTTP session data from the console. I’ve added an if statement to make sure the HTTP data is only outputted to the standard output in development mode, for security purposes, as well as requires the environment variable ‘HTTPDEBUG’.

# /config/initializers/connection.rb
class ActiveResource::Connection
  # Creates new Net::HTTP instance for communication with
  # remote service and resources.
  def http
    http = Net::HTTP.new(@site.host, @site.port)
    http.use_ssl = @site.is_a?(URI::HTTPS)
    http.verify_mode = OpenSSL::SSL::VERIFY_NONE if http.use_ssl
    http.read_timeout = @timeout if @timeout
    #Here's the addition that allows you to see the output
    if Rails.env == 'development' && ENV['HTTPDEBUG']
      http.set_debug_output $stderr
    end
    return http
  end
end

You can open the Rails console using ‘HTTPDEBUG=true rails c’ to activate the console with debugging output displayed in the console mode.

# /lib/tasks/mytask.rake
namespace :mytask do

  task :default => 'mytask:full_run'

  desc "run all tasks in proper order"
  task :full_run => [:example_task_one, :example_task_two] do
    puts "All tasks ran and completed at #{Time.now}"
  end

  desc "example task without arguments"
  task :example_task_one => :environment do
    # task code goes here
    puts "Example Task One completed"
  end

  desc "example task with arguments"
  task :example_task_two, [:arg1, :arg2] => :environment do |t, args|
    # if no arguments, display docs
    if args.count == 0
      puts ''
      puts "rake mytask:example_task[arg1,arg2]"
      puts "arg1: description of first argument"
      puts "arg2: description of second argument"
      puts ''
      puts "example:"
      puts "rake mytask:example_task[123,'456']"
      puts ''
    else
      # task code goes here
      puts "Running task with arg1: #{args.arg1}, and arg2: #{args.arg2}"
      puts "Example Task Two completed"
    end
  end
end

Special thanks to Jason Seifer for his Rake Tutorial which made this possible.

After upgrading and testing many points of the system locally, I was ready to push the upgraded application to the production server. After pushing it out I started to notice that a certain rake task was failing to run via a cronjob I had setup. This rake task worked with certain non-ActiveRecord models, which I had setup with a hierarchy which utilized inheritance and namespacing.

Under Rails 2.3.8 I had a file, /app/models/rets_map/rets_map_base.rb. The error I was receiving from the rake task involved some sort of issue loading the class from this file.

As an experiment I renamed the file as ‘base.rb’ so that it’s path was /app/models/rets_map/base.rb. I figured that Rails 3.1.0 expected this naming convention. I was right, kind of…

$ rails console
/Users/jason/Sites/rj4/rails/app/controllers/site_setup_controller.rb:120: warning: string literal in condition
Loading development environment (Rails 3.1.0)
irb(main):001:0> RetsMap
=> RetsMap
irb(main):002:0> RetsMap::Base
=> RetsMap::Base
irb(main):003:0> reload!
Reloading...
=> true
irb(main):004:0> RetsMap
=> RetsMap
irb(main):005:0> RetsMap::Base
=> RetsMap::Base
irb(main):006:0> reload!
Reloading...
=> true
irb(main):007:0> RetsMap
=> RetsMap
irb(main):008:0> RetsMap::Base
LoadError: Expected /Users/jason/Sites/rj4/rails/app/models/rets_map/base.rb to define RetsMap::Base
	from /opt/local/lib/ruby/gems/1.8/gems/activesupport-3.1.0/lib/active_support/dependencies.rb:490:in `load_missing_constant'
	from /opt/local/lib/ruby/gems/1.8/gems/activesupport-3.1.0/lib/active_support/dependencies.rb:181:in `const_missing'
	from /opt/local/lib/ruby/gems/1.8/gems/activesupport-3.1.0/lib/active_support/dependencies.rb:179:in `each'
	from /opt/local/lib/ruby/gems/1.8/gems/activesupport-3.1.0/lib/active_support/dependencies.rb:179:in `const_missing'
	from (irb):8

For some reason after I would tell the console to reload the models, I got an error that the file didn’t define RetsMap::Base….but it did damnit!!

The error was regarding ActiveSupport, so I tried to reinstall the Rails gem and ActiveSupport gem, but this didn’t help.

The solution I had found was to upgrade to Rails 3.1.1. After doing this, the error no longer occurred, even after I had reloaded the models.

Ooh, also, I didn’t mention. Previously I was using the following command in /config/application.rb:

config.autoload_paths += Dir["#{config.root}/app/models/**/"]

As part of my troubleshooting I figured that by default Rails will try to load models from subdirectories if they conform to the proper directory and file naming required for namespaced models. When you add models to the autoload paths configuration, I think it expects that those conventions don’t apply…or maybe this just causes problems. I commented this line out and simply added each subdirectory that contained non-namespaced models.

config.autoload_paths += %W(#{config.root}/app/models/email/)
config.autoload_paths += %W(#{config.root}/app/models/sub/)
config.autoload_paths += %W(#{config.root}/app/models/upload/)

We had just launched the upgraded Rails 3.1 application to our production server, which went smoothly, but upon my checklist of pages to test (we don’t have test suite in use yet) I noticed that the file upload was failing. Further investigation showed that the object using paperclip was failing to save:

upload.errors.inspect: 

#["/tmp/stream20111205-28441-10oj2ck-0.csv is not recognized by the 'identify' command.", "/tmp/stream20111205-28441-10oj2ck-0.csv is not recognized by the 'identify' command."]}>, @base=#>

Further investigation helped me identify this ‘identify’ command as an executable provided by ImageMagick. I ran this command on the temporary file which was located in /tmp, and I got an error such as the one that follows on both my local machine and in production. The odd thing was that the file upload worked locally, but was failing remotely.

$ identify test-import20111205-1909-1xsbr19-0.csv 

identify: no decode delegate for this image format `test-import20111205-1909-1xsbr19-0.csv' @ error/constitute.c/ReadImage/532.

This didn’t make sense. I was uploading a CSV file, not an image. I wasn’t even using the ‘:styles’ hash value in my model with the ‘has_attached_file’ expression. Why was it checking to see what type of image the file is?!?!

I tried to upgrade and reinstall ImageMagick on the production server, but this had no effect. This made me suspect that paperclip was the cause of the issue. I also created an initalizer for paperclip under /config/initalizers/paperclip.rb pointing out the image_magick_path, which I had seen resolve other issues with ‘identify’ errors.

if Rails.env == 'production'
  Paperclip.options[:image_magick_path] = "/usr/bin/"
end

This didn’t help at all.

I tried to reconfigure the application to use Paperclip version 2.4.4 and 2.4.3, but that didn’t resolve the issue.

Finally I updated my Gemfile to use the latest Github version of Paperclip. I deployed this update, tested, and finally the issue was resolved.

gem 'paperclip', "~> 2.4.5", :git => 'git://github.com/thoughtbot/paperclip.git'

I read through the documentation, followed the instructions to ensure that prerequisite software was installed. I specifically made sure that certain commands that it stated would be needed were all in my command line path under /opt/local, where the MacPorts all install. I try to maintain a command line environment that’s almost entirely dependent on MacPorts. Prior to ensuring this I ran into issues where software I’ve tried to install was using one utility or library provided natively by Mac OS X, while using some other utility or library I’ve installed separately, conflict due to differences and stop certain software from building properly upon install.

I also took note that since I’m using MacPorts, I should configure my $HOME/.rvmrc file so that RVM uses my MacPort libraries when building gems.

Installation of Ruby

The installation of the RVM software itself went smoothly. I felt good knowing that I was about to learn how RVM works and it will become another tool that I gladly assign to my arsenal of software to be used in the future (and add to my resume).

Then I ran into an issue with something in ‘readline.c’ when I attempted to install Ruby 1.8.7.

jason@imac ~$ rvm install 1.8.7 --with-openssl-dir=/opt/local

Installing Ruby from source to: /Users/jason/.rvm/rubies/ruby-1.8.7-p352, this may take a while depending on your cpu(s)...

ruby-1.8.7-p352 - #fetching
ruby-1.8.7-p352 - #extracting ruby-1.8.7-p352 to /Users/jason/.rvm/src/ruby-1.8.7-p352
ruby-1.8.7-p352 - #extracted to /Users/jason/.rvm/src/ruby-1.8.7-p352
Applying patch 'stdout-rouge-fix' (located at /Users/jason/.rvm/patches/ruby/1.8.7/stdout-rouge-fix.patch)
ruby-1.8.7-p352 - #configuring
ruby-1.8.7-p352 - #compiling
ERROR: Error running 'make ', please read /Users/jason/.rvm/log/ruby-1.8.7-p352/make.log
ERROR: There has been an error while running make. Halting the installation.

jason@imac ~$ tail -10 /Users/jason/.rvm/log/ruby-1.8.7-p352/make.log
.
.
.
compiling readline
/usr/bin/gcc-4.2 -I. -I../.. -I../../. -I../.././ext/readline -DHAVE_READLINE_READLINE_H -DHAVE_READLINE_HISTORY_H -DHAVE_RL_FILENAME_COMPLETION_FUNCTION -DHAVE_RL_COMPLETION_MATCHES -DHAVE_RL_DEPREP_TERM_FUNCTION -DHAVE_RL_COMPLETION_APPEND_CHARACTER -DHAVE_RL_BASIC_WORD_BREAK_CHARACTERS -DHAVE_RL_COMPLETER_WORD_BREAK_CHARACTERS -DHAVE_RL_BASIC_QUOTE_CHARACTERS -DHAVE_RL_COMPLETER_QUOTE_CHARACTERS -DHAVE_RL_FILENAME_QUOTE_CHARACTERS -DHAVE_RL_ATTEMPTED_COMPLETION_OVER -DHAVE_RL_LIBRARY_VERSION -DHAVE_RL_EVENT_HOOK -DHAVE_RL_CLEANUP_AFTER_SIGNAL -DHAVE_REPLACE_HISTORY_ENTRY -DHAVE_REMOVE_HISTORY -I/opt/local/include -D_XOPEN_SOURCE -D_DARWIN_C_SOURCE  -I/opt/local/include -fno-common -arch x86_64 -g -Os -pipe -no-cpp-precomp  -fno-common -pipe -fno-common   -c readline.c
readline.c: In function ‘username_completion_proc_call’:
readline.c:730: error: ‘username_completion_function’ undeclared (first use in this function)
readline.c:730: error: (Each undeclared identifier is reported only once
readline.c:730: error: for each function it appears in.)
make[1]: *** [readline.o] Error 1
make: *** [all] Error 1

I tried to install ‘readline’ using MacPorts because I read online that this was a common issue with Mac OS X users under Snow Leopard. This didn’t help, and in fact I got an error after trying to install readline from source as recommended in the forum post I found regarding the subject.

After further search, I realized that the RVM documentation (which is pretty good I must say) has a page devoted to this issue.

Issue Installing Custom Gems

Later I had installed Ruby 1.9.2 as well, because I needed it for BrowserCMS. I was trying to install gems for Ruby, but each time it would give me the ‘Invalid gemspec … invalid date format in specification’ error that I recall from a time when I was using a newer version of RubyGems than the gems I had installed were made for, like:

Invalid gemspec in [/opt/local/lib/ruby/gems/1.8/specifications/paperclip-2.4.3.gemspec]: invalid date format in specification: "2011-10-05 00:00:00.000000000Z"

I made sure I was running under Ruby 1.9.2, and that the version of RubyGems would be the one associated with Ruby version 1.9.2, and then upgraded it to version

imac:Sites jason$ rvm 1.9.2
imac:Sites jason$ rvm gemdir
/Users/jason/.rvm/gems/ruby-1.9.2-p290
imac:Sites jason$ rvm rubygems current
Removing old Rubygems files...
Installing rubygems-1.8.10 for ruby-1.9.2-p290 ...
Installation of rubygems completed successfully.

I tried to check or change which version of gem I was using, and it would tell me it’s using one installed under RVM, but still it would give errors as if it was using an older version of RubyGems.

imac:Sites jason$ which gem
/Users/jason/.rvm/rubies/ruby-1.9.2-p290/bin/gem

imac:Sites jason$ sudo gem install browsercms

Invalid gemspec in [/opt/local/lib/ruby/gems/1.8/specifications/capistrano-2.9.0.gemspec]: invalid date format in specification: "2011-09-24 00:00:00.000000000Z"

I then found out that I had a .gemrc file setup that was loading in my command line environment, and thus interfering with the dependency loading which RVM provides.

imac:Sites jason$ cd ~
imac:~ jason$ cat .gemrc
gemhome: /opt/local/lib/ruby/gems/1.8
gempath:
 - /opt/local/lib/ruby/gems/1.8
 - /Users/jason/gems
imac:~ jason$

I simply renamed this file as .gemrc.bak and this resolved the issue so that gems I install under Ruby v1.9.2 will use the RubyGem version associated with the Ruby 1.9.2 installation.

I then realized that perhaps redirects aren’t possible with HTTP POST’s, only GET requests. I ended up just creating a generic view for displaying errors, and will render that view and then ‘return FALSE’ inside of the if statement when an error is detected.

The wiki for this plugin advises you on how to do setup your controller method, and what to put in the view to obtain a simple set of links, such as:

# /app/controllers/contact_controller.rb
def index
  @contacts = Contact.paginate :page => params[:page], :per_page => 10, :order => 'created_at DESC'
end

# /app/views/contact/index.html.erb
<%= will_paginate @contacts %>

What I’m not finding however are more advanced methods of using the will_paginate plugin. Here are a few things I’ve found.

Links at top and bottom of paginated section

You can add the paginated links to the top and bottom of your paginated section using this syntax:

<% paginated_section @contacts do %>
	<table id="contacts">
		<%= render(:partial => "contact_row", :collection => @contacts) %>
	</table>
<% end %>

Display Page Entries Info

You can display text on your page such as ‘Displaying contacts 11 - 12 of 12 in total’ by using the following view helper.

<%= page_entries_info @contacts %>

Current and Total Page Number

If you want to display the total number of pages in your own way, you can do this by using the ‘total_pages’ method of the paginated collection.

<p>You are viewing page <%= @contacts.current_page %>
of <%= @contacts.total_pages %></p>