From 65b8ddaf1570166349d67642ec8bfb7755f920a1 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 12:13:58 -0800 Subject: [PATCH 1/7] Update known build issues for Python SDK --- doc/get_started/python-devbox-setup.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 60c9fb19675..9fbbe86d34a 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -38,7 +38,13 @@ 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) +1.On building the Python library on Linux devices that have less than **1 GB RAM**, you may see build getting stuck at **98%** while building `iothub_client_python.cpp`. Example below + +`[ 98%] Building CXX object python/src/CMakeFiles/iothub_client_python.dir/iothub_client_python.cpp.o` + +Check the memory consumption of the device using `free -m command` in another terminal window. If you are running out of memory while compiling this file, you may have to temporarily increase the **swap space** to that 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 @@ -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 From 5ead8f303ea3ab75c234c5fce3710297dff110c4 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 12:16:41 -0800 Subject: [PATCH 2/7] Typo --- doc/get_started/python-devbox-setup.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 9fbbe86d34a..91360690430 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -38,7 +38,8 @@ 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 building the Python library on Linux devices that have less than **1 GB RAM**, you may see build getting stuck at **98%** while building `iothub_client_python.cpp`. Example below + +1. On building the Python library on Linux devices that have less than **1 GB 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` From f9fad52426c1cbeebd91ca0defe95d28abb8ee89 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 12:18:51 -0800 Subject: [PATCH 3/7] minor edit --- doc/get_started/python-devbox-setup.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 91360690430..53ea4e0a8de 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -39,14 +39,13 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th ###Known build issues: -1. On building the Python library on Linux devices that have less than **1 GB RAM**, you may see build getting stuck at **98%** while building `iothub_client_python.cpp` as shown below +1.) On building the Python library on Linux devices that have less than **1 GB 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` +``[ 98%] Building CXX object python/src/CMakeFiles/iothub_client_python.dir/iothub_client_python.cpp.o`` Check the memory consumption of the device using `free -m command` in another terminal window. If you are running out of memory while compiling this file, you may have to temporarily increase the **swap space** to that 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 +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] From cf78980dce1a8b90424e810c7f8cda62eed6391b Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 12:27:34 -0800 Subject: [PATCH 4/7] minor edits --- doc/get_started/python-devbox-setup.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 53ea4e0a8de..f88f8ffe6bd 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -39,11 +39,11 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th ###Known build issues: -1.) On building the Python library on Linux devices that have less than **1 GB RAM**, you may see build getting stuck at **98%** while building `iothub_client_python.cpp` as shown below +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`` -Check the memory consumption of the device using `free -m command` in another terminal window. If you are running out of memory while compiling this file, you may have to temporarily increase the **swap space** to that get more available memory to successfully build the Python client side device SDK Library. +Check the **memory consumption** of the device using `free -m command` in another terminal window. If you are running out of memory while compiling this .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 From 3d9f22b113f238d190e45740ef41d029bf0c2893 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 12:28:53 -0800 Subject: [PATCH 5/7] typo --- doc/get_started/python-devbox-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index f88f8ffe6bd..67f462623ef 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -39,7 +39,7 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th ###Known build issues: -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 +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`` From 08ac38fa2a226dd7ee33e77ff9b26983903b7cd6 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 14:32:46 -0800 Subject: [PATCH 6/7] made minor additions --- doc/get_started/python-devbox-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index 67f462623ef..b207c036b84 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -43,7 +43,7 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th ``[ 98%] Building CXX object python/src/CMakeFiles/iothub_client_python.dir/iothub_client_python.cpp.o`` -Check the **memory consumption** of the device using `free -m command` in another terminal window. If you are running out of memory while compiling this .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. +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 From 262e2a366e7d4846ee01531ee3b047b8f6c0fba9 Mon Sep 17 00:00:00 2001 From: anhashia Date: Thu, 10 Nov 2016 15:10:35 -0800 Subject: [PATCH 7/7] typo --- doc/get_started/python-devbox-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/get_started/python-devbox-setup.md b/doc/get_started/python-devbox-setup.md index b207c036b84..c9b67ffe415 100644 --- a/doc/get_started/python-devbox-setup.md +++ b/doc/get_started/python-devbox-setup.md @@ -43,7 +43,7 @@ The Python iothub_client supports python versions 2.7.x, 3.4.x or 3.5.x. Know th ``[ 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. +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