diff --git a/content/tutorial-build-run-rippled-ubuntu.md b/content/tutorial-build-run-rippled-ubuntu.md new file mode 100644 index 0000000000..dc79ee71fe --- /dev/null +++ b/content/tutorial-build-run-rippled-ubuntu.md @@ -0,0 +1,200 @@ +#Build and Run `rippled` on Ubuntu 15.04 and Later + +`rippled` is the core peer-to-peer server that manages the XRP Ledger. A `rippled` server can connect to a network of peers, relay cryptographically signed transactions, and maintain a local copy of the complete shared global ledger. + +For an overview of `rippled`, see [Operating rippled Servers](tutorial-rippled-setup.html) + +Use these instructions to build a `rippled` binary file and run it as a stock `rippled` server on Ubuntu. These instructions use Ubuntu's APT (Advanced Packaging Tool) to install software prerequisites. These instructions were tested on Ubuntu 16.04 LTS. + +For information about building `rippled` for other platforms, see [Builds](https://github.com/ripple/rippled/tree/develop/Builds) in the `rippled` GitHub repository. + +##System Requirements + +Ripple recommends meeting the following **minimum** system requirements for building and running `rippled`. + +**_To build rippled:_** + +* RAM: 8GB + +**_To run rippled:_** + +* CPU: 64-bit x86_64, 2+ cores +* Disk: 50GB SSD with 500 IOPS for the database partition +* RAM: 4GB +* Network: A fast network connection is preferable. + +If you are running `rippled` in an Amazon EC2 instance, Ripple recommends selecting a **Type** of **_m3.large_**. Keep in mind that if you choose to run a validating `rippled` server, you may need more resources. Naturally, your server's workload determines the resources it requires. + +##Build and Run `rippled` + +
    +

  1. Update list of packages that can be installed or upgraded.

    +
    +sudo apt-get update
+
    +
    +
    2. +

  2. Retrieve and upgrade currently installed packages.

    +
    +sudo apt-get -y upgrade
+
    +
    +
    3. +
  3. +

    Install git.

    +
    +sudo apt-get -y install git
+
    +
    4. +

  4. Install SCons.

    +
    +sudo apt-get -y install scons
+
    +
    5. +
  5. +

    Install Ctags.

    +
    +sudo apt-get -y install ctags
+
    +
    6. +
  6. +

    Install pkg-config.

    +
    +sudo apt-get -y install pkg-config
+
    +
    7. +
  7. +

    Install Protocol Buffers.

    +
    +sudo apt-get -y install protobuf-compiler
+sudo apt-get -y install libprotobuf-dev
+
    +
    8. +
  8. +

    +Install SSL.

    +
    +sudo apt-get -y install libssl-dev
+
    +
    9. +
  9. +

    Install python-software properties. Provides the add-apt-repository binary that you'll need to install Boost.

    +
    +sudo apt-get install -y python-software-properties
+
    +
    10. +
  10. +

    Install Boost.

    +
    +sudo add-apt-repository -y ppa:boost-latest/ppa
+sudo apt-get -y update
+sudo apt-get install -y libboost-all-dev
+
    +
    11. +
  11. +

    Get rippled source code.

    +
    +git clone https://github.com/ripple/rippled.git
+cd rippled
+git checkout master
+
    +
    12. +
  12. +

    Build rippled binary executable from source code. This may take about 30 minutes.

    +
    +scons
+
    +
    13. +
  13. +

    Configure rippled.cfg.

    +

    rippled.cfg is the configuration file for rippled.

    +

    You can find an example configuration file (rippled-example.cfg) in rippled/doc. See the file for a description of all configuration options. You should be able to connect to the XRP Ledger using the default configuration defined in the example file.

    +

    Put rippled.cfg in etc/opt/ripple/.

    +
    14. +
  14. +

    Configure validators.txt.

    +

    When you start rippled for the first time, it uses an initial list of validators defined in validators.txt to retrieve validation information and form its UNL (unique node list). validators.txt also enables rippled clients to indirectly locate IPs they can use to contact the Ripple network.

    +

    You can find an example validators file (validators-example.txt) in rippled/doc. See the file for a description of all validator options. You should be able to connect to the XRP Ledger using the default validators defined in the example file.

    +

    Put validators.txt in etc/opt/ripple/.

    +
    15. +
  15. +

    Run rippled.

    +
    +cd build
+sudo ./rippled
+
    +

    You are now running a stock rippled server.

    +
    16. +
