2 Create an Oracle Blockchain Platform Instance

As Cloud Account Administrator, you can create and set up an Oracle Blockchain Platform instance for your organization.

Typical Workflow to Create an Oracle Blockchain Platform Instance

If you’re about to create an Oracle Blockchain Platform instance for the first time, follow these tasks as a guide.

Task Description More Information

Before you start

Activate your order and sign in to Oracle Cloud Infrastructure

As Cloud Account Administrator, you can complete all setup tasks for Oracle Blockchain Platform.

 
Create the service instance    

Create a service

Set up and configure your Oracle Blockchain Platform components.

Create a Custom Oracle Blockchain Platform Instance

Complete the setup

Verify that your service instance is up and running and that you can sign in.

Verify Your Instance and Access the Oracle Blockchain Platform Console

After creating your service instance

Manage users

Set up users for Oracle Blockchain Platform in Oracle Identity Cloud Service and assign roles to them.

Use Oracle Identity Cloud Service for Authentication

Manage your blockchain network

Add organizations to your blockchain network and manage a complex network.

See Using Oracle Blockchain Platform

Before You Create an Oracle Blockchain Platform Instance

Before you set up Oracle Blockchain Platform, take some time to set up your Oracle Infrastructure dashboard and plan your service. However no formal prerequisites exist for creating your instance.

Deciding Which Provisioning Shape to Use

When provisioning an instance, you choose between three configurations. Migration between these options isn't supported currently.

Configuration Minimum Charges Features
Developer

Recommended use for this starter shape is development and evaluation.

1 unit minimum charge

(500 transactions/hr)

  • 1 Fabric-CA node
  • 1 Kafka Orderer node with 1 Kafka broker (Founder only)
  • Up to 7 Peer nodes
  • 2TB of storage
  • Dynamically managed chaincode execution containers
  • Console node for operations web user interface
  • REST proxy node for RESTful API
  • Oracle Identity Cloud Service integration for authentication and role management
  • Object store backup of configuration and blocks replicated across regions
  • Load balancer and web firewall for Oracle Cloud Interface
  • Oracle operations management and monitoring
Enterprise-X1

Highly available instance configuration, suitable for small-to-medium production deployments of Founder and Participant instances with performance requirements in tens of transactions per second (TPS) single digit TPS rate.

2 unit minimum charge

(1000 transactions/hr)

  • 2 Fabric-CA nodes replicated across separate virtual machines for high availability
  • 3 x Standard 2.1 VM with 2 Kafka Orderer nodes replicated across separate virtual machines with 3-VM Kafka/Zookeeper cluster (Founder only) for high availability
  • Up to 14 Peer nodes spread across separate virtual machines
  • 4TB of storage
  • Dynamically managed chaincode execution containers in an isolated virtual machine
  • Console node for operations web user interface replicated across separate virtual machines for high availability
  • 4 REST proxy nodes for RESTful API replicated across separate virtual machines for high availability
  • Oracle Identity Cloud Service integration for authentication and role management
  • Object store backup of configuration and blocks replicated across regions
  • Load balancer and web firewall for Oracle Cloud Interface
  • Oracle operations management and monitoring
Enterprise-X4

Highly available instance configuration, suitable for medium-to-large production deployments of Founder and Participant instances with performance requirements of hundreds of transactions per second. It includes all the components and features listed for Enterprise-X1, but provides 4 times the compute capacity.

8 unit minimum charge

(4000 transactions/hr)

  • 2 Fabric-CA nodes replicated across separate virtual machines for high availability
  • 3 x Standard 2.4 VM with 2 Kafka Orderer nodes replicated across separate virtual machines with 3-VM Kafka/Zookeeper cluster (Founder only) for high availability
  • Up to 14 Peer nodes spread across separate virtual machines
  • 4TB of storage
  • Dynamically managed chaincode execution containers in an isolated virtual machine
  • Console node for operations web user interface replicated across separate virtual machines for high availability
  • 4 REST proxy nodes for RESTful API replicated across separate virtual machines for high availability
  • Oracle Identity Cloud Service integration for authentication and role management
  • Object store backup of configuration and blocks replicated across regions
  • Load balancer and web firewall for Oracle Cloud Interface
  • Oracle operations management and monitoring

Create a QuickStart Instance with a Single Click

You can create a QuickStart instance of Oracle Blockchain Platform with a single click. This installs Oracle Blockchain Platform and the services associated with it. Together, these instances are known as the stack. Oracle manages the stack for you.

The QuickStart templates provision a complete blockchain founder network with two peer nodes. The following templates are available:
  • Developer
  • Enterprise-X1
  • Enterprise-X4

To create a participant network, use the Custom provisioning option.

  1. Sign in to your Oracle Cloud account.

  2. From the Cloud Infrastructure Console Dashboard, open the Oracle Blockchain Platform

  3. Click QuickStarts.

  4. Enter your instance name or accept the default, and click Create.

It will take approximately 15 minutes for your service to be provisioned. Once it’s complete, you’ll receive an email with the details of the instance.

Create a Custom Oracle Blockchain Platform Instance

To create a blockchain founder or participant instance from Oracle Cloud Infrastructure Console, use the Create New Instance wizard.

There are two types of Oracle Blockchain Platform instances you can provision:
  • Founder organization: a complete blockchain environment, including a new network to which participants can join later on.

  • Participant instance: if there is already a founder organization you want to join, you can create a participant instance if your credentials provide you with access to the network.

  1. In the Cloud Infrastructure Console, open the Dashboard.
  2. Select Create Instance, navigate to Blockchain, and click Create. If the QuickStart creation wizard opens, click Custom to access additional customization options.
  3. Complete the following fields:
    Field Description
    Instance Name

    Enter a name for your Oracle Blockchain Platform instance.

    The service instance name:

    • Must contain one or more characters.
    • Must not exceed 15 characters.
    • Must start with an ASCII letter: a to z.
    • Must contain only ASCII lower-case letters or numbers.
    • Must not contain a hyphen.
    • Must not contain any other special characters.
    • Must be unique within the identity domain.
    Description

    Optional.

    Enter a short description of the Oracle Blockchain Platform instance.

    Notification Email

    Specify an email address where you would like to receive a notification when the service instance provisioning has succeeded or failed.

    Region

    Select the region where you want to host your service instance. 

    Tags

    Optional.

    Select existing tags or add tags to associate with the service instance.

    To select existing tags, select one or more check boxes from the list of tags that are displayed on the pull-down menu.

    To create tags, click Click to create a tag to display the Create Tags dialog box. In the New Tags field, enter one or more comma-separated tags that can be a key or a key:value pair.

    If you don't assign tags during provisioning, you can create and manage tags after the service instance is created.

    Create a New Network

    Selecting this creates a complete blockchain environment. This instance becomes the founder organization and you can onboard new participants in the network later.

    If this option isn't selected, the instance will be a participant organization and must join an existing blockchain network created elsewhere before this instance can be used.

    Configuration
    Select a provisioning shape which meets the needs of your deployment:
    • Developer
    • Enterprise X1
    • Enterprise X4
    Note that the minimums are charged every hour even if no transactions are used.
    Peers

    Specify the number of peer nodes to be initially created in this service instance. You can create between 1 and 14 peer nodes for an Enterprise configuration, and between 1 and 7 nodes for a Developer configuration. You can create additional peer nodes in the Oracle Blockchain Platform console at a later time.

    Upload Root CA Archive

    Optional.

    Oracle Blockchain Platform includes a certificate authority (CA), which is used to create self-signed certificates for all blockchain nodes in your instance

    If you want to use certificates from your own certificate authority and use the Oracle Blockchain Platform certificate authority as an intermediary CA, you can upload your CA archive. The certificate you upload will be used to sign the intermediary certificates for Oracle Blockchain Platform nodes, thus including them under your root CA chain.

    The archive is a zip file which contains the following files:
    • CA chain - named xxxca-chain.pem. The entire CA file sequence from the signing CA to the top-level CA should be present.
    • key - named xxxca-key.pem. The key should be a 256-bit elliptic curve key. The prime256v1 curve is recommended.
    • certificate - named xxxca-cert.pem
    where xxx is an identifier of your choice. The archive must be less than 2MB.
  4. Click Next.
  5. Verify that the details are correct, and click Confirm.

