Merge pull request #96363 from PatAltimore/patricka-blockchain-screenshots

Blockchain freshness - screenshots, title, metadata

Author: GitHubber17

articles/blockchain/service/configure-transaction-nodes.md

@@ -5,24 +5,16 @@ services: azure-blockchain
 keywords: 
 author: PatAltimore
 ms.author: patricka
-ms.date: 05/02/2019
+ms.date: 11/20/2019
 ms.topic: article
 ms.service: azure-blockchain
-ms.reviewer: seal
+ms.reviewer: janders
 manager: femila
 #Customer intent: As a network operator, I want to use the Azure portal to create and configure transaction nodes.
 ---
 
 # Configure Azure Blockchain Service transaction nodes
 
-To interact with Azure Blockchain Service, you do so through connecting to one or more transaction nodes in your blockchain member.  In order to interact with transaction nodes, you will need to configure your nodes for access.
-
-## Prerequisites
-
-* [Create an Azure Blockchain member](create-member.md)
-
-## Transaction node overview
-
 Transaction nodes are used to send blockchain transactions to Azure Blockchain Service through a public endpoint. The default transaction node contains the private key of the Ethereum account registered on the blockchain, and as such cannot be deleted.
 
 To view the default transaction node details:
@@ -36,7 +28,7 @@ To view the default transaction node details:
 
 ## Create transaction node
 
-You can add up to nine additional transaction nodes to your blockchain member, for a total of ten transaction nodes. By adding transaction nodes, you can increase scalability or distribute load. For example, you could have a transaction node endpoint for different client applications.
+You can add up to nine additional transaction nodes to your blockchain member, for a total of 10 transaction nodes. By adding transaction nodes, you can increase scalability or distribute load. For example, you could have a transaction node endpoint for different client applications.
 
 To add a transaction node:
 
@@ -103,7 +95,7 @@ To use the URL, replace \<password\> with the password set when the node was pro
 
 ### Access keys
 
-For access key authentication, the access key is included in the endpoint URL. When the transaction node is provisioned, two access keys are generated. Either access key can be used for authentication. Two keys enable you change and rotate keys.
+For access key authentication, the access key is included in the endpoint URL. When the transaction node is provisioned, two access keys are generated. Either access key can be used for authentication. Two keys enable you to change and rotate keys.
 
 You can view a transaction node's access key details and copy endpoint addresses that include the access keys. Navigate to one of your Azure Blockchain Service member transaction nodes and select **Access Keys** in settings.
 
@@ -135,9 +127,9 @@ You can view a transaction node's connection strings and copy endpoint addresses
 
 Sample code is provided to quickly enable connecting to your transaction node via Web3, Nethereum, Web3js, and Truffle.
 
-You can view a transaction node's sample connection code and copy it to use with popular developer tools. Navigate to one of your Azure Blockchain Service member transaction nodes and select **Sample Code** in settings.
+You can view a transaction node's sample connection code and copy it to use with popular developer tools. Go to one of your Azure Blockchain Service member transaction nodes and select **Sample Code** in settings.
 
-Choose the Web3 or Nethereum tab to view the code sample you want to use.
+Choose the Web3, Nethereum, Truffle, or Web3j tab to view the code sample you want to use.
 
 ![Sample code](./media/configure-transaction-nodes/sample-code.png)
 

articles/blockchain/service/connect-geth.md

@@ -1,21 +1,21 @@
 ---
-title: Use Geth to connect to Azure Blockchain Service
-description: Connect to an Azure Blockchain Service network using Geth
+title: Use Geth to attach to Azure Blockchain Service
+description: Attach to a Geth instance on Azure Blockchain Service transaction node
 services: azure-blockchain
 keywords: 
 author: PatAltimore
 ms.author: patricka
-ms.date: 05/02/2019
+ms.date: 11/20/2019
 ms.topic: quickstart
 ms.service: azure-blockchain
-ms.reviewer: jackyhsu
+ms.reviewer: janders
 manager: femila
 #Customer intent: As a developer, I want to connect to my blockchain member transaction node so that I can perform actions on a blockchain.
 ---
 
-# Quickstart: Use Geth to connect to a transaction node
+# Quickstart: Use Geth to attach to an Azure Blockchain Service transaction node
 
