Setting Up A Notary Node

Purpose

A notary node is a well known and trusted node that provides uniqueness consensus. Because of this, creating and running a notary node is slightly more involved compared with a regular node.

The network map service broadcasts information (stored in the network parameters file) that every participant in the network needs to agree on. One piece of information is the list of notaries. Because all notaries within this list need to be well known and trusted, the process of adding a new one requires some manual intervention on the network map service side.

Configuration

The exact configuration will depend on the Corda version that the notary node is running.

Example Configuration

myLegalName="O=Example Notary,L=London,C=GB"
notary {
    validating=false
}

networkServices {
  doormanURL="http://<IDENTITY_MANAGER_HOST>:<IDENTITY_MANAGER_PORT>"
  networkMapURL="http://NETWORK_MAP_SERVICE_HOST>:<NETWORK_MAP_SERVICE_PORT>"
}

devMode = false

sshd {
  port = <SSH_PORT>
}

p2pAddress="<NOTARY_HOST>:<NOTARY_PORT>"

Initial Setup

The steps to integrate the notary node into the network are:

  • Register the node with the Identity Manager
  • Generate the node info file
  • Copy the node info file to the network map service
  • Update the network parameters file on the network map service to reference the new node info file
  • Start (or restart) the network map service
  • Start the notary node as normal

Create Notary Node And Register With The Identity Manager

Ensuring that the Identity Manager service is successfully running, start the notary node for registration.

java -jar corda.jar --config-file <NODE_CONF_FILE> --initial-registration --network-root-truststore-password <TRUST_STORE_PASSWORD> --network-root-truststore <PATH_TO_TRUST_STORE>

Generate Node Info File

The node info file contains information such as address and certificates. The file will be used by all participants on the network to enable them to connect to, and trust, the new notary node.

java -jar corda.jar --config-file <NODE_CONF_FILE> --just-generate-node-info

Setup Network Map Service

Follow instructions here Network Map Service

Run The Notary

java -jar corda.jar --config-file <NODE_CONF_FILE>