Node configuration¶
File location¶
The Corda all-in-one corda.jar
file is generated by the gradle buildCordaJAR
task and defaults to reading configuration
from a node.conf
file in the present working directory. This behaviour can be overidden using the --config-file
command line option to target configuration files with different names, or different file location (relative paths are
relative to the current working directory). Also, the --base-directory
command line option alters the Corda node
workspace location and if specified a node.conf
configuration file is then expected in the root of the workspace.
The configuration file templates used for the gradle deployNodes
task are to be found in the /config/dev
folder.
Also note that there is a basic set of defaults loaded from the built in resource file /node/src/main/resources/reference.conf
of the :node
gradle module. All properties in this can be overidden in the file configuration and for rarely changed
properties this defaulting allows the property to be excluded from the configuration file.
Format¶
The Corda configuration file uses the HOCON format which is superset of JSON. It has several features which makes it very useful as a configuration format. Please visit their page for further details.
Examples¶
General node configuration file for hosting the IRSDemo services.
myLegalName : "Bank A"
nearestCity : "London"
keyStorePassword : "cordacadevpass"
trustStorePassword : "trustpass"
dataSourceProperties : {
dataSourceClassName : org.h2.jdbcx.JdbcDataSource
"dataSource.url" : "jdbc:h2:file:"${basedir}"/persistence"
"dataSource.user" : sa
"dataSource.password" : ""
}
artemisAddress : "my-corda-node:10002"
webAddress : "localhost:10003"
extraAdvertisedServiceIds: "corda.interest_rates"
networkMapService : {
address : "my-network-map:10000"
legalName : "Network Map Service"
}
useHTTPS : false
rpcUsers : [
{ user=user1, password=letmein, permissions=[ StartProtocol.net.corda.protocols.CashProtocol ] }
]
devMode : true
// Certificate signing service will be hosted by R3 in the near future.
//certificateSigningService : "https://testnet.certificate.corda.net"
NetworkMapService plus Simple Notary configuration file.
myLegalName : "Notary Service"
nearestCity : "London"
keyStorePassword : "cordacadevpass"
trustStorePassword : "trustpass"
artemisAddress : "localhost:12345"
webAddress : "localhost:12346"
extraAdvertisedServiceIds: ""
useHTTPS : false
devMode : true
// Certificate signing service will be hosted by R3 in the near future.
//certificateSigningService : "https://testnet.certificate.corda.net"
Fields¶
The available config fields are listed below. basedir
is available as a substitution value, containing the absolute
path to the node’s base directory.
myLegalName: | The legal identity of the node acts as a human readable alias to the node’s public key and several demos use this to lookup the NodeInfo. |
||||||
---|---|---|---|---|---|---|---|
nearestCity: | The location of the node as used to locate coordinates on the world map when running the network simulator demo. See Network Simulator. |
||||||
keyStorePassword: | |||||||
The password to unlock the KeyStore file ( Note This is the non-secret value for the development certificates automatically generated during the first node run. Longer term these keys will be managed in secure hardware devices. |
|||||||
trustStorePassword: | |||||||
The password to unlock the Trust store file ( Note Longer term these keys will be managed in secure hardware devices. |
|||||||
dataSourceProperties: | |||||||
This section is used to configure the jdbc connection and database driver used for the nodes persistence.
Currently the defaults in |
|||||||
artemisAddress: | The host and port on which the node is available for protocol operations over ArtemisMQ. Note In practice the ArtemisMQ messaging services bind to all local addresses on the specified port. However, note that the host is the included as the advertised entry in the NetworkMapService. As a result the value listed here must be externally accessible when running nodes across a cluster of machines. |
||||||
messagingServerAddress: | |||||||
The address of the ArtemisMQ broker instance. If not provided the node will run one locally. |
|||||||
webAddress: | The host and port on which the bundled webserver will listen if it is started. Note If HTTPS is enabled then the browser security checks will require that the accessing url host name is one
of either the machine name, fully qualified machine name, or server IP address to line up with the Subject Alternative
Names contained within the development certificates. This is addition to requiring the Note The driver will not automatically create a webserver instance, but the Cordformation will. If this field is present the web server will start. |
||||||
extraAdvertisedServiceIds: | |||||||
A list of ServiceType id strings to be advertised to the NetworkMapService and thus be available
when other nodes query the NetworkMapCache for supporting nodes. This can also include plugin services loaded from .jar
files in the plugins folder. Optionally, a custom advertised service name can be provided by appending it to the service
type id: |
|||||||
notaryNodeAddress: | |||||||
The host and port to which to bind the embedded Raft server. Required only when running a distributed notary service. A group of Corda nodes can run a distributed notary service by each running an embedded Raft server and joining them to the same cluster to replicate the committed state log. Note that the Raft cluster uses a separate transport
|
|||||||
notaryClusterAddresses: | |||||||
List of Raft cluster member addresses used to join the cluster. At least one of the specified members must be active and be able to communicate with the cluster leader for joining. If empty, a new cluster will be bootstrapped. Required only when running a distributed notary service. |
|||||||
networkMapService: | |||||||
If null, or missing the node is declaring itself as the NetworkMapService host. Otherwise this is a config object with the details of the network map service:
|
|||||||
useHTTPS: | If false the node’s web server will be plain HTTP. If true the node will use the same certificate and private
key from the |
||||||
rpcUsers: | A list of users who are authorised to access the RPC system. Each user in the list is a config object with the following fields:
If this field is absent or an empty list then RPC is effectively locked down. |
||||||
devMode: | This flag indicate if the node is running in development mode. On startup, if the keystore |
||||||
certificateSigningService: | |||||||
Certificate Signing Server address. It is used by the certificate signing request utility to obtain SSL certificate. (See Network permissioning for more information.) |