Skip to content

Onboarding: Add a troubleshooting section #430

Closed
@apeatling

Description

I think we need a troubleshooting section somewhere. This could be in the readme, or in the wiki, somewhere where it's easy to find.

A couple of issues I've run in to at various times running on a Mac:

Error: EMFILE, too many open files and Module build failed: Error: EMFILE where you need to boost this by using the command sudo ulimit -n 16384. There is also a more permanent solution here: http://docs.basho.com/riak/latest/ops/tuning/open-files-limit/#Mac-OS-X

Please try running again as an administrator (don't have a copy of the exact wording) where you need to run sudo make run instead of just make run. Usually this is only when starting from a fresh copy.

One other thing, lets make sure that we explain how to clean out the build using make distclean so you can start again in the event of an issue. Just re-running make run after dealing with the above errors can sometimes cause obscure issues, and you need to clean out.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions