Skip to content

Commit f06eb9e

Browse files
committed
Updated migration docs for abw to add images
1 parent b424e7c commit f06eb9e

16 files changed

Lines changed: 34 additions & 2 deletions

migration/abw-migration.md

Lines changed: 34 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,36 +6,66 @@ With the deprecation of Azure Blockchain Service, users of the Azure Blockchain
66

77
Migration from ABS to QBS or another Quorum stack is considered a supported scenario, however it will require some work of the user as the settings to reconfigure Azure Blockchain Workbench are internal to the service. The steps to perform this are:
88

9-
1. First, request the export of the blockchain data from the Azure Blockchain Service instance. Once the export is completed, the new instance of Quorum needs to be created and running.
9+
1. First, request the [export](https://docs.microsoft.com/en-us/azure/blockchain/service/migration-guide#export-data-from-azure-blockchain-service) of the blockchain data from the Azure Blockchain Service instance. Once the export is completed, the new instance of Quorum needs to be created and running.
1010

1111
2. Next, open the Azure portal to the resource group containing the Azure Blockchain Workbench deployed resources.
1212

13+
![Resource group view](media/resource-group.png)
14+
1315
3. Click on the SQL database, there should be only one.
1416

17+
![Sql database](media/sql.png)
18+
1519
4. Click on Query Editor.
1620

21+
![Query database](media/query.png)
22+
1723
5. Enter you DB username / password that was used to deploy the resources initially. `NOTE: You may need to whitelist the Azure IP for access.`
1824

25+
![SQL login](media/sqllogin.png)
26+
1927
6. Run the following command to view the Connections to ledgers. `SELECT * FROM [dbo].[Connection]`
2028

29+
![SQL Query run](media/queryrun.png)
30+
2131
7. Now update the update the connection with the new RPC endpoint. `UPDATE [dbo].[Connection] SET EndPointURL = <your new rpc endpoint> WHERE Id = <id of connection>`
2232

33+
![SQL update run](media/queryupdaterun.png)
34+
2335
8. Now navigate back to the resource group and open the Azure Key Vault resource.
2436

37+
![Azure Key Vault](media/keyvault.png)
38+
2539
9. Add your AAD profile to the Access Policies.
2640

41+
![Key vault access policy](media/accesspolicy.png)
42+
2743
10. Select `SET, GET, LIST` under Secrets for access.
2844

29-
11. Click Save.
45+
![Key vault secret permissions](media/perms.png)
46+
47+
11. Click Add and then Save.
48+
49+
![Save secret policies](media/save.png)
3050

3151
12. Click on Secrets.
3252

53+
![Secrets](media/secrets.png)
54+
3355
13. Click on `blockchainRpcConnectionString` secret.
3456

57+
![Blockchain connection secret](media/secrets2.png)
58+
3559
14. Click add new version.
3660

61+
![Add new secret version](media/createSecretVersion.png)
62+
3763
15. Paste the new RPC endpoint in the secret and save.
3864

65+
16. Restart the VMSS nodes.
66+
67+
![Restart VMSS](media/restart.png)
68+
3969
## Option 2 - Creating a new Azure Blockchain Workbench instance, connecting to a migrated ABS instance (easy)
4070

4171
Another option is to create a new instance of Azure Blockchain Workbench, connected to the migrated of Quorum either via QBS or manually. The steps to perform this are:
@@ -44,6 +74,8 @@ Another option is to create a new instance of Azure Blockchain Workbench, connec
4474

4575
2. Next, create a new instance of Azure Blockchain Workbench and in the advanced settings use the RPC endpoint of the Quorum node created in step 1.
4676

77+
![Workbench custom rpc endpoint](media/workbench.png)
78+
4779
```
4880
The ability to attach an existing ABW instance to a new blockchain ledger is not supported
4981
```

migration/media/accesspolicy.png

41.8 KB
Loading
35.8 KB
Loading

migration/media/keyvault.png

46.1 KB
Loading

migration/media/perms.png

45.3 KB
Loading

migration/media/query.png

103 KB
Loading

migration/media/queryrun.png

53.3 KB
Loading

migration/media/queryupdaterun.png

41.5 KB
Loading

migration/media/resource-group.png

166 KB
Loading

migration/media/restart.png

48.6 KB
Loading

0 commit comments

Comments
 (0)