From db41ab183bfdc27e24a837fdc7bd77db27fffdf6 Mon Sep 17 00:00:00 2001 From: Jennifer Hasegawa Date: Wed, 24 Oct 2018 09:32:52 -0700 Subject: [PATCH] just starting out --- .../install-rippled.md | 45 +++++++++++-------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/content/tutorials/manage-the-rippled-server/install-rippled.md b/content/tutorials/manage-the-rippled-server/install-rippled.md index dd2dacdd17..4da45ec7d8 100644 --- a/content/tutorials/manage-the-rippled-server/install-rippled.md +++ b/content/tutorials/manage-the-rippled-server/install-rippled.md @@ -80,7 +80,7 @@ This section assumes that you are using Ubuntu 15.04 or later. $ sudo systemctl start rippled.service -## Installation on macOS with homebrew +## Installation on macOS with Homebrew We don't recommend macOS for `rippled` production use at this time. Currently, the [Ubuntu platform](#installation-on-ubuntu-with-alien) has received the highest level of quality assurance and testing. That said, macOS is suitable for many development/test tasks. @@ -88,15 +88,31 @@ https://github.com/ripple/rippled/tree/develop/Builds/macos This section assumes that you are using macOS X 10.0 or higher. ***TODO: correct?*** -1. Download Xcode: https://developer.apple.com/download/ +1. Install [Xcode](https://developer.apple.com/download/). ***TODO: min and max version? If you try to install Xcode today, you'll need at least macOS 10.13.6.*** -2. Install home brew: ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install) +Installing homebrew removes the need to install xcode command line tools separately + homebrew install lists xcode commend line tools as a requirement: https://docs.brew.sh/Installation#requirements. What does this comment mean? -3. brew update +2. Install Homebrew. -4. brew install git cmake pkg-config protobuf openssl ninja + ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" -5. Download boost: https://dl.bintray.com/boostorg/release/1.67.0/source/boost_1_67_0.tar.bz2 +3. Update Homebrew. + + brew update + +4. Use Homebrew to install git, cmake, pkg-config, protobuf, openssl, and ninja. + + brew install git cmake pkg-config protobuf openssl ninja + +5. Download [boost](https://dl.bintray.com/boostorg/release/1.67.0/source/boost_1_67_0.tar.bz2): + +Installing Boost directly is going to frustrate people - brew can do it in one command + Which release to choose? + Have to deal with environment variables + “rc” files is a vague statement + Build issues with Boost not finding lib (boost-context) in my case + I ended up installing Boost with Brew with no issues 6. build boost: ./bootstrap.sh @@ -106,6 +122,9 @@ This section assumes that you are using macOS X 10.0 or higher. ***TODO: correct 9. Clone the ripple repo: git clone https://github.com/ripple/rippled.git +Cloning github repo is going to require proper github setup + Should we provide some guidance or references? + 10. switch the branch: git checkout develop 11. Create build folder: mkdir my_build @@ -122,22 +141,10 @@ This section assumes that you are using macOS X 10.0 or higher. ***TODO: correct Daniel: Compiling from source (OSX) -Installing homebrew removes the need to install xcode command line tools separately - homebrew install lists xcode commend line tools as a requirement: https://docs.brew.sh/Installation#requirements. What does this comment mean? - -Installing Boost directly is going to frustrate people - brew can do it in one command - Which release to choose? - Have to deal with environment variables - “rc” files is a vague statement - Build issues with Boost not finding lib (boost-context) in my case - I ended up installing Boost with Brew with no issues - -Cloning github repo is going to require proper github setup - Should we provide some guidance or references? - Update rippled No instructions on github or dev docs on how to do this for OSX, Windows, or other Linux distros +Is this about how to run rippled too? How to do that...and how to tell if what you are running is working correctly? ## Postinstall