Using the Node Explorer to test a Corda Enterprise node on Corda Testnet
This document will explain how to test the installation of a Corda Enterprise node on Corda Testnet.
This guide assumes you have deployed a Corda Enterprise node to either Azure or AWS using one of:
It also assumes your node is provisioned and connected to the Corda Testnet although the instructions below should work for any Corda Enterprise node connected to any Corda network.
Get the testing tools
To run the tests and make sure your node is connecting correctly to the network you will need to download and install a couple of resources.
- Log into your Cloud VM via SSH.
- Stop the Corda node(s) running on your cloud instance.
sudo systemctl stop corda
- Download the resources: download the finance CorDapp and database manager to your VM instance:
This is required to run some flows to check your connections, and to issue/transfer cash to counterparties. Copy it to the Corda installation location:
sudo cp /home/<USER>/corda-finance-*-4.3.jar /opt/corda/cordapps/
- Create a symbolic link to the shared database driver folder
sudo ln -s /opt/corda/drivers /opt/corda/plugins
- Execute the database migration. This is required so that the node database has the right schema for finance transactions defined in the installed CorDapp.
cd /opt/corda sudo java -jar /home/<USER>/corda-tools-database-manager-4.3.jar --base-directory /opt/corda --execute-migration
- Run the following to create a config file for the finance CorDapp:
echo "issuableCurrencies = [ USD ]" > /opt/corda/cordapps/config/corda-finance-4.3.conf
- Restart the Corda node:
sudo systemctl start corda
Your node is now running the Finance Cordapp.
/opt/corda/logs/node-<VM-NAME>.log. This file will list installed apps at startup. Search for
Loaded CorDappsin the logs.
- Now download the Node Explorer to your LOCAL machine:
- Run the Node Explorer tool on your LOCAL machine.
java -jar corda-tools-explorer-4.3.jar
Connect to the node
To connect to the node you will need:
- The IP address of your node (the public IP of your cloud instance). You can find this in the instance page of your cloud console.
- The port number of the RPC interface to the node, specified in
rpcSettingssection, (by default this is 10003 on Testnet).
- The username and password of the RPC interface of the node, also in the
rpcUserssection, (by default the username is
Connect to log into the node.
Check your network identity and counterparties
Once Explorer has logged in to your node over RPC click on the
Network tab in the side navigation of the Explorer UI:
If your Enterprise node is correctly configured and connected to the Testnet then you should be able to see the identities of your node, the Testnet notary and the network map listing all the counterparties currently on the network.
Test issuance transaction
Now we are going to try and issue some cash to a ‘bank’. Click on the
Now click on
New Transaction and create an issuance to a known counterparty on the network by filling in the form:
Execute and the transaction will start.
Click on the red X to close the notification window and click on
Transactions tab to see the transaction in progress,
or wait for a success message to be displayed:
Congratulations! You have now successfully installed a CorDapp and executed a transaction on the Corda Testnet.