Skip to main content

Creating Fabric nodes

In this tutorial, we will walk through the process of creating blockchain nodes using the ChainLaunch platform. This step-by-step guide is designed to help users who may be unfamiliar with the interface or the overall process of node creation.

Introduction​

Creating blockchain nodes is essential for establishing a functional blockchain network. This tutorial will guide you through:

  • Navigating to the appropriate sections of the ChainLaunch interface.
  • Adding organizations and configuring node settings.
  • Understanding each step's purpose and functionality.

Prerequisites​

Before starting, ensure you have:

  • Access to the ChainLaunch platform.
  • Basic knowledge of blockchain concepts.

Overview of Steps​

  1. Navigate to the Nodes section.
  2. Add an organization.
  3. Configure organization details.
  4. Create nodes in bulk.

Step 1: Navigate to the Nodes Section​

To begin the process, you need to access the nodes section of the ChainLaunch platform.

Step 1

Instructions:​

  1. Open your web browser and enter http://localhost:3100/nodes.
  2. You should see a dashboard displaying options for creating your first node.

Key Elements:​

  • Fabric Node: This option allows you to create a Hyperledger Fabric peer or orderer node.
  • Besu Node: This option lets you create a Hyperledger Besu node.
  • Bulk Create: Use this button to create multiple nodes at once.

Tip: Familiarize yourself with the interface to streamline your navigation.

Step 2: Click on 'Add Organization'​

Next, you will add an organization that will own the nodes.

Step 2

Instructions:​

  1. Locate and click on the Add Organization button at the top right corner.

Key Elements:​

  • A list of existing organizations will be displayed once added.

Warning: Ensure that the organization name is unique to avoid conflicts when creating nodes.

Step 3: Type 'TestOrgDemo' in MSP ID​

After clicking on 'Add Organization', you'll need to specify an ID for your organization.

Step 3

Instructions:​

  1. In the dialog box, enter TestOrgDemo in the MSP ID field.

Key Elements:​

  • MSP ID: The identifier for your organization.
  • Description: You can provide additional information about the organization (optional).

Step 4: Type '' in Enter Organization Description​

In this step, you will provide additional details about your organization.

Step 4

Instructions:​

  1. In the Description field, you can enter relevant information about your organization (optional).

Best Practice: Providing a description helps in identifying organizations later on, especially in larger networks.

Step 5: Click on 'Create Organization'​

Once you've entered all required information, you can create the organization.

Step 5

Instructions:​

  1. Click on the Create Organization button to finalize your entry.

Step 6: Click on 'Nodes'​

Now that you've created an organization, return to the Nodes section.

Step 6

Instructions:​

  1. Navigate back by clicking on Nodes from the left sidebar.

Step 7: Click on 'Bulk Create'​

You are now ready to create multiple nodes at once.

Step 7

Instructions:​

  1. Click on Bulk Create next to Fabric Node.

Step 8: Type '1' in Peer Count​

Configure how many peers you want to create for your organization.

Step 8

Instructions:​

  1. In the Number of Peers field, enter 1.

Key Elements:​

  • You can create up to 10 peers as needed for your blockchain setup.

Step 9: Type '1' in Orderer Count​

Next, specify how many orderers you want to create alongside peers.

Step 9

Instructions:​

  1. In the Number of Orderers field, enter 1.

Tip: Orderers are critical for maintaining consensus within your blockchain network.

Step 10: Click on 'Next'​

Proceed to configure network settings for your new nodes.

Step 10

Instructions:​

  1. Click on Next after entering peer and orderer counts.

Step 11: Configure Network Settings​

You now need to set up network configurations for your nodes.

Step 11

Instructions:​

  1. Fill in necessary fields like Listen Address and External Endpoint. Default values are provided but can be customized as needed.

Warning: Ensure that IP addresses and ports do not conflict with other services running on your machine.

Step 12: Click on 'Next' Again​

Once configurations are set, review them and move forward.

Step 12

Instructions:​

  1. Click on Next after reviewing network settings to proceed with node creation.

Step 13: Click on 'Create Nodes'​

Finalize your setup by creating all configured nodes at once.

Step 13

Instructions:​

  1. Review the summary provided and click on Create Nodes to launch the creation process.

Best Practice: Always double-check configurations before finalizing node creation to avoid errors later on.

Step 14: Capture Completed​

After successful creation, you'll receive confirmation that all nodes have been created successfully.

Step 14

Key Elements:​

  • A list displays newly created nodes along with their statuses (e.g., RUNNING).

Tip: You can manage or view logs for each node from this interface as needed for maintenance or troubleshooting purposes.

Conclusion​

Congratulations! You have successfully created blockchain nodes using ChainLaunch. By following these steps, you should now be familiar with navigating through different sections, adding organizations, and configuring multiple nodes efficiently.

Next Steps​

Consider exploring further functionalities within ChainLaunch such as monitoring node performance or adding more complex configurations tailored to specific use cases.

Troubleshooting Tips​

If you encounter issues during any steps:

  • Double-check entered values for typos.
  • Ensure there are no conflicts with existing network configurations.
  • Refer back to documentation for specific error messages or behaviors encountered during setup.