Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fixed #132 - Update README.md to add more details about installation #133

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,27 @@ You can simply install ROMA and dependency libralies by using a "gems" command o
$ gem install roma
```

### Troubleshooting
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this part should be a part of Installation and found it from another document. I tried to install roma from this repository like you into Ubuntu 14.04(trusty). lbibz2-dev is not installed in default. so installing libbz2-dev is required before installing roma. so it's not a trouble just a prerequisite for installing roma into Ubuntu.

I will merge your PR with the branch 'master' after update it. after that, I will write installation for tokyocabinet-ruby since it looks hard for visiters to this repository to be aware of another document site...


#### Building failure about gem native extension (Ubuntu 14.04)

On Ubuntu 14.04, it reports a failure about building gem native extension while doing `bundle install` under ROMA source directory:

Using tokyocabinet 1.32.0 from git://github.com/roma/tokyocabinet-ruby.git (at master@f270943)

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

This is because of the lack of `libbz2-dev`, so that the `tokyocabinet` cannot be built.
However, the error message is not very helpful, unless one takes a look at the `mkmf.log`.

/usr/bin/ld: cannot find -lbz2

To solve it, install the package from `apt-get`:

sudo apt-get install libbz2-dev

Then re-run `bundle install` to install all the depencies.

### Make routing files

ROMA is required to make the routing files before starting up.
Expand Down