2 Create an Instance

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

Before You Create Your Instance

Before you set up Oracle Blockchain Platform using Oracle Cloud Infrastructure Console, Oracle recommends that you take some time to plan your service.

Create a Compartment

When you sign up for Oracle Cloud Infrastructure, Oracle creates your tenancy with a root compartment that holds all your cloud resources. You then create additional compartments within the tenancy (root compartment) and corresponding policies to control access to the resources in each compartment. Before you create an Oracle Blockchain Platform instance, Oracle recommends that you set up the compartment where you want the instance to belong.

You create compartments in Oracle Cloud Infrastructure Identity and Access Management (IAM). See:

Plan Your Instance

Editions

There are three editions of Oracle Blockchain Platform available:
  • Standard Edition: 2 OCPUs, 50 GB storage, 2 peers (additional can be added later)
  • Enterprise Edition:
    • Small: 4 OCPUs, 150 GB storage, 2 peers (additional can be added later)
    • Medium: 8 OCPUs, 150 GB storage, 4 peers (additional can be added later)
    • Large: 16 OCPUs, 150 GB storage, 6 peers (additional can be added later)
    • X-Large: 32 OCPUs, 150 GB storage, 6 peers (additional can be added later)
  • Digital Assets Edition:
    • Medium: 8 OCPUs, 150 GB storage, 4 peers (additional can be added later)
    • Large: 16 OCPUs, 150 GB storage, 6 peers (additional can be added later)
    • X-Large: 32 OCPUs, 150 GB storage, 6 peers (additional can be added later)

If you create an Enterprise or Digital Assets shape, you can scale your Blockchain Platform up or down resulting in a new shape called Enterprise or Digital Assets Custom. See Scale Your Instance for details.

Platform Versions

You can also select which platform version (Hyperledger Fabric version) to use. For more information, see What's a Platform Version?.

Billing

Oracle Blockchain Platform OCPU-based meters use high precision billing, meaning that you are billed per second. The minimum billing amount is for one minute; any instance running for less than one minute will still be charged for one minute of time.

Create an Oracle Blockchain Platform Instance Using the Console

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

There are two types of Oracle Blockchain Platform instances that you can provision:

  • Founder organization: a complete blockchain environment, including a new network which participants can join later on.

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

  1. Sign in to your Oracle Cloud Infrastructure account. You must sign in as a federated Oracle Identity Cloud Service user.
  2. In the console, click the Navigation menu in the top-left corner.
  3. Under Developer Services, select Blockchain Platform.
  4. From the Compartment list, select the compartment where you want to create the service.
  5. Click Create Blockchain Platform.
  6. Enter a name for your Oracle Blockchain Platform instance.
    The service instance name must meet the following requirements:
    • Must contain one or more characters.
    • Must not exceed 15 characters.
    • Must start with an ASCII letter: a to z or A to Z.
    • Must contain only ASCII letters or numbers.
    • Must not contain a hyphen or any other special characters.
    • Must be unique within the identity domain.
  7. Optionally, enter a description of your instance.
  8. Select your platform version. This specifies the version of Hyperledger Fabric that you want your instance to run on. The founder and participants must all be on the same version of Hyperledger Fabric.
  9. Choose whether you are creating a new network or creating a participant instance to join an existing network.
  10. Select your edition. For more information about editions, see Plan Your Instance.
  11. Oracle Blockchain Platform includes a certificate authority (CA), which is used to create self-signed certificates for all blockchain nodes in your instance.

    Note:

    Third party certificates aren't supported for Oracle Blockchain Platform version 25.4.1 instances.

    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 that 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: This file must be named ca-chain.pem. The entire CA file sequence from the signing CA to the top-level CA must be present.
    • key: This file must be named ca-key.pem. A 256-bit key that uses the prime256v1 curve is recommended. The key file must be an unencrypted private key in the PKCS #8 format.
    • certificate: This file must be named ca-cert.pem. The certificate file must be in Base64 format and must include the subject key identifier extension.
    The archive must be less than 2 MB. The files must directly reside inside the .zip archive such that when the archive (.zip) is extracted, the files are visible in the current directory at the same level as the archive (.zip) file. The files must not be inside a nested directory inside the archive.

    The product was tested with an X.509 v3 certificate with the following properties.

    Key type: Elliptic curve cryptography (ECC)

    Curve name: prime256v1

    Certificate signing algorithm: ecdsa-with-SHA256

  12. To use tags for your instance, expand the Advanced Options section and add tags.
  13. Click Create.

It takes about 15 minutes to create the service. You can check the current status on the Instance page.

Verify Your Instance

Navigate to your service in the Oracle Cloud Infrastructure console, and sign in to verify that your Oracle Blockchain Platform instance is up and running.

For more information about signing into the Oracle Cloud Infrastructure console, see Signing In to the Console.

  1. On the Oracle Cloud Infrastructure console, click the Navigation menu in the top-left corner.
  2. Under Developer Services, select Blockchain Platform.
  3. From the Compartment list, select the compartment that you used to create the instance.
  4. Click the name of the new instance.
  5. Click Service Console. This launches the Oracle Blockchain Platform console.