HarperDB is a distributed data platform that is designed for ease of use, scalability, and flexibility. It is a NoSQL database that combines the features of a traditional relational database with those of a document-oriented database. HarperDB is known for its ability to handle complex data types and its compatibility with multiple programming languages. It also includes a built-in API, making integrating with other applications easy. HarperDB is particularly useful for IoT applications, real-time analytics, and edge computing, as it can operate in a distributed manner across multiple devices and locations.
This procedure will provide a detailed guide to creating a HarperDB database on an Ubuntu instance running on the Atlantic.Net Cloud Platform.
To create an Atlantic.Net account, you can follow these steps:
- Go to the Atlantic.Net website at https://www.atlantic.net/ and click on the "Sign Up" button in the top right corner of the page.
- On the sign-up page, fill in your information, including your name, email address, and password. You will also need to select a security question and provide an answer.
- Once you have submitted your registration, you will receive an email from Atlantic.Net with a link to activate your account. Click on the link in the email to activate your account.
- Once your account is activated, you can log in to the Atlantic.Net Cloud Control Panel to create and manage your cloud servers and other services.
You may need to provide additional information, such as your billing information and verification documents, to complete your registration and start using Atlantic.Net services.
Step 1 - Log in to your Atlantic.Net Account
Click the following link to be directed to the Login page. Fill in your details to log in.
Step 2 - Create an Ubuntu Instance on Atlantic.Net
Now it's time to build it; in this example, we will install Ubuntu 22.04 LTS 64bit
- Click on the "Add Server" button to create a new cloud server.
- On the "Add a Server" page, type a name for your server.
- Scroll down to find the Ubuntu operating system and click the "Ubuntu" button to see the versions. We installed 22.04 LTS 64-bit; select it and continue.
- Choose the region that you want to use for your Ubuntu instance. In this example, we will use USA-East-3 (Ashburn, VA).
- Choose the payment term: on-demand, one year, or three years. Various discounts are available, but we will choose on-demand for added flexibility.
- Choose the instance plan. HarperDB recommends at least 4GB RAM (more for production workloads). In this demo, we will choose the G3.4GB plan
- You can also select additional options, such as backups and IPV6, and add your own SSH keys if needed.
- When you have selected everything you need, click the “Create Server” button.
- Wait about 30 seconds for your server to be created. Once your server is ready, you can log in to it using SSH and start using it. The credentials are provided on screen and emailed to the primary email address on your account.
Step 3 - Enable SSH on your instance
There are numerous ways to enable SSH protocol on your server. To connect to the server, use a GUI SSH client, such as PuTTY on Windows or iTerm2 on macOS. Download and install the client on your local machine, enter the server's IP address and login credentials, and connect to the server.
In this example, I will be using iTerm2 on macOS.
Replace username with your VPS username and server_ip_address with your VPS's public IP address.
Step 4 - Update OS and Prep System for HarperDB
- Update the Ubuntu package list by running the following command:
- Create a username for HarperDB to use; it requires a non-root username to run.
- Set a password for the HarperDB username
- Create a 2GB swapfile on your server.
- Increase the Ubuntu security limits config file.
- Download and install NVM.
You should see this output:
- Load NVM into the current shell session.
- Install NodeJS.
Step 5 - Install HarperDB
- Use this oneliner to install HarperDB.
Note: Please ensure you create a secure password.
- Create a crontab entry to make HarperDB start after every reboot.
In this tutorial, we explained how to install HarperDB on Ubuntu Linux. We also showed you how to create a simple database using HarperDB. You can now start exploring the possibilities of this super fast database. You can try to install HarperDB on dedicated hosting from Atlantic.Net!
About the Author
Rich Bailey is the lead IT consultant and frequent blogger for Atlantic.Net, with 20 years of experience in Linux, Cloud, automation, and infrastructure, as well as code. He is a graduate of the University of Bradford, England.