Corda Enterprise HA notary service set-up
The Corda Enterprise notary service can be configured in high-availability (HA) mode. For the Corda Enterprise notary service to operate in HA mode, a high-availability database is required. See Corda Enterprise notary service overview for more information.
Running an HA notary requires the following:
- JPA or MySQL notary implementations
- A database supported by the notary implementation, configured in high-availability mode
For a list of databases supported by each of the above notary implementations, please refer to the Platform support matrix
Before setting up an HA notary, your Corda Enterprise distribution should contain all the following
configuration information, and capabilities:
- The notary worker and database machines need to be configured to use reliable and trusted time servers. The time source has to be monotonic and support leap second smearing.
- Java runtime
- Corda Enterprise JAR
- Notary Health Check Tool
- HA Utilities JAR to run notary registration
- Root access to a Linux machine or VM to install the selected database
- The private IP addresses of your database hosts
- The public IP addresses of your notary hosts
- The database driver in the form of a
.JARfile, located inside the “drivers” folder
- The relevant HSM library
.JAR(if storing keys inside a HSM). See cryptoservice configuration for more information.
- Database root password, used to create the Corda user, setting up the database and tables (only required for some installation methods)
- Corda database user password, used by the notary service to access the database
- State snapshot transfer (SST) database user password, used by the Percona cluster for data replication
- Network root truststore password
- Node keystore password
- Network root truststore
- Notary worker configuration files
If you are setting up a local network to test the HA notary setup process, use the Network Bootstrapper instead of the Notary Registration Tool. In all other implementations, the network bootstrapper is not required.
Ensure that the notary worker P2P ports are reachable from any nodes that might join the network. Each notary worker also needs access to its individual node database, and communicates with the underlying database cluster using JDBC.
When writing the notary worker’s
node.conf file, the notary worker must have both a
myLegalName and a
myLegalName property must be unique to each notary worker, however, all notary workers in a cluster
must share the same
notary.serviceLegalName. For more information, see the ../corda-configuration-file.
HA Notary registration process
Before a HA notary cluster can be run each worker needs a valid certificate to join the network and the HA notary service must be included in the network parameters. The steps below assume the network includes an Identity Manager and Network Map, and that the above prerequisites have been met.
- Register the notary service identity
Before any workers can be started up the HA notary service identity must be registered with the network’s Identity Manager.
To register the notary service identity with the Identity Manager, run the notary registration tool using the the notary
The notary registration tool will generate the notary service key pair, and submit a corresponding certificate submission
request (CSR) to the Identity Manager, then poll until it receives a successful response. Once successful, a local
file will be created containing the key pair and certificate chain if using a local key store, or just the certificate
chain if using an HSM.
See notary registration for more information on using the notary registration tool.
- Register the notary workers
After the notary service is registered with the Identity Manager, each notary worker must be registered with the Identity Manager. This process is similar to registering a standard Corda Node, but the notary workers also require access to the notary service key and certificate.
.jks file created when registering the notary service identity, and create a copy in the
directory for each notary worker. If using a shared HA HSM, each notary worker must have a unique key alias to ensure
that there are no identity clashes between notary workers.
Register each notary worker using the Corda
initial-registration command. After registration, the notary worker
identity and node CA entries will be added to the
certificates/nodekeystore.jks store alongside the notary service
entry. If configured to use an HSM, the generated keys are stored in the HSM and not in the
- Add the notary service to the network parameters
In order for network participants to use the new HA notary the notary service must be present in the network parameters. This involves configuring and setting the initial network parameters (if setting up a new network), or modifying the existing parameters and performing a flag day (if using an existing network). Please refer to the CENM documentation for more information on this process.