Skip to content
This repository has been archived by the owner on Mar 8, 2020. It is now read-only.

Commit

Permalink
Fixes for Query and Dev tutorial (#2660)
Browse files Browse the repository at this point in the history
Signed-off-by: EdProsser <[email protected]>
  • Loading branch information
EdProsser authored and nklincoln committed Nov 9, 2017
1 parent 2ccc3c6 commit 5db25ff
Show file tree
Hide file tree
Showing 4 changed files with 176 additions and 703 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -70,36 +70,6 @@ _Please note_: If you export a Business Network Card that has never been used, f

**Important**: Exported identity cards should be handled with care since they contain unprotected credentials. We recommend that you only send identity cards that have been encrypted.


### Creating Business Network Card Credentials

It is possible to provide credentials to a user to enable them to create a Business Network Card and then use it to connect to the business network for which the credentials are valid.
1. From the **Business Networks** page, select an identity to use to connect to your business network. Click **Connect Now**. _Please note:_ You must use an identity that has permission to create new identities.

2. If required, create the participant to which you intend to assign the identity:
- click the **Test** tab, and click **Create New Participant**.
- complete the Participant defintion and click **Create New**.

<video autoplay "autoplay=autoplay" style="display:block; width:100%; height:auto;" loop="loop">
<source src="{{ site.baseurl }}/assets/img/tutorials/playground/vs_code_3.mp4" type="video/mp4" />
</video>

3. Click the name of your identity in the upper right, and click **ID Registry** within the drop down.

4. Click **+Issue New ID**.

5. Choose an **ID Name**, and input an existing **Participant** to associate the new identity with. A look-ahead service is provided to auto-complete on known Participants.

6. Click **Create New**.

7. Take note of the Enrollment ID and Secret that is displayed. It is essential to record this information before proceeding as it is this information that must be provided to a user to enable them to create their Business Network Card. Once you have recorded the Enrollment ID and Secret, click **OK**.

<video autoplay "autoplay=autoplay" style="display:block; width:100%; height:auto;" loop="loop">
<source src="{{ site.baseurl }}/assets/img/tutorials/playground/vs_code_4.mp4" type="video/mp4" />
</video>

8. Provide the Enrollment ID and Secret to the user that you wish to connect via the generated Enrollment ID. In addition to the Enrollment ID and Secret, they will need to know the name of the business network for which their identity is valid and the Connection Profile that enables conection to the runtime on which the target business network is deployed.

---

## <a name="gain"></a>Gaining Access To A Business Network
Expand Down Expand Up @@ -132,21 +102,6 @@ To create a Business Network Card from the **Business Networks** page using _cer

The Business Network Card should now be displayed in the **Business Networks** page.

A Business Network Card can be created using an ID and secret, through knowledge of the following: a _Enrollment ID_ and _Enrollment Secret_, generated by an admin of a business network; the _Business network name_ for which the credentials are valid; the _Connection Profile_ details for the runtime on which the target business network is deployed.

To create a Business Network Card from the **Business Networks** page using an _enrollment ID_ and _enrollment secret_:

1. After receiving an enrollment ID and enrollment secret, click the **Connect using credentials** button in the upper right of the **Business Networks** page.

2. If you have previously connected to the deployed runtime, select it from the displayed list, click **Next** and proceed to step 4; otherwise select the radio option to connect to a new Blockchain and click **Next**.

3. Specify the Connection Profile details that were provided to you and click **Save**.

4. Enter the _enrollment ID_, _enrollment secret_ and _business network name_, and click **Create**.

The Business Network Card should now be displayed in the **Business Networks** page.


### Manually Creating a Business Network Card

Business Network Cards are archive (`.zip`) files containing up to three elements:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -161,15 +161,15 @@ Deploying a business network to the {{site.data.conrefs.hlfv1}} requires the {{s

2. To deploy the business network, from the `tutorial-network` directory, run the following command:

composer network start --card PeerAdmin@hlfv1 --networkAdmin admin --networkAdminEnrollSecret adminpw --archiveFile [email protected] --file networkadmin
composer network start --card PeerAdmin@hlfv1 --networkAdmin admin --networkAdminEnrollSecret adminpw --archiveFile [email protected] --file networkadmin.card

The `composer network start` command requires a business network card, as well as the name of the admin identity for the business network, the file path of the `.bna` and the name of the file to be created ready to import as a business network card.

3. To import the network administrator identity as a usable business network card, run the following command:

composer card import --file networkadmin
composer card import --file networkadmin.card

The `composer card import` command requires the filename specified in `composer network start` to create a card.
The `composer card import` command requires the filename specified in `composer network start` to create a card.

4. To check that the business network has been deployed successfully, run the following command to ping the network:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ In this step by step tutorial we'll walk through setting up a business network,

## Step One: Open the {{site.data.conrefs.composer_full}} Playground

Open <a href="http://composer-playground.mybluemix.net" target="blank">{{site.data.conrefs.composer_short}} Playground</a>. You should see the **My Wallet** screen. The **My Wallet** page shows you a summary of the business networks you can connect to, and the identities you can use to connect to them. Don't worry about this too much for the time being, as we're going to create our own network.
Open <a href="http://composer-playground.mybluemix.net" target="blank">{{site.data.conrefs.composer_short}} Playground</a>. You should see the **My Business Network** screen. The **My Business Network** page shows you a summary of the business networks you can connect to, and the identities you can use to connect to them. Don't worry about this too much for the time being, as we're going to create our own network.

## Step Two: Creating a new business network

Expand Down Expand Up @@ -207,7 +207,7 @@ Now that we have two _Trader_ participants, we need something for them to trade.

Now that we have two _Traders_ and a _Commodity_ to trade between them, we can test our _Trade_ transaction.

Transactions are the basis of all change in a {{site.data.conrefs.composer_full}} business network, if you want to experiment with your own after this tutorial, try creating another business network from the **My Wallet** screen and using a more advanced business network template.
Transactions are the basis of all change in a {{site.data.conrefs.composer_full}} business network, if you want to experiment with your own after this tutorial, try creating another business network from the **My Business Network** screen and using a more advanced business network template.

To test the _Trade_ transaction:

Expand Down Expand Up @@ -236,9 +236,9 @@ To test the _Trade_ transaction:

## Logging out of the business network

Now that transactions have successfully run, we should log out of the business network, ending up at the **My Wallet** screen where we started.
Now that transactions have successfully run, we should log out of the business network, ending up at the **My Business Network** screen where we started.

1. In the upper-right of the screen is a button labelled **admin**. This lists your current identity, to log out, click **admin** to open the dropdown menu, and click **Log Out**.
1. In the upper-right of the screen is a button labelled **admin**. This lists your current identity, to log out, click **admin** to open the dropdown menu, and click **My Business Networks**.

## What next?

Expand Down
Loading

0 comments on commit 5db25ff

Please sign in to comment.