Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 29 Next »

The information on this page is for people who will help validate and launch the RChain test net upgrade to RNode v0.7 the week of Oct. 15. Additional information will be added here between now and test net launch. 

Requirements for being a test net launcher

  1. Participated in the genesis ceremony to launch the test net at RCon3 in Sept. 2018
  2. Ability to prepare for and participate in the genesis ceremony planned for Oct. 15

What to expect with this test net upgrade

First, thank you for making the time and effort to help upgrade the RChain test net following the release of RNode v0.7. Since RNode v0.7 includes breaking changes, the plan is to take down the current test nest and relaunch a test net using RNode v0.7 the week of Oct. 15.

RNode v0.7.1 is released! Please see https://developer.rchain.coop for installation information.

Here is an overview of what we'll be doing Oct. 12-23 to relaunch the RChain test net. More details are below and will be added as we near the time for the next genesis ceremony.

  • Oct. 19-21 - Test net validators and the administrator of the test net bootstrap node will shut down their nodes, remove RNode and clear relevant directories. Node operators will then upgrade to RNode v0.7 by Oct. 22 and wait for the genesis ceremony to start on Oct. 23. Please see https://developer.rchain.coop for installation information.
  • Oct. 23 - Start of the genesis ceremony. Unlike the ceremony done at RCon3, this ceremony will have a longer time threshold to allow validators to participate asynchronously. 

System requirements

Memory requirements

Run RChain software on a machine that has at least 16 GB of RAM, and preferably 32 GB RAM, to support node operation and participation in performance tests.

Network configuration

Please see RNode supported network configuration for information on configuring your network to connect to the RChain network. 

Prepare for the genesis ceremony

Please do the following by EOD Oct. 22.

  • Shut down your validating node(s) running on the RChain test net
  • Remove the RNode software and wipe your relevant data directories. 
  • Install the RNode v0.7 software. Please see https://developer.rchain.coop for installation information.
  • Note - There may be additional preparation steps added here. Kelly will post announcements to the #testnet_validators channel in discord when this page updates. You may also opt to "watch" this page to receive updates when content changes.

Updated Oct. 23 Genesis ceremony protocol

When?

This work will begin as part of the community node testing session scheduled for Oct. 23 at 14:00 UTC. If you do not plan to attend the session, you can still participate as a genesis validator. We will set the timer to 24 hours to allow as many of you as can to validate the genesis block. If you will not be at the test session, look for a notice in the #testnet-validators discord channel for a notice for when this page is updated with the bootstrap address so you can start the validation process.

What's different about this ceremony?

In general this ceremony is similar to the one you participated in at RCon3. There are a few differences:

  • Longer validation time period. In Berlin we set the clock to 30 minutes. For this ceremony we will set the clock to 24 hours since we won't all be together at the start of the ceremony.
  • Larger wallets file. In preparation for the REV issuance at the launch of Mercury, we will use the complete wallets file containing information about RHOC balances. This wallets file is larger than the one used in Sept. We notice in internal tests that it takes close to an hour for RNode to process. We agree this processing time is too long! Work is in progress to reduce the time required. However, for this launch of test net, you can expect the processing time of the genesis block to be close to an hour. 
  • Validation of the genesis block will take longer. Please see the information about the larger wallets file above. We expect your node to spend about an hour processing the genesis block. Do not expect the quick response you saw in Sept.

Instructions

  • Confirm you have the correct version RChain Node 0.7.1 (1977b934c9c77024539638ecd9d72e35c9b00048)
  • Clear your RNode data directory. The default data directory is .rnode
  • Overwrite your existing bonds file with the bonds file at https://repo.pyr8.io/rchain/downloads/misc/
  • Overwrite your existing wallets file with the rhoc_rev_balances file at https://repo.pyr8.io/rchain/downloads/misc/
  • Prepare your run command. Below is an example 
rnode run --bootstrap "rnode://8eb905149ee104ff8cd6f5f2197b1c78f23dc11c@52.119.8.200?protocol=40400&discovery=40404"
 --deploy-timestamp 1540233008903 --required-sigs 15 --bonds-file ~/20181023testnetGenesisBonds.txt --wallets-file ~/rhoc_rev_balances.txt --map_size 17179869184 --genesis-validator --validator-private-key <your private key>

  • Notes on the run command

    • Bootstrap is shown above.
    • Deploy-timestamp 1540233008903
    • Required-sigs 15
    • The path to your bonds file may be different depending on where you saved the file. Put the path to where you saved the file.
    • The path to your wallets file may be different depending on where you saved the file. Put the path to where you saved the file.
    • --map_size. This is new for this launch. You must specify the map_size, shown in bytes, at 16 GB.
    • --genesis-validator. This is the flag specifying you as a known validator.
    • Please use the private key you created and used when you helped launch test net in Sept. 
    • --thread-pool-size Due to updates in RNode v0.7, this specification is no longer needed
    • --timeout flag May be included if needed. If you used this previously, please use again. 
    • -J-XmxMemory setting May be included if needed. If you used previously, please use again. 
  • Report your node(s) IP address(s) - To support measuring network performance we need the IP address for each RNode you operate as a validator. Please use this form to report your IP address. If you operate more than one Rnode, please complete the form for each RNode you run.

Get help for operating RNode

Please use any of the channels below to get help operating RNode:



  • No labels