LogoLogo
4.1
4.1
  • Developer Documentation
  • Install HarperDB
    • On Linux
  • Getting Started
  • Full API Documentation
  • HarperDB Studio
    • Create an Account
    • Log In & Password Reset
    • Resources (Marketplace, Drivers, Tutorials, & Example Code)
    • Organizations
    • Instances
    • Query Instance Data
    • Manage Schemas / Browse Data
    • Manage Charts
    • Manage Clustering
    • Manage Instance Users
    • Manage Instance Roles
    • Manage Functions
    • Instance Metrics
    • Instance Configuration
    • Instance Example Code
    • Enable Mixed Content
  • HarperDB Cloud
    • IOPS Impact on Performance
    • Instance Size Hardware Specs
    • Alarms
    • Verizon 5G Wavelength
  • Security
    • JWT Authentication
    • Basic Authentication
    • Configuration
    • Users & Roles
  • Clustering
    • Requirements and Definitions
    • Creating A Cluster User
    • Naming A Node
    • Enabling Clustering
    • Establishing Routes
    • Subscription Overview
    • Managing Subscriptions
    • Things Worth Knowing
  • Custom Functions
    • Requirements and Definitions
    • Create a Project
    • Define Routes
    • Define Helpers
    • Host A Static Web UI
    • Using NPM and GIT
    • Custom Functions Operations
    • Restarting the Server
    • Debugging a Custom Function
    • Custom Functions Templates
    • Example Projects
  • Add-ons and SDKs
    • Google Data Studio
  • SQL Guide
    • SQL Features Matrix
    • Insert
    • Update
    • Delete
    • Select
    • Joins
    • SQL Date Functions
    • SQL Reserved Word
    • SQL Functions
    • SQL JSON Search
    • SQL Geospatial Functions
      • geoArea
      • geoLength
      • geoDifference
      • geoDistance
      • geoNear
      • geoContains
      • geoEqual
      • geoCrosses
      • geoConvert
  • HarperDB CLI
  • Configuration File
  • Logging
  • Transaction Logging
  • Audit Logging
  • Jobs
  • Upgrade a HarperDB Instance
  • Reference
    • Storage Algorithm
    • Dynamic Schema
    • Data Types
    • Content Types/Data Formats
    • HarperDB Headers
    • HarperDB Limits
  • Support
  • Release Notes
    • HarperDB Tucker (Version 4)
      • 4.1.0
      • 4.0.6
      • 4.0.5
      • 4.0.4
      • 4.0.3
      • 4.0.2
      • 4.0.1
      • 4.0.0
    • HarperDB Monkey (Version 3)
      • 3.3.0
      • 3.2.1
      • 3.2.0
      • 3.1.5
      • 3.1.4
      • 3.1.3
      • 3.1.2
      • 3.1.1
      • 3.1.0
      • 3.0.0
    • HarperDB Penny (Version 2)
      • 2.3.1
      • 2.3.0
      • 2.2.3
      • 2.2.2
      • 2.2.0
      • 2.1.1
    • HarperDB Alby (Version 1)
      • 1.3.1
      • 1.3.0
      • 1.2.0
      • 1.1.0
Powered by GitBook

© HarperDB. All Rights Reserved

On this page
  • Initial Configuration
  • Manage Clustering
  • Connect an Instance
  • Disconnect an Instance
  • Manage Replication
Export as PDF
  1. HarperDB Studio

Manage Clustering

PreviousManage ChartsNextManage Instance Users

Last updated 1 year ago

HarperDB instance clustering and replication can be configured directly through the HarperDB Studio. It is recommended to read through the clustering documentation first to gain a strong understanding of HarperDB clustering behavior.

All clustering configuration is handled through the cluster page of the HarperDB Studio, accessed with the following instructions:

  1. Navigate to the page.

  2. Click the appropriate organization that the instance belongs to.

  3. Select your desired instance.

  4. Click cluster in the instance control bar.

Note, the cluster page will only be available to super users.


Initial Configuration

HarperDB instances do not have clustering configured by default. The HarperDB Studio will walk you through the initial configuration. Upon entering the cluster screen for the first time you will need to complete the following configuration. Configurations are set in the enable clustering panel on the left while actions are described in the middle of the screen.

  1. Create a cluster user, read more about this here: Clustering Users and Roles.

    • Enter username.

    • Enter password.

    • Click Create Cluster User.

  2. Click Set Cluster Node Name.

  3. Click Enable Instance Clustering.

At this point the Studio will restart your HarperDB Instance, required for the configuration changes to take effect.


Manage Clustering

Once initial clustering configuration is completed you a presented with a clustering management screen with the following properties:

  • connected instances

    Displays all instances within the Studio Organization that this instance manages a connection with.

  • unconnected instances

    Displays all instances within the Studio Organization that this instance does not manage a connection with.

  • unregistered instances

    Displays all instances outside of the Studio Organization that this instance manages a connection with.

  • manage clustering

    Once instances are connected, this will display clustering management options for all connected instances and all schemas and tables.


Connect an Instance

HarperDB Instances can be clustered together with the following instructions.

  1. Ensure clustering has been configured on both instances and a cluster user with identical credentials exists on both.

  2. Identify the instance you would like to connect from the unconnected instances panel.

  3. Click the plus icon next the appropriate instance.

  4. If configurations are correct, all schemas will sync across the cluster, then appear in the manage clustering panel. If there is a configuration issue, a red exclamation icon will appear, click it to learn more about what could be causing the issue.


Disconnect an Instance

HarperDB Instances can be disconnected with the following instructions.

  1. Identify the instance you would like to disconnect from the connected instances panel.

  2. Click the minus icon next the appropriate instance.


Manage Replication

Subscriptions must be configured in order to move data between connected instances. Read more about subscriptions here: Creating A Subscription. The manage clustering panel displays a table with each row representing an channel per instance. Cells are bolded to indicate a change in the column. Publish and subscribe replication can be configured per table with the following instructions:

  1. Identify the instance, schema, and table for replication to be configured.

  2. For publish, click the toggle switch in the publish column.

  3. For subscribe, click the toggle switch in the subscribe column.

HarperDB Studio Organizations