Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

835 Ubuntu 18.04 Support #1212

Merged
merged 4 commits into from
Aug 2, 2018
Merged

835 Ubuntu 18.04 Support #1212

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
749bdc9
Add: Ubuntu 18.04 and SSL 1.1 support
ryanRfox Jul 30, 2018
18bbdcc
Fixup: README.md
ryanRfox Aug 1, 2018
d945591
Add: current_version
ryanRfox Aug 1, 2018
29bd69e
Fixup: README.md
ryanRfox Aug 2, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 22 additions & 18 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,44 +20,48 @@ The web wallet is [BitShares UI](https://github.com/bitshares/bitshares-ui).

Visit [BitShares.org](https://bitshares.org/) to learn about BitShares and join the community at [BitSharesTalk.org](https://bitsharestalk.org/).

**NOTE:** The official BitShares git repository location, default branch, and submodule remotes were recently changed. Existing
repositories can be updated with the following steps:

git remote set-url origin https://github.com/bitshares/bitshares-core.git
git checkout master
git remote set-head origin --auto
git pull
git submodule sync --recursive
git submodule update --init --recursive

Getting Started
---------------
Build instructions and additional documentation are available in the
[wiki](https://github.com/bitshares/bitshares-core/wiki).

We recommend building on Ubuntu 16.04 LTS (64-bit), and the build dependencies may be installed with:
We recommend building on Ubuntu 16.04 LTS (64-bit)

**Build Dependencies**:

sudo apt-get update
sudo apt-get install autoconf cmake make automake libtool git libboost-all-dev libssl-dev g++ libcurl4-openssl-dev

To build after all dependencies are installed:
**Build Script:**

git clone https://github.com/bitshares/bitshares-core.git
cd bitshares-core
git checkout <LATEST_RELEASE_TAG>
git checkout master # may substitute "master" with current release tag
git submodule update --init --recursive
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo .
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<LATEST_RELEASE_TAG> has confused some people. Perhaps update it after every release? Or remove that line, then by default master branch will be used (but --version command won't show the correct tag).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed, let's make it simple for the end user to copy paste the script. I've added a new current_version file containing the text matching the (expected) release tag. I've swapped the for a $variable and inserted a bash script to set variable=$(curl URL)

Copy link
Member

@abitmore abitmore Aug 1, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

curl doesn't work in windows, so I'd avoid that. --version not showing the tag IMHO is acceptable.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the curl statement and $variable. Replaced with an explicit git checkout master and added a comment about replacing with current release as needed.

make

**NOTE:** BitShares requires an [OpenSSL](https://www.openssl.org/) version in the 1.0.x series. OpenSSL 1.1.0 and newer are NOT supported. If your system OpenSSL version is newer, then you will need to manually provide an older version of OpenSSL and specify it to CMake using `-DOPENSSL_INCLUDE_DIR`, `-DOPENSSL_SSL_LIBRARY`, and `-DOPENSSL_CRYPTO_LIBRARY`.
**Upgrade Script** (prepend to the Build Script above if you built a prior release):

**NOTE:** BitShares requires a [Boost](http://www.boost.org/) version in the range [1.57, 1.65]. Versions earlier than
1.57 or newer than 1.65 are NOT supported. If your system Boost version is newer, then you will need to manually build
git remote set-url origin https://github.com/bitshares/bitshares-core.git
git checkout master
git remote set-head origin --auto
git pull
git submodule update --init --recursive # this command may fail
git submodule sync --recursive
git submodule update --init --recursive

**NOTE:** BitShares requires a [Boost](http://www.boost.org/) version in the range [1.57 - 1.65.1]. Versions earlier than
1.57 or newer than 1.65.1 are NOT supported. If your system's Boost version is newer, then you will need to manually build
an older version of Boost and specify it to CMake using `DBOOST_ROOT`.

**NOTE:** BitShares requires a 64-bit operating system to build, and will not build on a 32-bit OS.

After building, the witness node can be launched with:
**NOTE:** BitShares now supports Ubuntu 18.04 LTS

**NOTE:** BitShares now supports OpenSSL 1.1.0

**After Building**, the `witness_node` can be launched with:

./programs/witness_node/witness_node

Expand All @@ -72,7 +76,7 @@ In order to run a full node with all the account history you need to remove `par

| Default | Full | Minimal | ElasticSearch
| --- | --- | --- | ---
| 20G RAM | 120G RAM | 4G RAM | 200G SSD HD, 16G RAM
| 16G RAM | 120G RAM | 4G RAM | 500G SSD HD, 32G RAM

After starting the witness node again, in a separate terminal you can run:

Expand Down