View source for Deploying the Microsoft Azure Ardor Node

<languages />
<translate>
{{#seo:
|title=Deploying the Microsoft Azure Ardor Node
|titlemode=replace
|keywords=Microsoft Azure, Marketplace, Ardor node app, ardor documentation, blockchain, proof of stake, ardor, ignis, jelurida, development, ardor wiki, wiki, tutorials, advanced tutorials
|description=Detailed explanation step by step for setting up the Azure Ardor node
}}
[[Category:Advanced_guides]]
__TOC__
== Introduction ==
The Azure Ardor node allows us to launch an Ardor node, and to provision automatically the node database. It uses as an internal component the [[Deploying_the_Ardor_Node_Docker_Image|Ardor Docker image]]. To complete this tutorial, basic knowledge of Microsoft Azure is desirable. Microsoft has an extensive [https://docs.microsoft.com/en-us/learn/paths/azure-fundamentals/ documentation and learning paths].


== How to deploy de Ardor Azure app ==

The steps to deploy the Azure Ardor node are as follows:
 
* [https://azure.microsoft.com/en-us/free/ Create an Azure account]
* Open the Azure Marketplace where the Ardor Node is located: [https://azuremarketplace.microsoft.com/en-us/marketplace/apps/jeluridaswisssa1593343357987.ardor01 Azure Marketplace - Ardor]:

[[File:Azure app - Marketplace - 1.png|class=img-responsive|center|border|Azure Ardor app]]


* Once these main steps described above are completed, click on the "Get it now" button, and the following image will pop-up

[[File:Azure app - Marketplace - 2.png|class=img-responsive|center|border|Create this app in Azure]]


* Afterwards, the image as follows will appear:

[[File:Azure app 3.png|class=img-responsive|center|border|Create button]]


Click on the "Create" button:

[[File:Azure app - Marketplace - 4.png|class=img-responsive|center|border|Create Ardor Node]]


* Configure the Subscription, select or create the Resource group to deploy the Ardor components, and the region where the components will be deployed.


[[File:Azure app - Marketplace - 5.png|class=img-responsive|center|border|Create Ardor Node]]


* Provide the Ardor Node Configuration:

[[File:Azure app - Marketplace - 5B.png|class=img-responsive|center|border|Create Ardor Node]]


* '''Password''': it refers to the [[API#Admin_Password|Admin Password]] of the node.
* '''Confirm Password''': it must be the same as the field Password.
* '''Select Mainnet or Testnet''': mark the option Mainnet for an Ardor mainnet node, or Testnet for an Ardor testnet node.
* '''DNS Label for the Ardor node''': The Azure fully qualified domain name will be formed by the DNS label plus the container location. For instance, the DNS 'Ardor' deployed in the 'Northern Europe' region will be: ''ardor.northeurope.azurecontainer.io''
* '''Number of CPUs''': 1 CPU is enough to run the Ardor node, this value can be increased in case parallelism is required 
* '''Memory in GB''': 1 GB is enough to run the Ardor node, this value can be increased if needed, for instance when forging with a large amount of ARDR tokens.

* Review + create. Click on the "Create" button, as shown below:

[[File:Azure app 6.png|class=img-responsive|center|border|Review and Create Ardor Node]]


Once clicked, the deployment will start:


[[File:Azure app - Marketplace - 7 Deployment.png|class=img-responsive|center|border|Deployment in progress]]


[[File:Azure app - Marketplace - 8 Deployment complete.png|center|border|600px|Deployment finished]]


The first execution takes slightly more time due to the provisioning of the node. When all these steps are completed, the node is ready to be accessed:

[[File:Azure app - Marketplace - 11 Ardor node up.png|class=img-responsive|center|border|Ardor node up]]


=== Walk-through of the components deployed ===

The docker container and the storage account can be accessed through the resource group:

[[File:Azure app - Marketplace - 9 Resources.png|class=img-responsive|center|border|Deployment finished]]


==== Container ====


[[File:Azure app - Marketplace - 10 Container.png|class=img-responsive|center|border|Deployment finished]]


==== File Shares ====


[[File:Azure app - Marketplace - 17 File shares.png|class=img-responsive|center|border|Deployment finished]]


== Costs ==

The pricing is the cost of the deployed components which are:
* A docker container. The pricing is explained in the link as follows: [https://azure.microsoft.com/en-us/pricing/details/container-instances/ Container costs]
* A storage account, that will have 3 File Shares once created. [https://azure.microsoft.com/en-us/pricing/details/storage/ Storage costs].

== How to change Ardor parameters after the deployment ==

The docker container internal files are not accessible, hence you can either change the nxt.properties file by accessing to the file shared 'ardorconf' and editing the file directly, or by using the Node Configuration as shown as follows:

First, you have to provide the admin password:


[[File:Azure app - Marketplace - 12 Change parameters.png|class=img-responsive|center|border|Node Configuration]]


[[File:Azure app - Marketplace - 13 Change parameters.png|class=img-responsive|center|border|Node Configuration]]


Log in again, and the parameters will be available to be modified:

[[File:Azure app - Marketplace - 14 Change parameters.png|class=img-responsive|center|border|Node Configuration]]


For instance, to modify the nxt.apiSSL parameter, select it and click on change:

[[File:Azure app - Marketplace - 15 Change parameters.png|class=img-responsive|center|border|Node Configuration]]


After the modification, a restart of the node is needed. Click on the "Save and Shutdown" button:

[[File:Azure app - Marketplace - 16 Change parameters.png|class=img-responsive|center|border|Node Configuration]]


The final step is to execute again the container:

[[File:Azure app - Marketplace - 18 Restart.png|class=img-responsive|center|border|Node Configuration]]

</translate>