Creating a Cluster

To create a cluster, use the Oracle Data Hub Cloud Service wizard as described in the following procedure.

Before You Begin

When you create a cluster, you may need to provide information about other resources, such as the following:

  • (Optional) An SSH public/private key pair

    An SSH public key is used for authentication when you use an SSH client to connect to a node associated with the cluster. When you connect, you must provide the private key that matches the public key.

    You can have the wizard create a public/private key pair for you, or you can create one beforehand and upload or paste its private key value. If you want to create a key pair beforehand, you can use a standard SSH key generation tool. See Generating a Secure Shell (SSH) Public/Private Key Pair for instructions.

  • (Optional) A cloud storage backup location

    If cloud backup is enabled, data stored in the Oracle Data Hub Cloud Service is backed up in the cloud storage backup location associated with the cluster when the cluster is created. The type of location you specify depends on the infrastructure the cluster is built on:

    • Oracle Cloud Infrastructure: cloud backups are stored in an Oracle Cloud Infrastructure Object Storage bucket. You must create a storage bucket before you create the cluster configured to back up to cloud storage. See Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure in the Oracle Cloud Infrastructure documentation.

    • Oracle Cloud Infrastructure Classic: cloud backups are stored in an Oracle Cloud Infrastructure Object Storage Classic container. You can create the container beforehand and provide the wizard with information about it, or you can have the wizard create the container for you. If you want to create the container beforehand, see Creating Containers in Using Oracle Cloud Infrastructure Object Storage Classic for instructions.

      Whether you create the container beforehand or have the wizard do it for you, you are prompted for the following information about the container:

      • The URL and name of the container

      • The user name and password of a user who has read/write access to the container

    Note:

    Do not use the Oracle Cloud Infrastructure Object Storage Classic container that you are using to back up Oracle Data Hub Cloud Service databases in Oracle Cloud Infrastructure Classic for any other purpose. For example, do not also use it to back up Oracle Java Cloud Service instances. Using the container for multiple purposes can result in billing errors.

Procedure

