Pre-General Availability: 2026-03-13

Install Manually

You can also install Blockchain Platform Manager manually on Oracle Kubernetes Engine.

Prerequisites for Manual Installation

Before you begin the manual installation process, ensure that you have the following prerequisites.

Kubernetes Platform

Access to a Kubernetes cluster via the kubeconfig file. For more information on connecting to Kubernetes, see Connect to Oracle Kubernetes Engine.

Software Prerequisites

  • kubectl version 1.31.0 or later - command line tool for Kubernetes
  • oci-cli version 3.71.4 or later - command line interface for OCI
  • istioctl version 1.28.1 or later - command line tool for Istio, a security and traffic management tool for deployments
  • Helm version 3.19.4 or later - a Kubernetes package manager
    • Helm version 4 or later is not supported.
  • Podman version 4.9.4-rhel or later
  • openssl version 1.1.1 or later
  • yq version 4.49.2 - a command line YAML processor
  • jq v1.6 or later - a command line JSON processor
  • bash version 3.2.57 or later - command shell

Install Oracle Blockchain Platform Enterprise Edition for Hyperledger Besu Manually

Complete the following steps to install the platform manually.

  1. Enter the following command to install Istio on the cluster.
    istioctl install --set profile=default --set values.pilot.env.ENABLE_TLS_ON_SIDECAR_INGRESS=true --set components.cni.enabled=true --set values.cni.repair.deletePods="true"
    ## Enter "y" when prompted for "Proceed? (y/N)"
  2. Enter the following command to extract either the full or the lite distribution package. To push images to the container registry, you must use the full distribution. For the limited availability release, the URL of the .tgz file is provided by your Oracle point of contact in sales or product management.
    tar -xzf <distribution-package-file>.tgz
  3. Update the runme-input.yaml file with the required values. You can use the following example runme-input.yaml file as a reference.
    ```
imageRegistryConfiguration:
    registry: ams.ocir.io
    imageTagPrefix: ams.ocir.io/oabcs1/besu
    username: dev.sony@oracle.com
 
  # Used for unattended mode (Wrap around quotes to prevent certain symbols from being read as part of yaml)
  ocirpwd: ”"
imageReleaseVersion: 26.1.1-2026XXXXXXXXXX
 
# storageClassName 
controlPlaneStorage:
  storageClassName: oci-bv
  # Example 500Mi, 5Gi
  size: 1Gi
 
parentDomainName: example.com
 
#imagePullTimeout: Use this field to customize the wait time (in seconds) for pulling the required docker images from the repository. Default is 1800 seconds.
imagePullTimeout: 1800 
 
# Used for unattended mode
cpAdminPassword: Welcome1
ldapAdminPassword: Welcome1
idbDbPassword: admin
dbRootPassword: admin
operatordbUser: obp-operator-admin
operatordbPassword: opadmin
```
    In the previous example, the variables are defined as shown in the following list:
    • imageRegistryConfiguration.registry: The container registry server to use.
    • imageRegistryConfiguration.imageTagPrefix: Container base repository path in the registry to use for resolving images.
    • imageRegistryConfiguration.username: Container registry login user name.
    • imageRegistryConfiguration.ocirpwd: (Optional, but required in unattended mode) Container registry login password.
    • imageReleaseVersion - Oracle Blockchain Platform Enterprise Edition for Hyperledger Besu release version. Use the release version from the distribution package file name.
    • controlPlaneStorage.storageClassName: Kubernetes storage class to use for PVC (PersistentVolumeClaim). If empty, the default storageClass is used.
    • parentDomainName: Domain name to use for the Blockchain Platform Manager deployment.
    • imagePullTimeout: Image pull wait timeout in seconds during installation.
    • cpAdminPassword: (Optional, but required in unattended mode) The password for the default Blockchain Platform Manager administrative user (user name: obpadmin).
    • ldapAdminPassword: (Optional, but required in unattended mode) The password for the default LDAP administrative user.
    • idbDbPassword: The default IDB persistence root password.
    • dbRootPassword: The default IDB persistence administrative password.
    • operatordbUser: The user name of the operator user. Operators are read-only users, who do not have access to the Accounts page in the service console
    • operatordbPassword: The password of the operator user.
  4. Navigate to the directory where you extracted the package and then run the runme_oke.sh script.
    • Enter the following command to run in unattended mode and push the images to the container registry. This command works only with the full distribution package.
      ./runme_oke -u –p
    • Enter the following command to run in unattended mode.
      ./runme_oke.sh -u
    • Enter the following command to run in interactive mode, following the prompts.
      ./runme_oke.sh
    After the script runs, you can log in to Blockchain Platform Manager and create an instance.