3 Provisioning Oracle Blockchain Platform Enterprise Edition from Oracle Cloud Marketplace

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

To find Oracle Blockchain Platform Enterprise Edition in Oracle Cloud Marketplace:

  1. Log in to Oracle Cloud Marketplace.
  2. From the Oracle Cloud Marketplace home page, use the search box under Applications and search for the keywords Oracle Blockchain Platform.
  3. From the search results, select Oracle Blockchain Platform Enterprise Edition.

After finding Oracle Blockchain Platform Enterprise Edition listing in Oracle Cloud Marketplace, you can deploy Oracle Blockchain Platform using the provided stack listing. The Terraform stack prompts you for specific information and then builds an Oracle Kubernetes Engine Cluster with Oracle Blockchain Enterprise Edition installed.

  1. From the Marketplace page, select Oracle Blockchain Platform Enterprise Edition.
  2. On the Oracle Blockchain Platform application page, provide the following information:
    1. Select Version
      Provides a list of versions that are available. Select the version of Oracle Blockchain Platform Enterprise Edition you want to provision.
    2. Select Compartment
      Specifies the compartment where the resources will be built.
    3. Terms of Use
      Review the licenses before proceeding with the instance creation.
    Click Launch Stack to launch the stack in the OCI environment.
  3. Optionally customize the Stack Information fields. All fields are completed with defaults.
    1. Custom provider
      Custom providers are not supported at this time.
    2. Name
      Name of the stack. It has a default name and provides a date time stamp. You can edit this if desired.
    3. Description
      Description of the stack that you are creating.
    4. Create in compartment
      Defaults to the compartment you selected on the Oracle Blockchain Platform Marketplace page.
    5. Terraform version
      Ensure version 1.1.x or later is selected.
    6. Tags
      Optional. Tags are a convenient way to assign a tracking mechanism.
    Click Next.
  4. Fill in the required details to configure the platform on the Configure Variables page.
    Blockchain Platform Configurations
    1. Domain Name
      The domain name that will be used for your Oracle Blockchain Platform Manager. This will be used in the Platform Manager URL as described in step 7.
    2. Admin User Password
      This is used to set the Blockchain Platform Manager admin user's password.
    3. LDAP User Password
      This is used to set the admin user's password for the LDAP authentication server.
    OCIR Image Configurations
    1. OCIR Username
      User name used to log into Oracle Cloud Infrastructure Registry. Enter the name of the user in the format:
      <tenancy-namespace>/<username>
      where <tenancy-namespace> is the auto-generated Object Storage namespace string of the tenancy in which to create repositories (as shown on the Tenancy Information page). For example
      ansh81vru1zp/jdoe@example.com
      Note that for some older tenancies, the namespace string might be the same as the tenancy name in all lower-case letters. For example,
      example-dev
      If your tenancy is federated with Oracle Identity Cloud Service, use the format
      <tenancy-namespace>/oracleidentitycloudservice/<username>

      See Logging in to Oracle Cloud Infrastructure Registry.

    2. OCIR Auth Token
      The auth token used to access OCIR.
    Kubernetes Cluster Configurations
    1. Cluster Name
      Name of the OCI Kubernetes Engine cluster that will be created.
    2. Node Pool Name
      Name of the node pool for the worker nodes.
    3. Enable Cluster Autoscaler for Node Pool
      This will enable node pools to autoscale based on resource usage and will add and remove worker nodes as needed.
    4. Minimum Number of Worker Nodes
      The minimum number of nodes in the node pool. If autoscaling has not been enabled, this is the total number of worker nodes available. At a minimum, three worker nodes are required.
    5. Maximum Number of Worker Nodes
      The maximum number of nodes in the node pool. This is only available if autoscaling has been enabled.
    6. Worker Nodes Instance Shape
      Select the appropriate compute shape. For information on supported shapes and their configurations, see: Supported Compute Shapes
    7. Worker Node OCPU Count
      The number of OCPUs for each worker node compute instance. The minimum is 2 OCPUs.
    8. Worker Node Memory (GB)
      The amount of memory for each worker node compute instance. The minimum is 32GB.
  5. On the Review page, review the information you provided and click Create.
    • Run Apply is selected by default. It will run the stack and setup your Blockchain Platform Manager.
    • If Run Apply was not selected, click Apply and select Automatically Approve for Apply job plan resolution.
    It will take approximately 30 minutes to complete the installation.
  6. After the job has completed, a new tab is available: Application Information.
    1. Copy the Domain Hosts Entry field and append it to your client machine's hosts file:
      • macOS or Linux: /etc/hosts
      • Windows: C:\Windows\System32\drivers\etc\hosts
    2. Optional: Copy the Kubernetes Configuration field and append it to your client machine's kubeconfig file (~/.kube/config) to access the cluster.
  7. You can now go to the Blockchain Platform Manager at the following URL:
    https://controlplane.<domain_name>/console/index.html
    Where <domain_name> corresponds to the domain name that was submitted in the Blockchain Platform Configurations details in step 4.
    For example: https://controlplane.obpee.com/console/index.html

Signing Into Blockchain Platform Manager for the First Time

Once you've deployed Oracle Blockchain Platform, you can log into Blockchain Platform Manager which allows you to provision an Oracle Blockchain Platform instance.

Once you've accessed Blockchain Platform Manager at https://controlplane.<domain_name>/console/index.html:
  1. Enter the default admin credentials.
    1. User name: obpadmin
    2. Password: the admin user password submitted in the Blockchain Platform Configurations details in step 4.
  2. You will be prompted to configure LDAP. Proceed by clicking OK.
    The Configuration tab opens.
  3. The LDAP configuration has already been created but the admin user must set it to active. Click Set Active to activate your LDAP configuration. A prompt will appear for confirmation; click Confirm.
  4. You need to add at least one user to create Oracle Blockchain Platform instances since the default admin user does not have this privilege. Click Add User and enter all required details. Click Submit.
  5. Sign out of Blockchain Platform Manager.
  6. Log in with the new user added to create instances.
  7. Click Create Instance to create your Oracle Blockchain Platform instance. Follow the steps outlined in Provision An Instance.

Next Steps

You're now ready to work with your Oracle Blockchain Platform Enterprise Edition instance as described in Using Oracle Blockchain Platform.