3 Manage the Lifecycle of an Instance

You can use the Instances page of the Oracle Cloud Infrasructure Console to perform routine maintenance or troubleshooting for your Oracle Blockchain Platform instance.

Start or Stop an Instance

You can start or stop an instance using the Oracle Cloud Infrastructure console or the REST APIs.

To start or stop an instance in the console:
  1. In the Oracle Cloud Infrastructure console, under Solutions and Platform, select Blockchain Platform.
  2. Select the correct compartment, and click the instance you want to start or stop.
  3. Select Start or Stop. You'll be prompted to confirm your selection.
To start or stop an instance using the REST APIs, you can use the following operations. Refer to the REST API Reference for information about how to use these operations:
  • /20191010/blockchainPlatforms/{blockchainPlatformId}/actions/start
  • /20191010/blockchainPlatforms/{blockchainPlatformId}/actions/stop

Scale Your Instance

You can scale your overall instance OCPU capacity (Enterprise instances only) or the components of any instance.

Scaling the OCPU Capacity of an Enterprise Instance

If you've selected an Enterprise edition when provisioning your instance, you can scale its OCPU capacity up or down, resulting in a new edition called Enterprise Custom. The total OCPU capacity represents the total number of OCPUs that are equally allocated among all the VMs in the Blockchain Platform cluster.

To change your OCPU capacity:
  1. In the Oracle Cloud Infrastructure console, under Solutions and Platform, select Blockchain Platform.
  2. Select the correct compartment, and click the instance you want to modify.
  3. Click Scale, and from the scaling object dropdown select Platform.
  4. You will be prompted to select the number of OCPUs you want provisioned for this instance. The options are 4, 8, 16, and 32.

    Note that the resizing will take several minutes and will result in downtime of your Blockchain Platform.

Your instance is now resized to its new OCPU capacity and will be listed as an Enterprise Custom edition.

Scaling Components of Your Instance

You can scale components of your instance by selecting it in the Oracle Cloud Infrastructure console and selecting Scale.

Peers
  • You can change the OCPUs for the peers created when provisioning your instance. The total value of the OCPUs must not exceed the size of the instance edition you selected when provisioning your instance. Once you have selected the OCPUs for a peer, you can't decrease the setting.
  • You can add a new peer by clicking Add Row and selecting the alias, OCPUs, role, and availability domain for that peer.
Ordering Service
  • You can add an additional orderer node if you have selected to provision an Enterprise Edition instance.
REST Proxy
  • You can change the number of cluster replicas for your REST proxy.
Certificate Authority:
  • You can change the number of cluster replicas for your certificate authority.
Storage
  • Storage scaling is for Enterprise shapes only.
  • You can add storage in 1TB increments. Metering of storage is also in 1TB increments. You can't decrease storage once allocated.
  • The initial block size is 50GB for each manager VM in the cluster, and is increased in increments of 100GB.
  • When storage is scaled up on an instance, the block volume on each VM in the cluster will be increased by the same size. All VMs in a cluster will have block storage volumes of the same size at all times.
  • Every time a storage scaling is performed on a Blockchain Platform, the added storage units will be added to the storageSizeInTBs for the platform, and then 100GB of storage will be added to each VM in the cluster from the storageSizeInTBs for the platform.
  • When new VMs are added as part of scaling peers and OSNs, every new VM will be brought to parity with existing VMs in the cluster by adding the same number and size of storage volumes as present in an existing VM. For this, required storage will be used from the platform storage pool. In situations when the platform storage pool does not have sufficient capacity to create the same number and size of block volumes for the new VM, we will offset the difference by adding additional storage to enable creation of required volumes. If the additional storage required is more than 0.5TB of the total purchased (metered) storage, you will be charged for additional storage units as applicable.
  • If the current active (growing) volume size exceeds 99% of the max storage size (32TB), a new volume will be created.
Automatic storage scaling
  • If the available storage space becomes less than 20% of the total storage capacity on any VM in the platform cluster, automatic storage scale up will be performed for the platform.
  • If the storage pool balance becomes less than the total size required for all the VMs in the cluster, then the remaining balance will be equally allocated to all the VMs in the cluster. If the platform storage pool balance becomes less that the minimum required (1 GB per VM) for all the VMs in the cluster then auto scaling of storage will not be performed for the platform.

Delete an Oracle Blockchain Platform Instance

When you no longer require an Oracle Blockchain Platform instance, you can delete it. Your account is no longer charged for the instance.

Only a blockchain administrator can delete a service instance. See Assigning Roles in Oracle Identity Cloud Service.

To delete an Oracle Blockchain Platform instance:
  1. In the Oracle Cloud Infrastructure console, select Solutions and Platform, select Blockchain Platform.
  2. Select the correct compartment, and click the instance you want to delete.
  3. From the More Actions dropdown, select Terminate.
  4. You will be asked to confirm your selection. Note that all information in the ledger will be lost when you terminate the instance.

Monitor the Status of Your Blockchain Platform

You can use Oracle Cloud Infrastructure Console, command line, or REST APIs to check the status of your Oracle Blockchain Platform instances and any operations that are in progress.

Monitor Status using the Console

  1. In the Console, click Navigation menuin the top left corner.
  2. Under Solutions and Platform, select Blockchain Platform.
  3. Select the compartment that contains the Oracle Blockchain Platform instances you're looking for.

    A list of all the instances in the compartment are displayed.

  4. Check the State column to determine the current status of your instance.
    • Creating: Instance is in the process of being created.
    • Active: Instance is running normally.
    • Updating: Instance is being updated. For example, in the process of scaling up or down.
    • Scaling: Instance is in the process of being scaled.
    • Inactive: Instance has been temporarily stopped or is stopping.
    • Failed: Instance isn't running due to an error.
    • Deleting: Instance is in the process of being deleted.

    Figure 3-1 Status of Blockchain Platforms


    Console view showing the State column for all Blockchain Platform instances.

  5. Click the name of your service to access the work request details.
    Use the Work Requests section to track the history and status of activities related to the instance. For example, work requests such as create, start, stop, scale, and so on.
    • Accepted: The request is in the queue to be processed.
    • InProgress: The work request started but isn't complete.
    • Succeeded: A work request record exists for this request and an associated WORK_COMPLETED record is in the state SUCCEEDED.
    • Failed: A work request record exists for this request and an associated WORK_COMPLETED record is in the state FAILED.
    • Canceling: The work request is in the process of canceling.
    • Canceled: The work request has been canceled.

    Figure 3-2 Status of a Blockchain Platform Instance


    Shows the list of work requests and their status.

Monitor Status using the Command Line

You use the work-request list and work-request get commands to get the current status of operations you perform on Oracle Blockchain Platform instances. If you want to cancel an operation, you use work-request delete. To check errors and access logs, you use work-request-error list and work-request-log list.

Refer to the Oracle Cloud Infrastructure CLI Command Reference for information about how to use these commands:

Monitor Status using the REST API

You use GetWorkRequest to get the current status of operations you perform on Oracle Blockchain Platform instances. If you want to cancel an operation, you use DeleteWorkRequest. To check errors and access logs, you use ListWorkRequestErrors and ListWorkRequestLogs.

Refer to the Oracle Cloud Infrastructure REST API Reference for information about how to use these operations: