diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 60c9fb19675..c9b67ffe415 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -38,8 +38,14 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th 5. After a successful build, the `iothub_client.so` Python extension module is copied to the **python/device/samples** folder. Please follow instructions in [Sample applications](#samplecode) to run the Python samples. ###Known build issues: -1. On some small footprint Linux devices, like a *Raspberry Pi* using Raspbian OS, the following build error may occur: `virtual memory exhausted: Cannot allocate memory`. In such a case please try to increase the swap file size on your platform and retry the build. (If swap increase did not work consider running build.sh using --skip-unittests --use-websockets parameters) -2. CentOS7: Only Python 2.7 is supported due to a missing boost-python3 library package + +1.) On building the Python client library (`iothub_client.so`) on Linux devices that have less than **1GB** RAM, you may see build getting **stuck** at **98%** while building `iothub_client_python.cpp` as shown below + +``[ 98%] Building CXX object python/src/CMakeFiles/iothub_client_python.dir/iothub_client_python.cpp.o`` + +If you run into this issue, check the **memory consumption** of the device using `free -m command` in another terminal window during that time. If you are running out of memory while compiling iothub_client_python.cpp file, you may have to temporarily increase the **swap space** to get more available memory to successfully build the Python client side device SDK library. + +2.) CentOS7: Only Python 2.7 is supported due to a missing boost-python3 library package ## Install the Python iothub_client module on Windows from [PyPI] @@ -104,4 +110,4 @@ This repository contains various Python sample applications that illustrate how [setup-devbox]: https://github.com/Azure/azure-iot-sdks/blob/master/c/doc/devbox_setup.md [getstarted]: python-run-sample.md [boost-zip]: http://www.boost.org/users/history/version_1_60_0.html -[lnk-c-redist]: https://www.microsoft.com/download/details.aspx?id=48145 \ No newline at end of file +[lnk-c-redist]: https://www.microsoft.com/download/details.aspx?id=48145