To create a cluster:

  1. Open the Oracle Data Hub Cloud Service console. See Accessing the Oracle Data Hub Cloud Service Console.

  2. Click Create Instance.

    The Oracle Data Hub Cloud Service Create New Instance wizard starts and the Instance page is displayed. For information about the details on this page, see Instances Page.

  3. On the Instance page, provide cluster information, then click Next to advance to the Service Details page.

    Element Description

    Instance Name

    Name for the new cluster. The name:

    • Must not exceed 50 characters.

    • Must start with a letter.

    • Must contain only letters, numbers, or hyphens.

    • Must not contain any other special characters.

    • Must be unique within the identity domain.

    Description

    (Optional) Description for the new cluster.

    The description is only used during cluster list display and is not used internally by Service Manager.

    Notification Email

    (Optional) Email address provisioning status updates should be sent to.

    Region

    (Available only if your identity domain is enabled for regions.)

    The region for the cluster deployment. If you choose a region that supports Oracle Cloud Infrastructure (for example: us-phoenix-1, us-ashburn-1, or eu-frankfurt-1), the Availability Domain and Subnet fields are displayed, and the deployment will be created on Oracle Cloud Infrastructure. Otherwise, the deployment will be created on Oracle Cloud Infrastructure Classic.

    Choose No Preference to let Oracle Data Hub Cloud Service choose an Oracle Cloud Infrastructure Classic region for you.

    Availability Domain

    (Available only on Oracle Cloud Infrastructure)

    The availability domain (within the region) where the cluster will be deployed.

    Subnet

    (Available only on Oracle Cloud Infrastructure)

    The Oracle Cloud Identifier (OCID) of a subnet from a virtual cloud network (VNC) that you had created previously in Oracle Cloud Infrastructure. For the instructions to create a VCN and subnet, see Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure in the Oracle Cloud Infrastructure documentation.

    The OCID is a unique autogenerated ID. To find out the OCID of a subnet, go to the Oracle Cloud Infrastructure web console, select the Networking tab, click the VCN that your subnet is in, and look for the OCID field under the subnet that you want to use.

    IP Network

    (Only if a region is selected)

    Select an IP network if you want to create the cluster in an IP network that you’ve defined. See Creating an IP Network in Oracle Cloud Infrastructure Classic.

    By default, each node in your cluster is auto-assigned a public and a private IP address. The IP addresses might change each time the cluster is restarted. You can reserve and assign fixed public IP addresses.

    This field is not relevant to Oracle Cloud Infrastructure.

    Tags

    (Optional) Select existing tags or add tags to associate with the cluster.

    To select existing tags, select one or more check boxes from the list of tags that are displayed on the pull-down menu.

    To create tags, click Click to create a tag to display the Create Tags dialog box. In the New Tags field, enter one or more comma-separated tags that can be a key or a key:value pair.

    If you do not assign tags during provisioning, you can create and manage tags after the service instance is created. See Creating, Assigning, and Unassigning Tags.

    Software Release

    Specify the version of Data Hub software and release you wish to use. Select from the following options:

    • Release 3.0.15

    • Release 3.11.1

    Metering Frequency

    Metering frequency used to determine the billing for resources used by the cluster.

  4. On the Service Details page, complete the Cluster Configuration section. For information about the details on this page, see Create New Instance: Service Details Page.

    Element Description

    Compute Shape

    Number of Oracle Compute Units (OCPUs) and amount of memory (RAM) for each node of the new cluster. Oracle Data Hub Cloud Service offers several OCPU/RAM combinations.

    Number of Nodes

    Number of nodes to be allocated to the cluster. Specify three or more nodes to provide high availability (HA).

    Reserved IPs

    (This option is displayed only if you selected a specific Region for this cluster.)

    Select reserved IP addresses for the nodes in your cluster, or leave the default value as Assign Automatically if you want Oracle to automatically assign IP addresses to these nodes. The number of IP addresses that you select must equal the number of nodes in the cluster.

    You create IP reservations by using the IP Reservations tab in the Oracle Data Hub Cloud Service Console. If you do not see this tab on the console, click the gear icon next to this field and follow the instructions to create your first IP reservation. After creating IP reservations, you need to restart the instance creation wizard. See Managing IP Reservations for a Cluster.

    Usable Data Storage in GB

    Amount of usable data storage to be allocated across the cluster.

    Note:

    The per node usable data storage is calculated by multiplying the replication factor and compaction overhead to the entered Usable Data Storage value and then dividing the resulting value by the number of nodes specified for the cluster. If the cluster size is 1 or 2 nodes, the replication factor is 1 or 2 respectively. If the cluster size is 3 or more nodes, the replication factor is 3. The compaction overhead applies a factor of 2 assuming Apache Cassandra’s SizeTieredCompactionStrategy. For example, if you create a cluster of 3 nodes specifying Usable Data Storage of 10 GB, then the Allocated Data Storage per node will be (3 * 2 * 10) / 3 giving 20 GB.

    Use High Performance Storage

    Select this to use high performance storage. With this option the storage attached to nodes uses SSDs (solid state drives) instead of HDDs (hard disk drives). Use this option for performance-critical workloads. An additional cost is associated with this type of storage.

  5. On the Service Details page, complete the Backup and Recovery Configuration section for storing backups in the cloud. You can specify an existing storage container, or have one created.

    Element Description

    Backup Destination

    Controls how backups for the clusters are to be configured:

    • Both Cloud Storage and Local Storage — backups are configured to be created automatically and stored both on local and cloud storage.

      If this choice is selected, the Cloud Storage Container, Username and Password fields are displayed.

    • Cloud Storage Only — backups are configured to be created automatically and stored on cloud storage.

      If this choice is selected, the Cloud Storage Container, Username and Password fields are displayed.

    • None — no automatic backups are configured.

    For more information about backups and backup configurations, see About Backing Up and Restoring Databases.

    Cloud Storage Container

    The URL where backups to cloud storage are to be stored:

    • For clusters in Oracle Cloud Infrastructure, enter the URL of an existing Oracle Cloud Infrastructure Object Storage bucket. The URL is of the form:

      https://swiftobjectstorage.region.oraclecloud.com/namespace/bucket

      For example:

      https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/mycompany/mybucket

      You must create this storage bucket before you begin creating the cluster. See Object Storage API in Oracle Cloud Infrastructure documentation.

    • For clusters in Oracle Cloud Infrastructure Classic, enter the URL of an Oracle Cloud Infrastructure Object Storage Classic container. The URL is of the general form:

      https://storage-instance-specifier/container

      To determine the storage-instance-specifier value for your account, see About REST URLs for Oracle Storage Cloud Service Resources in Using Oracle Cloud Infrastructure Object Storage Classic. If this container doesn’t exist, use the Create Cloud Storage Container checkbox to create it.

    Note:

    Do not use the Oracle Cloud Infrastructure Object Storage Classic container that you are using to back up Oracle Data Hub Cloud Service databases in Oracle Cloud Infrastructure Classic for any other purpose. For example, do not also use it to back up Oracle Java Cloud Service instances. Using the container for multiple purposes can result in billing errors.

    Cloud Storage Username

    A user with read/write (and creation, if necessary) access to the location specified in Cloud Storage Container:

    • For clusters in Oracle Cloud Infrastructure, enter the user name of the user who created the bucket you specified earlier.

    • For clusters in Oracle Cloud Infrastructure Classic, enter the Oracle Cloud user name of the administrator of the Oracle Cloud Infrastructure Object Storage Classic container specified in Cloud Storage Container. Usually, this is your Oracle Cloud user name.

    Cloud Storage Password

    The password necessary to access the location specified in Cloud Storage Container:

    • For clusters in Oracle Cloud Infrastructure, enter the Auth Token generated in Oracle Cloud Infrastructure for the user you specified. See Prerequisites for PaaS Services on Oracle Cloud Infrastructure in the Oracle Cloud Infrastructure documentation.

    • For clusters in Oracle Cloud Infrastructure Classic, enter the Oracle Cloud password for the user specified in Cloud Storage Username.

    Create Cloud Storage Container

    (Not available on Oracle Cloud Infrastructure)

    Select this to create a new Oracle Cloud Infrastructure Object Storage Classic container as part of cluster creation. Specify the container name, username, and password in the preceding fields.

    The user specified in Cloud Storage Username and Cloud Storage Password must have the privileges needed to create storage containers.

    If you select this option, the new storage container is created when you click Next on the Service Details page, and the storage container remains even if you cancel out of the wizard without creating a new cluster. If this happens, you can use the container in the future or manually delete it. See Deleting Containers in Using Oracle Cloud Infrastructure Object Storage Classic.

  6. On the Service Details page, complete the Credentials section. The username and password credentials are used to monitor the cluster.

    Element Description

    SSH Public Key

    Edit

    The SSH public key to be used for authentication when using an SSH client to connect to a node associated with your cluster.

    Click Edit to specify the public key. You can upload a file containing the public key value, paste in the value of a public key, or have the wizard generate a key pair for you.

    If you paste in the value, make sure the value does not contain line breaks or end with a line break.

    If you have the wizard generate a key pair for you, make sure you download the zip file containing the keys that the wizard generated.

    Administrative Username

    Username used to log in to the tools, such as cqlsh, nodetool, and service console.

    Password

    Confirm Password

    Password of the user specified in Administrative Username.

  7. On the Confirmation page, review the information listed. If you're satisfied with what you see, click Create to create the cluster.

    If you need to change something, click Previous at the top of the wizard to step back through the pages, or click Cancel to cancel out of the wizard without creating a new cluster.

    Click Download Download icon to download a JSON-format file containing the parameters you specified in the provisioning wizard. You can use the JSON-formatted file as a sample to construct the request body for creating instances using the REST API. Note that the file contains placeholders for passwords.