Getting Started with HarperDB on Ori Global Cloud

HarperDB is a turn-key distributed database solution that can help your organisation collect, distribute, and analyse data quickly and easily. By simplifying the complexities of data collection and management, HarperDB can save you months or even years of consulting, configuration, and custom development work. If you’re interested in deploying HarperDB on Ori Global Cloud, here’s how to get started:

  • Create an Ori account: The first step to deploying HarperDB on Ori is to create an account on the platform. Simply visit the Ori website and fill out the registration form to get started.

  • Set up your project: Once you have an Ori account, you’ll need to set up a project for your HarperDB deployment. A project is a container for all the resources related to a specific application or service. Creating a project helps you organise your resources and manage access control for your team. To create a new project, log in to your Ori account and navigate to the Projects tab. Click “New Project” and follow the prompts to create your project. Once you’ve created your project, you’ll need to link it to a cluster to deploy to - you can do this under the Cluster tab, selecting the target cluster then adding the project to the Projects tab.

  • Add your HarperDB package: After you’ve created your project, you’ll need to add the HarperDB package to it. A package is a versioned, deployable artefact that contains everything needed to run your application or service. To add the HarperDB package, navigate to the Packages tab and click “New Package.” Select the HarperDB package from the list of available packages and grab the details to add the HarperDB Docker Hub image to your project: the image name is: harperdb/harperb (this is enough for us to find the image).

  • Configure your HarperDB deployment: Once you’ve added the HarperDB package to your project, you’ll need to configure your deployment. This includes setting up ports and specifying any necessary environment variables. The Port protocol for HarperDB is IPv4 TCP with ports 9925 : 80 so we can expose it: we will be mapping from port 80 on the URL OGC provides, to 9925 on the container.

Next up, we’ll add any environment variables: follow the prompts on the Env Vars tab to configure your deployment. HarperDB configuration settings can be passed as docker run environment variables. If no environment variables are passed to docker run, HarperDB will run with default configuration settings, except for the following:

At the very least, you’ll need to set: HDB_ADMIN_USERNAME=HDB_ADMIN and HDB_ADMIN_PASSWORD=password. All environment variables can be added here with the exception of Secrets. Secrets need to be defined under Projects, then added to containers like so:

  • Load Balancing: Once you’ve set up your ports, environment variables and secrets, you need to head to Packages and firstly, add a Traffic Source. You can add the name as “Any” and the IP range to Hit save, then move to add a Route Policy, and select Traffic Source then Any as your source. Next, under Target, select your Port (80).

  • Monitor and manage your deployment: After you’ve launched your HarperDB deployment, you can monitor and manage it from the Ori platform. The platform offers powerful monitoring and troubleshooting tools that can help you identify and resolve issues quickly. You can also use the platform to scale your deployment, manage multiple cloud environments, and automate deployment workflows.

By following these steps, you can quickly and easily deploy HarperDB on Ori Global Cloud. With HarperDB, you can streamline your data collection and management workflows, allowing you to focus on building innovative and high-quality applications that drive business value.

It’s time to move beyond rigid legacy deployments and embrace the power of intelligent orchestration. Sign up and leverage the benefits of Ori Global Cloud.

Trying to set up this demo, however, I am getting this pop up error when trying to deploy:

Planning failed: Could not place one or more applications

I am using kind and the cluster is provisioned.

Please advise.

1 Like

:wave: @rfashwall It seems like the only thing missing is to assign a cluster to the project - you can do this in the Cluster tab. Select the specific cluster, and then under the Projects tab you can add the specific project to this cluster for use - I’ll update the text above!

Hello, here is a quick guide to doing that: Assign Clusters to Projects | Ori Docs
Any issues let me know.

1 Like

How did you get on with this rfashwall?