-Geth is a Go Ethereum client you can use to attach to a Geth instance on an Azure Blockchain Service transaction node.
+In this quickstart, you use the Geth client to attach to a Geth instance on an Azure Blockchain Service transaction node. Once attached, you use the Geth JavaScript console to call a web3 JavaScript Dapp API.
 
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
 
@@ -24,46 +24,46 @@ Geth is a Go Ethereum client you can use to attach to a Geth instance on an Azur
 * Install [Geth](https://github.com/ethereum/go-ethereum/wiki/geth)
 * Complete [Quickstart: Create a blockchain member using the Azure portal](create-member.md) or [Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI](create-member-cli.md)
 
-## Get the Geth connection string
+## Get Geth connection string
 
-You can find the Geth connection string in the Azure portal.
+You can get the Geth connection string for an Azure Blockchain Service transaction node in the Azure portal.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. Navigate to your Azure Blockchain Service member. Select **Transaction nodes** and the default transaction node link.
+1. Go to your Azure Blockchain Service member. Select **Transaction nodes** and the default transaction node link.
 
     ![Select default transaction node](./media/connect-geth/transaction-nodes.png)
 
 1. Select **Connection strings**.
-1. Copy the connection string from **HTTPS (Access key 1)**. You need the command for the next section.
+1. Copy the connection string from **HTTPS (Access key 1)**. You need the string for the next section.
 
     ![Connection string](./media/connect-geth/connection-string.png)
 
 ## Connect to Geth
 
 1. Open a command prompt or shell.
-1. Use the Geth attach subcommand to attach to the running Geth instance on your transaction node. Paste the connection string as an argument for the attach subcommand. For example,
+1. Use the Geth attach subcommand to attach to the running Geth instance on your transaction node. Paste the connection string as an argument for the attach subcommand. For example:
 
-    ```
+    ``` bash
     geth attach <connection string>
     ```
 
 1. Once connected to the transaction node's Ethereum console, you can call the web3 JavaScript Dapp API or the admin API.
 
-    For example, Use the following API to find out the chainId.
+    For example, use the following API to find out the chainId.
 
-    ```bash
+    ``` bash
     admin.nodeInfo.protocols.istanbul.config.chainId
     ```
 
-    In this example, the chainId is 297.
+    In this example, the chainId is 661.
 
     ![Azure Blockchain Service option](./media/connect-geth/geth-attach.png)
 
 1. To disconnect from the console, type `exit`.
 
 ## Next steps
 
-In this quickstart, you used the Geth client to attach to a Geth instance on an Azure Blockchain Service transaction node. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
+In this quickstart, you used the Geth client to attach to a Geth instance on an Azure Blockchain Service transaction node. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum to create, build, deploy, and execute a smart contract function via a transaction.
 
 > [!div class="nextstepaction"]
-> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)
+> [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/connect-truffle.md

@@ -1,21 +1,21 @@
 ---
-title: Connect using Truffle
+title: Use Truffle to connect to Azure Blockchain Service
 description: Connect to an Azure Blockchain Service network using Truffle
 services: azure-blockchain
 keywords: 
 author: PatAltimore
 ms.author: patricka
-ms.date: 08/29/2019
+ms.date: 11/20/2019
 ms.topic: quickstart
 ms.service: azure-blockchain
-ms.reviewer: jackyhsu
+ms.reviewer: janders
 manager: femila
 #Customer intent: As a developer, I want to connect to my blockchain member node so that I can perform actions on a blockchain.
 ---
 
-# Quickstart: Use Truffle to connect to a transaction node
+# Quickstart: Use Truffle to connect to Azure Blockchain Service
 
-Truffle is a blockchain development environment you can use to connect to an Azure Blockchain Service transaction node.
+In this quickstart, you use Truffle connect to an Azure Blockchain Service transaction node. You then use the Truffle interactive console to call **web3** methods to interact with your blockchain network.
 
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
 
@@ -54,12 +54,15 @@ Truffle is a blockchain development environment you can use to connect to an Azu
 
 To configure the Truffle project, you need some transaction node information from the Azure portal.
 
-### Transaction node endpoint addresses
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. Go to your Azure Blockchain Service member. Select **Transaction nodes** and the default transaction node link.
 
-1. In the Azure portal, navigate to the default transaction node and select **Transaction nodes > Connection strings**.
-1. Copy and save the endpoint URL from **HTTPS (Access key 1)**. You need the endpoint addresses for the smart contract configuration file later in the tutorial.
+    ![Select default transaction node](./media/connect-truffle/transaction-nodes.png)
 
-    ![Transaction endpoint address](./media/connect-truffle/endpoint.png)
+1. Select **Connection strings**.
+1. Copy the connection string from **HTTPS (Access key 1)**. You need the string for the next section.
+
+    ![Connection string](./media/connect-truffle/connection-string.png)
 
 ### Edit configuration file
 
@@ -96,7 +99,7 @@ Use *Web3* to connect to the transaction node.
 
     Truffle connects to the default transaction node and provides an interactive console.
 
-    You can call methods on the **web3** object to interact with your transaction node.
+    You can call methods on the **web3** object to interact with your blockchain network.
 
 1. Call the **getBlockNumber** method to return the current block number.
 
@@ -118,9 +121,9 @@ Use *Web3* to connect to the transaction node.
 
 ## Next steps
 
-In this quickstart, you created a Truffle project to connect to your Azure Blockchain Service default transaction node.
+In this quickstart, you used Truffle connect to an Azure Blockchain Service default transaction node and used the interactive console to return the current blockchain block number.
 
-Try the next tutorial to use Azure Blockchain Development Kit for Ethereum and Truffle to create, build, deploy, and execute a smart contract function via a transaction.
+Try the next tutorial to use Azure Blockchain Development Kit for Ethereum to create, build, deploy, and execute a smart contract function via a transaction.
 
 > [!div class="nextstepaction"]
 > [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/connect-vscode.md

@@ -1,11 +1,11 @@
 ---
-title: Use Visual Studio Code to connect to an Azure Blockchain Service consortium network
+title: Use Visual Studio Code to connect to Azure Blockchain Service
 description: Connect to an Azure Blockchain Service consortium network using the Azure Blockchain Development Kit for Ethereum extension in Visual Studio Code
 services: azure-blockchain
 keywords: 
 author: PatAltimore
 ms.author: patricka
-ms.date: 11/18/2019
+ms.date: 11/19/2019
 ms.topic: quickstart
 ms.service: azure-blockchain
 ms.reviewer: chrisseg
@@ -32,7 +32,7 @@ In this quickstart, you install and use the Azure Blockchain Development Kit for
 
 On Windows, an installed C++ compiler is required for the node-gyp module. You can use the MSBuild tools:
 
-* If Visual Studio 2017 is installed, configure npm to use the MSBuild tools using the command `npm config set msvs_version 2017 -g`
+* If Visual Studio 2017 is installed, configure npm to use the MSBuild tools with the command `npm config set msvs_version 2017 -g`
 * If Visual Studio 2019 is installed, set the MS build tools path for npm. For example, `npm config set msbuild_path "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\MSBuild.exe"`
 * Otherwise, install the stand-alone VS Build tools using `npm install --global windows-build-tools` in an elevated *Run as administrator* command shell.
 
@@ -76,7 +76,7 @@ The consortium and blockchain members are listed in the Visual Studio explorer s
 
 ## Next steps
 
-In this quickstart, you used Azure Blockchain Development Kit for Ethereum Visual Studio Code extension to attach to a consortium on Azure Blockchain Service. Try a tutorial to use Azure Blockchain Development Kit for Ethereum to create, build, deploy, and execute a smart contract function.
+In this quickstart, you used Azure Blockchain Development Kit for Ethereum Visual Studio Code extension to attach to a consortium on Azure Blockchain Service. Try the next tutorial to use Azure Blockchain Development Kit for Ethereum to create, build, deploy, and execute a smart contract function via a transaction.
 
 > [!div class="nextstepaction"]
 > [Use Visual Studio Code to create, build, and deploy smart contracts](send-transaction.md)

articles/blockchain/service/create-member-cli.md

@@ -1,21 +1,21 @@
 ---
-title: Create an Azure Blockchain Service using Azure CLI
-description: Use Azure Blockchain Service to create a blockchain member using Azure CLI.
+title: Create an Azure Blockchain Service member - Azure CLI
+description: Create an Azure Blockchain Service member for a blockchain consortium using the Azure CLI.
 services: azure-blockchain
 keywords: 
 author: PatAltimore
 ms.author: patricka
-ms.date: 05/29/2019
+ms.date: 11/20/2019
 ms.topic: quickstart
 ms.service: azure-blockchain
-ms.reviewer: seal
+ms.reviewer: janders
 manager: femila
 #Customer intent: As a network operator, I want use Azure Blockchain Service so that I can create a blockchain member on Azure
 ---
 
 # Quickstart: Create an Azure Blockchain Service blockchain member using Azure CLI
 
-Azure Blockchain Service is a blockchain platform you can use to execute your business logic within a smart contract. This quickstart shows you how to get started by creating a blockchain member using Azure CLI.
+In this quickstart, you deploy a new blockchain member and consortium in Azure Blockchain Service using Azure CLI.
 
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
 
@@ -32,22 +32,29 @@ If you prefer to install and use the CLI locally, this quickstart requires Azure
 Create a resource group with the [az group create](https://docs.microsoft.com/cli/azure/group) command. An Azure resource group is a logical container into which Azure resources are deployed and managed. The following example creates a resource group named *myResourceGroup* in the *eastus* location:
 
 ```azurecli-interactive
-az group create --name myResourceGroup --location eastus
+az group create \
+                 --name myResourceGroup \
+                 --location westus2
 ```
 
 ## Create a blockchain member
 
 Create a blockchain member in Azure Blockchain Service that runs the Quorum ledger protocol in a new consortium. There are several parameters and properties you need to pass. Replace the example parameters with your values.
 
 ```azurecli-interactive
-az resource create --resource-group myResourceGroup --name myblockchainmember --resource-type Microsoft.Blockchain/blockchainMembers --is-full-object --properties "{ \"location\": \"eastus\", \"properties\": {\"password\": \"strongMemberAccountPassword@1\", \"protocol\": \"Quorum\", \"consortium\": \"myConsortiumName\", \"consortiumManagementAccountPassword\": \"strongConsortiumManagementPassword@1\" }, \"sku\": { \"name\": \"S0\" } }"
+az resource create \
+                    --resource-group myResourceGroup \
+                    --name myblockchainmember \
+                    --resource-type Microsoft.Blockchain/blockchainMembers \
+                    --is-full-object \
+                    --properties '{"location":"westus2", "properties":{"password":"strongMemberAccountPassword@1", "protocol":"Quorum", "consortium":"myConsortiumName", "consortiumManagementAccountPassword":"strongConsortiumManagementPassword@1"}, "sku":{"name":"S0"}}'
 ```
 
 | Parameter | Description |
 |---------|-------------|
 | **resource-group** | Resource group name where Azure Blockchain Service resources are created. Use the resource group you created in the previous section.
 | **name** | A unique name that identifies your Azure Blockchain Service blockchain member. The name is used for the public endpoint address. For example, `myblockchainmember.blockchain.azure.com`.
-| **location** | Azure region where the blockchain member is created. For example, `eastus`. Choose the location that is closest to your users or your other Azure applications.
+| **location** | Azure region where the blockchain member is created. For example, `westus2`. Choose the location that is closest to your users or your other Azure applications.
 | **password** | The password for the member's default transaction node. Use the password for basic authentication when connecting to blockchain member's default transaction node public endpoint.
 | **consortium** | Name of the consortium to join or create.
 | **consortiumAccountPassword** | The consortium account password is also known as the member account password. The member account password is used to encrypt the private key for the Ethereum account that is created for your member. You use the member account and member account password for consortium management.
@@ -62,12 +69,14 @@ You can use the blockchain member you created for the next quickstart or tutoria
 Run the following command to remove the resource group and all related resources.
 
 ```azurecli-interactive
-az group delete --name myResourceGroup --yes
+az group delete \
+                 --name myResourceGroup \
+                 --yes
 ```
 
 ## Next steps
 
-Now that you have created a blockchain member, try one of the connection quickstarts for [Geth](connect-geth.md), [MetaMask](connect-metamask.md), or [Truffle](connect-truffle.md).
+In this quickstart, you deployed an Azure Blockchain Service member and a new consortium. Try the next quickstart to use  Azure Blockchain Development Kit for Ethereum to attach to a consortium on Azure Blockchain Service.
 
 > [!div class="nextstepaction"]
-> [Use Truffle to connect to a an Azure Blockchain Service network](connect-truffle.md)
+> [Use Visual Studio Code to connect to an Azure Blockchain Service consortium network](connect-vscode.md)