Deploy from Oracle Cloud Marketplace

As an Oracle Cloud Infrastructure administrator, you can install Oracle Blockchain Platform Enterprise Edition for Besu from Oracle Marketplace.

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 All Applications and search for the keywords Oracle Blockchain Platform.
  3. From the search results, select Oracle Blockchain Platform Besu Enterprise Edition.

After finding the Oracle Blockchain Platform Enterprise Edition listing in Oracle Cloud Marketplace, you can deploy Oracle Blockchain Platform using the provided stack listing. The 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 Besu Enterprise Edition.
  2. Select Launch Stack.
  3. On the Launch Stack page, provide the following information:
    1. Select Compartment
      Specifies the compartment where the resources will be built.
    2. Select Version
      Provides a list of versions that are available. Select the version of Oracle Blockchain Platform Enterprise Edition that you want to provision: 26.3.1.
    3. Terms and Conditions
      Review the licenses before proceeding with the instance creation.
    Select Launch Stack.
  4. 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.5.x or later is selected.
    6. Tags
      Optional. Tags are a convenient way to assign a tracking mechanism.
    Click Next.
  5. 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. Blockchain Platform Manager 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 autogenerated 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 lowercase 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. This prerequisite is described here: OCI Prerequisites.
    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 4 OCPUs.
    8. Worker Node Memory (GB)
      The amount of memory for each worker node compute instance. The minimum is 64GB.
  6. On the Review page, review the information you provided and click Create.
    • Run Apply is selected by default. It will run the stack and set up 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.
  7. 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.
  8. 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 5.
    For example: https://controlplane.obpee.com/console/index.html