Deploying Corda to Corda Testnet from an Azure Cloud Platform VM
This document will describe how to set up a virtual machine on the Azure Cloud Platform to deploy your pre-configured Corda node and automatically connnect to Testnet. A self-service download link can be obtained from https://marketplace.r3.com/network/testnet.
- Ensure you have a registered Microsoft Azure account which can create virtual machines.
Deploy Corda node
Browse to https://portal.azure.com and log in with your Microsoft account.
STEP 1: Create a Resource Group
Click on the “Resource groups” link in the side nav in the Azure Portal and then click “Add”:
Fill in the form and click “Create”:
STEP 2: Launch the VM
At the top of the left sidenav click on the button with the green cross “Create a resource”.
In this example we are going to use an Ubuntu server so select the latest Ubuntu Server option:
Fill in the form:
- Add a username (to log into the VM) and choose and enter a password
- Choose the resource group we created earlier from the “Use existing” dropdown
- Select a cloud region geographically near to your location to host your VM
Click on “OK”:
Choose a size (“D4S_V3 Standard” is recommended if available) and click “Select”:
Click on “Public IP address” to open the “Settings” panel
Set the IP address to “Static” under “Assignment” and click “OK”:
Add the following inbound rules for ports 8080 (webserver), and 10002-10003 for the P2P and RPC ports used by the Corda node respectively:
Destination port ranges: 10002, Priority: 1041 Name: Port_10002 Destination port ranges: 10003, Priority: 1042 Name: Port_10003 Destination port ranges: 8080, Priority: 1043 Name: Port_8080 Destination port ranges: 22, Priority: 1044 Name: Port_22
Click “Create” and wait a few minutes for your instance to be provisioned and start running:
STEP 3: Connect to your VM and set up the environment
Once your instance is running click on the “Connect” button and copy the ssh command:
Enter the ssh command into your terminal. At the prompt, type “yes” to continue connecting and then enter the password you configured earlier to log into the remote VM:
STEP 4: Download and set up your Corda node
Now that your Azure environment is configured you can switch to the Testnet dashboard and click “Copy” to get a one-time installation script.
sudo ONE_TIME_DOWNLOAD_KEY=YOUR_UNIQUE_DOWNLOAD_KEY_HERE bash -c "$(curl -L https://onboarder.prod.ws.r3.com/api/user/node/TESTNET/install.sh)"
You can follow the progress of the installation by typing the following command in your terminal:
tail -f /opt/corda/logs/node-<VM-NAME>.log
Testing your deployment
To test that your deployment is working correctly, follow the instructions in Using the Node Explorer to test a Corda node on Corda Testnet to set up the Finance CorDapp and issue cash to a counterparty.
This will also demonstrate how to install a custom CorDapp.