It takes about 15 minutes to create the service instance. Oracle sends an email to the designated email address when your service is ready. Display the Oracle Cloud Activity tab to check the current status. Once the instance has been created it is started, and can’t be stopped until it is deleted.

Create an Instance Using the PaaS Service Manager

The Oracle PaaS Service Manager provides a command line interface which contains tools you can use to manage the lifecycle of your Oracle services. You can provision an Oracle Blockchain Platform instance using a REST API.

The following example shows how to create an Oracle Blockchain Platform instance using REST API:
curl -X POST \ 
-u <username>:<password> \ 
https://<PSM_endpoint>/paas/api/v1.1/instancemgmt/<IdentityDomain>/services/OABCSINST/instances
-H "Content-Type: application/vnd.com.oracle.oracloud.provisioning.Service+json" \ 
-H "X-ID-TENANT-NAME: <IdentityDomain>" \ 
-d "@service_payload.json" \ 
The service_payload.json file will be of the format:
{
"serviceName": "your_service_name",
"appSize":"Enterprise-X1",
"serviceLevel": "PAAS",
"region":"your_region"
"organizationType": "true",
"numberOfPeersDev": "8",
"managedSystemType": "oracle",
"enableNotification":"true",
"notificationEmail":"your_email"
}
  • serviceName
    • Must contain one or more characters.

    • Must not exceed 15 characters.

    • Must start with an ASCII letter: a to z.

    • Must contain only ASCII lower-case letters or numbers.

    • Must not contain a hyphen.

    • Must not contain any other special characters.

    • Must be unique within the identity domain.

  • appSize
    • Developer: A 1 Kafka orderer and 3 OCPU total in 1 VM; 1 unit minimum charge (500 transactions/hr)

    • Enterprise-X1: A 3 node Kafka cluster and 3 X Standard 2.1 VM shapes; 2 unit minimum charge (1000 transactions/hr)

    • Enterprise-X4: A 3 node Kafka cluster and 3 X Standard 2.4 VM shapes; 8 unit minimum charge (4000 transactions/hr)

  • serviceLevel
    • Must be set to PAAS

  • region
    • Optional. Select the region where you want to host your service instance. 

  • organizationType
    • Must be set to true

  • numberOfPeersDev
    • Specify the number of peer nodes that will be initially created in this service instance.

    • 1 to 14 peer nodes for an Enterprise configuration.

    • 1 to 7 nodes for a Developer configuration

  • managedSystemType
    • Must be set to oracle

  • enableNotification
    • Must be set to true

  • notificationEmail
    • Enter the email where all notifications will be sent.

If you are using the instance creation wizard in the Cloud Infrastructure Console, once you have entered your desired configuration information, on the information confirmation page you can download a service_payload.json file with your selections by clicking the download icon.

After You Create a Service Instance

When you receive the email to say your service is ready, verify that the service is up and running, and then set up users for the service.

Verify that your instance has been created and access the Oracle Blockchain Platform console.

Add users and apply roles to them in IDCS.

You can use the Instances page of the Cloud Infrastructure Console to perform routine maintenance, or troubleshoot, explore, monitor, or delete your instances.

Verify Your Instance and Access the Oracle Blockchain Platform Console

Oracle sends an email to the designated email address when your Oracle Blockchain Platform instance is ready. Navigate to your service in the Cloud Infrastructure Console, obtain the service URL, and then sign in to verify your Oracle Blockchain Platform instance is up and running.

  1. In the Cloud Infrastructure Console, open the dashboard.
  2. Navigate to Blockchain and click the Action menu beside your instance name.
  3. Click Blockchain Console.
  4. Sign in with your administrator credentials.