This guide will take you through the minimum required steps to get up and running with HarperDB.
- Running HarperDB
- Stopping HarperDB
- Restarting HarperDB
- Check HarperDB Version
- CRUD Samples
- HarperDB Studio
- Need Help?
NodeJS and NPM are prerequisites for downloading the HarperDB application. The user will need elevated privileges or read and write access to install HarperDB with the -g flag.
npm install -g harperdb
or if you download the harperdb-2.0.0.tgz from products.harperdb.io
npm install -g harperdb-2.0.0.tgz
If you did NOT NPM install globally your commands will need to be run as
<Working Directory>/node_modules/harperdb/bin/harperdb [ install | run | register ]
If HarperDB was installed globally, then from any directory execute the following:
You will need read and write access to the HDB_ROOT (location of the root directory of the database) directory, default path is your users home directory i.e
You will be prompted for a database username and password during the install.
If HarperDB is already installed, the command 'harperdb' run will NOT run the installer. Instead it will run HarperDB.
Logs are located at HDB_ROOT/log/.
To run HarperDB after it is installed; run the following commands:
- You may need to update your firewall if you are not running locally, by default HarperDB runs on port 9925. If you are unsure see your properties file at HDB_ROOT/config/settings.js.
To stop HarperDB once it is running from the HarperDB home (HDB_HOME) directory run the following commands:
To restart HarperDB once it is running from the HarperDB home (HDB_HOME) directory run the following commands:
Check HarperDB Version
To check the version you are running of HarperDB from the HarperDB home (HDB_HOME) directory run the following commands:
We really like Postman. We like it so much, we have created a series of examples that can be run to create and access sample data in HarperDB.
Get Postman here: https://www.getpostman.com/.
Our Postman 'Getting Started' samples can be found on our examples page: http://examples.harperdb.io/. Click the "Run in Postman" button then run the samples from top to bottom to learn how to create, populate, and query our sample 'dog' database.
Sample code is also available in many common languages in the sample code pane. Select the language you want from the drop down and paste the code. See the Postman documentation on supported languages here: https://www.getpostman.com/docs/postman/sending_api_requests/generate_code_snippets
Once HarperDB is installed and running you can get instant gratification by navigating a browser to:
Login with the user name and password you created during install.
Add a schema, add a table with hash attribute (primary key).
Then add attributes in the json object editor.
HarperDB Studio is a web based UI for managing users, roles, and schemas. The HarperDB Studio also enables you to run NoSQL & SQL queries, create charts, save your favorite queries & charts and share them via live links to your organization.
You're in the right place. This is our documentation and support portal. Navigate this site for answers to any questions you may have. If you can't find an answer here, submit a support request and we'll make sure to get your questions answered.