[MESOS-1137] Add FAQ linked within docs/getting-started.md

• Type: Improvement
• Status: Open
• Priority: Trivial
• Resolution: Unresolved
• Component/s: documentation
• Labels: documentation faq getting-started.md
• Assignee: Unassigned
• Reporter: Till Toenshoff
• Created: 21/Mar/14 22:27
• Updated: 27/Sep/14 05:34

Description

Experience shows that there are a few very common questions that pop up for people that start playing with mesos.

So I would like to propose adding some kind of FAQ to our documentation. Specifically for OSX, here are some points that I collected over the time. As there will most likely be more, starting this ticket as a collection before adding an FAQ might be good to find out if it made sense having it.

OS Independent

When running make check one of the tests fails, what now?

After the tests have been compiled, individual tests can be executed manually.

Lets assume that a test named Foo.Bar had failed for you. Now go ahead and run that test individually, with enhanced output:
./bin/mesos-tests.sh --gtest-filter="Foo.Bar" --verbose
That should reveal some more insights of the failure reasoning.

[add some more info on how to skip tests in make check]

OSX Related

Mesos requires automake < 1.14 due to incompatibility issues

with the 'subdir-objects' option.

[insert link to jira ticket here]

For installing automake 1.13.4 via homebrew:
brew versions automake

1.14 git checkout 14a1fa8 /usr/local/Library/Formula/automake.rb
1.13.4 git checkout 029cdc3 /usr/local/Library/Formula/automake.rb
1.13.3 git checkout 9c7cf36 /usr/local/Library/Formula/automake.rb
1.13.2 git checkout 7f584b0 /usr/local/Library/Formula/automake.rb
1.13.1 git checkout 1e5eb62 /usr/local/Library/Formula/automake.rb
1.13 git checkout 2754bd4 /usr/local/Library/Formula/automake.rb
[…]

To be on the safe side, we may now uninstall any automake versions that was previously installed using homebrew.

brew uninstall automake

You may install 1.13.4. To do so, git-checkout the homebrew formula for that specific version manually.

cd /usr/local/Library/Formula/
git checkout 029cdc3 /usr/local/Library/Formula/automake.rb

Now we can simply install automake, the manually chosen version will be used instead of the most recent one.

brew install automake

Could not link test program to Python.

[insert link to jira ticket here]

You may have installed a Python version that did not come with OSX by default (e.g. via MacPorts or Homebrew). If that is the case, make sure the version used is 2.7.3. Anything more recent up until and including 2.7.6 will cause this problem.
Note: This does not apply for the default Python that is delivered by Apple (currently 2.7.5). Apple has fixed this problem in their distribution.

Issue Links

• is related to: MESOS-915 Draft FAQ to be included in project documentation