+ +##Verify Your Running Instance + +Here are excerpts of what you can expect to see in your terminal once `rippled` is running and connected to the XRP Ledger: + +``` +Loading: "/etc/opt/ripple/rippled.cfg" +Watchdog: Launching child 1 +2017-Dec-15 18:27:37 JobQueue:NFO Auto-tuning to 4 validation/transaction/proposal threads for non-validator. +2017-Dec-15 18:27:37 Amendments:DBG Amendment C6970A8B603D8778783B61C0D445C23D1633CCFAEF0D43E7DBCD1521D34BD7C3 is supported. +2017-Dec-15 18:27:37 Amendments:DBG Amendment 4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373 is supported. + +... + +2017-Dec-15 18:27:37 ValidatorList:DBG Loading configured trusted validator list publisher keys + +... + +2017-Dec-15 18:27:37 ValidatorList:DBG Loading configured validator keys + +... + +2017-Dec-15 18:27:37 ValidatorSite:DBG Loading configured validator list sites + +... + +2017-Dec-15 18:27:38 LedgerConsensus:NFO Entering consensus process, watching, synced=no + +... + +2017-Dec-15 18:27:40 LedgerConsensus:WRN +{ + "accepted" : true, + "account_hash" : "183D5235C7C1FB5AE67AD2F6CC3B28F5FB86E8C4F89DB50DD85641A96470534E", + "close_flags" : 0, + "close_time" : 566677650, + "close_time_human" : "2017-Dec-15 18:27:30", + "close_time_resolution" : 30, + "closed" : true, + "hash" : "014816C71F4B9AD5924AFBD7B02E0DF1522C4BC4BC45A69F97F51D4F2234FA10", + "ledger_hash" : "014816C71F4B9AD5924AFBD7B02E0DF1522C4BC4BC45A69F97F51D4F2234FA10", + "ledger_index" : "2", + "parent_close_time" : 0, + "parent_hash" : "AB868A6CFEEC779C2FF845C0AF00A642259986AF40C01976A7F842B6918936C7", + "seqNum" : "2", + "totalCoins" : "100000000000000000", + "total_coins" : "100000000000000000", + "transaction_hash" : "0000000000000000000000000000000000000000000000000000000000000000" +} + +... + +2017-Dec-15 18:27:48 LedgerConsensus:WRN Need consensus ledger BD5DA7BE8633FCBBBBD58BA62569397BCEE73848FD6068581F5E795243FDFF0B +2017-Dec-15 18:27:50 NetworkOPs:WRN We are not running on the consensus ledger +2017-Dec-15 18:27:50 LedgerConsensus:WRN Need consensus ledger 8459443546CCBE4E89A41E1D0C17F24FBEA7B344C1ED6A26292B4C5CD19B4321 +2017-Dec-15 18:27:53 NetworkOPs:WRN We are not running on the consensus ledger + +... + +2017-Dec-15 18:38:28 OpenLedger:WRN Offer involves frozen asset +2017-Dec-15 18:38:28 OpenLedger:WRN Offer involves frozen asset +2017-Dec-15 18:38:31 LedgerConsensus:WRN Offer involves frozen asset +2017-Dec-15 18:38:31 LedgerConsensus:WRN Offer involves frozen asset +``` + +##Explore Next Steps + +Now that you have a stock `rippled` server running, you may want to consider running it as a validating server. See the [rippled Setup Tutorial](tutorial-rippled-setup.html) for information about validating servers and why you might want to run one. + +For information about updating and maintaining your `rippled` server, see [Updating rippled](tutorial-rippled-setup.html#updating-rippled). + +For information about using the `rippled` API, see [rippled](reference-rippled.html). diff --git a/dactyl-config.yml b/dactyl-config.yml index b685d5703a..a0904af21c 100644 --- a/dactyl-config.yml +++ b/dactyl-config.yml @@ -60,6 +60,8 @@ targets: "tutorial-paychan.html": https://ripple.com/build/payment-channels-tutorial/ "tutorial-escrow.html": https://ripple.com/build/escrow-tutorials/ "tutorial-listing-xrp.html": https://ripple.com/build/listing-xrp-exchange/ + # Jha added link below + "tutorial-build-run-rippled-ubuntu.html": https://ripple.com/build/build-run-rippled-ubuntu/ "concept-accounts.html": https://ripple.com/build/accounts/ "concept-amendments.html": https://ripple.com/build/amendments/ "concept-consensus.html": https://ripple.com/build/xrp-ledger-consensus-process/ @@ -256,6 +258,15 @@ pages: - local - ripple.com +# Jha added entry below + - name: Build and Run rippled on Ubuntu + md: tutorial-build-run-rippled-ubuntu.md + html: tutorial-build-run-rippled-ubuntu.html + category: Tutorials + targets: + - local + - ripple.com + #Features describe how the XRP Ledger works in a mostly conceptual manner - name: Accounts category: Features