mirror of
https://github.com/Xahau/xahaud.git
synced 2025-12-06 17:27:52 +00:00
Update Linux Build Instructions (#4018)
* Removed a reference to the default number of workers varying based on whether a node has validation enabled. Workers default to the number of processor cores + 2: https://github.com/ripple/rippled/blob/develop/src/ripple/core/impl/JobQueue.cpp#L166 * Protobuf v2 and Ubuntu 16.04 are no longer supported. * Updated protobuf version as v3 is now supported, fixed typos, automatically sent number of processors when building boost & rippled.
This commit is contained in:
@@ -7,10 +7,11 @@ the [rippled-package-builder](https://github.com/ripple/rippled-package-builder)
|
|||||||
repository.
|
repository.
|
||||||
|
|
||||||
Note: Ubuntu 16.04 users may need to update their compiler (see the dependencies
|
Note: Ubuntu 16.04 users may need to update their compiler (see the dependencies
|
||||||
section). For non Ubuntu distributions, the steps below should work be
|
section). For non Ubuntu distributions, the steps below should work by
|
||||||
installing the appropriate dependencies using that distribution's package
|
installing the appropriate dependencies using that distribution's package
|
||||||
management tools.
|
management tools.
|
||||||
|
|
||||||
|
|
||||||
## Dependencies
|
## Dependencies
|
||||||
|
|
||||||
gcc-8 or later is required.
|
gcc-8 or later is required.
|
||||||
@@ -28,8 +29,6 @@ $ apt-get install -y autoconf flex bison
|
|||||||
```
|
```
|
||||||
|
|
||||||
Advanced users can choose to install newer versions of gcc, or the clang compiler.
|
Advanced users can choose to install newer versions of gcc, or the clang compiler.
|
||||||
At this time, rippled only supports protobuf version 2. Using version 3 of
|
|
||||||
protobuf will give errors.
|
|
||||||
|
|
||||||
### Build Boost
|
### Build Boost
|
||||||
|
|
||||||
@@ -42,7 +41,7 @@ $ tar -xzf boost_1_70_0.tar.gz
|
|||||||
$ cd boost_1_70_0
|
$ cd boost_1_70_0
|
||||||
$ ./bootstrap.sh
|
$ ./bootstrap.sh
|
||||||
$ ./b2 headers
|
$ ./b2 headers
|
||||||
$ ./b2 -j<Num Parallel>
|
$ ./b2 -j $(echo $(nproc)-2 | bc)
|
||||||
```
|
```
|
||||||
|
|
||||||
### (Optional) Dependencies for Building Source Documentation
|
### (Optional) Dependencies for Building Source Documentation
|
||||||
@@ -88,8 +87,8 @@ git checkout develop
|
|||||||
If you didn't persistently set the `BOOST_ROOT` environment variable to the
|
If you didn't persistently set the `BOOST_ROOT` environment variable to the
|
||||||
directory in which you compiled boost, then you should set it temporarily.
|
directory in which you compiled boost, then you should set it temporarily.
|
||||||
|
|
||||||
For example, you built Boost in your home directory `~/boost_1_70_0`, you
|
For example, if you built Boost in your home directory `~/boost_1_70_0`, you
|
||||||
would do for any shell in which you want to build:
|
would run the following shell command:
|
||||||
|
|
||||||
```
|
```
|
||||||
export BOOST_ROOT=~/boost_1_70_0
|
export BOOST_ROOT=~/boost_1_70_0
|
||||||
@@ -104,8 +103,8 @@ All builds should be done in a separate directory from the source tree root
|
|||||||
(a subdirectory is fine). For example, from the root of the ripple source tree:
|
(a subdirectory is fine). For example, from the root of the ripple source tree:
|
||||||
|
|
||||||
```
|
```
|
||||||
mkdir my_build
|
mkdir build
|
||||||
cd my_build
|
cd build
|
||||||
```
|
```
|
||||||
|
|
||||||
followed by:
|
followed by:
|
||||||
@@ -153,7 +152,7 @@ Several other infrequently used options are available - run `ccmake` or
|
|||||||
Once you have generated the build system, you can run the build via cmake:
|
Once you have generated the build system, you can run the build via cmake:
|
||||||
|
|
||||||
```
|
```
|
||||||
cmake --build . -- -j <parallel jobs>
|
cmake --build . -- -j $(echo $(nproc)-2 | bc)
|
||||||
```
|
```
|
||||||
|
|
||||||
the `-j` parameter in this example tells the build tool to compile several
|
the `-j` parameter in this example tells the build tool to compile several
|
||||||
@@ -174,7 +173,7 @@ building, e.g.:
|
|||||||
|
|
||||||
```
|
```
|
||||||
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/opt/local ..
|
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/opt/local ..
|
||||||
cmake --build . --target install -- -j <parallel jobs>
|
cmake --build . --target install -- -j $(echo $(nproc)-2 | bc)
|
||||||
```
|
```
|
||||||
|
|
||||||
We recommend specifying `CMAKE_INSTALL_PREFIX` when configuring in order to
|
We recommend specifying `CMAKE_INSTALL_PREFIX` when configuring in order to
|
||||||
@@ -184,7 +183,7 @@ the installation by specifying the `DESTDIR` env variable during the install pha
|
|||||||
e.g.:
|
e.g.:
|
||||||
|
|
||||||
```
|
```
|
||||||
DESTDIR=~/mylibs cmake --build . --target install -- -j <parallel jobs>
|
DESTDIR=~/mylibs cmake --build . --target install -- -j $(echo $(nproc)-2 | bc)
|
||||||
```
|
```
|
||||||
|
|
||||||
in which case, the files would be installed in the `CMAKE_INSTALL_PREFIX` within
|
in which case, the files would be installed in the `CMAKE_INSTALL_PREFIX` within
|
||||||
|
|||||||
Reference in New Issue
Block a user