From b6fb2d499abae1bbc712c0a1cd1cef6e208f906e Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Mon, 7 May 2018 14:27:19 -0700 Subject: [PATCH 1/7] Correcting docs for building in linux Related to: #57 --- Documentation/building/unix-instructions.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 09bc9c9909..1cecf3ff7c 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -14,21 +14,18 @@ For more information about the different options when building, run `build.sh -? ## Minimum Hardware Requirements - 2GB RAM -## Prerequisites (native build) +## Prerequisites ### Linux -First, the package lists might need to be updated - -`sudo apt-get update` - On Linux, the following components are needed -* CMake on the PATH -* Clang 3.5+ (same requirements as coreclr/corefx) -* All the requirements necessary to run .NET Core 2.0 applications -* libunwind +* git +* clang-3.9 +* cmake +* libunwind8 * curl +* All the requirements necessary to run .NET Core 2.0 applications ### macOS From 70a5cd7d951e5da9e5c0df2c3a28f514210d6fcb Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Mon, 7 May 2018 15:19:17 -0700 Subject: [PATCH 2/7] Adding more description --- Documentation/building/unix-instructions.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 1cecf3ff7c..31f561b6d4 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -13,26 +13,35 @@ For more information about the different options when building, run `build.sh -? ## Minimum Hardware Requirements - 2GB RAM +- x64 ## Prerequisites ### Linux -On Linux, the following components are needed +On Linux, the following components are needed: * git * clang-3.9 -* cmake +* cmake 2.8.12 * libunwind8 * curl * All the requirements necessary to run .NET Core 2.0 applications +e.g. for Ubuntu 14.04, follow the steps below: + +`sudo apt-get update` + +`sudo apt-get install git clang-3.9 cmake libunwind8 curl` + +Follow instructions on how to [install .NET Core SDK 2.0+ on Ubuntu](https://www.microsoft.com/net/learn/get-started/linux/ubuntu14-04). + ### macOS macOS 10.12 or higher is needed to build dotnet/machinelearning. On macOS a few components are needed which are not provided by a default developer setup: -* CMake +* cmake 3.10.3 One way of obtaining CMake is via [Homebrew](http://brew.sh): ```sh From 6f95b01b76da3606a5939d5ceb89195847d719b3 Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Mon, 7 May 2018 15:27:33 -0700 Subject: [PATCH 3/7] Providing link for further information --- Documentation/building/unix-instructions.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 31f561b6d4..d6cfa4e98d 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -30,11 +30,24 @@ On Linux, the following components are needed: e.g. for Ubuntu 14.04, follow the steps below: -`sudo apt-get update` +```sh +sudo apt-get update +sudo apt-get install git clang-3.9 cmake libunwind8 curl +``` -`sudo apt-get install git clang-3.9 cmake libunwind8 curl` +Follow instructions on how to [install .NET Core SDK 2.0+ on Ubuntu](https://www.microsoft.com/net/learn/get-started/linux/ubuntu14-04): -Follow instructions on how to [install .NET Core SDK 2.0+ on Ubuntu](https://www.microsoft.com/net/learn/get-started/linux/ubuntu14-04). +```sh +#Register Microsoft key and feed +wget -q packages-microsoft-prod.deb https://packages.microsoft.com/config/ubuntu/14.04/packages-microsoft-prod.deb +sudo dpkg -i packages-microsoft-prod.deb +#Install the SDK +sudo apt-get install apt-transport-https +sudo apt-get update +sudo apt-get install dotnet-sdk-2.1.105 +``` + +For more detailed info click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). ### macOS From 921ec5d55d0390e4e8a753dc62c2577d648a0094 Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Mon, 7 May 2018 18:35:50 -0700 Subject: [PATCH 4/7] Improving docs --- Documentation/building/unix-instructions.md | 31 ++++++++++++--------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index d6cfa4e98d..5d97c05d61 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -19,35 +19,40 @@ For more information about the different options when building, run `build.sh -? ### Linux -On Linux, the following components are needed: +For Ubuntu, the following components are needed: * git * clang-3.9 * cmake 2.8.12 * libunwind8 * curl -* All the requirements necessary to run .NET Core 2.0 applications - -e.g. for Ubuntu 14.04, follow the steps below: ```sh sudo apt-get update sudo apt-get install git clang-3.9 cmake libunwind8 curl ``` -Follow instructions on how to [install .NET Core SDK 2.0+ on Ubuntu](https://www.microsoft.com/net/learn/get-started/linux/ubuntu14-04): +And all the requirements necessary to run .NET Core 2.0 applications: libssl and libcu5x: + +* For 14.x ```sh -#Register Microsoft key and feed -wget -q packages-microsoft-prod.deb https://packages.microsoft.com/config/ubuntu/14.04/packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -#Install the SDK -sudo apt-get install apt-transport-https -sudo apt-get update -sudo apt-get install dotnet-sdk-2.1.105 +sudo apt-get install libssl1.0.0 libcu52 +``` + +* For 16.x + +```sh +sudo apt-get install libssl1.0.0 libcu55 +``` + +* For 17.x + +```sh +sudo apt-get install libssl1.0.0 libcu57 ``` -For more detailed info click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). +For more info on prerequisites for .NET Core on Linux click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). ### macOS From 846e5e747a352425e0020b6cc3550ab215d2e374 Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Tue, 8 May 2018 10:03:23 -0700 Subject: [PATCH 5/7] Making less ubuntu centric. --- Documentation/building/unix-instructions.md | 30 +++++---------------- 1 file changed, 7 insertions(+), 23 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 5d97c05d61..9ca621761c 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -19,41 +19,25 @@ For more information about the different options when building, run `build.sh -? ### Linux -For Ubuntu, the following components are needed: +The following components are needed: * git * clang-3.9 * cmake 2.8.12 * libunwind8 * curl +* All the requirements necessary to run .NET Core 2.0 applications: libssl1.0.0 (1.0.2 for Debian 9) and libicu5x (libicu52 for ubuntu 14.x, libicu55 for ubuntu 16.x, and libicu57 for ubuntu 17.x) -```sh -sudo apt-get update -sudo apt-get install git clang-3.9 cmake libunwind8 curl -``` - -And all the requirements necessary to run .NET Core 2.0 applications: libssl and libcu5x: - -* For 14.x - -```sh -sudo apt-get install libssl1.0.0 libcu52 -``` - -* For 16.x - -```sh -sudo apt-get install libssl1.0.0 libcu55 -``` +For more information on prerequisites in different linux distribution for .NET Core on Linux click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). -* For 17.x +e.g. for Ubuntu 16.x: ```sh -sudo apt-get install libssl1.0.0 libcu57 +sudo apt-get update +sudo apt-get install git clang-3.9 cmake libunwind8 curl +sudo apt-get install libssl1.0.0 libicu55 ``` -For more info on prerequisites for .NET Core on Linux click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). - ### macOS macOS 10.12 or higher is needed to build dotnet/machinelearning. From 8ea572f8dfb26655e86c2582ca8318078b39486f Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Tue, 8 May 2018 10:35:41 -0700 Subject: [PATCH 6/7] Adding pre-req link for macOS --- Documentation/building/unix-instructions.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 9ca621761c..05c2fd3c1a 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -44,8 +44,9 @@ macOS 10.12 or higher is needed to build dotnet/machinelearning. On macOS a few components are needed which are not provided by a default developer setup: * cmake 3.10.3 +* All the requirements necessary to run .NET Core 2.0 applications. To view macOS prerequisites click [here](https://docs.microsoft.com/en-us/dotnet/core/macos-prerequisites?tabs=netcore2x) One way of obtaining CMake is via [Homebrew](http://brew.sh): ```sh $ brew install cmake -``` \ No newline at end of file +``` From 27790ff77de6dfc3ca9cfba6230ca5f5be90fa26 Mon Sep 17 00:00:00 2001 From: Maryam Ariyan <> Date: Tue, 8 May 2018 12:10:57 -0700 Subject: [PATCH 7/7] Improving sentences --- Documentation/building/unix-instructions.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/Documentation/building/unix-instructions.md b/Documentation/building/unix-instructions.md index 05c2fd3c1a..0110ae6b8f 100644 --- a/Documentation/building/unix-instructions.md +++ b/Documentation/building/unix-instructions.md @@ -7,9 +7,9 @@ Building ML.NET on Linux and macOS 3. Navigate to the `machinelearning` directory 4. Run the build script `./build.sh` -Calling the script `build.sh` builds both the native and managed code. +Calling the script `./build.sh` builds both the native and managed code. -For more information about the different options when building, run `build.sh -?` and look at examples in the [developer-guide](../project-docs/developer-guide.md). +For more information about the different options when building, run `./build.sh -?` and look at examples in the [developer-guide](../project-docs/developer-guide.md). ## Minimum Hardware Requirements - 2GB RAM @@ -26,9 +26,7 @@ The following components are needed: * cmake 2.8.12 * libunwind8 * curl -* All the requirements necessary to run .NET Core 2.0 applications: libssl1.0.0 (1.0.2 for Debian 9) and libicu5x (libicu52 for ubuntu 14.x, libicu55 for ubuntu 16.x, and libicu57 for ubuntu 17.x) - -For more information on prerequisites in different linux distribution for .NET Core on Linux click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). +* All the requirements necessary to run .NET Core 2.0 applications: libssl1.0.0 (1.0.2 for Debian 9) and libicu5x (libicu52 for ubuntu 14.x, libicu55 for ubuntu 16.x, and libicu57 for ubuntu 17.x). For more information on prerequisites in different linux distributions click [here](https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x). e.g. for Ubuntu 16.x: @@ -44,7 +42,7 @@ macOS 10.12 or higher is needed to build dotnet/machinelearning. On macOS a few components are needed which are not provided by a default developer setup: * cmake 3.10.3 -* All the requirements necessary to run .NET Core 2.0 applications. To view macOS prerequisites click [here](https://docs.microsoft.com/en-us/dotnet/core/macos-prerequisites?tabs=netcore2x) +* All the requirements necessary to run .NET Core 2.0 applications. To view macOS prerequisites click [here](https://docs.microsoft.com/en-us/dotnet/core/macos-prerequisites?tabs=netcore2x). One way of obtaining CMake is via [Homebrew](http://brew.sh): ```sh