mperham--sidekiq/Pro-2.0-Upgrade.md

# Upgrading to Sidekiq Pro 2.0

Sidekiq Pro 2.0 removes deprecated APIs, changes the batch data format and
how features are activated. To upgrade cleanly:

## Batches

The batch data model was overhauled.  Batch data should take
significantly less space in Redis now.  A simple benchmark shows 25%
savings.

* Batch 2.x BIDs are 14 character URL-safe Base64-encoded strings, e.g.
  "vTF1-9QvLPnREQ".  Batch 1.x BIDs were 16 character hex-encoded
  strings, e.g. "4a3fc67d30370edf".
* In 1.x, batch data was not removed until it naturally expired in Redis.
  In 2.x, all data for a batch is removed from Redis once the batch has
  run any success callbacks.
* Because of the former point, batch expiry is no longer a concern.
  Batch expiry is hardcoded to 30 days and is no longer user-tunable.
* Failed batch jobs no longer automatically store any associated
  backtrace in Redis unless the job's `backtrace` option is set.
* You must require `sidekiq/notifications` if you want to use the
  pre-defined notification schemes.

## Reliability

* Reliable fetch is now activated without a require:
```ruby
Sidekiq.configure_server do |config|
  config.reliable_fetch!
end
* Reliable push is now activated without a require:
```ruby
Sidekiq::Client.reliable_push!
```