From ea4e82d66d22cdc4aa3eddd2d5b23a4928c280e3 Mon Sep 17 00:00:00 2001 From: Jack Ivanov Date: Sat, 14 Jan 2017 20:07:52 +0300 Subject: [PATCH] move troubleshooting from the landing readme page --- README.md | 49 +---------------------------------------- docs/Troubleshooting.md | 46 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+), 48 deletions(-) create mode 100644 docs/Troubleshooting.md diff --git a/README.md b/README.md index f1bdebc..fdae587 100644 --- a/README.md +++ b/README.md @@ -125,54 +125,7 @@ OpenVPN does not have out-of-the-box client support on any major desktop or mobi Alpine Linux is not supported out-of-the-box by any major cloud provider. We are interested in supporting Free-, Open-, and HardenedBSD. Follow along or contribute to our BSD support in [this issue](https://github.com/trailofbits/algo/issues/35). -## Troubleshooting - -### Error: "You have not agreed to the Xcode license agreements" - -On macOS, did you try to install the dependencies with pip and encounter the following error? - -``` -Downloading cffi-1.9.1.tar.gz (407kB): 407kB downloaded - Running setup.py (path:/private/tmp/pip_build_root/cffi/setup.py) egg_info for package cffi - -You have not agreed to the Xcode license agreements, please run 'xcodebuild -license' (for user-level acceptance) or 'sudo xcodebuild -license' (for system-wide acceptance) from within a Terminal window to review and agree to the Xcode license agreements. - - No working compiler found, or bogus compiler options - passed to the compiler from Python's distutils module. - See the error messages above. - (If they are about -mno-fused-madd and you are on OS/X 10.8, - see http://stackoverflow.com/questions/22313407/ .) - ----------------------------------------- -Cleaning up... -Command python setup.py egg_info failed with error code 1 in /private/tmp/pip_build_root/cffi -Storing debug log for failure in /Users/algore/Library/Logs/pip.log -``` - -The Xcode compiler is installed but requires you to accept its license agreement prior to using it. Run `xcodebuild -license` to agree and then retry installing the dependencies. - -### Error: "fatal error: 'openssl/opensslv.h' file not found" - -On macOS, did you try to install pycrypto and encounter the following error? - -``` -build/temp.macosx-10.12-intel-2.7/_openssl.c:434:10: fatal error: 'openssl/opensslv.h' file not found - -#include - - ^ - -1 error generated. - -error: command 'cc' failed with exit status 1 - ----------------------------------------- -Cleaning up... -Command /usr/bin/python -c "import setuptools, tokenize;__file__='/private/tmp/pip_build_root/cryptography/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-sREEE5-record/install-record.txt --single-version-externally-managed --compile failed with error code 1 in /private/tmp/pip_build_root/cryptography -Storing debug log for failure in /Users/algore/Library/Logs/pip.log -``` - -You are running an old version of `pip` that cannot build the `pycrypto` dependency. Upgrade to a new version of `pip` by running `sudo pip install -U pip`. +## [Troubleshooting](docs/Troubleshooting.md) ### Little Snitch is broken when connected to the VPN diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md new file mode 100644 index 0000000..2d82ba1 --- /dev/null +++ b/docs/Troubleshooting.md @@ -0,0 +1,46 @@ +### Error: "You have not agreed to the Xcode license agreements" + +On macOS, did you try to install the dependencies with pip and encounter the following error? + +``` +Downloading cffi-1.9.1.tar.gz (407kB): 407kB downloaded + Running setup.py (path:/private/tmp/pip_build_root/cffi/setup.py) egg_info for package cffi + +You have not agreed to the Xcode license agreements, please run 'xcodebuild -license' (for user-level acceptance) or 'sudo xcodebuild -license' (for system-wide acceptance) from within a Terminal window to review and agree to the Xcode license agreements. + + No working compiler found, or bogus compiler options + passed to the compiler from Python's distutils module. + See the error messages above. + (If they are about -mno-fused-madd and you are on OS/X 10.8, + see http://stackoverflow.com/questions/22313407/ .) + +---------------------------------------- +Cleaning up... +Command python setup.py egg_info failed with error code 1 in /private/tmp/pip_build_root/cffi +Storing debug log for failure in /Users/algore/Library/Logs/pip.log +``` + +The Xcode compiler is installed but requires you to accept its license agreement prior to using it. Run `xcodebuild -license` to agree and then retry installing the dependencies. + +### Error: "fatal error: 'openssl/opensslv.h' file not found" + +On macOS, did you try to install pycrypto and encounter the following error? + +``` +build/temp.macosx-10.12-intel-2.7/_openssl.c:434:10: fatal error: 'openssl/opensslv.h' file not found + +#include + + ^ + +1 error generated. + +error: command 'cc' failed with exit status 1 + +---------------------------------------- +Cleaning up... +Command /usr/bin/python -c "import setuptools, tokenize;__file__='/private/tmp/pip_build_root/cryptography/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-sREEE5-record/install-record.txt --single-version-externally-managed --compile failed with error code 1 in /private/tmp/pip_build_root/cryptography +Storing debug log for failure in /Users/algore/Library/Logs/pip.log +``` + +You are running an old version of `pip` that cannot build the `pycrypto` dependency. Upgrade to a new version of `pip` by running `sudo pip install -U pip`.