3 Blockchain Platform Manager

After you install Oracle Blockchain Platform Enterprise Edition for Besu, you can access Blockchain Platform Manager to create, configure and manage platform instances.

Log into Blockchain Platform Manager for the First Time

Before you begin, review the Application Information page, which shows details about the Blockchain Platform Manager, Kubernetes cluster, and Terraform output.
  • Note the ingress gateway IP address, which is used for Blockchain Platform Manager, and the ingress IP address for instance services, which is used by the service console and RPC gateway.
  • Full job logs, including jump host details and Terraform logs, are available under Jobs.
To ensure proper host name resolution, add entries to your local etc/hosts or C:\Windows\System32\drivers\etc\hosts file for Blockchain Platform Manager and OpenLDAP fully-qualified domain names. For a production environment, use DNS and certificates instead of etc/hosts file mappings. Add entries similar to the following example, where the the ingress IP address is the ingress gateway IP address shown in the installation output.
<ingress-ip> controlplane.<domainname> openldap.<domainname> auth.<domainname>

Log into Blockchain Platform Manager for the first time:

  1. Open Blockchain Platform Manager at https://controlplane.domainname/console/index.html. Your browser might warn you about a self-signed certificate.
  2. Log in to Blockchain Platform Manager by using the obpadmin user name and the password that you provided during installation.
  3. If you are using an external identity provider, proceed with the instructions in User Management with an External Identity Provider to create a confidential application, enable the identity provider, and add your users.
  4. If you are using the built-in default OpenLDAP authentication server:
    • On the Configuration page, select Authentication Servers.
    • Select the Default authentication server, then select Save and Set active.
    • Add an instance administrative user to the system. Do not use the Oracle Blockchain Platform administrator account for routine tasks. Log out and then log back in as the new user.
      • On the Authentication Servers tab of the Configuration page of Blockchain Platform Manager, click Add User.
      • Once you've entered the user name and password, this user will be added to the LDAP server as an administrative user.
      • You can now log out of Blockchain Platform Manager with your default admin user, and log in with this newly added instance administrative user to create an instance.

Instances Page Overview

Use the Instances page to create and manage blockchain platform instances (nodes and networks). Select Create Instance to create an instance. For more information, see Create an Instance.

This page lists all instances and the following instance details.
  • Role: Founder instances were created as a separate network. Participant instances were created to add nodes to an existing network.
  • Shape: The resource configuration of the instance. The Enterprise shape is the only supported shape.
  • State: Creating, Up, Stopped, and so on.
  • Domain Name: The domain name that you specified when creating the instance.
  • Created: Instance creation date/time.
  • Version: Version number of the instance.
  • Remarks: Additional remarks to indicate instance state.
The Actions menu for each instance lets you:
  • Start, stop, and terminate instances.
  • Select Confidential Client Credentials to generate or refresh access tokens.
  • Select Instance URLs to see the connection URLs for services provided by the Besu instance.
  • Select Deploy Applications to deploy one of the sample applications.
  • Select Export Genesis Metadata to generate a .zip file that participant network members can use to join a network.

Wallet Page Overview

Use the Wallet page to track and manage all organizations, wallets, and policies.

Activities Page Overview

All lifecycle management actions completed on an instance create a traceable activity record. The activity record logs all lifecycle phase changes the instance goes through from creation to termination. You can filter the activity log by instance, time range, or operation.

This page lists all activities and the following details.
  • Instance Name
  • Operation: Start, Stop, Create, Terminate, and so on.
  • Operation Status: The status of the last action on any instance.
  • Start Time
  • Last Updated Time
  • Initiated By: The user who initiated the activity.

Configuration Page Overview

Use the Configuration page to configure authentication servers and Blockchain Platform Manager itself.

Select Authentication Servers to configure authentication and users. For more information, see User Management with OpenLDAP.

Select Rich History Database to configure the database for the rich history.

Select Platform Manager Settings to view or edit the platform manager name and timeout values.

Deployed Samples Page Overview

This page shows details of the sample applications you've deployed.