https://github.com/mperham/sidekiq
Raw File
Tip revision: ebf04857d24d0c1fb682f78de0f5621a729a4a7f authored by sebastienvercammen on 12 November 2016, 22:39:08 UTC
I swear to god... (#3237)
Tip revision: ebf0485
Pro-3.0-Upgrade.md
# Welcome to Sidekiq Pro 3.0!

Sidekiq Pro 3.0 is designed to work with Sidekiq 4.0.

## What's New

* **Redis 2.8.0 or greater is required.**  Redis 2.8 was released two years
  ago and contains **many** useful features which Sidekiq couldn't
  leverage until now.  **Redis 3.0.3 or greater is recommended** for large
  scale use.

* Sidekiq Pro no longer uses Celluloid.  If your application code uses Celluloid,
  you will need to pull it in yourself.

* Pausing and unpausing queues is now instantaneous, no more polling!

* Reliable fetch has been re-implemented due to the fetch changes in
  Sidekiq 4.0.

* Support for platforms without persistent hostnames.  Since the reliable\_fetch
  algorithm requires a persistent hostname, an alternative reliability
algorithm is now available for platforms like Heroku and Docker:
```ruby
Sidekiq.configure_server do |config|
  config.timed_fetch!
end
```
  The wiki contains [much more detail about each reliability option](https://github.com/mperham/sidekiq/wiki/Pro-Reliability-Server).

* The old 'sidekiq/notifications' features have been removed.

## Upgrade

First, make sure you are using Redis 2.8 or greater. Next:

* Upgrade to the latest Sidekiq Pro 2.x.
```ruby
gem 'sidekiq-pro', '< 3'
```
* Fix any deprecation warnings you see.
* Upgrade to 3.x.
```ruby
gem 'sidekiq-pro', '< 4'
```
back to top