Provision an Instance

5 Provision an Instance

This section describes how to provision your Oracle Blockchain Platform instance using Blockchain Platform Manager.

Before You Create an Oracle Blockchain Platform Instance

Before you provision Oracle Blockchain Platform, decide if a developer or enterprise instance meets your needs.

Deciding Which Provisioning Shape to Use

When provisioning an instance, you choose between two configurations. Migration between these options isn't supported currently.

Configuration	Features
Developer Recommended use for this starter shape is development and evaluation.	1 Fabric-CA node 3-node Fabric Ordering Service Network 1-node repository for instance metadata Dynamically managed chaincode execution containers Console service for operations web user interface REST proxy service for RESTful API LDAP server integration for authentication and role management
Enterprise Highly available instance configuration, with higher replica count for each service.	3 Fabric-CA nodes 3-node Fabric Ordering Service Network 3-node cluster repository for high availability of instance metadata Dynamically managed chaincode execution containers Console service for operations web user interface Multiple replicas for REST proxy service for RESTful API LDAP server integration for authentication and role management

Provision an Instance using the Blockchain Platform Manager

To create a blockchain founder or participant instance in Blockchain Platform Manager, use the Create New Instance wizard.

There are two types of Oracle Blockchain Platform instances you can provision:

Founder organization: a complete blockchain environment, including a new network to which participants can join later on.
Participant instance: if there is already a founder organization you want to join, you can create a participant instance if your credentials provide you with access to the network. Note that a participant cannot function on its own.

In Blockchain Platform Manager, open the Instances page.
Select Create Instance.

Complete the following fields:

Field	Description
Instance Name	Enter a name for your Oracle Blockchain Platform instance. The service instance name: Must contain one or more characters. Must not exceed 15 characters. Must start with an ASCII letter: `a` to `z`. Must contain only ASCII letters or numbers. Must not contain a hyphen. Must not contain any other special characters. Must be unique within the identity domain.
Description	Optional. Enter a short description of the Oracle Blockchain Platform instance.
Domain Name	Enter the domain name for the cluster. The hostnames generated for the Blockchain Instance services make use of the domain name and the instance name as parent domain and sub domain respectively.
Role	Select Founder to create a complete blockchain environment. This instance becomes the founder organization and you can onboard new participants in the network later. Select Participant to create an instance that will join an existing blockchain network created elsewhere before this instance can be used.
Configuration	Select a provisioning shape which meets the needs of your deployment: Developer Enterprise
Peers	Specify the number of peer nodes to be initially created in this service instance. You can create additional peer nodes in the Oracle Blockchain Platform console at a later time.

Click Create Instance.

Provisioning Postrequisites

Before accessing the Oracle Blockchain Platform service console, configure the hostname resolution for the blockchain instance services, similar to what you did earlier for the Blockchain Platform Manager hostnames. Use the following command to get the list of hostnames for the created blockchain instance:

kubectl get virtualservice -n <instance-namespace> -o json | jq -r
      .items[].spec.hosts[0]

Once your instance has been created and is listed in the Instances list, you can launch the service console from the menu next to the instance name. Use the console to configure your network as described in Using Oracle Blockchain Platform.