Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 62 lines (39 sloc) 2.615 kb
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
1 # Bundler Issues
2
fe20ecb André Arko discuss REE+gzip and spork+rake in ISSUES
indirect authored
3 ## Frequently encountered issues
4
5 ### REE and Zlib::GzipFile::Error
6
7 Ruby Enterprise Edition users may see a `Zlib::GzipFile::Error` while installing gems. It is due to [a bug in REE](http://code.google.com/p/rubyenterpriseedition/issues/detail?id=45). You may be able to resolve the issue by upgrading REE, or changing to a different interpreter.
8
9 ### Rake activation error
10
571e3e9 André Arko Update spork issue fix with versions
indirect authored
11 Anyone who has installed the Spork gem may see activation errors while running `rake` directly. This is because old versions of Spork would [install the newest rake using a mkmf file](https://github.com/timcharper/spork/issues/119). To resolve the issue, update the Spork version requirement in your Gemfile to at least `"~>0.8.5"` or `"~>0.9.0.rc8"`.
fe20ecb André Arko discuss REE+gzip and spork+rake in ISSUES
indirect authored
12
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
13 ## Troubleshooting
14
2e6fcbd André Arko Update issues with better instructions
indirect authored
15 Instructions for common Bundler use-cases can be found on the [Bundler documentation site](http://gembundler.com/v1.0/).
16
17 Detailed information about each Bundler command, including help with common problems, can be found in the [Bundler man pages](http://gembundler.com/man/bundle.1.html).
d792117 André Arko Add links to helpful documentation in ISSUES
indirect authored
18
19 After reading the documentation, try these troubleshooting steps:
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
20
a6a3d12 André Arko Expand ISSUES to explain each deletion
indirect authored
21 # remove user-specific gems and git repos
22 rm -rf ~/.bundle/ ~/.gem/
23
fefc334 André Arko Delete bundler git repos while troubleshooting
indirect authored
24 # remove system-wide git repos and git checkouts
25 rm -rf $GEM_HOME/bundler/ $GEM_HOME/cache/bundler/
26
a6a3d12 André Arko Expand ISSUES to explain each deletion
indirect authored
27 # remove project-specific settings and git repos
28 rm -rf .bundle/
29
30 # remove project-specific cached .gem files
31 rm -rf vendor/cache/
32
33 # remove the saved resolve of the Gemfile
34 rm -rf Gemfile.lock
35
36 # try to install one more time
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
37 bundle install
38
d792117 André Arko Add links to helpful documentation in ISSUES
indirect authored
39 ## Reporting unresolved problems
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
40
2e6fcbd André Arko Update issues with better instructions
indirect authored
41 Instructions that allow the Bundler team to reproduce your issue are vitally important. When you report a bug, please include the following information:
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
42
2e6fcbd André Arko Update issues with better instructions
indirect authored
43 - The command you ran
44 - Exception backtrace(s), if any
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
45 - Your Gemfile
46 - Your Gemfile.lock
2e6fcbd André Arko Update issues with better instructions
indirect authored
47 - Your Bundler configuration settings (run `bundle config`)
48 - What version of bundler you are using (run `bundle -v`)
49 - What version of Ruby you are using (run `ruby -v`)
50 - What version of Rubygems you are using (run `gem -v`)
51 - Whether you are using RVM, and if so what version (run `rvm -v`)
dab9711 André Arko check for rubygem-bundler while troubleshooting
indirect authored
52 - Whether you have the `rubygems-bundler` gem, which can break gem binares
2e6fcbd André Arko Update issues with better instructions
indirect authored
53
3e63a35 André Arko Clean up README, factor out ISSUES
indirect authored
54
55 If you are using Rails 2.3, please also include:
56
57 - Your boot.rb file
58 - Your preinitializer.rb file
59 - Your environment.rb file
2e6fcbd André Arko Update issues with better instructions
indirect authored
60
61 [Create a gist](https://gist.github.com) containing all of that information, then visit the [Bundler issue tracker](https://github.com/carlhuda/bundler) and create a new ticket describing your problem and linking to your gist.
Something went wrong with that request. Please try again.