Skip to content

Latest commit

 

History

History
77 lines (64 loc) · 2.48 KB

upgrade.md

File metadata and controls

77 lines (64 loc) · 2.48 KB
Raw

Upgrade Notes

From Ravencore 3.0.0 to 4.0.0

ravencore-node@2.1.1 to ravencore-node@3.0.0

This major upgrade includes changes to indexes, API methods and services. Please review below details before upgrading.

Indexes

Indexes include more information and are now also faster. Because of this a reindex will be necessary when upgrading as the address and database indexes are now a part of ravend with three new raven.conf options:

  • -addressindex
  • -timestampindex
  • -spentindex

To start reindexing add reindex=1 during the first startup only.

Configuration Options

  • The raven.conf file in will need to be updated to include additional indexes (see below).
  • The datadir option is now a part of ravend spawn configuration, and there is a new option to connect to multiple ravend processes (Please see Ravencoin Service Docs for more details). The services db and address are now a part of the ravend service. Here is how to update ravencore-node.json configuration options:

Before:

{
  "datadir": "/home/<username>/.raven",
  "network": "livenet",
  "port": 3001,
  "services": [
    "address",
    "ravend",
    "db",
    "web"
  ]
}

After:

{
  "network": "livenet",
  "port": 3001,
  "services": [
    "ravend",
    "web"
  ],
  "servicesConfig": {
    "ravend": {
      "spawn": {
        "datadir": "/home/<username>/.raven",
        "exec": "/home/<username>/ravencore-node/bin/ravend"
      }
    }
  }
}

It will also be necessary to update raven.conf settings, to include these fields:

server=1
whitelist=127.0.0.1
txindex=1
addressindex=1
timestampindex=1
spentindex=1
zmqpubrawtx=tcp://127.0.0.1:<port>
zmqpubhashblock=tcp://127.0.0.1:<port>
rpcallowip=127.0.0.1
rpcuser=<user>
rpcpassword=<password>

Important: Once changes have been made you'll also need to add the reindex=1 option only for the first startup to regenerate the indexes. Once this is complete you should be able to remove the ravencore-node.db directory with the old indexes.

API and Service Changes

  • Many API methods that were a part of the db and address services are now a part of the ravend service. Please see Ravencoin Service Docs for more details.
  • The db and address services are deprecated, most of the functionality still exists. Any services that were extending indexes with the db service, will need to manage chain state itself, or build the indexes within ravend.